@luziyang2026/dsh-question-nav 0.4.0 → 0.4.2

package/LICENSE

@@ -1,29 +1,21 @@
-BSD 3-Clause License
+MIT License
 
-Copyright (c) 2026, Abel Keith Sun. All rights reserved.
+Copyright (c) 2026 Abel Keith Sun
 
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-1. Redistributions of source code must retain the above copyright notice,
-   this list of conditions and the following disclaimer.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-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.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,22 +10,26 @@ 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.
 
-Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm]).
+Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
+
+## Preview
+
+![Left-edge dot minimap with a hover tooltip showing the turn label and full question text](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## 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.
-- **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.
+- **One dot = one turn that asked a question** (strictly aligned with the
+  Trajectory view's turn numbering), with a small count above the dot column.
+- **Full history, persisted, no render-window expansion**: the plugin's host
+  half registers a `questionIndex` session projection — the projection
+  registry folds the whole event log (read-only, the chat's paged window is
+  never touched), the official projection cache persists it across restarts,
+  and push frames deliver new questions live.
 - **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
-  native-title delay) shows the question's **full text**.
+  native-title delay) shows the **turn label** (`Turn N`) plus the turn's
+  **full question text** (all of them, when one turn batched several).
 - **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.
@@ -79,8 +83,9 @@ module table.
 
 ## License
 
-BSD-3-Clause.
+MIT.
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/README.zh.md

@@ -7,19 +7,24 @@
 它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
 外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
 
-包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm]）。
+包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm] · [GitHub][github]）。
+
+## 效果展示
+
+![左缘圆点迷你地图：竖排圆点，每个圆点对应一个用户提问，悬停显示 Turn 编号与全文](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## 功能
 
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
-- **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
-- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
-  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
-  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
-  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
-  上方会出现一个虚线圆点，点击继续加载。
-- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
+- **一个圆点 = 一个含提问的 turn**（与轨迹视图的 Turn 编号严格对齐），
+  圆点列上方有圆点数量。
+- **完整历史、持久化、不展开渲染窗口**：插件的 host 半面注册
+  `questionIndex` 会话投影——投影注册表折叠完整事件日志（只读，对话的
+  分页窗口完全不被动），官方 projection-cache 跨重启持久化，新提问通过
+  推送帧实时到达。
+- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示
+  **Turn 编号**（`Turn N`）和该轮提问**全文**（一轮多条提问时全部列出）。
 - **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
   带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
@@ -69,8 +74,9 @@ externals 经加载器模块表解析。
 
 ## License
 
-BSD-3-Clause。
+MIT。
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/lib/client.js

@@ -18,13 +18,21 @@ window.__ModuleLoader__.load({
 		function questionKey(id) {
 			return `13:${MESSAGE_DEFINITION_KIND}${String(id)}`;
 		}
+		/** True when entries are already in non-decreasing seq order (the projection
+		* appends in event order, so this is the common case and skips the sort). */
+		function isSortedBySeq(entries) {
+			for (let i = 1; i < entries.length; i++) if (entries[i].seq < entries[i - 1].seq) return false;
+			return true;
+		}
 		/**
 		* Fold the projection's question list into one dot per turn. Entries arrive
 		* in event order; consecutive same-turn entries merge into a single dot whose
-		* anchor is the turn's first question.
+		* anchor is the turn's first question. The input is expected to be sorted by
+		* seq; the defensive sort is skipped when it already is, so a long session
+		* never pays an O(n log n) sort on every content update.
 		*/
 		function groupQuestionsByTurn(entries) {
-			const sorted = [...entries].sort((a, b) => a.seq - b.seq);
+			const sorted = isSortedBySeq(entries) ? entries : [...entries].sort((a, b) => a.seq - b.seq);
 			const dots = [];
 			for (const entry of sorted) {
 				const key = questionKey(entry.id);
@@ -54,19 +62,41 @@ window.__ModuleLoader__.load({
 		* whose key is already folded into a dot is dropped (the projected copy
 		* wins); the rest become single-question dots with `turn: null`, inserted in
 		* anchor-seq order so the strip stays strictly chronological.
+		*
+		* Fast path: when nothing new arrives the SAME array is returned (no copy),
+		* so the caller can bail out of a re-render on identical reference.
 		*/
 		function mergeLiveQuestions(dots, live) {
-			const known = new Set(dots.flatMap((dot) => dot.memberKeys));
-			const extras = live.filter((question) => !known.has(question.key)).map((question) => ({
-				turn: null,
-				key: question.key,
-				anchorSeq: question.anchorSeq,
-				time: question.time,
-				texts: [question.text],
-				memberKeys: [question.key]
-			}));
-			if (extras.length === 0) return [...dots];
-			return [...dots, ...extras].sort((a, b) => a.anchorSeq - b.anchorSeq);
+			if (live.length === 0) return dots;
+			const known = /* @__PURE__ */ new Set();
+			for (const dot of dots) for (const key of dot.memberKeys) known.add(key);
+			const extras = [];
+			for (const question of live) {
+				if (known.has(question.key)) continue;
+				extras.push({
+					turn: null,
+					key: question.key,
+					anchorSeq: question.anchorSeq,
+					time: question.time,
+					texts: [question.text],
+					memberKeys: [question.key]
+				});
+			}
+			if (extras.length === 0) return dots;
+			const out = [];
+			let i = 0;
+			for (const extra of extras) {
+				while (i < dots.length && dots[i].anchorSeq <= extra.anchorSeq) {
+					out.push(dots[i]);
+					i += 1;
+				}
+				out.push(extra);
+			}
+			while (i < dots.length) {
+				out.push(dots[i]);
+				i += 1;
+			}
+			return out;
 		}
 		//#endregion
 		//#region \0dsh-css:dsh-question-nav/src/client/question-nav.module.css.mjs
@@ -129,6 +159,19 @@ window.__ModuleLoader__.load({
 		function findConvRoot() {
 			return document.querySelector("[data-slot=\"conversation\"] > div[data-phase]");
 		}
+		/** Structural equality of two dot lists (member keys fully capture a dot's
+		* folded questions, so identical key sequences mean identical content).
+		* Lets the strip skip a re-render when a refresh produced no change. */
+		function sameDots(a, b) {
+			if (a.length !== b.length) return false;
+			for (let i = 0; i < a.length; i++) {
+				const da = a[i];
+				const db = b[i];
+				if (da.key !== db.key || da.memberKeys.length !== db.memberKeys.length) return false;
+				for (let j = 0; j < da.memberKeys.length; j++) if (da.memberKeys[j] !== db.memberKeys[j]) return false;
+			}
+			return true;
+		}
 		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]);
@@ -139,6 +182,7 @@ window.__ModuleLoader__.load({
 			const [tooltip, setTooltip] = (0, react.useState)(null);
 			const panelRef = (0, react.useRef)(null);
 			const hintTimerRef = (0, react.useRef)(null);
+			const lastDotsRef = (0, react.useRef)([]);
 			const showHint = (message) => {
 				setHint(message);
 				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
@@ -147,22 +191,26 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => {
 				if (!visible || current === void 0) {
 					setDots([]);
+					lastDotsRef.current = [];
 					return;
 				}
 				const sessionId = current;
 				const face = props.questionProjection(sessionId);
 				const refresh = () => {
-					const grouped = groupQuestionsByTurn(projectionEntries(face));
-					setDots(mergeLiveQuestions(grouped, props.readQuestions(sessionId)));
+					const next = mergeLiveQuestions(groupQuestionsByTurn(projectionEntries(face)), props.readQuestions(sessionId));
+					if (sameDots(next, lastDotsRef.current)) {
+						setDots(lastDotsRef.current);
+						return;
+					}
+					lastDotsRef.current = next;
+					setDots(next);
 				};
 				refresh();
 				const unsubProjection = face?.subscribe(refresh) ?? (() => {});
 				const unsubContent = props.subscribeContent(sessionId, refresh);
-				const unsubList = props.subscribeList(refresh);
 				return () => {
 					unsubProjection();
 					unsubContent();
-					unsubList();
 				};
 			}, [
 				visible,
@@ -180,37 +228,72 @@ window.__ModuleLoader__.load({
 			(0, react.useLayoutEffect)(() => {
 				if (!visible) return;
 				let raf = 0;
-				let retries = 0;
+				let idle = 0;
+				let stopped = false;
+				let observer = null;
+				const observed = {
+					frame: null,
+					convRoot: null
+				};
 				const applyLayout = () => {
 					const panel = panelRef.current;
-					if (panel === null) return;
+					if (panel === null) return false;
 					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);
+					if (frame === null || convRoot === null) return true;
+					if (observer !== null) {
+						if (observed.frame !== frame) {
+							observer.observe(frame, { box: "border-box" });
+							observed.frame = frame;
+						}
+						if (observed.convRoot !== convRoot) {
+							observer.observe(convRoot, { box: "border-box" });
+							observed.convRoot = convRoot;
 						}
-						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`;
+					const frameRect = frame.getBoundingClientRect();
+					const convRect = convRoot.getBoundingClientRect();
+					if (convRect.height <= 0 || convRect.width <= 0) return true;
+					const top = `${convRect.top - frameRect.top}px`;
+					const height = `${convRect.height}px`;
+					const left = `${convRect.left - frameRect.left}px`;
+					if (panel.style.top === top && panel.style.height === height && panel.style.left === left) return false;
+					panel.style.top = top;
+					panel.style.height = height;
+					panel.style.left = left;
+					return true;
+				};
+				const loop = () => {
+					if (stopped) return;
+					raf = 0;
+					idle = applyLayout() ? 0 : idle + 1;
+					if (idle < 3) raf = requestAnimationFrame(loop);
 				};
-				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);
+				const wake = () => {
+					if (stopped) return;
+					idle = 0;
+					if (raf === 0) raf = requestAnimationFrame(loop);
+				};
+				observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(wake);
+				if (observer !== null) {
+					const frame = panelRef.current?.closest("[data-shell-overlay]")?.parentElement ?? null;
+					const convRoot = findConvRoot();
+					if (frame !== null) {
+						observer.observe(frame, { box: "border-box" });
+						observed.frame = frame;
+					}
+					if (convRoot !== null) {
+						observer.observe(convRoot, { box: "border-box" });
+						observed.convRoot = convRoot;
+					}
+				}
+				wake();
+				window.addEventListener("resize", wake);
 				return () => {
+					stopped = true;
 					if (raf !== 0) cancelAnimationFrame(raf);
 					observer?.disconnect();
-					window.removeEventListener("resize", applyLayout);
+					window.removeEventListener("resize", wake);
 				};
 			}, [visible]);
 			(0, react.useEffect)(() => () => {

package/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["kind","useState","useRef","styles","createPortal"],"sources":["../src/core/turn-dots.ts","../src/client/QuestionNavStrip.tsx","../src/client/locales.ts","../src/core/nodes.ts","../src/core/jump.ts","../src/client/index.ts"],"sourcesContent":["/**\n * Turn-aligned dot model for the question-nav strip. Pure transforms over the\n * `questionIndex` projection value plus the live chat window — no React, no\n * DOM — so the grouping and merging rules are unit-testable in isolation.\n *\n * One dot per turn that claimed at least one user question; turns without a\n * question (retry, goal continuation, cancelled empty turns) produce no dot,\n * so dot turn labels may skip numbers but always match the Trajectory view.\n */\n\nimport type { QuestionEntry } from './question-entry.ts'\nimport type { QuestionNode } from './nodes.ts'\n\n/** The conversation Definition kind whose key a user question node uses. */\nexport const MESSAGE_DEFINITION_KIND = 'input-message'\n\n/**\n * The engine-owned stable chat key for a user question — mirrors\n * `conversationContextKey('input-message', String(id))` from the DSH runtime\n * (verified against that formula in the unit test).\n */\nexport function questionKey(id: unknown): string {\n  const kind = MESSAGE_DEFINITION_KIND\n  return `${kind.length}:${kind}${String(id)}`\n}\n\n/** One strip dot: a turn's questions (grouped) or one ungrouped live question. */\nexport interface TurnDot {\n  /** Owning turn number; null for live questions the projection has not seen. */\n  readonly turn: number | null\n  /** Jump anchor: the chat key of the turn's FIRST question. */\n  readonly key: string\n  /** Anchor seq of the first question (ordering + jump target). */\n  readonly anchorSeq: number\n  /** Unix ms of the first question. */\n  readonly time: number\n  /** Every question text of this dot, in order (tooltip lists them all). */\n  readonly texts: readonly string[]\n  /** Chat keys of every question folded into this dot (live-merge dedupe). */\n  readonly memberKeys: readonly string[]\n}\n\n/**\n * Fold the projection's question list into one dot per turn. Entries arrive\n * in event order; consecutive same-turn entries merge into a single dot whose\n * anchor is the turn's first question.\n */\nexport function groupQuestionsByTurn(entries: readonly QuestionEntry[]): TurnDot[] {\n  const sorted = [...entries].sort((a, b) => a.seq - b.seq)\n  const dots: TurnDot[] = []\n  for (const entry of sorted) {\n    const key = questionKey(entry.id)\n    const last = dots.at(-1)\n    if (last !== undefined && last.turn === entry.turn) {\n      dots[dots.length - 1] = {\n        ...last,\n        texts: [...last.texts, entry.text],\n        memberKeys: [...last.memberKeys, key],\n      }\n      continue\n    }\n    dots.push({\n      turn: entry.turn,\n      key,\n      anchorSeq: entry.seq,\n      time: entry.time,\n      texts: [entry.text],\n      memberKeys: [key],\n    })\n  }\n  return dots\n}\n\n/**\n * Merge live-window questions the projection has not recorded yet (the brief\n * window before the session/projection push frame lands). A live question\n * whose key is already folded into a dot is dropped (the projected copy\n * wins); the rest become single-question dots with `turn: null`, inserted in\n * anchor-seq order so the strip stays strictly chronological.\n */\nexport function mergeLiveQuestions(\n  dots: readonly TurnDot[],\n  live: readonly QuestionNode[],\n): TurnDot[] {\n  const known = new Set(dots.flatMap(dot => dot.memberKeys))\n  const extras: TurnDot[] = live\n    .filter(question => !known.has(question.key))\n    .map(question => ({\n      turn: null,\n      key: question.key,\n      anchorSeq: question.anchorSeq,\n      time: question.time,\n      texts: [question.text],\n      memberKeys: [question.key],\n    }))\n  if (extras.length === 0) return [...dots]\n  return [...dots, ...extras].sort((a, b) => a.anchorSeq - b.anchorSeq)\n}\n","/**\n * Question-nav minimap. Renders a vertical column of small round dots overlaid\n * on the LEFT edge of the conversation column (via the frame-wide\n * `shell.overlay` floating layer), vertically centered: one dot per turn that\n * claimed at least one user question — strictly aligned with the Trajectory\n * view's turn numbering (turns without a question produce no dot). Hover\n * enlarges a dot and shows an instant tooltip (portal-rendered, no native\n * delay) with the turn label and the turn's question text(s); clicking jumps\n * the chat to that turn's first question.\n *\n * Data source: the host-folded `questionIndex` session projection (whole\n * history, persisted host-side, pushed live through session/projection\n * frames) read through the injected `questionProjection` face, plus the live\n * chat window's questions merged on top for the brief window before a\n * just-sent question lands in the projection. No render-window expansion, no\n * client-side history paging.\n *\n * Data arrives through the props shares: the framework `useSessions` hook\n * (current session), the registrant inject face (read/subscribe/project/\n * jump), and the bound locale translator.\n */\nimport { useEffect, useLayoutEffect, useRef, useState } from 'react'\nimport { createPortal } from 'react-dom'\nimport type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { SessionId } from '@deepseek-ai/dsh-client-connection/client'\n// Type-only: pulls the ui-layout SlotMap merge ('shell.overlay').\nimport type {} from '@deepseek-ai/dsh-client-ui-layout/client'\nimport type { QuestionNode } from '../core/nodes.ts'\nimport type { QuestionEntry } from '../core/question-entry.ts'\nimport { groupQuestionsByTurn, mergeLiveQuestions, type TurnDot } from '../core/turn-dots.ts'\nimport type { JumpFailureCode } from '../core/jump.ts'\nimport type { QuestionNavKey } from './locales.ts'\nimport styles from './question-nav.module.css'\n\n/** Minimal observable shape of a session projection face. */\nexport interface ObservableFace {\n  /** Current projection value (unknown — validated structurally at read). */\n  getSnapshot: () => unknown\n  /** Subscribe to value changes; returns an unsubscribe. */\n  subscribe: (listener: () => void) => () => void\n}\n\n/** Values the registrant inject face supplies (wired in src/client/index.ts). */\nexport interface QuestionNavInjected {\n  /** Extract the user questions of a session's currently loaded window. */\n  readQuestions: (sessionId: SessionId) => QuestionNode[]\n  /** Subscribe to the session list; returns an unsubscribe. */\n  subscribeList: (cb: () => void) => () => void\n  /** Subscribe to a session's content; returns an unsubscribe. */\n  subscribeContent: (sessionId: SessionId, cb: () => void) => () => void\n  /** The session's `questionIndex` projection face, when the host unit is registered. */\n  questionProjection: (sessionId: SessionId) => ObservableFace | undefined\n  /** Jump the chat to a question row (pages the window on demand). */\n  jump: (sessionId: SessionId, key: string) => void\n}\n\ntype ComponentProps = PropsRuntime<'shell.overlay'> & QuestionNavInjected & PropsLocale<'question-nav'>\n\nconst FAILURE_HINTS: Record<JumpFailureCode, QuestionNavKey> = {\n  VIEW_INACTIVE: 'jump.inactive',\n  TARGET_HIDDEN: 'jump.hidden',\n  NOT_FOUND: 'jump.notfound',\n  TIMEOUT: 'jump.timeout',\n}\n\n/** Live position of the instant hover tooltip. */\ninterface TooltipState {\n  /** Turn label line (e.g. \"Turn 32\"); null for ungrouped live questions. */\n  title: string | null\n  /** Question text lines (one per question folded into the dot). */\n  lines: readonly string[]\n  left: number\n  top: number\n}\n\n/** Read the projection face value as a question-entry list (structural guard). */\nfunction projectionEntries(face: ObservableFace | undefined): QuestionEntry[] {\n  const value = face?.getSnapshot()\n  if (!Array.isArray(value)) return []\n  return value.filter((item): item is QuestionEntry =>\n    typeof item === 'object' && item !== null\n    && typeof (item as QuestionEntry).id === 'string'\n    && typeof (item as QuestionEntry).seq === 'number'\n    && typeof (item as QuestionEntry).turn === 'number')\n}\n\nfunction findConvRoot(): HTMLElement | null {\n  return document.querySelector<HTMLElement>('[data-slot=\"conversation\"] > div[data-phase]')\n}\n\nexport function QuestionNavStrip(props: ComponentProps): React.JSX.Element | null {\n  const current = props.useSessions((s) => s.current)\n  const summary = props.useSessions((s) => (s.current === undefined ? undefined : s.byId[s.current]))\n  const visible = current !== undefined && summary !== undefined && summary.blank !== true\n\n  const [dots, setDots] = useState<TurnDot[]>([])\n  const [jumpingKey, setJumpingKey] = useState<string | null>(null)\n  const [hint, setHint] = useState<string | null>(null)\n  const [tooltip, setTooltip] = useState<TooltipState | null>(null)\n  const panelRef = useRef<HTMLDivElement | null>(null)\n  const hintTimerRef = useRef<number | null>(null)\n\n  const showHint = (message: string): void => {\n    setHint(message)\n    if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current)\n    hintTimerRef.current = window.setTimeout(() => setHint(null), 1800)\n  }\n\n  // Recompute the dot list from the projection + live window; subscribe to\n  // the projection push frames, session content, and the session list.\n  useEffect(() => {\n    if (!visible || current === undefined) {\n      setDots([])\n      return\n    }\n    const sessionId = current\n    const face = props.questionProjection(sessionId)\n    const refresh = (): void => {\n      const grouped = groupQuestionsByTurn(projectionEntries(face))\n      setDots(mergeLiveQuestions(grouped, props.readQuestions(sessionId)))\n    }\n    refresh()\n    const unsubProjection = face?.subscribe(refresh) ?? (() => {})\n    const unsubContent = props.subscribeContent(sessionId, refresh)\n    const unsubList = props.subscribeList(refresh)\n    return () => {\n      unsubProjection()\n      unsubContent()\n      unsubList()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [visible, current, props])\n\n  // Listen for jump-failure events and surface the hint.\n  useEffect(() => {\n    const onJumpFailed = (event: Event): void => {\n      const code = (event as CustomEvent<JumpFailureCode>).detail\n      showHint(props.t(FAILURE_HINTS[code] ?? 'jump.timeout'))\n    }\n    window.addEventListener('question-nav:jump-failed', onJumpFailed)\n    return () => window.removeEventListener('question-nav:jump-failed', onJumpFailed)\n  }, [props])\n\n  // Anchor the minimap to the conversation column: position it at the left\n  // edge of the conversation root and reserve a thin rail with padding-left.\n  useLayoutEffect(() => {\n    if (!visible) return\n    let raf = 0\n    let retries = 0\n    const applyLayout = (): void => {\n      const panel = panelRef.current\n      if (panel === null) return\n      const frame = panel.closest('[data-shell-overlay]')?.parentElement ?? null\n      const convRoot = findConvRoot()\n      if (frame === null || convRoot === null) return\n      const frameRect = frame.getBoundingClientRect()\n      const convRect = convRoot.getBoundingClientRect()\n      if (convRect.height <= 0) {\n        if (retries < 20) {\n          retries += 1\n          raf = requestAnimationFrame(applyLayout)\n        }\n        return\n      }\n      retries = 0\n      panel.style.top = `${convRect.top - frameRect.top}px`\n      panel.style.height = `${convRect.height}px`\n      panel.style.left = `${convRect.left - frameRect.left}px`\n    }\n    applyLayout()\n    raf = requestAnimationFrame(applyLayout)\n    const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(applyLayout)\n    const convRoot = findConvRoot()\n    observer?.observe(convRoot ?? document.body, { box: 'border-box' })\n    window.addEventListener('resize', applyLayout)\n    return () => {\n      if (raf !== 0) cancelAnimationFrame(raf)\n      observer?.disconnect()\n      window.removeEventListener('resize', applyLayout)\n    }\n  }, [visible])\n\n  // Clear any pending hint timer on unmount.\n  useEffect(() => () => {\n    if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current)\n  }, [])\n\n  if (!visible) return null\n\n  const onJump = (dot: TurnDot): void => {\n    if (current === undefined) return\n    setJumpingKey(dot.key)\n    props.jump(current, dot.key)\n    window.setTimeout(() => setJumpingKey((k) => (k === dot.key ? null : k)), 600)\n  }\n\n  const openTooltip = (dot: TurnDot, target: HTMLElement): void => {\n    const r = target.getBoundingClientRect()\n    setTooltip({\n      title: dot.turn === null ? null : `Turn ${dot.turn}`,\n      lines: dot.texts,\n      left: r.right + 10,\n      top: r.top,\n    })\n  }\n\n  const t = props.t\n\n  return (\n    <div ref={panelRef} className={styles.rail} data-question-nav=\"rail\">\n      {hint !== null ? <div className={styles.hint} role=\"status\">{hint}</div> : null}\n      <div className={styles.list}>\n        {dots.length === 0 ? (\n          <div className={styles.empty}>{t('strip.empty')}</div>\n        ) : (\n          <div className={styles.dots}>\n            <span className={styles.count}>{dots.length}</span>\n            {dots.map((dot) => (\n              <button\n                key={dot.key}\n                className={jumpingKey === dot.key ? `${styles.dot} ${styles.active}` : styles.dot}\n                aria-label={dot.texts[0] ?? ''}\n                onMouseEnter={(e) => openTooltip(dot, e.currentTarget)}\n                onMouseLeave={() => setTooltip(null)}\n                onClick={() => onJump(dot)}\n              />\n            ))}\n          </div>\n        )}\n      </div>\n      {tooltip !== null\n        ? createPortal(\n            <div className={styles.tooltip} style={{ left: tooltip.left, top: tooltip.top }}>\n              {tooltip.title !== null ? <div className={styles.tooltipTitle}>{tooltip.title}</div> : null}\n              {tooltip.lines.map((line, index) => (\n                <div key={index} className={styles.tooltipLine}>{line}</div>\n              ))}\n            </div>,\n            document.body,\n          )\n        : null}\n    </div>\n  )\n}\n","/**\n * Locale dictionaries for the question-nav surface (zh/en). Registered under\n * the `question-nav` namespace; keys are consumed through the bound translator.\n */\nexport const zh = {\n  'strip.empty': '本会话还没有提问',\n  'jump.inactive': '聊天视图未激活',\n  'jump.hidden': '目标无独立气泡，已定位到邻近内容',\n  'jump.notfound': '目标未加载或不存在（可能已压缩）',\n  'jump.timeout': '加载历史超时，可重试',\n} as const\n\nexport const en = {\n  'strip.empty': 'No questions in this session yet',\n  'jump.inactive': 'Chat view is not active',\n  'jump.hidden': 'No dedicated bubble; landed on nearby content',\n  'jump.notfound': 'Target not loaded or missing (maybe compacted)',\n  'jump.timeout': 'Timed out loading history; retry',\n} as const\n\nexport type QuestionNavKey = keyof typeof zh\n","/**\n * Pure node-indexing logic for the question-nav plugin. No React, no DOM, no\n * Cordis — every function here is a pure transform over chat-node data so it\n * can be unit-tested in isolation (and reused by the browser half).\n */\n\n/** One user question as shown in the strip and targeted by a jump. */\nexport interface QuestionNode {\n  /** Chat anchor key, matches a `[data-chat-anchor-key]` row in the scrollport. */\n  key: string\n  /** Monotone anchor sequence for ordering and window-min detection. */\n  anchorSeq: number\n  /** Event seq of the user message. */\n  seq: number\n  /** Unix ms timestamp. */\n  time: number\n  /** Full question text — shown in the hover tooltip (not truncated). */\n  text: string\n}\n\n/** Minimal shape a chat node must expose for indexing (structural, not SDK-bound). */\nexport interface ChatNodeLike {\n  key: string\n  anchorSeq: number\n  visibility?: string\n  kind?: string\n  /** Kind-specific payload (a UserMessageNode for `user`/`steering`). */\n  data?: unknown\n}\n\n/** Kinds counted as a user question (turn-opening and steering admissions). */\nexport const QUESTION_KINDS = ['user', 'steering'] as const\n\n/** Narrow `node.data` to the user-message payload we read. */\ninterface UserDataLike {\n  content?: readonly { type?: string; text?: string }[]\n  seq?: number\n  time?: number\n}\n\nfunction userData(data: unknown): UserDataLike | undefined {\n  if (typeof data !== 'object' || data === null) return undefined\n  return data as UserDataLike\n}\n\n/** First text block of a user message; falls back to the raw first block. */\nexport function messageText(content: readonly { type?: string; text?: string }[] | undefined): string {\n  if (content === undefined || content.length === 0) return ''\n  const first = content[0]\n  if (typeof first?.text === 'string') return first.text\n  return ''\n}\n\n/** Extract the user questions from a chat-node window, ordered by anchorSeq. */\nexport function extractQuestions(nodes: Iterable<ChatNodeLike>): QuestionNode[] {\n  const out: QuestionNode[] = []\n  for (const node of nodes) {\n    if (!QUESTION_KINDS.includes(node.kind as (typeof QUESTION_KINDS)[number])) continue\n    const payload = userData(node.data)\n    out.push({\n      key: node.key,\n      anchorSeq: node.anchorSeq,\n      seq: payload?.seq ?? -1,\n      time: payload?.time ?? 0,\n      // Full question text: shown in the hover tooltip (not truncated).\n      text: messageText(payload?.content),\n    })\n  }\n  out.sort((a, b) => a.anchorSeq - b.anchorSeq)\n  return out\n}\n\n/** Whether a node is actually rendered (visible rows only are scroll targets). */\nexport function isRenderable(node: ChatNodeLike): boolean {\n  return node.visibility !== 'hidden'\n}\n\n/** The row of the window that renders the given key (exact match). */\nexport function findQuestionRow(nodes: Iterable<ChatNodeLike>, key: string): ChatNodeLike | null {\n  for (const node of nodes) {\n    if (node.key === key) return node\n  }\n  return null\n}\n\n/** Nearest renderable row for a key that is absent or hidden (compaction, windowing). */\nexport function nearestRenderable(\n  nodes: Iterable<{ key: string; anchorSeq: number; visibility?: string }>,\n  excludeKey: string | undefined,\n): { key: string; anchorSeq: number } | null {\n  let best: { key: string; anchorSeq: number } | null = null\n  for (const node of nodes) {\n    if (node.visibility === 'hidden') continue\n    if (node.key === excludeKey) continue\n    if (best === null || node.anchorSeq < best.anchorSeq) best = { key: node.key, anchorSeq: node.anchorSeq }\n  }\n  return best\n}\n","/**\n * Jump-to-question orchestration. Pure-ish: takes injected ports (snapshot\n * read, loadOlder, DOM row lookup, view liveness, scroll, timers) so the\n * paging/timeout/fallback loop is unit-testable without a real browser or\n * session. The browser half wires these ports to ctx.sessions + the DOM.\n */\n\nimport { nearestRenderable } from './nodes.ts'\n\n/** The bits of a session snapshot the jump loop needs. */\nexport interface JumpSnapshot {\n  openState: string\n  hasMore: boolean\n  loadingOlder: boolean\n  /** Renderable chat rows as a key->renderable map (or iterable of rows). */\n  rows: Iterable<{ key: string; anchorSeq: number; visibility?: string }>\n}\n\nexport interface JumpPorts {\n  /** Read the current snapshot; undefined when the session/view is unavailable. */\n  snapshot: () => JumpSnapshot | undefined\n  /** Expand the window backwards; rejects/throws on failure. */\n  loadOlder: () => Promise<void>\n  /** True while the chat view is active (a `[data-chat-flow]` is mounted). */\n  isViewActive: () => boolean\n  /** Find the DOM row for a chat anchor key; null when not rendered. */\n  findRow: (key: string) => HTMLElement | null\n  /** Scroll a row into view at the top. */\n  scrollIntoView: (row: HTMLElement) => void\n  /** Monotonic ms clock. */\n  now: () => number\n  /** Async sleep. */\n  sleep: (ms: number) => Promise<void>\n  /** Report a terminal failure to the caller (for a hint). */\n  report?: (code: JumpFailureCode, fallback?: boolean) => void\n}\n\nexport type JumpFailureCode = 'VIEW_INACTIVE' | 'TARGET_HIDDEN' | 'NOT_FOUND' | 'TIMEOUT'\n\nexport interface JumpResult {\n  ok: boolean\n  code?: JumpFailureCode\n  /** True when we landed on a fallback row rather than the exact target. */\n  fallback?: boolean\n}\n\nexport interface JumpOptions {\n  /** Total wall-clock budget for loadOlder paging. */\n  totalTimeoutMs?: number\n  /** Max loadOlder pages before giving up. */\n  maxPages?: number\n  /** Poll interval for the row to render after it is known to be in the window. */\n  rowWaitMs?: number\n  /** Poll interval for state transitions (loadingOlder / openState). */\n  pollMs?: number\n}\n\nconst DEFAULTS = {\n  totalTimeoutMs: 15_000,\n  maxPages: 100,\n  rowWaitMs: 8_000,\n  pollMs: 60,\n}\n\nfunction minAnchorSeq(rows: Iterable<{ anchorSeq: number }>): number | null {\n  let min: number | null = null\n  for (const row of rows) {\n    if (min === null || row.anchorSeq < min) min = row.anchorSeq\n  }\n  return min\n}\n\nfunction renderable(rows: Iterable<{ key: string; anchorSeq: number; visibility?: string }>): { key: string; anchorSeq: number }[] {\n  const out: { key: string; anchorSeq: number }[] = []\n  for (const row of rows) {\n    if (row.visibility === 'hidden') continue\n    out.push({ key: row.key, anchorSeq: row.anchorSeq })\n  }\n  return out\n}\n\n/**\n * Jump to the row for `key`, paging older content until it is rendered (or the\n * budget is exhausted). Falls back to the nearest renderable row when the\n * exact row is hidden/absent.\n */\nexport async function jumpToQuestion(ports: JumpPorts, key: string, options: JumpOptions = {}): Promise<JumpResult> {\n  const cfg = { ...DEFAULTS, ...options }\n  const fail = (code: JumpFailureCode, fallback = false): JumpResult => {\n    ports.report?.(code, fallback)\n    return fallback ? { ok: false, code, fallback: true } : { ok: false, code }\n  }\n\n  if (!ports.isViewActive()) return fail('VIEW_INACTIVE')\n\n  const deadline = ports.now() + cfg.totalTimeoutMs\n  let pages = 0\n\n  // Phase 1: page older until the key appears in the loaded window.\n  while (true) {\n    const snap = ports.snapshot()\n    if (snap === undefined) return fail('VIEW_INACTIVE')\n    const rows = renderable(snap.rows)\n    if (rows.some((r) => r.key === key)) break\n    if (snap.openState !== 'open') {\n      if (snap.openState === 'error' || ports.now() > deadline) {\n        return fail(snap.openState === 'error' ? 'VIEW_INACTIVE' : 'TIMEOUT')\n      }\n      await ports.sleep(cfg.pollMs)\n      continue\n    }\n    if (snap.hasMore !== true) return fail('NOT_FOUND')\n    if (pages >= cfg.maxPages || ports.now() > deadline) return fail('TIMEOUT')\n    if (snap.loadingOlder) {\n      await ports.sleep(cfg.pollMs)\n      continue\n    }\n    const before = minAnchorSeq(rows)\n    await ports.loadOlder()\n    pages += 1\n    const afterSnap = ports.snapshot()\n    const after = minAnchorSeq(afterSnap === undefined ? [] : afterSnap.rows)\n    if (after === null || (before !== null && after >= before)) return fail('NOT_FOUND')\n  }\n\n  // Phase 2: wait for the row to render, then scroll. Fall back if hidden.\n  const waitedFor = async (rowKey: string): Promise<HTMLElement | null> => {\n    for (let waited = 0; waited <= cfg.rowWaitMs; waited += cfg.pollMs) {\n      if (!ports.isViewActive()) return null\n      const row = ports.findRow(rowKey)\n      if (row !== null) return row\n      await ports.sleep(cfg.pollMs)\n    }\n    return null\n  }\n\n  const row = await waitedFor(key)\n  if (row !== null) {\n    ports.scrollIntoView(row)\n    return { ok: true }\n  }\n\n  const snap = ports.snapshot()\n  const fallback = nearestRenderable(snap === undefined ? [] : snap.rows, key)\n  if (fallback !== null) {\n    const fbRow = await waitedFor(fallback.key)\n    if (fbRow !== null) {\n      ports.scrollIntoView(fbRow)\n      return fail('TARGET_HIDDEN', true)\n    }\n  }\n  return fail('TARGET_HIDDEN', false)\n}\n","/**\n * Browser-half entry for the dsh-question-nav plugin.\n *\n * Registers one surface into the frame-wide floating layer (`shell.overlay`):\n * a vertical strip on the LEFT edge of the conversation column listing every\n * user question in the current session as a small button, one dot per turn.\n * Clicking a button scrolls the chat to that turn's first question.\n *\n * The dots are driven by the host-folded `questionIndex` session projection\n * (registered by the plugin's host half): the projection registry folds the\n * WHOLE event log without touching the chat's paged render window, the\n * projection cache persists it, and the standard carriers (history tail-page\n * baseline + session/projection push frames) keep it live. Live-window\n * questions not yet recorded by the projection are merged on top so a\n * just-sent question appears immediately.\n *\n * Failure policy: nothing here throws at apply time — an external plugin must\n * never take the GUI down.\n */\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\nimport type { SessionId } from '@deepseek-ai/dsh-client-connection/client'\n// Type-only: pulls ui-layout's SlotMap merge ('shell.overlay').\nimport type {} from '@deepseek-ai/dsh-client-ui-layout/client'\n// Type-only: pulls the locale plugin's Context merge (ctx.locale).\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\nimport { QuestionNavStrip, type ObservableFace, type QuestionNavInjected } from './QuestionNavStrip.tsx'\nimport { en, zh, type QuestionNavKey } from './locales.ts'\nimport { extractQuestions } from '../core/nodes.ts'\nimport { jumpToQuestion, type JumpFailureCode, type JumpPorts } from '../core/jump.ts'\n\n/** Locale namespace this plugin owns. */\nconst NS = 'question-nav'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** question-nav surface copy. */\n    'question-nav': QuestionNavKey\n  }\n}\n\n/** Services required by this plugin. */\nexport const inject = ['slots', 'locale', 'sessions']\n\n/** Single-instance guard: a duplicated client injection must not mount twice. */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __dshQuestionNavApplied: boolean | undefined\n}\n\nfunction claimApply(): boolean {\n  if (globalThis.__dshQuestionNavApplied === true) return false\n  globalThis.__dshQuestionNavApplied = true\n  return true\n}\n\nfunction releaseApply(): void {\n  globalThis.__dshQuestionNavApplied = undefined\n}\n\n/** Map the session snapshot to the jump-loop port surface. */\nfunction jumpPortsFor(ctx: ClientContext, sessionId: SessionId): JumpPorts {\n  return {\n    snapshot: () => {\n      const binding = ctx.sessions.binding(sessionId)\n      const snap = binding?.session.getSnapshot()\n      if (snap === undefined) return undefined\n      return {\n        openState: snap.openState,\n        hasMore: snap.hasMore,\n        loadingOlder: snap.loadingOlder,\n        rows: snap.chat.nodes.values(),\n      }\n    },\n    loadOlder: async () => {\n      const binding = ctx.sessions.binding(sessionId)\n      if (binding === undefined) throw new Error('session unavailable')\n      await binding.session.loadOlder()\n    },\n    isViewActive: () => document.querySelector('[data-chat-flow]') !== null,\n    findRow: (key: string) => {\n      for (const candidate of Array.from(document.querySelectorAll<HTMLElement>('[data-chat-anchor-key]'))) {\n        if (candidate.dataset.chatAnchorKey === key) return candidate\n      }\n      return null\n    },\n    scrollIntoView: (row) => row.scrollIntoView({ block: 'start' }),\n    now: () => Date.now(),\n    sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms)),\n  }\n}\n\n/**\n * The session's `questionIndex` projection face (getSnapshot + subscribe).\n * Undefined when the session is not bound or the host unit is not registered\n * (e.g. a headless composition) — the strip then shows live-window dots only.\n */\nfunction questionProjectionOf(ctx: ClientContext, sessionId: SessionId): ObservableFace | undefined {\n  const face = ctx.sessions.binding(sessionId)?.session.projections.faceOf('questionIndex')\n  if (face === undefined) return undefined\n  return {\n    getSnapshot: () => face.getSnapshot(),\n    subscribe: (listener) => face.subscribe(listener),\n  }\n}\n\nfunction createInject(ctx: ClientContext): QuestionNavInjected {\n  return {\n    readQuestions: (sessionId) => {\n      const snap = ctx.sessions.binding(sessionId)?.session.getSnapshot()\n      if (snap === undefined) return []\n      return extractQuestions(snap.chat.nodes.values())\n    },\n    subscribeList: (cb) => ctx.sessions.list.subscribe(cb),\n    subscribeContent: (sessionId, cb) => {\n      const binding = ctx.sessions.binding(sessionId)\n      if (binding === undefined) return () => {}\n      return binding.session.subscribe(cb)\n    },\n    questionProjection: (sessionId) => questionProjectionOf(ctx, sessionId),\n    jump: (sessionId, key) => {\n      const ports = jumpPortsFor(ctx, sessionId)\n      ports.report = (code: JumpFailureCode) => {\n        // Surface the failure through the component via a DOM event the\n        // strip listens for; simplest reliable cross-boundary channel here.\n        window.dispatchEvent(new CustomEvent('question-nav:jump-failed', { detail: code }))\n      }\n      void jumpToQuestion(ports, key)\n    },\n  }\n}\n\n/**\n * Register the question-nav surface.\n * @param ctx - client root context.\n */\nexport function apply(ctx: ClientContext): void {\n  if (!claimApply()) return\n  ctx.effect(() => releaseApply, 'question-nav: apply claim')\n\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'question-nav: dictionaries')\n\n  const injected = createInject(ctx)\n\n  ctx.slots.inject('shell.overlay', () => ctx.slots.register({\n    name: 'shell.overlay',\n    id: 'question-nav',\n    order: 900,\n    locale: NS,\n    inject: () => injected,\n  }, QuestionNavStrip))\n}\n"],"mappings":";;;;;;;;;;;EAcA,MAAa,0BAA0B;;;;;;EAOvC,SAAgB,YAAY,IAAqB;GAE/C,OAAO,MAAkBA,0BAAO,OAAO,EAAE;EAC3C;;;;;;EAuBA,SAAgB,qBAAqB,SAA8C;GACjF,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG;GACxD,MAAM,OAAkB,CAAC;GACzB,KAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,MAAM,YAAY,MAAM,EAAE;IAChC,MAAM,OAAO,KAAK,GAAG,EAAE;IACvB,IAAI,SAAS,KAAA,KAAa,KAAK,SAAS,MAAM,MAAM;KAClD,KAAK,KAAK,SAAS,KAAK;MACtB,GAAG;MACH,OAAO,CAAC,GAAG,KAAK,OAAO,MAAM,IAAI;MACjC,YAAY,CAAC,GAAG,KAAK,YAAY,GAAG;KACtC;KACA;IACF;IACA,KAAK,KAAK;KACR,MAAM,MAAM;KACZ;KACA,WAAW,MAAM;KACjB,MAAM,MAAM;KACZ,OAAO,CAAC,MAAM,IAAI;KAClB,YAAY,CAAC,GAAG;IAClB,CAAC;GACH;GACA,OAAO;EACT;;;;;;;;EASA,SAAgB,mBACd,MACA,MACW;GACX,MAAM,QAAQ,IAAI,IAAI,KAAK,SAAQ,QAAO,IAAI,UAAU,CAAC;GACzD,MAAM,SAAoB,KACvB,QAAO,aAAY,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC,CAC5C,KAAI,cAAa;IAChB,MAAM;IACN,KAAK,SAAS;IACd,WAAW,SAAS;IACpB,MAAM,SAAS;IACf,OAAO,CAAC,SAAS,IAAI;IACrB,YAAY,CAAC,SAAS,GAAG;GAC3B,EAAE;GACJ,IAAI,OAAO,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI;GACxC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS;EACtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ECvCA,MAAM,gBAAyD;GAC7D,eAAe;GACf,eAAe;GACf,WAAW;GACX,SAAS;EACX;;EAaA,SAAS,kBAAkB,MAAmD;GAC5E,MAAM,QAAQ,MAAM,YAAY;GAChC,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;GACnC,OAAO,MAAM,QAAQ,SACnB,OAAO,SAAS,YAAY,SAAS,QAClC,OAAQ,KAAuB,OAAO,YACtC,OAAQ,KAAuB,QAAQ,YACvC,OAAQ,KAAuB,SAAS,QAAQ;EACvD;EAEA,SAAS,eAAmC;GAC1C,OAAO,SAAS,cAA2B,gDAA8C;EAC3F;EAEA,SAAgB,iBAAiB,OAAiD;GAChF,MAAM,UAAU,MAAM,aAAa,MAAM,EAAE,OAAO;GAClD,MAAM,UAAU,MAAM,aAAa,MAAO,EAAE,YAAY,KAAA,IAAY,KAAA,IAAY,EAAE,KAAK,EAAE,QAAS;GAClG,MAAM,UAAU,YAAY,KAAA,KAAa,YAAY,KAAA,KAAa,QAAQ,UAAU;GAEpF,MAAM,CAAC,MAAM,YAAA,GAAWC,MAAAA,SAAAA,CAAoB,CAAC,CAAC;GAC9C,MAAM,CAAC,YAAY,kBAAA,GAAiBA,MAAAA,SAAAA,CAAwB,IAAI;GAChE,MAAM,CAAC,MAAM,YAAA,GAAWA,MAAAA,SAAAA,CAAwB,IAAI;GACpD,MAAM,CAAC,SAAS,eAAA,GAAcA,MAAAA,SAAAA,CAA8B,IAAI;GAChE,MAAM,YAAA,GAAWC,MAAAA,OAAAA,CAA8B,IAAI;GACnD,MAAM,gBAAA,GAAeA,MAAAA,OAAAA,CAAsB,IAAI;GAE/C,MAAM,YAAY,YAA0B;IAC1C,QAAQ,OAAO;IACf,IAAI,aAAa,YAAY,MAAM,OAAO,aAAa,aAAa,OAAO;IAC3E,aAAa,UAAU,OAAO,iBAAiB,QAAQ,IAAI,GAAG,IAAI;GACpE;GAIA,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,IAAI,CAAC,WAAW,YAAY,KAAA,GAAW;KACrC,QAAQ,CAAC,CAAC;KACV;IACF;IACA,MAAM,YAAY;IAClB,MAAM,OAAO,MAAM,mBAAmB,SAAS;IAC/C,MAAM,gBAAsB;KAC1B,MAAM,UAAU,qBAAqB,kBAAkB,IAAI,CAAC;KAC5D,QAAQ,mBAAmB,SAAS,MAAM,cAAc,SAAS,CAAC,CAAC;IACrE;IACA,QAAQ;IACR,MAAM,kBAAkB,MAAM,UAAU,OAAO,YAAY,CAAC;IAC5D,MAAM,eAAe,MAAM,iBAAiB,WAAW,OAAO;IAC9D,MAAM,YAAY,MAAM,cAAc,OAAO;IAC7C,aAAa;KACX,gBAAgB;KAChB,aAAa;KACb,UAAU;IACZ;GAEF,GAAG;IAAC;IAAS;IAAS;GAAK,CAAC;GAG5B,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,MAAM,gBAAgB,UAAuB;KAC3C,MAAM,OAAQ,MAAuC;KACrD,SAAS,MAAM,EAAE,cAAc,SAAS,cAAc,CAAC;IACzD;IACA,OAAO,iBAAiB,4BAA4B,YAAY;IAChE,aAAa,OAAO,oBAAoB,4BAA4B,YAAY;GAClF,GAAG,CAAC,KAAK,CAAC;GAIV,CAAA,GAAA,MAAA,gBAAA,OAAsB;IACpB,IAAI,CAAC,SAAS;IACd,IAAI,MAAM;IACV,IAAI,UAAU;IACd,MAAM,oBAA0B;KAC9B,MAAM,QAAQ,SAAS;KACvB,IAAI,UAAU,MAAM;KACpB,MAAM,QAAQ,MAAM,QAAQ,sBAAsB,CAAC,EAAE,iBAAiB;KACtE,MAAM,WAAW,aAAa;KAC9B,IAAI,UAAU,QAAQ,aAAa,MAAM;KACzC,MAAM,YAAY,MAAM,sBAAsB;KAC9C,MAAM,WAAW,SAAS,sBAAsB;KAChD,IAAI,SAAS,UAAU,GAAG;MACxB,IAAI,UAAU,IAAI;OAChB,WAAW;OACX,MAAM,sBAAsB,WAAW;MACzC;MACA;KACF;KACA,UAAU;KACV,MAAM,MAAM,MAAM,GAAG,SAAS,MAAM,UAAU,IAAI;KAClD,MAAM,MAAM,SAAS,GAAG,SAAS,OAAO;KACxC,MAAM,MAAM,OAAO,GAAG,SAAS,OAAO,UAAU,KAAK;IACvD;IACA,YAAY;IACZ,MAAM,sBAAsB,WAAW;IACvC,MAAM,WAAW,OAAO,mBAAmB,cAAc,OAAO,IAAI,eAAe,WAAW;IAC9F,MAAM,WAAW,aAAa;IAC9B,UAAU,QAAQ,YAAY,SAAS,MAAM,EAAE,KAAK,aAAa,CAAC;IAClE,OAAO,iBAAiB,UAAU,WAAW;IAC7C,aAAa;KACX,IAAI,QAAQ,GAAG,qBAAqB,GAAG;KACvC,UAAU,WAAW;KACrB,OAAO,oBAAoB,UAAU,WAAW;IAClD;GACF,GAAG,CAAC,OAAO,CAAC;GAGZ,CAAA,GAAA,MAAA,UAAA,aAAsB;IACpB,IAAI,aAAa,YAAY,MAAM,OAAO,aAAa,aAAa,OAAO;GAC7E,GAAG,CAAC,CAAC;GAEL,IAAI,CAAC,SAAS,OAAO;GAErB,MAAM,UAAU,QAAuB;IACrC,IAAI,YAAY,KAAA,GAAW;IAC3B,cAAc,IAAI,GAAG;IACrB,MAAM,KAAK,SAAS,IAAI,GAAG;IAC3B,OAAO,iBAAiB,eAAe,MAAO,MAAM,IAAI,MAAM,OAAO,CAAE,GAAG,GAAG;GAC/E;GAEA,MAAM,eAAe,KAAc,WAA8B;IAC/D,MAAM,IAAI,OAAO,sBAAsB;IACvC,WAAW;KACT,OAAO,IAAI,SAAS,OAAO,OAAO,QAAQ,IAAI;KAC9C,OAAO,IAAI;KACX,MAAM,EAAE,QAAQ;KAChB,KAAK,EAAE;IACT,CAAC;GACH;GAEA,MAAM,IAAI,MAAM;GAEhB,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,KAAK;IAAU,WAAWC,gCAAO;IAAM,qBAAkB;IAA9D,UAAA;KACG,SAAS,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;MAAK,WAAWA,gCAAO;MAAM,MAAK;MAAU,UAAA;KAAU,CAAA,IAAI;KAC3E,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;MAAK,WAAWA,gCAAO;MACpB,UAAA,KAAK,WAAW,IACf,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAQ,UAAA,EAAE,aAAa;MAAO,CAAA,IAErD,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAvB,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;QAAM,WAAWA,gCAAO;QAAQ,UAAA,KAAK;OAAa,CAAA,GACjD,KAAK,KAAK,QACT,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;QAEE,WAAW,eAAe,IAAI,MAAM,GAAGA,gCAAO,IAAI,GAAGA,gCAAO,WAAWA,gCAAO;QAC9E,cAAY,IAAI,MAAM,MAAM;QAC5B,eAAe,MAAM,YAAY,KAAK,EAAE,aAAa;QACrD,oBAAoB,WAAW,IAAI;QACnC,eAAe,OAAO,GAAG;OAC1B,GANM,IAAI,GAMV,CACF,CACE;;KAEJ,CAAA;KACJ,YAAY,QAAA,GACTC,UAAAA,aAAAA,CACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;MAAK,WAAWD,gCAAO;MAAS,OAAO;OAAE,MAAM,QAAQ;OAAM,KAAK,QAAQ;MAAI;MAA9E,UAAA,CACG,QAAQ,UAAU,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAe,UAAA,QAAQ;MAAW,CAAA,IAAI,MACtF,QAAQ,MAAM,KAAK,MAAM,UACxB,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAiB,WAAWA,gCAAO;OAAc,UAAA;MAAU,GAAjD,KAAiD,CAC5D,CACE;KACL,CAAA,GAAA,SAAS,IACX,IACA;IACD;;EAET;;;;;;;EC/OA,MAAa,KAAK;GAChB,eAAe;GACf,iBAAiB;GACjB,eAAe;GACf,iBAAiB;GACjB,gBAAgB;EAClB;EAEA,MAAa,KAAK;GAChB,eAAe;GACf,iBAAiB;GACjB,eAAe;GACf,iBAAiB;GACjB,gBAAgB;EAClB;;;;ECaA,MAAa,iBAAiB,CAAC,QAAQ,UAAU;EASjD,SAAS,SAAS,MAAyC;GACzD,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM,OAAO,KAAA;GACtD,OAAO;EACT;;EAGA,SAAgB,YAAY,SAA0E;GACpG,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,GAAG,OAAO;GAC1D,MAAM,QAAQ,QAAQ;GACtB,IAAI,OAAO,OAAO,SAAS,UAAU,OAAO,MAAM;GAClD,OAAO;EACT;;EAGA,SAAgB,iBAAiB,OAA+C;GAC9E,MAAM,MAAsB,CAAC;GAC7B,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,eAAe,SAAS,KAAK,IAAuC,GAAG;IAC5E,MAAM,UAAU,SAAS,KAAK,IAAI;IAClC,IAAI,KAAK;KACP,KAAK,KAAK;KACV,WAAW,KAAK;KAChB,KAAK,SAAS,OAAO;KACrB,MAAM,SAAS,QAAQ;KAEvB,MAAM,YAAY,SAAS,OAAO;IACpC,CAAC;GACH;GACA,IAAI,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS;GAC5C,OAAO;EACT;;EAgBA,SAAgB,kBACd,OACA,YAC2C;GAC3C,IAAI,OAAkD;GACtD,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,KAAK,eAAe,UAAU;IAClC,IAAI,KAAK,QAAQ,YAAY;IAC7B,IAAI,SAAS,QAAQ,KAAK,YAAY,KAAK,WAAW,OAAO;KAAE,KAAK,KAAK;KAAK,WAAW,KAAK;IAAU;GAC1G;GACA,OAAO;EACT;;;;;;;;;ECxCA,MAAM,WAAW;GACf,gBAAgB;GAChB,UAAU;GACV,WAAW;GACX,QAAQ;EACV;EAEA,SAAS,aAAa,MAAsD;GAC1E,IAAI,MAAqB;GACzB,KAAK,MAAM,OAAO,MAChB,IAAI,QAAQ,QAAQ,IAAI,YAAY,KAAK,MAAM,IAAI;GAErD,OAAO;EACT;EAEA,SAAS,WAAW,MAA+G;GACjI,MAAM,MAA4C,CAAC;GACnD,KAAK,MAAM,OAAO,MAAM;IACtB,IAAI,IAAI,eAAe,UAAU;IACjC,IAAI,KAAK;KAAE,KAAK,IAAI;KAAK,WAAW,IAAI;IAAU,CAAC;GACrD;GACA,OAAO;EACT;;;;;;EAOA,eAAsB,eAAe,OAAkB,KAAa,UAAuB,CAAC,GAAwB;GAClH,MAAM,MAAM;IAAE,GAAG;IAAU,GAAG;GAAQ;GACtC,MAAM,QAAQ,MAAuB,WAAW,UAAsB;IACpE,MAAM,SAAS,MAAM,QAAQ;IAC7B,OAAO,WAAW;KAAE,IAAI;KAAO;KAAM,UAAU;IAAK,IAAI;KAAE,IAAI;KAAO;IAAK;GAC5E;GAEA,IAAI,CAAC,MAAM,aAAa,GAAG,OAAO,KAAK,eAAe;GAEtD,MAAM,WAAW,MAAM,IAAI,IAAI,IAAI;GACnC,IAAI,QAAQ;GAGZ,OAAO,MAAM;IACX,MAAM,OAAO,MAAM,SAAS;IAC5B,IAAI,SAAS,KAAA,GAAW,OAAO,KAAK,eAAe;IACnD,MAAM,OAAO,WAAW,KAAK,IAAI;IACjC,IAAI,KAAK,MAAM,MAAM,EAAE,QAAQ,GAAG,GAAG;IACrC,IAAI,KAAK,cAAc,QAAQ;KAC7B,IAAI,KAAK,cAAc,WAAW,MAAM,IAAI,IAAI,UAC9C,OAAO,KAAK,KAAK,cAAc,UAAU,kBAAkB,SAAS;KAEtE,MAAM,MAAM,MAAM,IAAI,MAAM;KAC5B;IACF;IACA,IAAI,KAAK,YAAY,MAAM,OAAO,KAAK,WAAW;IAClD,IAAI,SAAS,IAAI,YAAY,MAAM,IAAI,IAAI,UAAU,OAAO,KAAK,SAAS;IAC1E,IAAI,KAAK,cAAc;KACrB,MAAM,MAAM,MAAM,IAAI,MAAM;KAC5B;IACF;IACA,MAAM,SAAS,aAAa,IAAI;IAChC,MAAM,MAAM,UAAU;IACtB,SAAS;IACT,MAAM,YAAY,MAAM,SAAS;IACjC,MAAM,QAAQ,aAAa,cAAc,KAAA,IAAY,CAAC,IAAI,UAAU,IAAI;IACxE,IAAI,UAAU,QAAS,WAAW,QAAQ,SAAS,QAAS,OAAO,KAAK,WAAW;GACrF;GAGA,MAAM,YAAY,OAAO,WAAgD;IACvE,KAAK,IAAI,SAAS,GAAG,UAAU,IAAI,WAAW,UAAU,IAAI,QAAQ;KAClE,IAAI,CAAC,MAAM,aAAa,GAAG,OAAO;KAClC,MAAM,MAAM,MAAM,QAAQ,MAAM;KAChC,IAAI,QAAQ,MAAM,OAAO;KACzB,MAAM,MAAM,MAAM,IAAI,MAAM;IAC9B;IACA,OAAO;GACT;GAEA,MAAM,MAAM,MAAM,UAAU,GAAG;GAC/B,IAAI,QAAQ,MAAM;IAChB,MAAM,eAAe,GAAG;IACxB,OAAO,EAAE,IAAI,KAAK;GACpB;GAEA,MAAM,OAAO,MAAM,SAAS;GAC5B,MAAM,WAAW,kBAAkB,SAAS,KAAA,IAAY,CAAC,IAAI,KAAK,MAAM,GAAG;GAC3E,IAAI,aAAa,MAAM;IACrB,MAAM,QAAQ,MAAM,UAAU,SAAS,GAAG;IAC1C,IAAI,UAAU,MAAM;KAClB,MAAM,eAAe,KAAK;KAC1B,OAAO,KAAK,iBAAiB,IAAI;IACnC;GACF;GACA,OAAO,KAAK,iBAAiB,KAAK;EACpC;;;;ECzHA,MAAM,KAAK;;EAUX,MAAa,SAAS;GAAC;GAAS;GAAU;EAAU;EAQpD,SAAS,aAAsB;GAC7B,IAAI,WAAW,4BAA4B,MAAM,OAAO;GACxD,WAAW,0BAA0B;GACrC,OAAO;EACT;EAEA,SAAS,eAAqB;GAC5B,WAAW,0BAA0B,KAAA;EACvC;;EAGA,SAAS,aAAa,KAAoB,WAAiC;GACzE,OAAO;IACL,gBAAgB;KAEd,MAAM,OADU,IAAI,SAAS,QAAQ,SAClB,CAAC,EAAE,QAAQ,YAAY;KAC1C,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;KAC/B,OAAO;MACL,WAAW,KAAK;MAChB,SAAS,KAAK;MACd,cAAc,KAAK;MACnB,MAAM,KAAK,KAAK,MAAM,OAAO;KAC/B;IACF;IACA,WAAW,YAAY;KACrB,MAAM,UAAU,IAAI,SAAS,QAAQ,SAAS;KAC9C,IAAI,YAAY,KAAA,GAAW,MAAM,IAAI,MAAM,qBAAqB;KAChE,MAAM,QAAQ,QAAQ,UAAU;IAClC;IACA,oBAAoB,SAAS,cAAc,kBAAkB,MAAM;IACnE,UAAU,QAAgB;KACxB,KAAK,MAAM,aAAa,MAAM,KAAK,SAAS,iBAA8B,wBAAwB,CAAC,GACjG,IAAI,UAAU,QAAQ,kBAAkB,KAAK,OAAO;KAEtD,OAAO;IACT;IACA,iBAAiB,QAAQ,IAAI,eAAe,EAAE,OAAO,QAAQ,CAAC;IAC9D,WAAW,KAAK,IAAI;IACpB,QAAQ,OAAO,IAAI,SAAS,YAAY,OAAO,WAAW,SAAS,EAAE,CAAC;GACxE;EACF;;;;;;EAOA,SAAS,qBAAqB,KAAoB,WAAkD;GAClG,MAAM,OAAO,IAAI,SAAS,QAAQ,SAAS,CAAC,EAAE,QAAQ,YAAY,OAAO,eAAe;GACxF,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;GAC/B,OAAO;IACL,mBAAmB,KAAK,YAAY;IACpC,YAAY,aAAa,KAAK,UAAU,QAAQ;GAClD;EACF;EAEA,SAAS,aAAa,KAAyC;GAC7D,OAAO;IACL,gBAAgB,cAAc;KAC5B,MAAM,OAAO,IAAI,SAAS,QAAQ,SAAS,CAAC,EAAE,QAAQ,YAAY;KAClE,IAAI,SAAS,KAAA,GAAW,OAAO,CAAC;KAChC,OAAO,iBAAiB,KAAK,KAAK,MAAM,OAAO,CAAC;IAClD;IACA,gBAAgB,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE;IACrD,mBAAmB,WAAW,OAAO;KACnC,MAAM,UAAU,IAAI,SAAS,QAAQ,SAAS;KAC9C,IAAI,YAAY,KAAA,GAAW,aAAa,CAAC;KACzC,OAAO,QAAQ,QAAQ,UAAU,EAAE;IACrC;IACA,qBAAqB,cAAc,qBAAqB,KAAK,SAAS;IACtE,OAAO,WAAW,QAAQ;KACxB,MAAM,QAAQ,aAAa,KAAK,SAAS;KACzC,MAAM,UAAU,SAA0B;MAGxC,OAAO,cAAc,IAAI,YAAY,4BAA4B,EAAE,QAAQ,KAAK,CAAC,CAAC;KACpF;KACA,eAAoB,OAAO,GAAG;IAChC;GACF;EACF;;;;;EAMA,SAAgB,MAAM,KAA0B;GAC9C,IAAI,CAAC,WAAW,GAAG;GACnB,IAAI,aAAa,cAAc,2BAA2B;GAE1D,IAAI,aAAa,IAAI,OAAO,SAAS,IAAI;IAAE;IAAI;GAAG,CAAC,GAAG,4BAA4B;GAElF,MAAM,WAAW,aAAa,GAAG;GAEjC,IAAI,MAAM,OAAO,uBAAuB,IAAI,MAAM,SAAS;IACzD,MAAM;IACN,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,cAAc;GAChB,GAAG,gBAAgB,CAAC;EACtB"}
+{"version":3,"file":"client.js","names":["kind","useState","useRef","styles","createPortal"],"sources":["../src/core/turn-dots.ts","../src/client/QuestionNavStrip.tsx","../src/client/locales.ts","../src/core/nodes.ts","../src/core/jump.ts","../src/client/index.ts"],"sourcesContent":["/**\n * Turn-aligned dot model for the question-nav strip. Pure transforms over the\n * `questionIndex` projection value plus the live chat window — no React, no\n * DOM — so the grouping and merging rules are unit-testable in isolation.\n *\n * One dot per turn that claimed at least one user question; turns without a\n * question (retry, goal continuation, cancelled empty turns) produce no dot,\n * so dot turn labels may skip numbers but always match the Trajectory view.\n */\n\nimport type { QuestionEntry } from './question-entry.ts'\nimport type { QuestionNode } from './nodes.ts'\n\n/** The conversation Definition kind whose key a user question node uses. */\nexport const MESSAGE_DEFINITION_KIND = 'input-message'\n\n/**\n * The engine-owned stable chat key for a user question — mirrors\n * `conversationContextKey('input-message', String(id))` from the DSH runtime\n * (verified against that formula in the unit test).\n */\nexport function questionKey(id: unknown): string {\n  const kind = MESSAGE_DEFINITION_KIND\n  return `${kind.length}:${kind}${String(id)}`\n}\n\n/** One strip dot: a turn's questions (grouped) or one ungrouped live question. */\nexport interface TurnDot {\n  /** Owning turn number; null for live questions the projection has not seen. */\n  readonly turn: number | null\n  /** Jump anchor: the chat key of the turn's FIRST question. */\n  readonly key: string\n  /** Anchor seq of the first question (ordering + jump target). */\n  readonly anchorSeq: number\n  /** Unix ms of the first question. */\n  readonly time: number\n  /** Every question text of this dot, in order (tooltip lists them all). */\n  readonly texts: readonly string[]\n  /** Chat keys of every question folded into this dot (live-merge dedupe). */\n  readonly memberKeys: readonly string[]\n}\n\n/** True when entries are already in non-decreasing seq order (the projection\n * appends in event order, so this is the common case and skips the sort). */\nfunction isSortedBySeq(entries: readonly QuestionEntry[]): boolean {\n  for (let i = 1; i < entries.length; i++) {\n    if (entries[i].seq < entries[i - 1].seq) return false\n  }\n  return true\n}\n\n/**\n * Fold the projection's question list into one dot per turn. Entries arrive\n * in event order; consecutive same-turn entries merge into a single dot whose\n * anchor is the turn's first question. The input is expected to be sorted by\n * seq; the defensive sort is skipped when it already is, so a long session\n * never pays an O(n log n) sort on every content update.\n */\nexport function groupQuestionsByTurn(entries: readonly QuestionEntry[]): TurnDot[] {\n  const sorted = isSortedBySeq(entries) ? entries : [...entries].sort((a, b) => a.seq - b.seq)\n  const dots: TurnDot[] = []\n  for (const entry of sorted) {\n    const key = questionKey(entry.id)\n    const last = dots.at(-1)\n    if (last !== undefined && last.turn === entry.turn) {\n      dots[dots.length - 1] = {\n        ...last,\n        texts: [...last.texts, entry.text],\n        memberKeys: [...last.memberKeys, key],\n      }\n      continue\n    }\n    dots.push({\n      turn: entry.turn,\n      key,\n      anchorSeq: entry.seq,\n      time: entry.time,\n      texts: [entry.text],\n      memberKeys: [key],\n    })\n  }\n  return dots\n}\n\n/**\n * Merge live-window questions the projection has not recorded yet (the brief\n * window before the session/projection push frame lands). A live question\n * whose key is already folded into a dot is dropped (the projected copy\n * wins); the rest become single-question dots with `turn: null`, inserted in\n * anchor-seq order so the strip stays strictly chronological.\n *\n * Fast path: when nothing new arrives the SAME array is returned (no copy),\n * so the caller can bail out of a re-render on identical reference.\n */\nexport function mergeLiveQuestions(\n  dots: readonly TurnDot[],\n  live: readonly QuestionNode[],\n): TurnDot[] {\n  if (live.length === 0) return dots as TurnDot[]\n  const known = new Set<string>()\n  for (const dot of dots) {\n    for (const key of dot.memberKeys) known.add(key)\n  }\n  const extras: TurnDot[] = []\n  for (const question of live) {\n    if (known.has(question.key)) continue\n    extras.push({\n      turn: null,\n      key: question.key,\n      anchorSeq: question.anchorSeq,\n      time: question.time,\n      texts: [question.text],\n      memberKeys: [question.key],\n    })\n  }\n  // Nothing new from the live window — reuse the input array unchanged.\n  if (extras.length === 0) return dots as TurnDot[]\n  // Both `dots` and `extras` are sorted by anchorSeq (dots from the projection\n  // order, extras from the live window order): merge linearly instead of\n  // re-sorting the whole list. Ties keep the projected dot first (stable\n  // sort semantics), matching the previous [...dots, ...extras].sort().\n  const out: TurnDot[] = []\n  let i = 0\n  for (const extra of extras) {\n    while (i < dots.length && dots[i].anchorSeq <= extra.anchorSeq) {\n      out.push(dots[i])\n      i += 1\n    }\n    out.push(extra)\n  }\n  while (i < dots.length) {\n    out.push(dots[i])\n    i += 1\n  }\n  return out\n}\n","/**\n * Question-nav minimap. Renders a vertical column of small round dots overlaid\n * on the LEFT edge of the conversation column (via the frame-wide\n * `shell.overlay` floating layer), vertically centered: one dot per turn that\n * claimed at least one user question — strictly aligned with the Trajectory\n * view's turn numbering (turns without a question produce no dot). Hover\n * enlarges a dot and shows an instant tooltip (portal-rendered, no native\n * delay) with the turn label and the turn's question text(s); clicking jumps\n * the chat to that turn's first question.\n *\n * Data source: the host-folded `questionIndex` session projection (whole\n * history, persisted host-side, pushed live through session/projection\n * frames) read through the injected `questionProjection` face, plus the live\n * chat window's questions merged on top for the brief window before a\n * just-sent question lands in the projection. No render-window expansion, no\n * client-side history paging.\n *\n * Data arrives through the props shares: the framework `useSessions` hook\n * (current session), the registrant inject face (read/subscribe/project/\n * jump), and the bound locale translator.\n */\nimport { useEffect, useLayoutEffect, useRef, useState } from 'react'\nimport { createPortal } from 'react-dom'\nimport type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { SessionId } from '@deepseek-ai/dsh-client-connection/client'\n// Type-only: pulls the ui-layout SlotMap merge ('shell.overlay').\nimport type {} from '@deepseek-ai/dsh-client-ui-layout/client'\nimport type { QuestionNode } from '../core/nodes.ts'\nimport type { QuestionEntry } from '../core/question-entry.ts'\nimport { groupQuestionsByTurn, mergeLiveQuestions, type TurnDot } from '../core/turn-dots.ts'\nimport type { JumpFailureCode } from '../core/jump.ts'\nimport type { QuestionNavKey } from './locales.ts'\nimport styles from './question-nav.module.css'\n\n/** Minimal observable shape of a session projection face. */\nexport interface ObservableFace {\n  /** Current projection value (unknown — validated structurally at read). */\n  getSnapshot: () => unknown\n  /** Subscribe to value changes; returns an unsubscribe. */\n  subscribe: (listener: () => void) => () => void\n}\n\n/** Values the registrant inject face supplies (wired in src/client/index.ts). */\nexport interface QuestionNavInjected {\n  /** Extract the user questions of a session's currently loaded window. */\n  readQuestions: (sessionId: SessionId) => QuestionNode[]\n  /** Subscribe to the session list; returns an unsubscribe. */\n  subscribeList: (cb: () => void) => () => void\n  /** Subscribe to a session's content; returns an unsubscribe. */\n  subscribeContent: (sessionId: SessionId, cb: () => void) => () => void\n  /** The session's `questionIndex` projection face, when the host unit is registered. */\n  questionProjection: (sessionId: SessionId) => ObservableFace | undefined\n  /** Jump the chat to a question row (pages the window on demand). */\n  jump: (sessionId: SessionId, key: string) => void\n}\n\ntype ComponentProps = PropsRuntime<'shell.overlay'> & QuestionNavInjected & PropsLocale<'question-nav'>\n\nconst FAILURE_HINTS: Record<JumpFailureCode, QuestionNavKey> = {\n  VIEW_INACTIVE: 'jump.inactive',\n  TARGET_HIDDEN: 'jump.hidden',\n  NOT_FOUND: 'jump.notfound',\n  TIMEOUT: 'jump.timeout',\n}\n\n/** Live position of the instant hover tooltip. */\ninterface TooltipState {\n  /** Turn label line (e.g. \"Turn 32\"); null for ungrouped live questions. */\n  title: string | null\n  /** Question text lines (one per question folded into the dot). */\n  lines: readonly string[]\n  left: number\n  top: number\n}\n\n/** Read the projection face value as a question-entry list (structural guard). */\nfunction projectionEntries(face: ObservableFace | undefined): QuestionEntry[] {\n  const value = face?.getSnapshot()\n  if (!Array.isArray(value)) return []\n  return value.filter((item): item is QuestionEntry =>\n    typeof item === 'object' && item !== null\n    && typeof (item as QuestionEntry).id === 'string'\n    && typeof (item as QuestionEntry).seq === 'number'\n    && typeof (item as QuestionEntry).turn === 'number')\n}\n\nfunction findConvRoot(): HTMLElement | null {\n  return document.querySelector<HTMLElement>('[data-slot=\"conversation\"] > div[data-phase]')\n}\n\n/** Structural equality of two dot lists (member keys fully capture a dot's\n * folded questions, so identical key sequences mean identical content).\n * Lets the strip skip a re-render when a refresh produced no change. */\nfunction sameDots(a: readonly TurnDot[], b: readonly TurnDot[]): boolean {\n  if (a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    const da = a[i]\n    const db = b[i]\n    if (da.key !== db.key || da.memberKeys.length !== db.memberKeys.length) return false\n    for (let j = 0; j < da.memberKeys.length; j++) {\n      if (da.memberKeys[j] !== db.memberKeys[j]) return false\n    }\n  }\n  return true\n}\n\nexport function QuestionNavStrip(props: ComponentProps): React.JSX.Element | null {\n  const current = props.useSessions((s) => s.current)\n  const summary = props.useSessions((s) => (s.current === undefined ? undefined : s.byId[s.current]))\n  const visible = current !== undefined && summary !== undefined && summary.blank !== true\n\n  const [dots, setDots] = useState<TurnDot[]>([])\n  const [jumpingKey, setJumpingKey] = useState<string | null>(null)\n  const [hint, setHint] = useState<string | null>(null)\n  const [tooltip, setTooltip] = useState<TooltipState | null>(null)\n  const panelRef = useRef<HTMLDivElement | null>(null)\n  const hintTimerRef = useRef<number | null>(null)\n  // Last rendered dot list, for the change-detection bail-out below.\n  const lastDotsRef = useRef<TurnDot[]>([])\n\n  const showHint = (message: string): void => {\n    setHint(message)\n    if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current)\n    hintTimerRef.current = window.setTimeout(() => setHint(null), 1800)\n  }\n\n  // Recompute the dot list from the projection + live window. Subscribed to\n  // the projection push frames and the session's content only — session\n  // switches are covered by `current` below (the effect re-runs on change),\n  // so the session-list feed is not subscribed: it would re-run the full\n  // recompute for unrelated list churn.\n  useEffect(() => {\n    if (!visible || current === undefined) {\n      setDots([])\n      lastDotsRef.current = []\n      return\n    }\n    const sessionId = current\n    const face = props.questionProjection(sessionId)\n    const refresh = (): void => {\n      const grouped = groupQuestionsByTurn(projectionEntries(face))\n      const next = mergeLiveQuestions(grouped, props.readQuestions(sessionId))\n      // Identical content (a streaming update that added no question): re-use\n      // the previous array reference so React bails out of re-rendering the\n      // strip — the common case during assistant streaming.\n      if (sameDots(next, lastDotsRef.current)) {\n        setDots(lastDotsRef.current)\n        return\n      }\n      lastDotsRef.current = next\n      setDots(next)\n    }\n    refresh()\n    const unsubProjection = face?.subscribe(refresh) ?? (() => {})\n    const unsubContent = props.subscribeContent(sessionId, refresh)\n    return () => {\n      unsubProjection()\n      unsubContent()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [visible, current, props])\n\n  // Listen for jump-failure events and surface the hint.\n  useEffect(() => {\n    const onJumpFailed = (event: Event): void => {\n      const code = (event as CustomEvent<JumpFailureCode>).detail\n      showHint(props.t(FAILURE_HINTS[code] ?? 'jump.timeout'))\n    }\n    window.addEventListener('question-nav:jump-failed', onJumpFailed)\n    return () => window.removeEventListener('question-nav:jump-failed', onJumpFailed)\n  }, [props])\n\n  // Anchor the minimap to the conversation column: position it at the left\n  // edge of the conversation root and reserve a thin rail with padding-left.\n  //\n  // A layout-correction loop keeps the rail pinned to the conversation even\n  // when an outside panel (e.g. a browser-extension sidebar like Doubao) moves\n  // or resizes the frame without resizing the browser window: `window resize`\n  // never fires for in-page panels, and a ResizeObserver on the conversation\n  // root alone misses remounts and the tail of the frame's grid-column\n  // transition, which used to leave the rail drifting into the session list.\n  // The loop runs while the layout is still moving, then parks itself after a\n  // few stable frames; observers re-wake it on the next change.\n  useLayoutEffect(() => {\n    if (!visible) return\n    let raf = 0\n    let idle = 0\n    let stopped = false\n    let observer: ResizeObserver | null = null\n    const observed = { frame: null as Element | null, convRoot: null as Element | null }\n\n    const applyLayout = (): boolean => {\n      const panel = panelRef.current\n      if (panel === null) return false\n      const frame = panel.closest('[data-shell-overlay]')?.parentElement ?? null\n      const convRoot = findConvRoot()\n      // Keep looping while the anchors are not both present (conversation not\n      // mounted yet / mid-reflow), so a late mount still aligns.\n      if (frame === null || convRoot === null) return true\n      // Keep observing the live nodes: the conversation root may remount\n      // (e.g. after a panel-triggered reflow), which silently detaches an\n      // earlier ResizeObserver target.\n      if (observer !== null) {\n        if (observed.frame !== frame) {\n          observer.observe(frame, { box: 'border-box' })\n          observed.frame = frame\n        }\n        if (observed.convRoot !== convRoot) {\n          observer.observe(convRoot, { box: 'border-box' })\n          observed.convRoot = convRoot\n        }\n      }\n      const frameRect = frame.getBoundingClientRect()\n      const convRect = convRoot.getBoundingClientRect()\n      // Never snap onto a transient box: keep correcting until the\n      // conversation has a real footprint again.\n      if (convRect.height <= 0 || convRect.width <= 0) return true\n      const top = `${convRect.top - frameRect.top}px`\n      const height = `${convRect.height}px`\n      const left = `${convRect.left - frameRect.left}px`\n      if (panel.style.top === top && panel.style.height === height && panel.style.left === left) {\n        return false\n      }\n      panel.style.top = top\n      panel.style.height = height\n      panel.style.left = left\n      return true\n    }\n\n    const loop = (): void => {\n      if (stopped) return\n      raf = 0\n      idle = applyLayout() ? 0 : idle + 1\n      if (idle < 3) raf = requestAnimationFrame(loop)\n    }\n    const wake = (): void => {\n      if (stopped) return\n      idle = 0\n      if (raf === 0) raf = requestAnimationFrame(loop)\n    }\n\n    observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(wake)\n    if (observer !== null) {\n      const panel = panelRef.current\n      const frame = panel?.closest('[data-shell-overlay]')?.parentElement ?? null\n      const convRoot = findConvRoot()\n      if (frame !== null) { observer.observe(frame, { box: 'border-box' }); observed.frame = frame }\n      if (convRoot !== null) { observer.observe(convRoot, { box: 'border-box' }); observed.convRoot = convRoot }\n    }\n\n    // Initial alignment; the loop keeps correcting through layout transitions.\n    wake()\n    window.addEventListener('resize', wake)\n    return () => {\n      stopped = true\n      if (raf !== 0) cancelAnimationFrame(raf)\n      observer?.disconnect()\n      window.removeEventListener('resize', wake)\n    }\n  }, [visible])\n\n  // Clear any pending hint timer on unmount.\n  useEffect(() => () => {\n    if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current)\n  }, [])\n\n  if (!visible) return null\n\n  const onJump = (dot: TurnDot): void => {\n    if (current === undefined) return\n    setJumpingKey(dot.key)\n    props.jump(current, dot.key)\n    window.setTimeout(() => setJumpingKey((k) => (k === dot.key ? null : k)), 600)\n  }\n\n  const openTooltip = (dot: TurnDot, target: HTMLElement): void => {\n    const r = target.getBoundingClientRect()\n    setTooltip({\n      title: dot.turn === null ? null : `Turn ${dot.turn}`,\n      lines: dot.texts,\n      left: r.right + 10,\n      top: r.top,\n    })\n  }\n\n  const t = props.t\n\n  return (\n    <div ref={panelRef} className={styles.rail} data-question-nav=\"rail\">\n      {hint !== null ? <div className={styles.hint} role=\"status\">{hint}</div> : null}\n      <div className={styles.list}>\n        {dots.length === 0 ? (\n          <div className={styles.empty}>{t('strip.empty')}</div>\n        ) : (\n          <div className={styles.dots}>\n            <span className={styles.count}>{dots.length}</span>\n            {dots.map((dot) => (\n              <button\n                key={dot.key}\n                className={jumpingKey === dot.key ? `${styles.dot} ${styles.active}` : styles.dot}\n                aria-label={dot.texts[0] ?? ''}\n                onMouseEnter={(e) => openTooltip(dot, e.currentTarget)}\n                onMouseLeave={() => setTooltip(null)}\n                onClick={() => onJump(dot)}\n              />\n            ))}\n          </div>\n        )}\n      </div>\n      {tooltip !== null\n        ? createPortal(\n            <div className={styles.tooltip} style={{ left: tooltip.left, top: tooltip.top }}>\n              {tooltip.title !== null ? <div className={styles.tooltipTitle}>{tooltip.title}</div> : null}\n              {tooltip.lines.map((line, index) => (\n                <div key={index} className={styles.tooltipLine}>{line}</div>\n              ))}\n            </div>,\n            document.body,\n          )\n        : null}\n    </div>\n  )\n}\n","/**\n * Locale dictionaries for the question-nav surface (zh/en). Registered under\n * the `question-nav` namespace; keys are consumed through the bound translator.\n */\nexport const zh = {\n  'strip.empty': '本会话还没有提问',\n  'jump.inactive': '聊天视图未激活',\n  'jump.hidden': '目标无独立气泡，已定位到邻近内容',\n  'jump.notfound': '目标未加载或不存在（可能已压缩）',\n  'jump.timeout': '加载历史超时，可重试',\n} as const\n\nexport const en = {\n  'strip.empty': 'No questions in this session yet',\n  'jump.inactive': 'Chat view is not active',\n  'jump.hidden': 'No dedicated bubble; landed on nearby content',\n  'jump.notfound': 'Target not loaded or missing (maybe compacted)',\n  'jump.timeout': 'Timed out loading history; retry',\n} as const\n\nexport type QuestionNavKey = keyof typeof zh\n","/**\n * Pure node-indexing logic for the question-nav plugin. No React, no DOM, no\n * Cordis — every function here is a pure transform over chat-node data so it\n * can be unit-tested in isolation (and reused by the browser half).\n */\n\n/** One user question as shown in the strip and targeted by a jump. */\nexport interface QuestionNode {\n  /** Chat anchor key, matches a `[data-chat-anchor-key]` row in the scrollport. */\n  key: string\n  /** Monotone anchor sequence for ordering and window-min detection. */\n  anchorSeq: number\n  /** Event seq of the user message. */\n  seq: number\n  /** Unix ms timestamp. */\n  time: number\n  /** Full question text — shown in the hover tooltip (not truncated). */\n  text: string\n}\n\n/** Minimal shape a chat node must expose for indexing (structural, not SDK-bound). */\nexport interface ChatNodeLike {\n  key: string\n  anchorSeq: number\n  visibility?: string\n  kind?: string\n  /** Kind-specific payload (a UserMessageNode for `user`/`steering`). */\n  data?: unknown\n}\n\n/** Kinds counted as a user question (turn-opening and steering admissions). */\nexport const QUESTION_KINDS = ['user', 'steering'] as const\n\n/** Narrow `node.data` to the user-message payload we read. */\ninterface UserDataLike {\n  content?: readonly { type?: string; text?: string }[]\n  seq?: number\n  time?: number\n}\n\nfunction userData(data: unknown): UserDataLike | undefined {\n  if (typeof data !== 'object' || data === null) return undefined\n  return data as UserDataLike\n}\n\n/** First text block of a user message; falls back to the raw first block. */\nexport function messageText(content: readonly { type?: string; text?: string }[] | undefined): string {\n  if (content === undefined || content.length === 0) return ''\n  const first = content[0]\n  if (typeof first?.text === 'string') return first.text\n  return ''\n}\n\n/** Extract the user questions from a chat-node window, ordered by anchorSeq. */\nexport function extractQuestions(nodes: Iterable<ChatNodeLike>): QuestionNode[] {\n  const out: QuestionNode[] = []\n  for (const node of nodes) {\n    if (!QUESTION_KINDS.includes(node.kind as (typeof QUESTION_KINDS)[number])) continue\n    const payload = userData(node.data)\n    out.push({\n      key: node.key,\n      anchorSeq: node.anchorSeq,\n      seq: payload?.seq ?? -1,\n      time: payload?.time ?? 0,\n      // Full question text: shown in the hover tooltip (not truncated).\n      text: messageText(payload?.content),\n    })\n  }\n  out.sort((a, b) => a.anchorSeq - b.anchorSeq)\n  return out\n}\n\n/** Whether a node is actually rendered (visible rows only are scroll targets). */\nexport function isRenderable(node: ChatNodeLike): boolean {\n  return node.visibility !== 'hidden'\n}\n\n/** The row of the window that renders the given key (exact match). */\nexport function findQuestionRow(nodes: Iterable<ChatNodeLike>, key: string): ChatNodeLike | null {\n  for (const node of nodes) {\n    if (node.key === key) return node\n  }\n  return null\n}\n\n/** Nearest renderable row for a key that is absent or hidden (compaction, windowing). */\nexport function nearestRenderable(\n  nodes: Iterable<{ key: string; anchorSeq: number; visibility?: string }>,\n  excludeKey: string | undefined,\n): { key: string; anchorSeq: number } | null {\n  let best: { key: string; anchorSeq: number } | null = null\n  for (const node of nodes) {\n    if (node.visibility === 'hidden') continue\n    if (node.key === excludeKey) continue\n    if (best === null || node.anchorSeq < best.anchorSeq) best = { key: node.key, anchorSeq: node.anchorSeq }\n  }\n  return best\n}\n","/**\n * Jump-to-question orchestration. Pure-ish: takes injected ports (snapshot\n * read, loadOlder, DOM row lookup, view liveness, scroll, timers) so the\n * paging/timeout/fallback loop is unit-testable without a real browser or\n * session. The browser half wires these ports to ctx.sessions + the DOM.\n */\n\nimport { nearestRenderable } from './nodes.ts'\n\n/** The bits of a session snapshot the jump loop needs. */\nexport interface JumpSnapshot {\n  openState: string\n  hasMore: boolean\n  loadingOlder: boolean\n  /** Renderable chat rows as a key->renderable map (or iterable of rows). */\n  rows: Iterable<{ key: string; anchorSeq: number; visibility?: string }>\n}\n\nexport interface JumpPorts {\n  /** Read the current snapshot; undefined when the session/view is unavailable. */\n  snapshot: () => JumpSnapshot | undefined\n  /** Expand the window backwards; rejects/throws on failure. */\n  loadOlder: () => Promise<void>\n  /** True while the chat view is active (a `[data-chat-flow]` is mounted). */\n  isViewActive: () => boolean\n  /** Find the DOM row for a chat anchor key; null when not rendered. */\n  findRow: (key: string) => HTMLElement | null\n  /** Scroll a row into view at the top. */\n  scrollIntoView: (row: HTMLElement) => void\n  /** Monotonic ms clock. */\n  now: () => number\n  /** Async sleep. */\n  sleep: (ms: number) => Promise<void>\n  /** Report a terminal failure to the caller (for a hint). */\n  report?: (code: JumpFailureCode, fallback?: boolean) => void\n}\n\nexport type JumpFailureCode = 'VIEW_INACTIVE' | 'TARGET_HIDDEN' | 'NOT_FOUND' | 'TIMEOUT'\n\nexport interface JumpResult {\n  ok: boolean\n  code?: JumpFailureCode\n  /** True when we landed on a fallback row rather than the exact target. */\n  fallback?: boolean\n}\n\nexport interface JumpOptions {\n  /** Total wall-clock budget for loadOlder paging. */\n  totalTimeoutMs?: number\n  /** Max loadOlder pages before giving up. */\n  maxPages?: number\n  /** Poll interval for the row to render after it is known to be in the window. */\n  rowWaitMs?: number\n  /** Poll interval for state transitions (loadingOlder / openState). */\n  pollMs?: number\n}\n\nconst DEFAULTS = {\n  totalTimeoutMs: 15_000,\n  maxPages: 100,\n  rowWaitMs: 8_000,\n  pollMs: 60,\n}\n\nfunction minAnchorSeq(rows: Iterable<{ anchorSeq: number }>): number | null {\n  let min: number | null = null\n  for (const row of rows) {\n    if (min === null || row.anchorSeq < min) min = row.anchorSeq\n  }\n  return min\n}\n\nfunction renderable(rows: Iterable<{ key: string; anchorSeq: number; visibility?: string }>): { key: string; anchorSeq: number }[] {\n  const out: { key: string; anchorSeq: number }[] = []\n  for (const row of rows) {\n    if (row.visibility === 'hidden') continue\n    out.push({ key: row.key, anchorSeq: row.anchorSeq })\n  }\n  return out\n}\n\n/**\n * Jump to the row for `key`, paging older content until it is rendered (or the\n * budget is exhausted). Falls back to the nearest renderable row when the\n * exact row is hidden/absent.\n */\nexport async function jumpToQuestion(ports: JumpPorts, key: string, options: JumpOptions = {}): Promise<JumpResult> {\n  const cfg = { ...DEFAULTS, ...options }\n  const fail = (code: JumpFailureCode, fallback = false): JumpResult => {\n    ports.report?.(code, fallback)\n    return fallback ? { ok: false, code, fallback: true } : { ok: false, code }\n  }\n\n  if (!ports.isViewActive()) return fail('VIEW_INACTIVE')\n\n  const deadline = ports.now() + cfg.totalTimeoutMs\n  let pages = 0\n\n  // Phase 1: page older until the key appears in the loaded window.\n  while (true) {\n    const snap = ports.snapshot()\n    if (snap === undefined) return fail('VIEW_INACTIVE')\n    const rows = renderable(snap.rows)\n    if (rows.some((r) => r.key === key)) break\n    if (snap.openState !== 'open') {\n      if (snap.openState === 'error' || ports.now() > deadline) {\n        return fail(snap.openState === 'error' ? 'VIEW_INACTIVE' : 'TIMEOUT')\n      }\n      await ports.sleep(cfg.pollMs)\n      continue\n    }\n    if (snap.hasMore !== true) return fail('NOT_FOUND')\n    if (pages >= cfg.maxPages || ports.now() > deadline) return fail('TIMEOUT')\n    if (snap.loadingOlder) {\n      await ports.sleep(cfg.pollMs)\n      continue\n    }\n    const before = minAnchorSeq(rows)\n    await ports.loadOlder()\n    pages += 1\n    const afterSnap = ports.snapshot()\n    const after = minAnchorSeq(afterSnap === undefined ? [] : afterSnap.rows)\n    if (after === null || (before !== null && after >= before)) return fail('NOT_FOUND')\n  }\n\n  // Phase 2: wait for the row to render, then scroll. Fall back if hidden.\n  const waitedFor = async (rowKey: string): Promise<HTMLElement | null> => {\n    for (let waited = 0; waited <= cfg.rowWaitMs; waited += cfg.pollMs) {\n      if (!ports.isViewActive()) return null\n      const row = ports.findRow(rowKey)\n      if (row !== null) return row\n      await ports.sleep(cfg.pollMs)\n    }\n    return null\n  }\n\n  const row = await waitedFor(key)\n  if (row !== null) {\n    ports.scrollIntoView(row)\n    return { ok: true }\n  }\n\n  const snap = ports.snapshot()\n  const fallback = nearestRenderable(snap === undefined ? [] : snap.rows, key)\n  if (fallback !== null) {\n    const fbRow = await waitedFor(fallback.key)\n    if (fbRow !== null) {\n      ports.scrollIntoView(fbRow)\n      return fail('TARGET_HIDDEN', true)\n    }\n  }\n  return fail('TARGET_HIDDEN', false)\n}\n","/**\n * Browser-half entry for the dsh-question-nav plugin.\n *\n * Registers one surface into the frame-wide floating layer (`shell.overlay`):\n * a vertical strip on the LEFT edge of the conversation column listing every\n * user question in the current session as a small button, one dot per turn.\n * Clicking a button scrolls the chat to that turn's first question.\n *\n * The dots are driven by the host-folded `questionIndex` session projection\n * (registered by the plugin's host half): the projection registry folds the\n * WHOLE event log without touching the chat's paged render window, the\n * projection cache persists it, and the standard carriers (history tail-page\n * baseline + session/projection push frames) keep it live. Live-window\n * questions not yet recorded by the projection are merged on top so a\n * just-sent question appears immediately.\n *\n * Failure policy: nothing here throws at apply time — an external plugin must\n * never take the GUI down.\n */\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\nimport type { SessionId } from '@deepseek-ai/dsh-client-connection/client'\n// Type-only: pulls ui-layout's SlotMap merge ('shell.overlay').\nimport type {} from '@deepseek-ai/dsh-client-ui-layout/client'\n// Type-only: pulls the locale plugin's Context merge (ctx.locale).\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\nimport { QuestionNavStrip, type ObservableFace, type QuestionNavInjected } from './QuestionNavStrip.tsx'\nimport { en, zh, type QuestionNavKey } from './locales.ts'\nimport { extractQuestions } from '../core/nodes.ts'\nimport { jumpToQuestion, type JumpFailureCode, type JumpPorts } from '../core/jump.ts'\n\n/** Locale namespace this plugin owns. */\nconst NS = 'question-nav'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** question-nav surface copy. */\n    'question-nav': QuestionNavKey\n  }\n}\n\n/** Services required by this plugin. */\nexport const inject = ['slots', 'locale', 'sessions']\n\n/** Single-instance guard: a duplicated client injection must not mount twice. */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __dshQuestionNavApplied: boolean | undefined\n}\n\nfunction claimApply(): boolean {\n  if (globalThis.__dshQuestionNavApplied === true) return false\n  globalThis.__dshQuestionNavApplied = true\n  return true\n}\n\nfunction releaseApply(): void {\n  globalThis.__dshQuestionNavApplied = undefined\n}\n\n/** Map the session snapshot to the jump-loop port surface. */\nfunction jumpPortsFor(ctx: ClientContext, sessionId: SessionId): JumpPorts {\n  return {\n    snapshot: () => {\n      const binding = ctx.sessions.binding(sessionId)\n      const snap = binding?.session.getSnapshot()\n      if (snap === undefined) return undefined\n      return {\n        openState: snap.openState,\n        hasMore: snap.hasMore,\n        loadingOlder: snap.loadingOlder,\n        rows: snap.chat.nodes.values(),\n      }\n    },\n    loadOlder: async () => {\n      const binding = ctx.sessions.binding(sessionId)\n      if (binding === undefined) throw new Error('session unavailable')\n      await binding.session.loadOlder()\n    },\n    isViewActive: () => document.querySelector('[data-chat-flow]') !== null,\n    findRow: (key: string) => {\n      for (const candidate of Array.from(document.querySelectorAll<HTMLElement>('[data-chat-anchor-key]'))) {\n        if (candidate.dataset.chatAnchorKey === key) return candidate\n      }\n      return null\n    },\n    scrollIntoView: (row) => row.scrollIntoView({ block: 'start' }),\n    now: () => Date.now(),\n    sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms)),\n  }\n}\n\n/**\n * The session's `questionIndex` projection face (getSnapshot + subscribe).\n * Undefined when the session is not bound or the host unit is not registered\n * (e.g. a headless composition) — the strip then shows live-window dots only.\n */\nfunction questionProjectionOf(ctx: ClientContext, sessionId: SessionId): ObservableFace | undefined {\n  const face = ctx.sessions.binding(sessionId)?.session.projections.faceOf('questionIndex')\n  if (face === undefined) return undefined\n  return {\n    getSnapshot: () => face.getSnapshot(),\n    subscribe: (listener) => face.subscribe(listener),\n  }\n}\n\nfunction createInject(ctx: ClientContext): QuestionNavInjected {\n  return {\n    readQuestions: (sessionId) => {\n      const snap = ctx.sessions.binding(sessionId)?.session.getSnapshot()\n      if (snap === undefined) return []\n      return extractQuestions(snap.chat.nodes.values())\n    },\n    subscribeList: (cb) => ctx.sessions.list.subscribe(cb),\n    subscribeContent: (sessionId, cb) => {\n      const binding = ctx.sessions.binding(sessionId)\n      if (binding === undefined) return () => {}\n      return binding.session.subscribe(cb)\n    },\n    questionProjection: (sessionId) => questionProjectionOf(ctx, sessionId),\n    jump: (sessionId, key) => {\n      const ports = jumpPortsFor(ctx, sessionId)\n      ports.report = (code: JumpFailureCode) => {\n        // Surface the failure through the component via a DOM event the\n        // strip listens for; simplest reliable cross-boundary channel here.\n        window.dispatchEvent(new CustomEvent('question-nav:jump-failed', { detail: code }))\n      }\n      void jumpToQuestion(ports, key)\n    },\n  }\n}\n\n/**\n * Register the question-nav surface.\n * @param ctx - client root context.\n */\nexport function apply(ctx: ClientContext): void {\n  if (!claimApply()) return\n  ctx.effect(() => releaseApply, 'question-nav: apply claim')\n\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'question-nav: dictionaries')\n\n  const injected = createInject(ctx)\n\n  ctx.slots.inject('shell.overlay', () => ctx.slots.register({\n    name: 'shell.overlay',\n    id: 'question-nav',\n    order: 900,\n    locale: NS,\n    inject: () => injected,\n  }, QuestionNavStrip))\n}\n"],"mappings":";;;;;;;;;;;EAcA,MAAa,0BAA0B;;;;;;EAOvC,SAAgB,YAAY,IAAqB;GAE/C,OAAO,MAAkBA,0BAAO,OAAO,EAAE;EAC3C;;;EAoBA,SAAS,cAAc,SAA4C;GACjE,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,IAAI,QAAQ,EAAE,CAAC,MAAM,QAAQ,IAAI,EAAE,CAAC,KAAK,OAAO;GAElD,OAAO;EACT;;;;;;;;EASA,SAAgB,qBAAqB,SAA8C;GACjF,MAAM,SAAS,cAAc,OAAO,IAAI,UAAU,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG;GAC3F,MAAM,OAAkB,CAAC;GACzB,KAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,MAAM,YAAY,MAAM,EAAE;IAChC,MAAM,OAAO,KAAK,GAAG,EAAE;IACvB,IAAI,SAAS,KAAA,KAAa,KAAK,SAAS,MAAM,MAAM;KAClD,KAAK,KAAK,SAAS,KAAK;MACtB,GAAG;MACH,OAAO,CAAC,GAAG,KAAK,OAAO,MAAM,IAAI;MACjC,YAAY,CAAC,GAAG,KAAK,YAAY,GAAG;KACtC;KACA;IACF;IACA,KAAK,KAAK;KACR,MAAM,MAAM;KACZ;KACA,WAAW,MAAM;KACjB,MAAM,MAAM;KACZ,OAAO,CAAC,MAAM,IAAI;KAClB,YAAY,CAAC,GAAG;IAClB,CAAC;GACH;GACA,OAAO;EACT;;;;;;;;;;;EAYA,SAAgB,mBACd,MACA,MACW;GACX,IAAI,KAAK,WAAW,GAAG,OAAO;GAC9B,MAAM,wBAAQ,IAAI,IAAY;GAC9B,KAAK,MAAM,OAAO,MAChB,KAAK,MAAM,OAAO,IAAI,YAAY,MAAM,IAAI,GAAG;GAEjD,MAAM,SAAoB,CAAC;GAC3B,KAAK,MAAM,YAAY,MAAM;IAC3B,IAAI,MAAM,IAAI,SAAS,GAAG,GAAG;IAC7B,OAAO,KAAK;KACV,MAAM;KACN,KAAK,SAAS;KACd,WAAW,SAAS;KACpB,MAAM,SAAS;KACf,OAAO,CAAC,SAAS,IAAI;KACrB,YAAY,CAAC,SAAS,GAAG;IAC3B,CAAC;GACH;GAEA,IAAI,OAAO,WAAW,GAAG,OAAO;GAKhC,MAAM,MAAiB,CAAC;GACxB,IAAI,IAAI;GACR,KAAK,MAAM,SAAS,QAAQ;IAC1B,OAAO,IAAI,KAAK,UAAU,KAAK,EAAE,CAAC,aAAa,MAAM,WAAW;KAC9D,IAAI,KAAK,KAAK,EAAE;KAChB,KAAK;IACP;IACA,IAAI,KAAK,KAAK;GAChB;GACA,OAAO,IAAI,KAAK,QAAQ;IACtB,IAAI,KAAK,KAAK,EAAE;IAChB,KAAK;GACP;GACA,OAAO;EACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EC7EA,MAAM,gBAAyD;GAC7D,eAAe;GACf,eAAe;GACf,WAAW;GACX,SAAS;EACX;;EAaA,SAAS,kBAAkB,MAAmD;GAC5E,MAAM,QAAQ,MAAM,YAAY;GAChC,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;GACnC,OAAO,MAAM,QAAQ,SACnB,OAAO,SAAS,YAAY,SAAS,QAClC,OAAQ,KAAuB,OAAO,YACtC,OAAQ,KAAuB,QAAQ,YACvC,OAAQ,KAAuB,SAAS,QAAQ;EACvD;EAEA,SAAS,eAAmC;GAC1C,OAAO,SAAS,cAA2B,gDAA8C;EAC3F;;;;EAKA,SAAS,SAAS,GAAuB,GAAgC;GACvE,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;GAClC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;IACjC,MAAM,KAAK,EAAE;IACb,MAAM,KAAK,EAAE;IACb,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,WAAW,GAAG,WAAW,QAAQ,OAAO;IAC/E,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,WAAW,QAAQ,KACxC,IAAI,GAAG,WAAW,OAAO,GAAG,WAAW,IAAI,OAAO;GAEtD;GACA,OAAO;EACT;EAEA,SAAgB,iBAAiB,OAAiD;GAChF,MAAM,UAAU,MAAM,aAAa,MAAM,EAAE,OAAO;GAClD,MAAM,UAAU,MAAM,aAAa,MAAO,EAAE,YAAY,KAAA,IAAY,KAAA,IAAY,EAAE,KAAK,EAAE,QAAS;GAClG,MAAM,UAAU,YAAY,KAAA,KAAa,YAAY,KAAA,KAAa,QAAQ,UAAU;GAEpF,MAAM,CAAC,MAAM,YAAA,GAAWC,MAAAA,SAAAA,CAAoB,CAAC,CAAC;GAC9C,MAAM,CAAC,YAAY,kBAAA,GAAiBA,MAAAA,SAAAA,CAAwB,IAAI;GAChE,MAAM,CAAC,MAAM,YAAA,GAAWA,MAAAA,SAAAA,CAAwB,IAAI;GACpD,MAAM,CAAC,SAAS,eAAA,GAAcA,MAAAA,SAAAA,CAA8B,IAAI;GAChE,MAAM,YAAA,GAAWC,MAAAA,OAAAA,CAA8B,IAAI;GACnD,MAAM,gBAAA,GAAeA,MAAAA,OAAAA,CAAsB,IAAI;GAE/C,MAAM,eAAA,GAAcA,MAAAA,OAAAA,CAAkB,CAAC,CAAC;GAExC,MAAM,YAAY,YAA0B;IAC1C,QAAQ,OAAO;IACf,IAAI,aAAa,YAAY,MAAM,OAAO,aAAa,aAAa,OAAO;IAC3E,aAAa,UAAU,OAAO,iBAAiB,QAAQ,IAAI,GAAG,IAAI;GACpE;GAOA,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,IAAI,CAAC,WAAW,YAAY,KAAA,GAAW;KACrC,QAAQ,CAAC,CAAC;KACV,YAAY,UAAU,CAAC;KACvB;IACF;IACA,MAAM,YAAY;IAClB,MAAM,OAAO,MAAM,mBAAmB,SAAS;IAC/C,MAAM,gBAAsB;KAE1B,MAAM,OAAO,mBADG,qBAAqB,kBAAkB,IAAI,CAC3B,GAAS,MAAM,cAAc,SAAS,CAAC;KAIvE,IAAI,SAAS,MAAM,YAAY,OAAO,GAAG;MACvC,QAAQ,YAAY,OAAO;MAC3B;KACF;KACA,YAAY,UAAU;KACtB,QAAQ,IAAI;IACd;IACA,QAAQ;IACR,MAAM,kBAAkB,MAAM,UAAU,OAAO,YAAY,CAAC;IAC5D,MAAM,eAAe,MAAM,iBAAiB,WAAW,OAAO;IAC9D,aAAa;KACX,gBAAgB;KAChB,aAAa;IACf;GAEF,GAAG;IAAC;IAAS;IAAS;GAAK,CAAC;GAG5B,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,MAAM,gBAAgB,UAAuB;KAC3C,MAAM,OAAQ,MAAuC;KACrD,SAAS,MAAM,EAAE,cAAc,SAAS,cAAc,CAAC;IACzD;IACA,OAAO,iBAAiB,4BAA4B,YAAY;IAChE,aAAa,OAAO,oBAAoB,4BAA4B,YAAY;GAClF,GAAG,CAAC,KAAK,CAAC;GAaV,CAAA,GAAA,MAAA,gBAAA,OAAsB;IACpB,IAAI,CAAC,SAAS;IACd,IAAI,MAAM;IACV,IAAI,OAAO;IACX,IAAI,UAAU;IACd,IAAI,WAAkC;IACtC,MAAM,WAAW;KAAE,OAAO;KAAwB,UAAU;IAAuB;IAEnF,MAAM,oBAA6B;KACjC,MAAM,QAAQ,SAAS;KACvB,IAAI,UAAU,MAAM,OAAO;KAC3B,MAAM,QAAQ,MAAM,QAAQ,sBAAsB,CAAC,EAAE,iBAAiB;KACtE,MAAM,WAAW,aAAa;KAG9B,IAAI,UAAU,QAAQ,aAAa,MAAM,OAAO;KAIhD,IAAI,aAAa,MAAM;MACrB,IAAI,SAAS,UAAU,OAAO;OAC5B,SAAS,QAAQ,OAAO,EAAE,KAAK,aAAa,CAAC;OAC7C,SAAS,QAAQ;MACnB;MACA,IAAI,SAAS,aAAa,UAAU;OAClC,SAAS,QAAQ,UAAU,EAAE,KAAK,aAAa,CAAC;OAChD,SAAS,WAAW;MACtB;KACF;KACA,MAAM,YAAY,MAAM,sBAAsB;KAC9C,MAAM,WAAW,SAAS,sBAAsB;KAGhD,IAAI,SAAS,UAAU,KAAK,SAAS,SAAS,GAAG,OAAO;KACxD,MAAM,MAAM,GAAG,SAAS,MAAM,UAAU,IAAI;KAC5C,MAAM,SAAS,GAAG,SAAS,OAAO;KAClC,MAAM,OAAO,GAAG,SAAS,OAAO,UAAU,KAAK;KAC/C,IAAI,MAAM,MAAM,QAAQ,OAAO,MAAM,MAAM,WAAW,UAAU,MAAM,MAAM,SAAS,MACnF,OAAO;KAET,MAAM,MAAM,MAAM;KAClB,MAAM,MAAM,SAAS;KACrB,MAAM,MAAM,OAAO;KACnB,OAAO;IACT;IAEA,MAAM,aAAmB;KACvB,IAAI,SAAS;KACb,MAAM;KACN,OAAO,YAAY,IAAI,IAAI,OAAO;KAClC,IAAI,OAAO,GAAG,MAAM,sBAAsB,IAAI;IAChD;IACA,MAAM,aAAmB;KACvB,IAAI,SAAS;KACb,OAAO;KACP,IAAI,QAAQ,GAAG,MAAM,sBAAsB,IAAI;IACjD;IAEA,WAAW,OAAO,mBAAmB,cAAc,OAAO,IAAI,eAAe,IAAI;IACjF,IAAI,aAAa,MAAM;KAErB,MAAM,QADQ,SAAS,SACF,QAAQ,sBAAsB,CAAC,EAAE,iBAAiB;KACvE,MAAM,WAAW,aAAa;KAC9B,IAAI,UAAU,MAAM;MAAE,SAAS,QAAQ,OAAO,EAAE,KAAK,aAAa,CAAC;MAAG,SAAS,QAAQ;KAAM;KAC7F,IAAI,aAAa,MAAM;MAAE,SAAS,QAAQ,UAAU,EAAE,KAAK,aAAa,CAAC;MAAG,SAAS,WAAW;KAAS;IAC3G;IAGA,KAAK;IACL,OAAO,iBAAiB,UAAU,IAAI;IACtC,aAAa;KACX,UAAU;KACV,IAAI,QAAQ,GAAG,qBAAqB,GAAG;KACvC,UAAU,WAAW;KACrB,OAAO,oBAAoB,UAAU,IAAI;IAC3C;GACF,GAAG,CAAC,OAAO,CAAC;GAGZ,CAAA,GAAA,MAAA,UAAA,aAAsB;IACpB,IAAI,aAAa,YAAY,MAAM,OAAO,aAAa,aAAa,OAAO;GAC7E,GAAG,CAAC,CAAC;GAEL,IAAI,CAAC,SAAS,OAAO;GAErB,MAAM,UAAU,QAAuB;IACrC,IAAI,YAAY,KAAA,GAAW;IAC3B,cAAc,IAAI,GAAG;IACrB,MAAM,KAAK,SAAS,IAAI,GAAG;IAC3B,OAAO,iBAAiB,eAAe,MAAO,MAAM,IAAI,MAAM,OAAO,CAAE,GAAG,GAAG;GAC/E;GAEA,MAAM,eAAe,KAAc,WAA8B;IAC/D,MAAM,IAAI,OAAO,sBAAsB;IACvC,WAAW;KACT,OAAO,IAAI,SAAS,OAAO,OAAO,QAAQ,IAAI;KAC9C,OAAO,IAAI;KACX,MAAM,EAAE,QAAQ;KAChB,KAAK,EAAE;IACT,CAAC;GACH;GAEA,MAAM,IAAI,MAAM;GAEhB,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,KAAK;IAAU,WAAWC,gCAAO;IAAM,qBAAkB;IAA9D,UAAA;KACG,SAAS,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;MAAK,WAAWA,gCAAO;MAAM,MAAK;MAAU,UAAA;KAAU,CAAA,IAAI;KAC3E,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;MAAK,WAAWA,gCAAO;MACpB,UAAA,KAAK,WAAW,IACf,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAQ,UAAA,EAAE,aAAa;MAAO,CAAA,IAErD,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAvB,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;QAAM,WAAWA,gCAAO;QAAQ,UAAA,KAAK;OAAa,CAAA,GACjD,KAAK,KAAK,QACT,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;QAEE,WAAW,eAAe,IAAI,MAAM,GAAGA,gCAAO,IAAI,GAAGA,gCAAO,WAAWA,gCAAO;QAC9E,cAAY,IAAI,MAAM,MAAM;QAC5B,eAAe,MAAM,YAAY,KAAK,EAAE,aAAa;QACrD,oBAAoB,WAAW,IAAI;QACnC,eAAe,OAAO,GAAG;OAC1B,GANM,IAAI,GAMV,CACF,CACE;;KAEJ,CAAA;KACJ,YAAY,QAAA,GACTC,UAAAA,aAAAA,CACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;MAAK,WAAWD,gCAAO;MAAS,OAAO;OAAE,MAAM,QAAQ;OAAM,KAAK,QAAQ;MAAI;MAA9E,UAAA,CACG,QAAQ,UAAU,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAK,WAAWA,gCAAO;OAAe,UAAA,QAAQ;MAAW,CAAA,IAAI,MACtF,QAAQ,MAAM,KAAK,MAAM,UACxB,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;OAAiB,WAAWA,gCAAO;OAAc,UAAA;MAAU,GAAjD,KAAiD,CAC5D,CACE;KACL,CAAA,GAAA,SAAS,IACX,IACA;IACD;;EAET;;;;;;;EC9TA,MAAa,KAAK;GAChB,eAAe;GACf,iBAAiB;GACjB,eAAe;GACf,iBAAiB;GACjB,gBAAgB;EAClB;EAEA,MAAa,KAAK;GAChB,eAAe;GACf,iBAAiB;GACjB,eAAe;GACf,iBAAiB;GACjB,gBAAgB;EAClB;;;;ECaA,MAAa,iBAAiB,CAAC,QAAQ,UAAU;EASjD,SAAS,SAAS,MAAyC;GACzD,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM,OAAO,KAAA;GACtD,OAAO;EACT;;EAGA,SAAgB,YAAY,SAA0E;GACpG,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,GAAG,OAAO;GAC1D,MAAM,QAAQ,QAAQ;GACtB,IAAI,OAAO,OAAO,SAAS,UAAU,OAAO,MAAM;GAClD,OAAO;EACT;;EAGA,SAAgB,iBAAiB,OAA+C;GAC9E,MAAM,MAAsB,CAAC;GAC7B,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,eAAe,SAAS,KAAK,IAAuC,GAAG;IAC5E,MAAM,UAAU,SAAS,KAAK,IAAI;IAClC,IAAI,KAAK;KACP,KAAK,KAAK;KACV,WAAW,KAAK;KAChB,KAAK,SAAS,OAAO;KACrB,MAAM,SAAS,QAAQ;KAEvB,MAAM,YAAY,SAAS,OAAO;IACpC,CAAC;GACH;GACA,IAAI,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS;GAC5C,OAAO;EACT;;EAgBA,SAAgB,kBACd,OACA,YAC2C;GAC3C,IAAI,OAAkD;GACtD,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,KAAK,eAAe,UAAU;IAClC,IAAI,KAAK,QAAQ,YAAY;IAC7B,IAAI,SAAS,QAAQ,KAAK,YAAY,KAAK,WAAW,OAAO;KAAE,KAAK,KAAK;KAAK,WAAW,KAAK;IAAU;GAC1G;GACA,OAAO;EACT;;;;;;;;;ECxCA,MAAM,WAAW;GACf,gBAAgB;GAChB,UAAU;GACV,WAAW;GACX,QAAQ;EACV;EAEA,SAAS,aAAa,MAAsD;GAC1E,IAAI,MAAqB;GACzB,KAAK,MAAM,OAAO,MAChB,IAAI,QAAQ,QAAQ,IAAI,YAAY,KAAK,MAAM,IAAI;GAErD,OAAO;EACT;EAEA,SAAS,WAAW,MAA+G;GACjI,MAAM,MAA4C,CAAC;GACnD,KAAK,MAAM,OAAO,MAAM;IACtB,IAAI,IAAI,eAAe,UAAU;IACjC,IAAI,KAAK;KAAE,KAAK,IAAI;KAAK,WAAW,IAAI;IAAU,CAAC;GACrD;GACA,OAAO;EACT;;;;;;EAOA,eAAsB,eAAe,OAAkB,KAAa,UAAuB,CAAC,GAAwB;GAClH,MAAM,MAAM;IAAE,GAAG;IAAU,GAAG;GAAQ;GACtC,MAAM,QAAQ,MAAuB,WAAW,UAAsB;IACpE,MAAM,SAAS,MAAM,QAAQ;IAC7B,OAAO,WAAW;KAAE,IAAI;KAAO;KAAM,UAAU;IAAK,IAAI;KAAE,IAAI;KAAO;IAAK;GAC5E;GAEA,IAAI,CAAC,MAAM,aAAa,GAAG,OAAO,KAAK,eAAe;GAEtD,MAAM,WAAW,MAAM,IAAI,IAAI,IAAI;GACnC,IAAI,QAAQ;GAGZ,OAAO,MAAM;IACX,MAAM,OAAO,MAAM,SAAS;IAC5B,IAAI,SAAS,KAAA,GAAW,OAAO,KAAK,eAAe;IACnD,MAAM,OAAO,WAAW,KAAK,IAAI;IACjC,IAAI,KAAK,MAAM,MAAM,EAAE,QAAQ,GAAG,GAAG;IACrC,IAAI,KAAK,cAAc,QAAQ;KAC7B,IAAI,KAAK,cAAc,WAAW,MAAM,IAAI,IAAI,UAC9C,OAAO,KAAK,KAAK,cAAc,UAAU,kBAAkB,SAAS;KAEtE,MAAM,MAAM,MAAM,IAAI,MAAM;KAC5B;IACF;IACA,IAAI,KAAK,YAAY,MAAM,OAAO,KAAK,WAAW;IAClD,IAAI,SAAS,IAAI,YAAY,MAAM,IAAI,IAAI,UAAU,OAAO,KAAK,SAAS;IAC1E,IAAI,KAAK,cAAc;KACrB,MAAM,MAAM,MAAM,IAAI,MAAM;KAC5B;IACF;IACA,MAAM,SAAS,aAAa,IAAI;IAChC,MAAM,MAAM,UAAU;IACtB,SAAS;IACT,MAAM,YAAY,MAAM,SAAS;IACjC,MAAM,QAAQ,aAAa,cAAc,KAAA,IAAY,CAAC,IAAI,UAAU,IAAI;IACxE,IAAI,UAAU,QAAS,WAAW,QAAQ,SAAS,QAAS,OAAO,KAAK,WAAW;GACrF;GAGA,MAAM,YAAY,OAAO,WAAgD;IACvE,KAAK,IAAI,SAAS,GAAG,UAAU,IAAI,WAAW,UAAU,IAAI,QAAQ;KAClE,IAAI,CAAC,MAAM,aAAa,GAAG,OAAO;KAClC,MAAM,MAAM,MAAM,QAAQ,MAAM;KAChC,IAAI,QAAQ,MAAM,OAAO;KACzB,MAAM,MAAM,MAAM,IAAI,MAAM;IAC9B;IACA,OAAO;GACT;GAEA,MAAM,MAAM,MAAM,UAAU,GAAG;GAC/B,IAAI,QAAQ,MAAM;IAChB,MAAM,eAAe,GAAG;IACxB,OAAO,EAAE,IAAI,KAAK;GACpB;GAEA,MAAM,OAAO,MAAM,SAAS;GAC5B,MAAM,WAAW,kBAAkB,SAAS,KAAA,IAAY,CAAC,IAAI,KAAK,MAAM,GAAG;GAC3E,IAAI,aAAa,MAAM;IACrB,MAAM,QAAQ,MAAM,UAAU,SAAS,GAAG;IAC1C,IAAI,UAAU,MAAM;KAClB,MAAM,eAAe,KAAK;KAC1B,OAAO,KAAK,iBAAiB,IAAI;IACnC;GACF;GACA,OAAO,KAAK,iBAAiB,KAAK;EACpC;;;;ECzHA,MAAM,KAAK;;EAUX,MAAa,SAAS;GAAC;GAAS;GAAU;EAAU;EAQpD,SAAS,aAAsB;GAC7B,IAAI,WAAW,4BAA4B,MAAM,OAAO;GACxD,WAAW,0BAA0B;GACrC,OAAO;EACT;EAEA,SAAS,eAAqB;GAC5B,WAAW,0BAA0B,KAAA;EACvC;;EAGA,SAAS,aAAa,KAAoB,WAAiC;GACzE,OAAO;IACL,gBAAgB;KAEd,MAAM,OADU,IAAI,SAAS,QAAQ,SAClB,CAAC,EAAE,QAAQ,YAAY;KAC1C,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;KAC/B,OAAO;MACL,WAAW,KAAK;MAChB,SAAS,KAAK;MACd,cAAc,KAAK;MACnB,MAAM,KAAK,KAAK,MAAM,OAAO;KAC/B;IACF;IACA,WAAW,YAAY;KACrB,MAAM,UAAU,IAAI,SAAS,QAAQ,SAAS;KAC9C,IAAI,YAAY,KAAA,GAAW,MAAM,IAAI,MAAM,qBAAqB;KAChE,MAAM,QAAQ,QAAQ,UAAU;IAClC;IACA,oBAAoB,SAAS,cAAc,kBAAkB,MAAM;IACnE,UAAU,QAAgB;KACxB,KAAK,MAAM,aAAa,MAAM,KAAK,SAAS,iBAA8B,wBAAwB,CAAC,GACjG,IAAI,UAAU,QAAQ,kBAAkB,KAAK,OAAO;KAEtD,OAAO;IACT;IACA,iBAAiB,QAAQ,IAAI,eAAe,EAAE,OAAO,QAAQ,CAAC;IAC9D,WAAW,KAAK,IAAI;IACpB,QAAQ,OAAO,IAAI,SAAS,YAAY,OAAO,WAAW,SAAS,EAAE,CAAC;GACxE;EACF;;;;;;EAOA,SAAS,qBAAqB,KAAoB,WAAkD;GAClG,MAAM,OAAO,IAAI,SAAS,QAAQ,SAAS,CAAC,EAAE,QAAQ,YAAY,OAAO,eAAe;GACxF,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;GAC/B,OAAO;IACL,mBAAmB,KAAK,YAAY;IACpC,YAAY,aAAa,KAAK,UAAU,QAAQ;GAClD;EACF;EAEA,SAAS,aAAa,KAAyC;GAC7D,OAAO;IACL,gBAAgB,cAAc;KAC5B,MAAM,OAAO,IAAI,SAAS,QAAQ,SAAS,CAAC,EAAE,QAAQ,YAAY;KAClE,IAAI,SAAS,KAAA,GAAW,OAAO,CAAC;KAChC,OAAO,iBAAiB,KAAK,KAAK,MAAM,OAAO,CAAC;IAClD;IACA,gBAAgB,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE;IACrD,mBAAmB,WAAW,OAAO;KACnC,MAAM,UAAU,IAAI,SAAS,QAAQ,SAAS;KAC9C,IAAI,YAAY,KAAA,GAAW,aAAa,CAAC;KACzC,OAAO,QAAQ,QAAQ,UAAU,EAAE;IACrC;IACA,qBAAqB,cAAc,qBAAqB,KAAK,SAAS;IACtE,OAAO,WAAW,QAAQ;KACxB,MAAM,QAAQ,aAAa,KAAK,SAAS;KACzC,MAAM,UAAU,SAA0B;MAGxC,OAAO,cAAc,IAAI,YAAY,4BAA4B,EAAE,QAAQ,KAAK,CAAC,CAAC;KACpF;KACA,eAAoB,OAAO,GAAG;IAChC;GACF;EACF;;;;;EAMA,SAAgB,MAAM,KAA0B;GAC9C,IAAI,CAAC,WAAW,GAAG;GACnB,IAAI,aAAa,cAAc,2BAA2B;GAE1D,IAAI,aAAa,IAAI,OAAO,SAAS,IAAI;IAAE;IAAI;GAAG,CAAC,GAAG,4BAA4B;GAElF,MAAM,WAAW,aAAa,GAAG;GAEjC,IAAI,MAAM,OAAO,uBAAuB,IAAI,MAAM,SAAS;IACzD,MAAM;IACN,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,cAAc;GAChB,GAAG,gBAAgB,CAAC;EACtB"}

package/lib/types/core/turn-dots.d.ts

@@ -35,7 +35,9 @@ export interface TurnDot {
 /**
  * Fold the projection's question list into one dot per turn. Entries arrive
  * in event order; consecutive same-turn entries merge into a single dot whose
- * anchor is the turn's first question.
+ * anchor is the turn's first question. The input is expected to be sorted by
+ * seq; the defensive sort is skipped when it already is, so a long session
+ * never pays an O(n log n) sort on every content update.
  */
 export declare function groupQuestionsByTurn(entries: readonly QuestionEntry[]): TurnDot[];
 /**
@@ -44,5 +46,8 @@ export declare function groupQuestionsByTurn(entries: readonly QuestionEntry[]):
  * whose key is already folded into a dot is dropped (the projected copy
  * wins); the rest become single-question dots with `turn: null`, inserted in
  * anchor-seq order so the strip stays strictly chronological.
+ *
+ * Fast path: when nothing new arrives the SAME array is returned (no copy),
+ * so the caller can bail out of a re-render on identical reference.
  */
 export declare function mergeLiveQuestions(dots: readonly TurnDot[], live: readonly QuestionNode[]): TurnDot[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@luziyang2026/dsh-question-nav",
   "description": "In-session question navigator for the DSH web GUI: a vertical minimap of round dots overlaid on the left edge of the conversation column, one dot per user question — hover enlarges and shows the full question text, click jumps to that message.",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "packageManager": "pnpm@11.7.0",
   "engines": {
@@ -69,7 +69,6 @@
     "react-dom": "^18.2.0",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
-    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.8"
   },
   "files": [
@@ -78,10 +77,9 @@
     "cordis.patch.yml",
     "LICENSE",
     "README.md",
-    "README.zh.md",
-    "README.i18n.yaml"
+    "README.zh.md"
   ],
-  "license": "BSD-3-Clause",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/AbelKeithsun/dsh-question-nav.git"

package/src/client/QuestionNavStrip.tsx

@@ -88,6 +88,22 @@ function findConvRoot(): HTMLElement | null {
   return document.querySelector<HTMLElement>('[data-slot="conversation"] > div[data-phase]')
 }
 
+/** Structural equality of two dot lists (member keys fully capture a dot's
+ * folded questions, so identical key sequences mean identical content).
+ * Lets the strip skip a re-render when a refresh produced no change. */
+function sameDots(a: readonly TurnDot[], b: readonly TurnDot[]): boolean {
+  if (a.length !== b.length) return false
+  for (let i = 0; i < a.length; i++) {
+    const da = a[i]
+    const db = b[i]
+    if (da.key !== db.key || da.memberKeys.length !== db.memberKeys.length) return false
+    for (let j = 0; j < da.memberKeys.length; j++) {
+      if (da.memberKeys[j] !== db.memberKeys[j]) return false
+    }
+  }
+  return true
+}
+
 export function QuestionNavStrip(props: ComponentProps): React.JSX.Element | null {
   const current = props.useSessions((s) => s.current)
   const summary = props.useSessions((s) => (s.current === undefined ? undefined : s.byId[s.current]))
@@ -99,6 +115,8 @@ export function QuestionNavStrip(props: ComponentProps): React.JSX.Element | nul
   const [tooltip, setTooltip] = useState<TooltipState | null>(null)
   const panelRef = useRef<HTMLDivElement | null>(null)
   const hintTimerRef = useRef<number | null>(null)
+  // Last rendered dot list, for the change-detection bail-out below.
+  const lastDotsRef = useRef<TurnDot[]>([])
 
   const showHint = (message: string): void => {
     setHint(message)
@@ -106,27 +124,38 @@ export function QuestionNavStrip(props: ComponentProps): React.JSX.Element | nul
     hintTimerRef.current = window.setTimeout(() => setHint(null), 1800)
   }
 
-  // Recompute the dot list from the projection + live window; subscribe to
-  // the projection push frames, session content, and the session list.
+  // Recompute the dot list from the projection + live window. Subscribed to
+  // the projection push frames and the session's content only — session
+  // switches are covered by `current` below (the effect re-runs on change),
+  // so the session-list feed is not subscribed: it would re-run the full
+  // recompute for unrelated list churn.
   useEffect(() => {
     if (!visible || current === undefined) {
       setDots([])
+      lastDotsRef.current = []
       return
     }
     const sessionId = current
     const face = props.questionProjection(sessionId)
     const refresh = (): void => {
       const grouped = groupQuestionsByTurn(projectionEntries(face))
-      setDots(mergeLiveQuestions(grouped, props.readQuestions(sessionId)))
+      const next = mergeLiveQuestions(grouped, props.readQuestions(sessionId))
+      // Identical content (a streaming update that added no question): re-use
+      // the previous array reference so React bails out of re-rendering the
+      // strip — the common case during assistant streaming.
+      if (sameDots(next, lastDotsRef.current)) {
+        setDots(lastDotsRef.current)
+        return
+      }
+      lastDotsRef.current = next
+      setDots(next)
     }
     refresh()
     const unsubProjection = face?.subscribe(refresh) ?? (() => {})
     const unsubContent = props.subscribeContent(sessionId, refresh)
-    const unsubList = props.subscribeList(refresh)
     return () => {
       unsubProjection()
       unsubContent()
-      unsubList()
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [visible, current, props])
@@ -143,40 +172,90 @@ export function QuestionNavStrip(props: ComponentProps): React.JSX.Element | nul
 
   // Anchor the minimap to the conversation column: position it at the left
   // edge of the conversation root and reserve a thin rail with padding-left.
+  //
+  // A layout-correction loop keeps the rail pinned to the conversation even
+  // when an outside panel (e.g. a browser-extension sidebar like Doubao) moves
+  // or resizes the frame without resizing the browser window: `window resize`
+  // never fires for in-page panels, and a ResizeObserver on the conversation
+  // root alone misses remounts and the tail of the frame's grid-column
+  // transition, which used to leave the rail drifting into the session list.
+  // The loop runs while the layout is still moving, then parks itself after a
+  // few stable frames; observers re-wake it on the next change.
   useLayoutEffect(() => {
     if (!visible) return
     let raf = 0
-    let retries = 0
-    const applyLayout = (): void => {
+    let idle = 0
+    let stopped = false
+    let observer: ResizeObserver | null = null
+    const observed = { frame: null as Element | null, convRoot: null as Element | null }
+
+    const applyLayout = (): boolean => {
       const panel = panelRef.current
-      if (panel === null) return
+      if (panel === null) return false
       const frame = panel.closest('[data-shell-overlay]')?.parentElement ?? null
       const convRoot = findConvRoot()
-      if (frame === null || convRoot === null) return
+      // Keep looping while the anchors are not both present (conversation not
+      // mounted yet / mid-reflow), so a late mount still aligns.
+      if (frame === null || convRoot === null) return true
+      // Keep observing the live nodes: the conversation root may remount
+      // (e.g. after a panel-triggered reflow), which silently detaches an
+      // earlier ResizeObserver target.
+      if (observer !== null) {
+        if (observed.frame !== frame) {
+          observer.observe(frame, { box: 'border-box' })
+          observed.frame = frame
+        }
+        if (observed.convRoot !== convRoot) {
+          observer.observe(convRoot, { box: 'border-box' })
+          observed.convRoot = convRoot
+        }
+      }
       const frameRect = frame.getBoundingClientRect()
       const convRect = convRoot.getBoundingClientRect()
-      if (convRect.height <= 0) {
-        if (retries < 20) {
-          retries += 1
-          raf = requestAnimationFrame(applyLayout)
-        }
-        return
+      // Never snap onto a transient box: keep correcting until the
+      // conversation has a real footprint again.
+      if (convRect.height <= 0 || convRect.width <= 0) return true
+      const top = `${convRect.top - frameRect.top}px`
+      const height = `${convRect.height}px`
+      const left = `${convRect.left - frameRect.left}px`
+      if (panel.style.top === top && panel.style.height === height && panel.style.left === left) {
+        return false
       }
-      retries = 0
-      panel.style.top = `${convRect.top - frameRect.top}px`
-      panel.style.height = `${convRect.height}px`
-      panel.style.left = `${convRect.left - frameRect.left}px`
+      panel.style.top = top
+      panel.style.height = height
+      panel.style.left = left
+      return true
+    }
+
+    const loop = (): void => {
+      if (stopped) return
+      raf = 0
+      idle = applyLayout() ? 0 : idle + 1
+      if (idle < 3) raf = requestAnimationFrame(loop)
+    }
+    const wake = (): void => {
+      if (stopped) return
+      idle = 0
+      if (raf === 0) raf = requestAnimationFrame(loop)
     }
-    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)
+
+    observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(wake)
+    if (observer !== null) {
+      const panel = panelRef.current
+      const frame = panel?.closest('[data-shell-overlay]')?.parentElement ?? null
+      const convRoot = findConvRoot()
+      if (frame !== null) { observer.observe(frame, { box: 'border-box' }); observed.frame = frame }
+      if (convRoot !== null) { observer.observe(convRoot, { box: 'border-box' }); observed.convRoot = convRoot }
+    }
+
+    // Initial alignment; the loop keeps correcting through layout transitions.
+    wake()
+    window.addEventListener('resize', wake)
     return () => {
+      stopped = true
       if (raf !== 0) cancelAnimationFrame(raf)
       observer?.disconnect()
-      window.removeEventListener('resize', applyLayout)
+      window.removeEventListener('resize', wake)
     }
   }, [visible])
 

package/src/core/turn-dots.ts

@@ -40,13 +40,24 @@ export interface TurnDot {
   readonly memberKeys: readonly string[]
 }
 
+/** True when entries are already in non-decreasing seq order (the projection
+ * appends in event order, so this is the common case and skips the sort). */
+function isSortedBySeq(entries: readonly QuestionEntry[]): boolean {
+  for (let i = 1; i < entries.length; i++) {
+    if (entries[i].seq < entries[i - 1].seq) return false
+  }
+  return true
+}
+
 /**
  * Fold the projection's question list into one dot per turn. Entries arrive
  * in event order; consecutive same-turn entries merge into a single dot whose
- * anchor is the turn's first question.
+ * anchor is the turn's first question. The input is expected to be sorted by
+ * seq; the defensive sort is skipped when it already is, so a long session
+ * never pays an O(n log n) sort on every content update.
  */
 export function groupQuestionsByTurn(entries: readonly QuestionEntry[]): TurnDot[] {
-  const sorted = [...entries].sort((a, b) => a.seq - b.seq)
+  const sorted = isSortedBySeq(entries) ? entries : [...entries].sort((a, b) => a.seq - b.seq)
   const dots: TurnDot[] = []
   for (const entry of sorted) {
     const key = questionKey(entry.id)
@@ -77,22 +88,49 @@ export function groupQuestionsByTurn(entries: readonly QuestionEntry[]): TurnDot
  * whose key is already folded into a dot is dropped (the projected copy
  * wins); the rest become single-question dots with `turn: null`, inserted in
  * anchor-seq order so the strip stays strictly chronological.
+ *
+ * Fast path: when nothing new arrives the SAME array is returned (no copy),
+ * so the caller can bail out of a re-render on identical reference.
  */
 export function mergeLiveQuestions(
   dots: readonly TurnDot[],
   live: readonly QuestionNode[],
 ): TurnDot[] {
-  const known = new Set(dots.flatMap(dot => dot.memberKeys))
-  const extras: TurnDot[] = live
-    .filter(question => !known.has(question.key))
-    .map(question => ({
+  if (live.length === 0) return dots as TurnDot[]
+  const known = new Set<string>()
+  for (const dot of dots) {
+    for (const key of dot.memberKeys) known.add(key)
+  }
+  const extras: TurnDot[] = []
+  for (const question of live) {
+    if (known.has(question.key)) continue
+    extras.push({
       turn: null,
       key: question.key,
       anchorSeq: question.anchorSeq,
       time: question.time,
       texts: [question.text],
       memberKeys: [question.key],
-    }))
-  if (extras.length === 0) return [...dots]
-  return [...dots, ...extras].sort((a, b) => a.anchorSeq - b.anchorSeq)
+    })
+  }
+  // Nothing new from the live window — reuse the input array unchanged.
+  if (extras.length === 0) return dots as TurnDot[]
+  // Both `dots` and `extras` are sorted by anchorSeq (dots from the projection
+  // order, extras from the live window order): merge linearly instead of
+  // re-sorting the whole list. Ties keep the projected dot first (stable
+  // sort semantics), matching the previous [...dots, ...extras].sort().
+  const out: TurnDot[] = []
+  let i = 0
+  for (const extra of extras) {
+    while (i < dots.length && dots[i].anchorSeq <= extra.anchorSeq) {
+      out.push(dots[i])
+      i += 1
+    }
+    out.push(extra)
+  }
+  while (i < dots.length) {
+    out.push(dots[i])
+    i += 1
+  }
+  return out
 }

package/lib/types/core/history-index.d.ts

@@ -1,99 +0,0 @@
-/**
- * Question-index builder over the raw session history RPC.
- *
- * DSH pages the rendered conversation window on purpose (memory economy):
- * `chat.nodes` only ever holds the loaded window, and force-expanding it
- * (repeated `loadOlder()`) materializes + renders the whole log — the exact
- * cost DSH's paging exists to avoid. This module instead builds a lightweight
- * index of every user question by paging the RAW history RPC (`session.history`
- * with `beforeSeq`), which reads the host log without touching the render
- * window at all. Only `{key, seq, time, text}` per question is retained.
- *
- * The chat anchor key is derived deterministically from the event — it equals
- * `conversationContextKey('input-message', String(event.data.id))` — so the
- * dots can target rows that are not loaded yet, and a click then pages the
- * window on demand (see `jump.ts`).
- *
- * Pure-ish: takes injected ports (one raw history page read, clocks) so it is
- * unit-testable without a browser or a live session.
- */
-import type { QuestionNode } from './nodes.ts';
-/** Minimal shape of a raw history event (structural, not SDK-bound). */
-export interface RawEventLike {
-    type: string;
-    seq: number;
-    time: number;
-    surfaceOp?: unknown;
-    data?: {
-        id?: unknown;
-        source?: {
-            kind?: string;
-            plugin?: string;
-        };
-        content?: readonly {
-            type?: string;
-            text?: string;
-        }[];
-    };
-}
-/** The conversation Definition kind whose key a user question node uses. */
-export declare 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).
- */
-export declare function questionKey(id: unknown): string;
-/**
- * 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.
- */
-export declare function isQuestionEvent(event: RawEventLike): boolean;
-/** Map one raw question event to a strip question node, or null when not one. */
-export declare function questionFromEvent(event: RawEventLike): QuestionNode | null;
-export interface HistoryIndexPorts {
-    /**
-     * Read one raw history page. `beforeSeq` is exclusive (events with seq <
-     * beforeSeq); `undefined` reads the newest page. Resolves undefined when
-     * the page is unavailable (session gone / transport error).
-     */
-    history: (beforeSeq: number | undefined, maxMessages: number) => Promise<{
-        events: readonly {
-            event: RawEventLike;
-        }[];
-        hasMore: boolean;
-    } | undefined>;
-    /** Monotonic ms clock. */
-    now: () => number;
-}
-export interface HistoryIndexOptions {
-    /** Raw messages per page (default 100). */
-    maxMessages?: number;
-    /** Max pages before giving up (default 200 => 20k messages). */
-    maxPages?: number;
-    /** Total wall-clock budget (default 30s). */
-    totalTimeoutMs?: number;
-    /** Abort the build; checked every iteration. */
-    signal?: AbortSignal;
-    /** Resume from a previous `nextBeforeSeq` instead of the newest page. */
-    startBeforeSeq?: number;
-}
-export type HistoryIndexCode = 'COMPLETE' | 'BUDGET' | 'TIMEOUT' | 'UNAVAILABLE' | 'CANCELLED';
-export interface HistoryIndexResult {
-    ok: boolean;
-    code: HistoryIndexCode;
-    /** Questions collected so far, ascending by anchorSeq. */
-    questions: QuestionNode[];
-    /** Page count actually read. */
-    pages: number;
-    /** Where to continue (exclusive) when stopped early; undefined when COMPLETE. */
-    nextBeforeSeq: number | undefined;
-}
-/**
- * Page the raw session history backward, collecting every user question into a
- * lightweight index. Never touches the render window.
- */
-export declare function buildQuestionIndex(ports: HistoryIndexPorts, options?: HistoryIndexOptions): Promise<HistoryIndexResult>;

package/lib/types/core/load-all.d.ts

@@ -1,53 +0,0 @@
-/**
- * Load-all orchestration for the question-nav strip.
- *
- * DSH sessions page history in fixed-size chunks: `chat.nodes` only ever holds
- * the currently loaded window, and questions that still sit behind the "load
- * older" button are invisible to the strip until the window is expanded
- * backwards. This loop pages `loadOlder()` until `hasMore` is false (the whole
- * history is materialized), so every user question becomes a dot.
- *
- * Pure-ish: takes injected ports (snapshot read, one paged loadOlder, view
- * liveness, clocks) so it is unit-testable without a browser or session.
- */
-export interface LoadAllSnapshot {
-    openState: string;
-    hasMore: boolean;
-    loadingOlder: boolean;
-}
-export interface LoadAllPorts {
-    /** Read the current session snapshot; undefined when unavailable. */
-    snapshot: () => LoadAllSnapshot | undefined;
-    /** Expand the window backwards by one page (may preserve scroll). */
-    loadOlder: () => Promise<void>;
-    /** True while the chat view is active (a `[data-chat-flow]` is mounted). */
-    isViewActive: () => boolean;
-    /** Monotonic ms clock. */
-    now: () => number;
-    /** Async sleep. */
-    sleep: (ms: number) => Promise<void>;
-}
-export interface LoadAllOptions {
-    /** Max older pages to fetch before giving up (default 400). */
-    maxPages?: number;
-    /** Total wall-clock budget for the whole expansion (default 60s). */
-    totalTimeoutMs?: number;
-    /** Poll interval for open/loading transitions (default 60ms). */
-    pollMs?: number;
-    /** Abort the expansion; checked every iteration. */
-    signal?: AbortSignal;
-}
-export type LoadAllCode = 'COMPLETE' | 'VIEW_INACTIVE' | 'NOT_OPEN' | 'BUDGET' | 'TIMEOUT' | 'CANCELLED';
-export interface LoadAllResult {
-    ok: boolean;
-    code: LoadAllCode;
-    /** Number of `loadOlder` pages actually fetched. */
-    pages: number;
-}
-/**
- * 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`.
- */
-export declare function loadAllOlder(ports: LoadAllPorts, options?: LoadAllOptions): Promise<LoadAllResult>;