Name: federation
Author: 843773493

Imported from 843773493/vscode-graph-agent-opencode (app/gateway/federation/AGENTS.md). Install upstream with npx skills add 843773493/vscode-graph-agent-opencode --skill federation. Copyright stays with the author.

目录用途

app/gateway/federation/ 存放 Gateway 联邦控制面：一个中心 hub 与其直接 spoke 之间通过 SSH -L loopback 建立的长期全双工 WebSocket 对等 RPC channel，以及绑定 origin/transit path/audience/capability/target/nonce 的 discovery/operation grant 与 permissions.federation 策略快照。

可修改内容

ws://.../api/gateway/federation/channel 的握手、心跳、断线语义与 RPC 分发。
grant 签发/校验、transit 上限、first-use replay registry、channel 注册表与短 TTL route hint。
permissions.federation 默认值与原子热发布快照。

不可修改内容

不实现 Agent/Job/消息业务逻辑；不写工作区 .boxteam 业务数据。
不新增第二套 federation token 校验；凭据校验统一复用 app/gateway/auth.py。
不把 channel/route/connection locator 写入 link、GlobalThreadAddress 或任何业务幂等键。
不在 hub 保存业务消息正文。

规范

身份、完整性、audience/path、防重放、target 解析与幂等不可关闭；失败一律抛携带稳定错误码的 FederationError，绝不静默降级或返回虚假默认值。
联邦持久状态只写 Gateway 控制面目录；replay registry 跨重启保留有效窗口。
只允许一次 B → A → C transit：max_transit_gateways=1、max_gateway_hops=2。
新增子目录必须补充自己的 AGENTS.md。
模板示例；在整理 AGENTS.md 时请保留此行。

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "843773493-vscode-graph-agent-opencode-federation", "kind": "skill", "name": "federation", "description": "`app/gateway/federation/` 存放 Gateway 联邦控制面：一个中心 hub 与其直接 spoke 之间通过 SSH `-L` loopback 建立的长期全双工 WebSocket 对等 RPC channel，以及绑定 origin/transit path/audience/capability/target/nonce 的 discovery/operation grant 与 `permissions.federation` 策略快照。", "publisher": "843773493", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "`app/gateway/federation/` 存放 Gateway 联邦控制面：一个中心 hub 与其直接 spoke 之间通过 SSH `-L` loopback 建立的长期全双工 WebSocket 对等 RPC channel，以及绑定 origin/transit path/audience/capability/target/nonce 的 discovery/operation grant 与 `permissions.federation` 策略快照。" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/843773493/vscode-graph-agent-opencode", "path": "app/gateway/federation/AGENTS.md", "ref": "01bb01472cdbcb130819e3394502fce68676db9f", "url": "https://github.com/843773493/vscode-graph-agent-opencode/blob/01bb01472cdbcb130819e3394502fce68676db9f/app/gateway/federation/AGENTS.md", "key": "843773493/vscode-graph-agent-opencode/app/gateway/federation/AGENTS.md" } }, "instructions": "# 目录用途\n\n`app/gateway/federation/` 存放 Gateway 联邦控制面：一个中心 hub 与其直接 spoke\n之间通过 SSH `-L` loopback 建立的长期全双工 WebSocket 对等 RPC channel，以及\n绑定 origin/transit path/audience/capability/target/nonce 的 discovery/operation\ngrant 与 `permissions.federation` 策略快照。\n\n## 可修改内容\n\n- `ws://.../api/gateway/federation/channel` 的握手、心跳、断线语义与 RPC 分发。\n- grant 签发/校验、transit 上限、first-use replay registry、channel 注册表与\n 短 TTL route hint。\n- `permissions.federation` 默认值与原子热发布快照。\n\n## 不可修改内容\n\n- 不实现 Agent/Job/消息业务逻辑；不写工作区 `.boxteam` 业务数据。\n- 不新增第二套 federation token 校验；凭据校验统一复用 `app/gateway/auth.py`。\n- 不把 channel/route/connection loc", "cost": { "context_tokens": 238 } }

federation

About

目录用途

可修改内容

不可修改内容

规范

Use it

Manifest

Reviews