google-agents-cli 1.2.0__tar.gz → 1.2.1__tar.gz

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-agents-cli
-Version: 1.2.0
+Version: 1.2.1
 Summary: Agents CLI — Agent Development Lifecycle toolchain for ADK
 Author-email: Google LLC <agents-cli-dev-pypi@google.com>
 Requires-Python: >=3.11

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "google-agents-cli"
-version = "1.2.0"
+version = "1.2.1"
 description = "Agents CLI — Agent Development Lifecycle toolchain for ADK"
 readme = "README.md"
 license = "Apache-2.0"

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-adk-code/SKILL.md

@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-deploy/SKILL.md

@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-eval/SKILL.md

@@ -11,7 +11,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-observability/SKILL.md

@@ -13,7 +13,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-publish/SKILL.md

@@ -15,7 +15,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-scaffold/SKILL.md

@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/skills/google-agents-cli-workflow/SKILL.md

@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 1.2.0
+  version: 1.2.1
   requires:
     bins:
       - agents-cli
@@ -26,8 +26,8 @@ metadata:
 > **Before writing agent code, make sure a scaffolded project exists (see Phase 2).** Skipping scaffolding loses eval boilerplate, CI/CD config, and project conventions.
 
 
-> Requires: google-agents-cli ~= 1.2.0
-> If version is behind, run: uv tool install "google-agents-cli~=1.2.0"
+> Requires: google-agents-cli ~= 1.2.1
+> If version is behind, run: uv tool install "google-agents-cli~=1.2.1"
 
 > Check version: agents-cli info
 > [Install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) first if needed.

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/src/google/agents/cli/_adk_client.py

@@ -19,11 +19,11 @@ from __future__ import annotations
 import json
 from collections.abc import Iterator
 
-import click
 import requests
 
 _SESSION_TIMEOUT = 30
 _RUN_SSE_TIMEOUT = 120
+_APP_INFO_TIMEOUT = 10
 
 
 def create_session(
@@ -32,20 +32,48 @@ def create_session(
     user_id: str,
     *,
     headers: dict,
+    prior_events: list[dict] | None = None,
 ) -> str:
-    """Create an ADK session and return its ID."""
+    """Create an ADK session and return its ID.
+
+    When ``prior_events`` are supplied, the ADK server seeds the fresh
+    session with them.
+    """
     session_url = f"{base_url}/apps/{app_name}/users/{user_id}/sessions"
-    resp = requests.post(session_url, headers=headers, json={}, timeout=_SESSION_TIMEOUT)
-    if not resp.ok:
-        hint = ""
-        if resp.status_code in (404, 405):
-            hint = "\n  If this is an A2A agent, try --mode a2a instead."
-        raise click.ClickException(
-            f"Failed to create session (HTTP {resp.status_code}):\n  {resp.text}{hint}"
-        )
+    body: dict = {}
+    if prior_events:
+        body["events"] = prior_events
+
+    resp = requests.post(
+        session_url, headers=headers, json=body, timeout=_SESSION_TIMEOUT
+    )
+    resp.raise_for_status()
     return resp.json().get("id")
 
 
+def fetch_app_info(
+    *,
+    base_url: str,
+    app_name: str,
+    headers: dict,
+) -> tuple[str | None, dict]:
+    """Fetch agent metadata from ADK's /apps/{app_name}/app-info endpoint.
+
+    Returns (root_agent_name, agents), where agents is the raw ADK agents
+    map keyed by agent id. root_agent_name may be None if the server omits
+    it; agents may be empty.
+
+    Raises requests.RequestException (or a subclass: ConnectionError,
+    HTTPError, JSONDecodeError) if the endpoint isn't reachable, returns a
+    non-2xx status, or returns a body that isn't valid JSON.
+    """
+    url = f"{base_url}/apps/{app_name}/app-info"
+    resp = requests.get(url, headers=headers, timeout=_APP_INFO_TIMEOUT)
+    resp.raise_for_status()
+    payload = resp.json()
+    return payload.get("rootAgentName"), payload.get("agents") or {}
+
+
 def run_sse(
     base_url: str,
     app_name: str,
@@ -72,10 +100,7 @@ def run_sse(
     with requests.post(
         run_url, headers=headers, json=payload, stream=True, timeout=_RUN_SSE_TIMEOUT
     ) as resp:
-        if not resp.ok:
-            raise click.ClickException(
-                f"Failed to run agent (HTTP {resp.status_code}):\n  {resp.text}"
-            )
+        resp.raise_for_status()
         for line in resp.iter_lines(decode_unicode=True):
             if not isinstance(line, str) or not line.startswith("data: "):
                 continue

google_agents_cli-1.2.1/src/google/agents/cli/_gcp_project.py

@@ -0,0 +1,93 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""GCP project resolution and lookup utilities."""
+
+import os
+
+import click
+
+from google.agents.cli._runner import run
+
+
+def resolve_gcp_project(
+    override_project: str | None = None, *, required: bool = False
+) -> str:
+    """Resolves the GCP project ID to use.
+
+    The project ID is resolved in the following order of precedence:
+
+    1.  The ``override_project`` argument if provided.
+        It's expected this would come from a --project command line argument.
+    2.  The ``GOOGLE_CLOUD_PROJECT`` environment variable.
+    3.  Application Default Credentials via :func:`google.auth.default`,
+        which itself checks (in order):
+
+        a.  ``GOOGLE_APPLICATION_CREDENTIALS`` service account JSON file.
+        b.  The gcloud SDK ADC file
+            (``gcloud auth application-default login``); when this file
+            exists but lacks a project, the gcloud SDK falls back to
+            ``gcloud config get-value project``.
+        c.  GAE / GCE / Cloud Run metadata service.
+
+    Returns:
+        The resolved GCP project ID, or an empty string if no project is found.
+    """
+    if override_project:
+        return override_project
+    env_project = os.environ.get("GOOGLE_CLOUD_PROJECT")
+    if env_project:
+        return env_project
+    # Local import: avoids a circular import at module load time
+    # (auth.py imports from _gcp_project transitively in some paths).
+    from google.agents.cli.auth import _get_adc_project
+
+    project = _get_adc_project() or ""
+    if required and not project:
+        raise click.ClickException(
+            "Could not determine GCP project. Set one with:\n"
+            "  * pass --project <PROJECT_ID>\n"
+            "  * export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>\n"
+            "  * gcloud config set project <PROJECT_ID>"
+        )
+    return project
+
+
+def get_gcp_project_number(project_id: str) -> str | None:
+    """Get numeric GCP project number for a project ID or project number.
+
+    Args:
+        project_id: GCP project ID or project number (e.g., 'my-project' or '123456789').
+
+    Returns:
+        Project number string, or None if lookup fails.
+    """
+    res = run(
+        [
+            "gcloud",
+            "projects",
+            "describe",
+            project_id,
+            "--format=value(projectNumber)",
+        ],
+        check=False,
+        capture=True,
+    )
+    if res.returncode == 0:
+        return res.stdout.strip() or None
+
+    # Maybe it's already a project number, return as-is
+    if project_id.isdigit():
+        return project_id
+    return None

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/src/google/agents/cli/_project.py

@@ -307,49 +307,6 @@ def require_deployment_target(cfg: ProjectConfig) -> None:
         )
 
 
-def resolve_gcp_project(
-    override_project: str | None = None, *, required: bool = False
-) -> str:
-    """Resolves the GCP project ID to use.
-
-    The project ID is resolved in the following order of precedence:
-
-    1.  The ``override_project`` argument if provided.
-        It's expected this would come from a --project command line argument.
-    2.  The ``GOOGLE_CLOUD_PROJECT`` environment variable.
-    3.  Application Default Credentials via :func:`google.auth.default`,
-        which itself checks (in order):
-
-        a.  ``GOOGLE_APPLICATION_CREDENTIALS`` service account JSON file.
-        b.  The gcloud SDK ADC file
-            (``gcloud auth application-default login``); when this file
-            exists but lacks a project, the gcloud SDK falls back to
-            ``gcloud config get-value project``.
-        c.  GAE / GCE / Cloud Run metadata service.
-
-    Returns:
-        The resolved GCP project ID, or an empty string if no project is found.
-    """
-    if override_project:
-        return override_project
-    env_project = os.environ.get("GOOGLE_CLOUD_PROJECT")
-    if env_project:
-        return env_project
-    # Local import: avoids a circular import at module load time
-    # (auth.py imports from _project transitively in some paths).
-    from google.agents.cli.auth import _get_adc_project
-
-    project = _get_adc_project() or ""
-    if required and not project:
-        raise click.ClickException(
-            "Could not determine GCP project. Set one with:\n"
-            "  * pass --project <PROJECT_ID>\n"
-            "  * export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>\n"
-            "  * gcloud config set project <PROJECT_ID>"
-        )
-    return project
-
-
 def require_a2a_project(cfg: ProjectConfig) -> None:
     """Raise if the project is not an A2A agent."""
     if not cfg.is_a2a:

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/src/google/agents/cli/deploy/cmd_deploy.py

@@ -26,6 +26,7 @@ import click
 import requests
 
 from google.agents.cli import _tools
+from google.agents.cli._gcp_project import resolve_gcp_project
 from google.agents.cli._project import (
     ProjectConfig,
     chdir_project_root,
@@ -33,7 +34,6 @@ from google.agents.cli._project import (
     find_project_root,
     read_project_config,
     require_deployment_target,
-    resolve_gcp_project,
 )
 from google.agents.cli._runner import popen_resolved, run, run_resolved
 from google.agents.cli.auth import get_access_token

{google_agents_cli-1.2.0 → google_agents_cli-1.2.1}/src/google/agents/cli/eval/cmd_analyze.py

@@ -28,11 +28,11 @@ from rich.console import Console
 from rich.table import Table
 from vertexai._genai import _evals_visualization
 
+from google.agents.cli._gcp_project import resolve_gcp_project
 from google.agents.cli._project import (
     chdir_project_root,
     read_project_config,
     require_agent_directory,
-    resolve_gcp_project,
 )
 from google.agents.cli.eval import _paths