@thincoder/core 0.9.5 → 0.10.2

package/tools/write-path.mjs

@@ -6,7 +6,7 @@
  * 写入又与用户随后的保存互相竞写（split-brain 数据丢失）。核内原先写盘直调
  * `node:fs/promises`、散在 5 个档的 8 个写点上 ⇒ **没有可注入的一跳** ⇒ 端侧接核后会
  * 丢掉编辑器径。本模块就是那一跳：核内**工具面的 8 个编辑写点**全改调 `writeThroughPath`
- * （模型面直写 `agent-tools/batch-segment.mjs` = 设计登记的 S2 前置门——不在本缝覆盖面；
+ * （模型面直写 `agent-tools/batch.mjs` = 设计登记的 S2 前置门——不在本缝覆盖面；
  * 口径与 `CORE-UNIFICATION.md` §2.13.5 落地收正同源）。
  *
  * 默认径 = CLI 语义（**零行为变**）：`writeFile` + 记账。端侧

package/traces/trace-store.mjs

@@ -1,5 +1,5 @@
 /**
- * trace-store.mjs — §18.6 完整轨迹存档（AGENT-LOOP.md §18.6 D-TR1..TR8 权威规格）。
+ * trace-store.mjs — 完整轨迹存档（TRACES.md §6 机制 + §7 决策表 D-TR1–4 / D-TR6 / D-TR10–13 权威规格）。
  *
  * 完整请求-响应轨迹落盘：每次 chat() 调用一个 JSONL 文件到
  * ~/.thincoder/traces/YYYY-MM-DD/<sessionKey>-<seq>.jsonl。采集点唯一 = core.mjs
@@ -11,9 +11,8 @@
  *   写盘异步（node:fs/promises——不 await）；落盘失败静默降级（不抛错、不阻塞
  *   chat() 返回）。recordChatTrace 返回落盘 promise——仅供测试/显式消费方 await。
  * - 测试隔离：node --test 进程（NODE_TEST_CONTEXT）默认不写盘——防测试事件污染真实
- *   轨迹目录（既有测试跑真实 agent 管线会产生数百次 chat 调用）；显式设置
- *   THINCODER_TRACES_DIR 强制写入该目录（traces.test.mjs 用它隔离临时目录——
- *   与 log.mjs 的 THINCODER_LOG_DIR 同惯例）。
+ *   轨迹目录（既有测试跑真实 agent 管线会产生数百次 chat 调用）；显式测试缝
+ *   （`_setTracesRootForTest`）强制写入该目录（与 log.mjs 同惯例——CONFIG.md §6.2）。
  * - 脱敏（D-TR2）：复用 log.mjs 字段名黑名单（apikey/designtoken/password/secret/
  *   token/authorization/proxyuri/proxy）+ SECRET_FORM 形态扫描（redactSecret）——对
  *   messages/content/reasoning/toolCalls/error 全字段应用；不发明新遮蔽模式。
@@ -24,7 +23,7 @@
  *   与写盘同在 fire-and-forget 异步体内）。2026-09-21（TRACES.md §6.4）：判据改**目录级三段梯**
  *   + 每写 prune **节流**；清理实现外提 `trace-cleanup.mjs`（本档包装保既有 import 面）。
  * - seq = 当日目录内最大已有 seq + 1（D-TR3——跨会话/进程重启不覆写既有旧轨迹——
- *   18.6.1 评审 #3）；**进程内 seqCache（§23.3.2——消除逐调用同步扫目录）**：首次
+ *   18.6.1 评审 #3）；**进程内 seqCache（TRACES.md §6.2——消除逐调用同步扫目录）**：首次
  *   readdirSync 后进程内递增预留，目录被清理（retention）后取下界重扫一次（防御）。
  *   多进程语义（修正轮 #10——登记）：同 cwd 多实例各自进程内缓存——seq 可撞、同
  *   sessionKey 记录并入同名文件（append 不覆写）；**可容忍**（本机 traces = 诊断面、
@@ -44,16 +43,20 @@ import { configDir, loadConfig } from "../config.mjs"
 import { redactSecret, errText, classifyErr } from "../log.mjs"
 import { normalizeCwd } from "../session-slots.mjs"
 
-/** 轨迹根目录：THINCODER_TRACES_DIR（测试隔离/override——同 THINCODER_LOG_DIR
- *  惯例）> ~/.thincoder/traces（configDir——D-TR3——与 sessions/ 同域）。 */
+/** Test seam: override the traces root (process-internal seam — CONFIG.md §6.2 ③ 通道). */
+let _tracesRoot = null
+export function _setTracesRootForTest(p) { _tracesRoot = p }
+export function _resetTracesRootForTest() { _tracesRoot = null }
+
+/** 轨迹根目录：显式测试缝 > ~/.thincoder/traces（configDir——D-TR3——与 sessions/ 同域）。 */
 export function tracesRoot() {
-  return process.env.THINCODER_TRACES_DIR ?? join(configDir, "traces")
+  return _tracesRoot ?? join(configDir, "traces")
 }
 
 /** 写门（测试隔离）：test runner 进程（NODE_TEST_CONTEXT）默认跳过——除显式
- *  THINCODER_TRACES_DIR override（traces.test.mjs 隔离临时目录）。 */
+ *  测试缝 override（轨迹测试隔离临时目录）。 */
 function writeEnabled() {
-  if (process.env.NODE_TEST_CONTEXT && !process.env.THINCODER_TRACES_DIR) return false
+  if (process.env.NODE_TEST_CONTEXT && _tracesRoot === null) return false
   return true
 }
 
@@ -93,7 +96,7 @@ export function tracesDirFor(dateStr) {
 // 完整落盘：不截断、不丢行（无单消息/单记录额度，无在途丢弃）；清理 = 每写一次 prune
 // （写盘成功后顺带清理——与写盘同在 fire-and-forget 异步体内，永不阻塞 chat）。
 
-// 进程内 seq 缓存（§23.3.2：dir → 已预留 max；首次读盘后递增预留，目录被清理后取下界重扫一次）。
+// 进程内 seq 缓存（TRACES.md §6.2：dir → 已预留 max；首次读盘后递增预留，目录被清理后取下界重扫一次）。
 const _seqCache = new Map()
 // 每写 prune 节流（D-TR12 · §6.4）：窗 = 10 分钟 + 在飞合并（同窗 3 连写 ⇒ 扫描 ≤1 次）。
 export const PRUNE_THROTTLE_MS = 10 * 60_000
@@ -132,7 +135,7 @@ function scanMaxSeq(dir) {
 
 /** seq = max(当日目录最大已有 seq, 进程内已预留) + 1（D-TR3——跨会话/进程重启
  *  不覆写——T-TR8/T-TR10；同步预留 = 异步写盘启动前的原子号位分配）。
- *  §23.3.2：seqCache 进程内递增——不逐调用 readdirSync（目录被清理/缺失 → 重扫一次）。 */
+ *   TRACES.md §6.2：seqCache 进程内递增——不逐调用 readdirSync（目录被清理/缺失 → 重扫一次）。 */
 export function nextTraceSeq(dateStr) {
   const dir = tracesDirFor(dateStr)
   let max = _seqCache.get(dir)
@@ -152,7 +155,7 @@ export function tracesEnabled(logCtx) {
   return logCtx?.traces !== false
 }
 
-// ─── 单遍序列化（§23.3.2 D-TR1——脱敏内联、零复制图、字段名/次序同构）────────
+// ─── 单遍序列化（TRACES.md §6.2 D-TR1——脱敏内联、零复制图、字段名/次序同构）────────
 
 const OMIT = Symbol("omit") // JSON.stringify 语义：对象属性省略（数组元素 → null）
 
@@ -292,7 +295,7 @@ export function recordChatTrace(provider, opts = {}, result = null, error = null
 }
 
 /** D-TR10 清理面（D-TR11 目录级三段梯）——实现外提 `traces/trace-cleanup.mjs`；此处包装保
- *  既有 import 面与缺省 `dir`（`tracesRoot()` 单源——测试经 `THINCODER_TRACES_DIR` 隔离）。
+ *  既有 import 面与缺省 `dir`（`tracesRoot()` 单源——测试经 `_setTracesRootForTest` 隔离）。
  *  调用点 = 每写 prune（经 `maybePruneTraces`）+ 启动清理（壳侧）；返回删除文件数。 */
 export function cleanupTraces({ dir = tracesRoot(), retentionHours = 24 } = {}) {
   return cleanupTracesImpl({ dir, retentionHours })

package/vision-reader.mjs

@@ -0,0 +1,76 @@
+/**
+ * vision-reader.mjs — 非多模态降级读图跑者（上提核件 —— parity-b4 W0 · 2026-09-29）。
+ *
+ * 上提源 = VSC `thincoder-vscode/src/extension/vision-channel.mjs:14`（`findVisionChannel` 逐字）
+ * + `image-handler.mjs:70-95`（`runVisionReader` 逐字）；VSC 自持跑者 ∕ 渠道副本已随迁移轮（parity-b4）删。
+ * 消费面 = VSC `image-handler.mjs`（已改指本档）· 桌面 `src/main/attachments.mjs`
+ * （降级适配器缺省 = 本档 —— `visionReader` 缝的核默认实现）。
+ *
+ * `findVisionChannel`（纯函数）：渠道表 ⇒ 视觉读图渠道 —— 「优先同名（当前主）渠道的视觉默认模型，
+ * else 全渠道首个视觉默认模型者」；判据 = `specForModel(p.model).multimodal`
+ * （与 `read_image` 注册门 ∕ `isNonVisionModel` 同源）。
+ *
+ * `runVisionReader`：一次性 depth-1 只读 explore 子代理读图返回文本描述。
+ *  渠道 = 视觉渠道（`resolveProviders()` 现读）；provider = 核 `resolveChildProvider`（`<渠道>:<模型>`）；
+ *  工具 = 按**该渠道模型**装配的只读族（`read_image` 随 multimodal 注册 —— 主模型非视觉时其工具表
+ *  本无该件，故按子代理模型重装，不沿用主代理工具表）；`config ∕ memory` = 主代理同源。
+ *  失败径全 `null`（原样兜底，不静默丢）：无渠道 ∕ 渠道未知 ∕ 渠道无 key（spawn 期失败回落）∕
+ *  spawn 失败 ∕ 超时 ∕ 空返；外部 `signal` 已停 ⇒ 快速失败，否则桥接内部控制器。
+ *
+ *  W8 契约②（2026-09-29 断链）：`agent.mjs` ∕ `agent-tools/subagent-async.mjs` 静态链达 `node:sqlite`
+ *  （`agent.mjs` → `agent/setup.mjs` → `memory.mjs` → `memory/schema.mjs`）⇒ 两端一律**函数体内动态 import**
+ *  （约定源 = `ledger.mjs:16`；实例 = `tools/index.mjs:63`）；本档静态边只留闭包净件（`config-io.mjs` ∕
+ *  `model-specs.mjs` ∕ `tools/index.mjs`）。
+ */
+import { resolveProviders } from "./config-io.mjs"
+import { specForModel } from "./model-specs.mjs"
+import { assembleBuiltinTools } from "./tools/index.mjs"
+
+/** 读图墙钟上限（VSC `image-handler.mjs:70` 同值——一次性子代理的成功径上限）。 */
+export const VISION_READ_TIMEOUT_MS = 60_000
+
+/** 找可跑视觉读图的渠道：`{ provider, model }` ∥ `null`——优先同名（当前主）渠道的视觉默认模型，
+ *  else 全渠道首个视觉默认模型者（"优先同名渠道视觉模型 → 首视觉渠道"）。 */
+export function findVisionChannel(providers, currentName = "") {
+  const first = []
+  for (const p of providers ?? []) {
+    const model = typeof p?.model === "string" && p.model && specForModel(p.model).multimodal ? p.model : ""
+    if (!model) continue
+    if (p.name === currentName) return { provider: p.name, model }
+    first.push({ provider: p.name, model })
+  }
+  return first[0] ?? null
+}
+
+/** 降级读图跑者（缝契约 = `visionReader({ paths, signal }) ⇒ { ok: true, description }` ∥ `null`
+ *  ——见 `attachments.mjs` `downgradeNonVisionImages`）。 */
+export async function runVisionReader({ paths, providerName, cwd, parentAgent, signal }) {
+  // 取消缝（VSC A12 同款）：已停 ⇒ 快速失败（不复用 60s 超时路径）；否则桥接内部 controller。
+  if (signal?.aborted) return null
+  let providers = []
+  try { providers = resolveProviders().providers } catch { return null }
+  const vc = findVisionChannel(providers, providerName)
+  if (!vc) return null
+  let provider = null
+  try {
+    const { resolveChildProvider } = await import("./agent-tools/subagent-async.mjs") // 动态 import（该链静态达 node:sqlite——W8 契约②）
+    provider = resolveChildProvider(parentAgent, `${vc.provider}:${vc.model}`)
+  } catch { return null }
+  const ac = new AbortController()
+  const timer = setTimeout(() => ac.abort(), VISION_READ_TIMEOUT_MS)
+  const onAbort = () => ac.abort()
+  if (signal) signal.addEventListener("abort", onAbort, { once: true })
+  try {
+    const { createAgent, runAgent, readonlyToolNames, excludeSubagentTools } = await import("./agent.mjs") // 动态 import（agent 链静态达 node:sqlite——W8 契约②）
+    const builtins = await assembleBuiltinTools({ memory: parentAgent?.memory, cwd, model: vc.model })
+    const allowed = readonlyToolNames(builtins)
+    const tools = excludeSubagentTools(builtins.filter((t) => allowed.has(t.name)))
+    const child = createAgent({ provider, tools, config: parentAgent?.config, cwd, memory: parentAgent?.memory, role: "explore" })
+    const task = paths.map((f) => `用 read_image 读 ${f} 返回图像内容描述`).join("\n")
+    const desc = await runAgent(child, task, {}, { depth: 1, maxTurns: 10, signal: ac.signal })
+    return typeof desc === "string" && desc.trim() ? { ok: true, description: desc.trim() } : null
+  } catch { return null } finally {
+    clearTimeout(timer)
+    if (signal) signal.removeEventListener("abort", onAbort)
+  }
+}

package/agent-tools/batch-segment.mjs

@@ -1,18 +0,0 @@
-/**
- * agent-tools/batch-segment.mjs — **过渡 shim**（batch 工具单名化收口，BATCH-RECORD §4.14）：
- * 本档仅 re-export `batch.mjs` 主档导出面（旧 import 面 = VSC `setup-tooltable.mjs` 经此 import
- * `configureBatchSegment` / 旧测试消费——导出全超集，行为零变）。权威实现 = batch.mjs
- * （batchTool 四 action + append 迁移面 + 过渡别名 batchSegmentTool）；撤除判据 = §4.14
- * （消费面清零后删本档——先例债：删档需同步 tooltable 装配 import，随批登记）。
- */
-export {
-  MAX_TEXT_CHARS,
-  SEGMENT_BY_ROLE,
-  batchDocBases,
-  batchDocForReview,
-  batchSegmentTool,
-  batchTool,
-  configureBatchSegment,
-  resetBatchSegment,
-  resolveBatchDocPath,
-} from "./batch.mjs"