@luziyang2026/dsh-question-nav 0.1.0 → 0.3.0

package/lib/client.js

@@ -7,8 +7,64 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_dom = require("react-dom");
 		let react_jsx_runtime = require("react/jsx-runtime");
+		//#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;
+		}
+		/**
+		* Merge two question sets (full-history index + live loaded window) into one
+		* deduplicated, anchorSeq-ascending list. The window may hold questions that
+		* arrived after the index was built; the index may hold questions the window
+		* has not loaded yet — union on `key`, newest live copy wins per key.
+		*/
+		function mergeQuestions(...sources) {
+			const byKey = /* @__PURE__ */ new Map();
+			for (const source of sources) for (const node of source) byKey.set(node.key, node);
+			return [...byKey.values()].sort((a, b) => a.anchorSeq - b.anchorSeq);
+		}
+		//#endregion
 		//#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 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_moreDot{border:1px dashed var(--dsw-alias-border-l3);background:0 0}.TWf_pa_moreDot:hover{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary)}.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_countLoading{color:var(--dsw-alias-brand-primary);margin-left:2px;font-weight:400;animation:1.2s ease-in-out infinite TWf_pa_qnPulse}@keyframes TWf_pa_qnPulse{0%,to{opacity:.4}50%{opacity: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");
@@ -20,10 +76,13 @@ window.__ModuleLoader__.load({
 		var question_nav_module_css_default = {
 			"active": "TWf_pa_active",
 			"count": "TWf_pa_count",
+			"countLoading": "TWf_pa_countLoading",
 			"dot": "TWf_pa_dot",
 			"dots": "TWf_pa_dots",
 			"empty": "TWf_pa_empty",
 			"list": "TWf_pa_list",
+			"moreDot": "TWf_pa_moreDot",
+			"qnPulse": "TWf_pa_qnPulse",
 			"rail": "TWf_pa_rail",
 			"tooltip": "TWf_pa_tooltip"
 		};
@@ -37,9 +96,19 @@ window.__ModuleLoader__.load({
 		* no native-title delay) shows the question's full text; clicking a dot scrolls
 		* the chat to that question.
 		*
+		* Index strategy (no render-window expansion): the dots cover the WHOLE
+		* session history. The index is built from the raw `session.history` RPC via
+		* the injected `fetchQuestionIndex` — the conversation's paged window is
+		* untouched, so DSH's memory economy is preserved. The loaded window's live
+		* questions are merged on top (for new messages arriving after the index was
+		* built). Clicking a dot jumps through the existing paging loop, which calls
+		* `loadOlder()` only until that specific page is in the window. If the index
+		* safety budget is exhausted, a dimmed dashed "load earlier" dot appears above
+		* the oldest question and continues the index on click.
+		*
 		* 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.
+		* hook (current session), the registrant inject face (read/subscribe/jump/
+		* fetch-index), and the bound locale translator.
 		*/
 		const FAILURE_HINTS = {
 			VIEW_INACTIVE: "jump.inactive",
@@ -58,8 +127,18 @@ window.__ModuleLoader__.load({
 			const [jumpingKey, setJumpingKey] = (0, react.useState)(null);
 			const [hint, setHint] = (0, react.useState)(null);
 			const [tooltip, setTooltip] = (0, react.useState)(null);
+			const [loadingIndex, setLoadingIndex] = (0, react.useState)(false);
+			const [moreAvailable, setMoreAvailable] = (0, react.useState)(false);
 			const panelRef = (0, react.useRef)(null);
 			const hintTimerRef = (0, react.useRef)(null);
+			/** Full-history index from the raw RPC (per current session). */
+			const indexRef = (0, react.useRef)([]);
+			/** Next beforeSeq to resume from when the index budget was exhausted. */
+			const nextBeforeSeqRef = (0, react.useRef)(void 0);
+			/** Abort controller for the in-flight index build. */
+			const indexAbortRef = (0, react.useRef)(null);
+			/** Session whose index build is in flight, to avoid duplicate loops. */
+			const buildingSessionRef = (0, react.useRef)(null);
 			const showHint = (message) => {
 				setHint(message);
 				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
@@ -67,14 +146,53 @@ window.__ModuleLoader__.load({
 			};
 			(0, react.useEffect)(() => {
 				if (!visible || current === void 0) {
+					indexRef.current = [];
+					nextBeforeSeqRef.current = void 0;
+					indexAbortRef.current?.abort();
+					indexAbortRef.current = null;
+					buildingSessionRef.current = null;
 					setQuestions([]);
+					setLoadingIndex(false);
+					setMoreAvailable(false);
 					return;
 				}
-				const refresh = () => setQuestions(props.readQuestions(current));
+				const sessionId = current;
+				indexRef.current = [];
+				nextBeforeSeqRef.current = void 0;
+				const refresh = () => {
+					const windowQuestions = props.readQuestions(sessionId);
+					setQuestions(mergeQuestions(indexRef.current, windowQuestions));
+				};
+				const startBuild = (options) => {
+					buildingSessionRef.current = sessionId;
+					const controller = new AbortController();
+					indexAbortRef.current = controller;
+					setLoadingIndex(true);
+					setMoreAvailable(false);
+					props.fetchQuestionIndex(sessionId, {
+						...options,
+						signal: controller.signal
+					}).then((result) => {
+						if (buildingSessionRef.current !== sessionId) return;
+						indexRef.current = mergeQuestions(result.questions, indexRef.current);
+						nextBeforeSeqRef.current = result.nextBeforeSeq;
+						setMoreAvailable(result.code === "BUDGET" && result.nextBeforeSeq !== void 0);
+						refresh();
+					}).finally(() => {
+						if (buildingSessionRef.current === sessionId) {
+							setLoadingIndex(false);
+							if (indexAbortRef.current === controller) indexAbortRef.current = null;
+							buildingSessionRef.current = null;
+						}
+					});
+				};
 				refresh();
-				const unsubContent = props.subscribeContent(current, refresh);
+				startBuild();
+				const unsubContent = props.subscribeContent(sessionId, refresh);
 				const unsubList = props.subscribeList(refresh);
 				return () => {
+					indexAbortRef.current?.abort();
+					indexAbortRef.current = null;
 					unsubContent();
 					unsubList();
 				};
@@ -137,6 +255,18 @@ window.__ModuleLoader__.load({
 				props.jump(current, node.key);
 				window.setTimeout(() => setJumpingKey((k) => k === node.key ? null : k), 600);
 			};
+			const onLoadMore = () => {
+				if (current === void 0 || nextBeforeSeqRef.current === void 0) return;
+				setMoreAvailable(false);
+				setLoadingIndex(true);
+				props.fetchQuestionIndex(current, { startBeforeSeq: nextBeforeSeqRef.current }).then((result) => {
+					if (current === void 0) return;
+					indexRef.current = mergeQuestions(result.questions, indexRef.current);
+					nextBeforeSeqRef.current = result.nextBeforeSeq;
+					setMoreAvailable(result.code === "BUDGET" && result.nextBeforeSeq !== void 0);
+					setQuestions(mergeQuestions(indexRef.current, props.readQuestions(current)));
+				}).finally(() => setLoadingIndex(false));
+			};
 			const t = props.t;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				ref: panelRef,
@@ -152,26 +282,47 @@ window.__ModuleLoader__.load({
 						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")
+							children: loadingIndex ? t("strip.loadingAll") : 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))]
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: question_nav_module_css_default.count,
+									children: [questions.length, loadingIndex ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: question_nav_module_css_default.countLoading,
+										children: t("strip.loadingSuffix")
+									}) : null]
+								}),
+								moreAvailable && !loadingIndex ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									className: `${question_nav_module_css_default.dot} ${question_nav_module_css_default.moreDot}`,
+									"aria-label": t("strip.loadEarlier"),
+									title: t("strip.loadEarlier"),
+									onMouseEnter: (e) => {
+										const r = e.currentTarget.getBoundingClientRect();
+										setTooltip({
+											text: t("strip.loadEarlier"),
+											left: r.right + 10,
+											top: r.top
+										});
+									},
+									onMouseLeave: () => setTooltip(null),
+									onClick: onLoadMore
+								}) : null,
+								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", {
@@ -193,6 +344,9 @@ window.__ModuleLoader__.load({
 		*/
 		const zh = {
 			"strip.empty": "本会话还没有提问",
+			"strip.loadingAll": "正在加载全部历史…",
+			"strip.loadingSuffix": "…",
+			"strip.loadEarlier": "加载更早的问题",
 			"jump.inactive": "聊天视图未激活",
 			"jump.hidden": "目标无独立气泡，已定位到邻近内容",
 			"jump.notfound": "目标未加载或不存在（可能已压缩）",
@@ -200,57 +354,15 @@ window.__ModuleLoader__.load({
 		};
 		const en = {
 			"strip.empty": "No questions in this session yet",
+			"strip.loadingAll": "Loading full history…",
+			"strip.loadingSuffix": "…",
+			"strip.loadEarlier": "Load earlier questions",
 			"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
@@ -258,7 +370,7 @@ window.__ModuleLoader__.load({
 		* 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 = {
+		const DEFAULTS$1 = {
 			totalTimeoutMs: 15e3,
 			maxPages: 100,
 			rowWaitMs: 8e3,
@@ -287,7 +399,7 @@ window.__ModuleLoader__.load({
 		*/
 		async function jumpToQuestion(ports, key, options = {}) {
 			const cfg = {
-				...DEFAULTS,
+				...DEFAULTS$1,
 				...options
 			};
 			const fail = (code, fallback = false) => {
@@ -353,6 +465,133 @@ window.__ModuleLoader__.load({
 			return fail("TARGET_HIDDEN", false);
 		}
 		//#endregion
+		//#region src/core/history-index.ts
+		/** The conversation Definition kind whose key a user question node uses. */
+		const MESSAGE_DEFINITION_KIND = "input-message";
+		/**
+		* The engine-owned stable chat key for a user question event — mirrors
+		* `conversationContextKey('input-message', String(id))` from the DSH runtime
+		* (verified against it in the unit test).
+		*/
+		function questionKey(id) {
+			return `13:${MESSAGE_DEFINITION_KIND}${String(id)}`;
+		}
+		/**
+		* Whether a raw event is one user question the strip should index.
+		* Mirrors the DSH `messageDefinition` match + `start` classification:
+		* an append-origin `user/message` with a human (`user`) source. Replacement
+		* copies (compaction checkpoints, `source.kind === 'plugin'`) and injected
+		* context (`source.kind !== 'user'`) are excluded.
+		*/
+		function isQuestionEvent(event) {
+			if (event.type !== "user/message") return false;
+			if (event.surfaceOp !== "append") return false;
+			return event.data?.source?.kind === "user";
+		}
+		/** Map one raw question event to a strip question node, or null when not one. */
+		function questionFromEvent(event) {
+			if (!isQuestionEvent(event)) return null;
+			return {
+				key: questionKey(event.data?.id),
+				anchorSeq: event.seq,
+				seq: event.seq,
+				time: event.time,
+				text: messageText(event.data?.content)
+			};
+		}
+		const DEFAULTS = {
+			maxMessages: 100,
+			maxPages: 200,
+			totalTimeoutMs: 3e4
+		};
+		function minSeq(events) {
+			let min;
+			for (const { event } of events) if (min === void 0 || event.seq < min) min = event.seq;
+			return min;
+		}
+		/**
+		* Page the raw session history backward, collecting every user question into a
+		* lightweight index. Never touches the render window.
+		*/
+		async function buildQuestionIndex(ports, options = {}) {
+			const cfg = {
+				...DEFAULTS,
+				...options
+			};
+			const deadline = ports.now() + cfg.totalTimeoutMs;
+			const questions = [];
+			let beforeSeq = cfg.startBeforeSeq;
+			let pages = 0;
+			const cancelled = () => cfg.signal?.aborted === true;
+			while (true) {
+				if (cancelled()) return {
+					ok: false,
+					code: "CANCELLED",
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
+				};
+				if (ports.now() > deadline) return {
+					ok: false,
+					code: "TIMEOUT",
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
+				};
+				if (pages >= cfg.maxPages) return {
+					ok: false,
+					code: "BUDGET",
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
+				};
+				const page = await ports.history(beforeSeq, cfg.maxMessages);
+				if (page === void 0) {
+					if (pages === 0) return {
+						ok: false,
+						code: "UNAVAILABLE",
+						questions,
+						pages,
+						nextBeforeSeq: beforeSeq
+					};
+					return {
+						ok: true,
+						code: "COMPLETE",
+						questions,
+						pages,
+						nextBeforeSeq: void 0
+					};
+				}
+				for (const { event } of page.events) {
+					const question = questionFromEvent(event);
+					if (question !== null) questions.push(question);
+				}
+				if (!page.hasMore) {
+					questions.sort((a, b) => a.anchorSeq - b.anchorSeq);
+					return {
+						ok: true,
+						code: "COMPLETE",
+						questions,
+						pages,
+						nextBeforeSeq: void 0
+					};
+				}
+				const next = minSeq(page.events);
+				if (next === void 0) {
+					questions.sort((a, b) => a.anchorSeq - b.anchorSeq);
+					return {
+						ok: true,
+						code: "COMPLETE",
+						questions,
+						pages,
+						nextBeforeSeq: void 0
+					};
+				}
+				beforeSeq = next;
+				pages += 1;
+			}
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/** Locale namespace this plugin owns. */
 		const NS = "question-nav";
@@ -360,7 +599,8 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"sessions"
+			"sessions",
+			"connection"
 		];
 		function claimApply() {
 			if (globalThis.__dshQuestionNavApplied === true) return false;
@@ -398,6 +638,37 @@ window.__ModuleLoader__.load({
 				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
 			};
 		}
+		/** Resolve the connection handle (shared API client) as other DSH plugins do. */
+		function connectionOf(ctx) {
+			return ctx.get("connection");
+		}
+		/**
+		* One raw history page, mapped to the pure `buildQuestionIndex` port shape.
+		* `beforeSeq` is exclusive; `undefined` reads the newest page. Returns
+		* undefined when the page is unavailable so the builder stops cleanly. The
+		* SDK's `SessionEvent` is cast to the structural `RawEventLike` at this
+		* boundary (the index reader only touches type/seq/time/surfaceOp/data).
+		*/
+		async function rawHistoryPage(ctx, sessionId, beforeSeq, maxMessages) {
+			const { api } = connectionOf(ctx);
+			const { result } = await api.sessions.history({
+				sessionId,
+				beforeSeq,
+				maxMessages
+			});
+			if (!result.ok) return void 0;
+			return {
+				events: result.value.events.map((entry) => ({ event: entry.event })),
+				hasMore: result.value.hasMore
+			};
+		}
+		/** Build the full-session question index from the raw history RPC (no render). */
+		function buildIndexFor(ctx, sessionId, options = {}) {
+			return buildQuestionIndex({
+				history: (beforeSeq, maxMessages) => rawHistoryPage(ctx, sessionId, beforeSeq, maxMessages),
+				now: () => Date.now()
+			}, options);
+		}
 		function createInject(ctx) {
 			return {
 				readQuestions: (sessionId) => {
@@ -417,7 +688,8 @@ window.__ModuleLoader__.load({
 						window.dispatchEvent(new CustomEvent("question-nav:jump-failed", { detail: code }));
 					};
 					jumpToQuestion(ports, key);
-				}
+				},
+				fetchQuestionIndex: (sessionId, options) => buildIndexFor(ctx, sessionId, options)
 			};
 		}
 		/**