dsh-quote-followup 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tr1v3r
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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

@@ -0,0 +1,105 @@
+# dsh-quote-followup
+
+English | [中文](README.zh.md)
+
+Quote **selected conversation content** into a **targeted follow-up turn** —
+one dsh plugin package, two faces:
+
+- **dsh-TUI face**: `Ctrl+Alt+Q` opens a message picker (recent user/assistant
+  messages, newest first); each pick appends a quote block into the prompt
+  input — repeatable, editable before sending.
+- **Web face (dsh web)**: **select any text span** in the transcript, click the
+  floating "❐ 引用" button, and the quote block lands at the composer's caret.
+
+The quote is a plain markdown blockquote (`> [引用 · assistant#5]`) —
+**visible, editable, no hidden injection**: the model sees exactly what you
+see in the input box.
+
+## How it works (public seams only, zero core patches)
+
+| Stage | TUI face | Web face |
+| --- | --- | --- |
+| Message source | `session/event` firehose (the ecosystem template's sanctioned seam), buffered per session | live transcript DOM in the browser |
+| Entry interaction | `ctx.tuiShortcuts` (global combo) + `ctx.tuiDialogs` (picker) | native text selection + floating button |
+| Writing the input | the dsh.nvim injection socket contract (`~/.dsh-tui/inject/<sessionId>.sock`, `prompt.append`) | direct composer element writes (native setter + input event) |
+| Feedback | `ctx.tuiToast` | console warnings on failure only |
+
+Component admission / `tui/input` interception are deliberately **not** used:
+as of dsh-TUI 0.10.x the admission capability has no public production entry
+(the `plugin-host` shim does not export it; test-utils is marked test-only),
+and the intercept-class permission that rewrites submitted input is
+deny-by-default. The selection→input-box pattern needs neither, matches the
+Web face behavior, and stays fully transparent to the user.
+
+## Install
+
+```sh
+# TUI profile
+dsh plugin --profile dsh-tui add dsh-quote-followup
+# Web profile (the browser half loads via the dsh.client declaration;
+# restart dsh web)
+dsh plugin --profile web add dsh-quote-followup
+```
+
+Add `dsh-quote-followup` to `dsh.profile.bundles` and restart. No grants file
+(`extension-grants.json`), no TUI patches.
+
+## Usage
+
+### TUI
+
+1. Converse normally (messages enter the buffer).
+2. `Ctrl+Alt+Q` → picker lists recent messages (`#seq me/assistant · summary`,
+   arrows + Enter).
+3. The quote block lands in the input; press the combo again to append more.
+4. Type your question below the quotes and send.
+
+### Web (dsh web GUI)
+
+1. Select any span in the transcript (cross-line, any granularity).
+2. The "❐ 引用" button appears above the selection — click it.
+3. The quote block is appended to the composer; keep quoting or type your
+   question, then send.
+
+## Configuration (optional row config override)
+
+Patch rows replace the whole `config`, so restate every key when overriding:
+
+```yaml
+- id: quote-followup
+  name: dsh-quote-followup
+  config:
+    shortcut: ctrl+alt+q   # needs ctrl or alt; avoid reserved combos
+    pickerLimit: 30        # max messages listed
+    quoteMaxChars: 1600    # per-quote truncation bound (chars)
+```
+
+## Known edges
+
+- **Live messages only**: `session/event` does not replay history (resume
+  seeds do not emit), so messages from before a `/resume` or restart never
+  appear in the picker.
+- **Picker target session**: the TUI face targets the session of the latest
+  user message; pressing the combo immediately after `/resume` (before any new
+  message) may list the previous session's buffer.
+- **Role detection (Web)**: best-effort heuristics; unknown roles are labeled
+  "对话".
+- The Web face writes input-box text — what you see is what the model gets.
+  Thinking / tool calls are not quotable.
+
+## Development
+
+```sh
+git clone <repo> && cd dsh-quote-followup
+dsh plugin --profile dsh-tui add link:$(pwd)
+dsh plugin --profile web add link:$(pwd)
+```
+
+Pure ESM, zero runtime dependencies; `lib/index.js` (host half, Node) +
+`lib/client.js` (browser half, a `window.__ModuleLoader__` closure factory).
+A headless E2E harness mounts the real extensions row plus this plugin and
+drives session/event → shortcut → dialog → injection socket end to end.
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,93 @@
+# dsh-quote-followup
+
+[English](README.md) | 中文
+
+把**选中的对话内容**引用进**针对性的下一轮追问**——同一个 dsh 插件包，两张界面：
+
+- **dsh-TUI 面**：`Ctrl+Alt+Q` 打开消息选择器（最近的用户/助手消息，最新在前），
+  选中后引用块直接落入输入框，可多次追加、发送前可编辑。
+- **Web 面（dsh web）**：在对话记录里**划选任意文本片段**，出现浮动「❐ 引用」按钮，
+  点击后引用块插入输入框光标处。
+
+引用块是普通的 markdown blockquote（`> [引用 · assistant#5]`），**可见、可编辑、
+无隐藏注入**——模型看到的就是你在输入框里看到的内容。
+
+## 工作原理（全部走公开插件缝，零核心 patch）
+
+| 环节 | TUI 面 | Web 面 |
+| --- | --- | --- |
+| 消息来源 | `session/event` 事件流（生态模板认可的标准接缝），按会话缓冲 | 浏览器实时读取 transcript DOM |
+| 入口交互 | `ctx.tuiShortcuts`（全局快捷键）+ `ctx.tuiDialogs`（选择弹窗） | 原生文本选区 + 浮动按钮 |
+| 写入输入框 | dsh.nvim 约定的注入套接字（`~/.dsh-tui/inject/<sessionId>.sock`，`prompt.append`） | 直接操作 composer 输入元素（原生 setter + input 事件） |
+| 提示反馈 | `ctx.tuiToast` | 控制台警告（仅失败时） |
+
+刻意**不使用** Component admission / `tui/input` 拦截：当前（dsh-TUI 0.10.x）
+准入能力没有公开的生产入口（`plugin-host` shim 不导出、test-utils 标注 test-only），
+改写已提交输入的拦截类权限也默认拒绝。选区→输入框的模式不需要其中任何一个，
+而且与 Web 面行为一致、对用户完全透明。
+
+## 安装
+
+```sh
+# TUI profile
+dsh plugin --profile dsh-tui add dsh-quote-followup
+# Web profile（浏览器半区由 dsh.client 声明自动加载，需重启 dsh web）
+dsh plugin --profile web add dsh-quote-followup
+```
+
+bundle 清单（`dsh.profile.bundles`）加上 `dsh-quote-followup` 后重启即生效。
+无需授权文件（`extension-grants.json`）、无需任何 TUI patch。
+
+## 使用
+
+### TUI
+
+1. 正常对话（消息进入缓冲）。
+2. `Ctrl+Alt+Q` → 选择器列出最近消息（`#序号 我/助手 · 摘要`，方向键 + Enter）。
+3. 引用块落入输入框；可再次 `Ctrl+Alt+Q` 追加多条。
+4. 在引用块下方写下问题，正常发送。
+
+### Web（dsh web GUI）
+
+1. 在对话记录中划选任意片段（支持跨行，任意粒度）。
+2. 选区上方出现「❐ 引用」按钮，点击。
+3. 引用块追加到输入框末尾（多次引用多次追加），继续输入问题后发送。
+
+## 配置（可选，覆盖行 config）
+
+`cordis.patch.yml` 的行 config 整体替换语义，覆盖时需完整重述：
+
+```yaml
+- id: quote-followup
+  name: dsh-quote-followup
+  config:
+    shortcut: ctrl+alt+q   # 需带 ctrl 或 alt；避开保留组合
+    pickerLimit: 30        # 选择器列出的消息数上限
+    quoteMaxChars: 1600    # 单条引用的截断上限（字符）
+```
+
+## 已知边界
+
+- **只有 live 消息可引用**：`session/event` 不回放历史（resume 的种子事件不发出），
+  `/resume` 或重启后、第一条新消息之前的旧消息不出现在选择器里。
+- **选择器目标会话**：TUI 面以「最近一条用户消息所在的会话」为准；`/resume` 后
+  立即按 `Ctrl+Alt+Q`（还没有新消息时）可能列出上一会话的缓冲。
+- **角色识别（Web）**：best-effort（data-role/class 启发式），识别不了标注为「对话」。
+- Web 面的注入走输入框文本，所见即所得； Thinking / 工具调用不在可引用范围。
+
+## 开发
+
+```sh
+git clone <repo> && cd dsh-quote-followup
+dsh plugin --profile dsh-tui add link:$(pwd)
+dsh plugin --profile web add link:$(pwd)
+```
+
+- 纯 ESM、零运行时依赖；`lib/index.js`（host 半区，Node）+ `lib/client.js`
+  （浏览器半区，`window.__ModuleLoader__` 闭包工厂）。
+- 无头 E2E：挂载真实 extensions 行 + 本插件行，驱动 session/event →
+  快捷键 → 弹窗 → 注入套接字全链路（见仓库 docs/harness 说明）。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-quote-followup bundle patch: one row over whatever layers came before.
+# Zero config by design — the quoting flow needs no machine-local values.
+# A profile may still override the row (config: {shortcut, pickerLimit,
+# quoteMaxChars}) by restating the whole config block, per patch semantics.
+
+- insert:
+    - id: quote-followup
+      name: dsh-quote-followup

package/lib/client.js

@@ -0,0 +1,252 @@
+/**
+ * dsh-quote-followup — browser half (Web face).
+ *
+ * Select text anywhere inside the conversation transcript
+ * (`[data-slot="conversation.session"]`), click the floating ❐ 引用 button,
+ * and the selection lands in the composer as a markdown blockquote the user
+ * can edit before sending — a visible, targeted follow-up with zero hidden
+ * state and zero host-side privileges.
+ *
+ * Pure DOM (no React), so the module carries no platform dependencies:
+ * `inject: []`. Mounted by the web client runtime through the package's
+ * `dsh.client` declaration (`platform: "web"`).
+ *
+ * @module dsh-quote-followup/client
+ */
+window.__ModuleLoader__.load({
+	id: "dsh-quote-followup",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region constants
+		/** Official slot wrapper owning the chat transcript (composer excluded). */
+		const TRANSCRIPT_SELECTOR = '[data-slot="conversation.session"]';
+		/** Composer input candidates, most specific first (official slot → legacy hints). */
+		const COMPOSER_SELECTORS = [
+			'[data-slot="conversation.composer"] textarea',
+			'[data-slot="conversation.composer"] [contenteditable="true"]',
+			'textarea[data-phase]',
+			'[data-composer-card] textarea',
+			'[data-composer-card] [contenteditable="true"]',
+			'[data-input-scroll] textarea'
+		];
+		const BUTTON_ID = "dsh-quote-followup-btn";
+		/** Per-quote character cap, mirroring the TUI face. */
+		const QUOTE_MAX_CHARS = 1600;
+		//#endregion
+		//#region helpers
+		const elementOf = (node) => (node === null ? null : node.nodeType === 1 ? node : node.parentElement);
+		const transcriptOf = (node) => {
+			const element = elementOf(node);
+			return element === null ? null : element.closest(TRANSCRIPT_SELECTOR);
+		};
+		/** The live selection when BOTH ends sit inside the same transcript. */
+		const selectionInTranscript = (selection) => {
+			if (selection === null || selection.isCollapsed || selection.rangeCount === 0)
+				return null;
+			const anchor = transcriptOf(selection.anchorNode);
+			const focus = transcriptOf(selection.focusNode);
+			if (anchor === null || anchor !== focus)
+				return null;
+			return anchor;
+		};
+		/**
+		 * Best-effort role for the quoted fragment: walk up from the range start
+		 * looking for role markers (data attributes, then class-name hints).
+		 * Null → the generic "对话" label; this is display-only metadata.
+		 */
+		const detectRole = (range, transcript) => {
+			let element = elementOf(range.startContainer);
+			while (element !== null && element !== transcript) {
+				const role = element.getAttribute?.("data-role") ?? element.getAttribute?.("data-message-role");
+				if (typeof role === "string" && role !== "") {
+					if (/user|human/i.test(role)) return "user";
+					if (/assistant|model|ai\b/i.test(role)) return "assistant";
+				}
+				const cls = String(element.className ?? "");
+				if (/(^|[\s_-])user([\s_-]|$)/i.test(cls)) return "user";
+				if (/(^|[\s_-])assistant([\s_-]|$)/i.test(cls)) return "assistant";
+				element = element.parentElement;
+			}
+			return null;
+		};
+		/** Markdown blockquote frame for one quoted fragment. */
+		const quoteFrame = (text, role) => {
+			let body = String(text ?? "");
+			let truncated = false;
+			if (body.length > QUOTE_MAX_CHARS) {
+				body = body.slice(0, QUOTE_MAX_CHARS);
+				truncated = true;
+			}
+			const who = role === "user" ? "user" : role === "assistant" ? "assistant" : "对话";
+			const lines = body.split("\n").map((line) => `> ${line}`.trimEnd());
+			return `> [引用 · ${who}${truncated ? "，已截断" : ""}]\n${lines.join("\n")}\n\n`;
+		};
+		const findComposer = () => {
+			for (const selector of COMPOSER_SELECTORS) {
+				const element = document.querySelector(selector);
+				if (element !== null)
+					return element;
+			}
+			return null;
+		};
+		/**
+		 * Append the quote at the END of the composer text (classic quote-reply
+		 * reading order) and leave the caret on the blank line for the question.
+		 * React-controlled inputs need the native setter + input event.
+		 */
+		const appendToComposer = (element, insertText) => {
+			element.focus();
+			if (element.tagName === "TEXTAREA" || element.tagName === "INPUT") {
+				const value = element.value ?? "";
+				const lead = value !== "" && !value.endsWith("\n") ? "\n" : "";
+				const next = `${value}${lead}${insertText}`;
+				const descriptor = element.tagName === "TEXTAREA"
+					? Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value")
+					: Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value");
+				(descriptor?.set ?? ((v) => { element.value = v; })).call(element, next);
+				element.dispatchEvent(new Event("input", { bubbles: true }));
+				const caret = next.length;
+				element.setSelectionRange(caret, caret);
+				return;
+			}
+			const selection = document.getSelection();
+			const range = document.createRange();
+			range.selectNodeContents(element);
+			range.collapse(false);
+			selection?.removeAllRanges();
+			selection?.addRange(range);
+			range.insertNode(document.createTextNode(insertText));
+			range.collapse(false);
+			element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: insertText }));
+		};
+		//#endregion
+		//#region floating button
+		let pendingQuote = null;
+		const ensureButton = () => {
+			const existing = document.getElementById(BUTTON_ID);
+			if (existing !== null)
+				return existing;
+			const button = document.createElement("button");
+			button.id = BUTTON_ID;
+			button.type = "button";
+			button.textContent = "❐ 引用";
+			button.title = "引用选中内容到输入框（可多次引用，发送前可编辑）";
+			Object.assign(button.style, {
+				position: "fixed",
+				zIndex: "2147483600",
+				padding: "3px 10px",
+				fontSize: "12px",
+				lineHeight: "20px",
+				borderRadius: "6px",
+				border: "1px solid rgba(140,140,150,.45)",
+				background: "rgba(56,56,62,.94)",
+				color: "#f5f5f7",
+				cursor: "pointer",
+				boxShadow: "0 2px 10px rgba(0,0,0,.28)",
+				userSelect: "none",
+				display: "none"
+			});
+			button.addEventListener("mousedown", (event) => {
+				event.preventDefault();
+				event.stopPropagation();
+			});
+			button.addEventListener("click", (event) => {
+				event.preventDefault();
+				event.stopPropagation();
+				onQuoteClick();
+			});
+			document.body.appendChild(button);
+			return button;
+		};
+		const placeButton = (button, rect) => {
+			let x = rect.left + rect.width / 2 - 30;
+			let y = rect.top - 28;
+			if (y < 4)
+				y = rect.bottom + 6;
+			x = Math.max(4, Math.min(x, window.innerWidth - 70));
+			button.style.left = `${Math.round(x)}px`;
+			button.style.top = `${Math.round(y)}px`;
+			button.style.display = "block";
+		};
+		const hideButton = () => {
+			const button = document.getElementById(BUTTON_ID);
+			if (button !== null)
+				button.style.display = "none";
+		};
+		const onSelectionChange = () => {
+			const selection = document.getSelection();
+			const transcript = selectionInTranscript(selection);
+			if (transcript === null) {
+				pendingQuote = null;
+				hideButton();
+				return;
+			}
+			const text = selection.toString();
+			if (text === null || text.trim() === "") {
+				pendingQuote = null;
+				hideButton();
+				return;
+			}
+			const rect = selection.getRangeAt(0).getBoundingClientRect();
+			if (rect.width === 0 && rect.height === 0) {
+				hideButton();
+				return;
+			}
+			pendingQuote = { text: text.trim(), role: detectRole(selection.getRangeAt(0), transcript) };
+			placeButton(ensureButton(), rect);
+		};
+		const onQuoteClick = () => {
+			if (pendingQuote === null)
+				return;
+			const quote = pendingQuote;
+			pendingQuote = null;
+			hideButton();
+			const composer = findComposer();
+			if (composer === null) {
+				console.warn("[dsh-quote-followup] composer input not found — quote dropped");
+				return;
+			}
+			appendToComposer(composer, quoteFrame(quote.text, quote.role));
+			const selection = document.getSelection();
+			selection?.removeAllRanges();
+		};
+		//#endregion
+		//#region apply
+		const MOUNTED = Symbol.for("dsh-quote-followup.mounted");
+		function apply(ctx) {
+			if (globalThis[MOUNTED] === true)
+				return;
+			globalThis[MOUNTED] = true;
+			const onScroll = () => hideButton();
+			const onKeyDown = (event) => {
+				if (event.key === "Escape")
+					hideButton();
+			};
+			const onMouseDown = (event) => {
+				if (event.target instanceof Element && event.target.id !== BUTTON_ID)
+					hideButton();
+			};
+			document.addEventListener("selectionchange", onSelectionChange);
+			window.addEventListener("scroll", onScroll, true);
+			document.addEventListener("keydown", onKeyDown, true);
+			document.addEventListener("mousedown", onMouseDown, true);
+			const cleanup = () => {
+				globalThis[MOUNTED] = false;
+				document.removeEventListener("selectionchange", onSelectionChange);
+				window.removeEventListener("scroll", onScroll, true);
+				document.removeEventListener("keydown", onKeyDown, true);
+				document.removeEventListener("mousedown", onMouseDown, true);
+				hideButton();
+				document.getElementById(BUTTON_ID)?.remove();
+			};
+			if (ctx !== undefined && typeof ctx.effect === "function")
+				ctx.effect(() => cleanup, "dsh-quote-followup: selection quote ui");
+		}
+		//#endregion
+		exports.inject = [];
+		exports.apply = apply;
+		return module.exports;
+	}
+});

package/lib/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * dsh-quote-followup host half (TUI face) — type surface.
+ * @module dsh-quote-followup
+ */
+import type { Context } from '@deepseek-ai/cordis';
+
+/** One quoted message. */
+export interface QuoteEntry {
+    seq: number;
+    role: 'user' | 'assistant';
+    text: string;
+}
+
+/** Row config (all optional; see cordis.patch.yml). */
+export interface QuoteFollowupConfig {
+    /** Global combo for the picker (needs ctrl or alt). Default 'ctrl+alt+q'. */
+    shortcut?: string;
+    /** Picker rows shown, newest first. Default 30. */
+    pickerLimit?: number;
+    /** Per-quote character cap. Default 1600. */
+    quoteMaxChars?: number;
+}
+
+/** Clip a string to `max` cells with an ellipsis marker. */
+export declare function clip(text: string, max: number): string;
+
+/** Project one `session/event` record onto a bufferable message (or null). */
+export declare function extractMessage(session: { id: string } | null, event: {
+    type?: string;
+    seq?: number;
+    data?: unknown;
+}): (QuoteEntry & { sessionId: string }) | null;
+
+/** Compose the quote block appended into the prompt input. */
+export declare function frameQuotes(quotes: QuoteEntry[], quoteMaxChars?: number): string;
+
+export declare const name: string;
+export declare const inject: string[];
+
+export declare function apply(ctx: Context, config?: QuoteFollowupConfig): void;

package/lib/index.js

@@ -0,0 +1,322 @@
+/**
+ * dsh-quote-followup — host half (TUI face).
+ *
+ * Quote selected conversation content into a targeted follow-up turn,
+ * using only public, activation-gated seams (no Component admission, no
+ * grants file, no TUI patches):
+ *
+ * - `session/event` (the ecosystem template's sanctioned firehose) buffers
+ *   user/assistant messages per session id.
+ * - `ctx.tuiShortcuts.register` binds Ctrl+Alt+Q; `ctx.tuiDialogs.select`
+ *   lists recent messages (newest first, single pick, repeatable).
+ * - The per-session injection socket (`~/.dsh-tui/inject/<sessionId>.sock`,
+ *   the dsh.nvim contract) appends the quote block into the live prompt
+ *   input — visible and editable before sending, exactly like the Web face.
+ * - `ctx.tuiToast` reports outcomes.
+ *
+ * On profiles without the TUI seams (dsh web) this row is inert: the browser
+ * half in ./client.js implements the Web face there.
+ *
+ * Known edge: the picker targets the session that received the most recent
+ * user message; right after `/resume` (before the first new message) it may
+ * briefly show the previous session's buffer. Documented, harmless.
+ *
+ * @module dsh-quote-followup
+ */
+import { createConnection } from 'node:net';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/** Stable Cordis plugin name (row id lives in cordis.patch.yml). */
+export const name = 'quote-followup';
+/** Services are resolved lazily via ctx.get so a bare mount degrades softly. */
+export const inject = [];
+
+/** Default global combo (ctrl/alt mandatory; ctrl+q is the todo-fold action). */
+const DEFAULT_SHORTCUT = 'ctrl+alt+q';
+/** Messages kept per session (session/event has no replay; live only). */
+const BUFFER_PER_SESSION = 200;
+/** Picker rows shown (newest first). */
+const DEFAULT_PICKER_LIMIT = 30;
+/** Per-quote character cap before truncation marker. */
+const DEFAULT_QUOTE_MAX_CHARS = 1600;
+/** Dialog auto-cancel bound (guards a wedged flow on headless embedders). */
+const PICKER_TIMEOUT_MS = 180000;
+/** How long to wait for sibling TUI services before going inert (ms). */
+const SERVICE_WAIT_MS = 3000;
+/** Injection-channel discovery file (see dsh-tui's inject-channel module). */
+const INJECT_SERVERS_FILE = join(homedir(), '.dsh-tui', 'inject', 'servers.json');
+
+/** One quoted message. */
+/** @typedef {{seq: number, role: 'user'|'assistant', text: string}} QuoteEntry */
+
+/** Clip a string to `max` cells with an ellipsis marker. Exported for tests. */
+export function clip(text, max) {
+    const clean = String(text ?? '').replace(/\s+/g, ' ').trim();
+    return clean.length <= max ? clean : `${clean.slice(0, Math.max(0, max - 1))}…`;
+}
+
+/** Join the text blocks of an MCP content array. */
+function textOfContent(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter(block => block !== null && typeof block === 'object' && block.type === 'text')
+        .map(block => String(block.text ?? ''))
+        .join('\n')
+        .trim();
+}
+
+/**
+ * Project one `session/event` record onto a bufferable message.
+ * Returns null for anything that is not a user/assistant text message.
+ * Exported for tests.
+ */
+export function extractMessage(session, event) {
+    if (event === null || typeof event !== 'object')
+        return null;
+    const type = event.type;
+    if (type !== 'user/message' && type !== 'assistant/message')
+        return null;
+    const id = session !== null && typeof session === 'object' && typeof session.id === 'string' ? session.id : null;
+    if (id === null)
+        return null;
+    const data = event.data;
+    const record = data !== null && typeof data === 'object' ? data : {};
+    const message = type === 'assistant/message' && record.message !== null && typeof record.message === 'object'
+        ? record.message
+        : record;
+    const text = textOfContent(message.content);
+    if (text === '')
+        return null;
+    return {
+        sessionId: id,
+        seq: typeof event.seq === 'number' ? event.seq : -1,
+        role: type === 'user/message' ? 'user' : 'assistant',
+        text,
+    };
+}
+
+/** Quote lines as a markdown blockquote, capped at `quoteMaxChars`. */
+function quoteBlock(entry, index, total, quoteMaxChars) {
+    let body = entry.text;
+    let truncated = false;
+    if (body.length > quoteMaxChars) {
+        body = body.slice(0, quoteMaxChars);
+        truncated = true;
+    }
+    const header = `> [引用 ${index}/${total} · ${entry.role}#${entry.seq}${truncated ? '，已截断' : ''}]`;
+    const lines = body.split('\n').map(line => `> ${line}`.trimEnd());
+    return `${header}\n${lines.join('\n')}`;
+}
+
+/**
+ * Compose the quote block appended into the prompt input. Exported for tests.
+ */
+export function frameQuotes(quotes, quoteMaxChars = DEFAULT_QUOTE_MAX_CHARS) {
+    const blocks = quotes.map((entry, i) => quoteBlock(entry, i + 1, quotes.length, quoteMaxChars));
+    return `\n${blocks.join('\n\n')}\n\n`;
+}
+
+/** Read the injection-channel discovery file; [] when absent/unreadable. */
+function readInjectServers() {
+    try {
+        const parsed = JSON.parse(readFileSync(INJECT_SERVERS_FILE, 'utf8'));
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(entry => entry !== null && typeof entry === 'object'
+            && typeof entry.pid === 'number' && typeof entry.socketPath === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+
+/** One-shot line write to a local injection socket; resolves true on delivery. */
+function injectAppend(socketPath, text) {
+    return new Promise(resolve => {
+        let socket;
+        let settled = false;
+        const finish = (ok) => {
+            if (settled)
+                return;
+            settled = true;
+            socket?.destroy();
+            resolve(ok);
+        };
+        try {
+            socket = createConnection(socketPath, () => {
+                try {
+                    socket.write(`${JSON.stringify({ type: 'prompt.append', text })}\n`);
+                    socket.end();
+                    finish(true);
+                }
+                catch {
+                    finish(false);
+                }
+            });
+            socket.on('error', () => finish(false));
+            setTimeout(() => finish(false), 1500).unref?.();
+        }
+        catch {
+            finish(false);
+        }
+    });
+}
+
+/**
+ * Apply: wire the TUI face when (and only when) the TUI extension seams are
+ * mounted. Every registration is scoped with ctx.effect so a profile that
+ * drops this row leaves nothing behind.
+ */
+export function apply(ctx, config) {
+    const shortcut = typeof config?.shortcut === 'string' && config.shortcut.trim() !== ''
+        ? config.shortcut.trim()
+        : DEFAULT_SHORTCUT;
+    const pickerLimit = Number.isInteger(config?.pickerLimit) && config.pickerLimit > 0
+        ? config.pickerLimit
+        : DEFAULT_PICKER_LIMIT;
+    const quoteMaxChars = Number.isInteger(config?.quoteMaxChars) && config.quoteMaxChars > 0
+        ? config.quoteMaxChars
+        : DEFAULT_QUOTE_MAX_CHARS;
+
+    /** Per-session ring buffer of observed messages. */
+    const buffers = new Map();
+    /** Session the picker targets: the one with the latest user message. */
+    let currentSessionId = null;
+    let wired = false;
+    /** Disposers accumulated by wire(); drained by the keep-alive effect. */
+    const disposers = [];
+    const keep = (dispose) => {
+        if (typeof dispose === 'function' || typeof dispose === 'boolean')
+            disposers.push(dispose);
+    };
+
+    const bufferOf = (sessionId) => {
+        let list = buffers.get(sessionId);
+        if (list === undefined) {
+            list = [];
+            buffers.set(sessionId, list);
+        }
+        return list;
+    };
+    const toast = (text) => {
+        try {
+            ctx.get('tuiToast')?.show(text);
+        }
+        catch {
+            /* toast-less hosts: the dialog/keyboard flow still works */
+        }
+    };
+
+    const onSessionEvent = (session, event) => {
+        try {
+            const message = extractMessage(session, event);
+            if (message === null)
+                return;
+            const list = bufferOf(message.sessionId);
+            list.push({ seq: message.seq, role: message.role, text: message.text });
+            if (list.length > BUFFER_PER_SESSION)
+                list.splice(0, list.length - BUFFER_PER_SESSION);
+            if (message.role === 'user')
+                currentSessionId = message.sessionId;
+        }
+        catch (error) {
+            ctx.logger.warn(`dsh-quote-followup: session event dropped: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    const onSessionDisposed = (session) => {
+        const id = session !== null && typeof session === 'object' && typeof session.id === 'string' ? session.id : null;
+        if (id !== null)
+            buffers.delete(id);
+    };
+
+    /** Ctrl+Alt+Q → picker; each pick appends one quote block to the input. */
+    const openPicker = async () => {
+        const dialogs = ctx.get('tuiDialogs');
+        if (dialogs === undefined) {
+            toast('对话框服务不可用（需要 dsh-TUI 扩展行）');
+            return;
+        }
+        let list = [];
+        if (currentSessionId !== null)
+            list = buffers.get(currentSessionId) ?? [];
+        if (list.length === 0) {
+            toast('本会话还没有可引用的消息');
+            return;
+        }
+        const options = list.slice(-pickerLimit).reverse().map(message => ({
+            id: String(message.seq),
+            label: `#${message.seq} ${message.role === 'user' ? '我' : '助手'} · ${clip(message.text, 44)}`,
+            description: clip(message.text, 160),
+        }));
+        const title = '选择要引用的对话内容（可多次引用，Esc 取消）';
+        let picked;
+        try {
+            picked = await dialogs.select({ title, options, timeoutMs: PICKER_TIMEOUT_MS });
+        }
+        catch {
+            return;
+        }
+        if (picked === undefined)
+            return;
+        const entry = list.find(message => String(message.seq) === picked);
+        if (entry === undefined)
+            return;
+        const record = readInjectServers().find(server => server.pid === process.pid);
+        if (record === undefined) {
+            toast('注入通道不可用（~/.dsh-tui/inject/ 无本进程套接字）');
+            return;
+        }
+        const delivered = await injectAppend(record.socketPath, frameQuotes([entry], quoteMaxChars));
+        toast(delivered
+            ? `已引用 #${entry.seq} → 输入框（可继续 ${shortcut} 追加，编辑后发送）`
+            : '引用写入输入框失败');
+    };
+
+    const wire = async () => {
+        if (wired)
+            return;
+        wired = true;
+        // Sibling rows ahead of us mount these during the same boot pass; a
+        // short poll keeps an out-of-order embedder from silently disabling
+        // the feature, while a headless/web host exits fast and inert.
+        const deadline = Date.now() + SERVICE_WAIT_MS;
+        let shortcuts = ctx.get('tuiShortcuts');
+        while ((shortcuts === undefined || ctx.get('tuiDialogs') === undefined) && Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, 50));
+            shortcuts = ctx.get('tuiShortcuts');
+        }
+        if (shortcuts === undefined) {
+            ctx.logger.info('dsh-quote-followup: no dsh-TUI extension seams on this profile — row stays inert (web face lives in the browser half)');
+            return;
+        }
+        keep(ctx.on('session/event', onSessionEvent));
+        keep(ctx.on('session/disposed', onSessionDisposed));
+        keep(shortcuts.register(shortcut, {
+            description: '引用对话内容，针对性追问 (dsh-quote-followup)',
+            handler: () => {
+                void openPicker();
+            },
+        }, ctx));
+        ctx.logger.info(`dsh-quote-followup: TUI face armed — ${shortcut} opens the quote picker`);
+    };
+    // The keep-alive effect is registered SYNCHRONOUSLY so the row's fiber
+    // outlives apply(): wire() registers the shortcut after an await, and an
+    // activation-scoped registration against an already-settled fiber is
+    // released immediately (observed: register() succeeds, dispatch never
+    // matches). This effect's disposer drains everything wire() accumulated.
+    ctx.effect(() => () => {
+        for (const dispose of disposers.splice(0)) {
+            try {
+                if (typeof dispose === 'function')
+                    dispose();
+            }
+            catch {
+                /* idempotent disposers; a double release is fine */
+            }
+        }
+    });
+    void wire();
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "dsh-quote-followup",
+  "version": "0.1.0",
+  "description": "Quote selected conversation content into a targeted follow-up turn for DeepSeek Harness — a TUI face (message picker + next-input rewrite via the official plugin seams) and a Web face (text-selection quoting into the composer).",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh-tui",
+    "quote",
+    "follow-up"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tr1v3r/dsh-quote-followup.git"
+  },
+  "homepage": "https://github.com/tr1v3r/dsh-quote-followup#readme",
+  "bugs": "https://github.com/tr1v3r/dsh-quote-followup/issues",
+  "author": "tr1v3r <tr1v3r@outlook.com> (https://github.com/tr1v3r)",
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.1.1-rc.1"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  }
+}