claude-code-best
|
0103f45109
|
feat: 实现 ACP session/delete + message-id 两个 UNSTABLE RFD
session/delete（rfds/session-delete.mdx）：
- sessionCapabilities.delete: {} 能力广告（类型增强写入,SDK 0.19.0 早于该 RFD）
- extMethod 钩子路由 session/delete → unstable_deleteSession
- 硬删除 .jsonl 文件,ENOENT 视为成功（幂等）
- 未知方法抛 RequestError.methodNotFound（JSON-RPC -32601）
message-id（rfds/message-id.mdx）：
- agent_message_chunk / user_message_chunk / agent_thought_chunk 携带 messageId
- forwardSessionUpdates 维护 currentAgentMessageId,lazy 生成 UUID
- streaming text/thinking chunks 与最终 assistant message 共享同一 ID
- replayHistoryMessages per-message 生成 UUID
- PromptRequest.messageId → PromptResponse.userMessageId 回显
- tool_call / plan / subagent 不带 messageId（spec 仅规定 chunk 类型）
测试：ACP service 从 176 → 191 (+15)
- bridge.test.ts: +9 个 message-id 测试
- agent.test.ts: +6 个 session/delete + userMessageId 测试
- 总测试 5851 → 5866,全通过
审计文档：新增附录 A.2 记录两个 UNSTABLE RFD 实现状态
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
|
2026-06-20 12:38:43 +08:00 |
|
claude-code-best
|
cac23e62cc
|
fix: 恢复 ACP usage 传递（usage_update + PromptResponse.usage）
撤销审计 §4.1 的原修复（删除 usage_update 以求严格 v1 stable 合规）。
现实中的所有主流 ACP 客户端（Zed、Cursor 等）实现的是 unstable spec，
删除 usage_update 后客户端 context 使用量一律显示 0/0，严重破坏 UX。
SDK 已包含 UsageUpdate 类型（sessionUpdate: 'usage_update'，字段 used + size
+ 可选 cost）和 PromptResponse.usage 根字段（UNSTABLE 但被广泛实现），这是
context 使用量报告的唯一标准化载体，故选择优先保证 interop。
变更：
- bridge/forwarding.ts: 收到 'result' 消息且 lastAssistantTotalUsage !== null
时发送 usage_update
- used = 最近一条 assistant 消息的 input + output + cache_read + cache_creation
token 总和（≈ 当前上下文占用）
- size = lastContextWindowSize（默认 200000，通过 modelUsage prefix-match 解析）
- compact_boundary 时不发（不知道压缩后实际占用；下一轮 result 会自然修正）
- agent/promptFlow.ts: PromptResponse 根部添加 usage 字段，并镜像到
_meta.claudeCode.usage 供消费者任选读取路径
- 测试更新：bridge.test.ts 三个相关 test 改为断言 usage_update 被发出且
used/size 正确；agent.test.ts 改为断言 root usage 存在
- 审计文档 §4.1 标记为已撤销，添加决策回滚说明
验证：bun run precheck 全通过（typecheck + lint + 5851 tests）
ACP service tests: 176 pass / 0 fail
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
|
2026-06-20 12:38:43 +08:00 |
|
claude-code-best
|
35768837a7
|
fix: 补齐 ACP tool_call 完整生命周期（in_progress）+ 去除伪造 terminal 元数据
承接 acp 合规审计第二轮：修复 tool 调用完整性相关的 3 条遗留发现。
§4.2 [minor] tool_call 从不发出 in_progress 状态：
- bridge.ts toAcpNotifications 的 tool_use 分支：当同一 tool_use 块被第二次遇到
（streaming content_block_start 首次 + assistant 完整消息回放第二次）时，
alreadyCached 路径补发 tool_call_update with status: 'in_progress'。
语义为"input 已收齐，即将执行"。
- ToolCallStatus 完整生命周期现在是 pending → in_progress → completed|failed，
对齐 schema.json:3525-3548 与 tool-calls.mdx:76-91。
- 新增 forwardSessionUpdates 集成测试验证 streaming + 回放场景下发出
in_progress 中间状态。
§4.4 + §5.2 简化版（合并修复）：
- bridge.ts toolInfoFromToolUse Bash 分支：去除 _supportsTerminalOutput 为 true
时发出的 { type: 'terminal', terminalId: toolUse.id }（terminalId 从未通过
terminal/create 注册，合规客户端按此 id 查 terminal/output 会失败）。统一
回退到 description 文本内容。
- bridge.ts toolUpdateFromToolResult Bash 分支：去除 _supportsTerminalOutput
分支里伪造的 terminalId 与三个非标准 _meta 键（terminal_info / terminal_output
/ terminal_exit，违反 _meta 应使用 vendor namespace 的规范）。Bash 输出统一
以 ```console 围栏文本呈现。删除随之无用的 exitCode / terminalId 局部变量。
- _supportsTerminalOutput 参数保留（前向兼容），用 void 标注暂未使用。
- 完整版（真接 terminal/create + terminal/release + PTY）涉及 BashTool 执行
管线改造，需单独决策，留作待办。
测试更新：
- toolInfoFromToolUse Bash 测试改写：不再断言 terminalId，改为断言回退到空
content（无 description）或 description 文本（有 description）。
- toolUpdateFromToolResult Bash 测试改写：不再断言 terminal_info/terminal_output/
terminal_exit，改为断言走 ```console 文本路径且 _meta 为 undefined。
- bash_code_execution_result 测试同步更新。
验证：bun run precheck 全绿（tsc 零错误、biome ci 零警告、5851/5851 测试通过）。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
|
2026-06-20 12:38:43 +08:00 |
|
claude-code-best
|
5e30697950
|
fix: 严格对齐 ACP 协议实现到 stable v1 规范
对照 /Users/konghayao/code/knowledgebase/origin/acp 规范审计并修复 53 条合规性
发现（critical 5 / major 17 / minor 20 / nit 11），完整审计报告见
docs/acp-compliance-audit.md。
Agent 端 (src/services/acp/agent.ts):
- initialize() 补齐 authMethods，promptCapabilities.image 降级为 false（声明与
实现脱节，按 initialization.mdx 不声明的 capability 视为不支持）
- sessionCapabilities.fork 移至 _meta.claudeCode.forkSession（fork 在
meta.unstable.json 中，避免在 stable sessionCapabilities 中暴露 unstable 特性）
- unstable_resumeSession 传 replay:false，不再通过 session/update 重放历史
（session-setup.mdx:239 明确禁止）
- PromptResponse.usage 移至 _meta.claudeCode.usage
（extensibility.mdx:39 禁止在 spec 类型根添加自定义字段）
- 空字符串 prompt 改为显式 throw（不再误返 end_turn）
Bridge (src/services/acp/bridge.ts):
- 删除全部 usage_update discriminator（不在 stable v1 schema 中）
- 显式映射 refusal stop_reason（之前误报 end_turn）
- max_tokens / isError 检查互斥
- Read/Write/Edit/Glob 路径全部绝对化（协议规定路径 MUST 绝对）
- 补全 resource_link / resource ContentBlock 渲染
Permissions (src/services/acp/permissions.ts):
- 补齐 reject_always PermissionOption（schema 规定的四个 option 之一）
- checkTerminalOutput 优先检查标准 clientCapabilities.terminal，
回退到 _meta.terminal_output
- 新增 onPermissionCancelled 回调：cancelled permission outcome →
StopReason::Cancelled（schema.json:629）
- ExitPlanMode cancelled 分支补上 toolUseID 字段
PromptConversion (src/services/acp/promptConversion.ts):
- resource 分支处理 BlobResource（之前静默丢弃 blob 内容）
acp-link 代理 (packages/acp-link/src/):
- WS 协议从专有 {type, payload} 改造为标准 JSON-RPC 2.0
（transports.mdx:52 要求自定义 transport MUST 保留 JSON-RPC 消息格式），
同时向后兼容旧 envelope
- 实现 $/cancel_request 处理
- 使用 JSON-RPC 标准错误码 -32700 / -32600 / -32601 / -32602 / -32603
- capability / agentInfo / protocolVersion 完整透传
验证：bun run precheck 全部通过（tsc 零错误、biome ci 零警告、5841/5841 测试通过）；
ACP 专项测试 221/221 通过。独立 verification agent 抽查全部 PASS。
已知暂缓项（审计文档附录 B/C）：
- §3.5 traceparent/trace-context 传播（QueryEngine 无 header hook）
- §5.2 terminal/create 完整生命周期（P1，非阻断，需新 RPC 流程）
- §4.2 in_progress tool_call status（SHOULD 级）
- §8.8/8.9/8.14 stale types.ts（不在 owner 分配集合，runtime 已修正）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
|
2026-06-20 12:38:43 +08:00 |
|