Skip to main content

Crate orchestral

Crate orchestral 

Source
Expand description

§Orchestral

Facade crate that re-exports orchestral_core and orchestral_runtime for convenient single-dependency access.

use orchestral::prelude::*;

Re-exports§

pub use orchestral_core as core;
pub use orchestral_runtime as runtime;

Structs§

ActionContext
Execution context for actions
ActionExecutionOptions
ActionInput
Input data for action execution
ActionMeta
Action metadata for planner
ActionRegistry
Action registry for looking up actions by name
BlobHead
Blob metadata fetched from physical backend.
BlobId
Strongly-typed blob id.
BlobMeta
Blob metadata.
BlobRead
Read result.
BlobWriteRequest
Write request.
CancellationToken
A token which can be used to signal a cancellation request to one or more tasks.
ContinuationState
Structured stage exit state consumed by runtime.
DagNode
A node in the execution DAG
ExecutionDag
Execution DAG - supports dynamic modification
ExecutionProgressEvent
Realtime execution progress event.
Executor
The executor - orchestrates DAG execution
ExecutorContext
Executor context
HistoryItem
A single item in the conversation history
Intent
User intent - the first-class input of the system
IntentContext
Additional context for an intent
InterpretRequest
Input payload for result interpretation.
InterpretResult
Output payload from interpreter.
NoopResultInterpreter
Deterministic fallback interpreter.
NormalizedPlan
Normalized plan ready for execution
Orchestral
Entry point for the SDK.
OrchestralApp
The running Orchestral application.
OrchestralBuilder
Builder for constructing an OrchestralApp without YAML config.
Plan
Execution plan - the primary asset of the system
PlanNormalizer
Plan normalizer - the stability core
PlannerContext
Context provided to the planner
PlannerLoopContext
Agent-loop execution state surfaced back into the planner.
PlannerRuntimeInfo
Runtime host info visible to planner prompt.
RunResult
Result of a single run() call.
SingleAction
Planner single-action output.
Step
A single step in the execution plan
StepId
Strongly-typed Step ID.
Task
Task - the stateful execution context
TaskId
Strongly-typed Task ID.
VerifyDecision
Structured verify result. This is the only terminal done gate.
WorkingSet
Working set - weakly-typed KV data container for inter-step communication

Enums§

ActionResult
Action execution result with retry semantics
BlobIoError
Storage-neutral blob errors.
ContinuationStatus
Explicit continuation decision emitted by a completed stage.
Event
Event - append-only fact record
ExecutionResult
Execution result
FixError
Fix errors
InterpretError
Result interpreter errors.
NodeState
Node state in the execution DAG
NormalizeError
Normalization errors
PlanError
Planner errors
PlannerOutput
Scope
Data scope for WorkingSet Avoids naming conflicts and data pollution
SdkError
SDK errors.
StepKind
Step type - distinguishes control semantics
StoreError
Store error types
TaskState
Task state machine - production-ready states
ValidationError
Validation errors
VerifyStatus
Final verification verdict.

Traits§

Action
Action trait - the core abstraction for atomic execution units
BlobStore
Blob store abstraction.
EventStore
EventStore trait - async interface for event storage
ExecutionProgressReporter
Sink interface for execution progress reporting.
InterpretDeltaSink
PlanFixer
Plan fixer trait
PlanValidator
Plan validator trait
Planner
Planner trait - generates execution plans from user intent
ResultInterpreter
Interpreter trait.
TaskStore
TaskStore trait - async interface for task persistence

Type Aliases§

ActionCall
Legacy alias preserved while call sites migrate.
ActionPreflightHook
BlobStream
Streaming blob body.