dsh-context 0.53.3 → 0.54.0

package/lib/client.js

@@ -105,7 +105,7 @@ window.__ModuleLoader__.load({
 			"brief.more": "+{n}",
 			"brief.noInputs": "（无新增）",
 			"brief.locate": "在上下文浏览器中查看",
-			"jump.title": "在上下文标签页中查看此轮",
+			"jump.title": "在上下文视图中查看此轮",
 			"brief.turnTip": "这一轮开场时用户发送的消息；回合内的每一步都会回显同一条",
 			"brief.inputTip": "上一步回复之后、本次请求发出前新进入上下文的内容——通常是上一步所调工具的结果；每轮的第一步无新增",
 			"brief.replyTip": "这一步模型返回的内容（文本回复或工具调用）；此步发起的调用，其结果会出现在下一柱的「输入」行",
@@ -329,6 +329,10 @@ window.__ModuleLoader__.load({
 			"ov.kpi.sessionsSub": "含 {n} 个会话",
 			"ov.kpi.toolSub": "工具执行 {dur}",
 			"ov.kpi.wallSub": "模型调用 {n}",
+			"balance.title": "DeepSeek 余额",
+			"balance.tip.total": "总余额",
+			"balance.tip.granted": "赠送余额",
+			"balance.tip.toppedUp": "充值余额",
 			"ov.heat.title": "活跃度",
 			"ov.heat.sub": "按日期筛选",
 			"ov.heat.empty": "暂无活跃数据 — 会话产生模型请求后，这里会显示每日用量",
@@ -471,7 +475,7 @@ window.__ModuleLoader__.load({
 			"brief.more": "+{n}",
 			"brief.noInputs": "(nothing new)",
 			"brief.locate": "Reveal in Context Browser",
-			"jump.title": "View this turn in the Context tab",
+			"jump.title": "View this turn in the Context view",
 			"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",
@@ -695,6 +699,10 @@ window.__ModuleLoader__.load({
 			"ov.kpi.sessionsSub": "across {n} sessions",
 			"ov.kpi.toolSub": "tool runs {dur}",
 			"ov.kpi.wallSub": "{n} model calls",
+			"balance.title": "DeepSeek balance",
+			"balance.tip.total": "Total balance",
+			"balance.tip.granted": "Granted balance",
+			"balance.tip.toppedUp": "Topped-up balance",
 			"ov.heat.title": "Activity",
 			"ov.heat.sub": "Filter by date",
 			"ov.heat.empty": "No activity yet — daily usage appears once sessions make model requests",
@@ -5069,6 +5077,7 @@ window.__ModuleLoader__.load({
 				} : void 0;
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "lc-card",
+					"data-lc-current": true,
 					children: [
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "lc-card-title",
@@ -5383,19 +5392,19 @@ window.__ModuleLoader__.load({
 		//#region src/client/cost.ts
 		/** 1 CNY = 0.15 USD — the fixed CNY-display conversion rate. */
 		const USD_PER_CNY = .15;
-		/** Off-peak DeepSeek rates are half the peak rates (the official list). */
-		const OFF_PEAK_FACTOR = .5;
+		/** DeepSeek's peak rates are twice the off-peak rates (the official list). */
+		const PEAK_FACTOR = 2;
 		/** A USD amount in the display currency (CNY divides the fixed rate). */
 		function toCurrency(usd, currency) {
 			return currency === "cny" ? usd / USD_PER_CNY : usd;
 		}
-		/** One rate triple at the half-price off-peak rate (the tooltip's `peak | off` pair). */
-		function offPeakOf(rate) {
+		/** One rate triple at the doubled peak rate (the tooltip's `peak | off` pair). */
+		function peakOf(rate) {
 			return {
-				hit: rate.hit * OFF_PEAK_FACTOR,
-				miss: rate.miss * OFF_PEAK_FACTOR,
-				write: rate.write * OFF_PEAK_FACTOR,
-				out: rate.out * OFF_PEAK_FACTOR
+				hit: rate.hit * PEAK_FACTOR,
+				miss: rate.miss * PEAK_FACTOR,
+				write: rate.write * PEAK_FACTOR,
+				out: rate.out * PEAK_FACTOR
 			};
 		}
 		/** One book branch (a provider's models), as far as runtime can prove it. */
@@ -5448,8 +5457,9 @@ window.__ModuleLoader__.load({
 		/**
 		* Price the session's cumulative billed-token totals. Cache reads bill at
 		* the hit rate, uncached input at the miss rate, cache writes at the write
-		* rate, output (reasoning included) at the out rate; `off` buckets (the
-		* Host splits DeepSeek's period-based list at fold time) price at half.
+		* rate, output (reasoning included) at the out rate; `peak` buckets price
+		* at twice the book rate for DeepSeek (the book lists that provider's
+		* off-peak rates — the Host splits the period-based list at fold time).
 		* Null when nothing was priced (no usage folded, no book yet, or no model
 		* the book prices), so the cell can show a dash.
 		*/
@@ -5460,7 +5470,7 @@ window.__ModuleLoader__.load({
 			for (const provider of Object.keys(usage)) {
 				const models = asRecord(usage[provider]);
 				if (models === null) continue;
-				const offPeak = isDeepSeekProvider(provider);
+				const deepseek = isDeepSeekProvider(provider);
 				for (const model of Object.keys(models)) {
 					const rate = priceOf(prices, provider, model);
 					const periods = asRecord(models[model]);
@@ -5469,7 +5479,7 @@ window.__ModuleLoader__.load({
 						const bucket = asRecord(periods[period]);
 						if (bucket === null) continue;
 						const price = (numOf(bucket.cacheRead) * rate.hit + numOf(bucket.uncached) * rate.miss + numOf(bucket.cacheWrite) * rate.write + numOf(bucket.output) * rate.out) / 1e6;
-						total += offPeak && period === "off" ? price * OFF_PEAK_FACTOR : price;
+						total += deepseek && period === "peak" ? price * PEAK_FACTOR : price;
 						any = true;
 					}
 				}
@@ -6197,6 +6207,141 @@ window.__ModuleLoader__.load({
 			return t("ov.time.d", { n: Math.floor(hours / 24) });
 		}
 		//#endregion
+		//#region src/client/balance.ts
+		const BALANCE_ROUTE = "/api/dsh-context/balance";
+		/** How long a settled answer (including a `null`) serves identical reads. */
+		const TTL_MS$1 = 6e4;
+		/** One platform amount ('110.00', or an already-numeric producer variant), or null. */
+		function amountOf(value) {
+			const n = typeof value === "string" ? Number(value) : value;
+			return typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : null;
+		}
+		/**
+		* Narrow the delivered payload to a render-safe value (the same boundary
+		* rigor as `timelineOf`): each entry's currency and amounts re-proved, an
+		* entry failing the shape drops whole, and a payload with no valid entry is
+		* no balance — the caller renders nothing rather than half a figure.
+		*/
+		function platformBalanceOf(value) {
+			const data = asRecord(value);
+			if (data === null) return null;
+			const infos = Array.isArray(data.balances) ? data.balances : [];
+			const balances = [];
+			for (const info of infos) try {
+				const entry = asRecord(info);
+				if (entry === null) continue;
+				const currency = entry.currency;
+				const total = amountOf(entry.total);
+				const granted = amountOf(entry.granted);
+				const toppedUp = amountOf(entry.toppedUp);
+				if (typeof currency !== "string" || currency === "" || total === null || granted === null || toppedUp === null) continue;
+				balances.push({
+					currency,
+					total,
+					granted,
+					toppedUp
+				});
+			} catch {
+				continue;
+			}
+			return balances.length > 0 ? {
+				isAvailable: data.isAvailable === true,
+				balances
+			} : null;
+		}
+		/**
+		* The entry matching the display currency (zh → CNY, en → USD), falling back
+		* to the account's first entry when the platform reports none in it — a
+		* number in the account's own currency beats no number.
+		*/
+		function balanceEntryOf(balance, currency) {
+			if (balance === null || balance === void 0 || balance.balances.length === 0) return null;
+			const want = currency === "cny" ? "CNY" : "USD";
+			return balance.balances.find((entry) => entry.currency === want) ?? balance.balances[0];
+		}
+		let cached$1 = null;
+		/**
+		* The capsule's read: one route POST, narrowed through
+		* `platformBalanceOf`, deduplicated in flight, TTL-cached. Never rejects.
+		*/
+		function fetchPlatformBalance() {
+			if (cached$1 !== null && Date.now() - cached$1.at < TTL_MS$1) return cached$1.promise;
+			const at = Date.now();
+			const promise = (async () => {
+				try {
+					const response = await fetch(BALANCE_ROUTE, {
+						method: "POST",
+						headers: { "content-type": "application/json" }
+					});
+					if (!response.ok) return null;
+					const r = asRecord(await response.json());
+					if (r === null || r.ok !== true || r.value === null || r.value === void 0) return null;
+					return platformBalanceOf(r.value);
+				} catch {
+					return null;
+				}
+			})();
+			cached$1 = {
+				at,
+				promise
+			};
+			return promise;
+		}
+		//#endregion
+		//#region src/client/components/balanceCapsule.tsx
+		/**
+		* BalanceCapsule — the DeepSeek open-platform balance pill in the Context
+		* Dashboard's header (the plugin's one account-level figure, beside the
+		* session-level ones). Mounted only by the dashboard header; it reads the
+		* plugin's balance route once per open through client/balance.ts and renders
+		* NOTHING while the read is pending, absent, or failed — the pill exists
+		* only when there is a live figure to show. The tooltip carries the
+		* breakdown (total / granted / topped-up) in the entry's own currency; the
+		* entry follows the active locale (zh → CNY) with the account's first
+		* currency as the fallback.
+		*/
+		/** The symbol prefix for the currencies the platform serves; others show their code. */
+		function symbolOf(currency) {
+			if (currency === "CNY") return "¥";
+			if (currency === "USD") return "$";
+			return currency + " ";
+		}
+		function makeBalanceCapsule(ctx, kit) {
+			const { t } = kit;
+			return function BalanceCapsule() {
+				const [balance, setBalance] = (0, react.useState)(null);
+				(0, react.useEffect)(() => {
+					let on = true;
+					fetchPlatformBalance().then((v) => {
+						if (on) setBalance(v);
+					});
+					return () => {
+						on = false;
+					};
+				}, []);
+				const locale = ctx.locale;
+				const entry = balanceEntryOf(balance, (typeof locale.getLocale === "function" ? locale.getLocale().active : "en") === "zh" ? "cny" : "usd");
+				if (entry === null) return null;
+				const money = (amount) => symbolOf(entry.currency) + amount.toFixed(2);
+				const tip = [
+					t("balance.tip.total") + ": " + money(entry.total),
+					t("balance.tip.granted") + ": " + money(entry.granted),
+					t("balance.tip.toppedUp") + ": " + money(entry.toppedUp)
+				].join("\n");
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: "lc-ov-balance",
+					title: tip,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "lc-ov-balance-label",
+						children: t("balance.title")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "lc-ov-balance-value",
+						children: money(entry.total)
+					})]
+				});
+			};
+		}
+		//#endregion
 		//#region src/shared/days.ts
 		/**
 		* The local-day key (`YYYY-MM-DD`) shared by the activity fold (host) and the
@@ -6658,6 +6803,7 @@ window.__ModuleLoader__.load({
 			const { t, fmtDuration } = kit;
 			const Heatmap = makeHeatmap(kit);
 			const OverviewCard = makeOverviewCard(kit);
+			const BalanceCapsule = makeBalanceCapsule(ctx, kit);
 			const ErrorBoundary = makeErrorBoundary(t);
 			/** The display currency follows the active locale (zh → CNY), read per render — the slot outlet re-renders on a locale switch. */
 			function activeCurrency() {
@@ -6742,6 +6888,7 @@ window.__ModuleLoader__.load({
 									className: "lc-ov-title",
 									children: t("ov.title")
 								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(BalanceCapsule, {}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "lc-gran lc-ov-range",
 									role: "group",
@@ -9492,7 +9639,7 @@ window.__ModuleLoader__.load({
 			return function PluginInfo() {
 				const [latest, setLatest] = (0, react.useState)(null);
 				(0, react.useEffect)(() => {
-					if ("0.53.3".includes("-dev")) return;
+					if ("0.54.0".includes("-dev")) return;
 					let on = true;
 					fetchLatestVersion().then((v) => {
 						if (on && v) setLatest(v);
@@ -9501,8 +9648,8 @@ window.__ModuleLoader__.load({
 						on = false;
 					};
 				}, []);
-				const update = latest !== null && isNewerVersion(latest, "0.53.3") ? latest : null;
-				const nameText = "dsh-context (v0.53.3)";
+				const update = latest !== null && isNewerVersion(latest, "0.54.0") ? latest : null;
+				const nameText = "dsh-context (v0.54.0)";
 				const nameValue = [nameText];
 				if (update) nameValue.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 					className: "lc-pi-update",
@@ -9986,12 +10133,13 @@ window.__ModuleLoader__.load({
 					const rate = priceOf(prices, provider, model);
 					if (rate === null) continue;
 					const periods = asRecord(models[model]);
-					const off = isDeepSeekProvider(provider) && periods !== null && periods.off !== void 0 ? offPeakOf(rate) : void 0;
+					const deepseek = isDeepSeekProvider(provider);
+					const billedOff = deepseek && periods !== null && periods.off !== void 0;
 					rows.push({
 						key: provider + "/" + model,
 						label: multi && provider !== "" ? `${model} · ${provider}` : model,
-						rate,
-						...off !== void 0 ? { offRate: off } : {}
+						rate: deepseek ? peakOf(rate) : rate,
+						...billedOff ? { offRate: rate } : {}
 					});
 				}
 			}
@@ -10438,17 +10586,130 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/sidebar.ts
+		/**
+		* The right Sidebar's Context tab (dsh 0.1.5-rc.1+).
+		*
+		* The tab reuses the Context conversation-view component VERBATIM: the
+		* `sidebar.right.pane.tab` seat is session-scoped and delivers the same
+		* framework standard kit (`sessionId`, `useProjection`, `useChat`, the locale
+		* `t` seat) the `conversation.view` seat does, so the panel and the tab are
+		* one component with one data path. The tab type contributes a guide entry, so
+		* the sidebar's guide page offers "Context" and picking it opens the panel —
+		* the product's own path, exactly as the shipped Files type does: a capsule of
+		* glyph, title, and description line, plus the chip-title seat that puts the
+		* same glyph beside the label once the tab is open (`icon.tsx`).
+		*
+		* OPTIONAL BY CONTRACT. `ctx.sidebarRightTabs` and the seat ship only on the
+		* 0.1.5 line (0.1.5-rc.1+ supported); the registration therefore rides a
+		* DEFERRED inject (the plugin's hard injects stay `slots` + `locale`), so on
+		* every older supported line the callback never fires, the plugin fiber never
+		* pends, and nothing is registered. The registry is re-proved structurally and
+		* the whole registration is guarded: a foreign or hostile registry (a throwing
+		* `register`, a taken id/kind) leaves the sidebar without the tab instead of
+		* taking the browser down.
+		*
+		* @module dsh-context/client/sidebar
+		*/
+		/** The tab type's identity in the sidebar's tab system (also its body-seat key). */
+		const SIDEBAR_CONTEXT_ID = "dsh-context";
+		/**
+		* The kind `openTab` names. Namespaced rather than the bare `context`: the
+		* registry THROWS when a kind collides with another registration in a
+		* non-coexisting band, and a foreign plugin may well own `context`.
+		*/
+		const SIDEBAR_CONTEXT_KIND = "dsh-context";
+		/** The guide capsule's position: after the shipped Files entry (order 10). */
+		const GUIDE_ORDER = 20;
+		/**
+		* Register the Context tab type, its body, and its chip title on the right
+		* Sidebar, if — and only if — this harness serves the sidebar tab registry.
+		* @param ctx - client root context carrying `slots` and the locale service.
+		* @param view - the Context view component factory result (the same one the
+		*   conversation tab mounts).
+		* @param t - the plugin-namespace translate; the label thunks read the active
+		*   locale at call time, so a language switch relabels the guide entry.
+		* @param ns - the plugin's locale namespace, put on the body registration so
+		*   the framework synthesizes the `t` seat for the panel too.
+		* @returns the deferred inject's disposer (placement toggling calls it to
+		*   take the mount down; a no-op on faces that return no handle).
+		*/
+		function watchSidebarContextTab(ctx, view, t, ns) {
+			const handle = ctx.inject(["sidebarRightTabs"], (raw) => {
+				const injected = raw;
+				const disposers = [];
+				const own = (result) => {
+					if (typeof result === "function") disposers.push(result);
+				};
+				try {
+					const tabs = injected.sidebarRightTabs;
+					if (tabs === void 0 || typeof tabs.register !== "function") return;
+					own(tabs.register({
+						id: SIDEBAR_CONTEXT_ID,
+						kind: SIDEBAR_CONTEXT_KIND,
+						title: () => t("tab"),
+						guide: [{
+							order: GUIDE_ORDER,
+							title: () => t("tab"),
+							description: () => t("sidebar.guideDescription"),
+							icon: ContextIcon
+						}]
+					}));
+					own(injected.slots.inject("sidebar.right.pane.tab", () => injected.slots.register({
+						name: "sidebar.right.pane.tab",
+						key: SIDEBAR_CONTEXT_ID,
+						locale: ns
+					}, (props) => view({
+						...props,
+						host: "sidebar"
+					}))));
+					own(injected.slots.inject("sidebar.right.pane.tab.title", () => injected.slots.register({
+						name: "sidebar.right.pane.tab.title",
+						key: SIDEBAR_CONTEXT_ID
+					}, makeContextTabTitle(t))));
+				} catch {
+					for (const dispose of disposers) dispose();
+					return;
+				}
+				return () => {
+					for (const dispose of disposers) dispose();
+				};
+			});
+			return () => {
+				handle?.dispose?.();
+			};
+		}
+		//#endregion
 		//#region src/client/viewFocus.ts
 		/**
 		* Chat → Context jump relay. The assistant-message action records the clicked
-		* reply's request seq here and activates the Context tab; the Context view
+		* reply's request seq here and opens the Context view — the right Sidebar's
+		* tab when this harness serves one, else the conversation tab; the view
 		* consumes the one-shot focus once its projection data is in. Module-level
 		* per-session map — the same life pattern as the modal open-state stores.
 		*/
 		const pendingFocus = /* @__PURE__ */ new Map();
-		/** Record the Context step (request seq) to reveal for `sessionId` — replaces any unconsumed request. */
+		/** The mounted Context views re-pinning on later records (repeat jumps). */
+		const focusListeners = /* @__PURE__ */ new Set();
+		/**
+		* Record the Context step (request seq) to reveal for `sessionId` — replaces
+		* any unconsumed request and wakes the mounted views.
+		*/
 		function requestContextFocus(sessionId, seq) {
 			pendingFocus.set(sessionId, seq);
+			for (const listener of focusListeners) listener();
+		}
+		/**
+		* Wake on every record while subscribed: a Context view that is already
+		* mounted (the sidebar landing keeps it mounted across jumps) re-pins when a
+		* record lands — the listener takes its OWN session's entry, so other
+		* sessions' records leave their entries pending for their views.
+		*/
+		function subscribeContextFocus(listener) {
+			focusListeners.add(listener);
+			return () => {
+				focusListeners.delete(listener);
+			};
 		}
 		/** Take the pending focus request, if any — one-shot, the map entry is consumed. */
 		function takeContextFocus(sessionId) {
@@ -10458,6 +10719,24 @@ window.__ModuleLoader__.load({
 			return seq;
 		}
 		/**
+		* Open the Context tab on the right Sidebar over `ctx.sidebarRight.openTab`
+		* (the column expands in the same step). OPTIONAL seam, re-proved at call
+		* time: a harness without the service (every line older than 0.1.5-rc.1), a
+		* placement that registered no tab type, no mounted session surface, or a
+		* hostile face all report false so the caller keeps its conversation-tab
+		* fallback.
+		*/
+		function openContextSidebar(ctx) {
+			try {
+				const face = asRecord(ctx.get("sidebarRight"));
+				if (face === null || typeof face.openTab !== "function") return false;
+				face.openTab.call(face, SIDEBAR_CONTEXT_KIND);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+		/**
 		* Activate the Context tab by clicking its own tab-bar button (the semantic
 		* `button[role="tab"]` chrome the conversation shell renders for every view).
 		* The harness hands `openView` only to the ACTIVE view entry, so a nested
@@ -10475,6 +10754,33 @@ window.__ModuleLoader__.load({
 			return false;
 		}
 		//#endregion
+		//#region src/client/revealScroll.ts
+		/**
+		* Scroll an element's nearest scrollable ancestor so the element tops that
+		* scrollport. The jump's landing reveal needs this host-agnostic: the
+		* conversation tab scrolls the shared `[data-conversation-scroll]` container
+		* while the right Sidebar scrolls dockkit's pane body (a CSS-module class,
+		* no stable attribute of its own), so the walk takes whichever ancestor
+		* actually scrolls — the rect delta lands the anchor flush regardless of the
+		* container's current position. `document.body` ends the walk: the page
+		* itself never scrolls. False — never a throw — when no ancestor scrolls (the
+		* layout already shows the element) or the chain turns hostile.
+		*
+		* @module dsh-context/client/revealScroll
+		*/
+		function revealInScrollParent(anchor) {
+			try {
+				for (let el = anchor.parentElement; el !== null && el !== document.body; el = el.parentElement) {
+					const oy = window.getComputedStyle(el).overflowY;
+					if (oy === "auto" || oy === "scroll") {
+						el.scrollTop += anchor.getBoundingClientRect().top - el.getBoundingClientRect().top;
+						return true;
+					}
+				}
+			} catch {}
+			return false;
+		}
+		//#endregion
 		//#region src/client/components/contextView.tsx
 		/**
 		* Context tab root: renders the `contextTimeline` projection and composes stats, composition, history, events and messages.
@@ -10580,8 +10886,12 @@ window.__ModuleLoader__.load({
 				const markers = (0, react.useMemo)(() => attachMarkers(displayRequests, events), [displayRequests, events]);
 				(0, react.useEffect)(() => {
 					if (typeof sessionId !== "string" || sessionId === "") return;
-					const seq = takeContextFocus(sessionId);
-					if (seq !== null) setJumpSeq(seq);
+					const take = () => {
+						const seq = takeContextFocus(sessionId);
+						if (seq !== null) setJumpSeq(seq);
+					};
+					take();
+					return subscribeContextFocus(take);
 				}, [sessionId]);
 				const detailReady = source.detailState === "ready" || source.detailState === "legacy";
 				(0, react.useEffect)(() => {
@@ -10592,7 +10902,10 @@ window.__ModuleLoader__.load({
 					setGranularity("turn");
 					setSelectedSeq(target.seq);
 					setFocusTurn(target.turn ?? 0);
-					if (scrollerRef.current !== null) scrollerRef.current.scrollTop = 0;
+					/* v8 ignore next 2 -- the effect only fires while mounted, and both render paths attach
+					rootRef and render the composition card. */
+					const anchor = rootRef.current?.querySelector("[data-lc-current]") ?? null;
+					if (anchor !== null) revealInScrollParent(anchor);
 				}, [
 					jumpSeq,
 					data,
@@ -10954,14 +11267,18 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/components/contextJump.tsx
 		/**
-		* The assistant-message action that jumps to the Context tab at this reply's
+		* The assistant-message action that opens the Context view 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 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.
+		* node seat AT RENDER TIME (the seat is a real React hook — render-only; a
+		* click-time read throws the dispatcher guard and the jump would land
+		* unpinned), records it in the viewFocus relay on click, and opens the
+		* Context tab on the right Sidebar — where the jump pins the reply's TURN
+		* (see contextView's leg 2). A harness or placement without the sidebar tab
+		* falls back to the conversation tab; an unresolvable seq still opens the
+		* view, just without a pin; a message id that is not a plain string renders
+		* nothing at all.
 		*/
 		/**
 		* The reply's request seq by its durable message id, or null when no served node proves the pair. Join/log nodes are untrusted input: each
@@ -11012,16 +11329,17 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		function makeContextJumpButton(kit) {
+		function makeContextJumpButton(ctx, kit) {
 			const { t } = kit;
 			return function ContextJump(props) {
+				const nodes = conversationNodesOf(props);
 				const messageId = props.messageId;
 				if (typeof messageId !== "string" || messageId === "") return null;
+				const seq = seqOfMessageId(nodes, messageId);
 				const jump = () => {
-					const seq = seqOfMessageId(conversationNodesOf(props), messageId);
 					const sessionId = props.sessionId;
 					if (seq !== null && typeof sessionId === "string" && sessionId !== "") requestContextFocus(sessionId, seq);
-					activateContextTab(t("tab"));
+					if (!openContextSidebar(ctx)) activateContextTab(t("tab"));
 				};
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 					label: t("jump.title"),
@@ -11073,100 +11391,6 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region src/client/sidebar.ts
-		/**
-		* The right Sidebar's Context tab (dsh 0.1.5-rc.1+).
-		*
-		* The tab reuses the Context conversation-view component VERBATIM: the
-		* `sidebar.right.pane.tab` seat is session-scoped and delivers the same
-		* framework standard kit (`sessionId`, `useProjection`, `useChat`, the locale
-		* `t` seat) the `conversation.view` seat does, so the panel and the tab are
-		* one component with one data path. The tab type contributes a guide entry, so
-		* the sidebar's guide page offers "Context" and picking it opens the panel —
-		* the product's own path, exactly as the shipped Files type does: a capsule of
-		* glyph, title, and description line, plus the chip-title seat that puts the
-		* same glyph beside the label once the tab is open (`icon.tsx`).
-		*
-		* OPTIONAL BY CONTRACT. `ctx.sidebarRightTabs` and the seat ship only on the
-		* 0.1.5 line (0.1.5-rc.1+ supported); the registration therefore rides a
-		* DEFERRED inject (the plugin's hard injects stay `slots` + `locale`), so on
-		* every older supported line the callback never fires, the plugin fiber never
-		* pends, and nothing is registered. The registry is re-proved structurally and
-		* the whole registration is guarded: a foreign or hostile registry (a throwing
-		* `register`, a taken id/kind) leaves the sidebar without the tab instead of
-		* taking the browser down.
-		*
-		* @module dsh-context/client/sidebar
-		*/
-		/** The tab type's identity in the sidebar's tab system (also its body-seat key). */
-		const SIDEBAR_CONTEXT_ID = "dsh-context";
-		/**
-		* The kind `openTab` names. Namespaced rather than the bare `context`: the
-		* registry THROWS when a kind collides with another registration in a
-		* non-coexisting band, and a foreign plugin may well own `context`.
-		*/
-		const SIDEBAR_CONTEXT_KIND = "dsh-context";
-		/** The guide capsule's position: after the shipped Files entry (order 10). */
-		const GUIDE_ORDER = 20;
-		/**
-		* Register the Context tab type, its body, and its chip title on the right
-		* Sidebar, if — and only if — this harness serves the sidebar tab registry.
-		* @param ctx - client root context carrying `slots` and the locale service.
-		* @param view - the Context view component factory result (the same one the
-		*   conversation tab mounts).
-		* @param t - the plugin-namespace translate; the label thunks read the active
-		*   locale at call time, so a language switch relabels the guide entry.
-		* @param ns - the plugin's locale namespace, put on the body registration so
-		*   the framework synthesizes the `t` seat for the panel too.
-		* @returns the deferred inject's disposer (placement toggling calls it to
-		*   take the mount down; a no-op on faces that return no handle).
-		*/
-		function watchSidebarContextTab(ctx, view, t, ns) {
-			const handle = ctx.inject(["sidebarRightTabs"], (raw) => {
-				const injected = raw;
-				const disposers = [];
-				const own = (result) => {
-					if (typeof result === "function") disposers.push(result);
-				};
-				try {
-					const tabs = injected.sidebarRightTabs;
-					if (tabs === void 0 || typeof tabs.register !== "function") return;
-					own(tabs.register({
-						id: SIDEBAR_CONTEXT_ID,
-						kind: SIDEBAR_CONTEXT_KIND,
-						title: () => t("tab"),
-						guide: [{
-							order: GUIDE_ORDER,
-							title: () => t("tab"),
-							description: () => t("sidebar.guideDescription"),
-							icon: ContextIcon
-						}]
-					}));
-					own(injected.slots.inject("sidebar.right.pane.tab", () => injected.slots.register({
-						name: "sidebar.right.pane.tab",
-						key: SIDEBAR_CONTEXT_ID,
-						locale: ns
-					}, (props) => view({
-						...props,
-						host: "sidebar"
-					}))));
-					own(injected.slots.inject("sidebar.right.pane.tab.title", () => injected.slots.register({
-						name: "sidebar.right.pane.tab.title",
-						key: SIDEBAR_CONTEXT_ID
-					}, makeContextTabTitle(t))));
-				} catch {
-					for (const dispose of disposers) dispose();
-					return;
-				}
-				return () => {
-					for (const dispose of disposers) dispose();
-				};
-			});
-			return () => {
-				handle?.dispose?.();
-			};
-		}
-		//#endregion
 		//#region src/client/viewkit.ts
 		function makeViewKit(t) {
 			const { eventLabel, eventAt } = makeEventText(t);
@@ -11348,7 +11572,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-global-css:/home/runner/work/dsh-context/dsh-context/src/client/styles/overview.css.mjs
-		const css = ".lc-ov-entry{box-sizing:border-box;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:8px;margin:0 -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.lc-ov-entry:hover{background:var(--dsw-alias-interactive-bg-hover)}.lc-ov-entry-rail{border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.lc-ov-entry-icon{flex:none}.lc-ov-entry-label{text-align:left;white-space:nowrap;text-overflow:ellipsis;flex:auto;min-width:0;overflow:hidden}.lc-ov-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0;container:lc-ov/inline-size}.lc-ov-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(1120px,100vw - 32px);max-height:min(86vh,900px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:16px 18px 18px;font-size:13px;display:flex;overflow:hidden}.lc-ov-head{flex-wrap:wrap;flex:none;align-items:center;gap:10px;margin-bottom:14px;display:flex}.lc-ov-head-icon{flex:none}.lc-ov-title{white-space:nowrap;font-size:15px;font-weight:600}.lc-ov-head .lc-modal-close{flex:none;margin-left:0}.lc-ov-body{flex:auto;grid-template-columns:minmax(0,3fr) minmax(0,7fr);gap:10px;min-height:0;display:grid}.lc-ov-left{scrollbar-gutter:stable;flex-direction:column;gap:10px;min-height:0;padding-right:8px;display:flex;overflow-y:auto}.lc-ov-right{scrollbar-gutter:stable;min-height:0;padding-right:8px;overflow-y:auto}@container lc-ov (width<=932px){.lc-ov-card{overflow-y:auto}.lc-ov-body{display:block}.lc-ov-left{margin-bottom:12px}.lc-ov-left,.lc-ov-right{min-height:auto;padding-right:0;overflow:visible}.lc-ov-heat-card{flex:none}}.lc-ov-left>.lc-card{box-sizing:border-box;min-width:0;margin-bottom:0}.lc-ov-kpis{flex:none;grid-template-rows:repeat(3,1fr);grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;display:grid}.lc-ov-kpi{align-items:center;padding:10px 8px}.lc-ov-kpi .lc-stat-value{font-size:20px}.lc-ov-heat-card{flex-direction:column;flex:1 0 auto;display:flex}.lc-heat{flex:1;justify-content:center;align-items:center;gap:4px;display:flex}.lc-heat-wds,.lc-heat-col{padding-top:13px}.lc-heat-wds{flex-direction:column;gap:3px;display:flex}.lc-heat-wd{width:10px;height:20px;color:var(--dsw-alias-label-secondary);text-align:center;flex:none;justify-content:center;align-items:center;font-size:9px;display:flex}.lc-heat-cols{gap:3px;display:flex}.lc-heat-col{flex-direction:column;gap:3px;display:flex;position:relative}.lc-heat-mon{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:9px;line-height:13px;position:absolute;top:0;left:0}.lc-heat-cell{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);cursor:default;border:0;border-radius:20%;width:20px;height:20px;padding:0}button.lc-heat-cell{cursor:pointer}button.lc-heat-cell:hover{box-shadow:0 0 0 1.5px color-mix(in srgb, var(--color-blue-500) 70%, transparent)}.lc-heat-future{background:0 0}.lc-heat-0{background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent)}.lc-heat-1{background:color-mix(in srgb, var(--color-blue-500) 28%, transparent)}.lc-heat-2{background:color-mix(in srgb, var(--color-blue-500) 50%, transparent)}.lc-heat-3{background:color-mix(in srgb, var(--color-blue-500) 72%, transparent)}.lc-heat-4{background:color-mix(in srgb, var(--color-blue-500) 92%, transparent)}.lc-heat-on{box-shadow:0 0 0 1.5px var(--color-blue-500)}.lc-ov-list-head{flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:10px;display:flex}.lc-ov-list-title{white-space:nowrap;font-weight:600}.lc-ov-list-count{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;background:var(--dsw-alias-bg-layer-2);border-radius:8px;padding:1px 7px;font-size:11px}.lc-ov-day-chip{border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);color:var(--color-blue-500);background:color-mix(in srgb, var(--color-blue-500) 10%, transparent);cursor:pointer;white-space:nowrap;border-radius:999px;padding:1px 10px;font-family:inherit;font-size:11px;line-height:1.4}.lc-ov-search{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);min-width:110px;font:inherit;color:var(--dsw-alias-label-primary);transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:6px;outline:none;flex:150px;padding:4px 10px;font-size:12px}.lc-ov-search:focus{border-color:var(--dsw-alias-label-secondary)}.lc-ov-search::placeholder{color:var(--dsw-alias-label-secondary)}.lc-ov-groups{flex-wrap:wrap;gap:6px;margin:-2px 0 10px;display:flex}.lc-ov-chip{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;white-space:nowrap;text-overflow:ellipsis;max-width:220px;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), border-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-radius:999px;align-items:baseline;gap:5px;padding:2px 10px;font-size:11px;line-height:1.5;display:inline-flex;overflow:hidden}.lc-ov-chip:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-secondary)}.lc-ov-chip-on,.lc-ov-chip-on:hover{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border-color:#0000}.lc-ov-chip-n{font-variant-numeric:tabular-nums;opacity:.65;font-size:10px}.lc-ov-chip-on .lc-ov-chip-n{opacity:.85}.lc-ov-grid{grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:10px;display:grid}.lc-ov-session{text-align:left;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;font:inherit;color:inherit;transition:border-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);border-radius:10px;flex-direction:column;gap:6px;padding:10px 12px;display:flex}.lc-ov-session:hover{border-color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}.lc-ov-session-current{border-color:color-mix(in srgb, var(--color-blue-500) 65%, transparent)}.lc-ov-session-head{align-items:flex-start;gap:6px;min-width:0;display:flex}.lc-ov-running{background:var(--color-green-500);border-radius:50%;flex:none;width:7px;height:7px}.lc-ov-session-title{-webkit-line-clamp:2;overflow-wrap:anywhere;-webkit-box-orient:vertical;flex:auto;min-width:0;font-weight:600;display:-webkit-box;overflow:hidden}.lc-ov-current{color:var(--color-blue-500);border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);border-radius:4px;flex:none;padding:0 4px;font-size:10px;line-height:1.5}.lc-ov-session-times{flex-direction:column;flex:none;align-items:flex-end;gap:1px;display:flex}.lc-ov-session-time{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:11px}.lc-ov-session-created{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-variant-numeric:tabular-nums;font-size:10px;line-height:1.4}.lc-ov-session-crumb{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;align-items:center;gap:5px;font-size:11px;display:flex;overflow:hidden}.lc-ov-crumb-group{text-overflow:ellipsis;flex:none;max-width:55%;overflow:hidden}.lc-ov-crumb-sep{opacity:.55;flex:none}.lc-ov-crumb-project{text-overflow:ellipsis;min-width:0;font-family:var(--ds-font-family-code,ui-monospace, SFMono-Regular, Menlo, monospace);color:var(--dsw-alias-label-primary);background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent);border-radius:999px;flex:0 auto;padding:0 8px;font-size:10px;line-height:1.6;overflow:hidden}.lc-ov-session-body{align-items:center;gap:14px;min-width:0;display:flex}.lc-ov-mini-stats{flex-direction:column;flex:auto;gap:3px;min-width:0;display:flex}.lc-ov-mini-stat{justify-content:space-between;align-items:baseline;gap:10px;font-size:11px;display:flex}.lc-ov-mini-label{color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none}.lc-ov-mini-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-session-empty{color:var(--dsw-alias-label-secondary);padding:6px 0;font-size:11px;line-height:1.5}.lc-ov-session-preview{border-top:1px solid color-mix(in srgb, var(--dsw-alias-border-l2) 60%, transparent);align-items:baseline;gap:6px;min-width:0;margin-top:auto;padding-top:6px;display:flex}.lc-ov-session-preview-label{color:var(--dsw-alias-label-secondary);flex:none;font-size:10px}.lc-ov-session-preview-text{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-primary);flex:0 auto;font-size:11px;line-height:1.5;overflow:hidden}.lc-ov-pager{justify-content:center;align-items:center;gap:10px;margin-top:12px;display:flex}.lc-ov-pager-btn{border:1px solid var(--dsw-alias-border-l2);width:26px;height:22px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:6px;flex:none;justify-content:center;align-items:center;line-height:1;display:flex}.lc-ov-pager-btn:hover:enabled{border-color:var(--dsw-alias-label-secondary)}.lc-ov-pager-btn:disabled{opacity:.4;cursor:default}.lc-ov-pager-n{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;white-space:nowrap;font-size:11px}";
+		const css = ".lc-ov-entry{box-sizing:border-box;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:8px;margin:0 -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.lc-ov-entry:hover{background:var(--dsw-alias-interactive-bg-hover)}.lc-ov-entry-rail{border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.lc-ov-entry-icon{flex:none}.lc-ov-entry-label{text-align:left;white-space:nowrap;text-overflow:ellipsis;flex:auto;min-width:0;overflow:hidden}.lc-ov-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0;container:lc-ov/inline-size}.lc-ov-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(1120px,100vw - 32px);max-height:min(86vh,900px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:16px 18px 18px;font-size:13px;display:flex;overflow:hidden}.lc-ov-head{flex-wrap:wrap;flex:none;align-items:center;gap:10px;margin-bottom:14px;display:flex}.lc-ov-head-icon{flex:none}.lc-ov-title{white-space:nowrap;font-size:15px;font-weight:600}.lc-ov-balance{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);cursor:default;border-radius:999px;flex:none;align-items:center;gap:6px;max-width:100%;padding:2px 10px;font-size:12px;line-height:18px;display:inline-flex}.lc-ov-balance-label{color:var(--dsw-alias-label-secondary);white-space:nowrap}.lc-ov-balance-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-head .lc-modal-close{flex:none;margin-left:0}.lc-ov-body{flex:auto;grid-template-columns:minmax(0,3fr) minmax(0,7fr);gap:10px;min-height:0;display:grid}.lc-ov-left{scrollbar-gutter:stable;flex-direction:column;gap:10px;min-height:0;padding-right:8px;display:flex;overflow-y:auto}.lc-ov-right{scrollbar-gutter:stable;min-height:0;padding-right:8px;overflow-y:auto}@container lc-ov (width<=932px){.lc-ov-card{overflow-y:auto}.lc-ov-body{display:block}.lc-ov-left{margin-bottom:12px}.lc-ov-left,.lc-ov-right{min-height:auto;padding-right:0;overflow:visible}.lc-ov-heat-card{flex:none}}.lc-ov-left>.lc-card{box-sizing:border-box;min-width:0;margin-bottom:0}.lc-ov-kpis{flex:none;grid-template-rows:repeat(3,1fr);grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;display:grid}.lc-ov-kpi{align-items:center;padding:10px 8px}.lc-ov-kpi .lc-stat-value{font-size:20px}.lc-ov-heat-card{flex-direction:column;flex:1 0 auto;display:flex}.lc-heat{flex:1;justify-content:center;align-items:center;gap:4px;display:flex}.lc-heat-wds,.lc-heat-col{padding-top:13px}.lc-heat-wds{flex-direction:column;gap:3px;display:flex}.lc-heat-wd{width:10px;height:20px;color:var(--dsw-alias-label-secondary);text-align:center;flex:none;justify-content:center;align-items:center;font-size:9px;display:flex}.lc-heat-cols{gap:3px;display:flex}.lc-heat-col{flex-direction:column;gap:3px;display:flex;position:relative}.lc-heat-mon{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:9px;line-height:13px;position:absolute;top:0;left:0}.lc-heat-cell{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);cursor:default;border:0;border-radius:20%;width:20px;height:20px;padding:0}button.lc-heat-cell{cursor:pointer}button.lc-heat-cell:hover{box-shadow:0 0 0 1.5px color-mix(in srgb, var(--color-blue-500) 70%, transparent)}.lc-heat-future{background:0 0}.lc-heat-0{background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent)}.lc-heat-1{background:color-mix(in srgb, var(--color-blue-500) 28%, transparent)}.lc-heat-2{background:color-mix(in srgb, var(--color-blue-500) 50%, transparent)}.lc-heat-3{background:color-mix(in srgb, var(--color-blue-500) 72%, transparent)}.lc-heat-4{background:color-mix(in srgb, var(--color-blue-500) 92%, transparent)}.lc-heat-on{box-shadow:0 0 0 1.5px var(--color-blue-500)}.lc-ov-list-head{flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:10px;display:flex}.lc-ov-list-title{white-space:nowrap;font-weight:600}.lc-ov-list-count{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;background:var(--dsw-alias-bg-layer-2);border-radius:8px;padding:1px 7px;font-size:11px}.lc-ov-day-chip{border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);color:var(--color-blue-500);background:color-mix(in srgb, var(--color-blue-500) 10%, transparent);cursor:pointer;white-space:nowrap;border-radius:999px;padding:1px 10px;font-family:inherit;font-size:11px;line-height:1.4}.lc-ov-search{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);min-width:110px;font:inherit;color:var(--dsw-alias-label-primary);transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:6px;outline:none;flex:150px;padding:4px 10px;font-size:12px}.lc-ov-search:focus{border-color:var(--dsw-alias-label-secondary)}.lc-ov-search::placeholder{color:var(--dsw-alias-label-secondary)}.lc-ov-groups{flex-wrap:wrap;gap:6px;margin:-2px 0 10px;display:flex}.lc-ov-chip{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;white-space:nowrap;text-overflow:ellipsis;max-width:220px;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), border-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-radius:999px;align-items:baseline;gap:5px;padding:2px 10px;font-size:11px;line-height:1.5;display:inline-flex;overflow:hidden}.lc-ov-chip:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-secondary)}.lc-ov-chip-on,.lc-ov-chip-on:hover{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border-color:#0000}.lc-ov-chip-n{font-variant-numeric:tabular-nums;opacity:.65;font-size:10px}.lc-ov-chip-on .lc-ov-chip-n{opacity:.85}.lc-ov-grid{grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:10px;display:grid}.lc-ov-session{text-align:left;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;font:inherit;color:inherit;transition:border-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);border-radius:10px;flex-direction:column;gap:6px;padding:10px 12px;display:flex}.lc-ov-session:hover{border-color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}.lc-ov-session-current{border-color:color-mix(in srgb, var(--color-blue-500) 65%, transparent)}.lc-ov-session-head{align-items:flex-start;gap:6px;min-width:0;display:flex}.lc-ov-running{background:var(--color-green-500);border-radius:50%;flex:none;width:7px;height:7px}.lc-ov-session-title{-webkit-line-clamp:2;overflow-wrap:anywhere;-webkit-box-orient:vertical;flex:auto;min-width:0;font-weight:600;display:-webkit-box;overflow:hidden}.lc-ov-current{color:var(--color-blue-500);border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);border-radius:4px;flex:none;padding:0 4px;font-size:10px;line-height:1.5}.lc-ov-session-times{flex-direction:column;flex:none;align-items:flex-end;gap:1px;display:flex}.lc-ov-session-time{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:11px}.lc-ov-session-created{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-variant-numeric:tabular-nums;font-size:10px;line-height:1.4}.lc-ov-session-crumb{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;align-items:center;gap:5px;font-size:11px;display:flex;overflow:hidden}.lc-ov-crumb-group{text-overflow:ellipsis;flex:none;max-width:55%;overflow:hidden}.lc-ov-crumb-sep{opacity:.55;flex:none}.lc-ov-crumb-project{text-overflow:ellipsis;min-width:0;font-family:var(--ds-font-family-code,ui-monospace, SFMono-Regular, Menlo, monospace);color:var(--dsw-alias-label-primary);background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent);border-radius:999px;flex:0 auto;padding:0 8px;font-size:10px;line-height:1.6;overflow:hidden}.lc-ov-session-body{align-items:center;gap:14px;min-width:0;display:flex}.lc-ov-mini-stats{flex-direction:column;flex:auto;gap:3px;min-width:0;display:flex}.lc-ov-mini-stat{justify-content:space-between;align-items:baseline;gap:10px;font-size:11px;display:flex}.lc-ov-mini-label{color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none}.lc-ov-mini-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-session-empty{color:var(--dsw-alias-label-secondary);padding:6px 0;font-size:11px;line-height:1.5}.lc-ov-session-preview{border-top:1px solid color-mix(in srgb, var(--dsw-alias-border-l2) 60%, transparent);align-items:baseline;gap:6px;min-width:0;margin-top:auto;padding-top:6px;display:flex}.lc-ov-session-preview-label{color:var(--dsw-alias-label-secondary);flex:none;font-size:10px}.lc-ov-session-preview-text{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-primary);flex:0 auto;font-size:11px;line-height:1.5;overflow:hidden}.lc-ov-pager{justify-content:center;align-items:center;gap:10px;margin-top:12px;display:flex}.lc-ov-pager-btn{border:1px solid var(--dsw-alias-border-l2);width:26px;height:22px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:6px;flex:none;justify-content:center;align-items:center;line-height:1;display:flex}.lc-ov-pager-btn:hover:enabled{border-color:var(--dsw-alias-label-secondary)}.lc-ov-pager-btn:disabled{opacity:.4;cursor:default}.lc-ov-pager-n{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;white-space:nowrap;font-size:11px}";
 		const tagId = "dsh-context/overview.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -11407,7 +11631,7 @@ window.__ModuleLoader__.load({
 				}),
 				sidebar: () => watchSidebarContextTab(ctx, ContextView, t, NS)
 			}), "dsh-context: placement");
-			const ContextJump = makeContextJumpButton(kit);
+			const ContextJump = makeContextJumpButton(ctx, kit);
 			ctx.slots.inject("conversation.chat.assistant-actions", () => {
 				return ctx.slots.register({
 					name: "conversation.chat.assistant-actions",

package/lib/index.d.ts

@@ -796,10 +796,33 @@ interface HeaderRecord {
 interface ContextHeaders {
   headers: HeaderRecord[];
 }
+/** One currency's DeepSeek open-platform balance figures. */
+interface PlatformBalanceEntry {
+  /** The ISO code the platform reported (`CNY` / `USD`). */
+  currency: string;
+  /** Total available funds: the granted and topped-up balances summed. */
+  total: number;
+  /** The not-expired granted (gift) balance. */
+  granted: number;
+  /** The topped-up balance. */
+  toppedUp: number;
+}
+/**
+ * The DeepSeek open-platform balance, served by the plugin's
+ * `/api/dsh-context/balance` fetch route (host/balance.ts). `null` on the
+ * wire — and nothing rendered client-side — whenever the platform is not
+ * configured or the read fails: the capsule only ever shows a live figure.
+ */
+interface PlatformBalance {
+  /** Whether the platform reports the balance sufficient for API calls. */
+  isAvailable: boolean;
+  /** One entry per currency the account holds; at least one. */
+  balances: PlatformBalanceEntry[];
+}
 //#endregion
 //#region src/host/index.d.ts
 export declare const name = "dsh-context";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, RequestRecord, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };
+export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, PlatformBalance, PlatformBalanceEntry, RequestRecord, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };

package/lib/index.js

@@ -2057,6 +2057,163 @@ function createToolAttribution(ctx) {
 	return { ownerOf: (name) => mcpSourceOf(name) ?? live.get(name) ?? pinnedSourceOf(name) ?? (boot.has(name) ? "<unknown-plugin>" : void 0) };
 }
 //#endregion
+//#region src/host/balance.ts
+/** The plugin's balance route, under the authenticated `/api` fence. */
+const BALANCE_ROUTE = "/api/dsh-context/balance";
+/** The settings namespace llm-deepseek installs its connection section under. */
+const DEEPSEEK_SETTINGS_NS = "llm-deepseek";
+/** llm-deepseek's default credential ref (the env-var name its section resolves). */
+const DEFAULT_API_KEY_ENV = "DEEPSEEK_API_KEY";
+/** The platform's public API root (llm-deepseek's PUBLIC_BASE_URL default). */
+const PUBLIC_BASE_URL = "https://api.deepseek.com";
+/** A settled read serves identical reads for this long; failures decay faster. */
+const CACHE_TTL_MS = 3e5;
+const CACHE_FAIL_TTL_MS = 6e4;
+/** One platform read's whole budget — never worth blocking the route longer. */
+const FETCH_TIMEOUT_MS = 1e4;
+/** Narrow an unknown value to a string-keyed record, or null. */
+function asRecord$1(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+/** One platform amount ('110.00', or an already-numeric producer variant), or null. */
+function amountOf(value) {
+	const n = typeof value === "string" ? Number(value) : value;
+	return typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : null;
+}
+/**
+* Resolve the DeepSeek connection facts exactly as llm-deepseek serves its
+* requests: its settings section for the credential ref and endpoint, the
+* credentials service for the key. `null` whenever any fact is missing —
+* the platform is simply not configured for this deployment.
+*/
+async function resolveFacts(ctx) {
+	const settings = ctx.get("settings");
+	const section = typeof settings?.get === "function" ? asRecord$1(settings.get(DEEPSEEK_SETTINGS_NS)) : null;
+	if (section === null) return null;
+	const apiKeyEnv = typeof section.apiKeyEnv === "string" && section.apiKeyEnv !== "" ? section.apiKeyEnv : DEFAULT_API_KEY_ENV;
+	const baseUrl = typeof section.baseURL === "string" && section.baseURL !== "" ? section.baseURL : PUBLIC_BASE_URL;
+	const credentials = ctx.get("credentials");
+	const resolve = typeof credentials?.resolve === "function" ? credentials.resolve.bind(credentials) : void 0;
+	if (resolve === void 0) return null;
+	let hit;
+	try {
+		hit = await resolve(apiKeyEnv);
+	} catch {
+		return null;
+	}
+	const apiKey = typeof hit?.value === "string" ? hit.value : "";
+	return apiKey === "" ? null : {
+		baseUrl,
+		apiKey
+	};
+}
+/**
+* Narrow the platform's payload to the wire value (the boundary rigor every
+* parser owes untrusted input): each entry's currency and three amounts are
+* re-proved, an entry failing the shape drops whole, and a payload with no
+* valid entry is no balance at all.
+*/
+function balanceOfPayload(value) {
+	const data = asRecord$1(value);
+	if (data === null) return null;
+	const infos = Array.isArray(data.balance_infos) ? data.balance_infos : [];
+	const balances = [];
+	for (const info of infos) try {
+		const entry = asRecord$1(info);
+		if (entry === null) continue;
+		const currency = entry.currency;
+		const total = amountOf(entry.total_balance);
+		const granted = amountOf(entry.granted_balance);
+		const toppedUp = amountOf(entry.topped_up_balance);
+		if (typeof currency !== "string" || currency === "" || total === null || granted === null || toppedUp === null) continue;
+		balances.push({
+			currency,
+			total,
+			granted,
+			toppedUp
+		});
+	} catch {
+		continue;
+	}
+	return balances.length > 0 ? {
+		isAvailable: data.is_available === true,
+		balances
+	} : null;
+}
+/** The outbound platform fetch through the real global fetch. */
+const defaultFetcher = (url, init) => fetch(url, init);
+let fetcher = defaultFetcher;
+let cache = null;
+let inFlight = null;
+/**
+* One platform read for these facts, shared across identical concurrent
+* reads and remembered briefly: successes for CACHE_TTL_MS, failures for
+* CACHE_FAIL_TTL_MS (a blip must not pin the capsule away for the full
+* window). Every failure path — transport, timeout, non-ok status, malformed
+* payload — resolves `null`; the route never throws into the transport.
+*/
+async function readBalance(facts) {
+	const key = facts.baseUrl + "\0" + facts.apiKey;
+	if (cache !== null && cache.key === key && Date.now() - cache.at < (cache.value === null ? CACHE_FAIL_TTL_MS : CACHE_TTL_MS)) return cache.value;
+	if (inFlight !== null) return inFlight;
+	inFlight = (async () => {
+		let value = null;
+		try {
+			const response = await fetcher(facts.baseUrl.replace(/\/+$/, "") + "/user/balance", {
+				headers: {
+					accept: "application/json",
+					authorization: "Bearer " + facts.apiKey
+				},
+				signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+			});
+			if (response.ok) value = balanceOfPayload(await response.json());
+		} catch {}
+		cache = {
+			key,
+			at: Date.now(),
+			value
+		};
+		return value;
+	})();
+	const settled = inFlight;
+	try {
+		return await settled;
+	} finally {
+		inFlight = null;
+	}
+}
+/**
+* Serve the balance route whenever the connection service composes (see
+* host/detail.ts for the load-order contract). The registration rides the
+* injected fiber: the service unloading withdraws the route. A rejecting
+* registry only closes the capsule — never the plugin.
+*/
+function watchBalanceChannel(ctx) {
+	ctx.inject(["connection"], (c) => {
+		const connection = c.get("connection");
+		const register = typeof connection?.fetch?.register === "function" ? connection.fetch.register.bind(connection.fetch) : void 0;
+		if (register === void 0) return;
+		const handler = async () => {
+			const facts = await resolveFacts(ctx);
+			const value = facts !== null ? await readBalance(facts) : null;
+			return Response.json({
+				ok: true,
+				value
+			}, { headers: { "cache-control": "no-store" } });
+		};
+		try {
+			c.effect(() => register({
+				path: BALANCE_ROUTE,
+				methods: ["POST"],
+				requestBody: "buffered",
+				fetch: handler
+			}), "dsh-context: balance route");
+		} catch {
+			return;
+		}
+	});
+}
+//#endregion
 //#region src/host/backfill.ts
 /** The plugin's warm-up trigger route, under the authenticated `/api` fence. */
 const BACKFILL_ROUTE = "/api/dsh-context/backfill";
@@ -2067,8 +2224,15 @@ const BACKFILL_ROUTE = "/api/dsh-context/backfill";
 * workspace sidebar rides it), so the pass breathes between sessions.
 */
 const YIELD_MS = 100;
-/** The `name` dsh raises for a durable log its migration surface refuses. */
-const UNSUPPORTED_MIGRATION = "SessionFormatUnsupportedMigrationError";
+/**
+* The `name` family dsh raises for a durable log it cannot interpret. The
+* format edge throws `SessionFormatUnsupportedMigrationError`, but the
+* persistence seam translates it — together with every other "intact yet not
+* interpretable" refusal — into `SessionFormatUnsupportedError` before the
+* error escapes (issue #75): classify by the family prefix, since either
+* exact name may be the one that arrives.
+*/
+const UNSUPPORTED_FORMAT = "SessionFormatUnsupported";
 function asRecord(value) {
 	return value !== null && typeof value === "object" ? value : null;
 }
@@ -2123,15 +2287,15 @@ function isLive(sessions, id) {
 	}
 }
 /**
-* Whether the cold read failed because the running harness refuses to
-* migrate this log — a permanent, source-side refusal (the artifact is left
-* unchanged, so retrying cannot succeed). Matched by the error's documented
-* `name`, so no dsh symbol needs importing and every supported baseline
-* classifies alike: an unknown error shape just falls to the warn path.
+* Whether the cold read failed because the running harness refuses this log's
+* format — a permanent, source-side refusal (the artifact is left unchanged,
+* so retrying cannot succeed). Matched by the error's documented `name`, so no
+* dsh symbol needs importing and every supported baseline classifies alike: an
+* unknown error shape just falls to the warn path.
 */
-function isUnsupportedMigration(error) {
+function isUnsupportedFormat(error) {
 	try {
-		return asRecord(error)?.name === UNSUPPORTED_MIGRATION;
+		return String(asRecord(error)?.name).startsWith(UNSUPPORTED_FORMAT);
 	} catch {
 		return false;
 	}
@@ -2210,7 +2374,7 @@ function watchActivityBackfill(ctx) {
 					cache.coldSnapshot(log.header, log.inheritedEventCount, log.events);
 					folded++;
 				} catch (error) {
-					if (isUnsupportedMigration(error)) {
+					if (isUnsupportedFormat(error)) {
 						refused++;
 						ctx.logger.debug(`dsh-context: projection backfill skipped "${header.id}" (${messageOf(error)})`);
 					} else ctx.logger.warn(`dsh-context: projection backfill skipped "${header.id}" (${messageOf(error)})`);
@@ -3281,6 +3445,7 @@ function detectHarnessVersion(ctx, resolveUrl = resolveRunningModule, pluginRoot
 const name = "dsh-context";
 const inject = ["sessionProjections"];
 function apply(ctx, config) {
+	watchBalanceChannel(ctx);
 	const harnessVersion = detectHarnessVersion(ctx);
 	if (harnessVersion !== void 0 && !meetsBaseline(harnessVersion)) {
 		ctx.sessionProjections.register(createFallbackTimelineDefinition(harnessVersion));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context",
-  "version": "0.53.3",
+  "version": "0.54.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": {