agent-engine-cli 0.1.1__tar.gz

agent_engine_cli-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agent-engine-cli
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

agent_engine_cli-0.1.1/.gitignore

@@ -0,0 +1,57 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/

agent_engine_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-01-19
+
+### Added
+
+- `ae sessions list` - List active sessions for an agent
+- `ae sandboxes list` - List active sandboxes
+- `ae memories list` - List agent memories
+- Support for automatic project detection from Application Default Credentials (ADC)
+
+### Changed
+
+- Improved PyPI package metadata
+
+## [0.1.0] - 2025-01-19
+
+### Added
+
+- Initial release of Agent Engine CLI (`ae`)
+- `ae list` - List all agents in a Google Cloud project
+- `ae get` - Get details for a specific agent
+- `ae create` - Create a new agent with configurable identity type
+- `ae delete` - Delete an agent with optional force flag
+- `ae chat` - Interactive chat session with an agent (streaming support)
+- `ae version` - Display CLI version
+- Rich terminal output with tables and panels
+- Support for Google Cloud authentication via ADC

agent_engine_cli-0.1.1/CHAT_README.md

@@ -0,0 +1,107 @@
+# Agent Engine Chat Client
+
+Interactive command-line client for chatting with your deployed agent on Vertex AI Agent Engine.
+
+## Features
+
+- Clean turn-based conversation interface
+- Color-coded user and agent responses
+- Automatic session management and memory persistence
+- Streaming responses from the remote agent
+- Session saved to memory on exit
+
+## Quick Start
+
+```bash
+ae chat AGENT_ID -p PROJECT_ID -l us-central1
+```
+
+## Command-Line Options
+
+```bash
+ae chat --help
+
+Usage: ae chat [OPTIONS] AGENT_ID
+
+  Start an interactive chat session with an agent.
+
+Arguments:
+  AGENT_ID  Agent ID or full resource name [required]
+
+Options:
+  -p, --project TEXT    Google Cloud project ID [required]
+  -l, --location TEXT   Google Cloud region [required]
+  -u, --user TEXT       User ID for the chat session [default: cli-user]
+  -d, --debug           Enable verbose HTTP debug logging
+  --help                Show this message and exit.
+```
+
+## Usage Examples
+
+```bash
+# Basic chat session
+ae chat 172357243746910208 -p my-project -l us-central1
+
+# With custom user ID
+ae chat 172357243746910208 -p my-project -l us-central1 --user john@example.com
+
+# With debug logging to see HTTP requests/responses
+ae chat 172357243746910208 -p my-project -l us-central1 --debug
+```
+
+## Interactive Session
+
+1. **Start the client:**
+   ```bash
+   ae chat AGENT_ID -p PROJECT_ID -l LOCATION
+   ```
+
+2. **Chat with your agent:**
+   - Type your message and press Enter
+   - Agent responses stream in real-time
+   - Tools used by the agent are displayed
+
+3. **Exit gracefully:**
+   - Type `quit` or `exit`
+   - Or press `Ctrl+C`
+
+## Example Session
+
+```
+Ready. User: cli-user, Session: abc123...
+
+Type your message and press Enter. Type 'quit' or 'exit' to end.
+
+You: Hello! How are you?
+
+Agent: Hello! I'm doing well, thank you for asking. How can I help you today?
+
+You: What can you do?
+
+Tools: [search_documents] [get_user_info]
+
+Agent: I can help you with several things including searching documents,
+retrieving user information, and answering questions. What would you like to do?
+
+You: quit
+Chat session ended.
+```
+
+## How It Works
+
+1. Connects to your deployed Agent Engine on Vertex AI
+2. Creates a new session (or resumes existing one)
+3. Sends your messages to the remote agent
+4. Streams responses back in real-time
+5. Saves conversation to memory bank on exit
+
+## Troubleshooting
+
+**Error: "Error in chat session: ..."**
+- Check your GCP credentials: `gcloud auth application-default login`
+- Verify agent is deployed: `ae list -p PROJECT_ID -l LOCATION`
+- Ensure the agent ID is correct
+
+**No response from agent:**
+- Check your network connection
+- Verify agent is running: `ae get AGENT_ID -p PROJECT_ID -l LOCATION`

agent_engine_cli-0.1.1/CLAUDE.md

@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Agent Engine CLI (`ae`) is a command-line interface for managing Agent Engine. Built with Python using Typer for CLI framework and Rich for terminal output.
+
+## Development Commands
+
+```bash
+# Install dependencies and project in development mode
+uv sync
+
+# Run the CLI
+uv run ae --help
+
+# Run all tests
+uv run pytest
+
+# Run a specific test
+uv run pytest tests/test_main.py::test_version
+```
+
+## Architecture
+
+- **Entry point**: `src/agent_engine_cli/main.py` - Contains the Typer app instance and all CLI commands
+- **CLI binary**: Installed as `ae` via `[project.scripts]` in pyproject.toml
+- **Testing**: Uses Typer's `CliRunner` for CLI command testing

agent_engine_cli-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mirko Montanari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_engine_cli-0.1.1/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: agent-engine-cli
+Version: 0.1.1
+Summary: Command-line interface for managing Google Cloud Vertex AI Agent Engine deployments
+Project-URL: Homepage, https://github.com/mmontan/agent-engine-cli
+Project-URL: Bug Tracker, https://github.com/mmontan/agent-engine-cli/issues
+Author-email: Agent Engine Team <info@agentengine.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,agent-engine,agents,ai,automation,cli,gcp,google-cloud,llm,vertex,vertex-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: google-cloud-aiplatform>=1.133.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# Agent Engine CLI
+
+A command-line interface to manage Agent Engine.
+
+## Installation with uv
+
+This project is set up to work seamlessly with `uv`.
+
+1.  **Install uv** (if you haven't already):
+    ```bash
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    ```
+
+2.  **Create a virtual environment and install dependencies**:
+    ```bash
+    uv venv
+    source .venv/bin/activate
+    uv pip install -e .
+    ```
+
+3.  **Run the CLI**:
+    ```bash
+    ae --help
+    ```
+
+## Running Without Installation
+
+You can run the CLI directly without installing it:
+
+```bash
+# Using uv (recommended)
+uv run python -m agent_engine_cli.main --help
+
+# Or with plain Python (after installing dependencies)
+python -m agent_engine_cli.main --help
+```
+
+Example commands:
+```bash
+uv run python -m agent_engine_cli.main list -p PROJECT_ID -l us-central1
+uv run python -m agent_engine_cli.main get AGENT_ID -p PROJECT_ID -l us-central1
+```
+
+## Chat with an Agent
+
+Start an interactive chat session with a deployed agent:
+
+```bash
+# Basic usage
+ae chat AGENT_ID -p PROJECT_ID -l us-central1
+
+# With custom user ID
+ae chat AGENT_ID -p PROJECT_ID -l us-central1 --user my-user-id
+
+# With debug logging enabled
+ae chat AGENT_ID -p PROJECT_ID -l us-central1 --debug
+```
+
+## Development
+
+To run tests:
+
+```bash
+uv pip install -e ".[dev]" # or just use the dev-dependencies if using a uv-managed lockfile workflow
+# If using pure uv sync:
+uv sync
+uv run pytest
+```

agent_engine_cli-0.1.1/README.md

@@ -0,0 +1,68 @@
+# Agent Engine CLI
+
+A command-line interface to manage Agent Engine.
+
+## Installation with uv
+
+This project is set up to work seamlessly with `uv`.
+
+1.  **Install uv** (if you haven't already):
+    ```bash
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    ```
+
+2.  **Create a virtual environment and install dependencies**:
+    ```bash
+    uv venv
+    source .venv/bin/activate
+    uv pip install -e .
+    ```
+
+3.  **Run the CLI**:
+    ```bash
+    ae --help
+    ```
+
+## Running Without Installation
+
+You can run the CLI directly without installing it:
+
+```bash
+# Using uv (recommended)
+uv run python -m agent_engine_cli.main --help
+
+# Or with plain Python (after installing dependencies)
+python -m agent_engine_cli.main --help
+```
+
+Example commands:
+```bash
+uv run python -m agent_engine_cli.main list -p PROJECT_ID -l us-central1
+uv run python -m agent_engine_cli.main get AGENT_ID -p PROJECT_ID -l us-central1
+```
+
+## Chat with an Agent
+
+Start an interactive chat session with a deployed agent:
+
+```bash
+# Basic usage
+ae chat AGENT_ID -p PROJECT_ID -l us-central1
+
+# With custom user ID
+ae chat AGENT_ID -p PROJECT_ID -l us-central1 --user my-user-id
+
+# With debug logging enabled
+ae chat AGENT_ID -p PROJECT_ID -l us-central1 --debug
+```
+
+## Development
+
+To run tests:
+
+```bash
+uv pip install -e ".[dev]" # or just use the dev-dependencies if using a uv-managed lockfile workflow
+# If using pure uv sync:
+uv sync
+uv run pytest
+```

agent_engine_cli-0.1.1/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-engine-cli"
+version = "0.1.1"
+description = "Command-line interface for managing Google Cloud Vertex AI Agent Engine deployments"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  {name = "Agent Engine Team", email = "info@agentengine.ai"}
+]
+keywords = ["agent", "ai", "cli", "google-cloud", "agent-engine", "gcp", "vertex-ai", "llm", "agents", "automation", "vertex"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "requests>=2.31.0",
+    "google-cloud-aiplatform>=1.133.0",
+]
+
+[project.scripts]
+ae = "agent_engine_cli.main:app"
+
+[project.urls]
+"Homepage" = "https://github.com/mmontan/agent-engine-cli"
+"Bug Tracker" = "https://github.com/mmontan/agent-engine-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agent_engine_cli"]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]

agent_engine_cli-0.1.1/src/agent_engine_cli/__init__.py

@@ -0,0 +1,3 @@
+# Init file for agent_engine_cli
+
+__version__ = "0.1.1"