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-harnessUse 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
ModelProviderover 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.
- Authority
Policy - One explicit authority policy layer; grants intersect and denials always win.
- Capabilities
- Deterministic capability set.
- Conversation
- Typed handle to one durable conversation.
- Conversation
Id - Identity of one durable conversation.
- Effect
Attempt Id - Identity of one dispatch attempt for an effect.
- Effect
Id - Identity of one external effect.
- Idempotency
Key - Caller-selected identity used to reconcile uncertain admission.
- Interaction
Id - Identity of one typed open interaction.
- Operation
Id - Identity assigned before an operation is admitted.
- Policy
Layer - One named layer in an explicit authority chain.
- Protocol
Identity - Stable wire identity used during compatibility handshakes.
- Session
- Typed handle to one durable execution session.
- Session
Id - 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.
- Authority
Level - 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.