Agent Harness
Harness (a13n-harness) is the embeddable execution SDK behind Harness UI and Service. It builds reusable agents, runs them with current tools and Environments, streams observations, and returns state for continuation. Start with the offline quickstart; the Python import is a13n_harness.
Capability composition
Build an AgentSpec with only the behavior your application needs. For example, to expose Environment tools and working state:
from a13n_harness import AgentSpec, HarnessBuilder
from a13n_harness.capabilities import WorkingStateCapability
from a13n_harness.environment import DynamicEnvironmentCapability, DynamicEnvironmentConfiguration
executable = HarnessBuilder().build(
AgentSpec(model="openai-responses:gpt-5"),
output_type=str,
capabilities=(
DynamicEnvironmentCapability(DynamicEnvironmentConfiguration()),
WorkingStateCapability(),
),
)
Supply a Host-owned EnvironmentSource to each run(..., environment=...), or use environments={...} for named mounts. Harness prepares targets on first use and opens and closes fresh executions; your application selects their configuration, current state, access policy, and when to destroy a backing target. See Environments and Capabilities.
Model construction
Pass a native model directly through HarnessBuilder.build(model=...), or select one in AgentSpec.model. a13n_harness.infer_model() constructs a model from supported aliases and caller-owned provider factories. create_model_http_client() builds a caller-owned httpx2 client for provider requests. Configure credentials and close owned clients in your application. See Models and Model authentication.
Execution boundary and filters
Harness prepares images for the selected Model without changing saved history or original files. Configure HarnessModelCharacteristics.image_input with ImageInputPolicy, or set image_input=None to disable preparation. See Context.
Recognized provider-history repairs are on by default; configure them through SelfHealingModelCapability or disable automatic installation with HarnessBuilder(self_healing_enabled=False). For long Threads, opt into history compaction. Add other Capabilities for policy, memory, or delegation.
A completed Run returns a HarnessState with a stable thread_id. Pass it as previous_state to continue the Thread; each new Run receives a fresh run_id. The Host persists accepted state and reconstructs credentials and other current authority on resume. State and resume covers serialization and interrupted calls.
Runnable examples and guides
- Agent application: offline streaming turns, checkpointing, and restart recovery.
- Environment Providers: construction, re-entry, and lifecycle.
- Plugins and extensions: packaged middleware, Capabilities, and Environment integrations.
- MCP tools: an in-process server and an offline Model, followed by Host-owned clients and per-Run headers.
- Harness guide: the public API by task.
Versioning
Harness and a13n-stream-protocol publish together at one exact version. Harness UI releases independently. The Harness specification owns the accepted contracts.
1 maintainer
Metadata
1 maintainer
Release files for a13n-harness 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| a13n_harness-0.12.0.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| a13n_harness-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / a13n_harness-0.12.0.tar.gz
| Download URL | a13n_harness-0.12.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
598cab01e058f981b7069bf41880a06a326a8c6a888bf59c7d4f5e22e9edb07d
|
|
BLAKE2b-256 checksum How to use checksums |
cb979fec805495afceeee9ff0e54788c46c36126e6d07b1cc53e408f75d9d604
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / a13n_harness-0.12.0-py3-none-any.whl
| Download URL | a13n_harness-0.12.0-py3-none-any.whl |
|---|---|
| Size | 842.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ae5dd7c267390f46985f034adcd573f486510068e1bf9392cde773c80e90cd4d
|
|
BLAKE2b-256 checksum How to use checksums |
18ace361d62a6428b86bdcd8d7690401396374f74e8873a437b82b210faff37f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
