成熟度: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 表示可在受控场景使用,但仍需跟随迁移说明处理兼容变化。