dsh-token-total 1.1.3 → 1.1.4

package/README.md

@@ -15,6 +15,7 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 ### 统计看板
 
 入口在左侧边栏的插件区（与原生「插件」页并列的独立页面），点开即为看板，分上中下三部分。
+![统计看板](assets/image.png)
 
 #### 上部
 
@@ -40,6 +41,8 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 
 会话输入框下方原生的「用时与速度 / Token 用量」两枚胶囊被接管并增强：
 
+![单会话统计](assets/image-1.png)
+
 - **Token 胶囊**显示的是**整棵会话树**（主智能体 + 全部子智能体）的合计，点开弹窗分为「主智能体 / 子智能体 / 会话合计」三行，并给出子智能体会话数。
 - 子智能体是独立持久化的会话，通过日志头的 `parentSession` 串成树；插件按需重放这些日志汇总（同一套 `(turn, step)` 去重规则，且跳过 fork 继承来的事件前缀，避免与父会话重复计数）。
 - **会话 Token 明细始终开启**：未命中缓存、缓存读 / 写、输出分别列出；底部胶囊的缓存命中率始终显示两位小数。
@@ -49,6 +52,7 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 ### 会话「用量」页
 
 在每个会话原生的「对话 / 轨迹」旁新增 **用量** tab；沿用会话切换与视图导航，不另造顶部栏或输入框。
+![会话用量页](assets/image-2.png)
 
 - **两张实时卡**（形制参考 [magpie](https://github.com/yetone/magpie)）并排位于子代理／模型明细之下、请求记录之上，回答「提示词里现在有什么」与「整场会话到底花了什么」两个不同的问题：
   - 左卡「**当前上下文**」：`已用 / 模型窗口 tokens` 大字附占用百分比，标题行右侧是当前供应商 · 模型；下方一条**整条即模型窗口**的堆叠条——有颜色的部分是已用的七类（按类别占比分色），尾部是还没用上的余量，所以条本身就是占用率；再下面按统一图例列出系统提示词、用户消息、技能注入、工具结果、工具定义、注入内容、助手消息各自的占比与估算 token（输出不占窗口，故不列）。鼠标悬浮可读精确 token 数与占上下文比例；模型窗口未知时只写已用数。

package/lib/client.js

@@ -31531,7 +31531,8 @@ window.__ModuleLoader__.load({
 				self,
 				subagents: tree?.subagents ?? { ...ZERO },
 				total: tree === null ? self : combinedTotals(tree, self),
-				subagentSessions: tree?.subagentSessions ?? 0
+				subagentSessions: tree?.subagentSessions ?? 0,
+				...tree?.coverage ? { coverage: tree.coverage } : {}
 			};
 		}
 		function hasAnyTokens(totals) {
@@ -31901,9 +31902,11 @@ window.__ModuleLoader__.load({
 		}
 		function UsagePill({ usage, tree, t, dialog, dock }) {
 			const { open, setOpen, rootRef, panelRef, pos } = useStatDialog(dialog);
-			const billed = sessionUsageForDisplay(usage, tree?.tree ?? null).total;
+			const display = sessionUsageForDisplay(usage, tree?.tree ?? null);
+			const billed = display.total;
 			const total = billedTotal(billed);
-			const totalText = t("message.turnUsage.count", { count: formatTokensCompact(total) });
+			const incomplete = display.coverage?.complete === false;
+			const totalText = (incomplete ? "≥ " : "") + t("message.turnUsage.count", { count: formatTokensCompact(total) });
 			const cacheHit = cacheHitPercent(billed);
 			const cacheHitText = cacheHit !== null ? t("stats.cacheHit", { percent: cacheHit }) : null;
 			const exactCount = (value) => t("message.turnUsage.count", { count: formatTokens(value) });
@@ -31916,7 +31919,8 @@ window.__ModuleLoader__.load({
 					className: StatsLineEnhanced_module_default.pill,
 					"aria-haspopup": "dialog",
 					"aria-expanded": open,
-					"aria-label": cacheHitText === null ? totalText : totalText + " · " + cacheHitText,
+					"aria-label": (incomplete ? t("stats.partial") + " · " : "") + (cacheHitText === null ? totalText : totalText + " · " + cacheHitText),
+					title: incomplete ? t("stats.incomplete", { count: display.coverage.unreadableSessions.length }) : void 0,
 					onClick: () => {
 						setOpen(!open);
 					},
@@ -31943,13 +31947,18 @@ window.__ModuleLoader__.load({
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(DatabaseIcon, {}), t("stats.dialog.usageTitle")]
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: StatsLineEnhanced_module_default.dialogTitleValue,
-								children: exactCount(total)
+								children: (incomplete ? "≥ " : "") + exactCount(total)
 							})]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: StatsLineEnhanced_module_default.dialogTitleRule,
 							"aria-hidden": true
 						}),
+						incomplete && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							role: "status",
+							"data-session-usage-partial": true,
+							children: t("stats.incomplete", { count: display.coverage.unreadableSessions.length })
+						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("dl", {
 							className: StatsLineEnhanced_module_default.dialogDetails,
 							"data-session-stats-usage": true,
@@ -31982,7 +31991,8 @@ window.__ModuleLoader__.load({
 			const stats = (0, react.useMemo)(() => projected ?? deriveStats(settledNodes ?? []), [projected, settledNodes]);
 			const tokenScale = (0, react.useMemo)(() => measuredTokenScale(settledNodes ?? []) ?? 1, [settledNodes]);
 			const tree = useSessionUsage(sessionId, usageSignature(usage, stats.steps));
-			const hasTokens = hasAnyTokens(sessionUsageForDisplay(usage, tree.tree).total);
+			const display = sessionUsageForDisplay(usage, tree.tree);
+			const hasTokens = hasAnyTokens(display.total) || display.coverage?.complete === false;
 			if (stats.steps === 0 && !hasTokens) return null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				ref: markDockContainer,
@@ -32048,7 +32058,8 @@ window.__ModuleLoader__.load({
 		const StatsUsageEntry = (0, react.memo)(function StatsUsageEntry({ useProjection, t, sessionId }) {
 			const usage = useProjection("tokenUsage");
 			const tree = useSessionUsage(sessionId, usageSignature(usage, usage === void 0 ? 0 : 1));
-			if (!hasAnyTokens(sessionUsageForDisplay(usage, tree.tree).total)) return null;
+			const display = sessionUsageForDisplay(usage, tree.tree);
+			if (!(hasAnyTokens(display.total) || display.coverage?.complete === false)) return null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsagePill, {
 				usage,
 				tree,
@@ -32420,6 +32431,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "Cache miss",
 			"stats.dialog.title": "Time & speed",
 			"stats.dialog.usageTitle": "Token usage",
+			"stats.partial": "Partial usage",
+			"stats.incomplete": "{count} subagent session(s) could not be read; totals are incomplete.",
 			"stats.dialog.llmTime": "LLM time",
 			"stats.dialog.toolTime": "Tool time",
 			"stats.dialog.ttft": "Mean TTFT",
@@ -32508,6 +32521,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "未命中缓存",
 			"stats.dialog.title": "用时与速度",
 			"stats.dialog.usageTitle": "Token 用量",
+			"stats.partial": "部分用量",
+			"stats.incomplete": "有 {count} 个子会话暂不可读取，总计尚不完整。",
 			"stats.dialog.llmTime": "LLM 用时",
 			"stats.dialog.toolTime": "工具用时",
 			"stats.dialog.ttft": "首 token 平均",
@@ -32596,6 +32611,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "未命中快取",
 			"stats.dialog.title": "用時與速度",
 			"stats.dialog.usageTitle": "Token 用量",
+			"stats.partial": "部分用量",
+			"stats.incomplete": "有 {count} 個子會話暫不可讀取，總計尚不完整。",
 			"stats.dialog.llmTime": "LLM 用時",
 			"stats.dialog.toolTime": "工具用時",
 			"stats.dialog.ttft": "首 token 平均",
@@ -33844,6 +33861,15 @@ window.__ModuleLoader__.load({
 					className: SessionUsageView_module_default.scope,
 					children: t("scope")
 				}),
+				detail.coverage?.complete === false && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: SessionUsageView_module_default.error,
+					role: "status",
+					"data-session-usage-partial": true,
+					children: [t("partialCoverage", { count: String(detail.coverage.unreadableSessions.length) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						title: detail.coverage.unreadableSessions.map((issue) => issue.sessionId).join("\n"),
+						children: t("partialTotals")
+					})]
+				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Metrics, {
 					detail,
 					t
@@ -33972,6 +33998,8 @@ window.__ModuleLoader__.load({
 			noModels: "暂无模型用量",
 			scope: "本会话及所有子代理 · 历史日志累计",
 			note: "统计包含本会话与全部后代的独立请求、重试和压缩调用，不重复计算继承历史。首 token 与速度仅使用已记录的时间信息，缺失时显示 —。",
+			partialCoverage: "有 {count} 个子会话暂不可读取。",
+			partialTotals: "当前仅显示已读取用量，未将缺失用量视为零。",
 			failedLoad: "用量读取失败，已保留上次结果。",
 			retry: "重新读取",
 			completed: "已完成",
@@ -34080,6 +34108,8 @@ window.__ModuleLoader__.load({
 			noModels: "No model usage yet",
 			scope: "This session and all subagents · Historical log totals",
 			note: "Includes independent requests, retries and compaction calls from this session and all descendants, without counting inherited history twice. Timing uses recorded timestamps only; missing values appear as —.",
+			partialCoverage: "{count} subagent session(s) could not be read.",
+			partialTotals: "Only readable usage is shown; missing usage is not treated as zero.",
 			failedLoad: "Could not read usage. The last successful result is preserved.",
 			retry: "Retry",
 			completed: "Completed",
@@ -34188,6 +34218,8 @@ window.__ModuleLoader__.load({
 			noModels: "暫無模型用量",
 			scope: "本會話及所有子代理 · 歷史日誌累計",
 			note: "統計包含本會話與全部後代的獨立請求、重試和壓縮呼叫，不重複計算繼承歷史。首 token 與速度僅使用已記錄的時間資訊，缺失時顯示 —。",
+			partialCoverage: "有 {count} 個子會話暫不可讀取。",
+			partialTotals: "目前僅顯示已讀取用量，未將缺失用量視為零。",
 			failedLoad: "用量讀取失敗，已保留上次結果。",
 			retry: "重新讀取",
 			completed: "已完成",

package/lib/index.js

@@ -1526,6 +1526,134 @@ async function resolveModelNames(modelRefs, llm) {
 	return names;
 }
 //#endregion
+//#region src/session-tree.ts
+function headerOf(item) {
+	if (!item || typeof item !== "object") return null;
+	const header = "header" in item ? item.header : item;
+	return header && typeof header.id === "string" && header.id !== "" ? header : null;
+}
+function inheritedCount(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : 0;
+}
+function throwIfCanceled(error, signal) {
+	signal?.throwIfAborted();
+	if (error && typeof error === "object" && "name" in error && error.name === "AbortError") throw error;
+}
+/** Never send raw exceptions to the client: they may contain paths or secrets. */
+function readIssue(sessionId, error) {
+	const name = error && typeof error === "object" && "name" in error ? error.name : "";
+	const code = error && typeof error === "object" && "code" in error ? error.code : "";
+	return {
+		sessionId,
+		reason: name === "SessionPersistenceCorruptionError" || name === "SessionFormatError" ? "corrupt" : name === "SessionPersistenceNotFoundError" || code === "ENOENT" ? "missing" : "unavailable"
+	};
+}
+async function readSession(persistence, id, header, live, signal) {
+	signal?.throwIfAborted();
+	if (typeof live?.snapshotEvents === "function" && typeof live.inheritedEventCount === "number") return {
+		id,
+		header,
+		live,
+		events: live.snapshotEvents(),
+		inheritedCut: inheritedCount(live.inheritedEventCount)
+	};
+	if (typeof persistence.open === "function") {
+		const options = signal === void 0 ? void 0 : { signal };
+		const handle = await persistence.open(id, "read", options);
+		try {
+			const events = [];
+			for (let offset = 0;;) {
+				signal?.throwIfAborted();
+				const page = await handle.read(offset, 500, options);
+				if (!page.events.length) break;
+				for (const event of page.events) events.push(event);
+				offset += page.events.length;
+			}
+			return {
+				id,
+				header: header ?? handle.header,
+				live,
+				events,
+				inheritedCut: inheritedCount(handle.inheritedEventCount)
+			};
+		} finally {
+			await handle.close().catch(() => {});
+		}
+	}
+	if (typeof persistence.inspect === "function") {
+		const inspection = await persistence.inspect(id, signal);
+		signal?.throwIfAborted();
+		return {
+			id,
+			header: header ?? inspection.meta,
+			live,
+			events: inspection.events,
+			inheritedCut: inheritedCount(inspection.inheritedEventCount)
+		};
+	}
+	throw new Error("no readable persistence seam (need open or inspect)");
+}
+async function readUsageTree(persistence, sessions, rootId, signal) {
+	signal?.throwIfAborted();
+	const rows = await persistence.list(typeof persistence.open === "function" ? signal === void 0 ? void 0 : { signal } : signal);
+	const headers = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const header = headerOf(row);
+		if (header) headers.set(header.id, header);
+	}
+	const live = new Map((sessions?.list() ?? []).map((handle) => [handle.id, handle]));
+	const children = /* @__PURE__ */ new Map();
+	const link = (id, parent) => {
+		if (typeof parent !== "string" || parent === "" || parent === id) return;
+		const bucket = children.get(parent) ?? /* @__PURE__ */ new Set();
+		bucket.add(id);
+		children.set(parent, bucket);
+	};
+	for (const header of headers.values()) link(header.id, header.parentSession);
+	for (const handle of live.values()) link(handle.id, handle.header?.parentSession ?? handle.parentSession);
+	const ids = [];
+	const seen = /* @__PURE__ */ new Set([rootId]);
+	const queue = [rootId];
+	for (let index = 0; index < queue.length; index++) for (const id of children.get(queue[index]) ?? []) {
+		if (seen.has(id)) continue;
+		seen.add(id);
+		ids.push(id);
+		queue.push(id);
+	}
+	const root = await readSession(persistence, rootId, headers.get(rootId), live.get(rootId), signal);
+	const logs = new Array(ids.length);
+	const issues = new Array(ids.length);
+	let next = 0;
+	const workers = await Promise.allSettled(Array.from({ length: Math.min(4, ids.length) }, async () => {
+		for (;;) {
+			signal?.throwIfAborted();
+			const index = next++;
+			if (index >= ids.length) return;
+			const id = ids[index];
+			try {
+				logs[index] = await readSession(persistence, id, headers.get(id), live.get(id), signal);
+			} catch (error) {
+				throwIfCanceled(error, signal);
+				issues[index] = readIssue(id, error);
+			}
+		}
+	}));
+	for (const worker of workers) if (worker.status === "rejected") throw worker.reason;
+	signal?.throwIfAborted();
+	const descendants = logs.filter((log) => log !== void 0);
+	const unreadableSessions = issues.filter((issue) => issue !== void 0);
+	return {
+		root,
+		descendants,
+		coverage: {
+			complete: unreadableSessions.length === 0,
+			totalSessions: ids.length + 1,
+			readableSessions: descendants.length + 1,
+			unreadableSessions
+		}
+	};
+}
+//#endregion
 //#region src/context-window.ts
 /** ASCII-ish characters per token (the host estimator's ratio). */
 const ASCII_CHARS_PER_TOKEN = 4;
@@ -1995,7 +2123,7 @@ function mergeUsageCompositions(parts) {
 }
 //#endregion
 //#region src/session-detail.ts
-const zero = () => ({
+const zero$1 = () => ({
 	uncachedInputTokens: 0,
 	outputTokens: 0,
 	cacheReadTokens: 0,
@@ -2082,43 +2210,6 @@ function usageOutputTokens(x) {
 	const value = (x?.usage ?? x)?.outputTokens;
 	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
 }
-function headerOf$1(item) {
-	const x = item;
-	if (x?.header?.id && typeof x.header.id === "string") return x.header;
-	return typeof x?.id === "string" && x.id ? x : null;
-}
-async function read(p, id, live) {
-	if (live?.snapshotEvents && typeof live.inheritedEventCount === "number") return {
-		events: live.snapshotEvents(),
-		cut: Math.max(0, live.inheritedEventCount)
-	};
-	if (p.open) {
-		const h = await p.open(id, "read");
-		const out = [];
-		try {
-			for (let off = 0;;) {
-				const page = await h.read(off, 500);
-				if (!page.events.length) break;
-				out.push(...page.events);
-				off += page.events.length;
-			}
-		} finally {
-			await h.close().catch(() => {});
-		}
-		return {
-			events: out,
-			cut: Math.max(0, Number(h.inheritedEventCount) || 0)
-		};
-	}
-	if (p.inspect) {
-		const x = await p.inspect(id);
-		return {
-			events: x.events,
-			cut: Math.max(0, Number(x.inheritedEventCount) || 0)
-		};
-	}
-	throw new Error("no readable persistence seam (need open or inspect)");
-}
 function nameOf(h, id) {
 	const x = h;
 	if (typeof x?.name === "string" && x.name) return x.name;
@@ -2126,10 +2217,10 @@ function nameOf(h, id) {
 	if (typeof x?.cwd === "string" && x.cwd) return x.cwd.split(/[\\/]/).filter(Boolean).pop() || id;
 	return id;
 }
-async function one(p, id, header, live) {
-	const { events, cut } = await read(p, id, live);
+function one(log) {
+	const { id, header, live, events, inheritedCut: cut } = log;
 	const fold = new UsageFold();
-	const totals = zero();
+	const totals = zero$1();
 	const records = [];
 	const byKey = /* @__PURE__ */ new Map();
 	let route = live?.requestContext?.() ?? {};
@@ -2205,14 +2296,14 @@ async function one(p, id, header, live) {
 					provider: r.provider || route.provider || "",
 					model: r.model || route.model || "",
 					status: "running",
-					totals: zero(),
+					totals: zero$1(),
 					firstTokenMs: null,
 					decodeMs: null,
 					tokensPerSecond: null,
 					turnName: "",
 					effort,
 					_attempt: ev.type === "llm/retry-started" ? 1 : 0,
-					_lastUsage: zero()
+					_lastUsage: zero$1()
 				};
 				records.push(rec);
 				byKey.set(key, rec);
@@ -2232,14 +2323,14 @@ async function one(p, id, header, live) {
 					provider: r.provider || route.provider || "",
 					model: r.model || route.model || "",
 					status: "running",
-					totals: zero(),
+					totals: zero$1(),
 					firstTokenMs: null,
 					decodeMs: null,
 					tokensPerSecond: null,
 					turnName: "",
 					effort,
 					_attempt: 0,
-					_lastUsage: zero()
+					_lastUsage: zero$1()
 				};
 				records.push(rec);
 				byKey.set(key, rec);
@@ -2326,32 +2417,16 @@ async function one(p, id, header, live) {
 	};
 }
 async function buildSessionUsageDetail(persistence, sessions, rootId, ctx) {
-	const headers = (await persistence.list(typeof persistence.open === "function" ? void 0 : void 0)).map(headerOf$1).filter((x) => x !== null);
-	const live = new Map((sessions?.list() ?? []).map((x) => [x.id, x]));
-	const children = /* @__PURE__ */ new Map();
-	for (const h of headers) if (h.parentSession) children.set(h.parentSession, [...children.get(h.parentSession) ?? [], h.id]);
-	for (const h of live.values()) {
-		const p = h.header?.parentSession ?? h.parentSession;
-		if (p) children.set(p, [...(children.get(p) ?? []).filter((x) => x !== h.id), h.id]);
-	}
-	const ids = [];
-	const seen = /* @__PURE__ */ new Set([rootId]);
-	const q = [rootId];
-	while (q.length) for (const c of children.get(q.shift()) ?? []) if (!seen.has(c)) {
-		seen.add(c);
-		ids.push(c);
-		q.push(c);
-	}
-	const all = [rootId, ...ids];
-	const parts = await Promise.all(all.map((id) => one(persistence, id, headers.find((h) => h.id === id), live.get(id))));
-	const totals = zero();
+	const { root, descendants, coverage } = await readUsageTree(persistence, sessions, rootId);
+	const parts = [root, ...descendants].map(one);
+	const totals = zero$1();
 	const models = /* @__PURE__ */ new Map();
 	const records = parts.flatMap((x) => x.records);
 	for (const p of parts) add$1(totals, p.totals);
 	for (const r of records) {
 		const key = r.model || "(unknown)";
 		const m = models.get(key) ?? {
-			totals: zero(),
+			totals: zero$1(),
 			requests: 0,
 			providers: /* @__PURE__ */ new Set()
 		};
@@ -2405,6 +2480,7 @@ async function buildSessionUsageDetail(persistence, sessions, rootId, ctx) {
 	const firsts = records.filter((x) => x.status === "completed").map((x) => x.firstTokenMs).filter((x) => x !== null);
 	return {
 		sessionId: rootId,
+		coverage,
 		totals,
 		requests: parts.reduce((n, p) => n + p.requests, 0),
 		averageFirstTokenMs: firsts.length ? firsts.reduce((a, b) => a + b, 0) / firsts.length : null,
@@ -2811,82 +2887,25 @@ function buildUsageRoute(ctx, deps) {
 }
 //#endregion
 //#region src/session-usage.ts
-const ZERO = {
+const zero = () => ({
 	uncachedInputTokens: 0,
 	outputTokens: 0,
 	cacheReadTokens: 0,
 	cacheWriteTokens: 0
-};
+});
 function add(into, from) {
 	into.uncachedInputTokens += from.uncachedInputTokens;
 	into.outputTokens += from.outputTokens;
 	into.cacheReadTokens += from.cacheReadTokens;
 	into.cacheWriteTokens += from.cacheWriteTokens;
 }
-/** How long one computed tree stays hot. The pill refreshes on its own clock,
-*  and a live session's numbers move at step granularity, not per frame. */
-const CACHE_TTL_MS = 4e3;
-/** Absolute ceiling on cached trees, so a long-lived host with many sessions
-*  cannot grow this map without bound. */
-const CACHE_MAX = 64;
-/** Normalize a `list()` row (alpha snapshots or rc.1 header rows). */
-function headerOf(item) {
-	const snap = item;
-	if (snap !== null && typeof snap === "object" && "header" in snap && snap.header !== null && typeof snap.header === "object" && typeof snap.header.id === "string") return snap.header;
-	const row = item;
-	return typeof row?.id === "string" && row.id !== "" ? row : null;
-}
-function inheritedCount(cut) {
-	return typeof cut === "number" && Number.isSafeInteger(cut) && cut >= 0 ? cut : 0;
-}
-/** Read one stored session's events through whichever persistence seam the
-*  host line exposes (alpha open/read/close wins; rc.1 inspect is the tail). */
-async function readEvents(persistence, id, signal) {
-	if (typeof persistence.open === "function") {
-		const handle = await persistence.open(id, "read", signal === void 0 ? void 0 : { signal });
-		try {
-			const inheritedCut = inheritedCount(handle.inheritedEventCount);
-			const collected = [];
-			let offset = 0;
-			const PAGE = 500;
-			for (;;) {
-				signal?.throwIfAborted();
-				const slice = await handle.read(offset, PAGE, signal === void 0 ? void 0 : { signal });
-				const page = slice && slice.events ? slice.events : [];
-				if (page.length === 0) break;
-				for (const ev of page) collected.push(ev);
-				offset += page.length;
-			}
-			return {
-				events: collected,
-				inheritedCut
-			};
-		} finally {
-			await handle.close().catch(() => {});
-		}
-	}
-	if (typeof persistence.inspect === "function") {
-		const inspection = await persistence.inspect(id, signal);
-		return {
-			events: inspection.events,
-			inheritedCut: inheritedCount(inspection.inheritedEventCount)
-		};
-	}
-	throw new Error("no readable persistence seam (need open or inspect)");
-}
-/** Sum one session's own usage (its main agent) from its log. */
-async function sumOneSession(persistence, id, signal, live) {
-	signal?.throwIfAborted();
-	const { events, inheritedCut } = typeof live?.snapshotEvents === "function" && typeof live.inheritedEventCount === "number" ? {
-		events: live.snapshotEvents(),
-		inheritedCut: inheritedCount(live.inheritedEventCount)
-	} : await readEvents(persistence, id, signal);
+function sumOneSession(log) {
 	const fold = new UsageFold();
-	const totals = { ...ZERO };
-	const compaction = { ...ZERO };
-	for (const ev of events) {
-		if (inheritedCut > 0 && typeof ev.seq === "number" && ev.seq < inheritedCut) continue;
-		const sample = fold.fold(ev);
+	const totals = zero();
+	const compaction = zero();
+	for (const event of log.events) {
+		if (event.seq < log.inheritedCut) continue;
+		const sample = fold.fold(event);
 		if (sample === null || sample.turn) continue;
 		const buckets = {
 			uncachedInputTokens: sample.inputTokens,
@@ -2895,77 +2914,47 @@ async function sumOneSession(persistence, id, signal, live) {
 			cacheWriteTokens: sample.cacheWriteTokens
 		};
 		add(totals, buckets);
-		if (ev.type === "compaction/summary") add(compaction, buckets);
+		if (event.type === "compaction/summary") add(compaction, buckets);
 	}
 	return {
 		totals,
 		compaction
 	};
 }
+const CACHE_TTL_MS = 4e3;
+const CACHE_MAX = 64;
 var SessionUsageService = class {
-	/** Short-lived tree reads; any live event can invalidate tree membership. */
 	cache = /* @__PURE__ */ new Map();
-	/** Any event can introduce a new descendant while an async read is running. */
 	generation = 0;
-	/** Invalidate conservatively: an unseen session may be a newly-created child
-	*  of ANY cached root, so membership-only invalidation is not safe. */
+	/** New events can introduce descendants of any cached root. */
 	invalidate(_sessionId) {
 		this.generation++;
 		this.cache.clear();
 	}
-	/** Resolve the whole session tree rooted at `rootId` and sum its usage.
-	*  `self` is the root's own usage, `subagents` every descendant's, `total`
-	*  the sum. Unreadable logs reject rather than publishing partial totals;
-	*  callers can retain their last good display while surfacing the error. */
+	/** A bad descendant leaves the readable totals available with coverage.
+	* Never cache incomplete results: a repaired log must recover on the next read.
+	* Root, catalog and cancellation failures still reject without publishing zero. */
 	async tree(persistence, sessions, rootId, signal) {
 		signal?.throwIfAborted();
 		const hit = this.cache.get(rootId);
 		if (hit !== void 0 && Date.now() - hit.at < CACHE_TTL_MS) return hit.value;
 		const generation = this.generation;
-		const headers = await this.listHeaders(persistence, signal);
-		const children = /* @__PURE__ */ new Map();
-		for (const header of headers) {
-			const parent = header.parentSession;
-			if (typeof parent !== "string" || parent === "") continue;
-			const bucket = children.get(parent);
-			if (bucket === void 0) children.set(parent, [header.id]);
-			else bucket.push(header.id);
-		}
-		const live = new Map((sessions?.list() ?? []).map((handle) => [handle.id, handle]));
-		for (const handle of live.values()) {
-			const parent = handle.header?.parentSession ?? handle.parentSession;
-			if (typeof parent !== "string" || parent === "" || parent === handle.id) continue;
-			const bucket = children.get(parent);
-			if (bucket === void 0) children.set(parent, [handle.id]);
-			else if (!bucket.includes(handle.id)) bucket.push(handle.id);
-		}
-		const descendants = [];
-		const seen = /* @__PURE__ */ new Set([rootId]);
-		const queue = [rootId];
-		while (queue.length > 0) {
-			const current = queue.shift();
-			for (const child of children.get(current) ?? []) {
-				if (seen.has(child)) continue;
-				seen.add(child);
-				descendants.push(child);
-				queue.push(child);
-			}
-		}
-		const root = await sumOneSession(persistence, rootId, signal, live.get(rootId));
-		const self = root.totals;
-		const subagents = { ...ZERO };
-		for (const id of descendants) add(subagents, (await sumOneSession(persistence, id, signal, live.get(id))).totals);
-		const total = { ...self };
+		const { root, descendants, coverage } = await readUsageTree(persistence, sessions, rootId, signal);
+		const own = sumOneSession(root);
+		const subagents = zero();
+		for (const log of descendants) add(subagents, sumOneSession(log).totals);
+		const total = { ...own.totals };
 		add(total, subagents);
 		const value = {
-			self,
-			selfCompaction: root.compaction,
+			self: own.totals,
+			selfCompaction: own.compaction,
 			subagents,
 			total,
-			subagentSessions: descendants.length
+			subagentSessions: descendants.length,
+			coverage
 		};
 		signal?.throwIfAborted();
-		if (generation === this.generation) {
+		if (coverage.complete && generation === this.generation) {
 			if (this.cache.size >= CACHE_MAX) this.cache.clear();
 			this.cache.set(rootId, {
 				at: Date.now(),
@@ -2974,9 +2963,6 @@ var SessionUsageService = class {
 		}
 		return value;
 	}
-	async listHeaders(persistence, signal) {
-		return (typeof persistence.open === "function" ? await persistence.list(signal === void 0 ? void 0 : { signal }) : await persistence.list(signal)).map(headerOf).filter((h) => h !== null);
-	}
 };
 //#endregion
 //#region src/index.ts

package/lib/types/client/locales.d.ts

@@ -7,7 +7,7 @@
 /** The locale namespace this plugin owns. */
 export declare const LOCALE_NS = "tokenTotal";
 /** The typed translator key union for the panel's locale seat. */
-export type TokenTotalKey = 'nav' | 'back' | 'range' | 'rangePreset.today' | 'rangePreset.3' | 'rangePreset.7' | 'rangePreset.30' | 'rangePreset.90' | 'rangeCustom' | 'from' | 'to' | 'refresh' | 'loading' | 'tokens' | 'tokensHint' | 'tokensUnit' | 'inputTokens' | 'outputTokens' | 'cacheTokens' | 'cachedTokens' | 'sessions' | 'requests' | 'requestsFailed' | 'activeDays' | 'cacheRate' | 'cacheRateHint' | 'cacheHitRate' | 'hitRateLegend' | 'topModel' | 'topModelHint' | 'heatmap' | 'heatLess' | 'heatMore' | 'dow.mon' | 'dow.tue' | 'dow.wed' | 'dow.thu' | 'dow.fri' | 'dow.sat' | 'dow.sun' | 'month.jan' | 'month.feb' | 'month.mar' | 'month.apr' | 'month.may' | 'month.jun' | 'month.jul' | 'month.aug' | 'month.sep' | 'month.oct' | 'month.nov' | 'month.dec' | 'dailyTrend' | 'hourlyTrend' | 'trendLimited' | 'usageRanking' | 'byModel' | 'byProvider' | 'tokensColumn' | 'cacheRateColumn' | 'providerModels' | 'other' | 'total' | 'percent' | 'asOf' | 'empty' | 'stats.counts' | 'stats.tokensPerSecond' | 'stats.cacheHit' | 'stats.cacheMiss' | 'stats.dialog.title' | 'stats.dialog.usageTitle' | 'stats.dialog.llmTime' | 'stats.dialog.toolTime' | 'stats.dialog.ttft' | 'stats.dialog.speed' | 'stats.dialog.main' | 'stats.dialog.subagents' | 'stats.dialog.subagentCount' | 'stats.dialog.treeTotal' | 'message.turnUsage.count' | 'message.turnUsage.cacheHit' | 'message.turnUsage.input' | 'message.turnUsage.cacheRead' | 'message.turnUsage.cacheWrite' | 'message.turnUsage.output';
+export type TokenTotalKey = 'nav' | 'back' | 'range' | 'rangePreset.today' | 'rangePreset.3' | 'rangePreset.7' | 'rangePreset.30' | 'rangePreset.90' | 'rangeCustom' | 'from' | 'to' | 'refresh' | 'loading' | 'tokens' | 'tokensHint' | 'tokensUnit' | 'inputTokens' | 'outputTokens' | 'cacheTokens' | 'cachedTokens' | 'sessions' | 'requests' | 'requestsFailed' | 'activeDays' | 'cacheRate' | 'cacheRateHint' | 'cacheHitRate' | 'hitRateLegend' | 'topModel' | 'topModelHint' | 'heatmap' | 'heatLess' | 'heatMore' | 'dow.mon' | 'dow.tue' | 'dow.wed' | 'dow.thu' | 'dow.fri' | 'dow.sat' | 'dow.sun' | 'month.jan' | 'month.feb' | 'month.mar' | 'month.apr' | 'month.may' | 'month.jun' | 'month.jul' | 'month.aug' | 'month.sep' | 'month.oct' | 'month.nov' | 'month.dec' | 'dailyTrend' | 'hourlyTrend' | 'trendLimited' | 'usageRanking' | 'byModel' | 'byProvider' | 'tokensColumn' | 'cacheRateColumn' | 'providerModels' | 'other' | 'total' | 'percent' | 'asOf' | 'empty' | 'stats.counts' | 'stats.tokensPerSecond' | 'stats.cacheHit' | 'stats.cacheMiss' | 'stats.dialog.title' | 'stats.dialog.usageTitle' | 'stats.partial' | 'stats.incomplete' | 'stats.dialog.llmTime' | 'stats.dialog.toolTime' | 'stats.dialog.ttft' | 'stats.dialog.speed' | 'stats.dialog.main' | 'stats.dialog.subagents' | 'stats.dialog.subagentCount' | 'stats.dialog.treeTotal' | 'message.turnUsage.count' | 'message.turnUsage.cacheHit' | 'message.turnUsage.input' | 'message.turnUsage.cacheRead' | 'message.turnUsage.cacheWrite' | 'message.turnUsage.output';
 export declare const en: Record<TokenTotalKey, string>;
 export declare const zh: Record<TokenTotalKey, string>;
 export declare const zhTW: Record<TokenTotalKey, string>;

package/lib/types/client/session-usage-locales.d.ts

@@ -32,6 +32,8 @@ export declare const usageZh: {
     noModels: string;
     scope: string;
     note: string;
+    partialCoverage: string;
+    partialTotals: string;
     failedLoad: string;
     retry: string;
     completed: string;