Skip to main content

Crate acyclic_harness

Crate acyclic_harness 

Source
Expand description

§acyclic-harness

Provider-neutral durable substrate and composable agent runtime. The deterministic core semantics are separate from live helpers: a Rust future is not automatically a durable operation.

cargo add acyclic-harness

Use the core contracts to define tasks, resource references, and replayable operations. Enable only the adapters you deploy: filesystem (with optional filesystem-local), machines, models (OpenAI-compatible model providers such as OpenRouter), http, or grpc. Each adapter is a module of this crate, not a separate package. The custom executor example shows composition. See the Rust API for feature-gated modules and the Harness protocol for wire semantics.

Re-exports§

pub use live::TaskGroup;
pub use live::TaskHandle;
pub use live::completion_stream;
pub use live::first_success;
pub use live::join_all;
pub use live::quorum;
pub use live::recursive_sum;

Modules§

bundle
Code-defined named bundles; bundles are constructors, not a configuration language.
context
Ordered function-based context assembly.
core
Deterministic, host-neutral durable substrate semantics.
distributed
Customer-hostable Stream-backed coordinator and pull-worker admission.
effects
Replaceable external effect providers with explicit guarantees and reconciliation.
executor
Fully replaceable turn execution and the stock streaming model/tool loop.
filesystem
Versioned filesystem workspace adapter.
fork
Atomic publication manifest for prepared environment forks.
grpc
gRPC server and client adapter.
http
HTTP, SSE, and WebSocket server adapter.
interaction
Typed, durable, executor-neutral open interactions.
live
Live-only bounded execution for arbitrary Rust futures.
machines
Replaceable machines provider adapter.
model
Provider-neutral immutable model values and streaming host contract.
models
Model adapters that implement the Harness ModelProvider over third-party inference APIs.
registry
Version-pinned runtime registrations with drain-before-replacement lifecycle.
resources
Provider-neutral references to state owned by other Acyclic SDK families.
scheduler
Deterministic durable scheduling and structured orchestration semantics.
speculation
Speculative execution: several attempts at one task, each on its own workspace fork, with one judged winner merged into the target workspace.
store
Direct Stream persistence for durable aggregate histories.
tool
Independently replaceable tool definitions, executors, and projections.
wire
Generated Protobuf envelopes shared by every transport.
wire_api
Transport-neutral server port implemented identically by every wire adapter.
workflow
Explicit versioned resumable state machines for durable authoring.

Structs§

Agent
Typed handle to one durable agent definition.
AgentId
Identity of one agent definition.
AuthorityPolicy
One explicit authority policy layer; grants intersect and denials always win.
Capabilities
Deterministic capability set.
Conversation
Typed handle to one durable conversation.
ConversationId
Identity of one durable conversation.
EffectAttemptId
Identity of one dispatch attempt for an effect.
EffectId
Identity of one external effect.
IdempotencyKey
Caller-selected identity used to reconcile uncertain admission.
InteractionId
Identity of one typed open interaction.
OperationId
Identity assigned before an operation is admitted.
PolicyLayer
One named layer in an explicit authority chain.
ProtocolIdentity
Stable wire identity used during compatibility handshakes.
Session
Typed handle to one durable execution session.
SessionId
Identity of one live conversation session.
Task
Typed handle to one durable general-purpose task.
TaskId
Identity of one general task.
Turn
Typed handle to one durable user-driven turn.
TurnId
Identity of one user-driven turn.

Enums§

Admission
One admission result per submitted input.
AuthorityLevel
Ordered authority-resolution level from the runtime root to one invocation.
Error
Errors shared by harness surfaces.
Outcome
Terminal outcome of admitted work.

Constants§

FILE_DESCRIPTOR_SET
Canonical harness descriptor set used for transport compatibility.

Functions§

encode_error
Converts a semantic error without losing storage or indeterminate state.
resolve_policies
Resolves runtime → invocation policy layers without ambient authority.
resolve_policy_layers
Validates hierarchy order and resolves the exact effective grant.

Type Aliases§

Result
Harness result type.