agent-sdk-core 0.1.0-alpha.3

//! Product-neutral core contracts and first-slice runtime for the Agent SDK.
//!
//! The core crate owns typed domain primitives, package snapshots, run control,
//! events, journals, policy, and test fakes. Product hosts and optional crates
//! own concrete providers, toolkits, isolation runtimes, telemetry exporters,
//! workflow engines, UI, and channel adapters.
//!
//! # Common Helper
//!
//! Simple helpers are convenience wrappers over the canonical request path.
//!
//! ```
//! use agent_sdk_core::{Agent, AgentId, RunId, RunRequest, SourceKind, SourceRef};
//!
//! let agent = Agent::builder()
//!     .id(AgentId::new("agent.docs.helper"))
//!     .name("docs helper")
//!     .build()?;
//! let source = SourceRef::with_kind(SourceKind::Host, "source.docs.helper");
//!
//! let lowered = RunRequest::text(
//!     RunId::new("run.docs.helper"),
//!     agent.id().clone(),
//!     source.clone(),
//!     "hello",
//! );
//!
//! assert_eq!(
//!     agent
//!         .typed_text_request::<DocsTodo>(
//!             RunId::new("run.docs.helper.typed"),
//!             source,
//!             "extract a todo",
//!         )
//!         .agent_id,
//!     lowered.agent_id
//! );
//!
//! # #[derive(Clone, Debug)]
//! # struct DocsTodo;
//! # impl agent_sdk_core::TypedOutputModel for DocsTodo {
//! #     const SCHEMA_ID: &'static str = "schema.docs.todo";
//! #     const SCHEMA_VERSION: agent_sdk_core::SchemaVersion =
//! #         agent_sdk_core::SchemaVersion::new(1, 0, 0);
//! #     fn schema_ref() -> agent_sdk_core::OutputSchemaRef {
//! #         agent_sdk_core::OutputContract::inline_json_schema(
//! #             agent_sdk_core::OutputSchemaId::new(Self::SCHEMA_ID),
//! #             Self::SCHEMA_VERSION,
//! #             serde_json::json!({"type": "object"}),
//! #         )
//! #         .schema
//! #     }
//! # }
//! # Ok::<(), agent_sdk_core::AgentError>(())
//! ```
//!
//! # Advanced Request Path
//!
//! Advanced callers can construct the same DTOs explicitly. Runtime execution
//! still resolves one effective `RuntimePackage` before provider calls, policy
//! checks, journal appends, events, redaction, and telemetry projections.
//!
//! ```
//! use agent_sdk_core::{
//!     AgentId, OutputContract, RunId, RunRequest, SourceKind, SourceRef,
//! };
//!
//! # #[derive(Clone, Debug)]
//! # struct DocsTodo;
//! # impl agent_sdk_core::TypedOutputModel for DocsTodo {
//! #     const SCHEMA_ID: &'static str = "schema.docs.todo.advanced";
//! #     const SCHEMA_VERSION: agent_sdk_core::SchemaVersion =
//! #         agent_sdk_core::SchemaVersion::new(1, 0, 0);
//! #     fn schema_ref() -> agent_sdk_core::OutputSchemaRef {
//! #         agent_sdk_core::OutputContract::inline_json_schema(
//! #             agent_sdk_core::OutputSchemaId::new(Self::SCHEMA_ID),
//! #             Self::SCHEMA_VERSION,
//! #             serde_json::json!({"type": "object"}),
//! #         )
//! #         .schema
//! #     }
//! # }
//! let request = RunRequest::text(
//!     RunId::new("run.docs.advanced"),
//!     AgentId::new("agent.docs.advanced"),
//!     SourceRef::with_kind(SourceKind::Host, "source.docs.advanced"),
//!     "extract a todo",
//! )
//! .with_output_contract(OutputContract::for_type::<DocsTodo>());
//!
//! assert!(request.output_contract.is_some());
//! ```
//!
//! # SemVer Posture
//!
//! The supported consumer import surface is the crate root plus documented
//! namespaces such as `agent_sdk_core::testing` and `agent_sdk_core::ports`.
//! Deep implementation modules remain review surfaces until release readiness;
//! downstream code should prefer builders, constructors, accessors, and wildcard
//! matches for public enums so the SDK can add fields and variants without
//! creating avoidable SemVer pressure.

#[path = "application/agent.rs"]
pub mod agent;
#[path = "application/agent_pool.rs"]
/// Public agent pool namespace. Use it for the documented agent pool
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod agent_pool;
#[path = "application/anti_entropy.rs"]
/// Public anti entropy namespace. Use it for the documented anti
/// entropy API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod anti_entropy;
#[path = "application/isolation.rs"]
/// Public application isolation namespace. Use it for the documented
/// application isolation API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod application_isolation;
#[path = "application/approval.rs"]
/// Public approval namespace. Use it for the documented approval API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod approval;
#[path = "ports/approval.rs"]
/// Public approval ports namespace. Use it for the documented approval
/// ports API surface; prefer crate-root re-exports for common imports.
/// Module items must preserve the core ownership and side-effect
/// boundaries described in this file.
pub mod approval_ports;
#[path = "records/approval.rs"]
/// Public approval records namespace. Use it for the documented
/// approval records API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod approval_records;
#[path = "testing/approval.rs"]
mod approval_testing;
#[path = "package/capability.rs"]
/// Public capability namespace. Use it for the documented capability
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod capability;
#[path = "application/checkpoint.rs"]
/// Public checkpoint namespace. Use it for the documented checkpoint
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod checkpoint;
#[path = "records/content.rs"]
/// Public content namespace. Use it for the documented content API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod content;
#[path = "ports/content.rs"]
/// Public content ports namespace. Use it for the documented content
/// ports API surface; prefer crate-root re-exports for common imports.
/// Module items must preserve the core ownership and side-effect
/// boundaries described in this file.
pub mod content_ports;
#[path = "testing/content.rs"]
mod content_testing;
#[path = "records/context.rs"]
/// Public context namespace. Use it for the documented context API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod context;
/// Public domain namespace. Use it for the documented domain API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod domain;
#[path = "records/effect.rs"]
/// Public effect namespace. Use it for the documented effect API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod effect;
#[path = "domain/error.rs"]
/// Public error namespace. Use it for the documented error API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod error;
#[path = "records/event.rs"]
/// Public event namespace. Use it for the documented event API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod event;
#[path = "ports/event_bus.rs"]
/// Public event bus namespace. Use it for the documented event bus API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod event_bus;
#[path = "testing/event.rs"]
mod event_testing;
#[path = "records/events.rs"]
/// Public events namespace. Use it for the documented events API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod events;
#[path = "application/extension.rs"]
/// Public extension namespace. Use it for the documented extension API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod extension;
#[path = "ports/extension.rs"]
/// Public extension ports namespace. Use it for the documented
/// extension ports API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod extension_ports;
#[path = "records/extension.rs"]
/// Public extension records namespace. Use it for the documented
/// extension records API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod extension_records;
#[path = "testing/extension.rs"]
mod extension_testing;
#[path = "testing/fakes.rs"]
mod fakes;
#[path = "ports/hooks.rs"]
/// Public hook ports namespace. Use it for the documented hook ports
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod hook_ports;
#[path = "records/hooks.rs"]
/// Public hook records namespace. Use it for the documented hook
/// records API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod hook_records;
#[path = "application/hooks.rs"]
/// Public hooks namespace. Use it for the documented hooks API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod hooks;
#[path = "testing/hooks.rs"]
mod hooks_testing;
#[path = "domain/ids.rs"]
/// Public ids namespace. Use it for the documented ids API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod ids;
#[path = "testing/isolation.rs"]
mod isolation_testing;
#[path = "records/journal.rs"]
/// Public journal namespace. Use it for the documented journal API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod journal;
#[path = "ports/journal.rs"]
/// Public journal ports namespace. Use it for the documented journal
/// ports API surface; prefer crate-root re-exports for common imports.
/// Module items must preserve the core ownership and side-effect
/// boundaries described in this file.
pub mod journal_ports;
#[path = "application/kernel.rs"]
/// Public kernel namespace. Use it for the documented kernel API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod kernel;
#[path = "application/loop_driver.rs"]
/// Public loop driver namespace. Use it for the documented loop driver
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod loop_driver;
#[path = "application/loop_state.rs"]
/// Public loop state namespace. Use it for the documented loop state
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod loop_state;
#[path = "records/output.rs"]
/// Public output namespace. Use it for the documented output API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod output;
#[path = "records/output_delivery.rs"]
/// Public output delivery namespace. Use it for the documented output
/// delivery API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod output_delivery;
#[path = "ports/output_delivery.rs"]
/// Public output delivery port namespace. Use it for the documented
/// output delivery port API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod output_delivery_port;
#[path = "application/output_delivery.rs"]
/// Public output delivery service namespace. Use it for the documented
/// output delivery service API surface; prefer crate-root re-exports
/// for common imports. Module items must preserve the core ownership
/// and side-effect boundaries described in this file.
pub mod output_delivery_service;
#[path = "testing/output_delivery.rs"]
mod output_delivery_testing;
/// Public package namespace. Use it for the documented package API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod package;
#[path = "package/extension.rs"]
/// Public package extension namespace. Use it for the documented
/// package extension API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod package_extension;
#[path = "package/hooks.rs"]
/// Public package hooks namespace. Use it for the documented package
/// hooks API surface; prefer crate-root re-exports for common imports.
/// Module items must preserve the core ownership and side-effect
/// boundaries described in this file.
pub mod package_hooks;
#[path = "package/isolation.rs"]
/// Public package isolation namespace. Use it for the documented
/// package isolation API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod package_isolation;
#[path = "domain/policy.rs"]
/// Public policy namespace. Use it for the documented policy API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod policy;
/// Public ports namespace. Use it for the documented ports API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod ports;
#[path = "ports/isolation.rs"]
/// Public ports isolation namespace. Use it for the documented ports
/// isolation API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod ports_isolation;
#[path = "domain/privacy.rs"]
/// Public privacy namespace. Use it for the documented privacy API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod privacy;
#[path = "application/projection.rs"]
/// Public projection namespace. Use it for the documented projection
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod projection;
#[path = "ports/provider.rs"]
/// Public provider namespace. Use it for the documented provider API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod provider;
#[path = "ports/providers.rs"]
/// Public providers namespace. Use it for the documented providers API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod providers;
#[path = "application/realtime.rs"]
/// Public realtime namespace. Use it for the documented realtime API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod realtime;
#[path = "records/realtime.rs"]
/// Public realtime records namespace. Use it for the documented
/// realtime records API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod realtime_records;
#[path = "testing/realtime.rs"]
mod realtime_testing;
#[path = "records/isolation.rs"]
/// Public records isolation namespace. Use it for the documented
/// records isolation API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod records_isolation;
#[path = "application/recovery.rs"]
/// Public recovery namespace. Use it for the documented recovery API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod recovery;
#[path = "domain/refs.rs"]
/// Public refs namespace. Use it for the documented refs API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod refs;
#[path = "application/repair.rs"]
/// Public repair namespace. Use it for the documented repair API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod repair;
#[path = "application/replay.rs"]
/// Public replay namespace. Use it for the documented replay API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod replay;
#[path = "application/run.rs"]
/// Public run namespace. Use it for the documented run API surface;
/// prefer crate-root re-exports for common imports. Module items must
/// preserve the core ownership and side-effect boundaries described in
/// this file.
pub mod run;
#[path = "application/run_handle.rs"]
/// Public run handle namespace. Use it for the documented run handle
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod run_handle;
#[path = "application/runtime.rs"]
/// Public runtime namespace. Use it for the documented runtime API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod runtime;
#[path = "application/stream.rs"]
/// Public stream namespace. Use it for the documented stream API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod stream;
#[path = "records/stream.rs"]
/// Public stream records namespace. Use it for the documented stream
/// records API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod stream_records;
#[path = "records/structured_output.rs"]
/// Public structured output namespace. Use it for the documented
/// structured output API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod structured_output;
#[path = "application/subagent.rs"]
/// Public subagent namespace. Use it for the documented subagent API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod subagent;
#[path = "records/subagent.rs"]
/// Public subagent records namespace. Use it for the documented
/// subagent records API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod subagent_records;
#[path = "ports/subscription.rs"]
/// Public subscription namespace. Use it for the documented
/// subscription API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod subscription;
#[path = "application/telemetry.rs"]
/// Public telemetry namespace. Use it for the documented telemetry API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod telemetry;
#[path = "ports/telemetry.rs"]
/// Public telemetry ports namespace. Use it for the documented
/// telemetry ports API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod telemetry_ports;
#[path = "records/telemetry.rs"]
/// Public telemetry records namespace. Use it for the documented
/// telemetry records API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod telemetry_records;
#[path = "testing/telemetry.rs"]
mod telemetry_testing;
/// Public testing namespace. Use it for the documented testing API
/// surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod testing;
#[path = "application/tool.rs"]
/// Public tool execution namespace. Use it for the documented tool
/// execution API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod tool_execution;
#[path = "ports/tool_pack.rs"]
/// Public tool pack ports namespace. Use it for the documented tool
/// pack ports API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod tool_pack_ports;
#[path = "records/tool_pack.rs"]
/// Public tool pack records namespace. Use it for the documented tool
/// pack records API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod tool_pack_records;
#[path = "ports/tool.rs"]
/// Public tool ports namespace. Use it for the documented tool ports
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod tool_ports;
#[path = "records/tool.rs"]
/// Public tool records namespace. Use it for the documented tool
/// records API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod tool_records;
#[path = "testing/tool.rs"]
mod tool_testing;
#[path = "application/trace.rs"]
/// Public trace namespace. Use it for derived journal trace views; prefer
/// crate-root re-exports for common imports. Module items must preserve
/// the core ownership and side-effect boundaries described in this file.
pub mod trace;
#[path = "ports/typed_output.rs"]
/// Public typed output ports namespace. Use it for the documented typed
/// output ports API surface; prefer crate-root re-exports for common
/// imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod typed_output_ports;
#[path = "records/validated_output.rs"]
/// Public validated output namespace. Use it for the documented
/// validated output API surface; prefer crate-root re-exports for
/// common imports. Module items must preserve the core ownership and
/// side-effect boundaries described in this file.
pub mod validated_output;
#[path = "application/validation.rs"]
/// Public validation namespace. Use it for the documented validation
/// API surface; prefer crate-root re-exports for common imports. Module
/// items must preserve the core ownership and side-effect boundaries
/// described in this file.
pub mod validation;

pub use agent::{Agent, AgentBuilder};
pub use agent_pool::{
    AgentPool, AgentPoolBuilder, AgentPoolMember, AgentPoolMessagePolicy, AgentPoolSnapshot,
    AgentPoolStore, AgentPoolStoreConfig, AgentPoolStoreCursor, AgentPoolStoreRecord,
    AgentPoolStoreRecordPayload, AgentPoolStoreStream, AgentPoolStoredMessage, AgentPoolStoredWake,
    AgentPoolWakePolicy, InMemoryAgentPoolStore, MessageReceipt, MessageResponseContract,
    MessageStatus, ResumeInputPolicy, RunAddress, RunAddressTarget, RunMessage, WakeCondition,
    WakeRegistration, WakeRegistrationStatus,
};
pub use anti_entropy::{
    AntiEntropyRepair, AntiEntropyReport, AntiEntropyScanner, DerivedViewKind, DerivedViewState,
};
pub use application_isolation::{
    IsolationCleanupOutcome, IsolationDowngradeApproval, IsolationLifecycleContext,
    IsolationLifecycleCoordinator, IsolationMatchStatus, IsolationProcessOutcome,
    IsolationReadinessProfile, IsolationSelectionOutcome, PolicyDecisionScope,
};
pub use approval::ApprovalBroker;
pub use approval_ports::{ApprovalDispatchRequest, ApprovalDispatchResponse, ApprovalDispatcher};
pub use approval_records::{
    ApprovalBrokerOutcome, ApprovalDecision, ApprovalLifecycleStatus, ApprovalRecord,
    ApprovalRequest, ApprovalTerminalStatus,
};
pub use capability::{
    CapabilityId, CapabilityKind, CapabilityNamespace, CapabilityReadiness,
    CapabilityReadinessStatus, CapabilitySource, CapabilitySourceKind, CapabilitySpec,
    CapabilityVersion, CapabilityVisibility, ExecutableCapabilityRoute, ExecutorRef,
    PackageSidecarRef, ProjectionMode, ProviderCapabilityProjection,
};
pub use checkpoint::{
    CheckpointPrunePolicy, CheckpointPruneReport, CheckpointSaveOutcome, CheckpointStore,
    InMemoryCheckpointStore,
};
pub use content::{
    ArtifactRef, ArtifactVersion, ContentKind, ContentRef, ContentResolutionError,
    ContentResolutionErrorKind, ContentResolutionPolicy, ContentResolutionPurpose,
    ContentResolveRequest, ContentScope, ContentVersion, MissingContentPolicy, ResolvedContent,
    RetentionUse,
};
pub use content_ports::ContentResolver;
pub use context::{
    AgentMessage, AgentMessagePart, AgentMessageRole, ContextBudgetHint, ContextBudgetSummary,
    ContextContribution, ContextContributionId, ContextContributionKind, ContextItem,
    ContextProjection, ContextProjectionAudit, ContextSelectionDecision, ContextSelectionReason,
    ProjectedContextPart, ProjectionRole,
};
pub use domain::{
    AdapterRef, AgentId, AgentPoolId, ArtifactId, AttemptId, ContentId, CorrelationEntry,
    CorrelationKey, CorrelationValue, DedupeKey, DestinationKind, DestinationRef, EffectId,
    EntityKind, EntityRef, EventCursorId, EventId, IdValidationError, IdempotencyKey, LineageId,
    LineageRef, MAX_ID_LEN, MessageId, OutputSchemaId, PolicyKind, PolicyRef, PrivacyClass,
    RepairAttemptId, RetentionClass, RunId, RuntimePackageId, SessionId, SourceKind, SourceRef,
    ToolCallId, TopicId, TraceId, TrustClass, TurnId, ValidatedOutputId, ValidationAttemptId,
    WakeConditionId,
};
pub use effect::{EffectIntent, EffectKind, EffectResult, EffectTerminalStatus};
pub use error::{AgentError, AgentErrorKind, CausalIds, ErrorContext, RetryClassification};
pub use event::{
    AgentEvent, ArchiveCursor, CompiledEventFilter, EventCursor, EventEnvelope, EventFamily,
    EventFilter, EventFrame, EventKind, EventOverflowNotice,
};
pub use event_bus::{AgentEventBus, AgentEventStream, EventArchive, InMemoryAgentEventBus};
pub use extension::{
    ExtensionActionContext, ExtensionActionCoordinator, ExtensionActionOutcome,
    ExtensionActionOutcomeStatus, ExtensionProtocolRecoveryContext,
    ExtensionProtocolRecoveryOutcome, recover_extension_protocol_error,
};
pub use extension_ports::{
    ExtensionActionExecutionOutput, ExtensionActionExecutionRequest, ExtensionActionExecutor,
    ExtensionActionExecutorRegistry, ExtensionActionRegistrySnapshot, ExtensionActionRequest,
    ExtensionActionRoute, ExtensionProtocolError, ExtensionProtocolErrorKind,
    ExtensionProtocolRequestId, ExtensionProtocolVersion, validate_extension_protocol_response_id,
};
pub use extension_records::{
    ExtensionActionEvent, ExtensionActionEventKind, ExtensionActionRecord,
    ExtensionActionRecordParams, ExtensionActionRecordStatus, ExtensionProtocolRecoveryRecord,
};
pub use hook_ports::{
    HookExecutionOutcome, HookExecutor, HookExecutorRegistry, InMemoryHookExecutorRegistry,
};
pub use hook_records::{
    HookMutationJournalPlan, HookRecord, HookRecordPayload, HookResponseDecision,
};
pub use hooks::{
    HookInvocationOutcome, HookInvocationStatus, HookLifecycleContext, HookLifecycleCoordinator,
};
pub use journal::{
    AgentPoolLifecycleStatus, AgentPoolRecord, ContextProjectionRecord, EventIndexProjection,
    JournalCursor, JournalRecord, JournalRecordBase, JournalRecordKind, JournalRecordPayload,
    MessageRecord, ModelAttemptRecord, PendingSideEffect, RecoveryMarker, RunCheckpoint,
    RunLifecycleRecord, RunMessageAddressTargetRecord, RunMessageDeliveryStatus, RunMessageRecord,
    StructuredOutputRecord, TerminalResultMarker, TurnLifecycleRecord, TurnLifecycleStatus,
    WakeRecord, WakeResumeInputPolicyRecord, WakeTriggerStatus,
};
pub use journal_ports::{RunJournal, append_before_effect, append_result_or_recovery};
pub use loop_state::{
    AgentStateMachine, CheckpointPolicy, LoopEventKind, LoopState, LoopStopReason,
    LoopTerminalResult, LoopTerminalStatus, LoopTrigger, MaxIterationOutcome, SideEffectPolicy,
    TransitionGuard, TransitionGuardSet, TransitionInput, TransitionOutput, TransitionRule,
    contract_state_names, transition_table, validate_transition,
};
pub use output::{
    CandidateContentRepairPolicy, ContentHash, CrateName, OutputContract, OutputMode, OutputPreset,
    OutputProjectionHint, OutputSchemaDialect, OutputSchemaRef, OutputValidatorRef,
    ProviderHintPolicy, RepairAdapterRef, RepairExhaustedBehavior, RepairPolicy, RetryBackoff,
    RetryBudget, SchemaVersion, SemanticValidatorRef, TypeName, ValidationFailureVisibility,
    ValidationPolicy,
};
pub use output_delivery::{
    OutputContentMode, OutputDeliveryDedupeRecord, OutputDeliveryEventKind,
    OutputDeliveryEventRecord, OutputDeliveryId, OutputDeliveryIntentRecord,
    OutputDeliveryJournalBase, OutputDeliveryKind, OutputDeliveryPolicy, OutputDeliveryReceipt,
    OutputDeliveryReconciliationRecord, OutputDeliveryRecord, OutputDeliveryRequest,
    OutputDeliveryRequirement, OutputDeliveryResultRecord, OutputDispatchStatus, OutputSinkRef,
    RawOutputContentPolicy, ReplayRepairDecision, TerminalAppendStatus,
    build_output_delivery_dedupe_key,
};
pub use output_delivery_port::{
    OutputSink as OutputDeliverySink, OutputSinkCapabilities,
    OutputSinkRegistry as OutputDeliverySinkRegistry,
};
pub use output_delivery_service::{
    OutputDedupeProof, OutputDeliveryCandidate, OutputDeliveryContext, OutputDeliveryDedupeIndex,
    OutputDeliveryOutcome, OutputDeliveryService,
};
pub use package::realtime::{
    REALTIME_SESSION_SIDECAR_KIND, REALTIME_SESSION_SIDECAR_VERSION, RealtimeSessionSidecar,
};
pub use package::stream::{
    STREAM_RULE_SIDECAR_KIND, STREAM_RULE_SIDECAR_VERSION, StreamRuleSidecar,
};
pub use package::tool_pack::{
    AnchorValidationRequirement, PreviewApplyRequirement, ResourceRouteSnapshot,
    ToolDiscoverySnapshot, ToolPackId, ToolPackKind, ToolPackSnapshot, ToolPackToolSnapshot,
    WorkspaceBoundsSnapshot, active_tool_pack_readiness,
};
pub use package::{
    AgentSnapshot, CapabilityCatalogSnapshot, ChildLifecyclePolicySnapshot,
    ChildPackageStripManifest, ChildRuntimePackage, ChildRuntimePackagePolicy,
    ContextHandoffPolicy, DepthBudget, FingerprintExclusionGroup, FingerprintInputGroup,
    FingerprintInputManifest, OutputContractSnapshot, OutputSinkSnapshot, PackageDelta,
    PackageSidecarSnapshot, PolicySnapshot, ProviderCapabilitySnapshot, ProviderRouteSnapshot,
    ReadinessProfile, RouteInheritanceMode, RuntimePackage, RuntimePackageBuilder,
    RuntimePackageCanonicalV1, RuntimePackageConformanceReport, RuntimePackageFingerprint,
    SubagentRoutePolicy, SubagentToolPolicy, VolatileRuntimeFields, build_child_runtime_package,
};
pub use package_extension::{
    CoreExtensionCapabilities, CoreExtensionCapabilitiesBuilder, EXTENSION_ACTION_SIDECAR_KIND,
    EXTENSION_ACTION_SIDECAR_VERSION, ExtensionActionCapability, ExtensionActionId,
    ExtensionActionIdempotency, ExtensionActionKind, ExtensionActionRef, ExtensionActionRequestId,
    ExtensionBridgeRef, ExtensionHookCapability, ExtensionId, ExtensionManifestAudit,
    ExtensionPackageCapability, ExtensionPackageResolution, ExtensionProviderCapability,
    ExtensionSubagentCapability, ExtensionToolCapability, ExtensionVersion,
    ResolvedExtensionActionSidecar, ResolvedExtensionPackage, audit_core_extension_capabilities,
};
pub use package_hooks::{
    ApprovalRequestPatch, CleanupRepairRequest, CompactionRequest, ContextInjectionRequest,
    DenyReason, DetachValidationRequest, HookCancellationToken, HookConfig, HookExecutionMode,
    HookExecutorRef, HookFailurePolicy, HookId, HookInput, HookMutationRight, HookMutationRights,
    HookOrdering, HookOrderingPhase, HookOverflowPolicy, HookPoint, HookPrivacyPolicy,
    HookQueueConfig, HookResponse, HookResponseClass, HookSource, HookSpec, HookTimeoutPolicy,
    HookView, ProjectionAuditRepairRequest, ProjectionPatch, RepairNeededReason, RetryRequest,
    StopReason, SubagentRequestPatch, ToolRequestPatch, ToolResultPatch, UsageRollupRepairRequest,
    ValidationHintPatch, hook_policy_ref, lower_code_hook, ordered_hooks_for_point,
    validate_hook_specs,
};
pub use package_isolation::{
    AmbientSecretPolicy, AuditabilityRequirement, ChildArtifactId, ChildShutdownBehavior,
    CleanupGuaranteeRequirement, CleanupMode, CleanupPlanRef, ContentRefMode,
    DataResidencyRequirement, DetachPolicy, EnvironmentLifecyclePolicy, EnvironmentSpec,
    ExecutionEnvironment, ExecutionEnvironmentBuilder, ExecutionEnvironmentId,
    ExecutionEnvironmentKind, FilesystemIsolationPolicy, ImageRef, ImageRequest, IsolatedProcessId,
    IsolatedProcessRef, IsolatedProcessSpec, IsolatedProcessSpecBuilder,
    IsolationAdapterRequirement, IsolationAdapterSessionRef, IsolationCapability,
    IsolationCapabilityReportRef, IsolationCapabilitySet, IsolationClass, IsolationFallback,
    IsolationFingerprintFields, IsolationRequirement, IsolationRequirementRef,
    IsolationRequirementSnapshot, IsolationRuntimeRef, IsolationSessionId, IsolationSessionRef,
    IsolationTrustField, IsolationTrustRequirement, LocalityRequirement, MountExpansionAudit,
    MountMode, MountPolicy, MountRef, NetworkIsolationPolicy, NetworkNamespaceRef,
    PolicyDecisionRef, ProcessContentCaptureMode, ProcessIoCapturePolicy, ProcessIoPolicy,
    ProcessIoStreamRef, ProcessOwnershipClass, ProcessOwnershipPolicy, ProcessStatsPolicy,
    ProcessStatsSnapshotRef, ReclaimPolicy, ReclaimTicketRef, RedactedEnvVar, ResourceLimits,
    RootFilesystemMode, RootfsRef, RootfsRequest, RunChildLifecyclePolicyRef,
    RuntimePackageSidecarId, SecretEnvPolicy, SecretExposurePolicy, SecretIsolationRequirement,
    SecretMountPolicy, SecretMountRef, SecretRef, SingleFileMountExpansionPolicy, StdinPolicy,
    SymlinkPolicy, TenantBoundaryRequirement, TerminalMode, TruncationPolicy, WorkspaceMountMode,
    WorkspaceMountPolicy,
};
pub use policy::{
    ApprovalDecisionKind, ApprovalPolicy, ApprovalRequestSpec, CapabilityPermission,
    ContentCaptureMode, ContentCapturePolicy, DecisionReason, DispatcherScope, EffectClass,
    EscalationPolicy, MissingDependency, PermissionPolicy, PolicyDecision, PolicyOutcome,
    PolicyStage, PrivacyPolicy, ResumePolicy, RiskClass, SandboxMode, SandboxPolicy,
    ToolRequestModification,
};
pub use ports::realtime::{
    RealtimeAdapterAck, RealtimeAdapterCall, RealtimeConnectRequest, RealtimeConnectResponse,
    RealtimeProviderAdapter,
};
pub use ports::{
    InMemoryRuntimePackageResolver, OutputSinkPort, OutputSinkRegistry, ProviderRegistry,
    RuntimePackageResolver, RuntimePolicyPort,
};
pub use ports_isolation::{
    CleanupRequest, CleanupResult, CleanupStatus, DetachTransferRequest, DetachTransferResult,
    EnvironmentPrepareRequest, ImageResolution, ImageResolveRequest, IsolationCapabilityReport,
    IsolationRuntime, IsolationRuntimeHealth, IsolationRuntimeKind, IsolationRuntimeRegistry,
    MountPlan, MountResolveRequest, NetworkPrepareRequest, PlatformReport, ProcessIoFrame,
    ProcessIoRequest, ProcessIoStream, ProcessSignal, ProcessSignalRequest, ProcessSignalResult,
    ProcessStartRequest, ProcessStartResult, ProcessStatsRequest, ProcessStatsSnapshot,
    ReclaimRequest, ReclaimResult, RootfsPrepareRequest, SecretMaterializationPlan,
    SecretPrepareRequest, SessionPrepareRequest, isolation_host_configuration_needed,
};
pub use projection::project_context_projection;
pub use provider::{
    ProviderAdapter, ProviderCapabilities, ProviderConformanceCase, ProviderMessage,
    ProviderMessageRole, ProviderModality, ProviderProjectedMetadata, ProviderProjectionPolicy,
    ProviderRequest, ProviderResponse, ProviderStopReason, ProviderStreamChunk,
    ProviderStreamDelta, ProviderStructuredOutputHint, ProviderToolCall, ProviderUsage,
};
pub use realtime::{RealtimeCompletionGate, RealtimeSessionController};
pub use realtime_records::{
    RealtimeBackpressureAction, RealtimeBackpressureState, RealtimeCloseReason,
    RealtimeConnectionId, RealtimeFrameId, RealtimeInputFrame, RealtimeMediaKind,
    RealtimeOutputFrame, RealtimeResponseId, RealtimeSessionId, RealtimeSessionRecord,
    RealtimeSessionRecordKind, RealtimeSessionState, RealtimeSessionStatus,
};
pub use records_isolation::{
    ISOLATION_RECORD_SCHEMA_VERSION, IsolationCapabilityMatchRecord,
    IsolationCapabilityReportedRecord, IsolationCleanupIntentRecord, IsolationCleanupResultRecord,
    IsolationDowngradeDecisionRecord, IsolationEnvironmentPrepareIntentRecord,
    IsolationEnvironmentPrepareResultRecord, IsolationEventBase, IsolationEventKind,
    IsolationEventRecord, IsolationFailureRecord, IsolationNetworkPreparedRecord,
    IsolationProcessStartIntentRecord, IsolationProcessStartResultRecord,
    IsolationProcessStatsRecord, IsolationRecord, IsolationRequestedRecord,
};
pub use recovery::{
    RecoveryAction, RecoveryClassification, RecoveryDecision, RecoveryFailureKind,
    classify_recovery,
};
pub use repair::{
    LocalValidationRepairService, RepairAccounting, RepairDecision, RepairPolicyController,
    ValidationRepairOutcome,
};
pub use replay::{
    CursorCompatibility, DurableReplaySupport, ReplayMode, ReplayPendingSideEffect, ReplayReducer,
    ReplayRepairKind, ReplayRepairNeeded, ReplayResult, ReplayStatus, check_cursor_compatibility,
    durable_replay_support,
};
pub use run::{RunRequest, RunResult, RunStatus, StructuredOutputArtifacts};
pub use run_handle::{InMemoryRunControlStore, RunControlStore, RunHandle};
pub use runtime::{
    AgentRuntime, AgentRuntimeBuilder, CancellationHandle, EffectiveRuntimePackage,
    RunRegistryStatus, RunSnapshot,
};
pub use stream::{StreamRuleEngine, StreamRuleEngineState};
pub use stream_records::{
    MarkerId, MarkerVersion, MatchPrivacyPolicy, MatcherEngineRef, PartialOutputPolicy,
    RedactedMatch, RegexDialect, RepeatPolicy, RuleVersion, StreamAction, StreamChannel,
    StreamChannelSelector, StreamCursor, StreamCursorPrecision, StreamDelta, StreamDeltaId,
    StreamDirection, StreamIntervention, StreamInterventionId, StreamMatchId, StreamMatchRef,
    StreamMatcher, StreamRule, StreamRuleBuilder, StreamRuleId, StreamRuleRecord,
    StreamRuleRecordKind, StreamRuleRepeatStateSnapshot, StreamRuleScope, stream_policy_ref,
};
pub use structured_output::{
    RepairExhaustionRecord, RepairPrompt, RepairPromptCandidateContent, RepairRecord,
    RepairRecordKind, StructuredOutputLifecycleKind, StructuredOutputLifecycleRecord,
    ValidationErrorCode, ValidationErrorSummary, ValidationRecord, ValidationRecordKind,
};
pub use subagent::{
    ChildRunHandle, SubagentRequest, SubagentRequestId, SubagentSupervisor,
    subagent_runtime_event_frame,
};
pub use subagent_records::{
    ChildArtifactKind, ChildLifecycleAction, ChildLifecycleRecord, ChildLifecycleStatus,
    RunJournalRef, SubagentCompletedRecord, SubagentHandoffRecord, SubagentRecord,
    SubagentStartedRecord, SubagentTerminalStatus, SubagentUsageRolledUpRecord,
    SubagentWrappedEventRecord,
};
pub use subscription::{InMemorySubscriptionHub, RunSubscriptionSource};
pub use telemetry::{
    TelemetryAuthorityBoundary, TelemetryContentCaptureDecision, TelemetryContentCaptureRequest,
    TelemetryDrainReport, TelemetryFanout, TelemetryFanoutConfig, TelemetryFanoutReport,
    TelemetryOverflowPolicy, TelemetrySinkIsolationPolicy, TelemetryUsageExtractionInput,
    TelemetryUsageExtractor, evaluate_content_capture, sink_health_projection,
    terminal_run_projection_from_event,
};
pub use telemetry_ports::{TelemetrySink, TelemetrySinkAck, TelemetrySinkError, TelemetrySinkSpec};
pub use telemetry_records::{
    CostEstimateStatus, CostTelemetryRecord, CostUnits, RateTableVersion,
    TelemetryContentCaptureMode, TelemetryCostRecordId, TelemetryExportAttemptId,
    TelemetryExportCursor, TelemetryExportCursorRecord, TelemetryProjection, TelemetryProjectionId,
    TelemetryProjectionKind, TelemetryRecord, TelemetryRecordId, TelemetryRecordPayload,
    TelemetrySinkFailureKind, TelemetrySinkFailureRecord, TelemetrySinkHealth,
    TelemetrySinkHealthState, TelemetrySinkId, TelemetrySinkKind, TelemetrySinkRecoveryRecord,
    TelemetrySourceCursor, TelemetrySourceRecord, TelemetryTerminalStatus, TelemetryUsageRecordId,
    UsageTelemetryRecord, UsageUnits,
};
pub use tool_execution::{ToolExecutionContext, ToolExecutionCoordinator, ToolExecutionOutcome};
pub use tool_pack_ports::{
    ResourceReadRequest, ResourceResolution, ResourceResolver, ResourceRouter, ResourceScheme,
};
pub use tool_pack_records::{
    ShellProcessLineage, ToolDiscoveryLineage, ToolPackEffectLineage, WorkspaceMutationLineage,
    WorkspaceReadLineage,
};
pub use tool_ports::{
    AllowToolPolicy, ResolvedToolCall, ToolCallRequest, ToolExecutionOutput, ToolExecutionRequest,
    ToolExecutionStrategy, ToolExecutor, ToolExecutorRegistry, ToolPolicyPort,
    ToolRegistrySnapshot, ToolRoute, ToolRouter, allowed_tool_policy_outcome,
};
pub use tool_records::{
    CanonicalToolName, ToolCallRecord, ToolCallRecordParams, ToolCallRecordStatus, ToolResultRef,
    tool_call_journal_record,
};
pub use trace::{RunTrace, SessionTimeline, TurnTrace};
pub use typed_output_ports::{TypedOutputDeserializer, TypedOutputModel};
pub use validated_output::{
    DecodedTypedOutput, OutputLineage, StructuredOutputResult, TypedOutputError,
    TypedResultPublicationRecord, TypedResultPublicationStatus, ValidatedOutput,
    ValidatedOutputParams, ValidatedOutputPublicationStep, ValidationReportRecord,
    ValidationReportRef, ValidationStatus, validate_typed_result_publication_order,
};
pub use validation::{
    HostileSchemaLimits, JsonSchemaSubsetValidator, OutputCandidate, StructuredOutputValidator,
    TerminalValidationFailure, ValidationErrorReport, ValidationSuccess,
};

/// Common imports for applications built on `agent-sdk-core`.
///
/// The prelude is a facade over stable crate-root exports. It does not define
/// helper behavior or alternate execution paths; common helpers still lower into
/// the canonical `RunRequest`, `RuntimePackage`, event, journal, policy,
/// telemetry, lineage, and redaction contracts.
///
/// ```
/// use agent_sdk_core::prelude::*;
///
/// let agent = Agent::builder()
///     .id(AgentId::new("agent.docs.prelude"))
///     .name("docs prelude")
///     .build()?;
///
/// let request = RunRequest::text(
///     RunId::new("run.docs.prelude"),
///     agent.id().clone(),
///     SourceRef::with_kind(SourceKind::Host, "source.docs.prelude"),
///     "hello",
/// );
///
/// assert_eq!(request.agent_id, agent.id().clone());
/// # Ok::<(), agent_sdk_core::AgentError>(())
/// ```
pub mod prelude {
    pub use crate::{
        Agent, AgentBuilder, AgentError, AgentEvent, AgentEventBus, AgentId, AgentMessage,
        AgentRuntime, CapabilitySpec, ContentResolver, ContextContribution, ContextItem,
        ContextProjection, DestinationKind, DestinationRef, EntityRef, EventCursor, EventFilter,
        EventFrame, JournalRecord, OutputContract, OutputSchemaId, OutputSchemaRef, PolicyDecision,
        PolicyKind, PolicyOutcome, PolicyRef, PolicyStage, PrivacyClass, ProviderAdapter,
        RetentionClass, RunHandle, RunId, RunJournal, RunRequest, RunResult, RunStatus,
        RuntimePackage, RuntimePackageBuilder, RuntimePolicyPort, SchemaVersion, SourceKind,
        SourceRef, TrustClass, TypedOutputModel, ValidatedOutput,
    };
}