Crate oneagentgraph 

oneagentgraph composes agents into a graph, drives each member’s engine in-process — onejudge for a two-party member, oneharness for a single-sided one — and merges their outputs into one NDJSON event stream.

Every public item below is the surface named by docs/contract.md — the approved contract, committed verbatim. tests/contract.rs drives the fenced blocks out of that document through these types, so the document and this surface cannot drift.

This crate owns no harness/model/fallback logic. A graph names an oneharness config per role and side; oneharness owns identity chains, fallback, model pins, and quota classification, and onejudge owns the two-party conversation. What lives here is the composition: resolving a graph, preparing each member’s launch, supervising it, and merging every member’s output into one NDJSON event stream.

Modules

cli

The command-line argument surface.

config

The graph config schema.

control

Out-of-band turn control: where a member’s in-flight turn is addressed, and the oneharness interrupt process that redirects it.

error

The failure modes the contract names, and the exit codes they map to.

event

The shared event envelope, as this crate publishes it.

harness

Running a single-sided member through oneharness’s library, in this process.

health

health: per-identity binding, utilization, and reset.

history

history: what past runs did, read back out of the state directory.

invoke

Preparing one member for launch.

judge

Running a two-party member through onejudge’s library, in this process.

liveness

The liveness contract, ported from ai-orchestrator intact.

member

Running one member, and turning what it publishes into envelopes.

note

Role-addressed notes: an update to one party’s task, carried from outside a run into the two-party conversation that is having it.

persona

Personas: the onejudge config fragment a member layers over its base config.

preturn

Running a member’s declared pre-turn commands, and folding what they printed into the instruction that turn receives.

render

--output text: a deterministic rendering of the same events.

resolve

Turning a ConfigRef into bytes, and recording what was read.

run

Running a whole graph: dependency order, cron members, and one merged stream.

scratch

Scratch ownership, and reaping what a member left behind.

smoke

smoke: spend one real harness turn, and judge the record it left.

sweep

sweep: what scratch exists, what can be reclaimed, and what could not be examined.