开发文档 · API 与协议参考

Interaction Protocol

Thread、Run、Consent 与 Fellow 原生流式事件的交互协议边界。

成熟度:Preview

Interaction Protocol 负责建立 Thread、发起、监督、注入或取消 Run,处理 Consent,并把执行结果以流式事件投影给应用。它不保存业务对象真相,也不承载 Console、Runtime 或全部产品 CRUD。

当前可用

Thread / Run、Fellow StreamEvent SSE、取消、注入和 Consent 已有实现,并可通过 @fellow.work/client 在 TypeScript/Web/Node 中使用。该 SDK 是参考实现;具体 HTTP 行为仍以 Gateway 实现为准。

信任边界

浏览器不得持有 fkey_…,应通过受信后端交换短期且受 origin 约束的 Token。服务端必须同时校验主体、Scope 与资源归属。SSE 内容、恢复位置和客户端参数都属于不可信输入。

版本与恢复边界

Fellow StreamEvent SSE 是当前原生 wire;AG-UI 仅是 Interfaces adapter。统一机器可读 Schema、错误 envelope、通用幂等键和完整 SSE 恢复参数仍在继续规范化,不能假定所有端点已具备相同行为。断流不等于 Run 失败,消费者应以明确终态为准。

当前不包含

Object / Control API、任意 Host shell、Management API、Connector 服务端实现及 HARP 生命周期不属于 Interaction。Preview 表示可在受控场景使用,但仍需跟随迁移说明处理兼容变化。

相关文档