主干

Profile / Bundle

定义一套产品要加载的默认插件和配置层。

协作：把最终插件树交给 App Boot。

主干

Cordis

提供服务容器、依赖注入、事件与可逆生命周期。

协作：连接几乎所有模块。

主干

Agent Core

定义 Agent 身份、状态、Inbox 和实时协调事件。

协作：被 Agent Loop、Host 和插件共同观察。

主干

Agent Loop

执行 Turn / Step 状态机，协调 Prompt、LLM、Tools、Session。

协作：是流程调度者，不是能力实现者。

主干

System Prompt

按顺序、作用域和动态环境组装系统规则、上下文与工具清单。

协作：每个 Step 在请求准备前组装。

主干

LLM Runtime

路由模型适配器，把不同提供方输出统一为标准流。

协作：接收冻结请求，返回文本、思考与工具调用。

记忆

Session

保存只追加事件日志，是模型历史、恢复和审计的事实源。

协作：所有持久事实都通过 session/event 广播。

记忆

Surface

把原始日志折叠为模型当前可见的消息序列，支持替换旧范围。

协作：由 Agent Loop 派生模型请求。

记忆

Session Projection

按事件增量计算标题、目标、计划、UI 节点等当前状态。

协作：Host 与 Client 读取成品视图。

记忆

Projection Cache

保存投影检查点和水位线，恢复时只需重放后续尾部。

协作：加速列表、冷读和恢复，不替代日志。

记忆

Persistence

通过会话句柄保存、读取、flush 和管理单写者所有权。

协作：默认 JSONL 后端提供崩溃后恢复。

记忆

Compaction

在 Token 压力下裁剪工具结果并把旧 Surface 总结为摘要节点。

协作：保留原始日志，只改变后续模型所见。

记忆

Token Meter

估算当前请求压力与各 Surface 节点成本，触发压缩决策。

协作：供 Agent Loop 与 Compaction 使用。

记忆

Session Query

统一查询在线和持久会话，支持事件过滤、全文搜索与谱系。

协作：可由 SQLite 索引提供快速检索。

记忆

Spill

把超大纯文本完整外置，向模型保留预览、定位符和取回提示。

协作：工具结果与会话引用都可使用。

记忆

Title / Telemetry

监听 Session 事件，派生标题和运行统计，不改变事实日志。

协作：作为独立消费者更新产品辅助信息。

能力

Tools

管理模型可见工具、作用域限制、执行模式与结果规范化。

协作：承接 LLM tool call，结果回到 Session。

能力

Filesystem

定义文件读写世界和文件操作策略事件，可替换为远程提供方。

协作：Shell、LSP、编辑工具可共享同一世界。

能力

Shell / Subprocess

启动一次性命令并管理取消、输出与退出状态。

协作：执行前可由 Sandbox 包装。

能力

Terminal / PTY

提供可持续、可交互的终端会话，而非一次性命令。

协作：Host 显示终端，工具读写其状态。

能力

Code Runtime

在受控运行时里执行代码，并可转运嵌套工具调用。

协作：仍然经过统一工具与策略流水线。

能力

LSP

向 Agent 提供代码导航、诊断和语义信息。

协作：与文件系统和工作区绑定。

能力

Web

提供网页读取、交互或网络资源能力。

协作：作为工具能力受审批和结果记录约束。

能力

Workflow / Jobs

组织多步流程或后台任务，并提供收集、停止和状态查询。

协作：把长任务纳入可观察控制流。

能力

Commands

让用户直接触发产品命令，不必先走一轮模型推理。

协作：可启动压缩、设置或其他显式操作。

能力

Subagent / Agent Team

把工作委派给其他 Agent；Team 进一步提供 roster、任务板和邮箱。

协作：子会话拥有持久谱系和受限作用域。

策略

Approval

在高风险动作前发起一次性用户确认；不可回答时向拒绝收敛。

协作：位于工具执行前置阶段。

策略

Permission Presets

把常见允许、拒绝和询问规则组合成部署策略。

协作：影响工具准入，但不改变工具实现。

策略

Sandbox 沙箱

限制进程、路径和系统资源，建立真实执行边界。

协作：包装 Shell、Terminal 等进程入口。

策略

Hooks

在请求、工具或其他生命周期点注入组织级策略和观察逻辑。

协作：借助 Waterfall 拦截或委托。

策略

Goal / Plan / Todo

分别表达长期目标、阶段计划和具体任务状态，并写入会话事实。

协作：Projection 为 UI 提供当前状态。

策略

User Questions

让 Agent 在需要选择时暂停并结构化地向用户提问。

协作：答案作为新的输入唤醒 Agent。

策略

Schedule

表达未来或重复执行的工作安排。

协作：到点后把新工作交回 Harness。

产品

Web Server / Gateway

对外提供调用、流和会话控制接口。

协作：把 Host 内部服务映射给 Client / SDK。

产品

Conversation

把 Session Projection 与实时流组装成用户看到的对话节点。

协作：展示消息、工具卡片、状态与错误。

产品

Client Modules

注册客户端功能、资源和生命周期。

协作：与服务端模块一样支持组合和卸载。

产品

Slots / Sidebar

为插件提供固定 UI 插入点和右侧栏扩展。

协作：中心界面只定义位置，不硬编码所有功能。

产品

Storage / Workspace

管理产品数据域和当前工作区上下文。

协作：为设置、文件、会话和插件提供归属。

产品

Settings / Credentials

保存可配置项和敏感凭据，并把二者分开处理。

协作：供模型适配器、工具和 Host 使用。

产品

Extensions / Skills

通过插件和指令包扩展模型能力、工作流与产品行为。

协作：最终仍挂入 Cordis 服务和事件体系。

产品

Webhook / Attachments

接入外部触发与文件材料，把它们安全地转为会话输入。

协作：创建或唤醒 Session，并保存来源。