开发文档 · API 与协议参考

Case Protocol

轻量工作单实例、有限状态机与事件(Stable opt-in MVP)。

成熟度:Stable(opt-in) @ @fellow.work/client ≥ 0.6.4(FPP-0030)

Case Protocol 提供独立于 Thread/Run 的轻量工作单:create / get / list / transition / events。Gateway 在 FELLOW_CASE=1 时挂载 /api/cases/* 并宣告 case.v1。SDK 使用 @fellow.work/client/case(不挂在 createClient() 根上;见 Changelog)。

设计职责

Case 回答“这次可关闭的工作单元处于什么状态”。它引用 Object / Thread / Run,但不拥有它们的 lifecycle。CaseEvent 为状态转换真相;Stream 仅为投影。

信任边界

非法转换与并发冲突须失败且无副作用。关闭 case.v1 后实例与事件只读保留(Gateway 策略以 capability 为准)。

版本边界

字段与状态机以 SDK spec/openapi.yaml、case.schema.json 与 conformance fixtures 为准;集成前核对 兼容矩阵。

当前可用与过渡

  • 已提供(Stable wire,opt-in):5 operations · spec:case:stable-gate · pnpm protocol:phase3。
  • 尚未承诺:Flow Template 编辑器、默认开启、全平台编排。产品 Flow/Case 愿景见架构文档,不等同于本 MVP wire。

相关文档