Metadata-Version: 2.4
Name: agent-control-server
Version: 7.8.1
Summary: Server for Agent Control - manage and evaluate controls for AI agents
Author: Agent Control Team
License: Apache-2.0
Requires-Python: >=3.12
Requires-Dist: agent-control-evaluators>=7.8.1
Requires-Dist: alembic>=1.13.0
Requires-Dist: asyncpg>=0.29.0
Requires-Dist: fastapi>=0.109.0
Requires-Dist: google-re2>=1.1
Requires-Dist: greenlet>=3.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: jsonschema-rs>=0.22.0
Requires-Dist: jsonschema>=4.25.1
Requires-Dist: psycopg[binary]>=3.1
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: starlette-exporter>=0.23.0
Requires-Dist: uvicorn[standard]>=0.27.0
Provides-Extra: galileo
Requires-Dist: agent-control-evaluator-galileo>=7.8.1; extra == 'galileo'
Description-Content-Type: text/markdown

# Agent Control Server

FastAPI server that powers Agent Control. It manages agents and controls, evaluates requests at runtime, and exposes REST APIs used by the SDKs and UI.

## What it provides

- Agent registration and control association
- Control CRUD and evaluator configuration
- Runtime evaluation (`/api/v1/evaluation`) with pre/post stages
- Observability endpoints for events and stats
- API key authentication for production deployments

## Quick start (local)

From the repo root:

```bash
make sync
make server-run
```

Server runs on http://localhost:8000. The UI expects this base URL by default.

To use non-default local ports with `make server-run`, export
`AGENT_CONTROL_PORT` for the server listen port. If you also want the local
Postgres container exposed on a different host port, set
`AGENT_CONTROL_DB_HOST_PORT` and point the server at the same value with
`AGENT_CONTROL_DB_PORT`.

## Database migrations

The server package includes the `agent-control-migrate` command for bundled
Alembic migrations.

In production, migrations are serialized with a Postgres advisory lock. Alembic
runs each migration revision in its own transaction, so if an upgrade across
multiple revisions fails, earlier revisions may already be committed. Check the
current revision before retrying:

```bash
agent-control-migrate current
agent-control-migrate upgrade head
```

## Configuration

Server configuration is driven by environment variables (database, auth, observability, evaluators). For the full list and examples, see the docs.

Full guide: https://docs.agentcontrol.dev/components/server
