成熟度:Stable @ @fellow.work/client ≥ 0.7.1(FPP-0032 · P5-01 adapter 平台)
Interfaces Protocol 描述边界 adapter 的能力声明、wire fixture 与 Gateway 挂载点。它不拥有 Thread / Run / Object 领域真相,也不把 Channels 或 MCP 塞进 @fellow.work/client 根 export。
Preview exit 基线仍为 0.5.90(fpp-0027);Stable 宣告不扩大 Gateway 产品 API 面。
四个 adapter(registry)
| adapter_id | 实现 | npm / 面 | Conformance |
|---|---|---|---|
| ag-ui | StreamEvent → AG-UI | @fellow/ag-ui-adapter@0.1.0 · subpath @fellow.work/client/ag-ui | mapping fixture + tarball smoke |
| channels | IM → ChannelDispatcher → RunManager | Gateway /api/channels · /api/channels/webhooks/*(internal,无 npm adapter 包) | ingress.json · webhooks.json(9)· dispatcher-inbound.json(5)· platform-taxonomy.json · gateway-outbound-inbound.json(4);门禁 spec:channels:recording-gate · dispatcher-hono-e2e · platform-taxonomy · outbound-fixtures · interfaces-exit-gate |
| mcp | 用户 MCP 注册表 | Gateway /api/mcp/* | boundary.json + contract tests |
| connectors | Hub + AnyConnect 代理 | Gateway /api/connectors · /api/connector/* | boundary.json + contract tests |
权威索引:SDK tarball 内 spec/operations/interfaces-adapters-registry.md · interfaces-stable-readiness.md。
AG-UI 消费方
推荐:
import { AgUiMapper } from '@fellow/ag-ui-adapter';
// 或
import { AgUiMapper } from '@fellow.work/client/ag-ui';
已移除(≥ 0.7.0 · fpp-0026): 从 @fellow.work/client 根 import AgUiMapper / AgUiCustomName / AgUiMapContext。迁移:spec/operations/ag-ui-adapter-migration.md。
门禁(工程)
cd sdk && pnpm spec:interfaces:check && pnpm spec:interfaces:exit-gate && pnpm spec:interfaces:stable-gate
cd sdk && pnpm spec:runner:adapter:tarball
cd gateway/packages/api && pnpm test:channels-ingress && pnpm test:channels-webhook-recording \
&& pnpm test:channels-dispatcher-hono-e2e && pnpm test:interfaces-boundaries
cd gateway/packages/gateway && pnpm exec vitest run \
src/modules/channels/webhook-provider-fixtures.test.ts \
src/modules/channels/dispatcher-inbound-fixtures.test.ts \
src/modules/channels/outbound-provider-fixtures.test.ts
Monorepo:bash scripts/verify-protocol.sh(委派 sdk/examples/verify-protocol.sh;pnpm spec:check 含 Interfaces/Channels exit、verify-protocol pack/exit、open-platform train exit)。
协议事实 SoT:@fellow.work/client 发布包内 spec/(版本见 Changelog · spec/status.md)。