Skip to main content

Agent Control Models

Shared Pydantic models used by the server and SDKs. These models define the API contract for agents, controls, evaluation requests, and responses.

What this package provides

  • Strongly typed request/response schemas
  • Consistent validation and serialization across server and SDKs
  • A single source of truth for model changes

Usage

from agent_control_models import Agent, Step

agent = Agent(agent_name="support-bot", agent_description="Support agent")
step = Step(type="llm", name="chat", input="hello")

Control execution duration

Evaluation responses include an optional top-level execution_duration_ms on each ControlMatch in matches, non_matches, and errors. It measures that control's condition evaluation in wall-clock milliseconds, including the visited condition leaves, evaluator work, and time waiting for an evaluator concurrency slot. Control loading and request/response overhead are outside this measurement.

Completed evaluations include a nonnegative value, including evaluator failures. Precheck failures have no duration, and canceled evaluations produce no result. Older responses without the field remain valid. The Python SDK copies the value to ControlExecutionEvent.execution_duration_ms; the TypeScript SDK exposes it as executionDurationMs.

Tests

cd models
uv run pytest

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

Metadata

Release files for agent-control-models 8.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-control-models 8.12.0
File Size Uploaded
agent_control_models-8.12.0.tar.gz 34.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-control-models 8.12.0
File Interpreter ABI Platform
agent_control_models-8.12.0-py3-none-any.whl Python 3 none any Details

Total release size: 67.7 kB

Release files / agent_control_models-8.12.0.tar.gz

Download URL agent_control_models-8.12.0.tar.gz
Size 34.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e7f0da402d33a0203ed8bbffea76df950d75c1e016d5f171902ab38ef1b4e3a8
BLAKE2b-256 checksum
How to use checksums
ac7083424f8353149021d11d664b670621a91e73e36c1a361cdd839abfcc123a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / agent_control_models-8.12.0-py3-none-any.whl

Download URL agent_control_models-8.12.0-py3-none-any.whl
Size 33.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e41a3fe276ea02018d8eb0181f77d7a23bd85f095561ceb5f1ab446e31ba5f96
BLAKE2b-256 checksum
How to use checksums
b804171a9347099d49769ef5b14be6a23a8715730873b6d2fb5a39bed0c97605
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

8.13.0

2 release files

This release

8.12.0 This release

2 release files

8.9.0

2 release files

8.8.0

2 release files

8.7.0

2 release files

8.6.0

2 release files

8.5.0

2 release files

8.4.0

2 release files

8.3.0

2 release files

8.2.0

2 release files

8.1.2

2 release files

8.1.1

2 release files

8.1.0

2 release files

8.0.0

2 release files

7.10.0

2 release files

7.9.0

2 release files

7.8.1

2 release files

7.8.0

2 release files

7.7.0

2 release files

7.6.0

2 release files

7.5.0

2 release files

7.4.1

2 release files

7.4.0

2 release files

7.3.2

2 release files

7.3.1

2 release files

7.3.0

2 release files

7.2.0

2 release files

7.1.0

2 release files

7.0.0

2 release files

6.8.1

2 release files

6.8.0

2 release files

6.7.2

2 release files

6.7.1

2 release files

6.7.0

2 release files

6.6.2

2 release files

6.6.1

2 release files

6.6.0

2 release files

6.5.0

2 release files

6.4.0

2 release files

6.3.0

2 release files

6.1.0

2 release files

6.0.0

2 release files

5.2.0

2 release files

5.1.0

2 release files

5.0.0

2 release files

4.0.0

2 release files

3.0.0

2 release files

2.1.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.1.4

2 release files

1.1.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page