运行元数据接口
从托管 VM 读取 Agent、owner、当前轮次和仓库信息，区分元数据与凭据。
Agent metadata 当前为 preview，可能发生破坏性变化。它提供运行现场信息，不是外部 API/SDK 创建 Agent 时附加的自定义 metadata 标签，也不是身份凭据。
读取与发现
curl --unix-socket "${CURSOR_AGENT_SOCKET:-/run/cursor/api.sock}" \
http://cursor-agent/v1/meta-data/agent/id接口使用 GET，无 body 或额外 headers。请求 /v1/meta-data/ 列出 agent/、owner/、turn/、workspace/ 等当前存在的前缀，再按需读取子键。
成功响应为 text/plain；单键返回文本，多值一行一个，前缀按字母排序并在子目录名后加 /。缺失键返回 404，错误响应则为 JSON。
常用键
| 键 | 含义 |
|---|---|
| agent/id、agent/name、agent/source | 运行 ID、名称与启动来源 |
| owner/user-id、owner/service-account-id | 原始拥有者 |
| owner/team-id | 所属团队 |
| turn/id、turn/user-id | 当前轮次及提交者 |
| turn/model | 实际服务模型，选 Auto 时也返回实际模型 |
| workspace/repo-url | 主仓库 |
| workspace/repo-urls | 完整仓库集，一行一个 |
| workspace/branch-name、workspace/environment-id | 当前分支与环境 |
turn/ 只在编码轮次活跃时存在，不能跨轮缓存；团队 follow-up 的提交者可能不同于 owner。repo-urls 缺失表示集合尚未知，不等于只有一个仓库。
可用范围
托管 VM 的 Agent、Hooks 和 install 脚本可使用同一 socket。Self-Hosted Machines 当前只提供可选 OIDC token API，不提供 metadata 接口。
元数据未签名，任意能访问 socket 的进程都能读取。外部服务需要验证身份时应使用OIDC，不要把 owner/user-id 文本当凭据转发。
限额与重试
每 VM 每分钟最多 120 个请求，突发最多 20；8 个并发连接上限与 OIDC 共用。启动时 socket 尚未就绪可重试连接。
429、503、500、502、504 按退避处理，403 为授权失败；404 可能只是当前没有活跃 turn 或对应键缺值，应按业务条件处理。