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 Participant Task Thread Approval
  • 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 的基础承诺

Intent events (SQLite) router inbox + cursor WS notify HTTP pull
  • 事件日志是真相源；实时连接只是提醒层。
  • 每个 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
broker-server event-store router projection policy client-adapters
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 的本地闭环与测试矩阵，随后再沿着远程部署、文件邮箱兼容层和更强策略插件向外扩展。