Python MCP server 现在提供十五个工具：除 MCP 集成 中原有七个执行和
文件工具外，新增 list_sandboxes、get_sandbox、set_sandbox_timeout，以及三个后台任务工具 和两个
二进制传输工具。它们复用现有
SDK API，仍受 provider 能力和平台权限限制。本文仅覆盖生命周期管理，不代表 Team 管理
或完整 MCP/Skills 产品规划已经实现。
list_sandboxes 返回当前授权账户及 provider 可见的沙箱，不会创建沙箱、选择默认沙箱或
将列表中的沙箱加入会话关闭清理。可选参数为 status（SandboxStatus 状态）、limit
（1–100，默认 100）、offset（非负整数，默认 0）、provider、region。
增加 offset 获取下一页；返回结果不承诺总数或下一页游标。
{"name":"list_sandboxes","arguments":{"status":"running","limit":10,"offset":0}}get_sandbox 对已管理实例调用 Sandbox.refresh_info()，对外部 ID 调用
Sandbox.get_info_by_id() 获取平台最新元数据。指定 sandbox_id 查询
对应沙箱；省略则查询会话已有默认沙箱。没有默认沙箱时返回工具错误，查询不会创建沙箱
或延长生命周期。显式 ID 不改变默认沙箱。切换 provider 时可用 SDK 的
provider:sandbox_id 限定格式。外部 ID 使用临时控制面基础设施，并在 finally 中关闭；
直接调用 provider 元数据方法，不调用 connect/resume，也不会加入会话关闭销毁集合。
{"name":"get_sandbox","arguments":{}}这两个工具的元数据结果仅包含 sandbox_id、template、status、region、
started_at、end_at、cpu_count、memory_mb、disk_size_mb。时间为 ISO 8601
字符串或 null，缺失的资源字段为 null。不返回访问令牌、环境变量、账户标识、用户
metadata、任意 lifecycle 对象或端点 URL。列表结果的 sandboxes 包含上述对象，另带
请求的 limit、offset。
create_sandbox 在原有 template、timeout、envs 基础上支持 region、cpu
（正整数，单位核）、memory（正整数，单位 MB）、provider（已配置的 provider ID）。
省略资源参数时保留 SDK/provider 默认值。资源组合仍由后端限制，通过输入校验不代表必然
可用。SDK 没有对应 Team 参数，因此不提供 Team 选择。
{"name":"create_sandbox","arguments":{"template":"base","timeout":600,"cpu":2,"memory":2048}}当前源码在显式指定 cpu 或 memory 时，会读取最新平台元数据，逐项核验实际配置后才
返回成功；此修复晚于公开的 0.4.0a6。无法核验或配置不符时返回工具错误，包含
category: "resource_configuration"、requested_resources、observed_resources 和
cleanup_verified，核验与回滚始终使用本次新建实例的原句柄，即使会话已关闭或缓存已变化，也不会按 ID 改查其他实例，并且只回滚本次新建沙箱。清理回读使用该实例实际解析的提供方、端点、地域和凭据建立新的控制面连接，不会用另一默认地域的 404 作为删除证明。只有类型化的不存在错误或 HTTP404 回读
才确认清理完成；结果不明时保留带提供方前缀的 recovery_sandbox_id，供显式清理。
直接 SDK 的 Sandbox.create 合同保持原样。region 仍遵循提供方端点配置，不属于这项
CPU/内存核验。
创建后该沙箱成为默认沙箱。秘密应保存在 MCP 进程已有授权配置中；工具参数和结果可能对 连接的模型可见。
set_sandbox_timeout 必须提供整数 timeout，范围 1–86400 秒，表示从现在起的生命周期，
而不是 HTTP 请求超时。可选 sandbox_id 省略时使用已有默认沙箱，不会隐式创建。
Sandbox.set_timeout() 成功后同步更新会话续期策略，后续执行/文件工具按该时长续期。
平台更新失败时保留之前的策略。
若更新尚未完成时会话已关闭，后续完成不会恢复续期所有权，也不会重建已清除的会话记录。
外部 ID 通过 Sandbox.set_timeout_by_id() 直接修改平台超时，在 finally 中关闭临时
控制面基础设施，不额外调用 connect/resume，不接管资源或在会话关闭时销毁它。
{"name":"set_sandbox_timeout","arguments":{"timeout":600}}成功返回 {"success":true,"sandbox_id":"...","timeout":600}。非法整数（包括布尔值）、
越界 limit/timeout、显式空 ID、不支持的生命周期参数在调用平台前返回工具错误。创建工具
也校验资源整数及 envs 字符串键值。Provider/API 错误通过 isError: true 返回。
生命周期错误仅返回固定的失败类别、可用的 HTTP 状态，或 SDK 错误码及静态恢复建议。 工具结果和 MCP 生命周期错误日志均不包含 provider 原始错误消息、请求 URL、响应校验输入 或异常堆栈。输入校验仅指出无效字段，不回显字段值。
列表委托给 Sandbox.list；已管理实例的查询/续期使用 refresh_info / set_timeout，
外部 ID 使用 Sandbox.get_info_by_id / Sandbox.set_timeout_by_id，没有新增或虚构平台端点。
同步接口为 get_info_by_id_sync / set_timeout_by_id_sync。新类方法与 Sandbox.kill_by_id
接受相同凭据、region 和 provider 覆盖参数，并支持 provider:id 限定 ID。
这些生命周期方法仅按控制面 API URL 路由，不创建 envd 客户端，不接受 sandbox_domain。Python STDIO 与 Streamable HTTP 共用 schema 和 handler。Node.js CLI
有独立 MCP 实现，是否支持这些工具需要单独核对。
单元测试位于 client-sdk/tests/test_agent/test_mcp_lifecycle.py，覆盖输入边界、SDK 委托、
默认沙箱解析、续期失败和元数据泄漏检查。Mock 测试不能证明真实 provider 支持；云端结果
必须另行记录在仓库验证证据中。接口参考
官方 MCP tools 规范。
本源码版本分别记录创建归属和缓存连接。执行或文件工具可通过已配置账号权限，访问
显式指定的外部 ID；该连接属于借用。删除借用方 HTTP 会话、关闭 STDIO 或空闲到期时，
只关闭客户端连接。manager 仅删除自己的创建实例，明确提交的后台任务可保留至平台 TTL。
显式、已授权的 kill_sandbox 仍执行删除。
此修正晚于公开的 0.4.0a6。同一账号凭证下的不同会话不构成租户授权隔离；不同用户 应使用独立凭证、Team 或应用层授权。
manager 按实际提供方和沙箱 ID 组合记录缓存归属、TTL 与任务保留。两个提供方返回相同
原始 ID 时，显式访问须使用 provider:id；有歧义的原始 ID 会被拒绝。别名不会替换已有
自有连接。创建或连接期间关闭会话后，会话保持关闭：晚到的创建实例被删除，晚到的
借用连接被关闭，不重新登记资源。