Agent Service Spec

agent-service-spec 定义一个绿地的 Agent as a Service 平台规范，包括 Agent、Tool、McpServer 等资源模型，revision / release / binding 模型、控制面 API、读/流接口、runtime SDK / connection 协议、事件模型、协议互操作层、一致性规则与实现符合性要求。

本目录只包含规范，不绑定任何特定产品实现，也不预设任何现有系统已经符合本规范。

当前稳定版本

• v1: 初始平台级规范

阅读顺序

1. GOVERNANCE.md
2. v1/overview/system-model.md
3. v1/overview/terminology.md
4. v1/domains/agent.md
5. v1/domains/agent-revision.md
6. v1/domains/tool.md
7. v1/domains/tool-revision.md
8. v1/domains/mcp-server.md
9. v1/domains/mcp-server-revision.md
10. v1/domains/release-channel.md
11. v1/domains/protocol-binding.md
12. v1/domains/run.md
13. v1/domains/interaction-request.md
14. v1/domains/runtime-connection.md
15. v1/domains/tracing.md
16. v1/state-machines/run-lifecycle.md
17. v1/api/control-plane.openapi.yaml
18. v1/api/read-plane.openapi.yaml
19. v1/api/runtime-sdk.md
20. v1/api/runtime-sdk-recommendations.md
21. v1/api/a2a.md
22. v1/api/acp.md
23. v1/api/ag-ui.md
24. v1/api/mcp.md
25. v1/api/trace-export.asyncapi.yaml
26. v1/conformance/invariants.md

规范边界

• 规范描述逻辑能力与外部契约，不绑定任何特定服务目录结构或代码仓布局。
• 规范优先于实现命名与字段漂移；实现需要向规范收敛。
• 机器可读文件与 Markdown 共同构成正式交付物。
• A2A、ACP、AG-UI 等外部协议面在规范中视为对 canonical 模型的受约束 profile / binding；MCP 通过 McpServer / McpServerRevision 与 ProtocolBinding(protocol=mcp) 收敛到同一真源，而不是独立资源体系。

文档约定

• 正文使用中文。
• 文件名、schema 名称、字段名、枚举值、协议方法名使用英文稳定命名。
• 规范性关键词 MUST、SHOULD、MAY 的含义见 GOVERNANCE.md。