Skip to main content

orchestral_runtime/
lib.rs

1//! # Orchestral Runtime
2//!
3//! Agent Protocol control plane, Generic Agent, guarded tools, and context.
4
5pub mod agent_control;
6pub mod agent_directory;
7pub mod agent_sdk;
8pub mod api;
9pub mod approval_bridge;
10pub mod exec_process;
11pub mod generic_agent;
12pub mod generic_agent_checkpoint;
13mod in_memory_blob;
14pub mod pty_process;
15pub mod session_context;
16pub mod session_history;
17pub mod skill;
18pub mod tool_runtime;
19pub mod tools;
20#[cfg(windows)]
21mod windows_process_job;
22pub mod workflow_strategy;
23
24pub use agent_control::{AgentControlError, AgentControlEvent, AgentController};
25pub use agent_directory::{AgentDirectory, AgentDirectoryError};
26pub use agent_sdk::{AgentClient, AgentRunHandle, AgentSdkError, AgentTurn};
27pub use approval_bridge::{AgentApprovalBridge, ApprovalBridgeError, InMemoryHostApprovalBroker};
28pub use exec_process::{
29    ExecPollResult, ExecProcessError, ExecSessionEvent, ExecSessionId, ExecSessionSnapshot,
30    ExecSessionStatus, ExecSpawnSpec, ExecWaitMode, ExecWaitOptions, ProcessSupervisor,
31};
32pub use generic_agent::{
33    ContextRecoveryPolicy, ContinuationPolicy, GenericAgentConfig, InternalGenericAgentProvider,
34    ModelCostPolicy, ModelRetryPolicy,
35};
36pub use generic_agent_checkpoint::{
37    replay_generic_agent_checkpoint, AppendGenericCheckpointOutcome, CommandCheckpoint,
38    CreateGenericRunOutcome, GenericAgentCheckpointProjection, GenericAgentCheckpointStore,
39    GenericAgentRunRegistration, GenericCheckpointDraft, GenericCheckpointError,
40    GenericCheckpointEvent, GenericCheckpointEventId, GenericCheckpointPhase,
41    GenericCheckpointRecord, GenericLoopBoundary, GenericModelContextTrace,
42    GenericModelObservation, GenericObservedToolCall, InMemoryGenericAgentCheckpointStore,
43    StoredGenericAgentRun,
44};
45pub use in_memory_blob::InMemoryBlobStore;
46pub use orchestral_core::model_protocol::{ModelTokenMeter, ModelTokenMeterDescriptor};
47pub use orchestral_core::spi::{
48    ComponentRegistry, HookDispatchError, HookDispatchMode, HookError, HookExecutionPolicy,
49    HookFailurePolicy, HookRegistry, RuntimeBuildRequest, RuntimeComponentFactory, RuntimeHook,
50    RuntimeHookContext, RuntimeHookEventEnvelope, SpiError, SpiMeta,
51};
52pub use pty_process::{
53    PtyProcessError, PtyProcessId, PtyProcessManager, PtyReadResult, PtySpawnSpec,
54};
55pub use session_context::{
56    AgentSessionCompactor, AgentSessionContextEngine, AgentSessionSummarizer,
57    DeterministicExtractiveSessionSummarizer, JsonSizeTokenMeter, SessionCompactionGroup,
58    SessionCompactionInput, SessionCompactionPolicy, SessionContextError, SessionContextProjection,
59    SessionContextRequest, SessionSummarizerDescriptor,
60};
61pub use skill::{
62    LoadedSkillSet, SkillConflict, SkillLoadOutcome, SkillRoot, SkillRuntime, SkillRuntimeError,
63};
64pub use tool_runtime::{
65    tool_permission_decision_digest, AgentToolRuntime, DescriptorPermissionPolicy,
66    GuardedToolExecution, GuardedToolExecutor, GuardedToolResult, GuardedToolRuntime,
67    ToolArtifactError, ToolArtifactStore, ToolOutcomeRecoveryError, ToolPermissionDecision,
68    ToolPermissionPolicy, ToolRuntimeError, WorkspacePermissionPolicy,
69};
70pub use tools::{
71    GuardedMcpServerConfig, McpServerConnectionManager, McpServerHealth, McpToolsAdapterError,
72    McpToolsAdapterRegistry, StdioMcpSandboxPolicy, StdioMcpTransportFactory,
73    MCP_STDIO_SANDBOX_PROFILE,
74};
75pub use workflow_strategy::{
76    workflow_plan_digest, workflow_step_call_id, RunBoundGuardedToolPort, WorkflowExecutionError,
77    WorkflowExecutionRequest, WorkflowExecutionSnapshot, WorkflowExecutionStrategy,
78};
79
80// Re-export core types for convenience
81pub use orchestral_core::prelude::*;