@luziyang2026/dsh-question-nav 0.2.0 → 0.3.0

package/README.md

@@ -17,15 +17,18 @@ Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm]).
 - **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.
-- **Full history**: on show, the strip auto-expands the session's older pages
-  (paging DSH's own "load older" window) so even questions that are still
-  collapsed behind the load-more button surface as dots. While expanding, the
-  count shows a "…" affordance; if the safety budget is exhausted a dimmed
-  dashed dot above the oldest question offers "load earlier" on click.
+- **Full history, no render-window expansion**: the index is built by paging
+  the raw `session.history` RPC (read-only), so every question in the session —
+  including ones still collapsed behind DSH's "load older" button — appears as
+  a dot without expanding the conversation's paged window (memory economy
+  preserved). While the index is building the count shows a "…"; if the safety
+  budget is exhausted a dimmed dashed dot above the oldest question offers
+  "load earlier" on click.
 - **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).
+- **Click**: jumps to that question. Only then does the jump loop page the
+  window (`loadOlder()`) to bring that specific page into view — never the
+  whole history up front.
 - Empty/left areas of the rail pass pointer events through to the conversation
   (it never blocks the chat).
 

package/README.zh.md

@@ -14,11 +14,14 @@
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
 - **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
-- **完整历史**：显示时自动向后翻页展开整个会话历史，连"加载更早"按钮后面
-  折叠隐藏的老提问也会变成圆点。展开过程中数量后显示 "…"；若超过安全预算，
-  最老提问上方会出现一个虚线圆点，点击可继续加载更早提问。
+- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
+  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
+  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
+  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
+  上方会出现一个虚线圆点，点击继续加载。
 - **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
-- **点击**：跳转到该提问，目标尚未加载时自动 `loadOlder` 扩窗（并落到最近可见行兜底）。
+- **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
+  带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
 
 ## 环境要求

package/lib/client.js

@@ -7,6 +7,62 @@ 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_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";
@@ -40,15 +96,19 @@ window.__ModuleLoader__.load({
 		* no native-title delay) shows the question's full text; clicking a dot scrolls
 		* the chat to that question.
 		*
-		* Dots index the WHOLE session history, not just the currently loaded window:
-		* on show, the strip auto-expands older pages (`loadAllOlder`) so questions
-		* that still sit behind DSH's "load older" button are surfaced too. While the
-		* expansion is running the count shows a "…" affordance; if the safety budget
-		* is exhausted a dimmed "load earlier" dot appears above the oldest 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/
-		* load-all), and the bound locale translator.
+		* fetch-index), and the bound locale translator.
 		*/
 		const FAILURE_HINTS = {
 			VIEW_INACTIVE: "jump.inactive",
@@ -67,14 +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 [loadingAll, setLoadingAll] = (0, react.useState)(false);
+			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);
-			/** Abort controller for the in-flight expansion (cancelled on session change). */
-			const loadAllAbortRef = (0, react.useRef)(null);
-			/** Session whose expansion is already running, to avoid duplicate loops. */
-			const loadingAllSessionRef = (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);
@@ -82,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();
 				};
@@ -98,36 +201,6 @@ window.__ModuleLoader__.load({
 				current,
 				props
 			]);
-			(0, react.useEffect)(() => {
-				if (!visible || current === void 0) {
-					loadAllAbortRef.current?.abort();
-					loadAllAbortRef.current = null;
-					loadingAllSessionRef.current = null;
-					setLoadingAll(false);
-					setMoreAvailable(false);
-					return;
-				}
-				if (loadingAllSessionRef.current === current) return;
-				loadingAllSessionRef.current = current;
-				const controller = new AbortController();
-				loadAllAbortRef.current = controller;
-				setLoadingAll(true);
-				setMoreAvailable(false);
-				props.loadAllOlder(current, { signal: controller.signal }).then((result) => {
-					setMoreAvailable(result.code === "BUDGET" && !result.ok);
-				}).finally(() => {
-					setLoadingAll(false);
-					if (loadAllAbortRef.current === controller) loadAllAbortRef.current = null;
-					loadingAllSessionRef.current = null;
-				});
-				return () => {
-					controller.abort();
-				};
-			}, [
-				visible,
-				current,
-				props
-			]);
 			(0, react.useEffect)(() => {
 				const onJumpFailed = (event) => {
 					const code = event.detail;
@@ -183,12 +256,16 @@ window.__ModuleLoader__.load({
 				window.setTimeout(() => setJumpingKey((k) => k === node.key ? null : k), 600);
 			};
 			const onLoadMore = () => {
-				if (current === void 0) return;
+				if (current === void 0 || nextBeforeSeqRef.current === void 0) return;
 				setMoreAvailable(false);
-				setLoadingAll(true);
-				props.loadAllOlder(current).then((result) => {
-					setMoreAvailable(result.code === "BUDGET" && !result.ok);
-				}).finally(() => setLoadingAll(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", {
@@ -205,18 +282,18 @@ 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: loadingAll ? t("strip.loadingAll") : 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.jsxs)("span", {
 									className: question_nav_module_css_default.count,
-									children: [questions.length, loadingAll ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									children: [questions.length, loadingIndex ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: question_nav_module_css_default.countLoading,
 										children: t("strip.loadingSuffix")
 									}) : null]
 								}),
-								moreAvailable && !loadingAll ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								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"),
@@ -286,51 +363,6 @@ window.__ModuleLoader__.load({
 			"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
@@ -433,68 +465,129 @@ window.__ModuleLoader__.load({
 			return fail("TARGET_HIDDEN", false);
 		}
 		//#endregion
-		//#region src/core/load-all.ts
+		//#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 = {
-			maxPages: 400,
-			totalTimeoutMs: 6e4,
-			pollMs: 60
+			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;
+		}
 		/**
-		* Expand the session window backwards until the earliest history is loaded.
-		* Waits while the session is still opening; aborts on cancellation, budget or
-		* timeout. Safe to re-enter: once `hasMore` is false the loop returns
-		* immediately with `COMPLETE`.
+		* Page the raw session history backward, collecting every user question into a
+		* lightweight index. Never touches the render window.
 		*/
-		async function loadAllOlder(ports, options = {}) {
+		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",
-					pages
-				};
-				if (!ports.isViewActive()) return {
-					ok: false,
-					code: "VIEW_INACTIVE",
-					pages
-				};
-				const snap = ports.snapshot();
-				if (snap === void 0) return {
-					ok: false,
-					code: "VIEW_INACTIVE",
-					pages
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
 				};
-				if (snap.openState === "error") return {
+				if (ports.now() > deadline) return {
 					ok: false,
-					code: "NOT_OPEN",
-					pages
-				};
-				if (snap.hasMore !== true) return {
-					ok: true,
-					code: "COMPLETE",
-					pages
+					code: "TIMEOUT",
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
 				};
 				if (pages >= cfg.maxPages) return {
 					ok: false,
 					code: "BUDGET",
-					pages
+					questions,
+					pages,
+					nextBeforeSeq: beforeSeq
 				};
-				if (ports.now() > deadline) return {
-					ok: false,
-					code: "TIMEOUT",
-					pages
-				};
-				if (snap.openState !== "open" || snap.loadingOlder) {
-					await ports.sleep(cfg.pollMs);
-					continue;
+				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
+					};
 				}
-				await ports.loadOlder();
+				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;
 			}
 		}
@@ -506,7 +599,8 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"sessions"
+			"sessions",
+			"connection"
 		];
 		function claimApply() {
 			if (globalThis.__dshQuestionNavApplied === true) return false;
@@ -544,49 +638,36 @@ window.__ModuleLoader__.load({
 				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
 			};
 		}
-		/** Resolve the active conversation scrollport (or null when not mounted). */
-		function scrollport() {
-			return document.querySelector("[data-conversation-scroll]");
+		/** Resolve the connection handle (shared API client) as other DSH plugins do. */
+		function connectionOf(ctx) {
+			return ctx.get("connection");
 		}
 		/**
-		* One backward page that preserves the reader's scroll position. DSH's own
-		* "load older" button arms a paging anchor; a programmatic `loadOlder()` does
-		* not, so without this compensation prepended content would push the visible
-		* rows down. We restore by the exact growth of the scrollHeight.
+		* 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 pagedLoadOlder(ctx, sessionId) {
-			const binding = ctx.sessions.binding(sessionId);
-			if (binding === void 0) return;
-			const port = scrollport();
-			const beforeHeight = port?.scrollHeight ?? 0;
-			const beforeTop = port?.scrollTop ?? 0;
-			await binding.session.loadOlder();
-			if (port === null) return;
-			await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
-			const delta = port.scrollHeight - beforeHeight;
-			if (delta > 0) port.scrollTop = beforeTop + delta;
-		}
-		/** Map the session to the load-all port surface. */
-		function loadAllPortsFor(ctx, sessionId) {
+		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 {
-				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
-					};
-				},
-				loadOlder: () => pagedLoadOlder(ctx, sessionId),
-				isViewActive: () => document.querySelector("[data-chat-flow]") !== null,
-				now: () => Date.now(),
-				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
+				events: result.value.events.map((entry) => ({ event: entry.event })),
+				hasMore: result.value.hasMore
 			};
 		}
-		/** Expand the whole session history so every question becomes a dot. */
-		function loadAllFor(ctx, sessionId, options = {}) {
-			return loadAllOlder(loadAllPortsFor(ctx, sessionId), options);
+		/** 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 {
@@ -608,7 +689,7 @@ window.__ModuleLoader__.load({
 					};
 					jumpToQuestion(ports, key);
 				},
-				loadAllOlder: (sessionId, options) => loadAllFor(ctx, sessionId, options)
+				fetchQuestionIndex: (sessionId, options) => buildIndexFor(ctx, sessionId, options)
 			};
 		}
 		/**