成熟度:Stable(Integration 25-op 子集 · @fellow.work/client ≥ 0.6.0 · FPP-0028)
Interaction Protocol 负责建立 Thread、发起、监督、注入或取消 Run,处理 Consent,并把执行结果以流式事件投影给应用。它不保存业务对象真相,也不承载 Console、Runtime 或全部产品 CRUD。同仓库 OpenAPI 中 Control / Object / Case / Runtime 均为 Stable opt-in(≥ 0.6.1 / 0.6.3 / 0.6.4 / 0.6.5);Host 仍为 Experimental,以 协议登记表 为准。
当前可用
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 Stable 子集。Stable 子集遵循 SemVer;见 SDK interaction-stable-semver.md 与 Changelog。