dsh-prompt-history 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-prompt-history contributors
+
+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,47 @@
+# dsh-prompt-history
+
+DSH Web 输入框的「类 Linux shell」提示词历史插件：在输入框里按 **↑ / ↓** 上下翻看之前发送过的消息。
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-prompt-history
+```
+
+然后刷新页面即可使用。
+
+## 用法
+
+- **↑**：召回上一条发送过的消息（最新在前），替换当前输入；继续按 ↑ 往前翻
+- **↓**：往后翻；翻到底时恢复你翻历史之前正在输入的那一行（readline 的 pending-line 行为）
+- **编辑即退出**：浏览历史时一旦动手编辑，自动回到当前行，不再继续翻
+- **不干扰其它操作**：`/` 与 `@` 建议菜单打开时，方向键仍归菜单导航；中文输入法（IME）组合、`Shift+↑` 选区、`Ctrl+↑` 跳词等修饰键组合均不拦截；发送中/已删除会话不响应
+
+## 特性
+
+- **历史来自会话自身的消息记录**：直接读取会话快照中的用户消息节点（`user` / `steering`），随消息落地实时追加——与聊天记录严格一致，随会话持久化，刷新页面后依然可用，不需要任何配置或额外存储
+- **连续重复自动合并**，浏览状态跟随会话切换自动重置
+- 无 UI、无设置项，bundle 仅约 7 KB；依赖全部走官方 `@deepseek-ai/*` peer 依赖
+
+## 已知限制
+
+- 切换会话时，只能召回当前已加载事件窗口内的旧消息（页面上新发送的都在）；不做宿主侧历史拉取
+- 纯文本召回：带图片/命令 chip 的消息不参与；召回内容为纯文本
+
+## 开发
+
+```sh
+pnpm install
+pnpm run typecheck   # tsc --noEmit
+pnpm run build       # tsc（lib/types）+ tsdown（lib/index.js / lib/invariant.js / lib/client.js）
+```
+
+浏览器半区（`src/client/`）注册在 `conversation.input.right` 槽位，构建产物为 DSH `__ModuleLoader__` 闭包格式，外部依赖仅 `react`（其余由浏览器模块表提供）。
+
+## 原理
+
+插件是一个不可见的 composer 槽位条目：挂一个 document 捕获期 keydown 监听，仅在目标为 composer 输入框、无修饰键、非输入法组合、菜单未打开、会话非忙碌时接管 ↑/↓，通过 `inputActions.setDraft` 写入历史文本。历史列表由会话快照的 `user`/`steering` 节点按 seq 去重追加，浏览位置（index + 待恢复的当前行）保存在组件 ref 中。
+
+## License
+
+[MIT](LICENSE)

package/README_EN.md

@@ -0,0 +1,47 @@
+# dsh-prompt-history
+
+Bash-like prompt history for the DSH web composer: **Up / Down** arrows recall previously submitted messages in the input box.
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-prompt-history
+```
+
+Then refresh the page.
+
+## Usage
+
+- **Up**: recall the previous submitted prompt (newest first), replacing the current draft; keep pressing Up to walk further back.
+- **Down**: walk forward; at the bottom edge, restore the line you were typing before browsing began (readline pending-line behavior).
+- **Edit exits browsing**: editing the draft while browsing drops back to the live line.
+- **Does not interfere**: while the `/` or `@` suggestion menu is open, arrow keys stay with menu navigation; IME composition, `Shift+Up` selection, `Ctrl+Up` word-jumps and other modifier chords are never intercepted; busy/removed sessions do not respond.
+
+## Features
+
+- **History comes from the session's own message log**: reads the conversation snapshot's user nodes (`user` / `steering`) and appends as they land — strictly consistent with the transcript, persisted with the session, survives page reloads, and needs no configuration or extra storage.
+- **Consecutive duplicates collapse**; browse state resets on session switch.
+- No UI, no settings; the client bundle is ~7 KB and depends only on the official `@deepseek-ai/*` peer packages.
+
+## Known limitations
+
+- On a session switch, only the currently loaded event window's messages are recallable (everything submitted while the page is open is included); there is no host-side history fetch.
+- Plain text only: image-only or chip-bearing messages are not recalled; recalled drafts are plain text.
+
+## Development
+
+```sh
+pnpm install
+pnpm run typecheck   # tsc --noEmit
+pnpm run build       # tsc (lib/types) + tsdown (lib/index.js / lib/invariant.js / lib/client.js)
+```
+
+The browser half (`src/client/`) registers into the `conversation.input.right` slot; the build emits the DSH `__ModuleLoader__` closure format with `react` as the only external (everything else comes from the browser module table).
+
+## How it works
+
+The plugin is an invisible composer slot entry that mounts a capture-phase `keydown` listener on the document. It takes over Up/Down only when the target is the composer textarea, no modifiers are held, no IME composition is active, no suggestion menu is open, and the session is not busy — then writes the recalled text through `inputActions.setDraft`. The history list is fed from the snapshot's `user`/`steering` nodes (deduped by seq); the browse position (index plus the pending line to restore) lives in component refs.
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-prompt-history bundle patch — bash-like prompt history for the composer.
+#
+# Mounts the browser half by inserting one row into the dsh.client roster; the
+# loader imports the package root (empty node half) and the modules node half
+# serves exports["./client"] to the browser.
+- insert:
+    - id: dsh-prompt-history
+      name: dsh-prompt-history

package/lib/client.js

@@ -0,0 +1,180 @@
+window.__ModuleLoader__.load({
+	id: "dsh-prompt-history",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		//#region src/client/InputHistory.tsx
+		/**
+		* InputHistory: bash-like prompt history for the composer (dsh-prompt-history).
+		* Renders nothing — it mounts one capture-phase keydown listener on the
+		* document while the session's composer card is live. Up recalls previously
+		* submitted prompts (newest first), Down walks forward and restores the line
+		* that was being typed before browsing began; editing the draft while browsing
+		* drops back to the live line. The '/' and '@' suggestion menus keep their own
+		* arrow-key navigation: while the menu (role=listbox inside the composer card)
+		* is open, this listener declines and the input trigger pipeline owns the keys.
+		*
+		* History is fed from the conversation snapshot's user nodes (kind 'user' and
+		* 'steering'), appended as they land — so everything submitted while the page
+		* is open is recallable even after the session event window slides. Consecutive
+		* duplicates collapse; on a session switch the window's in-window user messages
+		* seed the list. Unlike a parallel storage ring, the history IS the session's
+		* own message log: it stays consistent with the transcript, survives reloads
+		* through the session itself, and needs no configuration or extra storage.
+		*
+		* Interception guards: composer textarea target only, no modifier keys
+		* (Shift+Up still extends selection), no IME composition, machine not
+		* adjudicating/submitting, session not removed, and a non-empty history.
+		*/
+		/** Not-browsing state; also the reset target after edits and session switches. */
+		const RESET_BROWSE = {
+			index: -1,
+			saved: "",
+			lastSet: null
+		};
+		/** The composer card's own textarea is the only interception target. */
+		const COMPOSER_CARD = "[data-composer-card]";
+		/** The suggestion menu (slash/at) renders a listbox inside the card while open. */
+		const OPEN_MENU = "[role=\"listbox\"]";
+		/** Extract the trimmed plain text of one user-submitted message node; null when empty. */
+		function promptText(node) {
+			if (node.kind !== "user" && node.kind !== "steering") return null;
+			let text = "";
+			for (const block of node.content) if (block.type === "text") text += block.text;
+			const trimmed = text.trim();
+			return trimmed === "" ? null : trimmed;
+		}
+		/**
+		* The composer history entry: no visible UI, one keydown listener.
+		* @param props - framework standard kit (useInput/useSession/inputActions/sessionId).
+		* @returns null (the entry is invisible chrome).
+		*/
+		function InputHistory({ useInput, useSession, inputActions, sessionId }) {
+			const draft = useInput((s) => s.draft);
+			const phase = useInput((s) => s.phase);
+			const nodes = useSession((s) => s.nodes);
+			const removed = useSession((s) => s.removed) ?? false;
+			/** Submitted prompt texts, oldest → newest (per session; append-only). */
+			const historyRef = (0, react.useRef)([]);
+			/** User-node seqs already folded into historyRef (append-once dedup). */
+			const seenRef = (0, react.useRef)(/* @__PURE__ */ new Set());
+			const browseRef = (0, react.useRef)(RESET_BROWSE);
+			const liveRef = (0, react.useRef)({
+				draft,
+				phase,
+				removed,
+				inputActions
+			});
+			liveRef.current = {
+				draft,
+				phase,
+				removed,
+				inputActions
+			};
+			(0, react.useEffect)(() => {
+				historyRef.current = [];
+				seenRef.current = /* @__PURE__ */ new Set();
+				browseRef.current = RESET_BROWSE;
+			}, [sessionId]);
+			(0, react.useEffect)(() => {
+				const seen = seenRef.current;
+				const history = historyRef.current;
+				for (const node of nodes) {
+					if (node.kind !== "user" && node.kind !== "steering") continue;
+					if (seen.has(node.seq)) continue;
+					seen.add(node.seq);
+					const text = promptText(node);
+					if (text === null) continue;
+					if (history[history.length - 1] !== text) history.push(text);
+				}
+			}, [nodes]);
+			(0, react.useEffect)(() => {
+				const browse = browseRef.current;
+				if (browse.index !== -1 && draft !== browse.lastSet) browseRef.current = RESET_BROWSE;
+			}, [draft]);
+			(0, react.useEffect)(() => {
+				const onKeyDown = (e) => {
+					if (e.key !== "ArrowUp" && e.key !== "ArrowDown") return;
+					const target = e.target;
+					if (!(target instanceof HTMLTextAreaElement)) return;
+					const card = target.closest(COMPOSER_CARD);
+					if (card === null) return;
+					if (e.isComposing || e.keyCode === 229) return;
+					if (e.shiftKey || e.ctrlKey || e.metaKey || e.altKey) return;
+					if (card.querySelector(OPEN_MENU) !== null) return;
+					const live = liveRef.current;
+					if (live.phase === "adjudicating" || live.phase === "submitting" || live.removed) return;
+					const history = historyRef.current;
+					if (history.length === 0) return;
+					const recall = (index) => history[index] ?? "";
+					const browse = browseRef.current;
+					if (e.key === "ArrowDown" && browse.index === -1) return;
+					e.preventDefault();
+					e.stopPropagation();
+					if (e.key === "ArrowUp") {
+						if (browse.index === -1) {
+							const index = history.length - 1;
+							browseRef.current = {
+								index,
+								saved: live.draft,
+								lastSet: recall(index)
+							};
+							live.inputActions.setDraft(recall(index));
+						} else {
+							const index = Math.max(0, browse.index - 1);
+							browseRef.current = {
+								...browse,
+								index,
+								lastSet: recall(index)
+							};
+							live.inputActions.setDraft(recall(index));
+						}
+						return;
+					}
+					if (browse.index + 1 >= history.length) {
+						browseRef.current = RESET_BROWSE;
+						live.inputActions.setDraft(browse.saved);
+					} else {
+						const index = browse.index + 1;
+						browseRef.current = {
+							...browse,
+							index,
+							lastSet: recall(index)
+						};
+						live.inputActions.setDraft(recall(index));
+					}
+				};
+				document.addEventListener("keydown", onKeyDown, true);
+				return () => {
+					document.removeEventListener("keydown", onKeyDown, true);
+				};
+			}, []);
+			return null;
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required services: the slot registry the entry registers into. */
+		const inject = ["slots"];
+		/**
+		* Client plugin body: register the composer input-history entry. The
+		* declaration lives in ui-conversation, whose apply order is unconstrained —
+		* slots.inject waits on the actual declaration and retires the contribution
+		* with this plugin's fiber.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.slots.inject("conversation.input.right", () => ctx.slots.register({
+				name: "conversation.input.right",
+				id: "dsh-prompt-history"
+			}, InputHistory));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* dsh-prompt-history, node half. Pure UI plugin: the empty apply exists so
+* the plugin appears in the host cordis.yml / Loader; the browser half ships
+* via exports["./client"], discovered through the package.json dsh.client
+* declaration.
+*/
+/** Host plugin body — no host-side behavior for this UI-only plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `dsh-prompt-history`.
+* @module dsh-prompt-history/invariant
+*/
+const PACKAGE_NAME = "dsh-prompt-history";
+/** Cordis companion plugin name. */
+const name = "dsh-prompt-history-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the composer slot registration is a registry-owned
+* registration whose disposal is proven by the HMR-safety spec, and the
+* per-session keydown listener is React-effect-owned (unmount tears it down).
+* The plugin emits no cordis events and owns no cross-plugin mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,10 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Full props of the input-history entry: framework standard kit + owner share. */
+export type InputHistoryProps = PropsRuntime<'conversation.input.right'>;
+/**
+ * The composer history entry: no visible UI, one keydown listener.
+ * @param props - framework standard kit (useInput/useSession/inputActions/sessionId).
+ * @returns null (the entry is invisible chrome).
+ */
+export declare function InputHistory({ useInput, useSession, inputActions, sessionId }: InputHistoryProps): null;
+//# sourceMappingURL=InputHistory.d.ts.map

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

@@ -0,0 +1,17 @@
+/**
+ * Prompt-history plugin, browser half: one invisible entry in the composer's
+ * input.right tool row that mounts the capture-phase keyboard listener (see
+ * InputHistory.tsx for the full behavior contract).
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/** Required services: the slot registry the entry registers into. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the composer input-history entry. The
+ * declaration lives in ui-conversation, whose apply order is unconstrained —
+ * slots.inject waits on the actual declaration and retires the contribution
+ * with this plugin's fiber.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,13 @@
+import { InputHistory } from "./InputHistory.js";
+/** Required services: the slot registry the entry registers into. */
+export const inject = ['slots'];
+/**
+ * Client plugin body: register the composer input-history entry. The
+ * declaration lives in ui-conversation, whose apply order is unconstrained —
+ * slots.inject waits on the actual declaration and retires the contribution
+ * with this plugin's fiber.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.slots.inject('conversation.input.right', () => ctx.slots.register({ name: 'conversation.input.right', id: 'dsh-prompt-history' }, InputHistory));
+}

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * dsh-prompt-history, node half. Pure UI plugin: the empty apply exists so
+ * the plugin appears in the host cordis.yml / Loader; the browser half ships
+ * via exports["./client"], discovered through the package.json dsh.client
+ * declaration.
+ */
+/** Host plugin body — no host-side behavior for this UI-only plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * dsh-prompt-history, node half. Pure UI plugin: the empty apply exists so
+ * the plugin appears in the host cordis.yml / Loader; the browser half ships
+ * via exports["./client"], discovered through the package.json dsh.client
+ * declaration.
+ */
+/** Host plugin body — no host-side behavior for this UI-only plugin. */
+export function apply() { }

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `dsh-prompt-history`.
+ * @module dsh-prompt-history/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "dsh-prompt-history-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -0,0 +1,23 @@
+/**
+ * Package-owned invariant companion for `dsh-prompt-history`.
+ * @module dsh-prompt-history/invariant
+ */
+const PACKAGE_NAME = 'dsh-prompt-history';
+/** Cordis companion plugin name. */
+export const name = 'dsh-prompt-history-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: the composer slot registration is a registry-owned
+ * registration whose disposal is proven by the HMR-safety spec, and the
+ * per-session keydown listener is React-effect-owned (unmount tears it down).
+ * The plugin emits no cordis events and owns no cross-plugin mutable state.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "dsh-prompt-history",
+  "version": "0.1.0",
+  "description": "DSH web plugin: bash-like prompt history in the composer — Up/Down arrows recall previously submitted messages, sourced from the session's own message log (zero config, zero extra storage).",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "plugin",
+    "history",
+    "composer",
+    "input",
+    "prompt"
+  ],
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Xiaofei-fei/dsh-prompt-history"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "README_EN.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.7",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.6.0",
+    "unrun": "^0.3.1"
+  },
+  "scripts": {
+    "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
+    "prepare": "pnpm build",
+    "typecheck": "tsc --noEmit",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}

package/src/client/InputHistory.tsx

@@ -0,0 +1,171 @@
+/**
+ * InputHistory: bash-like prompt history for the composer (dsh-prompt-history).
+ * Renders nothing — it mounts one capture-phase keydown listener on the
+ * document while the session's composer card is live. Up recalls previously
+ * submitted prompts (newest first), Down walks forward and restores the line
+ * that was being typed before browsing began; editing the draft while browsing
+ * drops back to the live line. The '/' and '@' suggestion menus keep their own
+ * arrow-key navigation: while the menu (role=listbox inside the composer card)
+ * is open, this listener declines and the input trigger pipeline owns the keys.
+ *
+ * History is fed from the conversation snapshot's user nodes (kind 'user' and
+ * 'steering'), appended as they land — so everything submitted while the page
+ * is open is recallable even after the session event window slides. Consecutive
+ * duplicates collapse; on a session switch the window's in-window user messages
+ * seed the list. Unlike a parallel storage ring, the history IS the session's
+ * own message log: it stays consistent with the transcript, survives reloads
+ * through the session itself, and needs no configuration or extra storage.
+ *
+ * Interception guards: composer textarea target only, no modifier keys
+ * (Shift+Up still extends selection), no IME composition, machine not
+ * adjudicating/submitting, session not removed, and a non-empty history.
+ */
+import { useEffect, useRef } from 'react'
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+// Type-only: the ui-conversation SlotMap merge (the input.right entry) and the
+// session standard kit members (useInput/inputActions).
+import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+// Type-only: the runtime SessionStandardProps merge (useSession/sessionId) and
+// the conversation node union.
+import type { ConversationNode } from '@deepseek-ai/dsh-client-runtime/client'
+
+/** Full props of the input-history entry: framework standard kit + owner share. */
+export type InputHistoryProps = PropsRuntime<'conversation.input.right'>
+
+/** One browse-position snapshot; index -1 = showing the live draft (not browsing). */
+interface BrowseState {
+  /** History index currently shown; -1 = the live line. */
+  readonly index: number
+  /** The draft saved when browsing started; restored at the bottom edge. */
+  readonly saved: string
+  /** The exact draft our own setDraft last wrote (user-edit detection). */
+  readonly lastSet: string | null
+}
+
+/** Not-browsing state; also the reset target after edits and session switches. */
+const RESET_BROWSE: BrowseState = { index: -1, saved: '', lastSet: null }
+
+/** The composer card's own textarea is the only interception target. */
+const COMPOSER_CARD = '[data-composer-card]'
+/** The suggestion menu (slash/at) renders a listbox inside the card while open. */
+const OPEN_MENU = '[role="listbox"]'
+
+/** Extract the trimmed plain text of one user-submitted message node; null when empty. */
+function promptText(node: ConversationNode): string | null {
+  if (node.kind !== 'user' && node.kind !== 'steering') return null
+  let text = ''
+  for (const block of node.content) {
+    if (block.type === 'text') text += block.text
+  }
+  const trimmed = text.trim()
+  return trimmed === '' ? null : trimmed
+}
+
+/**
+ * The composer history entry: no visible UI, one keydown listener.
+ * @param props - framework standard kit (useInput/useSession/inputActions/sessionId).
+ * @returns null (the entry is invisible chrome).
+ */
+export function InputHistory({ useInput, useSession, inputActions, sessionId }: InputHistoryProps) {
+  // Latest machine/session facts at event time (the listener mounts once).
+  const draft = useInput(s => s.draft)
+  const phase = useInput(s => s.phase)
+  const nodes = useSession(s => s.nodes)
+  const removed = useSession(s => s.removed) ?? false
+
+  /** Submitted prompt texts, oldest → newest (per session; append-only). */
+  const historyRef = useRef<string[]>([])
+  /** User-node seqs already folded into historyRef (append-once dedup). */
+  const seenRef = useRef<Set<number>>(new Set())
+  const browseRef = useRef<BrowseState>(RESET_BROWSE)
+  const liveRef = useRef({ draft, phase, removed, inputActions })
+  liveRef.current = { draft, phase, removed, inputActions }
+
+  // Session switch: start a fresh history, seen set, and browse position.
+  useEffect(() => {
+    historyRef.current = []
+    seenRef.current = new Set()
+    browseRef.current = RESET_BROWSE
+  }, [sessionId])
+
+  // Fold newly arrived user messages into the history (window slides; the
+  // append-only list survives it).
+  useEffect(() => {
+    const seen = seenRef.current
+    const history = historyRef.current
+    for (const node of nodes) {
+      if (node.kind !== 'user' && node.kind !== 'steering') continue
+      if (seen.has(node.seq)) continue
+      seen.add(node.seq)
+      const text = promptText(node)
+      if (text === null) continue
+      if (history[history.length - 1] !== text) history.push(text)
+    }
+  }, [nodes])
+
+  // Any draft change that is not our own history write ends the browse
+  // session (bash drops the recalled line when you edit it).
+  useEffect(() => {
+    const browse = browseRef.current
+    if (browse.index !== -1 && draft !== browse.lastSet) browseRef.current = RESET_BROWSE
+  }, [draft])
+
+  useEffect(() => {
+    const onKeyDown = (e: KeyboardEvent): void => {
+      if (e.key !== 'ArrowUp' && e.key !== 'ArrowDown') return
+      const target = e.target
+      if (!(target instanceof HTMLTextAreaElement)) return
+      const card = target.closest(COMPOSER_CARD)
+      if (card === null) return
+      // IME composition and modifier chords stay native (Shift+Up selects text,
+      // Ctrl+Up moves by word).
+      if (e.isComposing || e.keyCode === 229) return
+      if (e.shiftKey || e.ctrlKey || e.metaKey || e.altKey) return
+      // The suggestion menu owns the arrows while it is open.
+      if (card.querySelector(OPEN_MENU) !== null) return
+      const live = liveRef.current
+      if (live.phase === 'adjudicating' || live.phase === 'submitting' || live.removed) return
+      const history = historyRef.current
+      if (history.length === 0) return
+      // The browse indexes below are always in bounds (derived from the length
+      // or a clamped prior index), so the undefined arm of the indexed read is
+      // unreachable; the fallback keeps the write and the lastSet echo aligned.
+      const recall = (index: number): string => history[index] ?? ''
+      const browse = browseRef.current
+
+      if (e.key === 'ArrowDown' && browse.index === -1) return // native caret-down on the live line
+
+      e.preventDefault()
+      e.stopPropagation()
+
+      if (e.key === 'ArrowUp') {
+        if (browse.index === -1) {
+          // Enter browsing: save the live line, recall the newest prompt.
+          const index = history.length - 1
+          browseRef.current = { index, saved: live.draft, lastSet: recall(index) }
+          live.inputActions.setDraft(recall(index))
+        } else {
+          const index = Math.max(0, browse.index - 1)
+          browseRef.current = { ...browse, index, lastSet: recall(index) }
+          live.inputActions.setDraft(recall(index))
+        }
+        return
+      }
+
+      // ArrowDown while browsing.
+      if (browse.index + 1 >= history.length) {
+        // Bottom edge: restore the saved live line and stop browsing.
+        browseRef.current = RESET_BROWSE
+        live.inputActions.setDraft(browse.saved)
+      } else {
+        const index = browse.index + 1
+        browseRef.current = { ...browse, index, lastSet: recall(index) }
+        live.inputActions.setDraft(recall(index))
+      }
+    }
+    document.addEventListener('keydown', onKeyDown, true)
+    return () => { document.removeEventListener('keydown', onKeyDown, true) }
+  }, [])
+
+  return null
+}

package/src/client/index.ts

@@ -0,0 +1,27 @@
+/**
+ * Prompt-history plugin, browser half: one invisible entry in the composer's
+ * input.right tool row that mounts the capture-phase keyboard listener (see
+ * InputHistory.tsx for the full behavior contract).
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+// Type-only: pulls the ui-conversation SlotMap merge (the input.right entry)
+// and the session standard kit members used by the component.
+import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+import { InputHistory } from './InputHistory.tsx'
+
+/** Required services: the slot registry the entry registers into. */
+export const inject = ['slots']
+
+/**
+ * Client plugin body: register the composer input-history entry. The
+ * declaration lives in ui-conversation, whose apply order is unconstrained —
+ * slots.inject waits on the actual declaration and retires the contribution
+ * with this plugin's fiber.
+ * @param ctx - client root context.
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.slots.inject('conversation.input.right', () => ctx.slots.register(
+    { name: 'conversation.input.right', id: 'dsh-prompt-history' },
+    InputHistory,
+  ))
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+/**
+ * dsh-prompt-history, node half. Pure UI plugin: the empty apply exists so
+ * the plugin appears in the host cordis.yml / Loader; the browser half ships
+ * via exports["./client"], discovered through the package.json dsh.client
+ * declaration.
+ */
+
+/** Host plugin body — no host-side behavior for this UI-only plugin. */
+export function apply(): void {}

package/src/invariant.ts

@@ -0,0 +1,32 @@
+/**
+ * Package-owned invariant companion for `dsh-prompt-history`.
+ * @module dsh-prompt-history/invariant
+ */
+
+/* jscpd:ignore-start */
+import type { Context } from '@deepseek-ai/cordis'
+import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
+
+const PACKAGE_NAME = 'dsh-prompt-history'
+
+/** Cordis companion plugin name. */
+export const name = 'dsh-prompt-history-invariant'
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants']
+
+/**
+ * No runtime invariant: the composer slot registration is a registry-owned
+ * registration whose disposal is proven by the HMR-safety spec, and the
+ * per-session keydown listener is React-effect-owned (unmount tears it down).
+ * The plugin emits no cordis events and owns no cross-plugin mutable state.
+ */
+const install: InvariantInstaller = () => {}
+
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx: Context): Promise<() => void> =>
+  Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
+/* jscpd:ignore-end */