@luziyang2026/dsh-question-nav 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Abel Keith Sun. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from this
+   software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,76 @@
+# dsh-question-nav
+
+In-session question navigator for the [DeepSeek Harness (DSH) Web GUI][dsh]: a
+vertical column of small round dots overlaid on the **left edge** of the
+conversation column — one dot per user question. Hover a dot to enlarge it and
+see the question's **full text** immediately; click a dot to scroll the chat to
+that question.
+
+It is an external plugin bundle with zero runtime dependencies — the browser
+half (`lib/client.js`) externalizes everything to the DSH shell, so it adds
+only a small bundle to the GUI at load time.
+
+## What it does
+
+- **Left-edge dot minimap** (embedded, not reserving any width).
+- **Vertically centered** in the conversation column.
+- **One dot = one user question**, with a small count above the dot column.
+- **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
+  native-title delay) shows the question's **full text**.
+- **Click**: jumps to that question, paging older history when the target is
+  not yet in the loaded window (with a nearest-row fallback).
+- Empty/left areas of the rail pass pointer events through to the conversation
+  (it never blocks the chat).
+
+## Behavior notes
+
+- Only the current session is indexed; the question list reflects the loaded
+  chat window and expands as history is paged in.
+- `user` and `steering` user messages count as questions.
+
+## Install (development / local checkout)
+
+This repository is a standalone plugin project — build it, then add it to a
+profile as an installable [bundle][bundle].
+
+```sh
+pnpm install       # install devDependencies (DSH SDK peers, tsdown, vitest)
+pnpm build         # tsc declarations + tsdown client bundle -> lib/
+```
+
+Add it to a profile (the `dsh` CLI is required):
+
+```sh
+dsh plugin --profile web add ./dsh-question-nav
+```
+
+Or, once published, install the prebuilt package from npm:
+
+```sh
+dsh plugin --profile web add @luziyang2026/dsh-question-nav
+```
+
+Restart the DSH Web GUI to load the new bundle.
+
+## Development
+
+```sh
+pnpm typecheck     # tsc --noEmit
+pnpm test          # vitest run
+pnpm build         # build host lib/index.js + client lib/client.js
+```
+
+## How it is built
+
+The client half uses the shared DSH client-bundle preset
+([`tsdown.client.ts`](tsdown.client.ts), vendored into this repo), which emits
+a `window.__ModuleLoader__.load({ id, factory })` closure-factory
+artifact with CSS Modules inlined and externals resolved through the loader
+module table.
+
+## License
+
+BSD-3-Clause.
+
+[dsh]: https://github.com/deepseek-harness/deepseek-harness
+[bundle]: https://github.com/deepseek-harness/deepseek-harness

package/README.zh.md

@@ -0,0 +1,67 @@
+# dsh-question-nav
+
+[DeepSeek Harness (DSH) Web GUI][dsh] 的**会话内提问导航**插件：在对话栏**左侧**
+内嵌一列竖排的圆点小按钮 —— 每个圆点对应一个用户提问。鼠标悬停圆点会放大
+并**立即**显示该提问的**全文**；点击圆点则把对话滚动跳到那一提问的位置。
+
+它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
+外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
+
+## 功能
+
+- **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
+- **垂直居中**在对话栏中。
+- **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
+- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
+- **点击**：跳转到该提问，目标尚未加载时自动 `loadOlder` 扩窗（并落到最近可见行兜底）。
+- 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
+
+## 行为说明
+
+- 只索引当前会话；问题列表反映已加载的对话窗口，随历史扩窗补全。
+- `user` 与 `steering` 用户消息计为提问。
+
+## 安装（开发 / 本地 checkout）
+
+本仓库是独立插件工程 —— 先构建，再作为可安装的 [bundle][bundle] 加进 profile。
+
+```sh
+pnpm install       # 安装 devDependencies（DSH SDK peers、tsdown、vitest）
+pnpm build         # tsc 声明 + tsdown client bundle -> lib/
+```
+
+加进 profile（需要 `dsh` CLI）：
+
+```sh
+dsh plugin --profile web add ./dsh-question-nav
+```
+
+发布后也可直接从 npm 装预构建产物：
+
+```sh
+dsh plugin --profile web add @luziyang2026/dsh-question-nav
+```
+
+重启 DSH Web GUI 以加载新 bundle。
+
+## 开发
+
+```sh
+pnpm typecheck     # tsc --noEmit
+pnpm test          # vitest run
+pnpm build         # 构建 host lib/index.js + client lib/client.js
+```
+
+## 构建方式
+
+client 半区使用共享的 DSH client-bundle 预设（[`tsdown.client.ts`](tsdown.client.ts)，
+vendored 到本项目内），产出
+`window.__ModuleLoader__.load({ id, factory })` 闭包工厂产物，CSS Modules 内联，
+externals 经加载器模块表解析。
+
+## License
+
+BSD-3-Clause。
+
+[dsh]: https://github.com/deepseek-harness/deepseek-harness
+[bundle]: https://github.com/deepseek-harness/deepseek-harness

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-question-nav bundle patch: inserts its plugin row into the web profile
+# roster. Applied as a profile bundle layer (the `dsh.bundle.patch` manifest
+# field); install with
+# `dsh plugin --profile web add ./dsh-question-nav` (from a local checkout) or
+# `dsh plugin --profile web add <npm-package>` once published.
+- insert:
+    - id: question-nav
+      name: '@luziyang2026/dsh-question-nav'

package/lib/client.js

@@ -0,0 +1,450 @@
+window.__ModuleLoader__.load({
+	id: "@luziyang2026/dsh-question-nav",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_dom = require("react-dom");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region \0dsh-css:dsh-question-nav/src/client/question-nav.module.css.mjs
+		const css = ".TWf_pa_rail{z-index:1;box-sizing:border-box;pointer-events:none;background:0 0;flex-direction:column;align-items:center;width:44px;display:flex;position:absolute;top:0;bottom:0;left:0}.TWf_pa_list{scrollbar-width:thin;flex-direction:column;flex:1;align-items:center;gap:6px;width:100%;min-height:0;padding:8px 0;display:flex;overflow:hidden auto}.TWf_pa_list>:first-child{margin-top:auto}.TWf_pa_list>:last-child{margin-bottom:auto}.TWf_pa_dot{pointer-events:auto;background:var(--dsw-alias-border-l3);cursor:pointer;border:none;border-radius:50%;flex:none;width:8px;height:8px;padding:0;transition:transform .12s,background .12s}.TWf_pa_dot:hover{background:var(--dsw-alias-brand-primary);transform:scale(2)}.TWf_pa_dot.TWf_pa_active{background:var(--dsw-alias-brand-primary);transform:scale(1.6)}.TWf_pa_count{color:var(--dsw-alias-label-tertiary);user-select:none;flex:none;font-size:10px;font-weight:600;line-height:1}.TWf_pa_dots{flex-direction:column;align-items:center;gap:6px;display:flex}.TWf_pa_empty{color:var(--dsw-alias-label-tertiary);text-align:center;word-break:break-word;padding:10px 4px;font-size:11px}.TWf_pa_tooltip{z-index:20;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);max-width:420px;color:var(--dsw-alias-label-primary);white-space:normal;word-break:break-word;pointer-events:none;border-radius:8px;padding:8px 12px;font-size:13px;line-height:18px;position:fixed;box-shadow:0 4px 16px #0003}";
+		const tagId = "@luziyang2026/dsh-question-nav/question-nav.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@luziyang2026/dsh-question-nav";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var question_nav_module_css_default = {
+			"active": "TWf_pa_active",
+			"count": "TWf_pa_count",
+			"dot": "TWf_pa_dot",
+			"dots": "TWf_pa_dots",
+			"empty": "TWf_pa_empty",
+			"list": "TWf_pa_list",
+			"rail": "TWf_pa_rail",
+			"tooltip": "TWf_pa_tooltip"
+		};
+		//#endregion
+		//#region src/client/QuestionNavStrip.tsx
+		/**
+		* Question-nav minimap. Renders a vertical column of small round dots overlaid
+		* on the LEFT edge of the conversation column (via the frame-wide
+		* `shell.overlay` floating layer), vertically centered: one dot per user
+		* question, enlarge on hover. The instant tooltip (a portal-rendered overlay,
+		* no native-title delay) shows the question's full text; clicking a dot scrolls
+		* the chat to that question.
+		*
+		* Data arrives through the four props shares: the framework `useSessions`
+		* hook (current session), the registrant inject face (read/subscribe/jump),
+		* and the bound locale translator.
+		*/
+		const FAILURE_HINTS = {
+			VIEW_INACTIVE: "jump.inactive",
+			TARGET_HIDDEN: "jump.hidden",
+			NOT_FOUND: "jump.notfound",
+			TIMEOUT: "jump.timeout"
+		};
+		function findConvRoot() {
+			return document.querySelector("[data-slot=\"conversation\"] > div[data-phase]");
+		}
+		function QuestionNavStrip(props) {
+			const current = props.useSessions((s) => s.current);
+			const summary = props.useSessions((s) => s.current === void 0 ? void 0 : s.byId[s.current]);
+			const visible = current !== void 0 && summary !== void 0 && summary.blank !== true;
+			const [questions, setQuestions] = (0, react.useState)([]);
+			const [jumpingKey, setJumpingKey] = (0, react.useState)(null);
+			const [hint, setHint] = (0, react.useState)(null);
+			const [tooltip, setTooltip] = (0, react.useState)(null);
+			const panelRef = (0, react.useRef)(null);
+			const hintTimerRef = (0, react.useRef)(null);
+			const showHint = (message) => {
+				setHint(message);
+				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
+				hintTimerRef.current = window.setTimeout(() => setHint(null), 1800);
+			};
+			(0, react.useEffect)(() => {
+				if (!visible || current === void 0) {
+					setQuestions([]);
+					return;
+				}
+				const refresh = () => setQuestions(props.readQuestions(current));
+				refresh();
+				const unsubContent = props.subscribeContent(current, refresh);
+				const unsubList = props.subscribeList(refresh);
+				return () => {
+					unsubContent();
+					unsubList();
+				};
+			}, [
+				visible,
+				current,
+				props
+			]);
+			(0, react.useEffect)(() => {
+				const onJumpFailed = (event) => {
+					const code = event.detail;
+					showHint(props.t(FAILURE_HINTS[code] ?? "jump.timeout"));
+				};
+				window.addEventListener("question-nav:jump-failed", onJumpFailed);
+				return () => window.removeEventListener("question-nav:jump-failed", onJumpFailed);
+			}, [props]);
+			(0, react.useLayoutEffect)(() => {
+				if (!visible) return;
+				let raf = 0;
+				let retries = 0;
+				const applyLayout = () => {
+					const panel = panelRef.current;
+					if (panel === null) return;
+					const frame = panel.closest("[data-shell-overlay]")?.parentElement ?? null;
+					const convRoot = findConvRoot();
+					if (frame === null || convRoot === null) return;
+					const frameRect = frame.getBoundingClientRect();
+					const convRect = convRoot.getBoundingClientRect();
+					if (convRect.height <= 0) {
+						if (retries < 20) {
+							retries += 1;
+							raf = requestAnimationFrame(applyLayout);
+						}
+						return;
+					}
+					retries = 0;
+					panel.style.top = `${convRect.top - frameRect.top}px`;
+					panel.style.height = `${convRect.height}px`;
+					panel.style.left = `${convRect.left - frameRect.left}px`;
+				};
+				applyLayout();
+				raf = requestAnimationFrame(applyLayout);
+				const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(applyLayout);
+				const convRoot = findConvRoot();
+				observer?.observe(convRoot ?? document.body, { box: "border-box" });
+				window.addEventListener("resize", applyLayout);
+				return () => {
+					if (raf !== 0) cancelAnimationFrame(raf);
+					observer?.disconnect();
+					window.removeEventListener("resize", applyLayout);
+				};
+			}, [visible]);
+			(0, react.useEffect)(() => () => {
+				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
+			}, []);
+			if (!visible) return null;
+			const onJump = (node) => {
+				if (current === void 0) return;
+				setJumpingKey(node.key);
+				props.jump(current, node.key);
+				window.setTimeout(() => setJumpingKey((k) => k === node.key ? null : k), 600);
+			};
+			const t = props.t;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				ref: panelRef,
+				className: question_nav_module_css_default.rail,
+				"data-question-nav": "rail",
+				children: [
+					hint !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: question_nav_module_css_default.hint,
+						role: "status",
+						children: hint
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: question_nav_module_css_default.list,
+						children: questions.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: question_nav_module_css_default.empty,
+							children: t("strip.empty")
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: question_nav_module_css_default.dots,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: question_nav_module_css_default.count,
+								children: questions.length
+							}), questions.map((node) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								className: jumpingKey === node.key ? `${question_nav_module_css_default.dot} ${question_nav_module_css_default.active}` : question_nav_module_css_default.dot,
+								"aria-label": node.text,
+								onMouseEnter: (e) => {
+									const r = e.currentTarget.getBoundingClientRect();
+									setTooltip({
+										text: node.text,
+										left: r.right + 10,
+										top: r.top
+									});
+								},
+								onMouseLeave: () => setTooltip(null),
+								onClick: () => onJump(node)
+							}, node.key))]
+						})
+					}),
+					tooltip !== null ? (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: question_nav_module_css_default.tooltip,
+						style: {
+							left: tooltip.left,
+							top: tooltip.top
+						},
+						children: tooltip.text
+					}), document.body) : null
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/locales.ts
+		/**
+		* Locale dictionaries for the question-nav surface (zh/en). Registered under
+		* the `question-nav` namespace; keys are consumed through the bound translator.
+		*/
+		const zh = {
+			"strip.empty": "本会话还没有提问",
+			"jump.inactive": "聊天视图未激活",
+			"jump.hidden": "目标无独立气泡，已定位到邻近内容",
+			"jump.notfound": "目标未加载或不存在（可能已压缩）",
+			"jump.timeout": "加载历史超时，可重试"
+		};
+		const en = {
+			"strip.empty": "No questions in this session yet",
+			"jump.inactive": "Chat view is not active",
+			"jump.hidden": "No dedicated bubble; landed on nearby content",
+			"jump.notfound": "Target not loaded or missing (maybe compacted)",
+			"jump.timeout": "Timed out loading history; retry"
+		};
+		//#endregion
+		//#region src/core/nodes.ts
+		/** Kinds counted as a user question (turn-opening and steering admissions). */
+		const QUESTION_KINDS = ["user", "steering"];
+		function userData(data) {
+			if (typeof data !== "object" || data === null) return void 0;
+			return data;
+		}
+		/** First text block of a user message; falls back to the raw first block. */
+		function messageText(content) {
+			if (content === void 0 || content.length === 0) return "";
+			const first = content[0];
+			if (typeof first?.text === "string") return first.text;
+			return "";
+		}
+		/** Extract the user questions from a chat-node window, ordered by anchorSeq. */
+		function extractQuestions(nodes) {
+			const out = [];
+			for (const node of nodes) {
+				if (!QUESTION_KINDS.includes(node.kind)) continue;
+				const payload = userData(node.data);
+				out.push({
+					key: node.key,
+					anchorSeq: node.anchorSeq,
+					seq: payload?.seq ?? -1,
+					time: payload?.time ?? 0,
+					text: messageText(payload?.content)
+				});
+			}
+			out.sort((a, b) => a.anchorSeq - b.anchorSeq);
+			return out;
+		}
+		/** Nearest renderable row for a key that is absent or hidden (compaction, windowing). */
+		function nearestRenderable(nodes, excludeKey) {
+			let best = null;
+			for (const node of nodes) {
+				if (node.visibility === "hidden") continue;
+				if (node.key === excludeKey) continue;
+				if (best === null || node.anchorSeq < best.anchorSeq) best = {
+					key: node.key,
+					anchorSeq: node.anchorSeq
+				};
+			}
+			return best;
+		}
+		//#endregion
+		//#region src/core/jump.ts
+		/**
+		* Jump-to-question orchestration. Pure-ish: takes injected ports (snapshot
+		* read, loadOlder, DOM row lookup, view liveness, scroll, timers) so the
+		* paging/timeout/fallback loop is unit-testable without a real browser or
+		* session. The browser half wires these ports to ctx.sessions + the DOM.
+		*/
+		const DEFAULTS = {
+			totalTimeoutMs: 15e3,
+			maxPages: 100,
+			rowWaitMs: 8e3,
+			pollMs: 60
+		};
+		function minAnchorSeq(rows) {
+			let min = null;
+			for (const row of rows) if (min === null || row.anchorSeq < min) min = row.anchorSeq;
+			return min;
+		}
+		function renderable(rows) {
+			const out = [];
+			for (const row of rows) {
+				if (row.visibility === "hidden") continue;
+				out.push({
+					key: row.key,
+					anchorSeq: row.anchorSeq
+				});
+			}
+			return out;
+		}
+		/**
+		* Jump to the row for `key`, paging older content until it is rendered (or the
+		* budget is exhausted). Falls back to the nearest renderable row when the
+		* exact row is hidden/absent.
+		*/
+		async function jumpToQuestion(ports, key, options = {}) {
+			const cfg = {
+				...DEFAULTS,
+				...options
+			};
+			const fail = (code, fallback = false) => {
+				ports.report?.(code, fallback);
+				return fallback ? {
+					ok: false,
+					code,
+					fallback: true
+				} : {
+					ok: false,
+					code
+				};
+			};
+			if (!ports.isViewActive()) return fail("VIEW_INACTIVE");
+			const deadline = ports.now() + cfg.totalTimeoutMs;
+			let pages = 0;
+			while (true) {
+				const snap = ports.snapshot();
+				if (snap === void 0) return fail("VIEW_INACTIVE");
+				const rows = renderable(snap.rows);
+				if (rows.some((r) => r.key === key)) break;
+				if (snap.openState !== "open") {
+					if (snap.openState === "error" || ports.now() > deadline) return fail(snap.openState === "error" ? "VIEW_INACTIVE" : "TIMEOUT");
+					await ports.sleep(cfg.pollMs);
+					continue;
+				}
+				if (snap.hasMore !== true) return fail("NOT_FOUND");
+				if (pages >= cfg.maxPages || ports.now() > deadline) return fail("TIMEOUT");
+				if (snap.loadingOlder) {
+					await ports.sleep(cfg.pollMs);
+					continue;
+				}
+				const before = minAnchorSeq(rows);
+				await ports.loadOlder();
+				pages += 1;
+				const afterSnap = ports.snapshot();
+				const after = minAnchorSeq(afterSnap === void 0 ? [] : afterSnap.rows);
+				if (after === null || before !== null && after >= before) return fail("NOT_FOUND");
+			}
+			const waitedFor = async (rowKey) => {
+				for (let waited = 0; waited <= cfg.rowWaitMs; waited += cfg.pollMs) {
+					if (!ports.isViewActive()) return null;
+					const row = ports.findRow(rowKey);
+					if (row !== null) return row;
+					await ports.sleep(cfg.pollMs);
+				}
+				return null;
+			};
+			const row = await waitedFor(key);
+			if (row !== null) {
+				ports.scrollIntoView(row);
+				return { ok: true };
+			}
+			const snap = ports.snapshot();
+			const fallback = nearestRenderable(snap === void 0 ? [] : snap.rows, key);
+			if (fallback !== null) {
+				const fbRow = await waitedFor(fallback.key);
+				if (fbRow !== null) {
+					ports.scrollIntoView(fbRow);
+					return fail("TARGET_HIDDEN", true);
+				}
+			}
+			return fail("TARGET_HIDDEN", false);
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Locale namespace this plugin owns. */
+		const NS = "question-nav";
+		/** Services required by this plugin. */
+		const inject = [
+			"slots",
+			"locale",
+			"sessions"
+		];
+		function claimApply() {
+			if (globalThis.__dshQuestionNavApplied === true) return false;
+			globalThis.__dshQuestionNavApplied = true;
+			return true;
+		}
+		function releaseApply() {
+			globalThis.__dshQuestionNavApplied = void 0;
+		}
+		/** Map the session snapshot to the jump-loop port surface. */
+		function jumpPortsFor(ctx, sessionId) {
+			return {
+				snapshot: () => {
+					const snap = ctx.sessions.binding(sessionId)?.session.getSnapshot();
+					if (snap === void 0) return void 0;
+					return {
+						openState: snap.openState,
+						hasMore: snap.hasMore,
+						loadingOlder: snap.loadingOlder,
+						rows: snap.chat.nodes.values()
+					};
+				},
+				loadOlder: async () => {
+					const binding = ctx.sessions.binding(sessionId);
+					if (binding === void 0) throw new Error("session unavailable");
+					await binding.session.loadOlder();
+				},
+				isViewActive: () => document.querySelector("[data-chat-flow]") !== null,
+				findRow: (key) => {
+					for (const candidate of Array.from(document.querySelectorAll("[data-chat-anchor-key]"))) if (candidate.dataset.chatAnchorKey === key) return candidate;
+					return null;
+				},
+				scrollIntoView: (row) => row.scrollIntoView({ block: "start" }),
+				now: () => Date.now(),
+				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
+			};
+		}
+		function createInject(ctx) {
+			return {
+				readQuestions: (sessionId) => {
+					const snap = ctx.sessions.binding(sessionId)?.session.getSnapshot();
+					if (snap === void 0) return [];
+					return extractQuestions(snap.chat.nodes.values());
+				},
+				subscribeList: (cb) => ctx.sessions.list.subscribe(cb),
+				subscribeContent: (sessionId, cb) => {
+					const binding = ctx.sessions.binding(sessionId);
+					if (binding === void 0) return () => {};
+					return binding.session.subscribe(cb);
+				},
+				jump: (sessionId, key) => {
+					const ports = jumpPortsFor(ctx, sessionId);
+					ports.report = (code) => {
+						window.dispatchEvent(new CustomEvent("question-nav:jump-failed", { detail: code }));
+					};
+					jumpToQuestion(ports, key);
+				}
+			};
+		}
+		/**
+		* Register the question-nav surface.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			if (!claimApply()) return;
+			ctx.effect(() => releaseApply, "question-nav: apply claim");
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "question-nav: dictionaries");
+			const injected = createInject(ctx);
+			ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+				name: "shell.overlay",
+				id: "question-nav",
+				order: 900,
+				locale: NS,
+				inject: () => injected
+			}, QuestionNavStrip));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map