google-agents-cli 1.9.0__tar.gz → 1.10.0__tar.gz

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-agents-cli
-Version: 1.9.0
+Version: 1.10.0
 Summary: Agents CLI — Agent Development Lifecycle toolchain for ADK
 Author-email: Google LLC <agents-cli-dev-pypi@google.com>
 Requires-Python: >=3.11
@@ -13,7 +13,7 @@ Requires-Dist: click>=8.1.8,<9
 Requires-Dist: PyYAML>=6.0.2,<7
 Requires-Dist: cookiecutter>=2.6.0,<3
 Requires-Dist: jinja2>=3.1.0
-Requires-Dist: google-cloud-aiplatform[evaluation]>=1.165.0,<2
+Requires-Dist: google-cloud-aiplatform[evaluation]>=2.2.0,<3
 Requires-Dist: google-cloud-resource-manager>=1.12.0
 Requires-Dist: google-auth[pyopenssl]>=2.47.0
 Requires-Dist: pyopenssl<26.2
@@ -42,7 +42,7 @@ Provides-Extra: lint
 <div align="center">
   <img src="https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/logo_sm.png" alt="agents-cli logo" width="120" />
   <h1><code>agents-cli</code></h1>
-  <p>The CLI and skills for building agents on Gemini Enterprise Agent Platform.</p>
+  <p>The CLI and skills for building agents on Gemini platform.</p>
 
   <p>
     <a href="#get-started">Get Started</a> &nbsp;&nbsp;|&nbsp;&nbsp;
@@ -60,7 +60,7 @@ Provides-Extra: lint
 
 Turn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.
 
-**Agents CLI in Agent Platform** (`agents-cli`) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.
+**Agents CLI in Gemini platform** (`agents-cli`) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.
 
 **Works seamlessly with:**
 [Antigravity CLI](https://antigravity.google/) &nbsp;•&nbsp; [Claude Code](https://docs.anthropic.com/en/docs/claude-code) &nbsp;•&nbsp; [Codex](https://github.com/openai/codex) &nbsp;•&nbsp; *and any other coding agent.*
@@ -106,8 +106,8 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `google-agents-cli-adk-code` | ADK Python API — agents, tools, orchestration, callbacks, state |
 | `google-agents-cli-scaffold` | Project scaffolding — `create`, `enhance`, `upgrade` |
 | `google-agents-cli-eval` | Evaluation methodology — metrics, datasets, LLM-as-judge, adaptive rubrics |
-| `google-agents-cli-deploy` | Deployment — [Agent Runtime](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale), [Cloud Run](https://cloud.google.com/run), [GKE](https://cloud.google.com/kubernetes-engine), CI/CD, secrets |
-| `google-agents-cli-publish` | Gemini Enterprise registration |
+| `google-agents-cli-deploy` | Deployment — [Agent Runtime in Gemini platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale), [Cloud Run](https://cloud.google.com/run), [GKE](https://cloud.google.com/kubernetes-engine), CI/CD, secrets |
+| `google-agents-cli-publish` | Gemini registration |
 | `google-agents-cli-observability` | Observability — Cloud Trace, logging, third-party integrations |
 
 ---
@@ -120,7 +120,7 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `agents-cli create <name>` | Create a new agent project |
 | `agents-cli eval run` | Run the agent over the eval dataset and grade the traces |
 | `agents-cli deploy` | Deploy to Google Cloud |
-| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |
+| `agents-cli publish gemini` | Register with Gemini |
 
 <details>
 <summary>See all commands</summary>
@@ -148,7 +148,7 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `agents-cli eval optimize` | Auto-tune agent prompts using eval data |
 | **Deploy & Publish** | |
 | `agents-cli deploy` | Deploy to Google Cloud |
-| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |
+| `agents-cli publish gemini` | Register with Gemini |
 | `agents-cli infra single-project` | Provision single-project infrastructure |
 | `agents-cli infra cicd` | Set up CI/CD pipeline + staging/prod infrastructure |
 | **Other** | |

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/logo_sm.png" alt="agents-cli logo" width="120" />
   <h1><code>agents-cli</code></h1>
-  <p>The CLI and skills for building agents on Gemini Enterprise Agent Platform.</p>
+  <p>The CLI and skills for building agents on Gemini platform.</p>
 
   <p>
     <a href="#get-started">Get Started</a> &nbsp;&nbsp;|&nbsp;&nbsp;
@@ -19,7 +19,7 @@
 
 Turn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.
 
-**Agents CLI in Agent Platform** (`agents-cli`) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.
+**Agents CLI in Gemini platform** (`agents-cli`) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.
 
 **Works seamlessly with:**
 [Antigravity CLI](https://antigravity.google/) &nbsp;•&nbsp; [Claude Code](https://docs.anthropic.com/en/docs/claude-code) &nbsp;•&nbsp; [Codex](https://github.com/openai/codex) &nbsp;•&nbsp; *and any other coding agent.*
@@ -65,8 +65,8 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `google-agents-cli-adk-code` | ADK Python API — agents, tools, orchestration, callbacks, state |
 | `google-agents-cli-scaffold` | Project scaffolding — `create`, `enhance`, `upgrade` |
 | `google-agents-cli-eval` | Evaluation methodology — metrics, datasets, LLM-as-judge, adaptive rubrics |
-| `google-agents-cli-deploy` | Deployment — [Agent Runtime](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale), [Cloud Run](https://cloud.google.com/run), [GKE](https://cloud.google.com/kubernetes-engine), CI/CD, secrets |
-| `google-agents-cli-publish` | Gemini Enterprise registration |
+| `google-agents-cli-deploy` | Deployment — [Agent Runtime in Gemini platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale), [Cloud Run](https://cloud.google.com/run), [GKE](https://cloud.google.com/kubernetes-engine), CI/CD, secrets |
+| `google-agents-cli-publish` | Gemini registration |
 | `google-agents-cli-observability` | Observability — Cloud Trace, logging, third-party integrations |
 
 ---
@@ -79,7 +79,7 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `agents-cli create <name>` | Create a new agent project |
 | `agents-cli eval run` | Run the agent over the eval dataset and grade the traces |
 | `agents-cli deploy` | Deploy to Google Cloud |
-| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |
+| `agents-cli publish gemini` | Register with Gemini |
 
 <details>
 <summary>See all commands</summary>
@@ -107,7 +107,7 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
 | `agents-cli eval optimize` | Auto-tune agent prompts using eval data |
 | **Deploy & Publish** | |
 | `agents-cli deploy` | Deploy to Google Cloud |
-| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |
+| `agents-cli publish gemini` | Register with Gemini |
 | `agents-cli infra single-project` | Provision single-project infrastructure |
 | `agents-cli infra cicd` | Set up CI/CD pipeline + staging/prod infrastructure |
 | **Other** | |

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "google-agents-cli"
-version = "1.9.0"
+version = "1.10.0"
 description = "Agents CLI — Agent Development Lifecycle toolchain for ADK"
 readme = "README.md"
 license = "Apache-2.0"
@@ -16,7 +16,7 @@ dependencies = [
   "PyYAML>=6.0.2,<7",
   "cookiecutter>=2.6.0,<3",
   "jinja2>=3.1.0",
-  "google-cloud-aiplatform[evaluation]>=1.165.0,<2",
+  "google-cloud-aiplatform[evaluation]>=2.2.0,<3",
   "google-cloud-resource-manager>=1.12.0",
   "google-auth[pyopenssl]>=2.47.0",
   # pyOpenSSL 26.2 forbids mutating a used SSL Context; urllib3 does it per
@@ -135,11 +135,14 @@ ignore = ["E501", "C901", "RUF001", "UP036", "RUF067", "RUF069"]
 
 [tool.ruff.lint.per-file-ignores]
 "tests/**/*.py" = ["PLR0917"]
+# The only module allowed to import private Agent Platform SDK modules; keep in
+# sync with ALLOWED_PRIVATE_IMPORT_FILES in tools/ci/check_private_imports.py.
+"src/google/agents/cli/_sdk_compat.py" = ["TID251"]
 
 [tool.ruff.lint.flake8-tidy-imports.banned-api]
 "rich.console.Console" = { msg = "Use `google.agents.cli._output.Console` instead to ensure project-wide defaults (soft_wrap=True) are applied." }
 "agentplatform.Client" = { msg = "Use `google.agents.cli._agent_platform.AgentPlatformClient` instead, so the client retries throttled requests." }
-"agentplatform._genai" = { msg = "Private SDK module that can change without notice. Use `types` from `google.agents.cli._agent_platform_types` for SDK types." }
+"agentplatform._genai" = { msg = "Private SDK module that can change without notice. Use `types` from `google.agents.cli._agent_platform_types` for SDK types, and add any other private SDK use to `google.agents.cli._sdk_compat`." }
 
 [tool.ruff.lint.pylint]
 max-positional-args = 5

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/_agent_platform.py

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Shared construction of the Agent Platform SDK client."""
+"""Shared construction of the Gemini platform SDK client."""
 
 from __future__ import annotations
 
@@ -21,7 +21,7 @@ from typing import TYPE_CHECKING, Any
 if TYPE_CHECKING:
     import agentplatform
 
-# Retry options applied to every Agent Platform client the CLI builds. Leaving
+# Retry options applied to every Gemini platform client the CLI builds. Leaving
 # http_status_codes unset keeps the SDK's default retryable set (408/429/500/502/503/504);
 # waits are roughly 1s, 2s, 4s, 8s (full-jittered).
 RETRY_OPTIONS: dict[str, Any] = {
@@ -31,7 +31,7 @@ RETRY_OPTIONS: dict[str, Any] = {
 
 
 class AgentPlatformClient:
-    """Agent Platform client configured with CLI-wide defaults (e.g. retries on transient errors).
+    """Gemini platform client configured with CLI-wide defaults (e.g. retries on transient errors).
 
     Retries are opt-in in the underlying SDK, so constructing ``agentplatform.Client``
     directly runs without them. A ruff rule enforces using this wrapper instead.

google_agents_cli-1.10.0/src/google/agents/cli/_agent_platform_types.py

@@ -0,0 +1,23 @@
+# 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.
+
+"""Gemini platform SDK types.
+
+Use ``types.EvalCase``, ``types.evals.AgentEvent``, etc. from here rather than
+importing ``agentplatform._genai`` directly. ``_sdk_compat`` resolves them.
+"""
+
+from google.agents.cli._sdk_compat import types
+
+__all__ = ["types"]

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/_click.py

@@ -65,6 +65,7 @@ class LazyGroup(click.Group):
         # name -> experiment label
         self._experiment_gates: dict[str, str] = {}
         self._overrides: dict[str, click.Command] = {}
+        self._hidden: set[str] = set()
 
     def add_lazy_command(
         self,
@@ -72,6 +73,7 @@ class LazyGroup(click.Group):
         import_path: str,
         short_help: str,
         experiment: str | None = None,
+        hidden: bool = False,
     ) -> None:
         """Register a subcommand for lazy loading.
 
@@ -83,10 +85,20 @@ class LazyGroup(click.Group):
         not at this registration call: `main` is built once at import, so
         guarding registration would freeze visibility before a unit test could
         override the experiment.
+
+        `hidden` keeps a command invocable but out of --help and the docs, e.g.
+        an old name kept as an alias after a rename.
         """
         self._lazy_commands[name] = (import_path, short_help)
         if experiment is not None:
             self._experiment_gates[name] = experiment
+        if hidden:
+            self._hidden.add(name)
+
+    @property
+    def hidden_commands(self) -> frozenset[str]:
+        """Names registered with `hidden=True`: invocable, but not listed."""
+        return frozenset(self._hidden)
 
     def _is_visible(self, name: str) -> bool:
         """True if `name` is not hidden via experiment."""
@@ -100,7 +112,7 @@ class LazyGroup(click.Group):
             set(super().list_commands(ctx))
             | set(self._lazy_commands)
             | set(self._overrides)
-        )
+        ) - self._hidden
         return sorted(filter(self._is_visible, names))
 
     def get_command(self, ctx: click.Context, cmd_name: str) -> click.Command | None:

google_agents_cli-1.10.0/src/google/agents/cli/_fs.py

@@ -0,0 +1,95 @@
+# 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.
+
+"""File system helpers for agents CLI."""
+
+from __future__ import annotations
+
+import contextlib
+import logging
+import os
+import shutil
+import stat
+from pathlib import Path
+
+
+def delete_folder(folder: Path) -> None:
+    """Delete `folder`, even when it holds read-only folders; warn when it cannot."""
+    make_folders_writable(folder)
+    shutil.rmtree(folder, ignore_errors=True)
+    if folder.exists() or folder.is_symlink():
+        logging.warning("Could not delete %s; delete it by hand.", folder)
+
+
+def delete_path(path: Path) -> None:
+    """Delete `path`; unlink a link instead of following it into a folder we do not own.
+
+    Raises OSError when it cannot delete, unlike `delete_folder`, which only warns.
+    """
+    try:
+        mode = path.lstat().st_mode
+    except (FileNotFoundError, NotADirectoryError):
+        return
+    if stat.S_ISDIR(mode):
+        make_folders_writable(path)
+        shutil.rmtree(os.fspath(path))
+    else:
+        path.unlink()
+
+
+def make_folders_writable(root: Path) -> None:
+    """Let ``rmtree`` delete what read-only folders under ``root`` hold.
+
+    Best effort: a folder it cannot change is left as it is.
+    """
+    if root.is_symlink():
+        return
+    _make_writable(root)
+    for folder, subfolders, _ in os.walk(root):
+        for name in subfolders:
+            subfolder = os.path.join(folder, name)
+            # chmod follows links, so a linked folder is skipped to keep the change
+            # inside `root` (CWE-59). Each one is changed before os.walk lists it.
+            if not os.path.islink(subfolder):
+                _make_writable(subfolder)
+
+
+def _make_writable(folder: str | Path) -> None:
+    with contextlib.suppress(OSError):
+        os.chmod(folder, stat.S_IRWXU)
+
+
+def is_real_dir(path: Path) -> bool:
+    """Whether `path` is a folder and not a link: a committed link can lead anywhere.
+
+    Uses `os.path`: before Python 3.14, `Path.is_dir` and `Path.is_symlink` raise
+    PermissionError under a folder that cannot be searched.
+    """
+    return not os.path.islink(path) and os.path.isdir(path)
+
+
+def first_copy_error(error: OSError) -> str:
+    """The reason of the first failed file, instead of copytree's list of all of them."""
+    # copytree collects every failed file into one shutil.Error holding a list of
+    # (source, target, reason) tuples.
+    if isinstance(error, shutil.Error) and error.args:
+        failures = error.args[0]
+        if (
+            isinstance(failures, list)
+            and failures
+            and isinstance(failures[0], tuple)
+            and len(failures[0]) == 3
+        ):
+            return str(failures[0][2])
+    return str(error)

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/_project.py

@@ -32,6 +32,17 @@ import yaml
 # ADK; new projects get the value from their template.
 DEFAULT_FRAMEWORK = "google-adk"
 
+# Values of create_params.agent_runtime.identity_default.
+AGENT_IDENTITY = "agent_identity"
+SERVICE_ACCOUNT = "service_account"
+AGENT_RUNTIME_IDENTITY_DEFAULTS = (AGENT_IDENTITY, SERVICE_ACCOUNT)
+
+# create_params the manifest keeps in a per-target section, as flat key ->
+# (section, key in the section). The flat key is the ProjectConfig field.
+NESTED_CREATE_PARAMS = {
+    "agent_runtime_identity_default": ("agent_runtime", "identity_default"),
+}
+
 
 @dataclass
 class ProjectConfig:
@@ -50,6 +61,7 @@ class ProjectConfig:
     cicd_runner: str = "skip"
     agent_gateway: bool = False
     agent_guidance_filename: str = "GEMINI.md"
+    agent_runtime_identity_default: str = SERVICE_ACCOUNT
     # The ADK name of the root agent. Empty means "derive it from the project
     # name"; see resolve_root_agent_name.
     root_agent_name: str = ""
@@ -64,6 +76,7 @@ class ProjectConfig:
             "agent_gateway": self.agent_gateway,
             "agent_guidance_filename": self.agent_guidance_filename,
             "root_agent_name": self.root_agent_name,
+            "agent_runtime_identity_default": self.agent_runtime_identity_default,
         }
 
     @classmethod
@@ -105,6 +118,24 @@ class ProjectConfig:
         cfg.agent_gateway = create_params.get("agent_gateway", cfg.agent_gateway)
         cfg.root_agent_name = create_params.get("root_agent_name") or ""
 
+        for flat_key, (section, key) in NESTED_CREATE_PARAMS.items():
+            values = create_params.get(section)
+            if values is None:
+                continue
+            if not isinstance(values, Mapping):
+                raise click.ClickException(
+                    f"malformed create_params.{section} in {filename}"
+                )
+            if key in values:
+                setattr(cfg, flat_key, values[key])
+
+        if cfg.agent_runtime_identity_default not in AGENT_RUNTIME_IDENTITY_DEFAULTS:
+            raise click.ClickException(
+                f"invalid create_params.agent_runtime.identity_default in {filename}: "
+                f"'{cfg.agent_runtime_identity_default}' is not one of "
+                f"{', '.join(AGENT_RUNTIME_IDENTITY_DEFAULTS)}"
+            )
+
         return cfg
 
 
@@ -182,7 +213,7 @@ def read_project_config(project_dir: str | None = None) -> ProjectConfig:
         return ProjectConfig()
 
 
-def _parse_version(v: str) -> tuple[int, ...]:
+def parse_version(v: str) -> tuple[int, ...]:
     """Parse a dotted numeric version into a comparable tuple.
 
     Raises ``ValueError`` on non-numeric components (e.g. a ``0.0.0-dev``
@@ -201,7 +232,7 @@ def scaffold_older_than(cfg: ProjectConfig, version: str) -> bool:
     if not cfg.acli_version:
         return False
     try:
-        return _parse_version(cfg.acli_version) < _parse_version(version)
+        return parse_version(cfg.acli_version) < parse_version(version)
     except ValueError:
         return False
 
@@ -220,8 +251,8 @@ def check_cli_version(cfg: ProjectConfig) -> None:
     from google.agents.cli import __version__
 
     try:
-        project_ver = _parse_version(acli_version)
-        cli_ver = _parse_version(__version__)
+        project_ver = parse_version(acli_version)
+        cli_ver = parse_version(__version__)
     except ValueError:
         return
 

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/_remote.py

@@ -153,7 +153,7 @@ def build_remote_headers(
     Auto-detects Google Cloud credentials unless the caller supplies
     an ``Authorization`` header via ``--header``.
 
-    Uses an **access token** for Vertex AI / Agent Runtime URLs and an
+    Uses an **access token** for Gemini platform / Agent Runtime URLs and an
     **identity token** (with the service URL as audience) for everything
     else (Cloud Run, GKE, etc.).
     """

google_agents_cli-1.10.0/src/google/agents/cli/_sdk_compat.py

@@ -0,0 +1,152 @@
+# 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.
+
+"""Gemini platform SDK features that the public SDK doesn't expose.
+
+Every private SDK module or member the CLI uses goes through here, so an SDK
+bump that breaks one of them breaks only this module (and its contract tests in
+``tests/unittests/cli/test_sdk_compat.py``). Other modules get the SDK types
+through ``google.agents.cli._agent_platform_types``, which re-exports ``types``.
+Private submodule imports are lazy, so commands that need only part of this
+module don't load the rest of the SDK.
+"""
+
+from __future__ import annotations
+
+import functools
+import time
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    # The public `agentplatform.types` is served by an untyped module
+    # `__getattr__`, which type checkers resolve to Unknown. Point them at the
+    # module it returns so the SDK models stay type-checked.
+    from agentplatform._genai import types
+    from agentplatform._genai.runtimes import Runtimes
+
+    from google.agents.cli._agent_platform import AgentPlatformClient
+else:
+
+    def __getattr__(name: str) -> Any:
+        # Lazy: `agentplatform.types` takes ~2s to import, which callers that
+        # need only the Agent Runtime or eval helpers shouldn't pay.
+        if name == "types":
+            from agentplatform import types
+
+            return types
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+# --- Agent Runtime ------------------------------------------------------------
+#
+# The SDK's public ``create()`` / ``update()`` block until the deploy finishes and
+# never return the operation, which ``--no-wait`` and ``deploy --status`` need.
+# They also can't take a custom update mask.
+
+POLL_INTERVAL_SECONDS = 10.0
+
+
+def build_config(
+    client: AgentPlatformClient, *, mode: str, **kwargs: Any
+) -> types.UpdateRuntimeConfigDict:
+    """Build the create/update request config, including its update mask."""
+    return _runtimes(client)._create_config(mode=mode, **kwargs)
+
+
+def start_create(
+    client: AgentPlatformClient, *, config: types.CreateRuntimeConfigDict
+) -> str:
+    """Start creating an Agent Runtime agent and return the operation name without waiting."""
+    return _operation_name(_runtimes(client)._create(config=config))
+
+
+def start_update(
+    client: AgentPlatformClient, *, name: str, config: types.UpdateRuntimeConfigDict
+) -> str:
+    """Start updating an Agent Runtime agent and return the operation name without waiting."""
+    return _operation_name(_runtimes(client)._update(name=name, config=config))
+
+
+def get_operation(
+    client: AgentPlatformClient, *, operation_name: str
+) -> types.RuntimeOperation:
+    """Fetch the current state of an Agent Runtime operation."""
+    return _runtimes(client)._get_agent_operation(operation_name=operation_name)
+
+
+def wait_for_operation(
+    client: AgentPlatformClient,
+    *,
+    operation_name: str,
+    poll_interval_seconds: float = POLL_INTERVAL_SECONDS,
+) -> types.RuntimeOperation:
+    """Poll an Agent Runtime operation until it is done and return it."""
+    operation = get_operation(client, operation_name=operation_name)
+    while not operation.done:
+        time.sleep(poll_interval_seconds)
+        operation = get_operation(client, operation_name=operation_name)
+    return operation
+
+
+def _operation_name(operation: types.RuntimeOperation) -> str:
+    name = getattr(operation, "name", None)
+    if not name:
+        raise RuntimeError("Gemini platform returned an operation without a name.")
+    return name
+
+
+def _runtimes(client: AgentPlatformClient) -> Runtimes:
+    # AgentPlatformClient forwards attributes untyped; naming the SDK class lets
+    # the type checker verify the private calls above against the SDK.
+    return client.runtimes
+
+
+# --- Eval ---------------------------------------------------------------------
+#
+# The SDK renders its evaluation and loss-analysis HTML reports, and lists its
+# predefined metrics, only from private modules (b/512125999).
+
+
+@functools.cache
+def supported_predefined_metrics() -> frozenset[str]:
+    """Versioned predefined metric names, e.g. ``general_quality_v1``.
+
+    The public ``types.PrebuiltMetric`` loader drops the versions and adds legacy
+    metrics, so it isn't a drop-in.
+    """
+    from agentplatform._genai._evals_constant import SUPPORTED_PREDEFINED_METRICS
+
+    return frozenset(SUPPORTED_PREDEFINED_METRICS)
+
+
+def evaluation_html(eval_result_json: str) -> str:
+    """Render the SDK's HTML report for a serialized ``EvaluationResult``."""
+    return _visualization().get_evaluation_html(eval_result_json)
+
+
+def loss_analysis_html(loss_analysis_json: str) -> str:
+    """Render the SDK's HTML report for a serialized loss-analysis response."""
+    return _visualization().get_loss_analysis_html(loss_analysis_json)
+
+
+def dataset_rows(dataset: types.EvaluationDataset) -> list[dict[str, Any]]:
+    """Flatten a dataset into the per-case rows the HTML report displays."""
+    return _visualization()._extract_dataset_rows(dataset)
+
+
+def _visualization() -> Any:
+    # Lazy: importing it loads the SDK's eval stack (litellm among others),
+    # about 3s that `eval metric list` shouldn't pay.
+    from agentplatform._genai import _evals_visualization
+
+    return _evals_visualization

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/auth.py

@@ -17,7 +17,7 @@
 Supports 3 authentication methods:
 - Google Cloud credentials (Application Default Credentials)
 - Gemini API Key from AI Studio (GEMINI_API_KEY)
-- Express Mode / Vertex AI API key (GOOGLE_API_KEY)
+- Express Mode / Gemini platform API key (GOOGLE_API_KEY)
 
 Authentication is based on environment variables and gcloud ADC.
 For API key methods, we print instructions for the user to
@@ -258,10 +258,10 @@ def _setup_gemini_api_key():
 
 # TODO(b/495501218): Re-enable Express Mode in the login menu once launched.
 def _setup_express_mode():
-    """Guide the user through Vertex AI Express Mode setup.
+    """Guide the user through setting up Express Mode in Gemini platform.
 
     Checks for GOOGLE_API_KEY env var. If not set, opens the
-    Vertex AI API keys page and prompts the user to paste a key.
+    API keys page and prompts the user to paste a key.
     Persists the key by appending to the user's shell profile.
 
     Returns:
@@ -277,7 +277,7 @@ def _setup_express_mode():
     click.echo()
 
     url = "https://cloud.google.com/vertex-ai/generative-ai/docs/start/api-keys"
-    click.echo("  We'll open the Vertex AI API keys page in your browser.")
+    click.echo("  We'll open the API keys page in your browser.")
     click.echo("  Create or copy an API key, then come back here for more instructions.")
     click.echo()
     click.secho(f"  {url}", fg="cyan")

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/data/_recipe.py

@@ -21,8 +21,8 @@ RAG_RECIPE_MESSAGE = (
     "RAG is now a clone-and-study recipe — this command has been removed.\n\n"
     "Datastore provisioning and data ingestion live in each sample's own Makefile\n"
     "(e.g. `make setup-infra`, `make data-ingestion`). Start from one of:\n"
-    "  - rag-vector-search  Vertex AI Vector Search + KFP ingestion pipeline\n"
-    "  - rag-agent-search   Agent Platform Search + managed GCS data connector\n"
+    "  - rag-vector-search  Vector Search in Gemini platform + KFP ingestion pipeline\n"
+    "  - rag-agent-search   Search in Gemini platform + managed GCS data connector\n"
     "under core/ in https://github.com/google/adk-samples\n\n"
     "See the agents-cli workflow skill (Phase 1: Study Reference Samples) for the\n"
     "clone-and-study steps."

{google_agents_cli-1.9.0 → google_agents_cli-1.10.0}/src/google/agents/cli/deploy/_cloud_validation.py

@@ -27,6 +27,7 @@ import click
 import requests
 
 from google.agents.cli._agent_platform import AgentPlatformClient
+from google.agents.cli._project import AGENT_IDENTITY
 from google.agents.cli.auth import get_access_token
 from google.agents.cli.deploy._utils import parse_secrets
 from google.agents.cli.deploy.agent_runtime import _resolve_target_agent
@@ -74,6 +75,7 @@ def validate_agent_runtime_deployment(
     secrets: str | None,
     update_only: bool,
     agent_identity: bool | None,
+    identity_type_default: str,
 ) -> None:
     """Check what an Agent Runtime deploy needs, and stop if a check fails."""
     click.echo("\n🔎 Validating the deployment (no resources are changed)...")
@@ -111,9 +113,14 @@ def validate_agent_runtime_deployment(
             update_only=update_only,
         )
         results.append(engine_result)
+    # None when the engine lookup could not run.
+    will_create = (engine is None) if engine_known else None
+
+    if will_create and agent_identity is None:
+        agent_identity = identity_type_default == AGENT_IDENTITY
 
     permissions = _deploy_permissions(
-        creates=(engine is None) if engine_known else None,
+        creates=will_create,
         update_only=update_only,
         agent_identity=agent_identity,
     )