Skip to main content

Crate arabica_protocol

Crate arabica_protocol 

Source
Expand description

Canonical wire contract for Structure.

Every UI sends CommandEnvelope values and observes EventEnvelope values. Runtime, session, and runner modules must not invent parallel wire types.

Modules§

lrp
Loop–Runner Protocol (LRP) wire types.

Structs§

CommandEnvelope
CommandFailure
A command rejected before it can produce a session-scoped event.
CommandId
ContextDecision
ContextEntry
ContextIdentity
ContextRunSnapshot
EventEnvelope
EventId
EventMetadata
PlanEntry
One durable item in the agent’s current plan.
ProtocolSchemaDocument
RunId
SessionId
WorkspaceId

Enums§

AgentLoopTerminationReason
Command
ContextDecisionReason
ContextItemType
ContextMode
Only exposure mode changes; policy enablement remains a separate decision.
ContextSourceKind
DisclosureLevel
ErrorCode
Event
ModelCallOutcome
ModelResponseRejectionReason
OutputStream
PlanEntryStatus
RunStatus
SessionStatus
TerminalControllerPolicy
Runtime-owned terminal control policy, recorded in canonical Events so experiments can prove that memory arms used identical control.
TerminalControllerState
TerminalControllerTransitionReason
ToolInteractionKind
Provider- and runner-neutral retention semantics for one tool interaction. Concrete runners classify their own tools; Runtime memory policy consumes this typed event and never parses tool arguments.
ToolPermissionOutcome
Whether a tool call was allowed to run.
ToolPermissionScope
How long a permission decision applies.
ToolPermissionSource
Who or what produced a permission decision.

Constants§

PROTOCOL_VERSION

Functions§

event_trace_v1
Project an ordered, single-session event stream. Returns no partial trace when its one MiB bound is exceeded. Source envelopes remain authoritative. Every protocol event has a record, including variants added in the future.
protocol_schema
Export the complete protocol schema used by code generators and hosts.
trace_atom_v1
UTF-8 percent encoding keeps record and path separators unambiguous.