概览
awaken crate 是 Awaken 的公开门面。它重新导出 runtime contract、server
contract、runtime API、stores 和扩展 crate，让下游可以从一个依赖开始。
| 门面路径 | 来源 crate | 内容 |
|---|---|---|
awaken::contract | awaken-runtime-contract | runtime-facing tool、event、message、suspension、lifecycle、commit coordinator |
awaken::server_contract | awaken-server-contract | server/store-facing storage query、scoped store、staged commit |
awaken::model | awaken-runtime-contract | Phase、EffectSpec、ScheduledActionSpec、JsonValue |
awaken::registry_spec | awaken-runtime-contract | AgentSpec、ModelSpec、ProviderSpec、McpServerSpec、PluginConfigKey |
awaken::state | awaken-runtime-contract + awaken-runtime | StateKey、StateMap、Snapshot、StateStore、MutationBatch |
awaken::agent | awaken-runtime | agent 配置与状态 |
awaken::builder | awaken-runtime | AgentRuntimeBuilder、BuildError |
awaken::context | awaken-runtime | PhaseContext |
awaken::engine | awaken-runtime | LLM 执行层抽象 |
awaken::execution | awaken-runtime | ExecutionEnv |
awaken::extensions | awaken-runtime | 内置扩展基础设施 |
awaken::loop_runner | awaken-runtime | agent loop 执行器 |
awaken::phase | awaken-runtime | PhaseRuntime、PhaseHook |
awaken::plugins | awaken-runtime | Plugin、PluginRegistrar |
awaken::policies | awaken-runtime | context window / retry policy |
awaken::registry | awaken-runtime | AgentResolver、ResolvedAgent、ResolvedBackendAgent |
awaken::runtime | awaken-runtime | AgentRuntime |
awaken::stores | awaken-stores | memory / file / PostgreSQL / SQLite-backed store |
受 feature flag 控制的模块
Section titled “受 feature flag 控制的模块”| 门面路径 | feature flag | 来源 crate |
|---|---|---|
awaken::ext_permission | permission | awaken-ext-permission |
awaken::ext_observability | observability | awaken-ext-observability |
awaken::ext_mcp | mcp | awaken-ext-mcp |
awaken::ext_skills | skills | awaken-ext-skills |
awaken::ext_generative_ui | generative-ui | awaken-ext-generative-ui |
awaken::ext_reminder | reminder | awaken-ext-reminder |
awaken::server | server | awaken-server |
常用类型还会直接从 crate root 导出，例如：
- 来自
awaken-runtime-contract：AgentSpec、KeyScope、MergeStrategy、Phase、StateKey、StateMap、Snapshot - 来自
awaken-runtime：AgentRuntime、AgentRuntimeBuilder、BuildError、RunActivation、RuntimeError、PhaseHook、ToolGateHook
Feature Flags
Section titled “Feature Flags”| Flag | 默认开启 | 说明 |
|---|---|---|
permission | yes | 工具级权限控制与 HITL |
observability | yes | tracing 与 metrics |
mcp | yes | MCP 工具桥接 |
skills | yes | 技能子系统 |
reminder | yes | 工具执行后的提醒注入 |
server | yes | HTTP / SSE / protocol server |
generative-ui | yes | 生成式 UI 组件流 |
full | yes | 上述功能全集 |
独立工作区扩展 crate 也可能存在但未接到门面 feature 上；当前包括 awaken-ext-deferred-tools。