开发文档 · API 与协议参考

AIOS 协议族

Interaction、Host、Runtime、Interfaces、Management、Case 等协议模块的职责与成熟度。

AIOS Protocol Suite 将智能应用的交互、执行、宿主能力、外部适配和企业治理拆成多个独立模块。它不是一个 /aios 万能 API,也不是单一 SDK。

模块一览

模块唯一职责当前成熟度
InteractionThread / Run、监督、Consent 与流式结果(Stable @ ≥ 0.6.0)Stable
Hosthost-results v2 wire(Stable @ ≥ 0.7.3;能力目录 waiver)Stable
RuntimeWorkload 查询与取消(Stable @ ≥ 0.6.5,opt-in runtime.v1)Stable
InterfacesAG-UI、Channels、MCP、Connectors 边界 adapter(Stable @ ≥ 0.7.1)Stable
ManagementOperator:/api/console/* + Platform /api/*(Stable @ ≥ 0.5.65)Stable
Case轻量工作单实例与有限状态机Stable @ ≥ 0.6.4(opt-in,case.v1)

成熟度是保守判定。“已有代码”不等于 Preview;机器可读契约、版本和错误语义、安全边界与一致性测试必须同时具备。

当前开发者入口

当前稳定程度最高的路径是 Interaction:

应用 / UI
   │
@fellow.work/client
   │
Thread / Run / Fellow StreamEvent SSE
   │
Gateway → Runtime → Sandbox / Host

@fellow.work/client 是 Interaction 在 TypeScript/Web/Node 环境中的参考实现,不覆盖 Case、Runtime、Management、Connectors 或所有产品 API。

共同约束

  • 每个模块独立版本化;包版本不能替代协议版本。
  • Fellow StreamEvent SSE 是当前原生 wire,AG-UI 是 adapter。
  • 所有副作用操作在进入 Preview 前必须定义幂等语义。
  • API Key、用户 Token、Console Token 与 Host Consent 属于不同凭证域。
  • Host 能力默认拒绝,必须经过能力目录、结构化参数和授权边界。
  • Case / Runtime 为 Stable wire,但 仍默认关闭;不得假设无开关即挂载。

规范来源

完整的架构决策、依赖图、信任边界、成熟度和 Phase 0–5 路线见中央规范: