google-agents-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-agents-cli
-Version: 0.5.0
+Version: 0.5.1
 Summary: Agents CLI — Agent Development Lifecycle toolchain for ADK
 Author-email: Google LLC <agents-cli-dev-pypi@google.com>
 Requires-Python: >=3.11
@@ -21,6 +21,7 @@ Requires-Dist: backoff>=2.2.1
 Requires-Dist: requests>=2.31.0
 Requires-Dist: a2a-sdk~=0.3.22
 Requires-Dist: tomlkit>=0.13.0,<1
+Requires-Dist: psutil>=5.9.0
 Requires-Dist: ruff ; extra == "lint"
 Requires-Dist: ty ; extra == "lint"
 Requires-Dist: codespell ; extra == "lint"
@@ -196,7 +197,7 @@ We value your input — it helps us improve `agents-cli` for the community.
 
 ## Contributing
 
-The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the `.whl` file (a standard zip archive).
+The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.
 
 See the [contributing guide](CONTRIBUTING.md) for details.
 

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/README.md

@@ -164,7 +164,7 @@ We value your input — it helps us improve `agents-cli` for the community.
 
 ## Contributing
 
-The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the `.whl` file (a standard zip archive).
+The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.
 
 See the [contributing guide](CONTRIBUTING.md) for details.
 

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "google-agents-cli"
-version = "0.5.0"
+version = "0.5.1"
 description = "Agents CLI — Agent Development Lifecycle toolchain for ADK"
 readme = "README.md"
 license = "Apache-2.0"
@@ -24,6 +24,7 @@ dependencies = [
   "requests>=2.31.0",
   "a2a-sdk~=0.3.22",
   "tomlkit>=0.13.0,<1",
+  "psutil>=5.9.0",
 ]
 
 [project.urls]

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-adk-code/SKILL.md

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

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-deploy/SKILL.md

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

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-eval/SKILL.md

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

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-observability/SKILL.md

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

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-publish/SKILL.md

@@ -5,14 +5,17 @@ description: >
   "publish my ADK agent", "register an agent with Gemini Enterprise",
   "publish to Gemini Enterprise", or needs guidance on the agents-cli
   publish gemini-enterprise command.
+  Also use when the user wants to "manage agents in Agent Registry" or
+  "list/update/delete registered agents".
   Covers ADK vs A2A registration modes, programmatic and interactive usage,
-  flag reference, auto-detection from deployment metadata, and troubleshooting.
+  flag reference, auto-detection from deployment metadata, Agent Registry
+  fleet management, and troubleshooting.
   Part of the Google ADK (Agent Development Kit) skills suite.
   Do NOT use for deployment (use google-agents-cli-deploy).
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
@@ -154,6 +157,35 @@ Agent Runtime deployments may encounter "Session not found" errors with `google-
 
 ---
 
+## Managing Agents in Agent Registry
+
+Agent Registry (Preview) is the Google Cloud fleet-wide record of your agents.
+Agents deployed to a managed runtime (Agent Runtime on Gemini Enterprise
+Agent Platform) are **auto-registered** — no extra step after `agents-cli deploy`.
+Manage them with `gcloud` (requires `roles/agentregistry.editor`):
+
+```bash
+# List / filter
+gcloud alpha agent-registry agents list --project PROJECT --location LOCATION
+gcloud alpha agent-registry agents list --filter="displayName:my-agent"
+
+# Inspect
+gcloud alpha agent-registry agents describe AGENT_NAME
+
+# Update endpoint/metadata — edit the Service resource, not the Agent
+gcloud alpha agent-registry services update AGENT_NAME \
+  --display-name "..." --description "..." \
+  --interfaces "url=ENDPOINT_URL,protocol=HTTP_JSON"
+
+# Remove: delete the underlying runtime agent (auto-registered) OR, for
+# manually registered agents, delete the Service resource
+gcloud alpha agent-registry services delete AGENT_NAME
+```
+
+Docs: https://docs.cloud.google.com/agent-registry/manage-agents
+
+---
+
 ## Troubleshooting
 
 | Issue | Solution |

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-scaffold/SKILL.md

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

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/skills/google-agents-cli-workflow/SKILL.md

@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
@@ -26,8 +26,8 @@ metadata:
 **agents-cli** is a CLI and skills toolkit for building, evaluating, and deploying agents on Google Cloud using the [Agent Development Kit (ADK)](https://adk.dev/). It works with any coding agent — Gemini CLI, Claude Code, Codex, or others. Install with `uvx google-agents-cli setup`.
 
 
-> Requires: google-agents-cli ~= 0.5.0
-> If version is behind, run: uv tool install "google-agents-cli~=0.5.0"
+> Requires: google-agents-cli ~= 0.5.1
+> If version is behind, run: uv tool install "google-agents-cli~=0.5.1"
 
 > Check version: agents-cli info
 > [Install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) first if needed.

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/src/google/agents/cli/_runner.py

@@ -152,3 +152,43 @@ def popen_resolved(
         args[0] = _tools.require_tool(executable)
 
     return subprocess.Popen(args, **kwargs)
+
+
+def popen_resolved_detached(
+    args: list[str], *, resolve_executable: bool = True, **kwargs
+) -> subprocess.Popen:
+    """Wrapper around subprocess.Popen for launching detached background processes.
+
+    Handles cross-platform differences for process detaching:
+    - On POSIX, sets start_new_session=True.
+    - On Windows, sets creationflags to DETACHED_PROCESS and CREATE_NEW_PROCESS_GROUP.
+    - Ensures stdin is redirected to subprocess.DEVNULL.
+
+    Args:
+        args: Command and arguments as a list of strings.
+        resolve_executable: If True, resolve the executable path using require_tool.
+            Defaults to True.
+        **kwargs: Additional keyword arguments passed to subprocess.Popen.
+
+    Raises:
+        ToolNotFoundError: If resolve_executable is True and the tool cannot be found.
+
+    Returns:
+        Popen instance.
+    """
+    stdin = kwargs.get("stdin")
+    if stdin is not None and stdin is not subprocess.DEVNULL:
+        raise ValueError("popen_resolved_detached only supports stdin=DEVNULL.")
+    kwargs["stdin"] = subprocess.DEVNULL
+
+    if os.name == "nt":
+        # Windows-specific process creation flags for detaching
+        create_new_process_group = getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0)
+        create_no_window = getattr(subprocess, "CREATE_NO_WINDOW", 0)
+        flags = create_new_process_group | create_no_window
+        kwargs["creationflags"] = kwargs.get("creationflags", 0) | flags
+    else:
+        # POSIX way of detaching
+        kwargs["start_new_session"] = True
+
+    return popen_resolved(args, resolve_executable=resolve_executable, **kwargs)

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/src/google/agents/cli/dev/cmd_playground.py

@@ -14,6 +14,7 @@
 
 """agents-cli playground command — start local agent playground."""
 
+import os
 import shlex
 
 import click
@@ -66,9 +67,13 @@ def cmd_playground(port, host, reload_agents, trace_to_cloud):
         host,
         "--port",
         str(port),
-        "--allow_origins",
-        "*",
     ]
+
+    # A '*' value is improperly shell-expanded on Windows due to an ADK bug,
+    # see b/525208532. Work around it by only passing the flag for non-Windows.
+    if os.name != "nt":
+        args.extend(["--allow_origins", "*"])
+
     if reload_agents:
         args.append("--reload_agents")
     if trace_to_cloud:

{google_agents_cli-0.5.0 → google_agents_cli-0.5.1}/src/google/agents/cli/run/_local_server.py

@@ -17,8 +17,8 @@
 from __future__ import annotations
 
 import json
+import logging
 import os
-import signal
 import socket
 import time
 from datetime import UTC, datetime
@@ -26,8 +26,9 @@ from pathlib import Path
 from typing import NamedTuple
 
 import click
+import psutil
 
-from google.agents.cli._runner import popen_resolved
+from google.agents.cli._runner import popen_resolved_detached
 
 _PID_DIR = ".google-agents-cli"
 _PID_FILENAME = "run_server.json"
@@ -195,14 +196,12 @@ def _start_server(
 
     log_file = open(log_path, "a", encoding="utf-8")
     try:
-        proc = popen_resolved(
+        proc = popen_resolved_detached(
             cmd,
             cwd=str(project_root),
             stdout=log_file,
             stderr=log_file,
             env=env,
-            # Detach from the CLI process so the server survives after exit.
-            start_new_session=True,
         )
     finally:
         # Close the parent's copy of the fd — the child inherits its own.
@@ -321,19 +320,21 @@ def _cleanup(project_root: Path, info: dict) -> None:
     pid = info.get("pid")
     if pid:
         try:
-            os.kill(pid, signal.SIGTERM)
-        except OSError:
-            pass
-        else:
-            # Wait briefly for the process to release its port.
-            try:
-                os.waitpid(pid, os.WNOHANG)
-            except ChildProcessError:
-                # Not a direct child — fall back to a short sleep so the
-                # port is freed before we attempt to bind a new one.
-                time.sleep(0.3)
+            parent = psutil.Process(pid)
+            children = parent.children(recursive=True)
+            for child in children:
+                try:
+                    child.terminate()
+                except psutil.NoSuchProcess:
+                    pass
+            parent.terminate()
+            psutil.wait_procs([*children, parent], timeout=3)
+        except psutil.NoSuchProcess:
+            logging.warning(
+                "Local server process with PID %d not found, skipping termination.", pid
+            )
     path = _pid_file_path(project_root)
     try:
-        path.unlink()
-    except OSError:
-        pass
+        path.unlink(missing_ok=True)
+    except OSError as exc:
+        logging.warning("Failed to remove PID file %s: %s", path, exc)