@deepwhale/coding-agent 1.0.10 → 1.0.12

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 yysf1949
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 yysf1949
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepwhale/coding-agent",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "DeepWhale CLI: DeepSeek-first AI coding agent. Linear sessions, 6 tools, Docker sandbox.",
   "license": "MIT",
   "type": "module",

package/dist/agent/agent-compaction.d.ts

@@ -1,74 +0,0 @@
-/**
- * Tool Loop + Compaction 集成 (Sprint 1c-revive-2-D-5 + D-5-2)
- *
- * 拍板 (跟 P21 / P27 跨协议 6 cell 一致):
- *   - runToolLoop 每次 LLM call 前, 测 messages token 数
- *   - 触发 (>= window * compactRatio) → 调 summaryFn (LLM 走同 client 拍板)
- *   - 成功 → 替换 working messages, 写 1 条 'compaction' event 到 SessionWriter
- *   - 失败 → CompactionState 累计; latch → 写 1 条 'compaction_paused' event
- *   - paused → 跳过 compaction (不浪费 LLM token 调 summaryFn, 防 death loop)
- *
- * 协议集成 (P38 拍板 + D-5-2 拍板):
- *   - protocol: 'openai' | 'anthropic' (用于 summaryFn, 不同协议 system prompt 不同)
- *   - 集成在 runToolLoop 入口, 跟 tool-loop.ts P21 6 cell 拍板一致:
- *     DeepSeek + Anthropic 协议都走同一 hook
- *
- * 不变量:
- *   - compaction 永不 throw 给 runToolLoop (防 LLM 续聊死锁)
- *   - 失败 event 总能写盘 (即使 writer.append 抛错, 也只 warn 不 throw)
- *   - paused 后仍跑 runToolLoop 正常 (不阻塞用户任务, 仅不再 compact)
- *
- * @module @deepwhale/coding-agent/agent-compaction
- */
-import { type ChatMessage, type LLMClient } from '@deepwhale/llm';
-import { type CompactionConfig, type SummarizeFn, CompactionState } from '@deepwhale/core';
-import type { SessionWriter } from '@deepwhale/core';
-import type { ToolLoopOptions, ToolLoopResult } from './tool-loop.js';
-/**
- * Compaction 集成配置 (runToolLoop 包装层用).
- *
- * 跟 core CompactionConfig 区别:
- *   - client 来自 coding-agent 包 (P21 拍板: 协议从 LLMClient 推断)
- *   - state 由集成层管 (caller 用 new CompactionState(...) 注入)
- *   - protocol 拍板: 'openai' (DeepSeek) | 'anthropic' — summaryFn 的 system prompt 不同
- */
-export interface AgentCompactionConfig extends CompactionConfig {
-    /** 协议拍板 — 跟 P21 6 cell 一致. summaryFn 内部用此拍 system prompt 模板. */
-    readonly protocol: 'openai' | 'anthropic';
-    /** SessionWriter — 写 'compaction' / 'compaction_paused' event 用 */
-    readonly writer: SessionWriter;
-    /** CompactionState — caller 管, 跨 runToolLoop 调用持久化 */
-    readonly state: CompactionState;
-}
-/**
- * 跑 runToolLoop 集成 compaction 触发.
- *
- * 拍板行为 (跟 P21 6 cell 一致):
- *   1. 入口测 token → 触发则 compact → 替换 working
- *   2. runToolLoop 内部每个 LLM call 前不重复触发 (避免 per-step 开销)
- *   3. 失败 latch → 写 paused event, runToolLoop 继续跑 (不阻塞)
- *
- * Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): caller-side system prefix
- * handling. 拍板: REPL/caller 可能把系统提示拼到 messages 最前面 (e.g. integration
- * test fixture, 或未来 system prompt 注入). 传 compact() 之前先 **剥掉** 连续
- * system 前缀, 让 compact 看到的 index 跟 session-adapter 累积 messages
- * (user/assistant/tool + compaction summary) 同 index 空间, replaced_range
- * 切 reload replay 同步. compact 后把 system 前缀 **原样 prepend 回** 替换后
- * 的 messages, LLM 看到的 context 跟 caller 拼的一致.
- *
- * @param client  LLM client
- * @param messages 入口 messages (不变, 内部 copy)
- * @param options runToolLoop 原生 options
- * @param compaction 集成配置
- * @param summaryFn 生成 summary text 的 callback (caller 决定 LLM 协议)
- * @returns ToolLoopResult
- */
-export declare function runToolLoopWithCompaction(client: LLMClient, messages: ReadonlyArray<ChatMessage>, options: ToolLoopOptions | undefined, compaction: AgentCompactionConfig, summaryFn: SummarizeFn): Promise<ToolLoopResult>;
-/**
- * 便捷工具: 估算当前 messages 的 token 数 (供 REPL / footer 拍板显示用).
- *
- * 跟 compaction.ts 的 estimateTokens 拍板一致 (char/4 粗估).
- * 集成在 coding-agent 包, 供 REPL 端零成本 import core.
- */
-export declare function estimateContextTokens(messages: ReadonlyArray<ChatMessage>): number;
-//# sourceMappingURL=agent-compaction.d.ts.map

package/dist/agent/agent-compaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-compaction.d.ts","sourceRoot":"","sources":["../../src/agent/agent-compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEhB,eAAe,EAGhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGtE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,EACpC,OAAO,EAAE,eAAe,YAAK,EAC7B,UAAU,EAAE,qBAAqB,EACjC,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,cAAc,CAAC,CAUzB;AAyFD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAElF"}

package/dist/agent/agent-compaction.js

@@ -1,145 +0,0 @@
-/**
- * Tool Loop + Compaction 集成 (Sprint 1c-revive-2-D-5 + D-5-2)
- *
- * 拍板 (跟 P21 / P27 跨协议 6 cell 一致):
- *   - runToolLoop 每次 LLM call 前, 测 messages token 数
- *   - 触发 (>= window * compactRatio) → 调 summaryFn (LLM 走同 client 拍板)
- *   - 成功 → 替换 working messages, 写 1 条 'compaction' event 到 SessionWriter
- *   - 失败 → CompactionState 累计; latch → 写 1 条 'compaction_paused' event
- *   - paused → 跳过 compaction (不浪费 LLM token 调 summaryFn, 防 death loop)
- *
- * 协议集成 (P38 拍板 + D-5-2 拍板):
- *   - protocol: 'openai' | 'anthropic' (用于 summaryFn, 不同协议 system prompt 不同)
- *   - 集成在 runToolLoop 入口, 跟 tool-loop.ts P21 6 cell 拍板一致:
- *     DeepSeek + Anthropic 协议都走同一 hook
- *
- * 不变量:
- *   - compaction 永不 throw 给 runToolLoop (防 LLM 续聊死锁)
- *   - 失败 event 总能写盘 (即使 writer.append 抛错, 也只 warn 不 throw)
- *   - paused 后仍跑 runToolLoop 正常 (不阻塞用户任务, 仅不再 compact)
- *
- * @module @deepwhale/coding-agent/agent-compaction
- */
-import { runCompactionWithLatch, estimateTokens, } from '@deepwhale/core';
-import { runToolLoop } from './tool-loop.js';
-/**
- * 跑 runToolLoop 集成 compaction 触发.
- *
- * 拍板行为 (跟 P21 6 cell 一致):
- *   1. 入口测 token → 触发则 compact → 替换 working
- *   2. runToolLoop 内部每个 LLM call 前不重复触发 (避免 per-step 开销)
- *   3. 失败 latch → 写 paused event, runToolLoop 继续跑 (不阻塞)
- *
- * Sprint 1c-revive-2-D-6 (review P1 修复, 2026-06-04): caller-side system prefix
- * handling. 拍板: REPL/caller 可能把系统提示拼到 messages 最前面 (e.g. integration
- * test fixture, 或未来 system prompt 注入). 传 compact() 之前先 **剥掉** 连续
- * system 前缀, 让 compact 看到的 index 跟 session-adapter 累积 messages
- * (user/assistant/tool + compaction summary) 同 index 空间, replaced_range
- * 切 reload replay 同步. compact 后把 system 前缀 **原样 prepend 回** 替换后
- * 的 messages, LLM 看到的 context 跟 caller 拼的一致.
- *
- * @param client  LLM client
- * @param messages 入口 messages (不变, 内部 copy)
- * @param options runToolLoop 原生 options
- * @param compaction 集成配置
- * @param summaryFn 生成 summary text 的 callback (caller 决定 LLM 协议)
- * @returns ToolLoopResult
- */
-export async function runToolLoopWithCompaction(client, messages, options = {}, compaction, summaryFn) {
-    // 1) 剥掉 caller 拼的连续 system prefix, 保持 replaced_range 跟 JSONL 累积同空间
-    const headSystem = splitSystemPrefix(messages);
-    // 2) 入口测 token, 触发则 compact 替换 messages (在剥掉 system 的子集上跑)
-    const compactedTail = await maybeCompactBeforeLoop(headSystem.tail, compaction, summaryFn);
-    // 3) 拼回 system prefix → 跑原生 runToolLoop
-    const compactedMessages = [...headSystem.prefix, ...compactedTail];
-    return runToolLoop(client, compactedMessages, options);
-}
-/**
- * 把 messages 切分为 "caller 自带的连续 system prefix" + "其余".
- *
- * 拍板 (D-6 review P1 修复, 2026-06-04):
- *   - prefix = messages[0..n), n = 头连续 system message 数量
- *   - tail   = messages[n..)
- *   - 没 system prefix → prefix=[], tail=messages
- *   - 全 system (只有 1 条 system 也算) → tail=[] (compaction 看到空, 不触发)
- *
- * 用途: caller 把 system prompt 拼前面时, 传给 compact() 前先剥掉, 让
- * replaced_range 的 index 空间 跟 session-adapter replay JSONL 时累积的
- * messages (user/assistant/tool + 之前 reload 注入的 summary) 同空间,
- * reload replay 不会 off-by-one.
- *
- * **不动** 中间或末尾的 system message (罕见, 但保留 — 不归 compaction 管).
- * **不动** tool_call_id 关联, 因为 prefix 是 system role, 不会拖 tool pair.
- */
-function splitSystemPrefix(messages) {
-    let n = 0;
-    while (n < messages.length && messages[n].role === 'system') {
-        n++;
-    }
-    return {
-        prefix: messages.slice(0, n),
-        tail: messages.slice(n),
-    };
-}
-/**
- * 入口 compaction 触发 (one-shot, 不重入 runToolLoop 内部).
- *
- * 行为契约:
- *   - paused → 返 messages 原样, 不调 summaryFn, 不写 event (latched 拍板)
- *   - 不该 compact → 返 messages 原样, 不调 summaryFn, 不写 event
- *   - compact 成功 → 替换 messages, 写 'compaction' event
- *   - compact 失败 (未 latch) → 返 messages 原样, 不写 event (caller 该 retry)
- *   - compact latched → 写 'compaction_paused' event, 返 messages 原样
- */
-async function maybeCompactBeforeLoop(messages, compaction, summaryFn) {
-    const { state, writer, protocol, contextWindow } = compaction;
-    // protocol 显式使用一次, 拍板留位 (跟 P21 6 cell summaryFn 拍 system prompt 模板用)
-    void protocol;
-    if (contextWindow <= 0)
-        return messages;
-    if (messages.length === 0)
-        return messages;
-    if (!state.shouldAttempt())
-        return messages;
-    let result;
-    try {
-        result = await runCompactionWithLatch(messages, compaction, summaryFn, state);
-    }
-    catch {
-        // 未触发 latch 的失败: caller 决定怎么处理 (e.g. 用户改配置), 这里不抛
-        // 拍板不阻塞 runToolLoop
-        return messages;
-    }
-    if (result === null) {
-        // 不该 compact 或 paused
-        return messages;
-    }
-    if (result.kind === 'ok') {
-        // 写 'compaction' event — writer.append 抛错只 warn, 不 throw
-        try {
-            await writer.append(result.event);
-        }
-        catch {
-            // 写盘失败不阻塞 loop
-        }
-        return result.result.messages;
-    }
-    // kind === 'latched'
-    try {
-        await writer.append(result.pausedEvent);
-    }
-    catch {
-        // 写盘失败不阻塞 loop
-    }
-    return messages;
-}
-/**
- * 便捷工具: 估算当前 messages 的 token 数 (供 REPL / footer 拍板显示用).
- *
- * 跟 compaction.ts 的 estimateTokens 拍板一致 (char/4 粗估).
- * 集成在 coding-agent 包, 供 REPL 端零成本 import core.
- */
-export function estimateContextTokens(messages) {
-    return estimateTokens(messages);
-}
-//# sourceMappingURL=agent-compaction.js.map

package/dist/agent/agent-compaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-compaction.js","sourceRoot":"","sources":["../../src/agent/agent-compaction.ts"],"names":[],"mappings":"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"}

package/dist/agent/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * @deepwhale/coding-agent/agent — Tool Loop & 调度
- *
- * Sprint 1a 落地：
- * - runToolLoop: 最小 agent loop（LLM ↔ tool_calls ↔ LLM）
- * - ToolLoopLimitError: maxSteps 触顶时抛
- * - session-adapter: tool loop step ↔ JSONL SessionEvent 转换
- *
- * Sprint 1b 再加：plan mode、schema 校验、budget cap、onStep 实时回调。
- * Sprint 2+ 再加：并行 tool_call、recovery 3-way、断点续传。
- */
-export { runToolLoop, isToolLoopError, TOOL_LOOP_DEFAULT_MAX_STEPS, type ToolLoopOptions, type ToolLoopResult, type ToolLoopStep, ToolLoopLimitError, } from './tool-loop.js';
-export { toolLoopStepToSessionEvent, sessionEventsToMessages, appendUserEvent, appendCompactionEvent, appendCompactionPausedEvent, appendVerificationEvent, persistToolLoopSteps, loadSession, } from './session-adapter.js';
-export { runToolLoopWithCompaction, estimateContextTokens, type AgentCompactionConfig, } from './agent-compaction.js';
-export { CompactionState, type CompactionConfig } from '@deepwhale/core';
-//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,EACX,eAAe,EACf,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/agent/index.js

@@ -1,17 +0,0 @@
-/**
- * @deepwhale/coding-agent/agent — Tool Loop & 调度
- *
- * Sprint 1a 落地：
- * - runToolLoop: 最小 agent loop（LLM ↔ tool_calls ↔ LLM）
- * - ToolLoopLimitError: maxSteps 触顶时抛
- * - session-adapter: tool loop step ↔ JSONL SessionEvent 转换
- *
- * Sprint 1b 再加：plan mode、schema 校验、budget cap、onStep 实时回调。
- * Sprint 2+ 再加：并行 tool_call、recovery 3-way、断点续传。
- */
-export { runToolLoop, isToolLoopError, TOOL_LOOP_DEFAULT_MAX_STEPS, ToolLoopLimitError, } from './tool-loop.js';
-export { toolLoopStepToSessionEvent, sessionEventsToMessages, appendUserEvent, appendCompactionEvent, appendCompactionPausedEvent, appendVerificationEvent, persistToolLoopSteps, loadSession, } from './session-adapter.js';
-export { runToolLoopWithCompaction, estimateContextTokens, } from './agent-compaction.js';
-// Re-export core compaction types for caller convenience
-export { CompactionState } from '@deepwhale/core';
-//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,EACX,eAAe,EACf,2BAA2B,EAI3B,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAC/B,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC"}

package/dist/agent/session-adapter.d.ts

@@ -1,177 +0,0 @@
-/**
- * Session ↔ Tool Loop 适配器（Sprint 1a）
- *
- * 把 tool loop 的 ToolLoopStep 事件 → SessionEvent JSONL 持久化，
- * 同时支持从已有 JSONL 重建 messages 列表（让 LLM 看到"上次聊到哪"）。
- *
- * Sprint 1a 范围（极简）：
- *   - assistant step → 'assistant' event（保留 tool_calls）
- *   - tool step → 'tool' event（保留 tool_call_id + name + result）
- *   - 不持久化 user 消息（REPL 层自己 append 'user'）
- *   - 不持久化 limit/error 事件（runtime 状态，不进 LLM context）
- *   - 不做 compaction、加密、压缩、分片（v1.5+）
- *
- * 重建 messages 规则（让 LLM 续聊）：
- *   - 遍历 events，遇到 user/assistant/tool 都 push 成 ChatMessage
- *   - tool 消息需保留 tool_call_id
- *   - assistant 消息需保留 tool_calls
- *   - 系统提示由 caller 单独组装（repl.ts 拼），不存 JSONL
- *
- * @module @deepwhale/coding-agent/session-adapter
- */
-import type { ChatMessage } from '@deepwhale/llm';
-import type { SessionEvent, SessionWriter, SessionReader } from '@deepwhale/core';
-import type { ToolLoopStep } from './tool-loop.js';
-/**
- * 把 tool loop step 翻译成 SessionEvent。
- *
- * 只翻译能放进 LLM context 的 step:
- *   - 'assistant' → { kind: 'assistant', ts, content, tool_calls }
- *   - 'tool'      → { kind: 'tool', ts, tool_call_id, name, result }
- *
- * limit/error 是 runtime 状态，**不**持久化（避免重启时把它们当 LLM context 喂回）。
- */
-export declare function toolLoopStepToSessionEvent(step: ToolLoopStep): SessionEvent | null;
-/**
- * 把 SessionEvent 列表重建为 LLM 的 ChatMessage 列表（用于 LLM 续聊）。
- *
- * Sprint 1c P2 修复: 过滤 dangling tool_call transcript.
- *
- * 背景: 二次启动恢复时, JSONL 里可能存在 "assistant(tool_calls=[c2]) 但
- * tool(c2) 没落盘" 的孤立 assistant (crash 写完 assistant 还没写 tool result
- * 就被杀). 旧实现直接 push 这个 assistant → LLM continuation 看到无对应
- * tool result 的 tool_call, 形成非法 transcript, OpenAI API 拒收.
- *
- * 修复规则 (按 user 拍板 2026-06-04):
- *   1. assistant(tool_calls): 只有在下一个 user/assistant 前, 所有
- *      tool_call_id 都有对应 tool event, 才保留 (整个 assistant message)
- *   2. tool: 只有它的 tool_call_id 属于"当前未结算的 assistant tool_calls",
- *      才保留; 否则丢 (孤儿)
- *   3. 普通 assistant(content) / user 不受影响
- *   4. **不改写 JSONL events**, 只在重建 messages 时过滤 — 后续补 tool
- *      result 后完整 tool_call 组自然重新合法化 (Sprint 1c P2 spec)
- *
- * 实现: 延迟 push 模式 — assistant(tool_calls) 进入 buffer, tool events
- * 配对删除 pending. user/assistant 边界触发 buffer 结算: pending 非空
- * → 整体 roll back (不 push); pending 空 → push buffer.
- *
- * Sprint 1c-revive-2-D-5+ reload 修复 (review P1, 2026-06-04):
- *   - JSONL 中的 'compaction' event 必须 **replay** 到 LLM context, 否则
- *     reload 后 messages 会从原始 user/assistant/tool events 重建, 旧
- *     compacted head 重新出现, 上下文不被压缩 (内存压缩成功但 reload
- *     失效 = P1).
- *   - replay 协议: 见到 'compaction' event 时, 把当前累积 messages 的
- *     `replaced_range[0..replaced_range[1])` 段 (按 JSONL 累积 index)
- *     替换为 1 条 system summary.
- *   - index 空间 (拍板 2026-06-04 review): compact() 入参 messages 来自
- *     caller 的 working 列表. REPL 路径下 working = loadSession() 返回
- *     的 JSONL 累积 (纯 user/assistant/tool) + REPL startup 拼的 system
- *     prompt. 拍板 compact() 只对 working[0..end] 操作, 不含外部 system
- *     prompt, 所以 replaced_range 索引的就是 "JSONL 累积 messages" 的
- *     index. reload 时 messages 仍按 JSONL 累积重建, replaced_range 同
- *     index 空间, 不偏移. (多个 'compaction' event 串行: 第 1 次 applied
- *     后累积 messages = 1 summary + N tail, 第 2 次 compact 入参就是
- *     reload 后的累积, index 重新从 0 计 — protocol 自洽.)
- *   - 'compaction_paused' event: 不入 messages. caller 决定是否 reset
- *     latch; UI/footer 可读 paused event 显式提示.
- */
-export declare function sessionEventsToMessages(events: ReadonlyArray<SessionEvent>): ChatMessage[];
-/**
- * 写一个 user event 到 session。
- * Sprint 1a 简化：user 消息也走 SessionWriter（统一审计）。
- */
-export declare function appendUserEvent(writer: SessionWriter, content: string, ts?: number): Promise<void>;
-/**
- * 写一条 'compaction' event 到 session (Sprint 1c-revive-2-D-5-1 拍板).
- *
- * 用途: agent-compaction.ts 在 runCompactionWithLatch 返 kind='ok' 时调,
- * 把 summary 拍板落盘 (供 reload 重建 messages 时知道哪段被总结过).
- *
- * 拍板: SessionReader 读到 kind='compaction' 时**不**重放进 LLM context
- * (跟 sessionEventsToMessages L132 'system' 跳过 一致 — compaction event 是 metadata,
- *  不是 LLM 看到的对话轮次).
- */
-export declare function appendCompactionEvent(writer: SessionWriter, summary: string, replacedRange: readonly [number, number], meta?: Record<string, unknown>, ts?: number): Promise<void>;
-/**
- * 写一条 'compaction_paused' event 到 session (Sprint 1c-revive-2-D-5-2 拍板).
- *
- * 用途: agent-compaction.ts 在 CompactionState latch 触发时调,
- * 记录"自动暂停, 防 death loop" 拍板 (供 reload 时 caller 知道状态).
- *
- * 拍板: SessionReader 读到 kind='compaction_paused' 时**不**重放进 LLM context
- * (caller 该决定是否 reset CompactionState / 改 summaryFn / 改 config).
- */
-export declare function appendCompactionPausedEvent(writer: SessionWriter, consecutiveFailures: number, reason: string, lastError: string, meta?: Record<string, unknown>, ts?: number): Promise<void>;
-/**
- * 把 tool loop 跑完后产出的 steps 全部落盘（assistant + tool）。
- * limit/error 跳过（toSessionEvent 返回 null 时不 append）。
- */
-export declare function persistToolLoopSteps(writer: SessionWriter, steps: ReadonlyArray<ToolLoopStep>): Promise<void>;
-/**
- * 加载已有 session 并重建 messages。
- *
- * Sprint 1b: 内部自动调 reader.truncate() 把 partial last line 清掉。
- * 之前 caller 必须自己记得调, Sprint 1a 全部漏调 → partial line 累积,
- * 下次 append 拼坏 JSON。Sprint 1b 闭环在 adapter 里, 3 个 mode (repl/print/rpc) 自动受益。
- *
- * 行为契约:
- * - 加载完整 events + 重建 messages
- * - 若文件末尾有 partial line(崩溃恢复), 自动 truncate
- * - truncate 失败不抛(不阻塞 agent 启动, 跟 Sprint 1a 容错语义一致)
- *
- * Sprint 1a 简化:返回 (events, messages) 两份数据, caller 决定要不要 ignore events。
- */
-export declare function loadSession(reader: SessionReader): Promise<{
-    events: ReadonlyArray<SessionEvent>;
-    messages: ChatMessage[];
-}>;
-/**
- * 写一个 'verification' event 到 session (Sprint 1c-revive-2-D-11-3, 2026-06-04).
- *
- * 调用场景: `deepwhale --verify` 或 REPL `/verify` 跑完, 把 VerificationReport
- * 摘要写 1 条到 session JSONL. 跟 `appendUserEvent` / `appendCompactionEvent` 模式一致.
- *
- * 字段 (跟 core/src/session/jsonl.ts 'verification' union 一致):
- *   - status: 整体结果 passed / failed
- *   - durationMs: 整体耗时
- *   - command_count: 跑的 step 数
- *   - failed_count: 失败 step 数
- *   - summary: 人类可读 summary (来自 formatter.buildSummaryAndNext)
- *   - meta: 可选扩展 (e.g. log file path, git sha)
- *
- * 不变量 (跟其它 event 写入一致):
- *   - ts 默认 Date.now(), 单测可注入
- *   - 走 SessionWriter.append → fsync 串行化, 顺序保证
- *   - 'verification' 是 metadata, reload session 时 sessionEventsToMessages 跳过
- *     (跟 compaction_paused 同语义), 不污染 LLM 看到的 messages
- */
-export declare function appendVerificationEvent(writer: SessionWriter, args: {
-    status: 'passed' | 'failed';
-    durationMs: number;
-    commandCount: number;
-    failedCount: number;
-    summary: string;
-    meta?: Record<string, unknown>;
-    ts?: number;
-}): Promise<void>;
-/**
- * 写一条 'policy_decision' event (Sprint 1c-revive-3-D-13, 2026-06-05).
- * 拍板 (用户 2026-06-05): 'allow' 不调本函数 (避免 JSONL 刷爆). 只对
- *   'deny' / 'require_confirmation' / 'user_approved' / 'user_denied' 4 个
- *   终态落盘.
- *
- * 字段拍板:
- *   - tool_call_id: 跟后续 'tool' event 配对 (reload 时 audit trace 完整)
- *   - argsDigest: sha256:<12hex>, 不存原始 args
- *   - reason: 已过 sanitize (长度 / 换行 / NUL, 拍板红线: 不存 secret)
- */
-export declare function appendPolicyDecisionEvent(writer: SessionWriter, args: {
-    tool_call_id: string;
-    name: string;
-    decision: 'deny' | 'require_confirmation' | 'user_approved' | 'user_denied';
-    argsDigest: string;
-    reason?: string;
-    meta?: Record<string, unknown>;
-    ts?: number;
-}): Promise<void>;
-//# sourceMappingURL=session-adapter.d.ts.map

package/dist/agent/session-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-adapter.d.ts","sourceRoot":"","sources":["../../src/agent/session-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAmClF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,WAAW,EAAE,CAgH1F;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,EAAE,GAAE,MAAmB,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,EAAE,GAAE,MAAmB,GACtB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,aAAa,EACrB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,EAAE,GAAE,MAAmB,GACtB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAS3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE;IACJ,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACA,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,eAAe,GAAG,aAAa,CAAC;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACA,OAAO,CAAC,IAAI,CAAC,CAWf"}