dsh-context 0.41.2 → 0.42.0

package/README.md

@@ -91,7 +91,7 @@ Pick **Live (next request)** or any retained step, and browse what that request
 
 ![A tool result expanded with Raw/Markdown toggle](https://raw.githubusercontent.com/bowenliang123/dsh-context/main/docs/context-browser-tool-result.png)
 
-- **Image payloads render as cards** — thumbnails with name, dimensions, stored size, and the official DeepSeek image-token estimate (dsh 0.1.1+ multimodal pipeline, e.g. `read_image` results and image attachments):
+- **Image payloads render as cards** — thumbnails with name, dimensions, stored size, and the official DeepSeek image-token estimate (the dsh multimodal pipeline, e.g. `read_image` results and image attachments):
 
 ![An image payload rendered as a thumbnail card](https://raw.githubusercontent.com/bowenliang123/dsh-context/main/docs/context-browser-images.png)
 
@@ -140,7 +140,7 @@ In **Settings → Plugins → Plugin configuration**, the **Context** card holds
 ## Good to know
 
 - **Estimates vs actuals** — category figures use dsh's own fixed-density heuristic (the same one as its built-in token meter); the pinned trend details and Token/Timing rings show provider-reported actuals next to them.
-- **Compatibility** — works on `@deepseek-ai/dsh` **0.1.1-rc2+** and **0.1.2-alpha2+**. The per-release matrix and how it is verified: [docs/compatibility.md](docs/compatibility.md).
+- **Compatibility** — works on `@deepseek-ai/dsh` **0.1.2-rc1+**. The per-release matrix and how it is verified: [docs/compatibility.md](docs/compatibility.md).
 - **I18n** — UI in English and 简体中文.
 
 ## Like it?

package/lib/client.js

@@ -88,6 +88,7 @@ window.__ModuleLoader__.load({
 			"brief.noInputs": "（无新增）",
 			"brief.locate": "在上下文浏览器中查看",
 			"jump.title": "在上下文标签页中查看此轮",
+			"jump.statsLine": "在上下文标签页中查看上下文构成",
 			"brief.turnTip": "这一轮开场时用户发送的消息；回合内的每一步都会回显同一条",
 			"brief.inputTip": "上一步回复之后、本次请求发出前新进入上下文的内容——通常是上一步所调工具的结果；每轮的第一步无新增",
 			"brief.replyTip": "这一步模型返回的内容（文本回复或工具调用）；此步发起的调用，其结果会出现在下一柱的「输入」行",
@@ -189,6 +190,12 @@ window.__ModuleLoader__.load({
 			"loading": "正在读取会话日志…",
 			"error": "上下文数据读取失败：",
 			"error.retry": "重试",
+			"gate.title": "请更新 DeepSeek Harness 版本",
+			"gate.body": "dsh-context 插件支持 DeepSeek Harness v{minimum} 或更新版本。",
+			"gate.current": "当前版本",
+			"gate.minimum": "最低要求",
+			"gate.orNewer": "及更新的版本",
+			"gate.ok": "知道了",
 			"footer": "估算口径：与 dsh 内置 tokenMeter 相同的固定密度启发式（约 4 字符 ≈ 1 token）；「实际」为供应商上报用量。",
 			"tip.step": "第 {t} 轮 · 第{s}步",
 			"tip.turn": "第 {t} 轮 · 共 {n} 步",
@@ -364,6 +371,7 @@ window.__ModuleLoader__.load({
 			"brief.noInputs": "(nothing new)",
 			"brief.locate": "Reveal in Context Browser",
 			"jump.title": "View this turn in the Context tab",
+			"jump.statsLine": "View the context composition in the Context tab",
 			"brief.turnTip": "The user message that opened this turn — every step of the turn recalls it",
 			"brief.inputTip": "What entered after the previous reply and before this request went out — usually the previous tool-call results; a turn opener has nothing new",
 			"brief.replyTip": "What the model returned on this step (a text reply or tool calls) — results of calls made here appear in the In row of the next bar",
@@ -465,6 +473,12 @@ window.__ModuleLoader__.load({
 			"loading": "Reading the session log…",
 			"error": "Failed to read context data: ",
 			"error.retry": "Retry",
+			"gate.title": "Update DeepSeek Harness",
+			"gate.body": "dsh-context supports DeepSeek Harness v{minimum} or newer.",
+			"gate.current": "Current",
+			"gate.minimum": "Minimum required",
+			"gate.orNewer": "or newer",
+			"gate.ok": "Got it",
 			"footer": "Estimate: same fixed-density heuristic as dsh’s built-in tokenMeter (~4 chars ≈ 1 token); “actual” is provider-reported usage.",
 			"tip.step": "Turn {t} · Step {s}",
 			"tip.turn": "Turn {t} · {n} steps",
@@ -814,55 +828,36 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/services.ts
 		/**
-		* A session-authorized durable-image loader over whichever conversation
-		* face the running harness provides (`resolveImage` pre-0.1.2, `imageUrl`
-		* since), or undefined when neither service is composed — the caller
-		* degrades to metadata-only cards. Hostile snapshots and throwing service
-		* reads are caught: this helper can never take a render down.
+		* A session-authorized durable-image loader over the harness conversation
+		* face (`uiConversation.imageUrl`), or undefined when the service is not
+		* composed — the caller degrades to metadata-only cards. Hostile snapshots
+		* and throwing service reads are caught: this helper can never take a
+		* render down.
 		*/
 		function imageLoaderOf(ctx, sessionId) {
 			if (typeof sessionId !== "string" || sessionId === "") return void 0;
 			try {
-				const legacy = ctx.get("conversation");
-				if (legacy !== void 0 && typeof legacy.resolveImage === "function") {
-					const resolveImage = legacy.resolveImage.bind(legacy);
-					return (attachment) => resolveImage(sessionId, attachment);
-				}
-				const modern = ctx.get("uiConversation");
-				if (modern !== void 0 && typeof modern.imageUrl === "function") {
-					const imageUrl = modern.imageUrl.bind(modern);
+				const conversation = ctx.get("uiConversation");
+				if (conversation !== void 0 && typeof conversation.imageUrl === "function") {
+					const imageUrl = conversation.imageUrl.bind(conversation);
 					return (attachment) => imageUrl(sessionId, attachment);
 				}
 			} catch {}
 		}
 		/**
-		* The conversation-window nodes this plugin joins on, from whichever seat
-		* the running harness provides — `useChat` (`ChatSnapshot.legacy.nodes`) on
-		* dsh 0.1.2+, the session snapshot's own `nodes` before that. Returns
-		* undefined when neither seat delivers a real array (absent seat, older or
-		* foreign harness, hostile snapshot) — callers render without the join,
-		* never an error.
-		*
-		* Hook-order contract: the seats are real React hooks, so BOTH are invoked
-		* on every call whenever present (the chat seat first, the session seat
-		* second) and only the RESULT is picked conditionally — a stable call order
-		* across renders. Selectors return stable slice references so the
-		* framework's snapshot equality can gate re-renders.
+		* The conversation-window nodes this plugin joins on, from the `useChat`
+		* seat (`ChatSnapshot.legacy.nodes`). Returns undefined when the seat does
+		* not deliver a real array (absent seat, foreign harness, hostile snapshot)
+		* — callers render without the join, never an error.
 		*/
 		function conversationNodesOf(props) {
 			const useChat = props.useChat;
-			let chatNodes;
-			if (typeof useChat === "function") try {
+			if (typeof useChat !== "function") return void 0;
+			try {
 				const slice = useChat((s) => s !== null && typeof s === "object" ? s.legacy : void 0);
-				chatNodes = slice !== null && typeof slice === "object" ? slice.nodes : void 0;
+				const nodes = slice !== null && typeof slice === "object" ? slice.nodes : void 0;
+				return Array.isArray(nodes) ? nodes : void 0;
 			} catch {}
-			const useSession = props.useSession;
-			let sessionNodes;
-			if (typeof useSession === "function") try {
-				sessionNodes = useSession((s) => s.nodes);
-			} catch {}
-			if (Array.isArray(chatNodes)) return chatNodes;
-			if (Array.isArray(sessionNodes)) return sessionNodes;
 		}
 		/**
 		* Narrow an unknown projection value to a string-keyed record, or null when
@@ -886,6 +881,20 @@ window.__ModuleLoader__.load({
 			return value.filter((v) => v !== null && typeof v === "object");
 		}
 		/**
+		* Narrow a delivered `unsupported` gate record (the host's baseline gate —
+		* see host/fallback.ts): both version strings re-proved, anything else
+		* degrades to null (no gate shown) instead of rendering garbage.
+		*/
+		function unsupportedOf(value) {
+			const data = asRecord$1(value);
+			if (data === null) return null;
+			if (typeof data.current !== "string" || typeof data.minimum !== "string") return null;
+			return {
+				current: data.current,
+				minimum: data.minimum
+			};
+		}
+		/**
 		* Narrow a delivered projection value to a RENDER-SAFE context timeline —
 		* the client's no-white-screen guarantee against backend/parse failures.
 		*
@@ -914,8 +923,10 @@ window.__ModuleLoader__.load({
 			const safeCurrent = current !== null && typeof current === "object" ? current : {};
 			const cost = typeof data.cost === "object" && data.cost !== null && !Array.isArray(data.cost) ? data.cost : void 0;
 			const timing = timingOf(data.timing);
+			const unsupported = unsupportedOf(data.unsupported);
 			return {
 				ok: true,
+				...unsupported !== null ? { unsupported } : {},
 				...typeof data.model === "string" ? { model: data.model } : {},
 				...typeof data.provider === "string" ? { provider: data.provider } : {},
 				...typeof data.contextWindow === "number" ? { contextWindow: data.contextWindow } : {},
@@ -1263,109 +1274,74 @@ window.__ModuleLoader__.load({
 			}
 			return nodes;
 		}
-		/** Read a service off the client context without letting an absent/foreign
-		* cordis service (a throwing `ctx.get`) escape: returns undefined instead. */
-		function serviceOf(ctx, name) {
+		/** The `page` verb of a history face, re-proved and bound to its owner.
+		* Hostile objects (any accessor backed by host state can throw) degrade to
+		* undefined instead of escaping the read. */
+		function readPageOf(face) {
+			if (face === null || typeof face !== "object") return void 0;
 			try {
-				return ctx.get(name);
+				const fn = face.page;
+				return typeof fn === "function" ? fn.bind(face) : void 0;
 			} catch {
 				return;
 			}
 		}
 		/**
-		* Walk a (possibly traced/proxied) service value down a plain-property path,
-		* degrading at the FIRST throw. cordis's undeclared-service proxies are one
-		* hostile object class — any accessor backed by host state can throw too —
-		* and the no-white-screen contract needs the whole chain guarded, not just
-		* the `ctx.get` call.
-		*/
-		function readKeysOf(value, ...keys) {
-			let current = value;
-			for (const key of keys) {
-				if (current === null || typeof current !== "object") return void 0;
-				try {
-					current = current[key];
-				} catch {
-					return;
-				}
-			}
-			return current;
-		}
-		/** The `page` verb of a history face, re-proved and bound to its owner. */
-		function readPageOf(face) {
-			const fn = readKeysOf(face, "page");
-			return typeof fn === "function" ? fn.bind(face) : void 0;
-		}
-		/** The `history` verb of the legacy api client face, re-proved and bound. */
-		function readHistoryOf(face) {
-			const sessions = readKeysOf(face, "api", "sessions");
-			const fn = readKeysOf(sessions, "history");
-			return typeof fn === "function" ? fn.bind(sessions) : void 0;
-		}
-		/**
-		* The 0.1.2+ gateway history page verb, resolved through the DECLARED inject
+		* The gateway history page verb, resolved through the DECLARED inject
 		* (see {@link watchHistoryFaces}) and bound up front: a method extracted
 		* unbound loses `this`, and the traced `remote` proxy that hands it out
 		* requires the inject to resolve at all.
 		*/
 		let declaredPage;
 		/**
-		* Register the plugin's 0.1.2+ history faces with the harness through the
-		* DECLARED inject — both `remote` AND `remote.session` (the ui-chat idiom)
-		* must be in one fiber's requirement list, because the traced `remote`
-		* proxy resolves `.session` through the context and each name needs the
-		* other's declaration. Pre-0.1.2 hosts never provide either name, so the
-		* callback simply never fires and the legacy `connection` face carries the
-		* reads. The callback re-runs on every unload/remount, so it owns the
-		* slot's lifetime. The face itself is re-proven (a never-fired or hostile
-		* invocation leaves the slot unset — nothing here can throw).
+		* Register the plugin's history face with the harness through the DECLARED
+		* inject — both `remote` AND `remote.session` (the ui-chat idiom) must be in
+		* one fiber's requirement list, because the traced `remote` proxy resolves
+		* `.session` through the context and each name needs the other's
+		* declaration; an undeclared read of the traced proxy throws instead of
+		* resolving. The callback re-runs on every unload/remount, so it owns the
+		* slot's lifetime. The face itself is re-proven: a never-fired invocation
+		* or a hostile property read leaves the slot unset — nothing here can throw.
 		*/
 		function watchHistoryFaces(ctx) {
 			ctx.inject(["remote", "remote.session"], (c) => {
-				const session = c.remote?.session;
-				declaredPage = session !== void 0 ? readPageOf(session) : void 0;
+				try {
+					const session = c.remote?.session;
+					declaredPage = session !== void 0 ? readPageOf(session) : void 0;
+				} catch {
+					declaredPage = void 0;
+				}
 				return () => {
 					declaredPage = void 0;
 				};
 			});
 		}
-		/** The rows array of a history/page response, under every served envelope. */
+		/** The rows array of a successful history page, under the served envelope. */
 		function rowsOf(response) {
 			let payload = response;
-			if (payload !== null && typeof payload === "object") {
-				const nested = payload.result;
-				if (nested !== null && typeof nested === "object") payload = nested;
-			}
 			if (payload !== null && typeof payload === "object" && "ok" in payload) {
 				const r = payload;
 				if (r.ok !== true || r.value === null || typeof r.value !== "object") throw new Error("history rpc failed");
 				payload = r.value;
 			}
 			if (payload === null || typeof payload !== "object") throw new Error("history rpc failed");
-			const rows = payload.records ?? payload.events;
+			const rows = payload.records;
 			if (!Array.isArray(rows)) throw new Error("history rpc failed");
 			return rows;
 		}
 		/**
-		* The session's history readers over whichever face the running harness
-		* serves — the 0.1.2+ gateway remotes (`remote.session.page`) first, the
-		* pre-0.1.2 api client verb (`connection.api.sessions.history`) beneath it.
-		* Both cut message-aligned pages, so the returned read covers `seq` whenever
-		* the durable log still holds it: the newer face pins the inclusive cut to
-		* the seq itself, the legacy reader uses the exclusive bound one past it —
-		* and because a non-declared read of the traced remote proxy throws
-		* ("cannot get property … without inject"), the page face prefers the
-		* injection-resolved slot and only then tries the reflect read. Every
-		* service property access degrades at its own guard instead of taking the
-		* view down. Undefined when no face exists (older hosts) — callers keep
-		* their static degradation.
+		* The session's history reader over the gateway remotes (`remote.session.page`),
+		* from the declared-inject slot. The page cuts message-aligned pages, so the
+		* returned read covers `seq` whenever the durable log still holds it: the
+		* inclusive cut is pinned to the seq itself, the exclusive bound one past
+		* it. Undefined when the slot holds no face (the inject never fired or
+		* served no usable page verb) — callers keep their static degradation.
 		*/
-		function pageReadersOf(ctx, sessionId) {
-			const page = declaredPage ?? readPageOf(serviceOf(ctx, "remote.session"));
-			const history = readHistoryOf(serviceOf(ctx, "connection"));
-			if (page === void 0 && history === void 0) return void 0;
+		function pageReaderOf(sessionId) {
+			const page = declaredPage;
+			if (page === void 0) return void 0;
 			return (seq) => {
-				if (page !== void 0) return page({
+				return page({
 					address: {
 						kind: "session",
 						sessionId
@@ -1373,24 +1349,18 @@ window.__ModuleLoader__.load({
 					throughSeq: seq,
 					beforeSeq: seq + 1
 				}, new AbortController().signal);
-				return history({
-					sessionId,
-					beforeSeq: seq + 1
-				});
 			};
 		}
 		/**
-		* Build the browser's per-session fetcher over whichever history face the
-		* running harness serves — the 0.1.2+ gateway remotes (`remote.session.page`)
-		* first, the pre-0.1.2 api client verb (`connection.api.sessions.history`)
-		* beneath it. Both cut message-aligned pages, so `beforeSeq: seq + 1` (with
-		* the inclusive cut pinned to `seq` on the newer face) covers the seq whenever
-		* the durable log still holds it. Undefined when no face exists (older
-		* hosts) — the caller keeps its static preview-plus-hint degradation. Found
-		* nodes cache in the closure: one mount re-reading a row never re-fetches.
+		* Build the browser's per-session fetcher over the gateway history face
+		* (`remote.session.page`): message-aligned pages whose inclusive cut pinned
+		* to `seq` (exclusive bound one past it) cover the seq whenever the durable
+		* log still holds it. Undefined when no face was resolved at build time —
+		* the caller keeps its static preview-plus-hint degradation. Found nodes
+		* cache in the closure: one mount re-reading a row never re-fetches.
 		*/
-		function makeContentFetcher(ctx, sessionId) {
-			const read = pageReadersOf(ctx, sessionId);
+		function makeContentFetcher(sessionId) {
+			const read = pageReaderOf(sessionId);
 			if (read === void 0) return void 0;
 			const cache = /* @__PURE__ */ new Map();
 			return async (seq) => {
@@ -1434,11 +1404,11 @@ window.__ModuleLoader__.load({
 		* mapped client-side into the renderable content. Epochs cache per session
 		* (history is immutable), and OLDER epochs sharing the page cache for free —
 		* stepping back through epochs walks the same pages. Undefined when no
-		* history face exists (older hosts) — the browser keeps a metadata-only
-		* degradation instead.
+		* history face exists — the browser keeps a metadata-only degradation
+		* instead.
 		*/
-		function makeHeaderFetcher(ctx, sessionId) {
-			const read = pageReadersOf(ctx, sessionId);
+		function makeHeaderFetcher(sessionId) {
+			const read = pageReaderOf(sessionId);
 			if (read === void 0) return void 0;
 			const cache = /* @__PURE__ */ new Map();
 			return async (seq) => {
@@ -1760,7 +1730,7 @@ window.__ModuleLoader__.load({
 		//#region src/client/components/images.tsx
 		/**
 		* Narrow an unknown content block to a durable image ref: accepts both raw message blocks (`{ type: 'image', attachment }`) and the
-		* snapshot's assistant blocks (`{ kind: 'image', attachment }`); everything else null. Lenient on the optional facts — resolveImage reads
+		* snapshot's assistant blocks (`{ kind: 'image', attachment }`); everything else null. Lenient on the optional facts — imageUrl reads
 		* only attachmentId.
 		*/
 		function imageRefOf(block) {
@@ -2913,8 +2883,8 @@ window.__ModuleLoader__.load({
 				const [hoverCat, setHoverCat] = React.useState(null);
 				const [dockLeft, setDockLeft] = React.useState(0);
 				const backdropRef = React.useRef(null);
-				const fetchContent = React.useMemo(() => sessionId !== "" ? makeContentFetcher(ctx, sessionId) : void 0, [ctx, sessionId]);
-				const fetchHeader = React.useMemo(() => sessionId !== "" ? makeHeaderFetcher(ctx, sessionId) : void 0, [ctx, sessionId]);
+				const fetchContent = React.useMemo(() => sessionId !== "" ? makeContentFetcher(sessionId) : void 0, [sessionId]);
+				const fetchHeader = React.useMemo(() => sessionId !== "" ? makeHeaderFetcher(sessionId) : void 0, [sessionId]);
 				const close = React.useCallback(() => {
 					if (sessionId === "") return;
 					modalStoreOf(sessionId).set(false);
@@ -5122,7 +5092,7 @@ window.__ModuleLoader__.load({
 			return function PluginInfo() {
 				const [latest, setLatest] = React.useState(null);
 				React.useEffect(() => {
-					if ("0.41.2".includes("-dev")) return;
+					if ("0.42.0".includes("-dev")) return;
 					let on = true;
 					fetchLatestVersion().then((v) => {
 						if (on && v) setLatest(v);
@@ -5131,8 +5101,8 @@ window.__ModuleLoader__.load({
 						on = false;
 					};
 				}, []);
-				const update = latest !== null && isNewerVersion(latest, "0.41.2") ? latest : null;
-				const nameText = "dsh-context (v0.41.2)";
+				const update = latest !== null && isNewerVersion(latest, "0.42.0") ? latest : null;
+				const nameText = "dsh-context (v0.42.0)";
 				const nameValue = [nameText];
 				if (update) nameValue.push(/* @__PURE__ */ React.createElement("span", {
 					key: "update",
@@ -5156,6 +5126,53 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/components/upgradeGate.tsx
+		/** Sessions whose gate the user already dismissed this browser session. */
+		const dismissed = /* @__PURE__ */ new Set();
+		function makeUpgradeGate(kit) {
+			const { t } = kit;
+			return function UpgradeGate(props) {
+				const sessionId = typeof props.sessionId === "string" ? props.sessionId : "";
+				const [closedFor, setClosedFor] = React.useState(null);
+				const closed = closedFor === sessionId || dismissed.has(sessionId);
+				const close = React.useCallback(() => {
+					dismissed.add(sessionId);
+					setClosedFor(sessionId);
+				}, [sessionId]);
+				React.useEffect(() => {
+					if (closed) return void 0;
+					const onKey = (ev) => {
+						if (ev.key !== "Escape") return;
+						ev.preventDefault();
+						ev.stopPropagation();
+						close();
+					};
+					window.addEventListener("keydown", onKey, true);
+					return () => {
+						window.removeEventListener("keydown", onKey, true);
+					};
+				}, [closed, close]);
+				if (closed) return null;
+				return /* @__PURE__ */ React.createElement("div", {
+					className: "lc-modal-backdrop",
+					onClick: close
+				}, /* @__PURE__ */ React.createElement("div", {
+					className: "lc-modal-card lc-gate-card",
+					onClick: (ev) => {
+						ev.stopPropagation();
+					}
+				}, /* @__PURE__ */ React.createElement("div", { className: "lc-modal-head" }, /* @__PURE__ */ React.createElement("span", { className: "lc-modal-title" }, t("gate.title")), /* @__PURE__ */ React.createElement("button", {
+					className: "lc-modal-close",
+					"aria-label": t("cmd.close"),
+					onClick: close
+				}, "×")), /* @__PURE__ */ React.createElement("div", { className: "lc-gate-body" }, t("gate.body", { minimum: props.minimum })), /* @__PURE__ */ React.createElement("div", { className: "lc-gate-versions" }, /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version" }, /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version-label" }, t("gate.current")), /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version-value" }, "v", props.current)), /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version" }, /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version-label" }, t("gate.minimum")), /* @__PURE__ */ React.createElement("span", { className: "lc-gate-version-value" }, "v", props.minimum, /* @__PURE__ */ React.createElement("span", { className: "lc-gate-or-newer" }, t("gate.orNewer"))))), /* @__PURE__ */ React.createElement("div", { className: "lc-gate-actions" }, /* @__PURE__ */ React.createElement("button", {
+					type: "button",
+					className: "lc-gate-ok",
+					onClick: close
+				}, t("gate.ok")))));
+			};
+		}
+		//#endregion
 		//#region src/client/components/requestDetail.tsx
 		function makeRequestDetail(kit, StackedBar) {
 			const { t, fmt, fmtTime, catLabel, eventLabel, eventAt } = kit;
@@ -6128,6 +6145,7 @@ window.__ModuleLoader__.load({
 			const StatsTiming = makeStatsTiming(kit, Donut);
 			const StatsTokens = makeStatsTokens(kit, Donut);
 			const PluginInfo = makePluginInfo(kit);
+			const UpgradeGate = makeUpgradeGate(kit);
 			const ContextBrowser = makeContextBrowser(kit, StackedBar);
 			const AgentGraph = makeAgentGraph(ctx, kit);
 			const ErrorBoundary = makeErrorBoundary(t);
@@ -6159,8 +6177,8 @@ window.__ModuleLoader__.load({
 					setNodeFocus(null);
 				}, []);
 				const loadImage = React.useMemo(() => imageLoaderOf(ctx, typeof sessionId === "string" ? sessionId : void 0), [ctx, sessionId]);
-				const fetchContent = React.useMemo(() => typeof sessionId === "string" && sessionId !== "" ? makeContentFetcher(ctx, sessionId) : void 0, [ctx, sessionId]);
-				const fetchHeader = React.useMemo(() => typeof sessionId === "string" && sessionId !== "" ? makeHeaderFetcher(ctx, sessionId) : void 0, [ctx, sessionId]);
+				const fetchContent = React.useMemo(() => typeof sessionId === "string" && sessionId !== "" ? makeContentFetcher(sessionId) : void 0, [sessionId]);
+				const fetchHeader = React.useMemo(() => typeof sessionId === "string" && sessionId !== "" ? makeHeaderFetcher(sessionId) : void 0, [sessionId]);
 				const rootRef = React.useRef(null);
 				const scrollerRef = React.useRef(null);
 				const restoredRef = React.useRef(null);
@@ -6302,6 +6320,7 @@ window.__ModuleLoader__.load({
 				const localeSvc = ctx.get("locale");
 				const activeLocale = localeSvc !== void 0 && typeof localeSvc.getLocale === "function" ? localeSvc.getLocale().active : "en";
 				const subtitle = (data.model ?? "") + (data.provider ? " · " + data.provider : "");
+				const gate = unsupportedOf(data.unsupported);
 				return /* @__PURE__ */ React.createElement("div", {
 					className: "lc-root",
 					ref: rootRef
@@ -6407,7 +6426,11 @@ window.__ModuleLoader__.load({
 						billed: usage !== null ? numOf(usage.uncachedInputTokens) + numOf(usage.outputTokens) + numOf(usage.cacheReadTokens) + numOf(usage.cacheWriteTokens) : null,
 						requests: requests.length
 					}
-				}), /* @__PURE__ */ React.createElement("div", { className: "lc-foot" }, t("footer")));
+				}), /* @__PURE__ */ React.createElement("div", { className: "lc-foot" }, t("footer")), gate !== null && /* @__PURE__ */ React.createElement(UpgradeGate, {
+					sessionId,
+					current: gate.current,
+					minimum: gate.minimum
+				}));
 			}
 			return function ContextView(props) {
 				return h(ErrorBoundary, null, h(ContextViewBody, props));
@@ -6419,9 +6442,8 @@ window.__ModuleLoader__.load({
 		* The assistant-message action that jumps to the Context tab at this reply's
 		* turn. Registered on the harness `conversation.chat.assistant-actions` seat
 		* (the icon row beside copy/branch), it receives the finalized reply's durable
-		* message id, resolves the matching assistant node's seq off whichever node
-		* seat the running harness serves (`useChat` on 0.1.2+, the session snapshot
-		* before it), records it in the viewFocus relay, and activates the Context
+		* message id, resolves the matching assistant node's seq off the `useChat`
+		* node seat, records it in the viewFocus relay, and activates the Context
 		* tab — where the jump pins the reply's TURN (see contextView's leg 2). An
 		* unresolvable seq still switches tabs, just without a pin; a message id that
 		* is not a plain string renders nothing at all.
@@ -6493,6 +6515,107 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/components/statsJump.tsx
+		/** The plugin's invisible dock anchor, and the class it brands the stats row with. */
+		const ANCHOR_CLASS = "lc-stats-jump";
+		const ROW_CLASS = "lc-stats-jump-row";
+		/**
+		* The stats row beside `anchor`: the single element child that is neither
+		* the anchor nor a tooltip bubble. Children are untrusted input — one that
+		* throws on attribute access is skipped whole, and two live candidates at
+		* once (another plugin's dock entry, a crash face) answer null so nothing
+		* is ever decorated on a guess.
+		*/
+		function statsRowOf(anchor) {
+			const parent = anchor.parentElement;
+			if (parent === null) return null;
+			let row = null;
+			for (const child of parent.children) {
+				try {
+					if (child === anchor || child.getAttribute("role") === "tooltip") continue;
+				} catch {
+					continue;
+				}
+				if (row !== null) return null;
+				row = child;
+			}
+			return row;
+		}
+		/**
+		* Wire the dock beside `anchor`: decorate today's stats row and re-spot it
+		* on dock churn. Returns the teardown that disconnects the observer and
+		* strips every mark the wiring left on the row.
+		*/
+		function wireDock(anchor, label, activate) {
+			if (anchor === null) return () => {};
+			let wired = null;
+			const unwire = () => {
+				wired?.off();
+				wired = null;
+			};
+			const scan = () => {
+				try {
+					const row = statsRowOf(anchor);
+					if (wired?.row === row) return;
+					unwire();
+					if (row === null || !(row instanceof HTMLElement)) return;
+					row.classList.add(ROW_CLASS);
+					row.setAttribute("role", "button");
+					row.setAttribute("tabindex", "0");
+					row.setAttribute("aria-label", label);
+					const onKey = (e) => {
+						if (e.key !== "Enter" && e.key !== " ") return;
+						e.preventDefault();
+						activate();
+					};
+					const onClick = () => {
+						const selection = anchor.ownerDocument.getSelection();
+						if (selection !== null && !selection.isCollapsed) return;
+						activate();
+					};
+					row.addEventListener("click", onClick);
+					row.addEventListener("keydown", onKey);
+					wired = {
+						row,
+						off() {
+							row.removeEventListener("click", onClick);
+							row.removeEventListener("keydown", onKey);
+							row.classList.remove(ROW_CLASS);
+							row.removeAttribute("role");
+							row.removeAttribute("tabindex");
+							row.removeAttribute("aria-label");
+						}
+					};
+				} catch {}
+			};
+			scan();
+			const parent = anchor.parentElement;
+			if (parent === null) return unwire;
+			const observer = new MutationObserver(scan);
+			observer.observe(parent, { childList: true });
+			return () => {
+				observer.disconnect();
+				unwire();
+			};
+		}
+		/** The dock entry component: the invisible anchor plus the wiring around it. */
+		function makeStatsJump(kit) {
+			const { t } = kit;
+			return function StatsJump() {
+				const anchorRef = React.useRef(null);
+				const label = t("jump.statsLine");
+				React.useEffect(() => wireDock(anchorRef.current, label, () => {
+					activateContextTab(t("tab"));
+				}), [label]);
+				return h("span", {
+					ref: anchorRef,
+					className: ANCHOR_CLASS,
+					hidden: true,
+					"aria-hidden": "true"
+				});
+			};
+		}
+		//#endregion
 		//#region src/client/viewkit.ts
 		function makeViewKit(t) {
 			const { eventLabel, eventAt } = makeEventText(t);
@@ -6531,7 +6654,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-global-css:/home/runner/work/dsh-context/dsh-context/src/client/styles/jump.css.mjs
-		const css$11 = ".lc-jump{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;transition:background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border:0;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}.lc-jump svg{width:calc(16px + var(--dsh-content-font-delta,0px));height:calc(16px + var(--dsh-content-font-delta,0px))}.lc-jump:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}";
+		const css$11 = ".lc-jump{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;transition:background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border:0;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}.lc-jump svg{width:calc(16px + var(--dsh-content-font-delta,0px));height:calc(16px + var(--dsh-content-font-delta,0px))}.lc-jump:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.lc-stats-jump{display:none}.lc-stats-jump-row{cursor:pointer}.lc-stats-jump-row:hover,.lc-stats-jump-row:focus-visible{text-decoration:underline}";
 		const tagId$11 = "dsh-context/jump.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$11) + "]") === null) {
 			const tag = document.createElement("style");
@@ -6608,7 +6731,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-global-css:/home/runner/work/dsh-context/dsh-context/src/client/styles/modal.css.mjs
-		const css$4 = ".lc-modal-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.lc-modal-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(720px,100vw - 48px);max-height:min(82vh,760px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;padding:16px 18px 18px;font-size:13px;overflow-y:auto}.lc-modal-head{align-items:baseline;gap:8px;margin-bottom:12px;display:flex}.lc-modal-title{font-size:14px;font-weight:600}.lc-modal-close{color:var(--dsw-alias-label-secondary);cursor:pointer;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border:0;border-radius:6px;margin-left:auto;padding:2px 6px;font-family:inherit;font-size:18px;line-height:1}.lc-modal-close:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-2)}";
+		const css$4 = ".lc-modal-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.lc-modal-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(720px,100vw - 48px);max-height:min(82vh,760px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;padding:16px 18px 18px;font-size:13px;overflow-y:auto}.lc-modal-head{align-items:baseline;gap:8px;margin-bottom:12px;display:flex}.lc-modal-title{font-size:14px;font-weight:600}.lc-modal-close{color:var(--dsw-alias-label-secondary);cursor:pointer;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border:0;border-radius:6px;margin-left:auto;padding:2px 6px;font-family:inherit;font-size:18px;line-height:1}.lc-modal-close:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-2)}.lc-gate-card{width:min(440px,100vw - 48px)}.lc-gate-body{color:var(--dsw-alias-label-secondary);line-height:1.7}.lc-gate-versions{gap:24px;margin-top:14px;display:flex}.lc-gate-version{flex-direction:column;gap:2px;display:flex}.lc-gate-version-label{color:var(--dsw-alias-label-secondary);font-size:11px}.lc-gate-version-value{font-weight:600;font-family:var(--dsw-font-family-mono,monospace);color:var(--dsw-alias-label-primary)}.lc-gate-or-newer{color:var(--dsw-alias-label-secondary);margin-left:6px;font-family:inherit;font-size:11px;font-weight:400}.lc-gate-actions{justify-content:flex-end;margin-top:16px;display:flex}.lc-gate-ok{cursor:pointer;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);transition:filter var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border:0;border-radius:6px;padding:6px 16px;font-family:inherit;font-size:12px}.lc-gate-ok:hover{filter:brightness(1.1)}";
 		const tagId$4 = "dsh-context/modal.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
@@ -6716,6 +6839,15 @@ window.__ModuleLoader__.load({
 					locale: NS
 				}, (props) => h(ContextJump, props));
 			});
+			const StatsJump = makeStatsJump(kit);
+			ctx.slots.inject("conversation.composer.dock", () => {
+				return ctx.slots.register({
+					name: "conversation.composer.dock",
+					id: "stats-jump",
+					order: 10,
+					locale: NS
+				}, (props) => h(StatsJump, props));
+			});
 			registerContextCommand(ctx, kit);
 			const ContextModal = makeContextModal(ctx, kit);
 			ctx.slots.inject("conversation.input.overlay", () => {

package/lib/index.d.ts

@@ -186,6 +186,17 @@ declare module '@deepseek-ai/dsh-session-projection/types' {
 type Category = 'user' | 'inject' | 'assistant' | 'tool';
 interface Snapshot {
   ok: boolean;
+  /**
+   * The host's baseline-gate record, present ONLY when the running harness
+   * is below the plugin's supported baseline: the host then folds nothing
+   * and every figure in this snapshot is zero/empty. The client keeps
+   * rendering the (blank) cards and pops the upgrade gate modal naming
+   * `current` (the detected harness version) and `minimum` (the baseline).
+   */
+  unsupported?: {
+    current: string;
+    minimum: string;
+  };
   model?: string;
   provider?: string;
   contextWindow?: number;
@@ -414,12 +425,13 @@ interface HeaderTool {
   name: string;
   tokens: number;
   /**
-   * The registering plugin's label, when attribution is known: either a
-   * `plugin` field carried by the raw header entry (harness-provided) or the
-   * host's best-effort attribution (`mcp:<server>` for MCP tools, or the
-   * pinned first-party package map). `UNKNOWN_TOOL_SOURCE` marks a tool whose
-   * provider predates the attribution hook; absent means nothing is known and
-   * the browser shows no tag.
+   * The registering plugin's label, when attribution is known: the host's
+   * best-effort attribution (`mcp:<server>` for MCP tools, or the pinned
+   * first-party package map), or a `plugin` field carried by the raw header
+   * entry — no supported-baseline harness path writes one, but the read
+   * stays defensive for foreign/newer producers. `UNKNOWN_TOOL_SOURCE` marks
+   * a tool whose provider predates the attribution hook; absent means
+   * nothing is known and the browser shows no tag.
    */
   plugin?: string;
 }

package/lib/index.js

@@ -1,9 +1,10 @@
+import { createRequire } from "node:module";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, normalize } from "node:path";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
-import z$1 from "@deepseek-ai/schemastery";
 import { deriveEventMessage } from "@deepseek-ai/dsh-session";
+import z$1 from "@deepseek-ai/schemastery";
 /**
 * Recover the MCP server display label from a proxied tool name, or undefined
 * for non-MCP names. `dsh-mcp-client` names tools `mcp__<server>__<rawName>`
@@ -30,10 +31,11 @@ function pinnedSourceOf(name) {
 }
 /**
 * Pinned first-party tool → plugin package map (see header comment). One entry
-* per model-facing name of the shipped tool packages at dsh 0.1.1-rc.2, from
-* the official tool-schema catalog; names are stable across the supported
-* harness range. Packages that mount under distinct names per composition
-* (bash/pwsh persistent variants, subagent fork) map to their primary package.
+* per model-facing name of the shipped tool packages in the official
+* tool-schema catalog of the supported dsh baseline; names are verified
+* stable across the supported harness range. Packages that mount under
+* distinct names per composition (bash/pwsh persistent variants, the
+* `subagent_fork` fixed-route alias) map to their primary package.
 */
 const FIRST_PARTY_SOURCES = Object.freeze({
 	read: "@deepseek-ai/dsh-tool-fs",
@@ -288,6 +290,70 @@ function resolveBounds(config) {
 	return Config.parse(config ?? {});
 }
 //#endregion
+//#region src/shared/version.ts
+/**
+* The harness-version gate's shared arithmetic — the supported dsh baseline
+* and the version compare behind it. Runtime code shared by BOTH halves (the
+* host probes and gates; the client displays what the wire record carries),
+* so this module must stay dependency-free.
+*
+* The baseline mirrors the support matrix (AGENTS.md "Compatibility" and the
+* package's `dsh.compatibility.dshReleases` declaration): the oldest dsh
+* release this plugin works on. A harness BELOW it gets the fallback units
+* (host/fallback.ts) instead of the real folds.
+*/
+/** The oldest supported dsh release (see the matrix note above). */
+const BASELINE_DSH_VERSION = "0.1.2-rc.1";
+/**
+* Release-channel rank at an equal X.Y.Z: a final release outranks its
+* release candidates, which outrank betas, which outrank alphas
+* (正式版 > RC > Beta > Alpha).
+*/
+function channelRank(channel) {
+	return channel === "rc" ? 3 : channel === "beta" ? 2 : 1;
+}
+const RELEASE_RANK = 4;
+/**
+* Parse `v?[major].[minor].[patch][-(alpha|beta|rc)[.N]][+build]`, or null
+* when the string is not that shape. Channels other than alpha/beta/rc
+* (nightly, dev, …) do not parse — the gate fails open on them.
+*/
+function parseVersion(version) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-(alpha|beta|rc)(?:\.(\d+))?)?(?:\+[0-9a-z.-]+)?$/i.exec(version.trim());
+	if (match === null) return null;
+	const channel = match[4]?.toLowerCase();
+	return {
+		major: Number(match[1]),
+		minor: Number(match[2]),
+		patch: Number(match[3]),
+		rank: channel === void 0 ? RELEASE_RANK : channelRank(channel),
+		serial: match[5] ? Number(match[5]) : 0
+	};
+}
+/**
+* Total order over parsed versions: X.Y.Z numerically first, then the
+* channel rank, then the prerelease serial.
+*/
+function compareParsed(a, b) {
+	if (a.major !== b.major) return a.major - b.major;
+	if (a.minor !== b.minor) return a.minor - b.minor;
+	if (a.patch !== b.patch) return a.patch - b.patch;
+	if (a.rank !== b.rank) return a.rank - b.rank;
+	return a.serial - b.serial;
+}
+/**
+* Whether `version` satisfies the supported baseline. FAIL OPEN by design: a
+* version that cannot be parsed (a dev/nightly harness build) must not blank
+* a working deployment, so it passes — the gate trips only on a proven
+* below-baseline release.
+*/
+function meetsBaseline(version, baseline = BASELINE_DSH_VERSION) {
+	const v = parseVersion(version);
+	const b = parseVersion(baseline);
+	if (v === null || b === null) return true;
+	return compareParsed(v, b) >= 0;
+}
+//#endregion
 //#region src/shared/imageTokens.ts
 /**
 * Per-image token estimate for DeepSeek's vision model — a faithful port of
@@ -622,6 +688,7 @@ const headerToolWireSchema = z.object({
 	tokens: z.number().int().nonnegative(),
 	plugin: z.string().optional()
 }).strict();
+/** Exported for the fallback unit (fallback.ts): one wire contract, one schema. */
 const contextHeadersSchema = z.object({ headers: z.array(z.object({
 	seq: z.number(),
 	time: z.number(),
@@ -696,26 +763,6 @@ function createContextHeadersDefinition(resolve) {
 	};
 }
 //#endregion
-//#region src/host/settings.ts
-/** The namespace is the join key between the Host registration and the browser card. */
-const SETTINGS_NAMESPACE = "dsh-context";
-/** Section schema: also the wire envelope the browser scope validates against. */
-const SettingsSchema = z$1.object({
-	defaultGranularity: z$1.union(["step", "turn"]).default("step"),
-	defaultTrendMode: z$1.union(["total", "delta"]).default("total").loose(),
-	defaultFileSort: z$1.union([
-		"count",
-		"latest",
-		"path"
-	]).default("count").loose()
-});
-/** Serve the namespace while a settings provider is composed; inert otherwise. */
-function installSettings(ctx) {
-	ctx.inject(["settings"], (sctx) => {
-		sctx.settings.register(SETTINGS_NAMESPACE, SettingsSchema);
-	});
-}
-//#endregion
 //#region src/host/fold.ts
 function trimToLastTurns(requests, maxTurns) {
 	let runs = 0;
@@ -921,6 +968,25 @@ function applySurface(st, ev, type, data, message) {
 	return node;
 }
 /**
+* One provider-reported usage bucket as a billed count, or null when the
+* field carries no readable number. Accepts finite numbers and numeric
+* strings; fractions round (some gateways report fractional counts) and
+* negatives clamp to 0 — a mis-accounting gateway that reports
+* `cached_tokens > prompt_tokens` drives the disjoint uncached-input figure
+* below zero, and one raw figure in the state would fail the wire and state
+* schemas' `.int().nonnegative()` gates on EVERY later delivery, permanently
+* freezing the projection feed for the session (issue #44). NaN, infinities,
+* and non-numeric values read as absent.
+*/
+function tokenCountOf(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? Math.max(0, Math.round(value)) : null;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) ? Math.max(0, Math.round(parsed)) : null;
+	}
+	return null;
+}
+/**
 * The DeepSeek V4 model family a model name prices as — matched on the NAME
 * alone (provider-agnostic: official API, proxies, OpenRouter spellings like
 * `deepseek/deepseek-v4-flash` all land here). Null for any other model:
@@ -949,7 +1015,9 @@ function isPeakUtc(time) {
 /**
 * Fold one billed request into the session-cost totals, cloning along the
 * mutated path only (the untouched branch stays shared with the persisted
-* previous state — the apply contract never mutates it in place).
+* previous state — the apply contract never mutates it in place). The
+* buckets arrive sanitized ({@link BilledUsage}), so the totals stay at the
+* schemas' non-negative safe integers no matter what the provider reported.
 */
 function accumulateCost(st, time, usage) {
 	const family = costFamilyOf(st.model);
@@ -965,13 +1033,10 @@ function accumulateCost(st, time, usage) {
 	};
 	const nextFam = { ...fam };
 	nextFam[period] = {
-		/* v8 ignore next 1 -- accumulateCost only runs under the
-		`typeof usage.inputTokens === 'number'` guard; the fallback is
-		defensive against a hand-built UsageLike. */
-		uncached: b.uncached + (usage.inputTokens ?? 0),
-		cacheRead: b.cacheRead + (usage.cacheReadTokens ?? 0),
-		cacheWrite: b.cacheWrite + (usage.cacheWriteTokens ?? 0),
-		output: b.output + (usage.outputTokens ?? 0)
+		uncached: b.uncached + usage.input,
+		cacheRead: b.cacheRead + usage.cacheRead,
+		cacheWrite: b.cacheWrite + usage.cacheWrite,
+		output: b.output + usage.output
 	};
 	const next = { ...prev };
 	next[family] = nextFam;
@@ -1194,11 +1259,22 @@ function applyTimeline(state, event, bounds) {
 				};
 				if (data && typeof data.turn === "number") record.turn = data.turn;
 				if (data && typeof data.step === "number") record.step = data.step;
-				if (usage && typeof usage.inputTokens === "number") {
-					record.prompt = usage.inputTokens + (usage.cacheReadTokens || 0) + (usage.cacheWriteTokens || 0);
-					if (typeof usage.cacheReadTokens === "number") record.cacheRead = usage.cacheReadTokens;
-					if (typeof usage.outputTokens === "number") record.output = usage.outputTokens;
-					accumulateCost(s, event.time, usage);
+				if (usage !== null && typeof usage === "object") {
+					const input = tokenCountOf(usage.inputTokens);
+					const cacheRead = tokenCountOf(usage.cacheReadTokens);
+					const cacheWrite = tokenCountOf(usage.cacheWriteTokens);
+					const output = tokenCountOf(usage.outputTokens);
+					if (input !== null || cacheRead !== null || cacheWrite !== null || output !== null) {
+						record.prompt = (input ?? 0) + (cacheRead ?? 0) + (cacheWrite ?? 0);
+						if (cacheRead !== null) record.cacheRead = cacheRead;
+						if (output !== null) record.output = output;
+						accumulateCost(s, event.time, {
+							input: input ?? 0,
+							cacheRead: cacheRead ?? 0,
+							cacheWrite: cacheWrite ?? 0,
+							output: output ?? 0
+						});
+					}
 				}
 				s.requests.push(record);
 				const timing = ensureTiming(s);
@@ -1441,8 +1517,15 @@ const timingTotalsSchema = z.object({
 	toolCalls: z.number().int().nonnegative(),
 	tools: z.record(z.string(), toolTimingSchema)
 }).strict();
+/** The baseline-gate record the fallback unit serves (see fallback.ts). */
+const unsupportedSchema = z.object({
+	current: z.string(),
+	minimum: z.string()
+}).strict();
+/** Exported for the fallback unit (fallback.ts): one wire contract, one schema. */
 const contextTimelineSchema = z.object({
 	ok: z.literal(true),
+	unsupported: unsupportedSchema.optional(),
 	model: z.string().optional(),
 	provider: z.string().optional(),
 	contextWindow: z.number().optional(),
@@ -1463,7 +1546,7 @@ const contextTimelineSchema = z.object({
 	archiveFloor: z.number().int().nonnegative().optional()
 }).strict();
 /**
-* The persisted fold-state schema (the dsh 0.1.1-rc.1+ `stateSchema`
+* The persisted fold-state schema (the registry's `stateSchema`
 * contract). Validates the plain-JSON `TimelineState` before a checkpoint
 * row seeds a fold — the same shape guarantee the projection cache's
 * plain-JSON precondition already enforces at write time.
@@ -1533,14 +1616,233 @@ function createContextTimelineDefinition(config) {
 		},
 		init: () => createTimelineState(),
 		apply: (state, event) => applyTimeline(state, event, bounds),
-		stateVersion: 12
+		stateVersion: 13
 	};
 }
 //#endregion
+//#region src/host/fallback.ts
+/**
+* The baseline gate's fallback projection units (see host/index.ts).
+*
+* On a harness below the supported baseline (shared/version.ts) the plugin
+* registers these INSTEAD of the real folds: the log's event shapes on such
+* a harness are outside the compat matrix, so nothing is parsed at all —
+* `apply` is the identity over an opaque empty state, and `view` serves a
+* fixed value whose timeline snapshot carries the gate record (`unsupported`:
+* the detected harness version and the baseline). The client's cards render
+* the blank data and its gate modal urges the upgrade; the registry pipeline
+* (fold, cache, push feed) keeps working end to end, so nothing hangs on a
+* loading screen.
+*
+* The definition carries BOTH registry contract generations: the modern
+* `stateSchema` + `wire` block (dsh 0.1.1-rc.1+, the realistic below-baseline
+* case) and the pre-0.1.1 top-level `schema` + `view` aliases that line's
+* registry reads instead. Each registry ignores the other generation's
+* fields, so one definition serves the gate on every harness that can
+* deliver projections to clients at all.
+*
+* `stateVersion` is pinned at 1. Downgrade/upgrade cache choreography: a
+* downgrade to a gated harness refolds the timeline key from scratch (no
+* ver-1 rows exist for it) and seeds the headers key from the real unit's
+* ver-1 rows — stripped to the empty state, which the gate never reads. An
+* upgrade back discards the fallback's ver-1 timeline rows and REJECTS its
+* ver-1 headers rows at the real unit's stricter state schema, refolding
+* both from the log. Nothing stale survives in either direction.
+*/
+/**
+* The opaque fold state: the gate folds nothing, so any cached row seeds it
+* (strip-mode object — never a discard, never a throw), and the plain-JSON
+* cache-write gate trivially holds.
+*/
+const fallbackStateSchema = z.object({});
+/** One gate unit: identity fold over the opaque state, constant view, both contract generations. */
+function fallbackDefinition(key, wireSchema, value) {
+	const view = () => value;
+	return {
+		key,
+		stateSchema: fallbackStateSchema,
+		init: () => ({}),
+		apply: (state) => state,
+		wire: {
+			viewSchema: wireSchema,
+			view
+		},
+		schema: wireSchema,
+		view,
+		stateVersion: 1
+	};
+}
+/**
+* The fallback `contextTimeline` unit: serves the fixed zeroed snapshot
+* naming the detected harness `current` version against the baseline.
+*/
+function createFallbackTimelineDefinition(current) {
+	return fallbackDefinition("contextTimeline", contextTimelineSchema, {
+		ok: true,
+		unsupported: {
+			current,
+			minimum: BASELINE_DSH_VERSION
+		},
+		current: {
+			system: 0,
+			tools: 0,
+			user: 0,
+			inject: 0,
+			assistant: 0,
+			tool: 0,
+			total: 0
+		},
+		requests: [],
+		events: [],
+		nodes: [],
+		droppedNodes: 0,
+		archive: []
+	});
+}
+/**
+* The fallback `contextHeaders` unit: an empty epoch list — the browser's
+* header sections degrade to their metadata-free rendering.
+*/
+function createFallbackHeadersDefinition() {
+	return fallbackDefinition("contextHeaders", contextHeadersSchema, { headers: [] });
+}
+//#endregion
+//#region src/host/settings.ts
+/** The namespace is the join key between the Host registration and the browser card. */
+const SETTINGS_NAMESPACE = "dsh-context";
+/** Section schema: also the wire envelope the browser scope validates against. */
+const SettingsSchema = z$1.object({
+	defaultGranularity: z$1.union(["step", "turn"]).default("step"),
+	defaultTrendMode: z$1.union(["total", "delta"]).default("total").loose(),
+	defaultFileSort: z$1.union([
+		"count",
+		"latest",
+		"path"
+	]).default("count").loose()
+});
+/** Serve the namespace while a settings provider is composed; inert otherwise. */
+function installSettings(ctx) {
+	ctx.inject(["settings"], (sctx) => {
+		sctx.settings.register(SETTINGS_NAMESPACE, SettingsSchema);
+	});
+}
+//#endregion
+//#region src/host/version.ts
+/**
+* Runtime harness-version probe behind the baseline gate (host/index.ts).
+*
+* The probe never imports a harness package for its version; it reads
+* manifests through Node resolution from two anchors, in order:
+*
+*  1. The harness home's healed `profiles/node_modules` mirror (located via
+*     the app-boot `dshHomePath` service) — it symlinks/proxies the running
+*     installation's dependency closure, so it names the true release even
+*     when this plugin is a `link:`-installed dev checkout.
+*  2. This module itself — in a real profile install the plugin sits inside
+*     the profile's node_modules and walk-up resolution reaches the same
+*     mirror; this anchor also covers harnesses too old to provide the home
+*     service.
+*
+* The `@deepseek-ai/dsh` CLI package is probed ONLY through the home anchor:
+* the plugin never depends on it, so a hit from the module anchor can only
+* be an ambient install above the plugin's tree (e.g. a global copy under
+* ~/node_modules) — not necessarily the RUNNING harness.
+*
+* Every step is guarded: any failure (absent service, unresolvable package,
+* unreadable/invalid manifest, non-string version) degrades to `undefined`,
+* and the gate treats an unknown version as SATISFIED — a probe misfire must
+* never blank a working deployment.
+*/
+/**
+* Library packages whose manifest version IS the harness release version
+* (the dsh monorepo versions every package in lockstep). From the plugin's
+* own tree they resolve to its pinned devDependencies in dev and to the
+* healed profiles mirror in real installs — both correct — so they are safe
+* to probe from either anchor.
+*/
+const LIBRARY_PROBE_PACKAGES = ["@deepseek-ai/dsh-session-projection", "@deepseek-ai/dsh-session"];
+/** Home-anchor probe order: the user-facing CLI version first, then the libraries. */
+const HOME_PROBE_PACKAGES = ["@deepseek-ai/dsh", ...LIBRARY_PROBE_PACKAGES];
+/** One manifest's `version`, or undefined on any read/shape failure. */
+function versionOfManifest(manifestPath, expectedName) {
+	try {
+		const parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+		if (parsed === null || typeof parsed !== "object") return void 0;
+		const record = parsed;
+		if (expectedName !== void 0 && record.name !== expectedName) return void 0;
+		return typeof record.version === "string" && record.version !== "" ? record.version : void 0;
+	} catch {
+		return;
+	}
+}
+/** Probe the package's published `./package.json` subpath. */
+function versionViaManifest(resolve, packageName) {
+	try {
+		return versionOfManifest(resolve(packageName + "/package.json"));
+	} catch {
+		return;
+	}
+}
+/**
+* Probe via the package's entry point, ascending to its owning manifest.
+* Covers the packaged-executable module proxies: their generated manifests
+* carry the real version but export only entry stubs, and Node's exports
+* gate refuses the direct `./package.json` subpath.
+*/
+function versionViaEntry(resolve, packageName) {
+	let dir;
+	try {
+		dir = dirname(resolve(packageName));
+	} catch {
+		return;
+	}
+	for (;;) {
+		const version = versionOfManifest(join(dir, "package.json"), packageName);
+		if (version !== void 0) return version;
+		const parent = dirname(dir);
+		if (parent === dir) return void 0;
+		dir = parent;
+	}
+}
+/** One anchor's answer: the first probe package that yields a version. */
+function probeAnchor(resolve, packageNames) {
+	for (const packageName of packageNames) {
+		const version = versionViaManifest(resolve, packageName) ?? versionViaEntry(resolve, packageName);
+		if (version !== void 0) return version;
+	}
+}
+/**
+* The running harness's version string, or undefined when nothing answers
+* (the gate fails open on it — see the header note).
+* @param selfUrl - the module anchor (injectable for hermetic tests).
+*/
+function detectHarnessVersion(ctx, selfUrl = import.meta.url) {
+	try {
+		const homePath = ctx.get("dshHomePath");
+		if (typeof homePath === "function") {
+			const req = createRequire(homePath("profiles", "dsh-context-version-probe.cjs"));
+			const home = probeAnchor((specifier) => req.resolve(specifier), HOME_PROBE_PACKAGES);
+			if (home !== void 0) return home;
+		}
+	} catch {}
+	try {
+		const req = createRequire(selfUrl);
+		return probeAnchor((specifier) => req.resolve(specifier), LIBRARY_PROBE_PACKAGES);
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region src/host/index.ts
 const name = "dsh-context";
 const inject = ["sessionProjections"];
 function apply(ctx, config) {
+	const harnessVersion = detectHarnessVersion(ctx);
+	if (harnessVersion !== void 0 && !meetsBaseline(harnessVersion)) {
+		ctx.sessionProjections.register(createFallbackTimelineDefinition(harnessVersion));
+		ctx.sessionProjections.register(createFallbackHeadersDefinition());
+		return;
+	}
 	const attribution = createToolAttribution(ctx);
 	ctx.sessionProjections.register(createContextTimelineDefinition(config));
 	ctx.sessionProjections.register(createContextHeadersDefinition((name) => attribution.ownerOf(name)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context",
-  "version": "0.41.2",
+  "version": "0.42.0",
   "description": "A DeepSeek Harness plugin for context insight and management, with context dashboard and context command, for understanding how the context is made of, and how it evolves.",
   "author": "bowenliang123",
   "repository": {
@@ -62,11 +62,6 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.1.1-rc.2": "compatible",
-        "0.1.2-alpha.2": "compatible",
-        "0.1.2-alpha.3": "compatible",
-        "0.1.2-alpha.4": "compatible",
-        "0.1.2-alpha.5": "compatible",
         "0.1.2-rc.1": "compatible"
       }
     }
@@ -85,11 +80,11 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.3.1"
   },
   "peerDependenciesMeta": {
@@ -101,12 +96,14 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/node": "^26.2.0",
     "@types/react": "^18.3.31",