opencode-subagent-magazine 1.6.1 → 1.7.0

package/src/panel/entry-map.ts

@@ -1,4 +1,4 @@
-import type { SubEntry } from "../core/types"
+import type { SubEntry, SubStatus } from "../core/types"
 
 export type SubEntryPatch = Omit<SubEntry, "startedAt" | "endedAt"> & {
   startedAt?: number
@@ -37,3 +37,79 @@ export function upsertSubEntry(
   })
   return next
 }
+
+/** running < cancel_requested < 终态（done/error/cancelled）。 */
+function statusRank(status: SubStatus): number {
+  if (status === "running") return 0
+  if (status === "cancel_requested") return 1
+  return 2
+}
+
+const isTerminalStatus = (status: SubStatus) => statusRank(status) === 2
+
+function minDefined(a: number | undefined, b: number | undefined): number | undefined {
+  if (a === undefined) return b
+  if (b === undefined) return a
+  return Math.min(a, b)
+}
+
+function maxDefined(a: number | undefined, b: number | undefined): number | undefined {
+  if (a === undefined) return b
+  if (b === undefined) return a
+  return Math.max(a, b)
+}
+
+/**
+ * 合并同一子代理条目的两个视图，绝不回退状态。
+ *
+ * 持久化存储由多个 TUI 实例写入，每个写入者都可能
+ * 持有过期快照。终态始终优先于 running /
+ * cancel_requested，进度计数只增不减，描述性字段
+ * 则回退到仍保有它的一侧。
+ */
+export function mergeSubEntry(base: SubEntry, incoming: SubEntry): SubEntry {
+  const successor = statusRank(incoming.status) > statusRank(base.status) ? incoming : base
+  const status = successor.status
+  const ended = isTerminalStatus(status)
+  return {
+    ...base,
+    ...incoming,
+    id: base.id,
+    status,
+    sessionId: incoming.sessionId ?? base.sessionId,
+    startedAt: minDefined(base.startedAt, incoming.startedAt) ?? base.startedAt,
+    endedAt: ended ? (base.endedAt ?? incoming.endedAt ?? Date.now()) : undefined,
+    tokens: maxDefined(base.tokens, incoming.tokens),
+    cost: maxDefined(base.cost, incoming.cost),
+    model: incoming.model ?? base.model,
+    todoTotal: maxDefined(base.todoTotal, incoming.todoTotal),
+    todoDone: maxDefined(base.todoDone, incoming.todoDone),
+    error: incoming.error ?? base.error,
+    cancelRequestedAt: minDefined(base.cancelRequestedAt, incoming.cancelRequestedAt),
+    abortAccepted: base.abortAccepted || incoming.abortAccepted || undefined,
+    cancelReason: incoming.cancelReason ?? base.cancelReason,
+  }
+}
+
+/**
+ * 合并两个条目集合，去重方式与 `upsertSubEntry` 相同
+ * （先子会话、后条目 id），冲突用 `mergeSubEntry` 合并。
+ * 所有持久化路径都走这里，避免并发实例以整表写入
+ * 互相丢弃对方的条目。
+ */
+export function mergeSubEntries(
+  base: Iterable<SubEntry>,
+  incoming: Iterable<SubEntry>,
+): Map<string, SubEntry> {
+  const out = new Map<string, SubEntry>()
+  for (const entry of base) out.set(entry.id, entry)
+  for (const entry of incoming) {
+    const key = findSubEntryKey(out, entry.id, entry.sessionId)
+    if (!key) {
+      out.set(entry.id, entry)
+      continue
+    }
+    out.set(key, mergeSubEntry(out.get(key)!, entry))
+  }
+  return out
+}

package/src/panel/panel-api.ts

@@ -51,6 +51,14 @@ export interface PanelApi {
     messages(sid: string): unknown[] | undefined
     /** Raw parts of a message (scan). */
     part(messageID: string): unknown[] | undefined
+    /** Optional host-side fallback: map a subagent tool call to its child session
+     *  when live events/history lack the link (V2 reads the local database). */
+    resolveChild?(input: {
+      parentId: string
+      callId?: string
+      agent?: string
+      startedAt?: number
+    }): string | undefined
   }
   event: {
     on(type: PanelEventType, cb: (e: PanelEvent) => void): () => void

package/src/v2/commands.ts

@@ -1,16 +1,24 @@
 import type { Context, KeymapCommand } from "./types"
 import type { PanelApi } from "../panel/panel-api"
-import type { Lang, SharedSignals, SubStatus } from "../core/types"
-import { KV_PREFIX, SETTING_KEYS, loadSessionData, saveSessionData, readTTLDays } from "../core/kv"
+import type { Lang, SharedSignals, SubStatus, TimeFormat } from "../core/types"
+import { TIME_FORMATS, TIME_FORMAT_SAMPLES } from "../core/format"
+import { KV_PREFIX, SETTING_KEYS, updateSessionData, readTTLDays } from "../core/kv"
 import { PLUGIN_VERSION } from "../_version"
 import { LANG_META, createT } from "../i18n"
 import { globalEntryCache, setClearTick } from "../panel/store"
+import { mergeSubEntries } from "../panel/entry-map"
+import { openSettingsMenu } from "./settings-menu"
 
 /** V2 命令（对齐 V1 的 9 个斜杠命令——promise 式对话框）。 */
-export function makeCommands(context: Context, api: PanelApi, signals: SharedSignals): KeymapCommand[] {
+export function makeCommands(
+  context: Context,
+  api: PanelApi,
+  signals: SharedSignals,
+): KeymapCommand[] {
   const t = createT(() => signals.lang())
   const kv = api.kv
   const clampMax = (n: number) => Math.max(1, Math.min(50, n))
+  const onOff = (v: boolean) => (v ? t("settings.on") : t("settings.off"))
 
   const resolveParent = (sid: string): { parentSid: string; isChild: boolean } => {
     try {
@@ -98,6 +106,111 @@ export function makeCommands(context: Context, api: PanelApi, signals: SharedSig
         api.ui.toast(`Max entries: ${n}`)
       },
     },
+    {
+      id: "opencode-subagent-magazine.subagent.config",
+      title: "SubAgent Magazine: Settings",
+      description: "Show current settings (change each via its own command)",
+      slash: { name: "subagent-config" },
+      palette: true,
+      run: () => {
+        const ttl = readTTLDays(kv)
+        const langLabel = LANG_META.find((m) => m.code === signals.lang())?.label ?? signals.lang()
+        const message = [
+          `${t("settings.lang")}: ${langLabel}`,
+          `${t("settings.max")}: ${signals.maxEntries()}`,
+          `${t("settings.order")}: ${signals.sortOrder() === "desc" ? t("order.desc") : t("order.asc")}`,
+          `${t("settings.scroll")}: ${signals.scrollMode() === "wheel" ? t("scroll.wheel") : t("scroll.click")}`,
+          `${t("settings.ttl")}: ${ttl === 0 ? t("ttl.unlimited") : `${ttl}d`}`,
+          `${t("settings.border")}: ${onOff(signals.borderVisible())}`,
+          `${t("settings.showEntryCost")}: ${onOff(signals.showEntryCost())}`,
+          `${t("settings.showEntryTime")}: ${onOff(signals.showEntryTime())}`,
+          `${t("settings.showEntryTokens")}: ${onOff(signals.showEntryTokens())}`,
+          `${t("settings.timeFormat")}: ${TIME_FORMAT_SAMPLES[signals.timeFormat()]}`,
+          `${t("settings.dbSync")}: ${onOff(signals.dbSync())}`,
+        ].join("\n")
+        context.ui.toast.show({ title: t("settings.title"), message })
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.sections",
+      title: "SubAgent Magazine: Settings Menu",
+      description: "Open the interactive settings menu (Esc to close)",
+      slash: { name: "subagent-sections" },
+      palette: true,
+      run: () => {
+        openSettingsMenu(context, api, signals)
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.cost",
+      title: "SubAgent Magazine: Toggle Entry Cost",
+      description: "Show or hide the per-sub-agent cost in the sidebar",
+      slash: { name: "subagent-cost" },
+      palette: true,
+      run: () => {
+        const v = !signals.showEntryCost()
+        signals.setShowEntryCost(v)
+        kv.set(SETTING_KEYS.showEntryCost, v)
+        api.ui.toast(`${t("settings.showEntryCost")}: ${onOff(v)}`)
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.time",
+      title: "SubAgent Magazine: Toggle Entry Time",
+      description: "Show or hide the elapsed time in the sidebar list",
+      slash: { name: "subagent-time" },
+      palette: true,
+      run: () => {
+        const v = !signals.showEntryTime()
+        signals.setShowEntryTime(v)
+        kv.set(SETTING_KEYS.showEntryTime, v)
+        api.ui.toast(`${t("settings.showEntryTime")}: ${onOff(v)}`)
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.time-format",
+      title: "SubAgent Magazine: Time Format",
+      description: "Set how elapsed time is displayed (short / decimal / clock / compact / seconds)",
+      slash: { name: "subagent-time-format" },
+      palette: true,
+      run: async () => {
+        const picked = await context.ui.dialog.select<TimeFormat>({
+          title: t("settings.timeFormat"),
+          options: TIME_FORMATS.map((f) => ({ title: `${f} — ${TIME_FORMAT_SAMPLES[f]}`, value: f })),
+          current: signals.timeFormat(),
+        })
+        if (!picked) return
+        signals.setTimeFormat(picked)
+        kv.set(SETTING_KEYS.timeFormat, picked)
+        api.ui.toast(`${t("settings.timeFormat")}: ${TIME_FORMAT_SAMPLES[picked]}`)
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.tokens",
+      title: "SubAgent Magazine: Toggle Entry Tokens",
+      description: "Show or hide the token count in the sidebar list",
+      slash: { name: "subagent-tokens" },
+      palette: true,
+      run: () => {
+        const v = !signals.showEntryTokens()
+        signals.setShowEntryTokens(v)
+        kv.set(SETTING_KEYS.showEntryTokens, v)
+        api.ui.toast(`${t("settings.showEntryTokens")}: ${onOff(v)}`)
+      },
+    },
+    {
+      id: "opencode-subagent-magazine.subagent.db",
+      title: "SubAgent Magazine: Toggle Local DB",
+      description: "Enrich sub-agent entries from the local OpenCode database (V2)",
+      slash: { name: "subagent-db" },
+      palette: true,
+      run: () => {
+        const v = !signals.dbSync()
+        signals.setDbSync(v)
+        kv.set(SETTING_KEYS.dbSync, v)
+        api.ui.toast(`${t("settings.dbSync")}: ${onOff(v)}`)
+      },
+    },
     {
       id: "opencode-subagent-magazine.subagent.version",
       title: "SubAgent Magazine: Version",
@@ -140,28 +253,49 @@ export function makeCommands(context: Context, api: PanelApi, signals: SharedSig
           }
         }
         if (count > 0) {
+          const ok = () => api.ui.toast(signals.lang() === "zh"
+            ? `已标记 ${count} 个运行中的条目为完成`
+            : `Marked ${count} running entries as done`)
+          const fail = () => {
+            try { api.ui.toast(t("clear.failed")) } catch {}
+          }
           try {
-            const data = loadSessionData(kv)
             const { parentSid, isChild } = resolveParent(sid)
-            if (isChild) {
-              if (!data[parentSid]) data[parentSid] = { ts: Date.now(), entries: [], scroll: 0, expanded: "", children: {} }
-              if (!data[parentSid].children) data[parentSid].children = {}
-              if (!data[parentSid].children[sid]) data[parentSid].children[sid] = { scroll: 0, expanded: "", entries: [] }
-              data[parentSid].children[sid] = { ...data[parentSid].children[sid], entries: [...entries.values()] }
-            } else {
-              data[sid] = {
-                ts: Date.now(),
-                entries: [...entries.values()],
-                scroll: data[sid]?.scroll ?? 0,
-                expanded: data[sid]?.expanded ?? "",
-                children: data[sid]?.children ?? {},
+            const done = updateSessionData(kv, (data) => {
+              // 落定前先把（可能过期的）模块缓存与持久化记录
+              // merge：其他实例可能有本实例从未见过的条目，
+              // 这次写入不能把它们丢掉。
+              if (isChild) {
+                if (!data[parentSid]) data[parentSid] = { ts: Date.now(), entries: [], scroll: 0, expanded: "", children: {} }
+                if (!data[parentSid].children) data[parentSid].children = {}
+                const prev = data[parentSid].children[sid]?.entries ?? []
+                const merged = [...mergeSubEntries(prev, entries.values()).values()].map((e) =>
+                  e.status === "running" || e.status === "cancel_requested"
+                    ? { ...e, status: "done" as SubStatus, endedAt: e.endedAt ?? Date.now() }
+                    : e
+                )
+                data[parentSid].children[sid] = {
+                  ...(data[parentSid].children[sid] ?? { scroll: 0, expanded: "" }),
+                  entries: merged,
+                }
+              } else {
+                const rec = data[parentSid] ?? { ts: Date.now(), entries: [], scroll: 0, expanded: "", children: {} }
+                const merged = [...mergeSubEntries(rec.entries ?? [], entries.values()).values()].map((e) =>
+                  e.status === "running" || e.status === "cancel_requested"
+                    ? { ...e, status: "done" as SubStatus, endedAt: e.endedAt ?? Date.now() }
+                    : e
+                )
+                data[parentSid] = { ...rec, ts: Date.now(), entries: merged, children: rec.children ?? {} }
               }
+            })
+            if (done && typeof (done as Promise<void>).then === "function") {
+              void (done as Promise<void>).then(ok, fail)
+            } else {
+              ok()
             }
-            saveSessionData(kv, data)
-          } catch {}
-          api.ui.toast(signals.lang() === "zh"
-            ? `已标记 ${count} 个运行中的条目为完成`
-            : `Marked ${count} running entries as done`)
+          } catch {
+            fail()
+          }
         } else {
           api.ui.toast(signals.lang() === "zh" ? "没有需要清理的运行中条目" : "No running entries to clear")
         }
@@ -216,32 +350,42 @@ export function makeCommands(context: Context, api: PanelApi, signals: SharedSig
         })
         if (choice !== "yes") return
         try {
-          const data = loadSessionData(kv)
           let count = 0
-          if (parentID) {
-            if (data[parentID]?.children?.[sid]) {
-              const child = data[parentID].children[sid]
-              const ids = child.entries?.map((e) => e.id) ?? []
-              count = ids.length
-              child.entries = []
-              child.scroll = 0
-              child.expanded = ""
-              child.clearedIds = [...new Set([...(child.clearedIds ?? []), ...ids])]
+          const finish = () => {
+            globalEntryCache.delete(sid)
+            setClearTick((v) => v + 1)
+            api.ui.toast(t("clear.done", { n: count }))
+          }
+          const done = updateSessionData(kv, (data) => {
+            if (parentID) {
+              const child = data[parentID]?.children?.[sid]
+              if (child) {
+                const ids = child.entries?.map((e) => e.id) ?? []
+                count = ids.length
+                child.entries = []
+                child.scroll = 0
+                child.expanded = ""
+                child.clearedIds = [...new Set([...(child.clearedIds ?? []), ...ids])]
+              }
+            } else {
+              const rec = data[sid]
+              if (rec) {
+                const ids = rec.entries?.map((e) => e.id) ?? []
+                count = ids.length
+                rec.entries = []
+                rec.scroll = 0
+                rec.expanded = ""
+                rec.clearedIds = [...new Set([...(rec.clearedIds ?? []), ...ids])]
+              }
             }
+          })
+          if (done && typeof (done as Promise<void>).then === "function") {
+            void (done as Promise<void>).then(finish, () => {
+              try { api.ui.toast(t("clear.failed")) } catch {}
+            })
           } else {
-            count = data[sid]?.entries?.length ?? 0
-            if (data[sid]) {
-              const ids = data[sid].entries?.map((e) => e.id) ?? []
-              data[sid].entries = []
-              data[sid].scroll = 0
-              data[sid].expanded = ""
-              data[sid].clearedIds = [...new Set([...(data[sid].clearedIds ?? []), ...ids])]
-            }
+            finish()
           }
-          saveSessionData(kv, data)
-          globalEntryCache.delete(sid)
-          setClearTick((v) => v + 1)
-          api.ui.toast(t("clear.done", { n: count }))
         } catch {}
       },
     },

package/src/v2/db.ts

@@ -0,0 +1,274 @@
+/**
+ * 本地 opencode.db 只读索引（V2）。
+ *
+ * 宿主数据层只为当前 TUI 已加载的会话缓存消息：前台子代理（非 background）
+ * 的 success 事件经常拿不到 metadata.sessionID，条目会一直停在 running，
+ * model/tokens/cost 也无法回填。这些数据在宿主数据库里是完整的：
+ * - 父会话 assistant 消息中，工具 part 的 state.metadata.sessionID 指向子会话（前台/后台都有）；
+ * - session_v2 保存子会话的 agent/model/tokens/cost 与 time_idle/idle_outcome。
+ *
+ * 本模块以只读方式查询该库作为补充数据源；bun:sqlite 不可用、库不存在或
+ * 设置项 dbSync 关闭时静默禁用（回退宿主 API）。库结构属于宿主内部实现，
+ * 任何读取失败都返回 undefined，绝不影响面板其余功能。
+ */
+
+import { homedir } from "node:os"
+
+export interface ChildSessionInfo {
+  id: string
+  parentId?: string
+  agent?: string
+  title?: string
+  model?: string
+  cost?: number
+  tokens?: number
+  timeCreated?: number
+  timeIdle?: number
+  idleOutcome?: string
+}
+
+export interface SessionDbIndex {
+  /** 数据库可用且设置项开启时为 true。 */
+  enabled(): boolean
+  /** call id → 子会话 id（前台/后台通用）。 */
+  resolveCall(parentId: string, callId: string): string | undefined
+  /** 无 call id 时的兜底：按 agent + 起始时间匹配子会话。 */
+  matchChild(parentId: string, agent: string | undefined, startedAt: number | undefined): string | undefined
+  /** 子会话汇总（model/tokens/cost/time_idle）。 */
+  info(sid: string): ChildSessionInfo | undefined
+}
+
+type SqlRow = Record<string, unknown>
+interface SqlStatement {
+  all(...params: unknown[]): SqlRow[]
+  get(...params: unknown[]): SqlRow | undefined
+}
+interface SqlDatabase {
+  query(sql: string): SqlStatement
+  close?(): void
+}
+
+// 动态加载：仅 Bun 运行时可用。字符串变量使 tsc/esbuild 不做静态解析，
+// 打包产物保留运行时 import；Node（CI 测试）加载失败会静默禁用。
+const BUN_SQLITE = "bun:sqlite"
+
+/** 从宿主 model 字段提取模型 id。
+ *  兼容三种形态：名字字符串、{ id } 对象，以及序列化后的 JSON 字符串
+ *  （session_v2.model 列存的就是 `{"id":...}` 文本）。 */
+export function modelIdOf(value: unknown): string | undefined {
+  if (typeof value === "string") {
+    const s = value.trim()
+    if (s.length === 0) return undefined
+    if (s.startsWith("{")) {
+      try { return modelIdOf(JSON.parse(s)) } catch { return undefined }
+    }
+    return s
+  }
+  if (value && typeof value === "object") {
+    const id = (value as { id?: unknown }).id
+    if (id === undefined) return undefined
+    const direct = modelIdOf(id)
+    if (direct !== undefined) return direct
+    const s = String(id)
+    return s.length > 0 ? s : undefined
+  }
+  return undefined
+}
+
+/** 宿主 readSessionTokens 同语义：最后一条 assistant 消息的上下文规模。 */
+export function contextTokens(tokens: unknown): number | undefined {
+  if (!tokens || typeof tokens !== "object") return undefined
+  const t = tokens as Record<string, unknown>
+  const cache = (t.cache && typeof t.cache === "object") ? (t.cache as Record<string, unknown>) : {}
+  const sum =
+    (Number(t.input) || 0) +
+    (Number(t.output) || 0) +
+    (Number(t.reasoning) || 0) +
+    (Number(cache.read) || 0) +
+    (Number(cache.write) || 0)
+  return sum > 0 ? sum : undefined
+}
+
+/** 子会话终态：time_idle 存在才算结束；interrupted 视为取消。
+ *  没有 time_idle 时不作判断（交给宿主实时状态）——避免时间阈值猜测。 */
+export function statusOfChild(info: ChildSessionInfo | undefined): "done" | "cancelled" | undefined {
+  if (!info || info.timeIdle == null) return undefined
+  return info.idleOutcome === "interrupted" ? "cancelled" : "done"
+}
+
+/** 定位宿主数据库（可用 OPENCODE_DB 覆盖，遵循 XDG_DATA_HOME）。 */
+export function findDbPath(
+  env: Record<string, string | undefined> = process.env,
+  home = safeHomedir(),
+): string | undefined {
+  if (env.OPENCODE_DB) return env.OPENCODE_DB
+  const base = env.XDG_DATA_HOME && env.XDG_DATA_HOME.length > 0 ? env.XDG_DATA_HOME : `${home}/.local/share`
+  if (!base || base === "/.local/share") return undefined
+  return `${base}/opencode/opencode.db`
+}
+
+function safeHomedir(): string {
+  try { return homedir() } catch { return "" }
+}
+
+const CALL_MAP_SQL = `
+  SELECT json_extract(p.value, '$.id') AS call_id,
+         json_extract(p.value, '$.state.metadata.sessionID') AS child_sid
+  FROM session_message m, json_each(m.data, '$.content') p
+  WHERE m.session_id = ? AND m.type = 'assistant'
+    AND json_extract(p.value, '$.id') LIKE 'call_%'
+    AND json_extract(p.value, '$.state.metadata.sessionID') IS NOT NULL`
+
+const CHILD_INFO_SQL = `
+  SELECT parent_id, agent, title, model, cost,
+         tokens_input, tokens_output, tokens_reasoning, tokens_cache_read, tokens_cache_write,
+         time_created, time_idle, idle_outcome
+  FROM session_v2 WHERE id = ?`
+
+const LAST_ASSISTANT_SQL = `
+  SELECT json_extract(data, '$.tokens.input') AS input,
+         json_extract(data, '$.tokens.output') AS output,
+         json_extract(data, '$.tokens.reasoning') AS reasoning,
+         json_extract(data, '$.tokens.cache.read') AS cache_read,
+         json_extract(data, '$.tokens.cache.write') AS cache_write,
+         json_extract(data, '$.model.id') AS model_id
+  FROM session_message
+  WHERE session_id = ? AND type = 'assistant' AND json_extract(data, '$.tokens.output') > 0
+  ORDER BY seq DESC LIMIT 1`
+
+const ASSISTANT_COST_SQL = `
+  SELECT COUNT(*) AS n, SUM(COALESCE(json_extract(data, '$.cost'), 0)) AS total
+  FROM session_message WHERE session_id = ? AND type = 'assistant'`
+
+const CHILDREN_SQL = `
+  SELECT id, agent, time_created FROM session_v2 WHERE parent_id = ? ORDER BY time_created`
+
+const num = (v: unknown): number | undefined => {
+  const n = Number(v)
+  return Number.isFinite(n) ? n : undefined
+}
+const str = (v: unknown): string | undefined => (typeof v === "string" && v.length > 0 ? v : undefined)
+
+export function createSessionDbIndex(enabled: () => boolean): SessionDbIndex | undefined {
+  const dbPath = findDbPath()
+  if (!dbPath) return undefined
+
+  let db: SqlDatabase | undefined
+  let failed = false
+  void (async () => {
+    try {
+      const mod = (await import(BUN_SQLITE)) as { Database?: new (p: string, o?: Record<string, unknown>) => SqlDatabase }
+      const Database = mod?.Database
+      if (!Database) { failed = true; return }
+      db = new Database(dbPath, { readonly: true })
+      try { db.query("pragma query_only = on").all() } catch {}
+    } catch {
+      failed = true
+      db = undefined
+    }
+  })()
+
+  const CALL_MAP_TTL_MS = 15000
+  const CALL_MAP_RETRY_MS = 2000
+  const INFO_TTL_MS = 5000
+  const callMaps = new Map<string, { map: Map<string, string>; at: number }>()
+  const infos = new Map<string, { info: ChildSessionInfo | undefined; at: number }>()
+  const childrenCache = new Map<string, { list: SqlRow[]; at: number }>()
+
+  const ready = (): boolean => {
+    if (failed || db === undefined) return false
+    try { return enabled() } catch { return false }
+  }
+
+  const buildCallMap = (parentId: string): Map<string, string> => {
+    const now = Date.now()
+    const prev = callMaps.get(parentId)
+    if (prev && now - prev.at < CALL_MAP_RETRY_MS) return prev.map
+    const map = new Map<string, string>()
+    try {
+      for (const row of db!.query(CALL_MAP_SQL).all(parentId)) {
+        const id = str(row.call_id)
+        const sid = str(row.child_sid)
+        if (id && sid) map.set(id, sid)
+      }
+    } catch {}
+    callMaps.set(parentId, { map, at: now })
+    return map
+  }
+
+  const resolveCall = (parentId: string, callId: string): string | undefined => {
+    if (!ready() || !parentId || !callId) return undefined
+    const prev = callMaps.get(parentId)
+    const map = prev && Date.now() - prev.at < CALL_MAP_TTL_MS ? prev.map : buildCallMap(parentId)
+    return map.get(callId) ?? buildCallMap(parentId).get(callId)
+  }
+
+  const matchChild = (parentId: string, agent: string | undefined, startedAt: number | undefined): string | undefined => {
+    if (!ready() || !parentId || startedAt === undefined) return undefined
+    const now = Date.now()
+    let cached = childrenCache.get(parentId)
+    if (!cached || now - cached.at > CALL_MAP_TTL_MS) {
+      let list: SqlRow[] = []
+      try { list = db!.query(CHILDREN_SQL).all(parentId) } catch {}
+      cached = { list, at: now }
+      childrenCache.set(parentId, cached)
+    }
+    let best: string | undefined
+    let bestAt = Number.POSITIVE_INFINITY
+    for (const row of cached.list) {
+      const sid = str(row.id)
+      const t = num(row.time_created)
+      if (!sid || t === undefined) continue
+      if (t < startedAt - 2000) continue
+      if (agent !== undefined && str(row.agent) !== agent) continue
+      if (t < bestAt) { bestAt = t; best = sid }
+    }
+    return best
+  }
+
+  const info = (sid: string): ChildSessionInfo | undefined => {
+    if (!sid) return undefined
+    const hit = infos.get(sid)
+    if (hit && Date.now() - hit.at < INFO_TTL_MS) return hit.info
+    if (!ready()) return undefined
+    let result: ChildSessionInfo | undefined
+    try {
+      const row = db!.query(CHILD_INFO_SQL).get(sid)
+      if (row) {
+        const last = db!.query(LAST_ASSISTANT_SQL).get(sid)
+        let tokens = contextTokens(last ? {
+          input: last.input, output: last.output, reasoning: last.reasoning,
+          cache: { read: last.cache_read, write: last.cache_write },
+        } : undefined)
+        if (tokens === undefined) {
+          const agg = (num(row.tokens_input) || 0) + (num(row.tokens_output) || 0) + (num(row.tokens_reasoning) || 0) +
+            (num(row.tokens_cache_read) || 0) + (num(row.tokens_cache_write) || 0)
+          if (agg > 0) tokens = agg
+        }
+        // cost 语义对齐宿主 readSessionCost：优先会话聚合值，
+        // 0 时回退 assistant 消息求和（有消息即权威，0 表示确实免费）。
+        let cost = num(row.cost)
+        if (!(typeof cost === "number" && cost > 0)) {
+          const aggCost = db!.query(ASSISTANT_COST_SQL).get(sid)
+          if (aggCost && Number(aggCost.n) > 0) cost = Number(aggCost.total) || 0
+        }
+        result = {
+          id: sid,
+          parentId: str(row.parent_id),
+          agent: str(row.agent),
+          title: str(row.title),
+          model: modelIdOf(last?.model_id) ?? modelIdOf(row.model),
+          cost,
+          tokens,
+          timeCreated: num(row.time_created),
+          timeIdle: num(row.time_idle),
+          idleOutcome: str(row.idle_outcome),
+        }
+      }
+    } catch { result = undefined }
+    infos.set(sid, { info: result, at: Date.now() })
+    return result
+  }
+
+  return { enabled: ready, resolveCall, matchChild, info }
+}