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.
1 maintainer
Metadata
1 maintainer
Release files for oneharness-sdk 0.25.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| oneharness_sdk-0.25.2.tar.gz | 117.6 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| oneharness_sdk-0.25.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 236.7 kB
Release files / oneharness_sdk-0.25.2.tar.gz
| Download URL | oneharness_sdk-0.25.2.tar.gz |
|---|---|
| Size | 117.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5ac3336ecb13e9da87b1d36ac42155bf704be88d9bba2395a9d529dbabdf4ae2
|
|
BLAKE2b-256 checksum How to use checksums |
ffe10a945e686b3d4ad6c9fabdd2f593d35930e6ee904a5d97d7acc070202849
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / oneharness_sdk-0.25.2-py3-none-any.whl
| Download URL | oneharness_sdk-0.25.2-py3-none-any.whl |
|---|---|
| Size | 119.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7c075fe83d82986971ee9eacebc2897ca23fac89d0a0831c3b1199a673044c5f
|
|
BLAKE2b-256 checksum How to use checksums |
71d05d082b8d78c731ceeddf209a599458cbe2afbae3e1d84a813c9bff643c70
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logSecurity for oneharness-sdk 0.25.2
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for oneharness_sdk-0.25.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
