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

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.

Metadata

Release files for a13n-harness 0.9.2

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

Source distribution (sdist)

Source distribution for a13n-harness 0.9.2
File	Size	Uploaded
a13n_harness-0.9.2.tar.gz	1.1 MB	Oct 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for a13n-harness 0.9.2
File	Interpreter	ABI	Platform	Reset
a13n_harness-0.9.2-py3-none-any.whl 808.8 kB Oct 11, 2026	Python 3	none	any	Details

Total release size: 1.9 MB

Release files / a13n_harness-0.9.2.tar.gz

Download URL	a13n_harness-0.9.2.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`3ff1b5302d1c9fe810f2a754e7c5df28b0deed981c034f4258f2a3c0763b49e1`
BLAKE2b-256 checksum How to use checksums	`f54d542cae9576d9c96c27d9bdafd37770b7e3bd46dec6525618337b7744797f`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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.9.2-py3-none-any.whl

Download URL	a13n_harness-0.9.2-py3-none-any.whl
Size	808.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2e28b5e4f961bbc308c2677ed4b9c665c1451455663e305efc7657fdf9d355d7`
BLAKE2b-256 checksum How to use checksums	`cab52ede654afab496ba65498ff5f3374da27cb8c3c74e7f81207cf81525f342`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}`