awaken 0.6.0

Rust AI agent backend: build capabilities once, tune behavior live, serve every client
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

//! 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::{AgentRuntime, AgentRuntimeBuilder, BuildError, RunActivation, RuntimeError};
pub use crate::{
    AgentSpec, AgentSpecPatch, ConfigRecord, Modalities, Modality, ModelSpec, PluginConfigKey,
    PreparedSkillSpecs, SkillArgumentSpec, SkillSpec, SkillSpecContext, SkillSpecPatch,
    SkillSpecSink,
};
pub use crate::{
    decode_config_record, effective_config_record, validate_agent_spec, validate_agent_spec_patch,
    validate_config_record, validate_config_record_overrides, validate_model_spec,
    validate_provider_spec, validate_skill_spec,
};
pub use awaken_runtime::engine::MockProviderProfile;

// ── 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_runtime_contract::contract::tool::{
    Tool, ToolCallContext, ToolDescriptor, ToolError, ToolOutput, ToolResult, ToolStatus,
    ToolValidationError, TypedTool,
};
pub use awaken_runtime_contract::contract::tool_schema::{
    generate_tool_schema, sanitize_for_llm, validate_against_schema,
};

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

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

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

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

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

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

// ── 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::{
    ConfigSkill, ConfigSkillRegistry, 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,
};