@deepseek-harness-tui/dsh-tui 0.7.1 → 0.7.3

package/README.md

@@ -77,7 +77,8 @@ sh install.sh
 `dsh-tui --resume` 恢复上次会话；Windows 也可用仓库里的 `dsh-tui.cmd`（等价）。
 
 在 VS Code 中运行的完整指南（内置终端直接使用 + companion 扩展
-`dsh-tui-vscode` 一键启动/恢复与编辑器集成）见
+`dsh-tui-vscode`——**真实集成终端承载、体验与 Claude Code 官方扩展几乎一致、
+已上架 VS Code Marketplace**）见
 [在 VS Code 中运行 dsh-TUI](docs/vscode.md)。
 
 TUI 启动后会在后台检查 npm 是否有新版本；发现更新时会提示，输入 `/update`
@@ -134,7 +135,7 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 
 | 分组 | 命令 |
 |---|---|
-| 会话 | `/new` 新会话 · `/resume` 切换当前工作区内的会话 · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） |
+| 会话 | `/new` 新会话 · `/resume` 会话浏览器（搜索、预览、跨项目、折叠子 agent 运行） · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） |
 | 状态 | `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md |
 | 模型 | `/model` 选择器 · `/thinking` 思考显示 · `/tokens` token 明细 · `/theme` 主题选择器 · `/lang` 中英界面切换 |
 | 账号/策略 | `/provider` 添加模型提供方 · `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` · `/memory` |
@@ -151,7 +152,7 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 | [主题系统](docs/themes.md) | 内置主题、自动检测、自定义 JSON 主题与校验规则 |
 | [交互与命令](docs/interaction.md) | 快捷键、鼠标、问卷、slash command 与会话工作流 |
 | [架构与限制](docs/architecture.md) | 运行链路、渲染与持久化设计、安全边界、已知限制 |
-| [VS Code 使用指南](docs/vscode.md) | 在 VS Code 集成终端运行 dsh-tui 与 companion 扩展 `dsh-tui-vscode` |
+| [VS Code 使用指南](docs/vscode.md) | 在 VS Code 集成终端运行 dsh-tui；companion 扩展 `dsh-tui-vscode` 提供与 Claude Code 官方扩展几乎一致的体验（已上架 Marketplace） |
 | [贡献与开发约定](docs/contributing.md) | 贡献流程、仓库地图、构建产物、验证矩阵与修改规则 |
 | [插件开发指南](docs/plugins.md) | 插件接缝（会话事件 / 槽位 / 技能 / 主题 / prompt 段）、契约、规范与收录 |
 
@@ -159,7 +160,8 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 
 ## 配置与扩展
 
-- **Agent preset**：四种官方 Agent 模式（`standard` / `code` / `minimal` / `cordis`），
+- **Agent preset**：四种官方 Agent 模式（`standard` / `code` / `minimal` / `cordis`）和
+  TUI 随包提供的“梁神模式”（`liangshen`），
   `/preset` 切换；已产生对话的会话不可切换，空白会话立即生效。默认 preset 持久化
   在 `~/.dsh-tui/agent-preset.json`；`/model` 的选择持久化在 `~/.dsh-tui/model.json`。
   详见[配置参考](docs/configuration.md#agent-preset)。
@@ -205,7 +207,7 @@ compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与
 - **TPS 仪表**：参考 pi-tps-meter——流式 1/8 格 gauge、历史 min-max sparkline、
   速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
 - **working-activity 生态**：工作状态行复用
-  [dsh-working-activity](https://github.com/ccch1mneyyy/dsh-working-activity)
+  [dsh-working-activity](https://github.com/ccch1mneyyy/working-activity)
   的纯状态机，在进程内从基础会话事件派生，不向共享日志写入 UI 状态。
 - **终端粘贴**：raw 模式下 Ctrl+V 由应用接管，按平台读取系统剪贴板——Windows
   走 PowerShell `Get-Clipboard`，macOS 走 `osascript`/`pbpaste`，Linux 自动探测

package/bin/dsh-tui.js

@@ -9,7 +9,11 @@
  *   2. 检测 $DSH_HOME/profiles/dsh-tui 是否已初始化，未初始化则自动执行
  *      `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@<本包版本>`
  *      自举——版本号与本包对齐，避免 pnpm store 缓存带来的旧版漂移；
- *   3. 已初始化但版本与本包不一致时打印一行提示（TUI 内 /update 或重新 add）；
+ *   3. 已初始化但版本与本包不一致时按方向处理（issue #183）：profile
+ *      更新（前向错位）打印一行提示后继续启动（TUI 内 /update 或重新
+ *      add）；profile 次版本更旧（反向错位）拒绝启动并给出对齐命令——
+ *      该方向 dsh CLI 会把启动器的 bundle patch 套到 profile 旧包上，
+ *      启动必然以模块解析错误崩溃；
  *   4. 透传全部参数启动 `dsh --profile dsh-tui`。
  *
  * `--resume` 由本启动器拦截：读取 TUI 保留的 ~/.dsh-tui/resume.txt
@@ -65,10 +69,37 @@ const MSG = {
       `  更新 profile：在 TUI 内执行 /update，或运行：\n` +
       `  dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest`,
   },
+  // Reverse skew (issue #183): the dsh CLI reads the bundle patch from the
+  // FIRST copy found from its own install anchor — this globally installed
+  // launcher — while the plugin modules load from the profile's copy. A
+  // launcher minor NEWER than the profile means the patch may reference
+  // subpath exports the profile's older package does not have, and boot
+  // crashes opaquely (ERR_PACKAGE_PATH_NOT_EXPORTED) before any TUI code
+  // runs. Fail loud with the fix instead. (Forward skew degrades to a
+  // working local-workspace fallback since 0.7.2 — soft note below.)
+  profileOlderThanLauncher: {
+    en: (installed, own) =>
+      `[dsh-tui] cannot start: the profile runs v${installed} but this launcher is v${own}.\n` +
+      `  The launcher's bundle patch would be applied to the profile's older package,\n` +
+      `  which does not export everything the patch references — boot would crash.\n` +
+      `  Align the profile with the launcher:\n` +
+      `  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${own}\n` +
+      `  (or update everything to the latest release: dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest)`,
+    zh: (installed, own) =>
+      `[dsh-tui] 无法启动：profile 内运行的是 v${installed}，而启动器是 v${own}。\n` +
+      `  启动器的 bundle patch 会套用到 profile 里的旧版包上，其中缺少 patch 引用\n` +
+      `  的子路径导出——启动会以模块解析错误崩溃。请让 profile 与启动器对齐：\n` +
+      `  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${own}\n` +
+      `  （或全部升到最新：dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest）`,
+  },
   launchFailed: {
     en: err => `[dsh-tui] Failed to launch: ${err.message}`,
     zh: err => `[dsh-tui] 启动失败：${err.message}`,
   },
+  profileExited: {
+    en: code => `[dsh-tui] dsh profile exited with code ${code}. Run it directly for diagnostics:\n  dsh --profile ${PROFILE}`,
+    zh: code => `[dsh-tui] dsh profile 已退出（退出码 ${code}）。可直接运行以下命令查看诊断：\n  dsh --profile ${PROFILE}`,
+  },
   legacyEnv: {
     en: (oldName, newName) => `[dsh-tui] note: env ${oldName} was renamed to ${newName}; the old name no longer takes effect.`,
     zh: (oldName, newName) => `[dsh-tui] 提示：环境变量 ${oldName} 已更名为 ${newName}，旧名不再生效。`,
@@ -126,6 +157,15 @@ if (installedVersion === undefined) {
     process.exit(add.status ?? 1)
   }
 } else if (installedVersion !== ownVersion) {
+  // Reverse skew is fatal (see MSG.profileOlderThanLauncher): compare
+  // major/minor only — patch-level differences never move the patch surface.
+  const majorMinor = v => v.split('-')[0].split('.').slice(0, 2).map(Number)
+  const [installedMajor, installedMinor] = majorMinor(installedVersion)
+  const [ownMajor, ownMinor] = majorMinor(ownVersion)
+  if (installedMajor < ownMajor || (installedMajor === ownMajor && installedMinor < ownMinor)) {
+    console.error(MSG.profileOlderThanLauncher[lang](installedVersion, ownVersion))
+    process.exit(1)
+  }
   console.error(MSG.versionMismatch[lang](installedVersion, ownVersion))
 }
 
@@ -197,6 +237,7 @@ child.on('exit', (code, signal) => {
   if (signal) {
     process.kill(process.pid, signal)
   } else {
+    if (code !== null && code !== 0) console.error(MSG.profileExited[lang](code))
     process.exit(code ?? 0)
   }
 })

package/cordis.patch.yml

@@ -218,6 +218,16 @@
       # The entry-level dependency augments the plugin's `agents` inject and
       # prevents startup Session creation from racing WorkspaceRegistry init.
       inject: [workspaceRegistry, agents, tuiWorkspaces]
+      # `tuiWorkspaces` lives in the entry-level inject ONLY as an ordering
+      # guarantee alongside the dsh-tui-workspaces row above — it is
+      # deliberately absent from the plugin's code-level inject (issue
+      # #183): the dsh CLI may read this patch from an older copy of the
+      # package than the plugin module it loads, and a hard code-level
+      # inject then deadlocks the tree at boot ("pending (waiting for
+      # service: tuiWorkspaces)"). Without the row the TUI degrades to a
+      # local-only workspace runtime instead. (The comment sits below the
+      # inject line: verify-workspace-attachment.mjs asserts the
+      # name→inject distance.)
       config:
         provider: deepseek-official
         # Alt-screen fullscreen（CC 同款）：应用内鼠标选区（选择即复制, OSC 52 +

package/lib/types/commands.js

@@ -31,7 +31,7 @@ export const LOCAL_COMMANDS = [
     { name: 'agents', description: 'Show subagents of this session' },
     // Model / display
     { name: 'activity', description: 'Switch the working-activity indicator preset' },
-    { name: 'preset', description: 'Switch the agent preset (standard/code/minimal/cordis)' },
+    { name: 'preset', description: 'Switch the agent preset (including Liangshen mode)' },
     { name: 'theme', description: 'Switch the color theme (auto, built-in or custom)' },
     { name: 'lang', description: 'Switch the UI language (en / zh)' },
     { name: 'model', description: 'Show the active model' },

package/lib/types/components/GoalTodoPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GoalTodoPanel.d.ts","sourceRoot":"","sources":["../../../src/components/GoalTodoPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,2BAA2B,CAAA;AAwDpF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CA2DhF"}
+{"version":3,"file":"GoalTodoPanel.d.ts","sourceRoot":"","sources":["../../../src/components/GoalTodoPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,2BAA2B,CAAA;AAwDpF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAgEhF"}

package/lib/types/components/GoalTodoPanel.js

@@ -45,7 +45,12 @@ function BranchPrefix({ last }) {
  */
 export function GoalTodoPanel({ channel }) {
     const goal = channel.goal;
-    const todos = channel.todos ?? [];
+    const allTodos = channel.todos ?? [];
+    // Completed rows are useful progress while a turn is running, but become
+    // stale footer noise once the agent is idle. Keep unfinished work visible.
+    const todos = channel.working
+        ? allTodos
+        : allTodos.filter(todo => todo.status !== 'completed');
     if (goal === undefined && todos.length === 0)
         return null;
     const visible = todos.slice(0, MAX_TODOS);

package/lib/types/components/HistorySearchDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HistorySearchDialog.d.ts","sourceRoot":"","sources":["../../../src/components/HistorySearchDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,YAAY,EACZ,OAAO,EACP,UAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,KAAK,CAAC,SAAS,CAmDlB"}
+{"version":3,"file":"HistorySearchDialog.d.ts","sourceRoot":"","sources":["../../../src/components/HistorySearchDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,YAAY,EACZ,OAAO,EACP,UAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,KAAK,CAAC,SAAS,CAuDlB"}

package/lib/types/components/HistorySearchDialog.js

@@ -26,7 +26,11 @@ export function HistorySearchDialog({ query, cursorOffset, matches, focusIndex,
     const { start, end } = listWindow(matches.map(() => 2), focusIndex, Math.max(terminalRows - 18, 2), 1);
     return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { bold: true, color: "permission", children: t('history-search-title') }), _jsx(SearchBox, { query: query, cursorOffset: cursorOffset, isFocused: true, isTerminalFocused: isTerminalFocused, placeholder: t('history-search-placeholder') }), matches.length === 0 ? (_jsx(Text, { dimColor: true, children: t('history-search-empty') })) : (matches.slice(start, end).map((entry, index) => {
                     const absoluteIndex = start + index;
-                    return (_jsx(ListItem, { isFocused: absoluteIndex === focusIndex, description: formatRelativeAge(entry.ts), showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < matches.length, children: entry.text }, historyEntryId(entry)));
+                    return (_jsx(ListItem, { isFocused: absoluteIndex === focusIndex, 
+                        // The SearchBox owns the native-cursor declaration while this
+                        // dialog is open — result rows must not park the cursor on
+                        // themselves, or IME preedit lands on a list row.
+                        declareCursor: false, description: formatRelativeAge(entry.ts), showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < matches.length, children: entry.text }, historyEntryId(entry)));
                 })), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-history-search') }) })] }) }));
 }
 /** Relative age like CC's formatRelativeTimeAgo ("now" / "5m ago" / …), localized. */

package/lib/types/components/LoadedContextPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoadedContextPanel.d.ts","sourceRoot":"","sources":["../../../src/components/LoadedContextPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AA+BlF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CAkElB"}
+{"version":3,"file":"LoadedContextPanel.d.ts","sourceRoot":"","sources":["../../../src/components/LoadedContextPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AA+BlF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CAoElB"}

package/lib/types/components/LoadedContextPanel.js

@@ -26,5 +26,5 @@ export function LoadedContextPanel({ context, open, onToggle, }) {
     const summary = summarizeLoadedContext(context);
     if (summary === '')
         return null;
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsxs(Box, { paddingX: 1, backgroundColor: open ? 'userMessageBackground' : undefined, children: [_jsxs(Text, { bold: open, children: [open ? '▼' : '▶', " ", t('context-loaded'), " \u00B7 ", summary] }), _jsxs(Text, { dimColor: true, children: [" \uFF08Ctrl+T", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] })] }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) }))] }))] }));
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsx(Box, { paddingX: 1, backgroundColor: open ? 'userMessageBackground' : undefined, children: _jsxs(Text, { wrap: "truncate", bold: open, children: [open ? '▼' : '▶', " ", t('context-loaded'), " \u00B7 ", summary, _jsxs(Text, { dimColor: true, children: [" \uFF08Ctrl+T", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] })] }) }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) }))] }))] }));
 }

package/lib/types/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,2BAA2B,CAAA;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAuC/C,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAsB,EACtB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;2EACuE;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,oDAAoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,qBAoPA;AAuQD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,KAAK,CAAC,SAAS,CAMlB"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,2BAA2B,CAAA;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAuC/C,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAsB,EACtB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;2EACuE;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,oDAAoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,qBAwPA;AAuQD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,KAAK,CAAC,SAAS,CAMlB"}

package/lib/types/components/MessageList.js

@@ -158,8 +158,12 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
             }
         }
     }
+    const lastUnseenReportRef = React.useRef(-1);
     React.useEffect(() => {
-        onUnseenCount?.(unseenCount);
+        if (unseenCount !== lastUnseenReportRef.current) {
+            lastUnseenReportRef.current = unseenCount;
+            onUnseenCount?.(unseenCount);
+        }
     });
     // Post-commit: measure mounted rows, derive the content-space base from
     // the first mounted row's Yoga top, and clamp render-time scrollTop to the

package/lib/types/components/PromptInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PromptInput.d.ts","sourceRoot":"","sources":["../../../src/components/PromptInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAkDxD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,OAAO,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,IAAI,IAAI,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,IAAI,IAAI,CAAA;IACvB,8EAA8E;IAC9E,eAAe,CAAC,IAAI,IAAI,CAAA;IACxB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,GACd,EAAE,gBAAgB,qBAq6BlB"}
+{"version":3,"file":"PromptInput.d.ts","sourceRoot":"","sources":["../../../src/components/PromptInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAkDxD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,OAAO,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,IAAI,IAAI,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,IAAI,IAAI,CAAA;IACvB,8EAA8E;IAC9E,eAAe,CAAC,IAAI,IAAI,CAAA;IACxB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,GACd,EAAE,gBAAgB,qBAg5BlB"}

package/lib/types/components/PromptInput.js

@@ -103,6 +103,8 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         controllerRef.current = {
             hasText: () => value.length > 0,
             clear: () => {
+                valueRef.current = '';
+                cursorRef.current = 0;
                 setValue('');
                 setCursor(0);
             },
@@ -120,6 +122,8 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     React.useEffect(() => {
         if (fillText && fillText !== lastFill.current) {
             lastFill.current = fillText;
+            valueRef.current = fillText;
+            cursorRef.current = fillText.length;
             setValue(fillText);
             setCursor(fillText.length);
             onFillConsumed?.();
@@ -132,16 +136,6 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     const clipboardBusyRef = React.useRef(false);
     /** True while the external editor owns the terminal (Ctrl+X round-trip). */
     const editorBusyRef = React.useRef(false);
-    /**
-     * Latest committed input state. The Ctrl+V clipboard read resolves
-     * asynchronously; inserting against the render that STARTED the read
-     * would drop whatever the user typed while waiting. The continuation
-     * inserts against this mirror instead.
-     */
-    const liveInputRef = React.useRef({ value: '', cursor: 0 });
-    React.useEffect(() => {
-        liveInputRef.current = { value, cursor };
-    });
     /** Enter dedupe window: cmd pipelines can deliver one Enter as `\r`+`\n`. */
     const lastEnterAtRef = React.useRef(0);
     React.useEffect(() => {
@@ -193,6 +187,12 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         !helpOpen &&
         !selectionActive &&
         fileEscRef.current !== mention?.start;
+    const setInput = (next, cursorOffset = next.length) => {
+        valueRef.current = next;
+        cursorRef.current = Math.max(0, Math.min(cursorOffset, next.length));
+        setValue(next);
+        setCursor(cursorRef.current);
+    };
     /**
      * Accept the selected file suggestion: replace ONLY the mention token at
      * the caret (prefix/suffix text survives), quoting whitespace paths. A
@@ -216,8 +216,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         if (history.current.length > HISTORY_LIMIT)
             history.current.shift();
         historyIndex.current = -1;
-        setValue('');
-        setCursor(0);
+        setInput('', 0);
         setSelectedCommand(0);
         appendHistory(trimmed);
         channel.submit(trimmed);
@@ -243,8 +242,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         if (history.current.length > HISTORY_LIMIT)
             history.current.shift();
         historyIndex.current = -1;
-        setValue('');
-        setCursor(0);
+        setInput('', 0);
         setSelectedCommand(0);
         appendHistory(trimmed);
         channel.steer(trimmed);
@@ -262,8 +260,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         if (history.current.length > HISTORY_LIMIT)
             history.current.shift();
         historyIndex.current = -1;
-        setValue('');
-        setCursor(0);
+        setInput('', 0);
         setSelectedCommand(0);
         appendHistory(trimmed);
         channel.submit(trimmed);
@@ -282,8 +279,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             channel.notify(t('input-cannot-retract'), { color: 'warning', timeoutMs: 2500 });
             return;
         }
-        setValue(item.text);
-        setCursor(item.text.length);
+        setInput(item.text);
         setSelectedCommand(0);
         setFileSelected(0);
         channel.notify(t('input-retracted'), { timeoutMs: 2000 });
@@ -308,8 +304,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         if (history.current.length > HISTORY_LIMIT)
             history.current.shift();
         historyIndex.current = -1;
-        setValue('');
-        setCursor(0);
+        setInput('', 0);
         setSelectedCommand(0);
         setFileSelected(0);
         appendHistory(trimmed);
@@ -336,19 +331,12 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             if (history.current.length > HISTORY_LIMIT)
                 history.current.shift();
             historyIndex.current = -1;
-            setValue('');
-            setCursor(0);
+            setInput('', 0);
             setSelectedCommand(0);
             appendHistory(text.trim());
         }
         return handled;
     };
-    const setInput = (next, cursorOffset = next.length) => {
-        valueRef.current = next;
-        cursorRef.current = Math.max(0, Math.min(cursorOffset, next.length));
-        setValue(next);
-        setCursor(cursorRef.current);
-    };
     /** Clipboard reads are asynchronous; insert against the latest render so
      * typing while PowerShell owns the clipboard never gets overwritten. */
     const insertClipboardAtCaret = (text) => {
@@ -359,13 +347,13 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         setFileSelected(0);
     };
     /** Line index of the cursor; -1 when the cursor is at the very end. */
-    const cursorLine = () => {
-        const before = value.slice(0, cursor);
+    const cursorLine = (text, cursorOffset) => {
+        const before = text.slice(0, cursorOffset);
         return before.split('\n').length - 1;
     };
     /** Column of the cursor within its line. */
-    const cursorColumn = () => {
-        const before = value.slice(0, cursor);
+    const cursorColumn = (text, cursorOffset) => {
+        const before = text.slice(0, cursorOffset);
         const line = before.split('\n').pop() ?? '';
         return line.length;
     };
@@ -377,13 +365,17 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         // setValue can never overwrite fresh typing (and vice versa).
         if (editorBusyRef.current)
             return;
+        // App deliberately dispatches every parsed key from one stdin read in a
+        // single React update. Read the synchronous mirrors so each event sees
+        // the text/caret produced by the preceding event in that batch.
+        const value = valueRef.current;
+        const cursor = cursorRef.current;
         /** Insert text at the caret (typing, paste) and dismiss overlays. */
         const insertAtCaret = (text) => {
             if (helpOpen)
                 onToggleHelp();
             const next = value.slice(0, cursor) + text + value.slice(cursor);
-            setValue(next);
-            setCursor(cursor + text.length);
+            setInput(next, cursor + text.length);
             setSelectedCommand(0);
             setFileSelected(0);
         };
@@ -441,10 +433,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 // Insert against the LIVE input state: the read above resolved
                 // asynchronously and the user may have typed while waiting.
                 const text = formatClipboardInsert(content);
-                const live = liveInputRef.current;
-                const caret = Math.min(live.cursor, live.value.length);
-                setValue(live.value.slice(0, caret) + text + live.value.slice(caret));
-                setCursor(caret + text.length);
+                insertClipboardAtCaret(text);
             })
                 .catch(() => {
                 channel.notify(t('input-clipboard-read-failed'), { color: 'warning' });
@@ -469,8 +458,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 try {
                     const outcome = await editInExternalEditor(value);
                     if (outcome.kind === 'edited') {
-                        setValue(outcome.text);
-                        setCursor(outcome.text.length);
+                        setInput(outcome.text);
                         setSelectedCommand(0);
                         setFileSelected(0);
                     }
@@ -575,8 +563,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             // ink/terminal.ts); Option+Enter (ESC CR) is the fallback on terminals
             // that can't report shift — e.g. macOS Terminal.app (issue #110).
             const next = value.slice(0, cursor) + '\n' + value.slice(cursor);
-            setValue(next);
-            setCursor(cursor + 1);
+            setInput(next, cursor + 1);
             setSelectedCommand(0);
             return;
         }
@@ -620,13 +607,13 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 setFileSelected(index => index <= 0 ? fileMatches.length - 1 : index - 1);
                 return;
             }
-            const line = cursorLine();
+            const line = cursorLine(value, cursor);
             if (line > 0) {
                 // Move to the previous line, clamping to its length.
                 const upToLineStart = value.lastIndexOf('\n', cursor - 1);
                 const prevLineStart = upToLineStart === -1 ? 0 : value.lastIndexOf('\n', upToLineStart - 1) + 1;
                 const prevLine = value.slice(prevLineStart, upToLineStart);
-                setCursor(prevLineStart + Math.min(cursorColumn(), prevLine.length));
+                setInput(value, prevLineStart + Math.min(cursorColumn(value, cursor), prevLine.length));
                 return;
             }
             if (overlayOpen) {
@@ -639,8 +626,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 ? history.current.length - 1
                 : Math.max(0, historyIndex.current - 1);
             const entry = history.current[historyIndex.current] ?? '';
-            setValue(entry);
-            setCursor(entry.length);
+            setInput(entry);
             return;
         }
         if (key.downArrow) {
@@ -648,13 +634,13 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 setFileSelected(index => index >= fileMatches.length - 1 ? 0 : index + 1);
                 return;
             }
-            const line = cursorLine();
+            const line = cursorLine(value, cursor);
             const lines = value.split('\n');
             if (line < lines.length - 1) {
                 const nextLineStart = value.indexOf('\n', cursor) + 1;
                 const nextLineEnd = value.indexOf('\n', nextLineStart);
                 const nextLine = value.slice(nextLineStart, nextLineEnd === -1 ? value.length : nextLineEnd);
-                setCursor(nextLineStart + Math.min(cursorColumn(), nextLine.length));
+                setInput(value, nextLineStart + Math.min(cursorColumn(value, cursor), nextLine.length));
                 return;
             }
             if (overlayOpen) {
@@ -667,76 +653,73 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             const entry = historyIndex.current >= history.current.length
                 ? ''
                 : (history.current[historyIndex.current] ?? '');
-            setValue(entry);
-            setCursor(entry.length);
+            setInput(entry);
             return;
         }
         if (isMod(key) && key.leftArrow) {
             // Jump to the previous word boundary (readline alt+b). Must precede the
             // bare-arrow arms: Ctrl+Left arrives as leftArrow + ctrl.
-            setCursor(previous => wordBoundaryLeft(value, previous));
+            setInput(value, wordBoundaryLeft(value, cursor));
             return;
         }
         if (isMod(key) && key.rightArrow) {
             // Jump to the next word boundary (readline alt+f).
-            setCursor(previous => wordBoundaryRight(value, previous));
+            setInput(value, wordBoundaryRight(value, cursor));
             return;
         }
         if (key.leftArrow) {
-            setCursor(previous => Math.max(0, previous - 1));
+            setInput(value, Math.max(0, cursor - 1));
             return;
         }
         if (key.rightArrow) {
-            setCursor(previous => Math.min(value.length, previous + 1));
+            setInput(value, Math.min(value.length, cursor + 1));
             return;
         }
         if (key.backspace) {
             if (cursor === 0)
                 return;
-            setValue(value.slice(0, cursor - 1) + value.slice(cursor));
-            setCursor(cursor - 1);
+            setInput(value.slice(0, cursor - 1) + value.slice(cursor), cursor - 1);
             return;
         }
         if (key.delete) {
             if (cursor >= value.length)
                 return;
-            setValue(value.slice(0, cursor) + value.slice(cursor + 1));
+            setInput(value.slice(0, cursor) + value.slice(cursor + 1), cursor);
             return;
         }
         if (key.home) {
             // Start of the current line.
             const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
-            setCursor(lineStart);
+            setInput(value, lineStart);
             return;
         }
         if (key.end) {
             // End of the current line.
             const nextLine = value.indexOf('\n', cursor);
-            setCursor(nextLine === -1 ? value.length : nextLine);
+            setInput(value, nextLine === -1 ? value.length : nextLine);
             return;
         }
         if (isMod(key) && input === 'a') {
             const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
-            setCursor(lineStart);
+            setInput(value, lineStart);
             return;
         }
         if (isMod(key) && input === 'e') {
             const nextLine = value.indexOf('\n', cursor);
-            setCursor(nextLine === -1 ? value.length : nextLine);
+            setInput(value, nextLine === -1 ? value.length : nextLine);
             return;
         }
         if (isMod(key) && input === 'u') {
             // Delete to start of line.
             const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
-            setValue(value.slice(0, lineStart) + value.slice(cursor));
-            setCursor(lineStart);
+            setInput(value.slice(0, lineStart) + value.slice(cursor), lineStart);
             return;
         }
         if (isMod(key) && input === 'k') {
             // Delete to end of line.
             const nextLine = value.indexOf('\n', cursor);
             const end = nextLine === -1 ? value.length : nextLine;
-            setValue(value.slice(0, cursor) + value.slice(end));
+            setInput(value.slice(0, cursor) + value.slice(end), cursor);
             return;
         }
         if (isMod(key) && input === 'w') {
@@ -749,8 +732,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             let start = end;
             while (start > 0 && !/\s/.test(before[start - 1]))
                 start--;
-            setValue(value.slice(0, start) + value.slice(cursor));
-            setCursor(start);
+            setInput(value.slice(0, start) + value.slice(cursor), start);
             return;
         }
         if (key.escape) {
@@ -761,8 +743,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             // A single Esc closes the open command menu first (CC/pi behavior);
             // the double-tap-clear semantics only apply to ordinary input.
             if (overlayOpen) {
-                setValue('');
-                setCursor(0);
+                setInput('', 0);
                 setSelectedCommand(0);
                 setFileSelected(0);
                 return;
@@ -786,8 +767,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             // A single Esc clears the current input (if any); the double-tap
             // path below handles rewind/clear on an already-empty input.
             if (value.length > 0) {
-                setValue('');
-                setCursor(0);
+                setInput('', 0);
                 setSelectedCommand(0);
                 setFileSelected(0);
                 return;
@@ -803,8 +783,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                     onRewindRequest?.();
                 }
                 else {
-                    setValue('');
-                    setCursor(0);
+                    setInput('', 0);
                 }
                 return;
             }
@@ -826,8 +805,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             if (helpOpen)
                 onToggleHelp();
             const next = value.slice(0, cursor) + input + value.slice(cursor);
-            setValue(next);
-            setCursor(cursor + input.length);
+            setInput(next, cursor + input.length);
             setSelectedCommand(0);
             setFileSelected(0);
         }

package/lib/types/components/SearchBox.d.ts

@@ -6,6 +6,10 @@ import React from 'react';
  * placeholder is right-aligned (dimmed) — kept off the caret's cell so the
  * terminal-painted IME preedit (pinyin) can never be overlaid on it during
  * CJK composition.
+ *
+ * The query row is strictly single-line: an overlong query is windowed
+ * around the caret (horizontal scroll) instead of wrapping, so the native
+ * cursor declaration below stays exact for any query length.
  */
 export declare function SearchBox({ query, placeholder, isFocused, isTerminalFocused, prefix, width, cursorOffset, borderless, }: {
     query: string;

package/lib/types/components/SearchBox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchBox.d.ts","sourceRoot":"","sources":["../../../src/components/SearchBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,MAAY,EACZ,KAAK,EACL,YAAY,EACZ,UAAkB,GACnB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CAqDlB"}
+{"version":3,"file":"SearchBox.d.ts","sourceRoot":"","sources":["../../../src/components/SearchBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAyD7E;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,MAAY,EACZ,KAAK,EACL,YAAY,EACZ,UAAkB,GACnB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CA0GlB"}