feat(agentstack-cli): use better heuristics for adding agents

[JanPokorny]

Summary

Given what we officially support, determine if given path is buildable as Docker context (existing local path, or URL that looks like a git forge). Otherwise assume public image and attempt to pull it.

Linked Issues

Fixes #1529

Documentation

• No Docs Needed: It just improves existing documented behavior.

[gemini-code-assist]

Summary of Changes

Hello @JanPokorny, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the agentstack-cli's ability to intelligently interpret the source of an agent when using the add_agent command. By implementing a more robust and ordered detection mechanism, the CLI can now more accurately identify whether an agent should be sourced from a local Docker image, built from a specified context (like a local directory or a Git repository), or pulled as a public Docker image. This change aims to improve the reliability and user experience by automating the selection of the correct agent provisioning method.

Highlights

• Improved Agent Source Detection: The add_agent command now employs better heuristics to determine if a given input location refers to a local Docker image, a buildable Docker context (local path or Git repository), or a public Docker image.
• Structured Logic Flow: The agent addition process has been refactored into a clear conditional structure: first attempting to inspect local Docker images, then checking for various buildable context patterns (local paths, Git URLs), and finally assuming a public Docker image if neither of the former apply.
• Simplified Error Handling: The previous try-except ExceptionGroup block has been removed, streamlining the flow for agent registration after the source determination.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request improves the heuristics for adding an agent by intelligently determining whether a given location is a local path, a Git repository URL, or a public Docker image. The logic has been refactored to be more explicit about its assumptions. My review focuses on improving the readability of the new conditional logic. Overall, the changes are a good improvement.