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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-agents-cli
-Version: 1.8.0
+Version: 1.9.0
 Summary: Agents CLI — Agent Development Lifecycle toolchain for ADK
 Author-email: Google LLC <agents-cli-dev-pypi@google.com>
 Requires-Python: >=3.11
@@ -210,10 +210,7 @@ See the [contributing guide](CONTRIBUTING.md) for details.
 
 ## Telemetry
 
-> **Note:** Telemetry is experimental and off by default. It only runs when
-> enabled with `AGENTS_CLI_EXPERIMENTS='{"cli_telemetry": true}'`.
-
-`agents-cli` can emit a single usage signal per command invocation to help
+By default, `agents-cli` emits a single usage signal per command invocation to help
 improve the tool and better understand how it's used. Each signal
 is a structured log entry written to **your own Google Cloud project**:
 `GOOGLE_CLOUD_PROJECT`, or else the default project of your Application Default

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

@@ -169,10 +169,7 @@ See the [contributing guide](CONTRIBUTING.md) for details.
 
 ## Telemetry
 
-> **Note:** Telemetry is experimental and off by default. It only runs when
-> enabled with `AGENTS_CLI_EXPERIMENTS='{"cli_telemetry": true}'`.
-
-`agents-cli` can emit a single usage signal per command invocation to help
+By default, `agents-cli` emits a single usage signal per command invocation to help
 improve the tool and better understand how it's used. Each signal
 is a structured log entry written to **your own Google Cloud project**:
 `GOOGLE_CLOUD_PROJECT`, or else the default project of your Application Default

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

@@ -1,6 +1,6 @@
 [project]
 name = "google-agents-cli"
-version = "1.8.0"
+version = "1.9.0"
 description = "Agents CLI — Agent Development Lifecycle toolchain for ADK"
 readme = "README.md"
 license = "Apache-2.0"
@@ -139,6 +139,7 @@ ignore = ["E501", "C901", "RUF001", "UP036", "RUF067", "RUF069"]
 [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." }
 
 [tool.ruff.lint.pylint]
 max-positional-args = 5

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

@@ -0,0 +1,31 @@
+# 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.
+
+"""Agent Platform SDK types, imported through the SDK's public path.
+
+Use ``types.EvalCase``, ``types.evals.AgentEvent``, etc. from here rather than
+importing ``agentplatform._genai`` directly.
+"""
+
+from typing import TYPE_CHECKING
+
+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  # noqa: TID251
+else:
+    from agentplatform import types
+
+__all__ = ["types"]

{google_agents_cli-1.8.0 → google_agents_cli-1.9.0}/src/google/agents/cli/_experiments.py

@@ -28,9 +28,6 @@ class Experiment(NamedTuple):
 _REGISTRY: dict[str, Experiment] = {
     # Hides the `build` command until Go (compiled-language) support launches.
     "build_command": Experiment("build_command", bool, True),
-    # Gates CLI usage telemetry (see _telemetry.py). Off by default
-    # during validation. Users can opt out via DO_NOT_TRACK / AGENTS_CLI_TELEMETRY.
-    "cli_telemetry": Experiment("cli_telemetry", bool, False),
 }
 
 

{google_agents_cli-1.8.0 → google_agents_cli-1.9.0}/src/google/agents/cli/_runner.py

@@ -14,6 +14,7 @@
 
 """Subprocess helpers for agents CLI."""
 
+import contextlib
 import io
 import os
 import shlex
@@ -222,6 +223,30 @@ def run_extension_command(
     return result.returncode
 
 
+@contextlib.contextmanager
+def _wrap_launch_errors(executable: str | None, args: list[str]):
+    """Turn a resolved tool's launch-time OSError into a ToolNotExecutableError.
+
+    On Windows, shutil.which doesn't check ACLs or security policies, so a
+    blocked tool resolves fine and only fails at launch, even with check=False.
+    Only ERROR_ACCESS_DENIED maps to PermissionError; policy blocks (e.g.
+    WinError 4551 from Application Control) surface as a plain OSError.
+    FileNotFoundError and unresolved executables (``executable is None``) keep
+    the raw error so callers' own handling still applies.
+    """
+    try:
+        yield
+    except FileNotFoundError:
+        raise
+    except (PermissionError, OSError) as e:
+        if executable is None:
+            raise
+        msg = f"'{executable}' was found at '{args[0]}' but could not be executed: {e}"
+        if _tools.is_windows():
+            msg += "\n  It may be blocked by a security policy (e.g. AppLocker, WDAC, Defender)."
+        raise _tools.ToolNotExecutableError(msg) from e
+
+
 def run_resolved(
     args: list[str], *, resolve_executable: bool = True, **kwargs
 ) -> subprocess.CompletedProcess:
@@ -235,6 +260,8 @@ def run_resolved(
 
     Raises:
         ToolNotFoundError: If resolve_executable is True and the tool cannot be found.
+        ToolNotExecutableError: If resolve_executable is True and the OS refuses
+            to execute the resolved tool.
 
     Returns:
         CompletedProcess instance.
@@ -242,13 +269,15 @@ def run_resolved(
     if isinstance(args, str):
         raise ValueError("args must be a list of strings, not a single string.")
 
+    executable = None
     if resolve_executable and args:
         executable = args[0]
         # Create a shallow copy to avoid modifying the original list passed by reference
         args = args.copy()
         args[0] = _tools.require_tool(executable)
 
-    return subprocess.run(args, **kwargs)
+    with _wrap_launch_errors(executable, args):
+        return subprocess.run(args, **kwargs)
 
 
 def popen_resolved(
@@ -264,6 +293,8 @@ def popen_resolved(
 
     Raises:
         ToolNotFoundError: If resolve_executable is True and the tool cannot be found.
+        ToolNotExecutableError: If resolve_executable is True and the OS refuses
+            to execute the resolved tool.
 
     Returns:
         Popen instance.
@@ -271,13 +302,15 @@ def popen_resolved(
     if isinstance(args, str):
         raise ValueError("args must be a list of strings, not a single string.")
 
+    executable = None
     if resolve_executable and args:
         executable = args[0]
         # Create a shallow copy to avoid modifying the original list passed by reference
         args = args.copy()
         args[0] = _tools.require_tool(executable)
 
-    return subprocess.Popen(args, **kwargs)
+    with _wrap_launch_errors(executable, args):
+        return subprocess.Popen(args, **kwargs)
 
 
 def popen_resolved_detached(
@@ -298,6 +331,8 @@ def popen_resolved_detached(
 
     Raises:
         ToolNotFoundError: If resolve_executable is True and the tool cannot be found.
+        ToolNotExecutableError: If resolve_executable is True and the OS refuses
+            to execute the resolved tool.
 
     Returns:
         Popen instance.

{google_agents_cli-1.8.0 → google_agents_cli-1.9.0}/src/google/agents/cli/_telemetry.py

@@ -76,8 +76,6 @@ class _Signal:
 _TELEMETRY_LOGS_URL = "https://telemetry.googleapis.com/v1/logs"
 # Log id: entries land at logName=projects/<project>/logs/agents-cli.
 _LOG_ID = "agents-cli"
-# Experiment label initially gating the feature.
-_EXPERIMENT = "cli_telemetry"
 # Commands we never emit signals for, matched as path prefixes: "login" also
 # covers its subcommands and an extension's override of it ("login~ext").
 _SKIP_COMMANDS = frozenset({"login", "setup"})
@@ -107,21 +105,6 @@ def _env_opted_out() -> bool:
     return False
 
 
-def is_experiment_enabled() -> bool:
-    """True if the ``cli_telemetry`` experiment is active.
-
-    Gates the whole feature: when off, telemetry never emits and
-    ``agents-cli info`` doesn't mention it at all.
-    """
-    try:
-        from google.agents.cli._experiments import resolve_experiment
-
-        return bool(resolve_experiment(_EXPERIMENT))
-    except Exception:
-        # If experiment resolution fails, treat the feature as off.
-        return False
-
-
 def is_telemetry_enabled() -> bool:
     """True if telemetry is configured to emit (not opted out).
 
@@ -129,7 +112,7 @@ def is_telemetry_enabled() -> bool:
     deliver — emission additionally requires resolvable credentials and a
     project at runtime (checked in the child process).
     """
-    return is_experiment_enabled() and not _env_opted_out()
+    return not _env_opted_out()
 
 
 def error_class_of(exc: BaseException) -> str:

{google_agents_cli-1.8.0 → google_agents_cli-1.9.0}/src/google/agents/cli/_tools.py

@@ -43,7 +43,8 @@ DEFAULT_INSTALL_HINTS = {
     "npx": "Install Node.js (https://nodejs.org/en/download) and try again.",
     "npm": "Install Node.js (https://nodejs.org/en/download) and try again.",
     "gcloud": "Install the Google Cloud SDK (https://cloud.google.com/sdk/docs/install) and ensure it is in your PATH.",
-    "terraform": "Install Terraform (https://developer.hashicorp.com/terraform/downloads) and ensure it is in your PATH.",
+    "terraform": "Install Terraform (https://developer.hashicorp.com/terraform/install) and ensure it is in your PATH.",
+    "kubectl": "Install kubectl (https://kubernetes.io/docs/tasks/tools/) and ensure it is in your PATH.",
     "gh": "Install the GitHub CLI (https://cli.github.com/) and ensure it is in your PATH.",
     "git": "Install Git (https://git-scm.com/downloads) and ensure it is in your PATH.",
     "uv": "Install uv (https://docs.astral.sh/uv/getting-started/installation/) and ensure it is in your PATH.",
@@ -59,6 +60,12 @@ class ToolNotFoundError(click.ClickException):
     pass
 
 
+class ToolNotExecutableError(click.ClickException):
+    """Raised when a required external tool is found but cannot be executed."""
+
+    pass
+
+
 @cache
 def _get_cleaned_path() -> str:
     """Returns a cleaned and expanded version of the PATH environment variable.

google_agents_cli-1.9.0/src/google/agents/cli/deploy/_agent_engines.py

@@ -0,0 +1,68 @@
+# 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.
+
+"""Agent Runtime operations that the public Agent Platform SDK doesn't expose.
+
+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.
+"""
+
+import time
+from typing import Any
+
+from google.agents.cli._agent_platform_types import types
+
+POLL_INTERVAL_SECONDS = 10.0
+
+
+def build_config(client: Any, *, mode: str, **kwargs: Any) -> dict[str, Any]:
+    """Build the create/update request config, including its update mask."""
+    return client.agent_engines._create_config(mode=mode, **kwargs)
+
+
+def start_create(client: Any, *, config: dict[str, Any]) -> str:
+    """Start creating an agent engine and return the operation name without waiting."""
+    return _operation_name(client.agent_engines._create(config=config))
+
+
+def start_update(client: Any, *, name: str, config: dict[str, Any]) -> str:
+    """Start updating an agent engine and return the operation name without waiting."""
+    return _operation_name(client.agent_engines._update(name=name, config=config))
+
+
+def get_operation(client: Any, *, operation_name: str) -> types.AgentEngineOperation:
+    """Fetch the current state of an agent engine operation."""
+    return client.agent_engines._get_agent_operation(operation_name=operation_name)
+
+
+def wait_for_operation(
+    client: Any,
+    *,
+    operation_name: str,
+    poll_interval_seconds: float = POLL_INTERVAL_SECONDS,
+) -> types.AgentEngineOperation:
+    """Poll an agent engine 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.AgentEngineOperation) -> str:
+    name = getattr(operation, "name", None)
+    if not name:
+        raise RuntimeError("Agent Platform returned an operation without a name.")
+    return name