Path 返回计划文件的绝对路径（供测试和日志使用）。

PopMessage 删除并返回最新一条消息；无消息时返回 nil, nil。

ReadFile 从 bind mount 的宿主机文件系统读取文件，与容器内视图一致。

Register 将工具注册到注册表中。 同名工具已存在时返回 error 且保留原实现，由调用方决定如何处理冲突 （静默忽略、终止启动、或先 unregister 再注册）。

RunBash 通过 docker exec 在容器内执行 bash 命令。 命令失败（非零退出）时返回 (errorString, nil)，保持 Self-Correction Loopback 语义。

SaveTodos 内存实现：无操作（无持久化）。

SaveTodos 原子性保存任务列表（write-replace 语义）。 事务内先删除该会话所有旧 todos，再全量插入新列表。

Send 发送 JSON-RPC 请求并等待响应（支持 ctx 超时取消）。

Start 启动容器并等待就绪：docker run → 轮询 docker inspect → StateRunning。 若 docker run 失败立即转 StateFailed；若轮询超时（StartTimeout）也转 StateFailed。

Start 启动子进程并开始读取 stdout 中的响应。

TestBashTool_EffectiveTimeout 验证超时优先级：per-call > 工具配置 > 默认。

TestBashTool_Execute_ParentContextCancelled verifies that a long-running command is killed when the parent context times out, and the result is return

TestBashTool_PerCallTimeout 验证 timeout_secs 能放宽单次命令超时。

TestBashTool_TimeoutBanner 验证本地超时路径追加清晰的 TIMEOUT 横幅。

TestBashTool_Truncation_KeepsHeadAndTail 验证大输出同时保留头部与尾部， 不再像旧实现那样只留头部丢尾部（测试失败摘要/traceback 在尾部）。

buildEditSummary：CRLF 文件归一化后正常展示

buildEditSummary：纯删除（只删除行，无新增）

buildEditSummary：纯插入（只新增行，无删除）

buildEditSummary：变更超过 20 行时只报数字，不展开 diff

buildEditSummary：单行替换，验证 - / + 行和上下文行

TestBuildMentionHint 验证 @ 前缀的子代理建议提示：前缀匹配、全列出、无匹配。

TestClient_CallTool_EmptyContent 验证空 Content 时返回空字符串且无 error。

TestClient_CallTool_IsError 验证 isError=true 时同时返回非 nil error。

---- Client.CallTool 测试 ---- TestClient_CallTool_Success 验证工具调用返回文本内容正确拼接。

TestClient_Close_DelegatesToTransport 验证 Close 调用底层 Transport.Close。

TestClient_Connect_ContextCancelled 验证 ctx 取消时 Connect 返回 context 错误。

TestClient_Connect_StartFails 验证 Transport.Start 失败时 Connect 返回包装错误。

---- Client.Connect 测试 ---- TestClient_Connect_Success 验证正常握手三步流程后 Tools 被正确填充。

TestClient_Connect_ToolsListParseFails 验证 tools/list 返回非法 JSON 时 Connect 返回错误。

TestCompact_EmptySession 验证 session 无消息时，Compact 返回零值 CompactionData 且不报错。

TestCompact_NilCompactor 验证 compactor 为 nil 时，Compact 返回零值 CompactionData 且不报错。

TestCompact_NilSession 验证 session 为 nil 时，Compact 返回零值 CompactionData 且不报错。

TestCompact_Normal 验证正常执行：session 历史被替换为压缩后版本，CompactionData 字段正确。 与真实使用场景一致：system prompt 不持久化到 session DB， Compact 内部动态注入 system prompt 后交给 compact

TestContextCancellation 验证 Context 取消信号的传播。

TestContextEngineering 运行 Context Engineering 能力评估（3 个黄金用例）。

TestDecisionConstructors 验证 Allow/Deny/Ask 快捷构造函数的字段设置正确。

TestDefaultBootstrapCmd 验证默认自举命令包含恢复 pip、editable 安装当前仓库、安装 pytest 三要素——这是"可配置·默认自举"路线让真实测试可运行的基础（接通 sandbox.BootstrapCmd 接缝）。