agent-starter-pack 0.17.4__py3-none-any.whl → 0.18.0__py3-none-any.whl

agent_starter_pack/base_template/Makefile

@@ -127,6 +127,8 @@ playground-remote: build-frontend-if-needed
 	@echo "==============================================================================="
 	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode remote
 {%- endif %}
+{%- endif %}
+{%- if cookiecutter.is_adk_live and cookiecutter.deployment_target == 'agent_engine' %}
 
 # Start the frontend UI separately for development (requires backend running separately)
 ui:
@@ -226,3 +228,20 @@ lint:
 	uv run ruff check . --diff
 	uv run ruff format . --check --diff
 	uv run mypy .
+{%- if cookiecutter.is_adk and cookiecutter.deployment_target == 'agent_engine' %}
+
+# ==============================================================================
+# Gemini Enterprise Integration
+# ==============================================================================
+
+# Register the deployed agent to Gemini Enterprise
+# Usage: make register-gemini-enterprise GEMINI_ENTERPRISE_APP_ID=projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine_id} [AGENT_ENGINE_ID=<id>]  # Defaults to deployment_metadata.json
+register-gemini-enterprise:
+	uvx --from agent-starter-pack agent-starter-pack-register-gemini-enterprise \
+		$(if $(GEMINI_ENTERPRISE_APP_ID),--gemini-enterprise-app-id="$(GEMINI_ENTERPRISE_APP_ID)",) \
+		$(if $(AGENT_ENGINE_ID),--agent-engine-id="$(AGENT_ENGINE_ID)",) \
+		$(if $(GEMINI_DISPLAY_NAME),--display-name="$(GEMINI_DISPLAY_NAME)",) \
+		$(if $(GEMINI_DESCRIPTION),--description="$(GEMINI_DESCRIPTION)",) \
+		$(if $(GEMINI_TOOL_DESCRIPTION),--tool-description="$(GEMINI_TOOL_DESCRIPTION)",) \
+		$(if $(GEMINI_AUTHORIZATION_ID),--authorization-id="$(GEMINI_AUTHORIZATION_ID)",)
+{%- endif %}

agent_starter_pack/base_template/README.md

@@ -59,16 +59,21 @@ make install && make playground
 {%- endif %}
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 | `make playground`    | Launch local development environment with backend and frontend{%- if cookiecutter.is_adk %} - leveraging `adk web` command. {%- endif %}|
-| `make backend`       | Deploy agent to Cloud Run (use `IAP=true` to enable Identity-Aware Proxy) |
-| `make local-backend` | Launch local development server |
-{%- if cookiecutter.deployment_target == 'cloud_run' %}
-{%- if cookiecutter.is_adk_live %}
-| `make ui`       | Launch Agent Playground front-end only |
-{%- endif %}
-{%- endif %}
+| `make backend`       | Deploy agent to Cloud Run (use `IAP=true` to enable Identity-Aware Proxy, `PORT=8080` to specify container port) |
+| `make local-backend` | Launch local development server with hot-reload |
 {%- elif cookiecutter.deployment_target == 'agent_engine' %}
 | `make playground`    | Launch Streamlit interface for testing agent locally and remotely |
 | `make backend`       | Deploy agent to Agent Engine |
+{%- if cookiecutter.is_adk_live %}
+| `make local-backend` | Launch local development server with hot-reload |
+| `make ui`            | Start the frontend UI separately for development (requires backend running separately) |
+| `make playground-dev` | Launch dev playground with both frontend and backend hot-reload |
+| `make playground-remote` | Connect to remote deployed agent with local frontend |
+| `make build-frontend` | Build the frontend for production |
+{%- endif %}
+{%- if cookiecutter.is_adk %}
+| `make register-gemini-enterprise` | Register deployed agent to Gemini Enterprise (see Makefile for parameters) |
+{%- endif %}
 {%- endif %}
 | `make test`          | Run unit and integration tests                                                              |
 | `make lint`          | Run code quality checks (codespell, ruff, mypy)                                             |
@@ -76,7 +81,6 @@ make install && make playground
 {%- if cookiecutter.data_ingestion %}
 | `make data-ingestion`| Run data ingestion pipeline in the Dev environment                                           |
 {%- endif %}
-| `uv run jupyter lab` | Launch Jupyter notebook                                                                     |
 
 For full command options and usage, refer to the [Makefile](Makefile).
 

agent_starter_pack/cli/utils/register_gemini_enterprise.py

@@ -0,0 +1,406 @@
+#!/usr/bin/env python3
+# Copyright 2025 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
+#
+#     http://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.
+
+"""Utility to register an Agent Engine to Gemini Enterprise."""
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+import requests
+import vertexai
+from google.auth import default
+from google.auth.transport.requests import Request as GoogleAuthRequest
+
+
+def get_agent_engine_id(
+    agent_engine_id: str | None, metadata_file: str = "deployment_metadata.json"
+) -> str:
+    """Get the agent engine ID from parameter or deployment metadata.
+
+    Args:
+        agent_engine_id: Optional agent engine resource name
+        metadata_file: Path to deployment metadata JSON file
+
+    Returns:
+        The agent engine resource name
+
+    Raises:
+        ValueError: If agent_engine_id is not provided and metadata file doesn't exist
+    """
+    if agent_engine_id:
+        return agent_engine_id
+
+    # Try to read from deployment_metadata.json
+    metadata_path = Path(metadata_file)
+    if not metadata_path.exists():
+        raise ValueError(
+            f"No agent engine ID provided and {metadata_file} not found. "
+            "Please provide --agent-engine-id or deploy your agent first."
+        )
+
+    with open(metadata_path) as f:
+        metadata = json.load(f)
+        return metadata["remote_agent_engine_id"]
+
+
+def get_access_token() -> str:
+    """Get Google Cloud access token.
+
+    Returns:
+        Access token string
+
+    Raises:
+        SystemExit: If authentication fails
+    """
+    try:
+        credentials, _ = default()
+        auth_req = GoogleAuthRequest()
+        credentials.refresh(auth_req)
+        return credentials.token
+    except Exception as e:
+        print(f"Error getting access token: {e}", file=sys.stderr)
+        print(
+            "Please ensure you are authenticated with 'gcloud auth application-default login'",
+            file=sys.stderr,
+        )
+        raise RuntimeError("Failed to get access token") from e
+
+
+def get_agent_engine_metadata(agent_engine_id: str) -> tuple[str | None, str | None]:
+    """Fetch display_name and description from deployed Agent Engine.
+
+    Args:
+        agent_engine_id: Agent Engine resource name
+
+    Returns:
+        Tuple of (display_name, description) - either can be None if not found
+    """
+    parts = agent_engine_id.split("/")
+    if len(parts) < 6:
+        return None, None
+
+    project_id = parts[1]
+    location = parts[3]
+
+    try:
+        client = vertexai.Client(project=project_id, location=location)
+        agent_engine = client.agent_engines.get(name=agent_engine_id)
+
+        display_name = getattr(agent_engine.api_resource, "display_name", None)
+        description = getattr(agent_engine.api_resource, "description", None)
+
+        return display_name, description
+    except Exception as e:
+        print(
+            f"Warning: Could not fetch metadata from Agent Engine: {e}", file=sys.stderr
+        )
+        return None, None
+
+
+def register_agent(
+    agent_engine_id: str,
+    gemini_enterprise_app_id: str,
+    display_name: str,
+    description: str,
+    tool_description: str,
+    project_id: str | None = None,
+    authorization_id: str | None = None,
+) -> dict:
+    """Register an agent engine to Gemini Enterprise.
+
+    This function attempts to create a new agent registration. If the agent is already
+    registered (same reasoning engine), it will automatically update the existing
+    registration instead.
+
+    Args:
+        agent_engine_id: Agent engine resource name (e.g., projects/.../reasoningEngines/...)
+        gemini_enterprise_app_id: Full Gemini Enterprise app resource name
+            (e.g., projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine_id})
+        display_name: Display name for the agent in Gemini Enterprise
+        description: Description of the agent
+        tool_description: Description of what the tool does
+        project_id: Optional GCP project ID for billing (extracted from agent_engine_id if not provided)
+        authorization_id: Optional OAuth authorization ID
+            (e.g., projects/{project_number}/locations/global/authorizations/{auth_id})
+
+    Returns:
+        API response as dictionary
+
+    Raises:
+        requests.HTTPError: If the API request fails
+        ValueError: If gemini_enterprise_app_id format is invalid
+    """
+    # Parse Gemini Enterprise app resource name
+    # Format: projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine_id}
+    parts = gemini_enterprise_app_id.split("/")
+    if (
+        len(parts) != 8
+        or parts[0] != "projects"
+        or parts[2] != "locations"
+        or parts[4] != "collections"
+        or parts[6] != "engines"
+    ):
+        raise ValueError(
+            f"Invalid GEMINI_ENTERPRISE_APP_ID format. Expected: "
+            f"projects/{{project_number}}/locations/{{location}}/collections/{{collection}}/engines/{{engine_id}}, "
+            f"got: {gemini_enterprise_app_id}"
+        )
+
+    project_number = parts[1]
+    as_location = parts[3]
+    collection = parts[5]
+    engine_id = parts[7]
+
+    # Use project from agent engine if not explicitly provided (for billing header)
+    if not project_id:
+        # Extract from agent_engine_id: projects/{project}/locations/{location}/reasoningEngines/{id}
+        agent_parts = agent_engine_id.split("/")
+        if len(agent_parts) > 1 and agent_parts[0] == "projects":
+            project_id = agent_parts[1]
+        else:
+            # Fallback to the project number from the Gemini Enterprise App ID.
+            project_id = project_number
+
+    # Get access token
+    access_token = get_access_token()
+
+    # Build API endpoint
+    url = (
+        f"https://discoveryengine.googleapis.com/v1alpha/projects/{project_number}/"
+        f"locations/{as_location}/collections/{collection}/engines/{engine_id}/"
+        "assistants/default_assistant/agents"
+    )
+
+    # Request headers
+    headers = {
+        "Authorization": f"Bearer {access_token}",
+        "Content-Type": "application/json",
+        "x-goog-user-project": project_id,
+    }
+
+    # Request body
+    adk_agent_definition: dict = {
+        "tool_settings": {"tool_description": tool_description},
+        "provisioned_reasoning_engine": {"reasoningEngine": agent_engine_id},
+    }
+
+    # Add OAuth authorization if provided
+    if authorization_id:
+        adk_agent_definition["authorizations"] = [authorization_id]
+
+    payload = {
+        "displayName": display_name,
+        "description": description,
+        "icon": {
+            "uri": "https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/smart_toy/default/24px.svg"
+        },
+        "adk_agent_definition": adk_agent_definition,
+    }
+
+    print("Registering agent to Gemini Enterprise...")
+    print(f"  Agent Engine: {agent_engine_id}")
+    print(f"  Gemini Enterprise App: {gemini_enterprise_app_id}")
+    print(f"  Display Name: {display_name}")
+    print(f"  API Endpoint: {url}")
+
+    try:
+        # Try to create a new registration first
+        response = requests.post(url, headers=headers, json=payload, timeout=30)
+        response.raise_for_status()
+
+        result = response.json()
+        print("\n✅ Successfully registered agent to Gemini Enterprise!")
+        print(f"   Agent Name: {result.get('name', 'N/A')}")
+        return result
+
+    except requests.exceptions.HTTPError as http_err:
+        # Check if the error is because the agent already exists
+        if response.status_code in (400, 409):
+            try:
+                error_data = response.json()
+                error_message = error_data.get("error", {}).get("message", "")
+
+                # Check if error indicates the agent already exists
+                if (
+                    "already exists" in error_message.lower()
+                    or "duplicate" in error_message.lower()
+                ):
+                    print(
+                        "\n⚠️  Agent already registered. Updating existing registration..."
+                    )
+
+                    # For update, we need to use the specific agent resource name
+                    # The agent name should be in the error or we can construct it
+                    # Format: {url}/{agent_id} but we need to find existing agent first
+
+                    # List existing agents to find the one for this reasoning engine
+                    list_response = requests.get(url, headers=headers, timeout=30)
+                    list_response.raise_for_status()
+                    agents_list = list_response.json().get("agents", [])
+
+                    # Find the agent that matches our reasoning engine
+                    existing_agent = None
+                    for agent in agents_list:
+                        re_name = (
+                            agent.get("adk_agent_definition", {})
+                            .get("provisioned_reasoning_engine", {})
+                            .get("reasoningEngine", "")
+                        )
+                        if re_name == agent_engine_id:
+                            existing_agent = agent
+                            break
+
+                    if existing_agent:
+                        agent_name = existing_agent.get("name")
+                        update_url = f"https://discoveryengine.googleapis.com/v1alpha/{agent_name}"
+
+                        print(f"  Updating agent: {agent_name}")
+
+                        # PATCH request to update
+                        update_response = requests.patch(
+                            update_url, headers=headers, json=payload, timeout=30
+                        )
+                        update_response.raise_for_status()
+
+                        result = update_response.json()
+                        print(
+                            "\n✅ Successfully updated agent registration in Gemini Enterprise!"
+                        )
+                        print(f"   Agent Name: {result.get('name', 'N/A')}")
+                        return result
+                    else:
+                        print(
+                            "\n❌ Could not find existing agent to update",
+                            file=sys.stderr,
+                        )
+                        raise
+            except (ValueError, KeyError):
+                # Failed to parse error response, raise original error
+                pass
+
+        # If not an "already exists" error, or update failed, raise the original error
+        print(f"\n❌ HTTP error occurred: {http_err}", file=sys.stderr)
+        print(f"   Response: {response.text}", file=sys.stderr)
+        raise
+    except requests.exceptions.RequestException as req_err:
+        print(f"\n❌ Request error occurred: {req_err}", file=sys.stderr)
+        raise
+
+
+def main() -> None:
+    """Main entry point for CLI."""
+    parser = argparse.ArgumentParser(
+        description="Register an Agent Engine to Gemini Enterprise"
+    )
+    parser.add_argument(
+        "--agent-engine-id",
+        help="Agent Engine resource name (e.g., projects/.../reasoningEngines/...). "
+        "If not provided, reads from deployment_metadata.json",
+    )
+    parser.add_argument(
+        "--metadata-file",
+        default="deployment_metadata.json",
+        help="Path to deployment metadata file (default: deployment_metadata.json)",
+    )
+    parser.add_argument(
+        "--gemini-enterprise-app-id",
+        help="Gemini Enterprise app full resource name "
+        "(e.g., projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine_id}). "
+        "Can also be set via GEMINI_ENTERPRISE_APP_ID env var",
+    )
+    parser.add_argument(
+        "--display-name",
+        help="Display name for the agent. Can also be set via GEMINI_DISPLAY_NAME env var",
+    )
+    parser.add_argument(
+        "--description",
+        help="Description of the agent. Can also be set via GEMINI_DESCRIPTION env var",
+    )
+    parser.add_argument(
+        "--tool-description",
+        help="Description of what the tool does. Can also be set via GEMINI_TOOL_DESCRIPTION env var",
+    )
+    parser.add_argument(
+        "--project-id",
+        help="GCP project ID (extracted from agent-engine-id if not provided). "
+        "Can also be set via GOOGLE_CLOUD_PROJECT env var",
+    )
+    parser.add_argument(
+        "--authorization-id",
+        help="OAuth authorization resource name "
+        "(e.g., projects/{project_number}/locations/global/authorizations/{auth_id}). "
+        "Can also be set via GEMINI_AUTHORIZATION_ID env var",
+    )
+
+    args = parser.parse_args()
+
+    # Get agent engine ID
+    try:
+        agent_engine_id = get_agent_engine_id(args.agent_engine_id, args.metadata_file)
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # Auto-detect display_name and description from Agent Engine
+    auto_display_name, auto_description = get_agent_engine_metadata(agent_engine_id)
+
+    gemini_enterprise_app_id = args.gemini_enterprise_app_id or os.getenv(
+        "GEMINI_ENTERPRISE_APP_ID"
+    )
+    if not gemini_enterprise_app_id:
+        print(
+            "Error: --gemini-enterprise-app-id or GEMINI_ENTERPRISE_APP_ID env var required",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    display_name = (
+        args.display_name
+        or os.getenv("GEMINI_DISPLAY_NAME")
+        or auto_display_name
+        or "My Agent"
+    )
+    description = (
+        args.description
+        or os.getenv("GEMINI_DESCRIPTION")
+        or auto_description
+        or "AI Agent"
+    )
+    tool_description = (
+        args.tool_description or os.getenv("GEMINI_TOOL_DESCRIPTION") or description
+    )
+    project_id = args.project_id or os.getenv("GOOGLE_CLOUD_PROJECT")
+    authorization_id = args.authorization_id or os.getenv("GEMINI_AUTHORIZATION_ID")
+
+    try:
+        register_agent(
+            agent_engine_id=agent_engine_id,
+            gemini_enterprise_app_id=gemini_enterprise_app_id,
+            display_name=display_name,
+            description=description,
+            tool_description=tool_description,
+            project_id=project_id,
+            authorization_id=authorization_id,
+        )
+    except Exception as e:
+        print(f"Error during registration: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

agent_starter_pack/cli/utils/remote_template.py

@@ -204,7 +204,7 @@ def check_and_execute_with_version_lock(
 
         try:
             # Execute uvx with the locked version
-            cmd = ["uvx", f"agent-starter-pack=={version}", *original_args]
+            cmd = ["uvx", f"agent-starter-pack@{version}", *original_args]
             logging.debug(f"Executing nested command: {' '.join(cmd)}")
             subprocess.run(cmd, check=True)
             return True

agent_starter_pack/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/utils/deployment.py

@@ -71,8 +71,10 @@ def print_deployment_success(
         location: GCP region where the agent was deployed
         project: GCP project ID
     """
-    # Extract agent engine ID for console URL
-    agent_engine_id = remote_agent.api_resource.name.split("/")[-1]
+    # Extract agent engine ID and project number for console URL
+    resource_name_parts = remote_agent.api_resource.name.split("/")
+    agent_engine_id = resource_name_parts[-1]
+    project_number = resource_name_parts[1]
     console_url = f"https://console.cloud.google.com/vertex-ai/agents/locations/{location}/agent-engines/{agent_engine_id}?project={project}"
 
 {%- if cookiecutter.is_adk %}
@@ -83,12 +85,15 @@ def print_deployment_success(
         "\n✅ Deployment successful! Test your agent: notebooks/adk_app_testing.ipynb"
     )
 {%- endif %}
-    service_account = remote_agent.api_resource.spec.service_account
-    print(f"Service Account: {service_account}")
-    print(f"\n📊 View in console: {console_url}\n")
 {%- else %}
     print("\n✅ Deployment successful!")
+{%- endif %}
     service_account = remote_agent.api_resource.spec.service_account
-    print(f"Service Account: {service_account}")
+    if service_account:
+        print(f"Service Account: {service_account}")
+    else:
+        default_sa = (
+            f"service-{project_number}@gcp-sa-aiplatform-re.iam.gserviceaccount.com"
+        )
+        print(f"Service Account: {default_sa}")
     print(f"\n📊 View in console: {console_url}\n")
-{%- endif %}

{agent_starter_pack-0.17.4.dist-info → agent_starter_pack-0.18.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.17.4
+Version: 0.18.0
 Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -11,6 +11,7 @@ Requires-Dist: click>=8.1.7
 Requires-Dist: cookiecutter<3.0.0,>=2.6.0
 Requires-Dist: google-cloud-aiplatform>=1.120.0
 Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: requests>=2.31.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: tomli>=1.1.0; python_version < '3.11'
 Provides-Extra: jupyter
@@ -45,7 +46,7 @@ Focus on your agent logic—the starter pack provides everything else: infrastru
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
-| [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
+| [Pre-built agent templates](./agent_starter_pack/agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
 
 ---
 

{agent_starter_pack-0.17.4.dist-info → agent_starter_pack-0.18.0.dist-info}/RECORD

@@ -35,8 +35,8 @@ agent_starter_pack/agents/langgraph_base_react/notebooks/evaluating_langgraph_ag
 agent_starter_pack/agents/langgraph_base_react/tests/integration/test_agent.py,sha256=xy0A_3eGhxM8A5rc81revMztJN5GtFA-o5-CG5JzeQw,1630
 agent_starter_pack/base_template/.gitignore,sha256=Fq0w34x4sfbwP4RqDqh6hdHNYRUEsFNI-9XONzLWBIs,2580
 agent_starter_pack/base_template/GEMINI.md,sha256=ApNsGamVPBsrKeI77p6QxU2-sJE6k3wGwSLVvNa-YGA,126
-agent_starter_pack/base_template/Makefile,sha256=cOuwlWgMY1Gr5oBpgH5vZUDx2igM2RRTceEinDcZCww,11765
-agent_starter_pack/base_template/README.md,sha256=EqNrXQ9MZAk0fm2wd69bqaoJ-YYhFiAJstB4NYt8KkM,10122
+agent_starter_pack/base_template/Makefile,sha256=rp3abDY_70bChSYM5wpIkPi59LAvneWId36zZ6yNkhY,13017
+agent_starter_pack/base_template/README.md,sha256=MjDtgCPrmkXj70EMv0RkZk7022uljCc0yKLM-l-8ubM,10513
 agent_starter_pack/base_template/pyproject.toml,sha256=Tc1hPD-o8GtU6YJAkkB2JagTJ5aObdjmjCZuGB4oCb0,3028
 agent_starter_pack/base_template/deployment/README.md,sha256=gZJvSWdQh_Mi-bZ3dmuPv7fMezIw04fgN5tq7KgglPw,692
 agent_starter_pack/base_template/deployment/terraform/apis.tf,sha256=KX8Oe2gjT-gh9Bkntz9yIAyRjPc1gZvwOhroJ6NZVp4,1513
@@ -78,7 +78,8 @@ agent_starter_pack/cli/utils/cicd.py,sha256=l9hPdqFXo5SxdtOG1yEoQdmRff5vNcqf0sqx
 agent_starter_pack/cli/utils/datastores.py,sha256=gv1V6eDcOEKx4MRNG5C3Y-VfixYq1AzQuaYMLp8QRNo,1058
 agent_starter_pack/cli/utils/gcp.py,sha256=N6pvNU9gT6DpS7Peipfs57ckvqcUWU7OK1zdqBcQV0M,9276
 agent_starter_pack/cli/utils/logging.py,sha256=61ulUY1hUrpxHDFi0szqsjPlrpxdBvwzfYEEV0o97GA,3530
-agent_starter_pack/cli/utils/remote_template.py,sha256=CD5imiJPGIMVRhGOCiB11oFsz9Pusy_A2kdxsvMfscE,24129
+agent_starter_pack/cli/utils/register_gemini_enterprise.py,sha256=KV9loXLjro4ZtSxvQAQ4Jhw4ZPmkLR2MZ3LtMQG6p1o,14865
+agent_starter_pack/cli/utils/remote_template.py,sha256=lWfC1_Vx_m4SD-wVHb8tiGfobOH1-o_eWaM1264rwGs,24128
 agent_starter_pack/cli/utils/template.py,sha256=9U3eZOqISbCQ-uOmGwLCWagTDjaGPmIKqiei1XiID8w,52459
 agent_starter_pack/cli/utils/version.py,sha256=F4udQmzniPStqWZFIgnv3Qg3l9non4mfy2An-Oveqmc,2916
 agent_starter_pack/data_ingestion/README.md,sha256=LNxSQoJW9JozK-TbyGQLj5L_MGWNwrfLk6V6RmQ2oBQ,4032
@@ -96,7 +97,7 @@ agent_starter_pack/deployment_targets/agent_engine/tests/load_test/README.md,sha
 agent_starter_pack/deployment_targets/agent_engine/tests/load_test/load_test.py,sha256=sZewuwPQwgrfaYCo7IjIhIN9REFXP-rhJbtW236EuGA,9110
 agent_starter_pack/deployment_targets/agent_engine/tests/load_test/.results/.placeholder,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agent_starter_pack/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/agent_engine_app.py,sha256=qKEz1z2pD5IpFBq7IhT0GtFpPdbUu54gca10qZKe6Yw,13246
-agent_starter_pack/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/utils/deployment.py,sha256=KwhRqgnTr6JsmVt6BG5zy8wH1sC_mlu5oEgh7L83ERk,3226
+agent_starter_pack/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/utils/deployment.py,sha256=NdpTwLig1p8jcmpuykacudMYJ7BfpOgvKyD6As6lw1I,3367
 agent_starter_pack/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/utils/{% if cookiecutter.is_adk_live %}expose_app.py{% else %}unused_expose_app.py{% endif %},sha256=6o6CBsQblSL919-ag5WcshQBYc3mrIBuyhfxWI0Cmkg,19446
 agent_starter_pack/deployment_targets/cloud_run/Dockerfile,sha256=GExFR0dSpkTzvzmeE3siGaoXCWp7zKJoB4Uguo0oZhk,1423
 agent_starter_pack/deployment_targets/cloud_run/deployment/terraform/service.tf,sha256=xBFjT7QGKjMkN2MW40eE22odbyZmvbujkxjAqUN2TNY,11097
@@ -152,12 +153,7 @@ agent_starter_pack/frontends/streamlit/frontend/utils/message_editing.py,sha256=
 agent_starter_pack/frontends/streamlit/frontend/utils/multimodal_utils.py,sha256=v6YbCkz_YcnEo-9YvRjwBNt0SzU4M39bYxJGmKk69vE,7313
 agent_starter_pack/frontends/streamlit/frontend/utils/stream_handler.py,sha256=-XVRfLH6ck1KP6NS4vrhcvPyZe6z3NLHliEg17s9jjo,12551
 agent_starter_pack/frontends/streamlit/frontend/utils/title_summary.py,sha256=B0cadS_KPW-tsbABauI4J681aqjEtuKFDa25e9R1WKc,3030
-agent_starter_pack/resources/containers/data_processing/Dockerfile,sha256=VoB9d5yZiiWnqRfWrIq0gGNMzZg-eVy733OgP72ZgO0,950
-agent_starter_pack/resources/containers/e2e-tests/Dockerfile,sha256=yA3HxeX0HNpl8B4oEQUICCVZDCXdRn2Igmii4jt-r7k,1895
 agent_starter_pack/resources/docs/adk-cheatsheet.md,sha256=YSfJd0KER3xkwq6Uy7TC-TaiOdGpj9OrXnvm_wNILdA,71562
-agent_starter_pack/resources/idx/idx-template.json,sha256=EuiZ_v__1Zourbz4F8fjutNKNSvLGc6HFRW2_4vVSuM,377
-agent_starter_pack/resources/idx/idx-template.nix,sha256=cI35oMmMzgsDRMQgIBmMLtAUczIFramAkA2iBpq_o14,811
-agent_starter_pack/resources/idx/.idx/dev.nix,sha256=chSxdz-b06y76Mdbb9zjxUJtI3CN4lBVqiZ0rO7PktE,2356
 agent_starter_pack/resources/locks/uv-adk_base-agent_engine.lock,sha256=Bmj-6hVfUiS6GDi8_6eHhMAFsmDefxTjrhBeIHOKyOs,588363
 agent_starter_pack/resources/locks/uv-adk_base-cloud_run.lock,sha256=b4nJ8YTXPp6nQypbA4wz0wNwTH318qOUbfMHIiMoOf0,776457
 agent_starter_pack/resources/locks/uv-adk_live-agent_engine.lock,sha256=tMOwue7BrFYYJUbOaYvjar0xIhrB4wglljVcm-pXTM0,589379
@@ -172,8 +168,8 @@ agent_starter_pack/utils/generate_locks.py,sha256=LwR46w25CV0_ySF_MS9W2vp7S1Nf17
 agent_starter_pack/utils/lock_utils.py,sha256=vqFHTN7lju9to74MKOmLvz80BA47G0CVkxrd1MyLWYQ,2309
 agent_starter_pack/utils/watch_and_rebuild.py,sha256=1hMn29eLpVblfvixV9FEo46u8efmnLuRIn-bPrfdW3g,6694
 llm.txt,sha256=z9FTkAnj3cErCzHj3IES9eB35wW3JGaVsd8a0wA7IMs,15380
-agent_starter_pack-0.17.4.dist-info/METADATA,sha256=mt4AxsXueS2RD43q0LrYqOe5daJUR63K3UNDITu50gU,11210
-agent_starter_pack-0.17.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.17.4.dist-info/entry_points.txt,sha256=QLSX_97UynG0vLpoZ3ePfyCQkaR-g0qglp2b26G4KHQ,71
-agent_starter_pack-0.17.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.17.4.dist-info/RECORD,,
+agent_starter_pack-0.18.0.dist-info/METADATA,sha256=RpChhntaC0gs-hncyXjrYiCSl0W23PmZXCf9Cyz_TZE,11261
+agent_starter_pack-0.18.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.18.0.dist-info/entry_points.txt,sha256=LO_oGmY1IdlFJRF9s7oIL3qdewC8Q9UtmTV6jWVZq3U,180
+agent_starter_pack-0.18.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.18.0.dist-info/RECORD,,

agent_starter_pack-0.18.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+agent-starter-pack = agent_starter_pack.cli.main:cli
+agent-starter-pack-register-gemini-enterprise = agent_starter_pack.cli.utils.register_gemini_enterprise:main

agent_starter_pack/resources/containers/data_processing/Dockerfile

@@ -1,27 +0,0 @@
-# Copyright 2025 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
-#
-#     http://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.
-
-FROM python:3.11-slim
-
-RUN pip install --no-cache-dir \
-    "bigframes==1.36.0" \
-    "langchain==0.3.18" \
-    "markdownify==0.14.1" \
-    "swifter==1.4.0" \
-    "google-cloud-aiplatform>=1.80.0" \
-    "kfp>=1.4.0" \
-    "google-cloud-discoveryengine==0.13.6" \
-    "backoff==2.2.1" \
-    "google-cloud-pipeline-components==2.19.0" \
-    "langchain-google-vertexai==2.0.13"

agent_starter_pack/resources/containers/e2e-tests/Dockerfile

@@ -1,41 +0,0 @@
-# Stage 1: Builder - Prepare APT repositories
-FROM ghcr.io/astral-sh/uv:python3.11-bookworm-slim AS builder
-
-# Install tools needed to add repositories
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends \
-    ca-certificates \
-    curl \
-    gnupg && \
-    # GitHub CLI
-    curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg && \
-    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" > /etc/apt/sources.list.d/github-cli.list && \
-    # Google Cloud SDK
-    curl -sS https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && \
-    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" > /etc/apt/sources.list.d/google-cloud-sdk.list && \
-    # Terraform
-    curl -fsSL https://apt.releases.hashicorp.com/gpg | gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg && \
-    echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com bookworm main" > /etc/apt/sources.list.d/hashicorp.list && \
-    # Clean up builder stage
-    apt-get clean && \
-    rm -rf /var/lib/apt/lists/*
-
-# Stage 2: Final Image
-FROM ghcr.io/astral-sh/uv:python3.11-bookworm-slim
-
-# Copy repository configurations from the builder stage
-COPY --from=builder /etc/apt/sources.list.d/ /etc/apt/sources.list.d/
-COPY --from=builder /usr/share/keyrings/ /usr/share/keyrings/
-
-# Install the final packages
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends \
-    gh \
-    google-cloud-cli \
-    terraform \
-    make \
-    nodejs \
-    npm && \
-    # Clean up apt cache
-    apt-get clean && \
-    rm -rf /var/lib/apt/lists/*

agent_starter_pack/resources/idx/.idx/dev.nix

@@ -1,64 +0,0 @@
-
-# To learn more about how to use Nix to configure your environment
-# see: https://firebase.google.com/docs/studio/customize-workspace
-{ pkgs, ... }: {
-  # Which nixpkgs channel to use.
-  channel = "stable-24.11"; # or "unstable"
-
-  # Use https://search.nixos.org/packages to find packages
-  packages = [
-    pkgs.uv
-    pkgs.gnumake
-    pkgs.terraform
-    pkgs.gh
-  ];
-  # Sets environment variables in the workspace
-  env = {};
-  idx = {
-    # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
-    extensions = [
-    ];
-    workspace = {
-      # Runs when a workspace is first created with this `dev.nix` file
-      onCreate = {
-        create-venv = ''
-        # Load environment variables from .env file if it exists
-        source .env
-
-        # Beautiful prints for gcloud setup
-        echo ""
-        echo "╔════════════════════════════════════════════════════════════╗"
-        echo "║                  🔐 GCLOUD SETUP REQUIRED                  ║"
-        echo "╚════════════════════════════════════════════════════════════╝"
-        echo ""
-        echo "📝 Before proceeding, please ensure:"
-        echo "   1️⃣  You are logged in to gcloud"
-        echo "   2️⃣  You have selected the correct project"
-        echo ""
-
-        auth_status=$(gcloud auth list --quiet 2>&1)
-
-        echo ""
-        echo "⚙️  We will now set the project you want to use..."
-        gcloud config get project
-
-        echo ""
-        echo "💡 Need to setup? Run these commands:"
-        echo "   → gcloud auth login"
-        echo "   → gcloud config set project YOUR_PROJECT_ID"
-        echo ""
-
-        echo "Running agent starter pack creation..."
-        uvx agent-starter-pack create $WS_NAME
-        code ~/$WS_NAME/$WS_NAME/README.md
-        exec bash
-        '';
-        # Open editors for the following files by default, if they exist:
-        default.openFiles = [];
-      };
-      # To run something each time the workspace is (re)started, use the `onStart` hook
-    };
-    # Enable previews and customize configuration
-    previews = {};
-  };
-}

agent_starter_pack/resources/idx/idx-template.json

@@ -1,6 +0,0 @@
-{
-  "name": "Agent Starter Pack",
-  "description": "Production-ready Gen AI Agent templates for Google Cloud. Addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.",
-  "icon": "https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/icon.png?raw=true",
-  "params": []
-}

agent_starter_pack/resources/idx/idx-template.nix

@@ -1,25 +0,0 @@
-
-# No user-configurable parameters
-# Accept additional arguments to this template corresponding to template
-# parameter IDs
-{ pkgs, agent_name ? "", google_cloud_project_id ? "", ... }: {
-  # Shell script that produces the final environment
-  bootstrap = ''
-    # Copy the folder containing the `idx-template` files to the final
-    # project folder for the new workspace. ${./.} inserts the directory
-    # of the checked-out Git folder containing this template.
-    cp -rf ${./.} "$out"
-
-    # Set some permissions
-    chmod -R +w "$out"
-
-    # Create .env file with the parameter values
-    cat > "$out/.env" << EOF
-    WS_NAME=$WS_NAME
-    EOF
-
-    # Remove the template files themselves and any connection to the template's
-    # Git repository
-    rm -rf "$out/.git" "$out/idx-template".{nix,json}
-  '';
-}

agent_starter_pack-0.17.4.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-agent-starter-pack = agent_starter_pack.cli.main:cli