Metadata-Version: 2.4
Name: agent-dev-cli
Version: 0.0.1b260228
Summary: AI Toolkit - CLI and SDK for agent debugging and workflow visualization
Keywords: ai,agent,toolkit,debugging,workflow,visualization
Author-email: Microsoft <aitkfeedback@microsoft.com>
Requires-Python: >=3.10.0
Description-Content-Type: text/markdown
License-Expression: LicenseRef-Microsoft-AI-Toolkit-Agent-Dev-CLI
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
License-File: LICENSE
Requires-Dist: pydantic>=2.12.4
Requires-Dist: azure-identity>=1.25.1
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: azure-ai-agents>=1.2.0b5
Requires-Dist: starlette>=0.49.3
Requires-Dist: openai>=1.109.1
Requires-Dist: agent-framework-azure-ai>=1.0.0b251211,<=1.0.0b260107
Requires-Dist: agent-framework-core>=1.0.0b251211,<=1.0.0b260107
Requires-Dist: azure-ai-agentserver-agentframework==1.0.0b14
Requires-Dist: azure-ai-agentserver-core==1.0.0b14
Requires-Dist: click>=8.1.0
Requires-Dist: azure-ai-projects>=2.0.0b2
Project-URL: Documentation, https://github.com/microsoft/vscode-ai-toolkit#readme
Project-URL: Homepage, https://github.com/microsoft/vscode-ai-toolkit
Project-URL: Issues, https://github.com/microsoft/vscode-ai-toolkit/issues
Project-URL: Repository, https://github.com/microsoft/vscode-ai-toolkit

# Agent Dev CLI

A Python CLI and SDK for agent debugging and workflow visualization with VS Code AI Toolkit integration.

## Installation

```bash
pip install agent-dev-cli --pre
```

> **Note**: This package is currently in beta. The `--pre` flag is required to install pre-release versions.

## Usage

### Option 1: CLI Wrapper (Recommended)

The easiest way to use Agent Dev CLI - **no code changes required**:

```bash
# Run your agent script with agentdev instrumentation
agentdev run my_agent.py

# Specify a custom port
agentdev run workflow.py --port 9000

# Enable verbose output
agentdev run my_agent.py --verbose

# Pass arguments to your script
agentdev run my_agent.py -- --model gpt-4 --temperature 0.7
```

The CLI automatically:
- Intercepts `from_agent_framework()` calls
- Injects agentdev visualization endpoints
- Opens the workflow visualization in VS Code

### Option 2: Programmatic API

If you prefer explicit control, you can integrate agentdev directly:

```python
from agentdev import configure_agent_server
from azure.ai.agentserver.agentframework import from_agent_framework

# Create your agent
agent = build_agent(chat_client)

# Create agent server
agent_server = from_agent_framework(agent)

# Setup workflow visualization
configure_agent_server(agent_server)

# Run the server
await agent_server.run_async()
```

## CLI Commands

### `agentdev run`

Run a Python agent script with agentdev instrumentation.

```
agentdev run [OPTIONS] SCRIPT [ARGS]...

Options:
  -p, --port INTEGER    Agent server port (default: 8087)
  -v, --verbose         Enable verbose output
  --help                Show this message and exit
```

### `agentdev info`

Show agentdev configuration and status information.

```
agentdev info
```

## Features

- **Health Check Endpoint**: Adds a `/agentdev/health` endpoint to your agent server
- **Workflow Visualization**: Starts a visualization server on port 8090 for WorkflowAgent instances
- **Easy Integration**: Simple one-function setup

## Testing Your Agent Server

Once your agent server is running, you can test it using curl:

```bash
# Health check
curl http://localhost:8087/agentdev/health

# Send a request to your agent (streaming)
curl 'http://localhost:8087/agentdev/v1/responses' \
  -H 'Content-Type: application/json' \
  -d '{"model":"your-agent-model-id","input":{"role":"user","text":"Hello!"},"stream":true}'
```

## Requirements

- Python 3.10+
- [VS Code AI Toolkit](https://marketplace.visualstudio.com/items?itemName=ms-windows-ai-studio.windows-ai-studio) (for visualization)

## License

This project is licensed under the **Microsoft AI Toolkit – Agent Dev CLI License Terms**.

