Metadata-Version: 2.4
Name: steerplane
Version: 0.2.0
Summary: Agent Control Plane for Autonomous Systems — Runtime guards, loop detection, cost limits, and telemetry for AI agents.
Author-email: SteerPlane <hello@steerplane.ai>
License-Expression: MIT
Project-URL: Homepage, https://steerplane.ai
Project-URL: Documentation, https://docs.steerplane.ai
Project-URL: Repository, https://github.com/vijaym2k6/SteerPlane
Project-URL: Issues, https://github.com/vijaym2k6/SteerPlane/issues
Keywords: ai,agents,guard,safety,monitoring,telemetry,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"

# SteerPlane SDK

**Agent Control Plane for Autonomous Systems**

> "Agents don't fail in the dark anymore."

## Quick Start

```bash
pip install steerplane
```

### Decorator API (Minimal Integration)

```python
from steerplane import guard

@guard(max_cost_usd=10, max_steps=50)
def run_agent():
    agent.run()
```

### Context Manager API (Full Control)

```python
from steerplane import SteerPlane

sp = SteerPlane(agent_id="my_bot")

with sp.run(max_cost_usd=10) as run:
    run.log_step("query_db", tokens=380, cost=0.002)
    run.log_step("generate_response", tokens=1240, cost=0.008)
```

## Features

- 🔄 **Loop Detection** — Automatically detects repeating agent behavior
- 💰 **Cost Limits** — Stop expensive agent runs before they blow budgets
- 🚫 **Step Limits** — Prevent runaway execution
- 📊 **Telemetry** — Full step-by-step execution tracking
- 🖥️ **Dashboard** — Visual execution monitoring

## Documentation

See [docs.steerplane.ai](https://docs.steerplane.ai) for full documentation.
