@whyshu/argent-engine 0.7.1 → 0.7.3

package/engine/scripts/session-handoff.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+// `session-handoff` —— 给老会话产出"续接摘要"（S4 收尾配套）
+// 目的：老格式会话日志一旦退役/升级后打不开，"工作能续上"由**摘要**承担。
+// 真实形状（2026-10-16 实测）：header `{type:"session",version,id,createdAt,cwd,agentPreset}`；
+// 事件 `{type,seq,time,data}`；用户输入在 `agent/inbox/spliced → data.inserted[].content[].text`。
+// 用法：--scan ｜ --write [--format v3|v4|all] [--limit N]
+// ⛔ 只读日志、只写摘要目录；多帧 zstd 按 magic 切帧逐帧解压。
+import { readFileSync, readdirSync, statSync, mkdirSync, writeFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { zstdDecompressSync } from 'node:zlib'
+
+const args = process.argv.slice(2)
+const has = (f) => args.includes(f)
+const val = (f, d) => { const i = args.indexOf(f); return i >= 0 && args[i + 1] ? args[i + 1] : d }
+const HOME = process.env.HOME || homedir()
+const ROOT = join(HOME, '.dsh', 'sessions')
+const OUT = join(HOME, '.dsh', 'argent', 'session-handoffs')
+const FORMAT = val('--format', 'v3'); const LIMIT = Number(val('--limit', '0')) || 0; const WRITE = has('--write')
+const DAYS = Number(val('--days', '10')) || 0        // 只处理最近 N 天内动过的主会话（0 = 全部）
+const CHILDREN = has('--include-children')          // 默认**排除**子会话（delegationDepth>0）
+const MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd])
+
+function readText(file) {
+  const buf = readFileSync(file); const pos = []; let i = 0
+  while ((i = buf.indexOf(MAGIC, i)) !== -1) { pos.push(i); i += 4 }
+  if (!pos.length) return ''
+  pos.push(buf.length); let out = ''
+  for (let k = 0; k < pos.length - 1; k++) { try { out += zstdDecompressSync(buf.subarray(pos[k], pos[k + 1])).toString('utf8') } catch { /* 坏帧跳过 */ } }
+  return out
+}
+/** 递归找所有文本块（形状容错：content[]/inserted[]/text） */
+function texts(node, acc = []) {
+  if (!node) return acc
+  if (typeof node === 'string') { if (node.trim()) acc.push(node.trim()); return acc }
+  if (Array.isArray(node)) { for (const x of node) texts(x, acc); return acc }
+  if (typeof node === 'object') {
+    if (typeof node.text === 'string' && node.text.trim()) acc.push(node.text.trim())
+    for (const k of ['content', 'inserted', 'message', 'parts', 'blocks', 'data']) if (node[k] !== undefined) texts(node[k], acc)
+  }
+  return acc
+}
+const clean = (s, n) => String(s || '').replace(/\s+/g, ' ').trim().slice(0, n)
+const isUser = (e) => /inbox|user/.test(String(e.type)) || (e.data && e.data.source && e.data.source.kind === 'user')
+
+function summarize(file, id, project, ver) {
+  const lines = readText(file).split('\n').filter(Boolean)
+  let header = null, ts0 = null, ts1 = null, events = 0
+  const users = [], assistants = [], all = []
+  for (const l of lines) {
+    let e; try { e = JSON.parse(l) } catch { continue }
+    if (e.type === 'session') { header = e; continue }
+    events++
+    const t = e.time || (e.data && e.data.time)
+    if (t) { const iso = new Date(t).toISOString(); ts0 = ts0 || iso; ts1 = iso }
+    const blocks = texts(e.data ?? e)
+    if (!blocks.length) continue
+    const joined = clean(blocks.join(' ｜ '), 600)
+    all.push(joined)
+    if (isUser(e)) users.push(joined); else assistants.push(joined)
+  }
+  const todos = all.join('\n').split(/｜|\n/).map((s) => s.trim()).filter((l) => /(^\s*-\s*\[ \])|TODO|待办|下一步|下一步是/.test(l)).slice(0, 10)
+  return { id, project, ver, file, bytes: statSync(file).size, created: header && header.createdAt ? new Date(header.createdAt).toISOString() : null,
+    ts0, ts1, events, turns: users.length + assistants.length, preset: (header && header.agentPreset) || '', cwd: (header && header.cwd) || '', depth: (header && header.delegationDepth) || 0,
+    title: clean(users[0], 140), lastUser: clean(users[users.length - 1], 400), lastAsst: clean(assistants[assistants.length - 1], 400), todos }
+}
+
+function walk(dir, out = []) {
+  let es = []; try { es = readdirSync(dir, { withFileTypes: true }) } catch { return out }
+  for (const e of es) {
+    const p = join(dir, e.name)
+    if (e.isDirectory()) walk(p, out)
+    else {
+      const m = e.name.match(/^session\.(v\d+)\.jsonl\.zstd$/)
+      if (m && (FORMAT === 'all' || m[1] === FORMAT)) out.push({ file: p, ver: m[1], id: (p.match(/session-([0-9a-f-]{8,})/) || [])[1] || p.split('/').slice(-2)[0].replace(/^session[.-]?/, '') || e.name, project: p.replace(ROOT + '/', '').split('/')[0] })
+    }
+  }
+  return out
+}
+
+const CUT = DAYS ? Date.now() - DAYS * 86400000 : 0
+const walkAll = walk(ROOT)
+const recent = DAYS ? walkAll.filter((x) => statSync(x.file).mtimeMs >= CUT) : walkAll
+const all = recent.sort((a, b) => statSync(b.file).mtimeMs - statSync(a.file).mtimeMs)
+const list = LIMIT ? all.slice(0, LIMIT) : all
+const rows = []; let bad = 0
+for (const it of list) { try { rows.push(summarize(it.file, it.id, it.project, it.ver)) } catch { bad++ } }
+const kept = CHILDREN ? rows : rows.filter((r) => !r.depth)
+for (const r of rows) if (!kept.includes(r)) { /* 子会话：跳过（--include-children 可纳入） */ }
+const titled = kept.filter((r) => r.title).length
+console.log(JSON.stringify({ ok: true, days: DAYS, candidates: all.length, childrenExcluded: CHILDREN ? 0 : rows.length - kept.length, kept: kept.length, format: FORMAT, unreadable: bad, withTitle: titled, write: WRITE }))
+if (!WRITE) { console.log(JSON.stringify(kept.slice(0, 3).map((r) => ({ id: r.id.slice(0, 8), ver: r.ver, preset: r.preset, events: r.events, turns: r.turns, title: r.title.slice(0, 70) })), null, 1)); process.exit(0) }
+mkdirSync(OUT, { recursive: true })
+const slug = (s) => s.replace(/[^\w.-]/g, '_')
+for (const r of kept) {
+  writeFileSync(join(OUT, `${slug(r.project)}__${r.id}.${r.ver}.md`), [
+    `# 会话续接摘要｜${r.id}（${r.ver}）`, '',
+    `- 项目：\`${r.project}\`　cwd：\`${r.cwd}\`　preset：\`${r.preset}\``,
+    `- 日志：\`${r.file}\`（${(r.bytes / 1024).toFixed(0)}KB，${r.events} 事件 / ${r.turns} 轮）`,
+    `- 时间：${(r.created || r.ts0 || '?').slice(0, 16).replace('T', ' ')} → ${(r.ts1 || '?').slice(0, 16).replace('T', ' ')}`, '',
+    '## 首轮需求（标题）', '', r.title || '（未提取到）', '',
+    '## 最后一轮用户输入', '', r.lastUser || '（未提取到）', '',
+    '## 最后一条助手输出', '', r.lastAsst || '（未提取到）', '',
+    '## 疑似待办 / 下一步（原文行）', '', ...(r.todos.length ? r.todos.map((t) => `- ${clean(t, 200)}`) : ['（未提取到）']), '',
+    '> ⚠️ 自动提取（best effort）：日志退役后，续接以本摘要 + 仓库文档/提交为准。', ''].join('\n'))
+}
+writeFileSync(join(OUT, 'INDEX.md'), ['# 老会话续接摘要索引', '', `- 生成：${new Date().toISOString().slice(0, 16).replace('T', ' ')}`,
+  `- 范围：format=${FORMAT} ｜ 近 ${DAYS} 天 ｜ 本次 ${kept.length} 条（候选 ${all.length} 条）｜ 有标题 ${titled} 条`, '',
+  '| 会话 | 版本 | preset | 时间 | 标题 | 摘要 |', '|---|---|---|---|---|---|',
+  ...rows.map((r) => `| \`${r.id.slice(0, 8)}\` | ${r.ver} | ${r.preset} | ${(r.created || r.ts0 || '?').slice(0, 10)} | ${(r.title || '').replace(/\|/g, '/').slice(0, 56)} | [md](${slug(r.project)}__${r.id}.${r.ver}.md) |`), ''].join('\n'))
+console.log(`✅ 已写 ${kept.length} 份摘要（有标题 ${titled}）+ INDEX.md ⇒ ${OUT}`)

package/engine/skills/ml-fulfillment-sop/references/pitfalls.md

@@ -75,3 +75,33 @@
 - **口径变化（有意）**：新文案含「需运营…」⇒ 分类从 `needs_agent`（唤醒角色去猜）
   变为 `needs_human`（落卡等人、运营改商品）。⛔ 这是本事故要的结果，不是副作用。
 
+## 卡票先问 hub 真相；⛔ 别单步硬跑（2026-10-16 现场 79301358）
+
+**症状**：lip 表里一张票 `FULL状态=失败`（如「步骤7 上传箱唛失败」），但门户侧其实**早就全做完了**
+（运营手工做完 / 页面早已下载完标签），反复重跑仍旧失败。
+
+**根因（两条，都要记住）**：
+1. **单步模式会绕过前置判定**：`orchestrator.py --mode step --step 7 …` 直接进步骤，**跳过了**
+   `step1_prepare` 里那句「**先问 hub 真相，再下结论**」——那句会按 hub-v2 三项
+   （预约已取消 ∧ 产品标签已下载 ∧ 箱唛已下载）判定「**运营手动完成**」并结票。
+   ⇒ 用单步"复现失败"会把一张**其实已完成**的票重新打成失败。
+2. **「Declara al menos」不一定是残留**：旧逻辑把点击 `Generar etiquetas` 之前就存在的该提示
+   一律当"残留文案"⇒ 干等 30s 后以"平台侧异常"收口（**冤枉平台**，运营也拿不到可执行信息）。
+   KB-136 起改为：先读 checkbox 勾选进度 + **Andes 勾选态**（`#2/#3`），声明确实没做完时
+   重勾重试、仍不行则以 `[declaration_incomplete] 已声明 N/M` 精确收口。
+   ⚠️ 注意 `checkbox_total` **包含我们故意跳过的 `#1`（bultos）**，所以"勾选数 < 总数"本身
+   **不是**声明未完成的证据（正常态就是 2/4）。
+
+**正确处置顺序（⛔ 不要一上来就 `--mode step`）**：
+```bash
+# ① 先问 hub 真相（只读探针；必须带 --store-name，否则会解析成别的店）
+python3 scripts/orchestrator.py --mode hub-status --record-id <rec> --shipment-id <货件号> \
+        --store-name "<店铺名>"
+# ② 若 operationally_complete=true ⇒ 认定「运营手动完成」并**置位**（2026-10-16 起同时写 FULL状态=已完成）
+python3 scripts/orchestrator.py --mode hub-status --hub-write-note \
+        --record-id <rec> --shipment-id <货件号> --store-name "<店铺名>"
+# ③ 门户/数据侧确实没做完 ⇒ 才进单步或定点续跑（有失败收口时，步骤7 现在会先自己问一次 hub）
+```
+
+**卡住不动的票**（触发器不再认领）：`flow_stale.py --flow <流程> [--requeue]` 回收；
+**流程跑得动但不接票**：`flow_trigger.sh --flow <流程>` 手动一轮（与定时器同一路径）。

package/engine/version.mjs

@@ -1 +1 @@
-export const VERSION = "0.7.1"
+export const VERSION = "0.7.3"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whyshu/argent-engine",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Argent 引擎（L1）：流程/台账/重试/守卫/审计/浏览器自动化 —— 逐字节来自 argent-dsh 仓库",
   "type": "module",
   "engines": {

package/engine/scripts/patches/dsh-llm-deepseek--transport-diagnostics.patch

@@ -1,297 +0,0 @@
-# requires-dsh: >=0.1.7   （TRANSPORT 可诊断性；判定语义不变，只加可观测字段）
-#
-# 目标：@deepseek-ai/dsh-llm-deepseek/lib/index.js（官方 Messages 适配器；**问述代理复用同一份**，
-#       见 plugins/argent-core/src/llm-whyshu.js —— 它只把 provider 注册成 `whyshu`）。
-#
-# 为什么（2026-10-02）：`generate()` 的 catch 把"非空闲超时、非用户中断"的**一切**错误折叠成
-#   `DeepSeek Messages transport failed` / TRANSPORT，`failure` 只剩 message+code
-#   ⇒ 落到会话日志的 `llm/retry` 事件也只有这两项（实测 session-878f3e3b：6 次连败，事后完全
-#   分不清 ECONNRESET / 提前关闭 / 5xx 断流），且无法回答"这次到底产出了没有"。
-#
-# 本补丁做三件事（**都不改 TIMEOUT/ABORTED/TRANSPORT 三分支判定**）：
-#   ① 捕获 provider 侧请求标识（request-id / x-request-id / x-deepseek-request-id）与 HTTP 状态，
-#      并作为 `requestId` 塞进 LlmError.failure ⇒ 随 `llm/retry` 事件**落进会话日志**；
-#   ② 统计已产出内容（chunks / text / reasoning / toolArgs / blockStarts / settled / anyOutput）；
-#   ③ 打两行 warn：`[argent-transport] ...` 单行摘要（可 grep）+ 结构化 `TRANSPORT detail %o`。
-#
-# 回滚：git checkout 该文件（或用 patch -R）。重启不必要（模块在下次进程启动时加载）。
---- /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-llm-deepseek/lib/index.js.orig
-+++ /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-llm-deepseek/lib/index.js
-@@ -2061,6 +2061,191 @@
- 	var e = new Error(message);
- 	return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
- });
-+/**
-+ * Argent hotfix (2026-10-02) — TRANSPORT 可诊断性（**只加可观测字段，不改判定语义**）。
-+ *
-+ * 事故：`generate()` 的 catch 把"非空闲超时、非用户中断"的**一切**错误折叠成
-+ * `DeepSeek Messages transport failed` / TRANSPORT，`failure` 里只剩 message+code
-+ * ⇒ 落到会话日志的 `llm/retry` 事件也只有这两项，事后完全分不清是
-+ * 连接被对端重置（ECONNRESET）、提前关闭（socket hang up）、读超时（ETIMEDOUT）、
-+ * 还是 5xx 断流；也无法回答"这次到底产出了没有"（决定能不能安全重试）。
-+ * 下面这些纯函数只负责收集与格式化，**不参与** TIMEOUT/ABORTED/TRANSPORT 的分支判定。
-+ */
-+let argentTransportCallSeq = 0;
-+/** 建一次请求的诊断累加器（每回合一个）。 */
-+function argentTransportDiagnostics(options, connection) {
-+	return {
-+		provider: options.provider,
-+		model: options.model,
-+		sessionId: options.sessionId === void 0 ? void 0 : String(options.sessionId),
-+		purpose: options.purpose,
-+		callId: `${Date.now().toString(36)}-${++argentTransportCallSeq}`,
-+		startedAt: Date.now(),
-+		signalAbortedAtStart: options.signal?.aborted === true,
-+		idleTimeoutMs: connection.streamIdleTimeoutMs,
-+		requestId: void 0,
-+		httpStatus: void 0,
-+		responseAt: void 0,
-+		bodySnippet: void 0,
-+		produced: {
-+			chunks: 0,
-+			blockStarts: 0,
-+			blocksEnded: 0,
-+			textChars: 0,
-+			reasoningChars: 0,
-+			toolCallChars: 0,
-+			toolCallNames: [],
-+			settled: false
-+		},
-+		lastChunkAt: void 0
-+	};
-+}
-+/** 记一条已产出的流分片 —— "有没有输出" = `chunks>0` 且任一类计数非零。 */
-+function argentRecordProducedChunk(diagnostics, chunk) {
-+	if (diagnostics === void 0 || chunk === null || typeof chunk !== "object") return;
-+	const produced = diagnostics.produced;
-+	produced.chunks += 1;
-+	diagnostics.lastChunkAt = Date.now();
-+	if (chunk.type === "text-delta") produced.textChars += typeof chunk.text === "string" ? chunk.text.length : 0;
-+	else if (chunk.type === "reasoning-delta") produced.reasoningChars += typeof chunk.text === "string" ? chunk.text.length : 0;
-+	else if (chunk.type === "tool-call-delta") {
-+		produced.toolCallChars += typeof chunk.argumentsDelta === "string" ? chunk.argumentsDelta.length : 0;
-+		if (typeof chunk.name === "string" && chunk.name.length > 0 && !produced.toolCallNames.includes(chunk.name)) produced.toolCallNames.push(chunk.name);
-+	} else if (chunk.type === "block-start") produced.blockStarts += 1;
-+	else if (chunk.type === "block-end") produced.blocksEnded += 1;
-+	else if (chunk.type === "finish" || chunk.type === "usage") produced.settled = true;
-+}
-+/** `produced` 的摘要字段（写进日志，也用于"是否可安全重试"的判断依据）。 */
-+function argentProducedSummary(diagnostics) {
-+	const produced = diagnostics?.produced;
-+	if (produced === void 0) return { chunks: 0, textChars: 0, reasoningChars: 0, toolCallChars: 0, blockStarts: 0, blocksEnded: 0, toolCallNames: [], settled: false, anyOutput: false };
-+	return {
-+		chunks: produced.chunks,
-+		textChars: produced.textChars,
-+		reasoningChars: produced.reasoningChars,
-+		toolCallChars: produced.toolCallChars,
-+		blockStarts: produced.blockStarts,
-+		blocksEnded: produced.blocksEnded,
-+		toolCallNames: [...produced.toolCallNames],
-+		settled: produced.settled,
-+		anyOutput: produced.textChars + produced.reasoningChars + produced.toolCallChars + produced.blockStarts > 0
-+	};
-+}
-+/** 从响应头取 provider 侧请求标识（与 `providerError()` 同一组头、同一优先级）。 */
-+function argentRequestIdOf(headers) {
-+	if (headers === void 0 || headers === null || typeof headers.get !== "function") return void 0;
-+	const id = headers.get("request-id") ?? headers.get("x-request-id") ?? headers.get("x-deepseek-request-id");
-+	return id === null || id === void 0 || id.length === 0 ? void 0 : ProviderRequestId(id);
-+}
-+/** 响应一到就记下状态码与请求标识（**即便后面流断掉**，这些也已经拿到了）。 */
-+function argentNoteResponse(diagnostics, response) {
-+	if (diagnostics === void 0) return;
-+	diagnostics.responseAt = Date.now();
-+	diagnostics.httpStatus = response.status;
-+	const id = argentRequestIdOf(response.headers);
-+	if (id !== void 0) diagnostics.requestId = id;
-+}
-+/** 记非 2xx 的响应体片段（判 5xx 断流 vs 网关错误页用；截断，避免日志被 HTML 淹没）。 */
-+function argentNoteHttpFailure(diagnostics, response, text) {
-+	if (diagnostics === void 0) return;
-+	diagnostics.httpStatus = response.status;
-+	const id = argentRequestIdOf(response.headers);
-+	if (id !== void 0) diagnostics.requestId = id;
-+	diagnostics.bodySnippet = typeof text === "string" ? text.slice(0, 400) : void 0;
-+}
-+/**
-+ * 把任意 error 折成**可读的 cause 形态**。覆盖：
-+ *   · `ECONNRESET` / `socket hang up` / `ETIMEDOUT` / `UND_ERR_*` —— Node fetch(undici) 的
-+ *     连接层错误，**通常在 `error.cause` 上**（undici 会包一层 `TypeError: fetch failed` 或
-+ *     `TypeError: terminated`）；
-+ *   · 非 2xx 状态码 + 响应体片段 —— provider 侧网关/上游错误；
-+ *   · `AbortError` —— 区分"空闲 watchdog 触发"（已归 TIMEOUT）与"其它中断"。
-+ * @param error - catch 到的原始错误。
-+ * @param depth - 递归深度（只跟 cause 链，最多 4 层）。
-+ * @returns 平铺的 cause 事实（可直接 JSON 化）。
-+ */
-+function argentDescribeTransportCause(error, depth = 0) {
-+	const out = {
-+		depth,
-+		name: void 0,
-+		message: void 0,
-+		code: void 0,
-+		errno: void 0,
-+		syscall: void 0,
-+		abort: false,
-+		kind: "unknown"
-+	};
-+	if (error === null || error === void 0 || typeof error !== "object") {
-+		out.message = String(error);
-+		return out;
-+	}
-+	out.name = typeof error.name === "string" ? error.name : void 0;
-+	out.message = typeof error.message === "string" ? error.message : String(error);
-+	out.code = typeof error.code === "string" ? error.code : void 0;
-+	out.errno = error.errno === void 0 ? void 0 : String(error.errno);
-+	out.syscall = typeof error.syscall === "string" ? error.syscall : void 0;
-+	out.abort = out.name === "AbortError" || out.code === "ABORT_ERR";
-+	const text = `${out.name ?? ""} ${out.code ?? ""} ${out.message ?? ""}`;
-+	if (out.abort) out.kind = "AbortError";
-+	else if (out.code === "ECONNRESET" || /socket hang up|ECONNRESET/i.test(text)) out.kind = "ECONNRESET";
-+	else if (out.code === "ETIMEDOUT" || /ETIMEDOUT|timed? ?out/i.test(text)) out.kind = "ETIMEDOUT";
-+	else if (out.code === "ECONNREFUSED" || /ECONNREFUSED/i.test(text)) out.kind = "ECONNREFUSED";
-+	else if (out.code === "EPIPE") out.kind = "EPIPE";
-+	else if (out.code === "UND_ERR_SOCKET" || out.code === "ERR_STREAM_PREMATURE_CLOSE") out.kind = "EARLY_CLOSE";
-+	else if (out.code === "UND_ERR_ABORTED") out.kind = "AbortError";
-+	else if (out.code === "UND_ERR_CONNECT_TIMEOUT" || out.code === "UND_ERR_HEADERS_TIMEOUT" || out.code === "UND_ERR_BODY_TIMEOUT") out.kind = "ETIMEDOUT";
-+	else if (typeof out.code === "string" && out.code.startsWith("UND_ERR")) out.kind = out.code;
-+	else if (/terminated|premature close|other side closed/i.test(text)) out.kind = "EARLY_CLOSE";
-+	else if (/fetch failed/i.test(text)) out.kind = "FETCH_FAILED";
-+	return out;
-+}
-+/** 汇总本回合的全部诊断事实（一次调用产出日志行 + 结构化字段）。 */
-+function argentTransportReport(diagnostics, error, connection) {
-+	const now = Date.now();
-+	const cause = argentDescribeTransportCause(error?.cause ?? error);
-+	const produced = argentProducedSummary(diagnostics);
-+	const requestId = diagnostics?.requestId ?? (typeof error?.failure?.requestId === "string" ? error.failure.requestId : void 0);
-+	const status = diagnostics?.httpStatus;
-+	return {
-+		provider: diagnostics?.provider,
-+		model: diagnostics?.model,
-+		sessionId: diagnostics?.sessionId,
-+		purpose: diagnostics?.purpose,
-+		callId: diagnostics?.callId,
-+		requestId,
-+		httpStatus: status,
-+		produced,
-+		elapsedMs: diagnostics === void 0 ? void 0 : now - diagnostics.startedAt,
-+		msSinceLastChunk: diagnostics?.lastChunkAt === void 0 ? void 0 : now - diagnostics.lastChunkAt,
-+		idleTimeoutMs: connection.streamIdleTimeoutMs,
-+		cause,
-+		causeChain: (() => {
-+			const chain = [];
-+			let node = error;
-+			for (let i = 0; i < 4 && node !== null && node !== void 0 && typeof node === "object"; i += 1) {
-+				chain.push(argentDescribeTransportCause(node, i));
-+				node = node.cause;
-+			}
-+			return chain;
-+		})(),
-+		bodySnippet: diagnostics?.bodySnippet,
-+		aborted: false
-+	};
-+}
-+/** 单行、可 grep 的日志文本（`[argent-transport]` 前缀固定，便于 tail/grep 定位）。 */
-+function argentTransportLogLine(report) {
-+	const p = report.produced;
-+	return `[argent-transport] route=${report.provider ?? "?"}/${report.model ?? "?"}`
-+		+ ` callId=${report.callId ?? "?"} providerRequestId=${report.requestId ?? "(none)"}`
-+		+ ` httpStatus=${report.httpStatus ?? "(no response)"} cause=${report.cause.kind}`
-+		+ ` causeName=${report.cause.name ?? "?"} causeCode=${report.cause.code ?? "?"} causeErrno=${report.cause.errno ?? "?"}`
-+		+ ` causeMessage=${JSON.stringify(String(report.cause.message ?? "").slice(0, 200))}`
-+		+ ` produced={chunks:${p.chunks},text:${p.textChars},reasoning:${p.reasoningChars},toolArgs:${p.toolCallChars},blockStarts:${p.blockStarts},settled:${p.settled},anyOutput:${p.anyOutput}}`
-+		+ ` toolCalls=${JSON.stringify(report.produced.toolCallNames ?? [])}`
-+		+ ` elapsedMs=${report.elapsedMs ?? "?"} msSinceLastChunk=${report.msSinceLastChunk ?? "?"}`
-+		+ ` idleTimeoutMs=${report.idleTimeoutMs ?? "?"} sessionId=${report.sessionId ?? "(none)"}`
-+		+ (report.bodySnippet === void 0 ? "" : ` bodySnippet=${JSON.stringify(report.bodySnippet.slice(0, 200))}`);
-+}
- /** DeepSeek provider using Messages content and native thinking replay. */
- var DeepSeekAdapter = class extends LlmAdapter {
- 	dependencies;
-@@ -2111,20 +2296,32 @@
- 		try {
- 			const consumer = new AbortController();
- 			const watchdog = __addDisposableResource(env_1, idleWatchdog(options.signal === void 0 ? consumer.signal : AbortSignal.any([consumer.signal, options.signal]), connection.streamIdleTimeoutMs, "MESSAGES_IDLE"), false);
-+			/* Argent hotfix (2026-10-02)：TRANSPORT 诊断累加器（只观测，不参与判定）。 */
-+			const transportDiagnostics = argentTransportDiagnostics(options, connection);
- 			const iterator = this.request(options, connection, watchdog.signal, () => {
- 				watchdog.pulse();
--			});
-+			}, transportDiagnostics);
- 			try {
- 				while (true) {
- 					const next = await watchdog.next(iterator);
- 					if (next.done) return;
-+					argentRecordProducedChunk(transportDiagnostics, next.value);
- 					yield next.value;
- 				}
- 			} catch (error) {
- 				if (timeoutOf(watchdog.signal, "MESSAGES_IDLE") !== void 0) throw new LlmError("DeepSeek Messages stream idle timeout", "TIMEOUT", { cause: error });
- 				if (options.signal?.aborted) throw new LlmError("DeepSeek Messages request aborted", "ABORTED", { cause: error });
- 				if (error instanceof LlmError) throw error;
--				throw new LlmError("DeepSeek Messages transport failed", "TRANSPORT", { cause: error });
-+				/* Argent hotfix (2026-10-02)：**判定不变**（仍是 TRANSPORT），只补可观测字段：
-+				 *   ① 通过 onTransportFailure 打一行可 grep 的 cause/streamId/已产出长度；
-+				 *   ② 把 provider 侧请求标识塞进 LlmError.failure ⇒ 随 llm/retry 事件**落进会话日志**
-+				 *      （此前 failure 只有 message+code，事后无法复盘）。 */
-+				const transportReport = argentTransportReport(transportDiagnostics, error, connection);
-+				this.dependencies.onTransportFailure?.(transportReport);
-+				throw new LlmError("DeepSeek Messages transport failed", "TRANSPORT", {
-+					cause: error,
-+					...transportReport.requestId === void 0 ? {} : { requestId: transportReport.requestId }
-+				});
- 			} finally {
- 				consumer.abort();
- 				try {
-@@ -2138,7 +2335,7 @@
- 			__disposeResources(env_1);
- 		}
- 	}
--	async *request(options, connection, signal, activity) {
-+	async *request(options, connection, signal, activity, transportDiagnostics) {
- 		signal.throwIfAborted();
- 		const { messages, versions } = await prepareImages(options.messages, connection, options.model, this.dependencies.resolveAttachments?.(), this.imageAccess, signal);
- 		const auth = await this.dependencies.resolveAuth(connection);
-@@ -2197,8 +2394,12 @@
- 						...options.purpose === "compaction" ? { "x-deepseek-harness-compact": "1" } : {}
- 					}
- 				});
-+				/* Argent hotfix (2026-10-02)：响应一到就记下状态码 + provider 请求标识
-+				 * ——**即便随后流被对端切断**，这两个也已拿到，是事后定位的唯一线索。 */
-+				argentNoteResponse(transportDiagnostics, response);
- 				if (!response.ok) {
- 					const text = await response.text();
-+					argentNoteHttpFailure(transportDiagnostics, response, text);
- 					let raw;
- 					try {
- 						raw = JSON.parse(text);
-@@ -2252,6 +2453,27 @@
- 		onExtensionsOmitted: ({ provider, model, fields, error }) => {
- 			ctx.logger.warn(`llm-deepseek: sending route "${provider}/${model}" without request extension fields ${fields.join(", ")} because they failed to serialize: %o`, error);
- 		},
-+		/* Argent hotfix (2026-10-02)：TRANSPORT 的可诊断性。
-+		 * 一次失败打两行：① 单行、可 grep 的摘要（cause/streamId/已产出长度）；
-+		 * ② 结构化对象（`%o`）供 `dsh` 日志详情/后续工具解析。判定语义不变。 */
-+		onTransportFailure: (report) => {
-+			ctx.logger.warn(argentTransportLogLine(report));
-+			ctx.logger.warn("llm-deepseek: TRANSPORT detail %o", {
-+				route: `${report.provider ?? "?"}/${report.model ?? "?"}`,
-+				callId: report.callId,
-+				providerRequestId: report.requestId,
-+				httpStatus: report.httpStatus,
-+				produced: report.produced,
-+				elapsedMs: report.elapsedMs,
-+				msSinceLastChunk: report.msSinceLastChunk,
-+				idleTimeoutMs: report.idleTimeoutMs,
-+				cause: report.cause,
-+				causeChain: report.causeChain,
-+				bodySnippet: report.bodySnippet,
-+				sessionId: report.sessionId,
-+				purpose: report.purpose
-+			});
-+		},
- 		resolveAttachments: () => ctx.get("attachments"),
- 		resolveImageAccess: (attachments, ref) => resolveImageAttachmentAccess(attachments, (hostPath) => ctx.get("fs")?.processPathFromHostPath(hostPath), ref),
- 		prepareExtensions: (request) => ctx.get("deepseekLlmApiExtensions")?.prepare(request) ?? Promise.resolve({
-

package/engine/scripts/patches/dsh-session-format-v0-to-v1--permission-preset-origin.patch

@@ -1,11 +0,0 @@
---- /tmp/dsh-fix-test/index.js.orig	2026-09-10 16:21:27
-+++ /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-session-format-v0-to-v1/lib/index.js	2026-09-10 16:21:27
-@@ -116,7 +116,7 @@
- 		"retry"
- 	]),
- 	"model/selection": disposition(["provider", "model"], ["reasoningEffort"]),
--	"permission/preset": disposition(["preset"]),
-+	"permission/preset": disposition(["preset"], ["origin"]),
- 	"plan/mode": disposition(["active"]),
- 	"request/context": disposition(["provider", "model"], ["contextWindow"]),
- 	"request/header": disposition(["header", "reason"], ["startsSeries"]),

package/engine/scripts/patches/dsh-session-format-v3-to-v4--turn-outside-replace.patch

@@ -1,20 +0,0 @@
-# requires-dsh: >=0.1.7   （v3→v4 迁移器 0.1.7 新增；修复"turn 外替换型 tool/result"过严拒绝）
---- /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-session-format-v3-to-v4/lib/index.js.orig
-+++ /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-session-format-v3-to-v4/lib/index.js
-@@ -617,7 +617,15 @@
- 	}
- 	tool(event, data) {
- 		if (event.type === "tool/result" && event["surfaceOp"] !== "append") {
--			this.requireTurn(event.type);
-+			/* Hardening (2026-09-29, argent-dsh hotfix for 0.1.7): v3 允许"turn 结束后的替换型
-+			   tool/result"（编辑/重放场景：重写早先 turn 的工具结果，如 surface 自替换）。
-+			   原 requireTurn 过严 → 整个 session 迁移失败（'tool/result is outside an
-+			   open turn'，实测 06732069/34c3e088 等）。现在：turn 外时校验 data.turn 指向
-+			   已关闭的历史 turn（防真损坏，放行合法历史）。 */
-+			if (this.turn === null) {
-+				const t = data["turn"];
-+				if (!Number.isSafeInteger(t) || t >= this.nextTurn) throw new SessionFormatError(`${event.type} is outside an open turn`);
-+			}
- 			return;
- 		}
- 		this.requireStep(event, data);

package/engine/scripts/patches/dsh-session-persistence-jsonl--worker-bundled-migrators.patch

@@ -1,39 +0,0 @@
-# requires-dsh: >=0.1.7   （迁移校验 worker 的**打包副本**——模块版 hotfix 打不到它，必须单独打）
-#
-# 背景（2026-09-29 事故，实例 session-06732069「Argent项目」）：
-#   v3→v4 迁移由 @deepseek-ai/dsh-session-persistence-jsonl 起 worker 线程做最终校验
-#   （lib/worker.cjs，539KB 打包件，内联了一整份 v0→v1 与 v3→v4 的迁移器/校验器）。
-#   此前所有 hotfix 只打在 lib/index.js 这些**模块**上 ⇒
-#     · 离线校验器（verify-session-migration.mjs）import 模块 → 一直假绿；
-#     · 真实 resume 走 worker 的**旧副本** → 抛
-#       SessionPersistenceCorruptionError: stored log is corrupt:
-#       Error: tool/result is outside an open turn
-#     ⇒ 前端发送消息弹白 toast、会话打不开。
-#   本补丁把两处 hotfix 同步进 worker 打包副本：
-#     ① v3→v4 `tool()`：turn 结束后的**替换型** tool/result 在 v3 里合法（编辑/重放），
-#        原 requireTurn 过严 → 整个迁移失败；
-#     ② v0 `permission/preset`：容忍旧数据里的 `origin` 字段（= 2026-09-10 hotfix 的镜像，
-#        此前同样只打在模块上）。
---- /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-session-persistence-jsonl/lib/worker.cjs.orig
-+++ /opt/homebrew/lib/node_modules/@deepseek-ai/dsh-session-persistence-jsonl/lib/worker.cjs
-@@ -6749,4 +6749,4 @@
- 	]),
- 	"model/selection": disposition(["provider", "model"], ["reasoningEffort"]),
--	"permission/preset": disposition(["preset"]),
-+	"permission/preset": disposition(["preset"], ["origin"]),
- 	"plan/mode": disposition(["active"]),
-@@ -11331,7 +11331,13 @@
- 	}
- 	tool(event, data) {
- 		if (event.type === "tool/result" && event["surfaceOp"] !== "append") {
--			this.requireTurn(event.type);
-+			/* Hardening (2026-09-29, argent-dsh hotfix, mirrored into the bundled worker):
-+			   v3 allows a REPLACEMENT tool/result after its turn closed (edit/replay); the strict
-+			   requireTurn killed the entire migration. Same rule as the module patch. */
-+			if (this.turn === null) {
-+				const t = data["turn"];
-+				if (!Number.isSafeInteger(t) || t >= this.nextTurn) throw new SessionFormatError(`${event.type} is outside an open turn`);
-+			}
- 			return;
- 		}
- 		this.requireStep(event, data);

package/engine/scripts/patches/verify-bundled-migrators.mjs

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-/**
- * verify-bundled-migrators.mjs — 校验**打包副本**里的迁移器/校验器也带上了 hotfix。
- *
- * 由来（2026-09-29 事故，实例 session-06732069「Argent项目」）：
- *   `@deepseek-ai/dsh-session-persistence-jsonl` 在做 v3→v4 迁移时，会另起一个
- *   **worker 线程**对迁移产物做最终校验，而那个 worker 是**打包件**
- *   （`lib/worker.cjs`，~540KB，内联了一整份 v0→v1 与 v3→v4 的迁移器/校验器）。
- *   `scripts/patches/*.patch` 历来只打在 `lib/index.js` 这些**模块**上 ⇒
- *     · `verify-session-migration.mjs`（import 模块）**一直假绿**；
- *     · 真实 resume 走 worker 的旧副本 → `SessionPersistenceCorruptionError:
- *       stored log is corrupt: Error: tool/result is outside an open turn`
- *     ⇒ 前端发消息弹 toast、会话打不开。
- *
- * 判据（文本级，诚实说明边界）：worker 是打包件、无导出，无法直接做行为断言；
- * 这里用**紧贴语义的代码形状**断言两处 hotfix 是否在打包副本里：
- *   A. v3→v4 `tool()`：turn 外的替换型 tool/result 必须走"校验 data.turn 指向已关闭
- *      历史 turn"的放宽分支，**不得**再是裸 `this.requireTurn(event.type);`。
- *   B. v0 `permission/preset`：必须容忍旧数据里的 `origin` 键。
- * 任一不满足 → exit 1，提示先跑 `node scripts/dsh-upgrade.mjs --patches-only`。
- *
- * 用法：node scripts/patches/verify-bundled-migrators.mjs
- * 退出码：0 通过（或本机无该打包件，跳过）/ 1 失守
- */
-import { readFileSync, existsSync } from 'node:fs'
-import { requireDshScope } from '../lib/dsh-scope.mjs'
-
-// 0.6.0 F1 修复批（2026-10-14）：探不到 scope ⇒ 响亮失败（⛔ 不用假路径 ⇒ 否则本脚本会
-// "本机无该打包件，跳过"地**假绿** —— 而它正是防"worker 打包副本漏打 hotfix"的那道门禁）。
-let SCOPE
-try { SCOPE = requireDshScope({ what: '打包副本校验（verify-bundled-migrators）' }) }
-catch (e) { console.error(`  ❌ ${e.message}`); process.exit(1) }
-const WORKER = `${SCOPE}/dsh-session-persistence-jsonl/lib/worker.cjs`
-
-let pass = 0, fail = 0
-const ok = (c, n) => { c ? (pass++, console.log(`  ✅ ${n}`)) : (fail++, console.log(`  ❌ ${n}`)) }
-
-console.log('【打包副本】dsh-session-persistence-jsonl/lib/worker.cjs 的迁移器 hotfix')
-
-if (!existsSync(WORKER)) {
-  console.log(`  ⏭  本机没有该打包件（${WORKER}）——跳过（上游可能改了实现）`)
-  process.exit(0)
-}
-
-const src = readFileSync(WORKER, 'utf8')
-
-// ── A. v3→v4 tool()：放宽 turn 外的替换型 tool/result ──────────────────────────
-const toolAt = src.indexOf('\ttool(event, data) {')
-if (toolAt === -1) {
-  ok(false, 'worker 里能找到 v3→v4 的 tool() 方法（上游结构可能已变，本门禁需同步）')
-} else {
-  // 取该方法开头到 `this.requireStep(` 之间的片段（即 surfaceOp !== "append" 分支）
-  const stepAt = src.indexOf('this.requireStep(event, data);', toolAt)
-  const branch = stepAt === -1 ? src.slice(toolAt, toolAt + 1200) : src.slice(toolAt, stepAt)
-  ok(/Hardening \(2026-09-29, argent-dsh hotfix, mirrored into the bundled worker\)/.test(branch),
-    'A1 打补丁标记存在（mirrored into the bundled worker）')
-  ok(!/^\s*this\.requireTurn\(event\.type\);\s*$/m.test(branch),
-    'A2 已不再是裸 requireTurn（否则 turn 外替换型 tool/result 会否掉整个迁移）')
-  ok(/const t = data\["turn"\];/.test(branch) && /t >= this\.nextTurn/.test(branch),
-    'A3 放宽分支在校验 data.turn 指向已关闭的历史 turn（不是无条件放行）')
-}
-
-// ── B. v0 permission/preset：容忍 origin ────────────────────────────────────
-ok(/"permission\/preset": disposition\(\["preset"\], \["origin"\]\)/.test(src),
-  'B1 v0 的 permission/preset 容忍旧数据的 origin 键（2026-09-10 hotfix 的镜像）')
-ok(!/"permission\/preset": disposition\(\["preset"\]\),/.test(src),
-  'B2 旧的严格 disposition 已不存在')
-
-// ── C. 共享的 requireTurn 仍应保持严格（放宽只针对替换型 tool/result）─────────
-ok(/requireTurn\(type\) \{\s*\n\s*if \(this\.turn === null\) throw new SessionFormatError\(`\$\{type\} is outside an open turn`\);/.test(src),
-  'C1 requireTurn 本身仍是严格的（放宽没有波及别的下游事件类型）')
-
-console.log(`\n── 合计：通过 ${pass} / 失败 ${fail}`)
-if (fail > 0) {
-  console.log('❌ 打包副本未同步 hotfix —— 真实 resume 会否掉会话（前端发送消息报 toast）')
-  console.log('   修法：node scripts/dsh-upgrade.mjs --patches-only   （必须重启前跑）')
-  process.exit(1)
-}
-console.log('✅ 打包副本的迁移器 hotfix 已同步（模块 + worker 两侧一致）')