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 fresh Provider Environment to each run(..., environment=...), or use environments={...} for named mounts. Harness enters and closes adapters; 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
Each built Agent includes the tool execution boundary and message integrity filter. Add Capabilities for policy, context, memory, delegation, or model recovery. Toolsets are available from a13n_harness.toolsets, and managed tool contracts from a13n_harness.tools.
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.
- 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.4.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.4.0.tar.gz | 988.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| a13n_harness-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / a13n_harness-0.4.0.tar.gz
| Download URL | a13n_harness-0.4.0.tar.gz |
|---|---|
| Size | 988.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
981b70070e9633771524f7784e2792c14539528cf9de6fa15adaf414556e6c7d
|
|
BLAKE2b-256 checksum How to use checksums |
df700d694763e8f967273da46def108dd977837971f4564cf19e4229a7a8c0f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.4.0-py3-none-any.whl
| Download URL | a13n_harness-0.4.0-py3-none-any.whl |
|---|---|
| Size | 754.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
87693d68a1d2dc3e19b306566702cb3807df86fc8b0daf9282679f314f99ecdc
|
|
BLAKE2b-256 checksum How to use checksums |
d4ca75a39a7ca1757f8ba26135efe97c5fe97adf766be353e55485758fe61d92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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}
|
