Crate aion_integrations 

Harness-integration SDK for Aion — the inbound analogue of aion-client.

Where aion-client is the SDK for a caller driving Aion, aion-integrations is the SDK for an agent harness Aion drives. It defines the harness-neutral extension seam an integrator implements — the AgentHarness / AgentSession traits — plus the reusable machinery an adapter would otherwise hand-roll, and it re-exports the neutral aion-core types so an integrator has a single dependency.

The seam

Implement AgentHarness (in a separate adapter crate) to teach Aion how to run one agent harness for one activity attempt. The seam is harness-blind by construction: no signature names a concrete harness, a transport, or a wire protocol. A session:

• advertises which neutral intervention primitives it supports via AgentSession::capabilities — an empty set is first-class (an observability-only harness supports no interventions),
• streams neutral ActivityEvents OUT via AgentSession::events,
• accepts neutral InterventionCommands IN via AgentSession::intervene, and
• yields a single terminal Payload via AgentSession::wait_result.

Building blocks

• jsonrpc — a generic JSON-RPC 2.0 over newline-delimited stdio helper (envelopes, id correlation, a single serializing writer) that any stdio-JSON-RPC adapter reuses. It is machinery, not a harness: it names no concrete harness and no method namespace.

Re-exported neutral types

The neutral aion-core types the integration surface speaks are re-exported from the crate root (a curated re-export, the aion-client house style — not a blanket pub use aion_core), so an integrator depends only on aion-integrations.

Re-exports

pub use contract::AgentHarness;

pub use contract::AgentSession;

pub use contract::DynAgentHarness;

pub use contract::DynAgentSession;

pub use envelope_delta::Compaction;

pub use envelope_delta::EnvelopeDeltaDecoder;

pub use envelope_delta::EnvelopeDeltaEncoder;

pub use envelope_delta::ResolvedEnvelope;

pub use envelope_delta::UnresolvedDelta;

pub use environment::ChildEnvironment;

pub use environment::EnvironmentDeclaration;

pub use environment::EnvironmentError;

pub use environment::process_environment;

pub use error::HarnessError;

pub use error::PolicyRefusalDetection;

pub use spec::AgentRunSpec;

pub use workspace::HarnessWorkspace;

Modules

contract

The harness-integration seam: the AgentHarness / AgentSession traits. The harness-integration seam: the AgentHarness trait an integrator implements and the live AgentSession it produces.

envelope_delta

Persisting a turn’s repeated provider response envelopes once instead of once per frame. Envelope-delta persistence for repeated provider response envelopes.

environment

The DECLARED environment a harness subprocess is launched with. The DECLARED environment a harness subprocess is launched with.

error

The harness-neutral error taxonomy for the seam. The harness-neutral error taxonomy for the integration seam.

jsonrpc

A generic JSON-RPC 2.0 over newline-delimited stdio building block. A generic, harness-neutral JSON-RPC 2.0 over newline-delimited stdio helper.

spec

The neutral run identity handed to a harness at start. The neutral run identity handed to a harness at crate::AgentHarness::start.

workspace

Where one attempt’s working directory comes from: the worker, or the work. Where one attempt’s working directory comes from, and how it is obtained.

Structs

ActivityEvent

A live transcript event for one (workflow, run, activity, attempt) produced by an agent harness.

ActivityId

Identifier for an activity scheduled within a workflow history.

AgentOutcome

The canonical agent-outcome record: what a completed agent activity’s result payload carries, from every harness.

InterventionCapabilities

The set of neutral intervention primitives a harness advertises support for.

InterventionCommand

A mid-run control command routed operator -> server -> the worker owning the activity-attempt.

Payload

Type-erased user data with an explicit content type tag.

RunId

Identifier for a concrete run of a logical workflow.

WorkflowId

Identifier for a logical workflow.

Enums

ActivityEventKind

The payload of an ActivityEvent — the classified kind of transcript signal.

ApprovalDecision

A decision answering a pending human-in-the-loop approval gate.

ContentType

Stable tag describing the encoding used for a payload’s bytes.

InjectPriority

Priority of an injected out-of-band message.

InterventionKind

The complete set of harness-neutral mid-run control primitives.

InterventionPrimitive

A single neutral intervention primitive, independent of any command payload.

MessageRole

The role a conversational message is attributed to.

ProgressDetail

A fine-grained progress signal within an activity attempt.

StopKind

Why an agent run reached a terminal boundary.