oneharness-sdk

Async Python access to the oneharness engine, generated from and validated against the Rust-owned JSON Schema contracts. The distribution is oneharness-sdk, the import is oneharness_sdk, and every release depends on the exact same oneharness-cli version.

pip install oneharness-sdk

import asyncio

from oneharness_sdk import OneHarness


async def main() -> None:
    oneharness = OneHarness()
    report = await oneharness.run(
        {"prompt": "Summarize this repository", "harnesses": ["codex"]}
    )
    print(report["results"][0]["text"])


asyncio.run(main())

Every JSON-returning method passes --format json --compact itself, so the CLI's own default (a human-readable text view) never reaches the SDK. A run over several harnesses is a fallback chain by default — the first candidate that can run does, and the report's fallback block says which; pass "run_mode": "parallel" to run them all at once.

The client covers every verb the CLI exposes, so nothing needs a hand-built command line: run, run_mock, run_stream, list, detect, config, sync, init, usage, gate, mock, interrupt, history, history_list, history_watch, history_clear, history_migrate, history_reindex, and history_pointers. That coverage is gated, not asserted here. run_mock uses the deterministic responder shipped in the CLI; see Testing patterns. run_stream and history_watch are async iterators. Every envelope is validated before it is yielded; closing or cancelling an iterator terminates its subprocess.

An option whose name is a Python keyword takes the conventional trailing underscore — sync({"global_": True}) sends --global — and nothing else about the spelling changes.

async for envelope in oneharness.run_stream(
    {"prompt": "Inspect this repository", "harnesses": ["codex"]}
):
    if envelope["type"] == "event" and envelope["event"]["name"] == "shell":
        break

async for envelope in oneharness.history_watch(
    {"labels": {"graph": "release"}, "after": last_history_id}
):
    print(envelope["record"]["history_id"])

Python input keys are snake case and strict: unknown fields and misspellings fail before the CLI starts. Output dictionaries preserve additive fields from newer compatible CLI versions. history and history_watch raise HistoryNotFoundError when a session, record, or cursor cannot be resolved.

Metadata

Release files for oneharness-sdk 0.21.1

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

Source distribution (sdist)

Source distribution for oneharness-sdk 0.21.1
File	Size	Uploaded
oneharness_sdk-0.21.1.tar.gz	111.7 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for oneharness-sdk 0.21.1
File	Interpreter	ABI	Platform	Reset
oneharness_sdk-0.21.1-py3-none-any.whl 114.0 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 225.7 kB

Release files / oneharness_sdk-0.21.1.tar.gz

Download URL	oneharness_sdk-0.21.1.tar.gz
Size	111.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c856cb6fd2d78cc313bfacc0541b205a98163e28cf75922388a199a2a4dc70e9`
BLAKE2b-256 checksum How to use checksums	`7dd03e14fa3b399e478bd61732bca494f2b99b125cf4b608b6db88c6e8ce0cd1`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nickderobertis/oneharness
Publishing commit: github.com/nickderobertis/oneharness/tree/01f51f355f4cd75afc092b781e47d1ebc8a97b30

Workflow

Publishing configuration: github.com/nickderobertis/oneharness/blob/01f51f355f4cd75afc092b781e47d1ebc8a97b30/.github/workflows/release.yml
Publishing logs: github.com/nickderobertis/oneharness/actions/runs/36752518349/attempts/2

Artifact

Subject: oneharness_sdk-0.21.1.tar.gz
SHA-256 checksum: c856cb6fd2d78cc313bfacc0541b205a98163e28cf75922388a199a2a4dc70e9 Verifying attestations

Release files / oneharness_sdk-0.21.1-py3-none-any.whl

Download URL	oneharness_sdk-0.21.1-py3-none-any.whl
Size	114.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c316e96afc7ed5702fcd05bb140a3de0d8be53b2e56047eecfd699292e6fbf7f`
BLAKE2b-256 checksum How to use checksums	`3af6818b778dd873dec14cc153e03068c5fe72d8ab9b4f4e7001ea0e0d148780`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nickderobertis/oneharness
Publishing commit: github.com/nickderobertis/oneharness/tree/01f51f355f4cd75afc092b781e47d1ebc8a97b30

Workflow

Publishing configuration: github.com/nickderobertis/oneharness/blob/01f51f355f4cd75afc092b781e47d1ebc8a97b30/.github/workflows/release.yml
Publishing logs: github.com/nickderobertis/oneharness/actions/runs/36752518349/attempts/2

Artifact

Subject: oneharness_sdk-0.21.1-py3-none-any.whl
SHA-256 checksum: c316e96afc7ed5702fcd05bb140a3de0d8be53b2e56047eecfd699292e6fbf7f Verifying attestations