Speaker Notes
精修 / Polish · Enterprise Dark

# Intent Broker

本地优先、可靠优先、协议优先的协作中间层。目标不是替代推理，而是让任务认领、澄清、提交和审批拥有可重放、可审计、可恢复的本地真相源。

3
核心设计原则
10
稳定 Intent
∞
后续扩展空间
问题定义

## 多窗口协作仍停留在临时约定

### 缺少统一通道

多个 agent 与人类之间没有统一 inbox，任务常常散落在不同会话里。

### 缺少任务语义

“直接聊天”很难稳定表达 accept、clarification、approval 这类高价值动作。

### 缺少可靠恢复

当长连接断开或窗口关闭时，关键上下文容易丢失，也缺少审计重放能力。

关键判断： 当前缺的不是“更多消息”，而是“带状态推进语义的协作协议”。

Thesis 与边界

## Broker 只做协议、事件、投递与视图

### This system is

- append-only 事件日志 + task / thread / approval 投影视图
- participant / role / capability 驱动的路由器
- 以 HTTP pull 为主消费模型的本地 broker
- 多 agent 协作的本地基础设施起点

### This system is not

- 通用聊天服务器
- 自动执行 shell / git / browser 的任务工厂
- 各家 agent 内部 conversation protocol 的抽象层
- 一开始就覆盖远程、多租户、OAuth 的大平台

设计原则

## v1 先做稳定协议，不追求大而全

### 本地优先

先解决单机多个 agent / human 的协作问题，默认绑定 localhost，不引入复杂远程身份体系。

### 协议优先

先稳定定义 request / accept / progress / submit / approval 这些高价值意图，再谈更多客户端。

### 可靠优先

先写事件再投递，以 cursor、ack 和 replay 保证可恢复，而不是依赖在线连接是否存活。

Concept Map

## 五个核心对象构成协作骨架

- Intent 是少量稳定字段 + 自然语言 body 的混合协议。
- Task 表示长生命周期工作对象，状态由事件聚合产生。
- Thread 把澄清、进度、交付挂进同一上下文流。
- Approval 独立于 Task，但影响 blocked / submitted / completed。

Lifecycle

## 状态推进来自 intent 事件

### Task lifecycle

open

request_task 创建任务

candidate

accept_task 进入候选

in_progress

首次 progress 进入执行

submitted

submit_result 等待确认

completed

人工确认或审批通过

### Approval lifecycle

- pending：由 request_approval 创建
- approved / rejected：由 respond_approval 推进
- expired / cancelled：由 TTL 或任务终止触发
- 约束：`completed` 不直接回退，返工要创建 follow-up task

Reliability

## “先落事件，再投递” 是 v1 的基础承诺

- 事件日志是真相源；实时连接只是提醒层。
- 每个 participant 拥有独立 inbox 与消费 cursor。
- 关键事件默认不可丢弃；易失事件可 TTL，但必须留下 discard 审计记录。
- 至少一次投递 + 幂等去重，让重连和重放成为常规路径。

Architecture

## 六个组件围绕 event-store 分工

- broker-server：暴露 HTTP API，可选 WebSocket 提醒
- event-store：append-only 事实源
- projection-engine：派生 TaskView / ApprovalView / InboxItem
- router：按寻址规则分发事件
- policy-layer：审批、TTL、认领模式等本地策略
- client-adapters：对接 Codex、Claude Code、OpenCode

Readiness

## API 与测试面足够支撑 v1 验证

### Stable HTTP surface

- `POST /participants/register` / `/presence`
- `POST /intents` / `GET /inbox/{participant}`
- `POST /inbox/{participant}/ack`
- `GET /tasks/{task_id}` / `GET /threads/{thread_id}`
- `POST /approvals/{approval_id}/respond` / `GET /events/replay`

### Test matrix

- 协议单元测试：字段校验、幂等、状态推进
- 路由测试：participant / role / capability / broadcast
- 可靠性测试：reconnect、duplicate ack、TTL discard record
- 集成测试：从 request_task 到 approval 完成整条链路

Closing

## Intent Broker 是协作基础设施

它用少量稳定 intent、append-only 事件日志、HTTP pull 和审批机制，把多 agent 与人类协作从“临时对话”提升为“可重放、可审计、可恢复”的系统。

建议实施路径： 先实现 v1 的本地闭环与测试矩阵，随后再沿着远程部署、文件邮箱兼容层和更强策略插件向外扩展。