Expand description
§Orchestral Runtime
Thread Runtime with concurrency, interruption, scheduling, LLM planners, built-in actions, context building, and application-layer API.
Modules§
- action
- Orchestral Actions
- agent
- api
- context
- Orchestral Context
- planner
- Planner implementations for Orchestral.
- sdk
- SDK builder for programmatic Orchestral setup.
- skill
Structs§
- Action
Context - Execution context for actions
- Action
Execution Options - Action
Input - Input data for action execution
- Action
Meta - Action metadata for planner
- Action
Registry - Action registry for looking up actions by name
- Blob
Head - Blob metadata fetched from physical backend.
- BlobId
- Strongly-typed blob id.
- Blob
Meta - Blob metadata.
- Blob
Read - Read result.
- Blob
Write Request - Write request.
- Cancellation
Token - A token which can be used to signal a cancellation request to one or more tasks.
- Component
Registry - Continuation
State - Structured stage exit state consumed by runtime.
- DagNode
- A node in the execution DAG
- Default
Concurrency Policy - Default concurrency policy: Interrupt and start new
- Default
Runtime Component Factory - Default component factory providing in-memory stores and blob storage.
- Execution
Dag - Execution DAG - supports dynamic modification
- Execution
Progress Event - Realtime execution progress event.
- Executor
- The executor - orchestrates DAG execution
- Executor
Context - Executor context
- History
Item - A single item in the conversation history
- Hook
Execution Policy - Hook
Registry - InMemory
Blob Store - Intent
- User intent - the first-class input of the system
- Intent
Context - Additional context for an intent
- Interaction
- Interaction - a single trigger → response attempt
- Interaction
Id - Strongly-typed Interaction ID.
- Interpret
Request - Input payload for result interpretation.
- Interpret
Result - Output payload from interpreter.
- Merge
Concurrency Policy - Merge policy: Merge new inputs into the running interaction.
- Noop
Result Interpreter - Deterministic fallback interpreter.
- Normalized
Plan - Normalized plan ready for execution
- Orchestrator
- Orchestrator - wires runtime + planner + executor for a minimal pipeline
- Parallel
Concurrency Policy - Parallel policy: Allow multiple interactions to run in parallel
- Plan
- Execution plan - the primary asset of the system
- Plan
Normalizer - Plan normalizer - the stability core
- Planner
Context - Context provided to the planner
- Planner
Loop Context - Agent-loop execution state surfaced back into the planner.
- Planner
Runtime Info - Runtime host info visible to planner prompt.
- Queue
Concurrency Policy - Queue policy placeholder.
- Reject
When Busy Concurrency Policy - Reject policy: Reject new inputs when busy
- Running
State - Running state information for concurrency decisions
- Runtime
App - Running app bundle created from unified config.
- Runtime
Build Request - Runtime
Hook Context - Runtime
Hook Event Envelope - Single
Action - Planner single-action output.
- SpiMeta
- Step
- A single step in the execution plan
- StepId
- Strongly-typed Step ID.
- Store
Bundle - Task
- Task - the stateful execution context
- TaskId
- Strongly-typed Task ID.
- Thread
- Thread - a long-lived context where interactions take place
- Thread
Id - Strongly-typed Thread ID.
- Thread
Runtime - ThreadRuntime - manages thread lifecycle and interaction concurrency
- Thread
Runtime Config - Configuration for ThreadRuntime
- Verify
Decision - Structured verify result. This is the only terminal done gate.
- Working
Set - Working set - weakly-typed KV data container for inter-step communication
Enums§
- Action
Result - Action execution result with retry semantics
- Blob
IoError - Storage-neutral blob errors.
- Bootstrap
Error - Runtime bootstrap errors.
- Concurrency
Decision - Decision on how to handle concurrent interactions
- Continuation
Status - Explicit continuation decision emitted by a completed stage.
- Event
- Event - append-only fact record
- Execution
Result - Execution result
- FixError
- Fix errors
- Handle
Event Result - Result of handling an event
- Hook
Dispatch Mode - Hook
Failure Policy - Interaction
State - Interaction state
- Interpret
Error - Result interpreter errors.
- Node
State - Node state in the execution DAG
- Normalize
Error - Normalization errors
- Orchestrator
Error - Orchestrator errors
- Orchestrator
Result - Orchestrator result for a handled event
- Plan
Error - Planner errors
- Planner
Output - Runtime
Error - Runtime errors
- Scope
- Data scope for WorkingSet Avoids naming conflicts and data pollution
- SpiError
- Step
Kind - Step type - distinguishes control semantics
- Store
Error - Store error types
- Task
State - Task state machine - production-ready states
- Validation
Error - Validation errors
- Verify
Status - Final verification verdict.
Traits§
- Action
- Action trait - the core abstraction for atomic execution units
- Blob
Store - Blob store abstraction.
- Concurrency
Policy - Concurrency policy trait
- Event
Store - EventStore trait - async interface for event storage
- Execution
Progress Reporter - Sink interface for execution progress reporting.
- Interpret
Delta Sink - Plan
Fixer - Plan fixer trait
- Plan
Validator - Plan validator trait
- Planner
- Planner trait - generates execution plans from user intent
- Result
Interpreter - Interpreter trait.
- Runtime
Component Factory - Runtime
Hook - Task
Store - TaskStore trait - async interface for task persistence
Type Aliases§
- Action
Call - Legacy alias preserved while call sites migrate.
- Action
Preflight Hook - Blob
Stream - Streaming blob body.