dsh-quote-followup 0.2.0 → 0.2.2

package/README.md

@@ -2,116 +2,39 @@
 
 English | [中文](README.zh.md)
 
-Quote **selected conversation content** into a **targeted follow-up turn** —
-one dsh plugin package, two faces:
+A Web-only [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin for quoting selected conversation text into the composer and asking a focused follow-up.
 
-- **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.
+## Features
 
-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.
+- Select text inside the Web conversation transcript to reveal a floating **Quote** button.
+- Append the selection as a Markdown quote without replacing the existing draft.
+- Repeat the action to collect multiple excerpts before sending.
+- Dispatch DSH's live Lexical `PASTE_COMMAND` directly, keeping the editor model and rendered composer in sync across Chromium and Firefox.
 
-## 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.
+TUI is intentionally unsupported.
 
 ## 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)
+```bash
 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
-
-**Selection quoting (recommended — matches the Web face)**: in fullscreen,
-dsh-TUI's copy-on-select copies any mouse selection to the clipboard and
-clears the highlight. After selecting, press `Ctrl+Alt+Q` — the **first
-picker row is exactly the text you just selected** (`📋 划选/剪贴板 · …`);
-Enter quotes it.
-
-**Whole-message quoting**: `Ctrl+Alt+Q` → picker lists recent messages
-(`#seq me/assistant · summary`, arrows + Enter); mixes freely with the
-selection row and repeats.
-
-Type your question below the quote blocks and send.
-
-> Combo delivery note: the TUI enables the kitty keyboard protocol, so
-> `Ctrl+Alt+Q` arrives reliably as CSI-u on modern terminals (iTerm2 3.5+,
-> kitty, WezTerm, Ghostty, …). If your terminal does not deliver the combo,
-> remap `shortcut` in the row config to any ctrl/alt combo it does deliver.
-
-### 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)
-    clipboardReadCommand: ''    # optional custom clipboard reader (/bin/sh -c;
-                                # default probes pbpaste / wl-paste / xclip / xsel)
-```
+Add `dsh-quote-followup` to the Web profile's `dsh.profile.bundles`, then restart `dsh web` so the server rebuilds its boot-time client bundle. Reload or reopen browser tabs that stayed open across the restart; their already-loaded JavaScript cannot update itself from a new server process.
 
-## Known edges
+## Use
 
-- **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.
+1. Select text in a conversation message.
+2. Click **❐ Quote**.
+3. Select and quote more excerpts if needed.
+4. Type the follow-up below the inserted quotes and send.
 
 ## Development
 
-```sh
-git clone <repo> && cd dsh-quote-followup
-dsh plugin --profile dsh-tui add link:$(pwd)
-dsh plugin --profile web add link:$(pwd)
+```bash
+npm test
 ```
 
-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.
+The regression harness covers repeated quotes, Firefox rejecting constructor-injected `clipboardData`, Lexical reconciliation of raw DOM fallbacks, and takeover from a stale client button/singleton after a hot swap.
 
 ## License
 

package/README.zh.md

@@ -2,102 +2,40 @@
 
 [English](README.md) | 中文
 
-把**选中的对话内容**引用进**针对性的下一轮追问**——同一个 dsh 插件包，两张界面：
+一个仅支持 Web 的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：选中对话文本，将其追加到输入框，再进行针对性追问。
 
-- **dsh-TUI 面**：`Ctrl+Alt+Q` 打开消息选择器（最近的用户/助手消息，最新在前），
-  选中后引用块直接落入输入框，可多次追加、发送前可编辑。
-- **Web 面（dsh web）**：在对话记录里**划选任意文本片段**，出现浮动「❐ 引用」按钮，
-  点击后引用块插入输入框光标处。
+## 功能
 
-引用块是普通的 markdown blockquote（`> [引用 · assistant#5]`），**可见、可编辑、
-无隐藏注入**——模型看到的就是你在输入框里看到的内容。
+- 在 Web 对话区选中文本后显示浮动的 **❐ 引用** 按钮。
+- 以 Markdown 引用块追加到现有草稿，不覆盖已输入内容。
+- 可连续引用多段内容，再统一编辑并发送。
+- 直接派发 DSH 当前 Lexical editor 的 `PASTE_COMMAND`，在 Chromium 与 Firefox 中同步更新编辑器模型和 DOM。
 
-## 工作原理（全部走公开插件缝，零核心 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 面行为一致、对用户完全透明。
+本插件不再适配 TUI。
 
 ## 安装
 
-```sh
-# TUI profile
-dsh plugin --profile dsh-tui add dsh-quote-followup
-# Web profile（浏览器半区由 dsh.client 声明自动加载，需重启 dsh web）
+```bash
 dsh plugin --profile web add dsh-quote-followup
 ```
 
-bundle 清单（`dsh.profile.bundles`）加上 `dsh-quote-followup` 后重启即生效。
-无需授权文件（`extension-grants.json`）、无需任何 TUI patch。
+将 `dsh-quote-followup` 加入 Web profile 的 `dsh.profile.bundles`，然后重启 `dsh web`，让服务端重新生成启动时缓存的 client bundle。重启后还需刷新或重新打开此前一直未关闭的浏览器页；旧页面已经加载的 JavaScript 不会从新服务进程自动更新。
 
 ## 使用
 
-### TUI
-
-**划选引用（推荐，与 Web 面体验一致）**：dsh-TUI 全屏模式下鼠标划选文本会
-自动复制到剪贴板并清除高亮（copy-on-select）。划选后按 `Ctrl+Alt+Q`，
-选择器**第一行就是刚划选的内容**（`📋 划选/剪贴板 · …`），回车即引用。
-
-**整条消息引用**：`Ctrl+Alt+Q` → 选择器列出最近消息（`#序号 我/助手 · 摘要`，
-方向键 + Enter），可与划选行混用、多次追加。
-
-引用块落入输入框后在下方写下问题，正常发送。
-
-> 快捷键送达说明：TUI 启用了 kitty 键盘协议，现代终端（iTerm2 3.5+、kitty、
-> WezTerm、Ghostty 等）下 `Ctrl+Alt+Q` 以 CSI-u 编码可靠送达。若你的终端不发
-> 该组合，在行 config 里把 `shortcut` 换成任意可送达的 ctrl/alt 组合即可。
-
-### 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         # 单条引用的截断上限（字符）
-    clipboardReadCommand: ''    # 可选：自定义剪贴板读取命令（/bin/sh -c；
-                                # 默认 pbpaste / wl-paste / xclip / xsel 探测）
-```
-
-## 已知边界
-
-- **只有 live 消息可引用**：`session/event` 不回放历史（resume 的种子事件不发出），
-  `/resume` 或重启后、第一条新消息之前的旧消息不出现在选择器里。
-- **选择器目标会话**：TUI 面以「最近一条用户消息所在的会话」为准；`/resume` 后
-  立即按 `Ctrl+Alt+Q`（还没有新消息时）可能列出上一会话的缓冲。
-- **角色识别（Web）**：best-effort（data-role/class 启发式），识别不了标注为「对话」。
-- Web 面的注入走输入框文本，所见即所得； Thinking / 工具调用不在可引用范围。
+1. 在对话消息中划选任意片段。
+2. 点击 **❐ 引用**。
+3. 如需补充，可继续选中并引用其他片段。
+4. 在引用块下输入追问并发送。
 
-## 开发
+## 开发验证
 
-```sh
-git clone <repo> && cd dsh-quote-followup
-dsh plugin --profile dsh-tui add link:$(pwd)
-dsh plugin --profile web add link:$(pwd)
+```bash
+npm test
 ```
 
-- 纯 ESM、零运行时依赖；`lib/index.js`（host 半区，Node）+ `lib/client.js`
-  （浏览器半区，`window.__ModuleLoader__` 闭包工厂）。
-- 无头 E2E：挂载真实 extensions 行 + 本插件行，驱动 session/event →
-  快捷键 → 弹窗 → 注入套接字全链路（见仓库 docs/harness 说明）。
+回归测试覆盖连续引用、Firefox 丢弃构造参数中的 `clipboardData`、Lexical 回滚裸 DOM fallback，以及热替换后新版 client 接管旧按钮/单例状态。
 
-## License
+## 许可证
 
 MIT

package/cordis.patch.yml

@@ -1,7 +1,5 @@
-# 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.
+# dsh-quote-followup Web bundle patch.
+# The host row is inert; it mounts the package's browser client entry.
 
 - insert:
     - id: quote-followup

package/lib/client.js

@@ -32,7 +32,9 @@ window.__ModuleLoader__.load({
 			'[data-input-scroll] textarea'
 		];
 		const BUTTON_ID = "dsh-quote-followup-btn";
-		/** Per-quote character cap, mirroring the TUI face. */
+		const BUTTON_VERSION_ATTR = "data-dsh-quote-followup-version";
+		const CLIENT_VERSION = "0.2.2";
+		/** Per-quote character cap for a bounded composer insertion. */
 		const QUOTE_MAX_CHARS = 1600;
 		//#endregion
 		//#region helpers
@@ -91,7 +93,41 @@ window.__ModuleLoader__.load({
 			}
 			return null;
 		};
-		/** Dispatch a real paste path so stateful editors (Lexical) own the update. */
+		/**
+		 * Use the live Lexical command table when DSH exposes its editor on the root.
+		 * This bypasses browser security differences around synthetic clipboardData
+		 * while still entering through DSH's own PASTE_COMMAND → keyboard.paste path.
+		 */
+		const pasteViaLexical = (element, text) => {
+			const editor = element.__lexicalEditor;
+			if (editor === null || typeof editor !== "object" || typeof editor.dispatchCommand !== "function")
+				return false;
+			const commands = editor._commands;
+			if (commands === null || typeof commands !== "object" || typeof commands.keys !== "function")
+				return false;
+			const command = [...commands.keys()].find((candidate) => candidate?.type === "PASTE_COMMAND");
+			if (command === undefined)
+				return false;
+			const clipboardData = {
+				files: [],
+				items: [],
+				types: ["text/plain"],
+				getData: (type) => type === "text/plain" ? text : ""
+			};
+			const event = {
+				clipboardData,
+				defaultPrevented: false,
+				preventDefault() { this.defaultPrevented = true; },
+				stopPropagation() {}
+			};
+			try {
+				return editor.dispatchCommand(command, event) === true;
+			} catch (error) {
+				console.warn("[dsh-quote-followup] Lexical paste command failed; using DOM event fallback", error);
+				return false;
+			}
+		};
+		/** Dispatch a DOM paste fallback for non-DSH stateful editors. */
 		const pasteIntoEditor = (element, text) => {
 			let clipboardData = null;
 			try {
@@ -139,10 +175,18 @@ window.__ModuleLoader__.load({
 			}
 			const selection = document.getSelection();
 			const range = document.createRange();
-			range.selectNodeContents(element);
+			// A Lexical root with existing block children does not admit a caret at
+			// `root.childNodes.length`: its paste listener ignores that DOM point,
+			// then mutation reconciliation deletes the raw-text fallback. Put the
+			// caret INSIDE the last block instead. The empty-editor case still uses
+			// the root because it has no block yet.
+			const caretContainer = element.lastElementChild ?? element;
+			range.selectNodeContents(caretContainer);
 			range.collapse(false);
 			selection?.removeAllRanges();
 			selection?.addRange(range);
+			if (pasteViaLexical(element, insertText))
+				return;
 			if (pasteIntoEditor(element, insertText))
 				return;
 			if (typeof document.execCommand === "function" && document.execCommand("insertText", false, insertText))
@@ -156,10 +200,12 @@ window.__ModuleLoader__.load({
 		let pendingQuote = null;
 		const ensureButton = () => {
 			const existing = document.getElementById(BUTTON_ID);
-			if (existing !== null)
+			if (existing?.getAttribute(BUTTON_VERSION_ATTR) === CLIENT_VERSION)
 				return existing;
+			existing?.remove();
 			const button = document.createElement("button");
 			button.id = BUTTON_ID;
+			button.setAttribute(BUTTON_VERSION_ATTR, CLIENT_VERSION);
 			button.type = "button";
 			button.textContent = "❐ 引用";
 			button.title = "引用选中内容到输入框（可多次引用，发送前可编辑）";
@@ -245,11 +291,13 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region apply
-		const MOUNTED = Symbol.for("dsh-quote-followup.mounted");
+		const STATE = Symbol.for("dsh-quote-followup.state");
 		function apply(ctx) {
-			if (globalThis[MOUNTED] === true)
+			const previous = globalThis[STATE];
+			if (previous?.version === CLIENT_VERSION)
 				return;
-			globalThis[MOUNTED] = true;
+			if (typeof previous?.dispose === "function")
+				previous.dispose();
 			const onScroll = () => hideButton();
 			const onKeyDown = (event) => {
 				if (event.key === "Escape")
@@ -259,19 +307,31 @@ window.__ModuleLoader__.load({
 				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);
+			let disposed = false;
+			let state;
 			const cleanup = () => {
-				globalThis[MOUNTED] = false;
+				if (disposed)
+					return;
+				disposed = true;
 				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();
+				const button = document.getElementById(BUTTON_ID);
+				if (button?.getAttribute(BUTTON_VERSION_ATTR) === CLIENT_VERSION)
+					button.remove();
+				if (globalThis[STATE] === state)
+					delete globalThis[STATE];
 			};
+			state = { version: CLIENT_VERSION, dispose: cleanup };
+			globalThis[STATE] = state;
+			document.addEventListener("selectionchange", onSelectionChange);
+			window.addEventListener("scroll", onScroll, true);
+			document.addEventListener("keydown", onKeyDown, true);
+			document.addEventListener("mousedown", onMouseDown, true);
+			// Claim the shared id immediately so an older listener in a long-lived tab
+			// cannot keep its obsolete click handler after a client hot-swap.
+			ensureButton();
 			if (ctx !== undefined && typeof ctx.effect === "function")
 				ctx.effect(() => cleanup, "dsh-quote-followup: selection quote ui");
 		}

package/lib/index.d.ts

@@ -1,46 +1,4 @@
-/**
- * dsh-quote-followup host half (TUI face) — type surface.
- * @module dsh-quote-followup
- */
-import type { Context } from '@deepseek-ai/cordis';
-
-/** One quoted message (`seq: null` marks a mouse-selection/clipboard quote). */
-export interface QuoteEntry {
-    seq: number | null;
-    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;
-    /** Custom clipboard reader (`/bin/sh -c`; defaults to pbpaste / wl-paste /
-     *  xclip / xsel probing). */
-    clipboardReadCommand?: string;
-}
-
-/** 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;
-
-/** Read the system clipboard ('' on failure / unsupported platform). */
-export declare function readClipboard(overrideCommand?: string): Promise<string>;
-
-export declare const name: string;
-export declare const inject: string[];
-
-export declare function apply(ctx: Context, config?: QuoteFollowupConfig): void;
+/** Web-only host stub; the feature is implemented by `lib/client.js`. */
+export declare const name = "quote-followup";
+export declare const inject: readonly [];
+export declare function apply(): void;

package/lib/index.js

@@ -1,381 +1,11 @@
 /**
- * dsh-quote-followup — host half (TUI face).
+ * dsh-quote-followup host 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
+ * The feature is Web-only. The host entry intentionally stays inert; its sole
+ * purpose is to let DSH mount the package's `dsh.client` browser entry.
  */
-import { createConnection } from 'node:net';
-import { execFile } from 'node:child_process';
-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;
-/** Picker row id for the clipboard quote (dsh-TUI copies mouse selections to
- *  the clipboard automatically — copy-on-select — so the freshest mouse
- *  selection is always quotable through this row). */
-const CLIPBOARD_ROW_ID = '__clipboard__';
-/** 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 tail = entry.seq === null || entry.seq === undefined ? '' : `#${entry.seq}`;
-    const header = `> [引用 ${index}/${total} · ${entry.role}${tail}${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);
-        }
-    });
-}
-
-/**
- * Read the system clipboard. dsh-TUI's copy-on-select already places every
- * mouse selection there, so this is the bridge between terminal text
- * selection and the quote picker. `overrideCommand` (row config
- * `clipboardReadCommand`) runs via /bin/sh — mainly a deterministic seam
- * for tests and exotic setups. Resolves '' on any failure.
- */
-export function readClipboard(overrideCommand) {
-    const run = (file, args) => new Promise(resolve => {
-        try {
-            execFile(file, args, { timeout: 1200, maxBuffer: 4 * 1024 * 1024, encoding: 'utf8' }, (error, stdout) => {
-                resolve(error === null ? String(stdout ?? '') : '');
-            });
-        }
-        catch {
-            resolve('');
-        }
-    });
-    return (async () => {
-        if (typeof overrideCommand === 'string' && overrideCommand.trim() !== '')
-            return run('/bin/sh', ['-c', overrideCommand]);
-        if (process.platform === 'darwin')
-            return run('pbpaste', []);
-        if (process.platform === 'linux') {
-            for (const probe of [['wl-paste', []], ['xclip', ['-selection', 'clipboard', '-o']], ['xsel', ['--clipboard', '--output']]]) {
-                const text = await run(probe[0], probe[1]);
-                if (text !== '')
-                    return text;
-            }
-        }
-        return '';
-    })();
-}
-
-/**
- * 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;
-    const clipboardCommand = typeof config?.clipboardReadCommand === 'string'
-        ? config.clipboardReadCommand
-        : undefined;
-
-    /** 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) ?? [];
-        // dsh-TUI copies every mouse selection to the clipboard (copy-on-select,
-        // then clears the highlight), so the clipboard holds exactly what the
-        // user just selected. Offer it as the FIRST picker row.
-        const clipboardText = await readClipboard(clipboardCommand);
-        const options = [];
-        if (clipboardText.trim() !== '') {
-            options.push({
-                id: CLIPBOARD_ROW_ID,
-                label: `📋 划选/剪贴板 · ${clip(clipboardText, 40)}`,
-                description: clip(clipboardText, 160),
-            });
-        }
-        options.push(...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),
-        })));
-        if (options.length === 0) {
-            toast('没有可引用内容：划选一段文本（自动复制）或先对话后重试');
-            return;
-        }
-        const title = '选择要引用的对话内容（可多次引用，Esc 取消）';
-        let picked;
-        try {
-            picked = await dialogs.select({ title, options, timeoutMs: PICKER_TIMEOUT_MS });
-        }
-        catch {
-            return;
-        }
-        if (picked === undefined)
-            return;
-        const entry = picked === CLIPBOARD_ROW_ID
-            ? { seq: null, role: '划选', text: clipboardText }
-            : 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 === null
-                ? '已引用划选内容 → 输入框（可继续追加，编辑后发送）'
-                : `已引用 #${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();
-}
+export function apply() {}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "dsh-quote-followup",
-  "version": "0.2.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).",
+  "version": "0.2.2",
+  "description": "Quote selected Web conversation text into the DeepSeek Harness composer for targeted follow-up turns.",
   "keywords": [
     "dsh",
     "dsh-plugin",
     "deepseek-harness",
-    "dsh-tui",
+    "web",
     "quote",
     "follow-up"
   ],
+  "scripts": {
+    "test": "node --check lib/index.js && node --check lib/client.js && node test/web-repeat-harness.mjs"
+  },
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",