@kirkchinese/dsh-citeciter 0.4.1 → 0.4.3

package/README.md

@@ -11,7 +11,7 @@ Investigate any line in a DSH response—without stopping the Agent or changing
 ## Highlights
 
 - **Exact source binding.** CiteCiter rechecks the visible selection against the committed response before creating a Topic.
-- **No need to wait.** A committed model response can be investigated while the surrounding Agent turn continues.
+- **No need to wait.** A committed intermediate model call can be investigated while the surrounding Agent turn continues, including its reasoning or a selection spanning reasoning and answer text.
 - **Durable investigations.** Private Topics support natural follow-up questions and reopen after a refresh or restart.
 - **Evidence with no write access.** CiteCiter can inspect committed source events and search or read project files, but cannot change the source Session or workspace.
 - **Inspectable work.** Questions, answers, source reads, and project-file checks remain together in the investigation panel.
@@ -19,23 +19,23 @@ Investigate any line in a DSH response—without stopping the Agent or changing
 
 ## Use
 
-1. Select text inside a committed assistant model call. The surrounding Agent turn may still be running.
+1. Select answer or expanded reasoning text inside a committed assistant model call. The surrounding Agent turn may still be running.
 2. Right-click the selection, enter your first question, and choose `Citer!`.
 3. CiteCiter creates a new Topic in the investigation panel.
 4. Continue asking questions there, or reopen an earlier Topic from CiteCiter's Topic rail.
 5. Change the Topic model, reasoning effort, title, archive state, or panel width without changing the source Session.
 
-## Install v0.4.1
+## Install v0.4.3
 
-CiteCiter 0.4.1 requires Node.js `^22.19.0 || >=24.0.0` and DSH `>=0.1.1-rc.1 <0.1.1-rc.3`.
+CiteCiter 0.4.3 requires Node.js `^22.19.0 || >=24.0.0` and DSH `>=0.1.1-rc.1 <0.1.1-rc.3`.
 
 For DSH Web:
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.3
 ```
 
-Restart DSH Web and refresh the page. Packaged Desktop adaptation is deferred; CiteCiter 0.4.1 does not provide a supported Desktop installation path.
+Restart DSH Web and refresh the page. Packaged Desktop adaptation is deferred; CiteCiter 0.4.3 does not provide a supported Desktop installation path.
 
 ## Context modes
 
@@ -47,7 +47,7 @@ Exact Fork is an advanced mode for a source turn that has already ended. `exact-
 
 | Host | CiteCiter version | Status |
 |---|---|---|
-| DSH Web `0.1.1-rc.2` | `0.4.1` | Linux package, CI, upgrade, and assembled keyless browser checks passed; real-provider acceptance was not run |
+| DSH Web `0.1.1-rc.2` | `0.4.3` | Linux package, regression tests, and real-browser selection checks passed; real-provider acceptance was not run |
 | [DSH Desktop 2.0.2](https://github.com/anywhere-labs/deepseek-harness-desktop) with bundled DSH `0.1.1-rc.2` | Future target | Adaptation and native acceptance are deferred; no packaged-Desktop compatibility claim |
 | [dataelement DSH Desktop](https://github.com/dataelement/dsh-desktop) development shell with DSH `0.1.1-rc.1` | `0.4.0` only | Historical conditional Linux source-shell evidence |
 | DSH Web `0.1.0-rc.7` | `0.3.2` | Previous stable line |
@@ -57,27 +57,27 @@ The demo uses a deterministic fixture to show the workflow; it is not real-provi
 
 ## Upgrade from an earlier version
 
-To install or upgrade v0.4.1 in Web:
+To install or upgrade v0.4.3 in Web:
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.3
 dsh plugin --profile web list --depth 0
 ```
 
-Packaged Desktop adaptation is deferred and is not part of the supported 0.4.1 upgrade path.
+Packaged Desktop adaptation is deferred and is not part of the supported 0.4.3 upgrade path.
 
 Upgrading from v0.3 does not migrate or rewrite existing Topics, settings, or source Sessions. Users remaining on DSH `0.1.0-rc.7` should keep CiteCiter 0.3.2.
 
 ## Limitations
 
-- A selection must include at least one committed assistant model call. User-only ranges, tool-only ranges, and still-streaming fragments cannot anchor a Citation.
+- A selection must include at least one committed assistant model call. User-only ranges, tool-only ranges, still-streaming fragments, and the generated reasoning disclosure header cannot anchor a Citation.
 - Renderer-generated KaTeX layout and footnote numbers cannot be cited directly because they lack stable source coordinates.
 - Exact Fork cannot start from an open source turn.
 - Source-file access depends on the running DSH filesystem service and remains read-only.
 - Read Frog translated selections are a best-effort compatibility path on DSH rc.1/rc.2 and activate only when its complete private marker set is present; ordinary DSH selection does not depend on Read Frog.
 - DSH does not yet expose a public additive right-dock contribution point. CiteCiter therefore uses a reversible private AppFrame grid adapter whenever the panel and conversation fit; it preserves the layout's details preference but temporarily hides that column while the investigation panel is open, and it must be retested for every supported DSH release.
 - Topics are Host-durable. When Desktop restarts on a different loopback port, CiteCiter falls back to the most recently updated Topic because browser local storage is origin-scoped; configure a fixed Desktop port to restore the exact last-viewed Topic.
-- CiteCiter 0.4.1 makes no packaged-Desktop compatibility claim; native Windows and macOS adaptation continues separately.
+- CiteCiter 0.4.3 makes no packaged-Desktop compatibility claim; native Windows and macOS adaptation continues separately.
 - There is currently no TUI interaction adapter.
 - DSH is prerelease software; later DSH API versions may require a CiteCiter update.
 

package/README.zh.md

@@ -11,7 +11,7 @@
 ## 核心能力
 
 - **精确绑定来源。** 创建 Topic 前，CiteCiter 会把可见选区与已经提交的回答重新核对。
-- **不用等待主任务。** 一次模型回答提交后即可开始调查，外层 Agent 轮次可以继续运行。
+- **不用等待主任务。** 一次中间模型调用提交后即可开始调查，外层 Agent 轮次可以继续运行；思考内容和跨越“思考+回答”的选区也可以使用。
 - **调查可以持续。** 私有 Topic 支持自然续问，刷新或重启后仍能重新打开。
 - **有证据、无写权限。** CiteCiter 能检查来源中已提交的事件，也能搜索和阅读项目文件，但不能改变来源 Session 或工作区。
 - **过程可检查。** 问题、回答、来源读取和项目文件核查都留在调查面板中。
@@ -19,23 +19,23 @@
 
 ## 使用
 
-1. 在一次已经提交的助手模型调用中选择文字；外层 Agent 轮次可以仍在运行。
+1. 在一次已经提交的助手模型调用中选择回答或展开后的思考文字；外层 Agent 轮次可以仍在运行。
 2. 右键选区，输入第一个问题，然后点击 `Citer!`。
 3. CiteCiter 在调查面板中创建一个新 Topic。
 4. 在 Topic 中继续追问，或从 CiteCiter 的 Topic 栏恢复旧讨论。
 5. 独立调整模型、思考强度、标题、归档状态和面板宽度，不改变来源 Session。
 
-## 安装 v0.4.1
+## 安装 v0.4.3
 
-CiteCiter 0.4.1 需要 Node.js `^22.19.0 || >=24.0.0` 与 DSH `>=0.1.1-rc.1 <0.1.1-rc.3`。
+CiteCiter 0.4.3 需要 Node.js `^22.19.0 || >=24.0.0` 与 DSH `>=0.1.1-rc.1 <0.1.1-rc.3`。
 
 DSH Web 使用：
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.3
 ```
 
-安装后重启 DSH Web 并刷新页面。正式 Desktop 适配已经暂缓；CiteCiter 0.4.1 不提供受支持的 Desktop 安装路径。
+安装后重启 DSH Web 并刷新页面。正式 Desktop 适配已经暂缓；CiteCiter 0.4.3 不提供受支持的 Desktop 安装路径。
 
 ## 上下文模式
 
@@ -47,7 +47,7 @@ Exact Fork 是面向已结束来源轮次的高级模式。`exact-when-available
 
 | 宿主 | CiteCiter 版本 | 状态 |
 |---|---|---|
-| DSH Web `0.1.1-rc.2` | `0.4.1` | Linux 包、CI、升级与组装 keyless 浏览器检查通过；真实提供方验收未运行 |
+| DSH Web `0.1.1-rc.2` | `0.4.3` | Linux 包、回归测试与真实浏览器选区检查通过；真实提供方验收未运行 |
 | [DSH Desktop 2.0.2](https://github.com/anywhere-labs/deepseek-harness-desktop)（内置 DSH `0.1.1-rc.2`） | 后续目标 | 适配与原生验收暂缓；不声明正式 Desktop 安装包兼容性 |
 | [dataelement DSH Desktop](https://github.com/dataelement/dsh-desktop) 源码开发壳（内置 DSH `0.1.1-rc.1`） | 仅 `0.4.0` | 历史上的有条件 Linux 源码壳证据 |
 | DSH Web `0.1.0-rc.7` | `0.3.2` | 旧版稳定线 |
@@ -57,27 +57,27 @@ Exact Fork 是面向已结束来源轮次的高级模式。`exact-when-available
 
 ## 从旧版本升级
 
-在 Web 安装或升级 v0.4.1：
+在 Web 安装或升级 v0.4.3：
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.3
 dsh plugin --profile web list --depth 0
 ```
 
-正式 Desktop 适配已经暂缓，不属于 0.4.1 的受支持升级路径。
+正式 Desktop 适配已经暂缓，不属于 0.4.3 的受支持升级路径。
 
 从 v0.3 升级不会迁移或重写现有 Topic、设置或来源 Session。仍在 DSH `0.1.0-rc.7` 上运行的用户应继续使用 CiteCiter 0.3.2。
 
 ## 已知限制
 
-- 选区中必须至少包含一个已经提交的助手模型回答；纯用户消息、纯工具行和仍在流式输出的片段不能作为引用锚点。
+- 选区中必须至少包含一个已经提交的助手模型调用；纯用户消息、纯工具行、仍在流式输出的片段和自动生成的思考折叠标题不能作为引用锚点。
 - 渲染器生成的 KaTeX 排版和脚注编号没有稳定原文坐标，不能直接引用。
 - Exact Fork 不能从仍在运行的来源轮次开始。
 - 来源文件访问依赖当前 DSH 文件系统服务，并始终保持只读。
 - Read Frog 翻译选区是 DSH rc.1/rc.2 上的 best-effort 兼容路径，仅在其完整私有标记同时存在时启用；普通 DSH 选区不依赖 Read Frog。
 - DSH 尚未提供公开的增量右侧 dock 布局扩展点。CiteCiter 因此在面板与主对话能够同时容纳时使用可逆的私有 AppFrame grid 适配器；它保留布局的 details 偏好，但在调查面板打开期间临时隐藏该列，并且每个受支持的 DSH 版本都必须重新验证。
 - Topic 由 Host 持久保存。Desktop 重启到不同 loopback 端口时，浏览器 localStorage 会因 origin 改变而失去精确指针，CiteCiter 将回退到最近更新的 Topic；需要精确恢复“上次查看”时应配置固定 Desktop 端口。
-- CiteCiter 0.4.1 不声明正式 Desktop 安装包兼容性；Windows 与 macOS 原生适配将另行继续。
+- CiteCiter 0.4.3 不声明正式 Desktop 安装包兼容性；Windows 与 macOS 原生适配将另行继续。
 - 当前没有 TUI 交互适配器。
 - DSH 仍处于预发布阶段，后续 API 版本可能要求同步更新 CiteCiter。
 

package/lib/client.js

@@ -4443,6 +4443,26 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}]
 		};
 		//#endregion
+		//#region lib/types/assistant-content.js
+		/**
+		* Project committed reasoning and answer blocks in renderer order.
+		*
+		* @param blocks - DSH assistant content blocks.
+		* @returns reasoning and answer text separated by the renderer's paragraph break.
+		*/
+		function projectCitableAssistantContent(blocks) {
+			let text = "";
+			for (const block of blocks) {
+				if (block === null || typeof block !== "object") continue;
+				const candidate = block;
+				const kind = candidate.kind ?? candidate.type;
+				if (typeof candidate.text !== "string" || candidate.text === "") continue;
+				if (kind === "reasoning") text += `${candidate.text}\n\n`;
+				else if (kind === "text") text += candidate.text;
+			}
+			return text;
+		}
+		//#endregion
 		//#region lib/types/client/answer.js
 		/**
 		* Read visible text from one assistant-step payload without retaining its live node.
@@ -4453,12 +4473,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			if (data === null || typeof data !== "object") return null;
 			const record = data;
 			if (record.status !== "running" && record.status !== "settled" && record.status !== "interrupted") return null;
-			let text = "";
-			for (const block of record.blocks ?? []) {
-				if (typeof block !== "object" || block === null) continue;
-				const candidate = block;
-				if (candidate.kind === "text" && typeof candidate.text === "string") text += candidate.text;
-			}
+			const text = projectCitableAssistantContent(record.blocks ?? []);
 			return text === "" ? null : {
 				status: record.status,
 				text
@@ -5365,6 +5380,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const DSH_FLOW_SELECTOR = "[data-chat-flow-kind]";
 		const DSH_ASSISTANT_ANCHOR_SELECTOR = "[data-chat-flow-kind=\"assistant-step\"][data-chat-anchor-key]";
 		const DSH_REASONING_SELECTOR = "[data-variant=\"think\"]";
+		const DSH_REASONING_HEADER_SELECTOR = "[data-disclosure-row]";
 		const DSH_GENERATED_CONTENT_SELECTOR = "button, .katex, [data-footnotes], sup";
 		const DSH_CODE_BLOCK_SELECTOR = ".md-code-block";
 		const READ_FROG_TRANSLATION_SELECTOR = "[data-read-frog-translation-mode]";
@@ -5423,14 +5439,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return anchors;
 		}
 		/**
-		* Detect DSH-rendered reasoning, generated controls, and collapsed code chrome.
+		* Detect generated controls, reasoning summaries, and collapsed code chrome.
 		*
 		* @param range - current rendered selection range.
 		* @param flow - assistant flow containing the range.
 		* @returns whether the range touches content that CiteCiter must ignore.
 		*/
 		function dshRangeTouchesExcludedContent(range, flow) {
-			for (const reasoning of flow.querySelectorAll(DSH_REASONING_SELECTOR)) if (range.intersectsNode(reasoning)) return true;
+			for (const reasoning of flow.querySelectorAll(DSH_REASONING_SELECTOR)) for (const header of reasoning.querySelectorAll(DSH_REASONING_HEADER_SELECTOR)) if (range.intersectsNode(header)) return true;
 			for (const generated of flow.querySelectorAll(DSH_GENERATED_CONTENT_SELECTOR)) if (range.intersectsNode(generated)) return true;
 			for (const endpoint of [range.startContainer, range.endContainer]) {
 				const element = elementForNode(endpoint);
@@ -5449,13 +5465,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return null;
 		}
 		/**
-		* Determine whether a node is a Read Frog translated projection rather than source text.
+		* Determine whether a node is generated UI rather than committed citable text.
 		*
 		* @param node - rendered node to classify.
-		* @returns whether Read Frog marks the node as translated content.
+		* @returns whether the node must stay out of the citable projection.
 		*/
-		function isReadFrogTranslatedContent(node) {
-			return node.nodeType === Node.ELEMENT_NODE && node.matches(READ_FROG_TRANSLATION_SELECTOR);
+		function isNonCitableProjection(node) {
+			if (node.nodeType !== Node.ELEMENT_NODE) return false;
+			const element = node;
+			return element.matches(READ_FROG_TRANSLATION_SELECTOR) || element.matches(DSH_REASONING_HEADER_SELECTOR) && element.closest(DSH_REASONING_SELECTOR) !== null;
+		}
+		/**
+		* Determine whether a node owns one DSH reasoning block.
+		*
+		* @param node - rendered node to classify.
+		* @returns whether the node is a reasoning root.
+		*/
+		function isDshReasoningContent(node) {
+			return node.nodeType === Node.ELEMENT_NODE && node.matches(DSH_REASONING_SELECTOR);
 		}
 		/**
 		* Resolve a selection wholly inside one Read Frog translation to its source paragraph.
@@ -6939,11 +6966,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			let targetStart;
 			let targetEnd;
 			const visit = (node) => {
-				if (isReadFrogTranslatedContent(node)) return;
+				if (isNonCitableProjection(node)) return;
+				const start = text.length;
 				if (node === target) targetStart = text.length;
 				if (node.nodeType === Node.TEXT_NODE) text += node.textContent ?? "";
 				else for (const child of node.childNodes) visit(child);
 				if (node === target) targetEnd = text.length;
+				if (isDshReasoningContent(node) && text.length > start) text += "\n\n";
 			};
 			visit(root);
 			return {
@@ -6956,7 +6985,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			let text = "";
 			let found = false;
 			const visit = (node) => {
-				if (found || isReadFrogTranslatedContent(node)) return;
+				if (found || isNonCitableProjection(node)) return;
 				if (node === boundary) {
 					if (node.nodeType === Node.TEXT_NODE) text += (node.textContent ?? "").slice(0, offset);
 					else for (let index = 0; index < offset; index++) {
@@ -6966,8 +6995,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					found = true;
 					return;
 				}
+				const start = text.length;
 				if (node.nodeType === Node.TEXT_NODE) text += node.textContent ?? "";
-				else for (const child of node.childNodes) visit(child);
+				else for (const child of node.childNodes) {
+					visit(child);
+					if (found) return;
+				}
+				if (isDshReasoningContent(node) && text.length > start) text += "\n\n";
 			};
 			visit(root);
 			return found ? text : null;

package/lib/index.js

@@ -33,6 +33,26 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
+//#region lib/types/assistant-content.js
+/**
+* Project committed reasoning and answer blocks in renderer order.
+*
+* @param blocks - DSH assistant content blocks.
+* @returns reasoning and answer text separated by the renderer's paragraph break.
+*/
+function projectCitableAssistantContent(blocks) {
+	let text = "";
+	for (const block of blocks) {
+		if (block === null || typeof block !== "object") continue;
+		const candidate = block;
+		const kind = candidate.kind ?? candidate.type;
+		if (typeof candidate.text !== "string" || candidate.text === "") continue;
+		if (kind === "reasoning") text += `${candidate.text}\n\n`;
+		else if (kind === "text") text += candidate.text;
+	}
+	return text;
+}
+//#endregion
 //#region ../../node_modules/.pnpm/mdast-util-to-string@4.0.0/node_modules/mdast-util-to-string/lib/index.js
 /**
 * @typedef {import('mdast').Nodes} Nodes
@@ -14369,7 +14389,8 @@ function compactMapped(units) {
 		});
 		else compact[compact.length - 1] = {
 			...previous,
-			endOffset: unit.endOffset
+			endOffset: unit.endOffset,
+			...previous.synthetic === true || unit.synthetic === true ? { synthetic: true } : {}
 		};
 	}
 	return compact;
@@ -14384,7 +14405,8 @@ function joinMapped(parts, separator) {
 			for (const text of separator) joined.push({
 				text,
 				startOffset: before,
-				endOffset: after
+				endOffset: after,
+				synthetic: true
 			});
 		}
 		joined.push(...part);
@@ -14442,6 +14464,47 @@ function candidatesFromProjection(markdown, projection, needle) {
 	}
 	return candidates;
 }
+function candidatesIgnoringSyntheticWhitespace(markdown, projection, needle) {
+	const rendered = visibleText(projection);
+	const visibleOffsets = [0];
+	for (const unit of projection) visibleOffsets.push(visibleOffsets.at(-1) + unit.text.length);
+	const candidates = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (let start = 0; start < projection.length; start++) {
+		const first = projection[start];
+		if (first.synthetic === true) continue;
+		let unitIndex = start;
+		let needleOffset = 0;
+		let lastIndex = -1;
+		while (needleOffset < needle.length && unitIndex < projection.length) {
+			const unit = projection[unitIndex];
+			if (unit.synthetic === true) {
+				while (projection[unitIndex]?.synthetic === true) unitIndex++;
+				needleOffset += /^\s+/u.exec(needle.slice(needleOffset))?.[0].length ?? 0;
+				continue;
+			}
+			if (!needle.startsWith(unit.text, needleOffset)) break;
+			needleOffset += unit.text.length;
+			lastIndex = unitIndex;
+			unitIndex++;
+		}
+		if (needleOffset !== needle.length || lastIndex < start) continue;
+		const last = projection[lastIndex];
+		const key = `${first.startOffset}:${last.endOffset}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const visibleStart = visibleOffsets[start];
+		const visibleEnd = visibleOffsets[lastIndex + 1];
+		candidates.push({
+			startOffset: first.startOffset,
+			endOffset: last.endOffset,
+			sourceText: markdown.slice(first.startOffset, last.endOffset),
+			displayPrefix: rendered.slice(Math.max(0, visibleStart - 240), visibleStart),
+			displaySuffix: rendered.slice(visibleEnd, visibleEnd + 240)
+		});
+	}
+	return candidates;
+}
 /**
 * Locate every GFM source range that renders as one browser-visible selection.
 *
@@ -14458,7 +14521,11 @@ function markdownSourceCandidates(markdown, displayText) {
 	if (needle === "") return [];
 	const exact = candidatesFromProjection(markdown, projection, needle);
 	if (exact.length > 0) return exact;
-	return candidatesFromProjection(markdown, compactMapped(projection), needle.replace(/\s+/gu, " "));
+	const compactProjection = compactMapped(projection);
+	const compactNeedle = needle.replace(/\s+/gu, " ");
+	const compact = candidatesFromProjection(markdown, compactProjection, compactNeedle);
+	if (compact.length > 0) return compact;
+	return candidatesIgnoringSyntheticWhitespace(markdown, compactProjection, compactNeedle);
 }
 //#endregion
 //#region lib/types/citation-mapping.js
@@ -14519,23 +14586,37 @@ function committedAssistantText(source, sourceSessionId, anchorSeq) {
 	if (sourceSessionId !== source.session.id) throw new Error("Citation sourceSessionId does not match the observed source Session");
 	const anchor = source.events.find((event) => event.seq === anchorSeq);
 	if (anchor?.type !== "assistant/message") throw new Error("Citation anchorSeq does not identify a committed assistant/message");
-	const text = messageText(anchor.data.message.content);
-	if (text === "") throw new Error("Citation assistant/message has no visible text");
+	const citable = projectCitableAssistantContent(anchor.data.message.content);
+	const answer = messageText(anchor.data.message.content);
+	const projections = citable === answer ? [citable] : [citable, answer].filter((text) => text !== "");
+	if (projections[0]?.trim() === "") throw new Error("Citation assistant/message has no citable text");
 	return {
 		seq: anchor.seq,
-		text
+		projections
 	};
 }
+function resolveProjectedRange(selection, projections) {
+	let failure;
+	for (const text of projections) try {
+		return {
+			range: resolveCitationRange(selection, text),
+			text
+		};
+	} catch (error) {
+		failure ??= error;
+	}
+	throw failure;
+}
 /** Resolve a browser selection claim against the authoritative committed assistant message. */
 function resolveObserverCitation(source, rawClaim) {
 	const claim = citationSelectionClaimSchema.parse(rawClaim);
 	const anchor = committedAssistantText(source, claim.sourceSessionId, claim.anchorSeq);
-	const range = resolveCitationRange({
+	const { range, text } = resolveProjectedRange({
 		displayText: claim.displayText,
 		...claim.sourceHintText === void 0 ? {} : { sourceHintText: claim.sourceHintText },
 		prefixText: claim.prefixText,
 		suffixText: claim.suffixText
-	}, anchor.text);
+	}, anchor.projections);
 	const identity = {
 		sourceSessionId: claim.sourceSessionId,
 		anchorSeq: anchor.seq,
@@ -14549,20 +14630,20 @@ function resolveObserverCitation(source, rawClaim) {
 			selectionFingerprint
 		},
 		assistantMessageSeq: anchor.seq,
-		assistantVisibleText: anchor.text,
+		assistantVisibleText: text,
 		contentFingerprint: selectionFingerprint
 	};
 }
 /**
-* Validate one Citation against a committed assistant message in the observed source snapshot.
+* Validate one Citation against committed reasoning or answer text in the observed source snapshot.
 * A matching `assistant/message` is sufficient; its step and turn may remain open.
 */
 function validateObserverCitation(source, rawDraft) {
 	const citation = citationDraftSchema.parse(rawDraft);
 	const anchor = committedAssistantText(source, citation.sourceSessionId, citation.anchorSeq);
-	const visibleText = anchor.text;
-	if (citation.endOffset <= citation.startOffset || citation.endOffset > visibleText.length || citation.endOffset - citation.startOffset !== citation.sourceText.length || visibleText.slice(citation.startOffset, citation.endOffset) !== citation.sourceText) throw new Error("Citation UTF-16 offsets and sourceText do not match the assistant/message");
-	if (visibleText.slice(Math.max(0, citation.startOffset - citation.prefixText.length), citation.startOffset) !== citation.prefixText || visibleText.slice(citation.endOffset, citation.endOffset + citation.suffixText.length) !== citation.suffixText) throw new Error("Citation surrounding context does not match the assistant/message");
+	if (anchor.projections.find((text) => citation.endOffset > citation.startOffset && citation.endOffset <= text.length && citation.endOffset - citation.startOffset === citation.sourceText.length && text.slice(citation.startOffset, citation.endOffset) === citation.sourceText) === void 0) throw new Error("Citation UTF-16 offsets and sourceText do not match the assistant/message");
+	const visibleText = anchor.projections.find((text) => citation.endOffset > citation.startOffset && citation.endOffset <= text.length && citation.endOffset - citation.startOffset === citation.sourceText.length && text.slice(citation.startOffset, citation.endOffset) === citation.sourceText && text.slice(Math.max(0, citation.startOffset - citation.prefixText.length), citation.startOffset) === citation.prefixText && text.slice(citation.endOffset, citation.endOffset + citation.suffixText.length) === citation.suffixText);
+	if (visibleText === void 0) throw new Error("Citation surrounding context does not match the assistant/message");
 	const expectedFingerprint = fingerprintCitationDraft(citation);
 	if (citation.selectionFingerprint !== expectedFingerprint) throw new Error("Citation content fingerprint does not match its evidence");
 	return {

package/lib/types/assistant-content.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Project committed reasoning and answer blocks in renderer order.
+ *
+ * @param blocks - DSH assistant content blocks.
+ * @returns reasoning and answer text separated by the renderer's paragraph break.
+ */
+export declare function projectCitableAssistantContent(blocks: readonly unknown[]): string;

package/lib/types/client/answer.d.ts

@@ -1,4 +1,4 @@
-/** Visible assistant text and its stream lifecycle. */
+/** Citable assistant reasoning and answer text with its stream lifecycle. */
 export type AssistantAnswer = {
     readonly status: 'running' | 'settled' | 'interrupted';
     readonly text: string;

package/lib/types/client/conversation-dom.d.ts

@@ -41,7 +41,7 @@ export declare function dshAssistantAnchorForTarget(target: EventTarget | null):
  */
 export declare function dshIntersectedAssistantAnchors(range: Range): DshAssistantAnchor[];
 /**
- * Detect DSH-rendered reasoning, generated controls, and collapsed code chrome.
+ * Detect generated controls, reasoning summaries, and collapsed code chrome.
  *
  * @param range - current rendered selection range.
  * @param flow - assistant flow containing the range.
@@ -56,12 +56,19 @@ export declare function dshRangeTouchesExcludedContent(range: Range, flow: HTMLE
  */
 export declare function findDshAssistantAnchor(anchorKey: string): HTMLElement | null;
 /**
- * Determine whether a node is a Read Frog translated projection rather than source text.
+ * Determine whether a node is generated UI rather than committed citable text.
  *
  * @param node - rendered node to classify.
- * @returns whether Read Frog marks the node as translated content.
+ * @returns whether the node must stay out of the citable projection.
  */
-export declare function isReadFrogTranslatedContent(node: Node): boolean;
+export declare function isNonCitableProjection(node: Node): boolean;
+/**
+ * Determine whether a node owns one DSH reasoning block.
+ *
+ * @param node - rendered node to classify.
+ * @returns whether the node is a reasoning root.
+ */
+export declare function isDshReasoningContent(node: Node): boolean;
 /**
  * Resolve a selection wholly inside one Read Frog translation to its source paragraph.
  *

package/lib/types/observer.d.ts

@@ -38,7 +38,7 @@ export declare function fingerprintCitationDraft(draft: Omit<CitationDraft, 'sel
 /** Resolve a browser selection claim against the authoritative committed assistant message. */
 export declare function resolveObserverCitation(source: ObserverSourceSnapshot, rawClaim: CitationSelectionClaim): ValidatedObserverCitation;
 /**
- * Validate one Citation against a committed assistant message in the observed source snapshot.
+ * Validate one Citation against committed reasoning or answer text in the observed source snapshot.
  * A matching `assistant/message` is sufficient; its step and turn may remain open.
  */
 export declare function validateObserverCitation(source: ObserverSourceSnapshot, rawDraft: CitationDraft): ValidatedObserverCitation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirkchinese/dsh-citeciter",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Verifiable, source-bound, read-only investigations for DeepSeek Harness responses",
   "keywords": [
     "deepseek-harness",
@@ -80,6 +80,20 @@
     "cordis.patch.yml",
     "README.zh.md"
   ],
+  "scripts": {
+    "build": "npm run build:lib && npm run build:bundle",
+    "prebuild:lib": "node scripts/clean-types.mjs",
+    "build:lib": "tsc -p tsconfig.json",
+    "prebuild:bundle": "node scripts/clean-bundle.mjs",
+    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
+    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
+    "prepack": "npm run build",
+    "dev": "npm run build && node dev/watch.mjs",
+    "smoke:seed": "node dev/seed-smoke-session.mjs",
+    "smoke:hmr": "node dev/hmr-smoke.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build:lib && node --test tests/*.test.mjs"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.1-rc.1 <0.1.1-rc.3",
@@ -159,18 +173,5 @@
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "zod": "^4.4.3"
-  },
-  "scripts": {
-    "build": "npm run build:lib && npm run build:bundle",
-    "prebuild:lib": "node scripts/clean-types.mjs",
-    "build:lib": "tsc -p tsconfig.json",
-    "prebuild:bundle": "node scripts/clean-bundle.mjs",
-    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
-    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
-    "dev": "npm run build && node dev/watch.mjs",
-    "smoke:seed": "node dev/seed-smoke-session.mjs",
-    "smoke:hmr": "node dev/hmr-smoke.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build:lib && node --test tests/*.test.mjs"
   }
-}
+}