awaken 0.4.0

//! One-import convenience module for awaken.
//!
//! ```rust,ignore
//! use awaken::prelude::*;
//! ```
//!
//! Covers the types needed to build agents, define tools, manage state,
//! and wire up plugins. Extension types are included when the corresponding
//! feature flag is active.

// ── Building agents ──
pub use crate::registry::traits::ModelBinding;
pub use crate::{AgentRuntime, AgentRuntimeBuilder, BuildError, RunRequest, RuntimeError};
pub use crate::{AgentSpec, PluginConfigKey};

// ── Plugin system ──
pub use crate::CancellationToken;
pub use crate::{EffectSpec, ScheduledActionSpec, TypedEffect};
pub use crate::{Phase, PhaseContext, PhaseHook, ToolGateHook};
pub use crate::{Plugin, PluginDescriptor, PluginRegistrar};
pub use crate::{TypedEffectHandler, TypedScheduledActionHandler};

// ── State ──
pub use crate::state::{CommitEvent, CommitHook, MutationBatch, StateCommand, StateStore};
pub use crate::{KeyScope, MergeStrategy, StateKey, StateKeyOptions};
pub use crate::{Snapshot, StateError, StateMap};

// ── Tools ──
pub use awaken_contract::contract::tool::{
    Tool, ToolCallContext, ToolDescriptor, ToolError, ToolResult, ToolStatus, ToolValidationError,
    TypedTool,
};
pub use awaken_contract::contract::tool_schema::{
    generate_tool_schema, sanitize_for_llm, validate_against_schema,
};

// ── Tool interception (ToolGate decisions) ──
pub use awaken_contract::contract::tool_intercept::ToolInterceptPayload;

// ── Context messages (system reminders / prompt injection) ──
pub use awaken_contract::contract::context_message::{ContextMessage, ContextMessageTarget};

// ── Messages & content ──
pub use awaken_contract::contract::content::ContentBlock;
pub use awaken_contract::contract::message::{Message, Role, Visibility};

// ── Inference ──
pub use awaken_contract::contract::executor::{InferenceRequest, LlmExecutor};
pub use awaken_contract::contract::inference::{InferenceOverride, StopReason, StreamResult};

// ── Events ──
pub use awaken_contract::contract::event::AgentEvent;
pub use awaken_contract::contract::event_sink::EventSink;

// ── Lifecycle ──
pub use awaken_contract::contract::lifecycle::{RunStatus, TerminationReason};

// ── Storage ──
pub use awaken_contract::MailboxStore;
pub use awaken_contract::contract::storage::ThreadRunStore;

// ── Stop policies ──
pub use crate::policies::{StopConditionPlugin, StopDecision, StopPolicy, StopPolicyStats};

// ── Common re-exports ──
pub use serde_json::Value as JsonValue;
pub use std::sync::Arc;

// ── Extension types (feature-gated) ──

#[cfg(feature = "permission")]
pub use awaken_ext_permission::{
    PermissionConfigKey, PermissionPlugin, PermissionRuleEntry, PermissionRulesConfig,
    ToolPermissionBehavior,
};

#[cfg(feature = "observability")]
pub use awaken_ext_observability::ObservabilityPlugin;

#[cfg(feature = "mcp")]
pub use awaken_ext_mcp::{McpPlugin, McpServerConnectionConfig, McpToolRegistryManager};

#[cfg(feature = "skills")]
pub use awaken_ext_skills::{SkillDiscoveryPlugin, SkillRegistry};

#[cfg(feature = "reminder")]
pub use awaken_ext_reminder::{
    ReminderPlugin, ReminderRule, ReminderRuleEntry, ReminderRulesConfig,
};

#[cfg(feature = "generative-ui")]
pub use awaken_ext_generative_ui::{
    A2uiPlugin, A2uiPromptConfig, A2uiPromptConfigKey, DEFAULT_A2UI_CATALOG_ID,
};

#[cfg(feature = "server")]
pub use awaken_server::app::{AppState, ServerConfig, ShutdownConfig, serve, serve_with_shutdown};
#[cfg(feature = "server")]
pub use awaken_server::mailbox::{Mailbox, MailboxConfig};
#[cfg(feature = "server")]
pub use awaken_server::routes::build_router;