AGENTS.md@packages/runtime-mcp git:20260812.8ae540cA

Immutable. This exact content never changes and is served at /api/v1/blob/e54a0b4f69ed2610.

# Team: Runtime

> 本包属于 **Runtime Team**，同组包：`runtime-core`、`runtime-storage`、`runtime-telemetry`、`runtime-tools`、`cli-app`

## 职责范围

MCP（Model Context Protocol）的独立 Runtime Feature：定义版本化工具视图 Source Port、增量同步、
Turn generation 内的渐进披露和模型调用级 Prompt/Tool 物化。

## 注意事项

- `src/` 不得导入或 re-export `@vetta/coding-agent`
- 不在本包解析 Desktop/CLI 产品配置，也不绑定具体 `McpManager`
- 具体 MCP SDK、stdio/HTTP、OAuth Provider 与显式路径文件适配器由本包提供；产品目录和交互式授权流程由宿主适配层提供
- 动态新增、删除、未变化 binding 保留、失败保持和渐进披露必须有独立测试
- 修改公开 Port 时同步检查 `runtime-composition` 与 coding-agent 的 legacy adapter

## 测试要求

- 使用 Vitest Node 测试和本地 fake transport/server，不默认连接真实 MCP 服务、OAuth Provider 或用户配置。
- Tool/Resource/Prompt 发现、增量同步或渐进披露变化时，必须覆盖新增、删除、替换、未变化复用、乱序/重复通知、失败保持、取消、活动 Turn 保持旧 generation 和下一 Turn 可见性。
- stdio/HTTP、OAuth、Schema 或公开 Port 变化必须增加对应合同或传输集成测试，验证协议错误、清理和重连；产品目录与交互授权行为留给 Coding Agent/Desktop 测试。