dsh-code 1.2.0 → 1.4.0

package/src/input-split.ts

@@ -62,10 +62,30 @@ export function createKeypressSplitter(): KeypressSplitter {
         }
         const head = buffer[0]
         if (head !== '\x1b') {
-          // Plain bytes key one at a time; a surrogate pair is one grapheme
-          // and must not split into two lone surrogates.
-          const pair = head >= '\uD800' && head <= '\uDBFF' && buffer[1] !== undefined
-          const take = pair ? 2 : 1
+          // C0 / DEL stay one key so a coalesced ` \r` is still space then
+          // Enter. A printable run (file drag or unbracketed path paste on
+          // any platform, including CJK) must stay ONE unit: splitting a
+          // long path into tens of setStates overflows React's update depth
+          // and never reaches the attachment parser. Typed keys still
+          // arrive as one-byte chunks, so this only batches what the OS
+          // already coalesced.
+          if (head < ' ' || head === '\x7f') {
+            units.push(head)
+            buffer = buffer.slice(1)
+            continue
+          }
+          let take = 0
+          while (take < buffer.length) {
+            const ch = buffer[take]
+            if (ch === '\x1b' || ch < ' ' || ch === '\x7f') break
+            if (ch >= '\uD800' && ch <= '\uDBFF') {
+              if (buffer[take + 1] === undefined) break
+              take += 2
+              continue
+            }
+            take += 1
+          }
+          if (take === 0) break
           units.push(buffer.slice(0, take))
           buffer = buffer.slice(take)
           continue

package/src/internals.ts

@@ -19,7 +19,7 @@ import {
   shouldEnableKeyboardEnhancement,
 } from './keyboard.ts'
 import { createSplitStdin } from './input-split.ts'
-import { ensureVsCodeTabTitleSetting } from './terminal-title.ts'
+import { ensureVsCodeTabTitleSetting } from './ui/terminal-title.ts'
 
 /** A mounted terminal app instance; the runner owns unmount ordering. */
 export interface TuiMount {

package/src/locales/en.ts

@@ -63,7 +63,38 @@ export const en = {
   'search.footer': '↑↓ move · enter search/resume · esc close',
 
   // /statusline panel
+  'header.hint': '/help · Esc interrupt · Ctrl+C quit',
+  'header.hintResumed': 'resumed · /help · Esc interrupt',
+
   'statusline.title': '/statusline · items apply to the live status line below',
+  'statusline.item.model': 'model',
+  'statusline.item.model.desc': 'provider/model serving this session',
+  'statusline.item.cwd': 'cwd',
+  'statusline.item.cwd.desc': 'working-directory basename',
+  'statusline.item.mode': 'mode',
+  'statusline.item.mode.desc': 'agent preset composing the session',
+  'statusline.item.branch': 'branch',
+  'statusline.item.branch.desc': 'git branch inside a repository',
+  'statusline.item.context': 'context',
+  'statusline.item.context.desc': 'context-window occupancy meter',
+  'statusline.item.permission': 'permission',
+  'statusline.item.permission.desc': 'permission preset badge with cycle hint',
+  'statusline.item.plan': 'plan',
+  'statusline.item.plan.desc': 'plan-mode state mark',
+  'statusline.item.turns': 'turns',
+  'statusline.item.turns.desc': 'turn and step counters',
+  'statusline.item.durations': 'durations',
+  'statusline.item.durations.desc': 'llm/ttft/decode/tool wall time',
+  'statusline.item.cache': 'cache',
+  'statusline.item.cache.desc': 'cache-hit share of billed input',
+  'statusline.item.tokens': 'tokens',
+  'statusline.item.tokens.desc': 'cumulative input/output tokens',
+  'statusline.item.title': 'title',
+  'statusline.item.title.desc': 'session title or short id',
+  'statusline.item.goal': 'goal',
+  'statusline.item.goal.desc': 'live goal phase and round progress',
+  'statusline.item.sandbox': 'sandbox',
+  'statusline.item.sandbox.desc': 'divergent sandbox-mode override',
 
   // /schedule panel
   'schedule.title': '/schedule · {count} active reminder',
@@ -72,8 +103,15 @@ export const en = {
 
   // Transcript document panel (/resume details)
   'document.loading': 'loading transcript…',
+  'attach.bar': 'observing · {label} · r reload · esc/ctrl+d back',
+  'attach.loading': 'loading {label}\'s conversation…',
+  'attach.status': 'subagent {label} · {id} · {turns} turns',
+  'notice.attachUnavailable': 'subagent attachment is unavailable in this profile',
   'document.compact': 'transcript · esc close',
-  'document.footer': 'lines {from}-{to}/{total} · ↑↓/pg/g/G · t/esc close',
+  'document.expanded': 'expanded',
+  'document.refreshHint': 'r refresh',
+  'document.footerExpanded': 'lines {from}-{to}/{total} · ↑↓/pg/g/G{refresh} · esc/ctrl+d back',
+  'document.footer': 'lines {from}-{to}/{total} · ↑↓/pg/g/G · enter/f expand · t/esc close',
 
   // /review picker
   'review.picker.title': '/review · choose a target',
@@ -227,12 +265,18 @@ export const en = {
   'status.label.out': 'out',
   'status.label.mode': '/mode',
   'status.label.context': 'context',
+  'status.label.sandbox': 'sandbox',
+  'status.plan.on': 'plan on',
+  'status.plan.mark': '⧉ plan',
+  'status.goal.round': '◎ round {current}/{max}',
+  'status.goal.phase': '◎ {phase}',
 
   // Frozen band
   'frozen.keysGoTo': 'keys go to {owner} · esc {action}',
   'frozen.action.rejects': 'rejects',
   'frozen.action.cancels': 'cancels',
   'frozen.action.closes': 'closes',
+  'frozen.action.waits': 'waits',
 
   // Relative time (panel list timestamps)
   'time.justNow': 'now',
@@ -248,6 +292,7 @@ export const en = {
   'notice.themeSaveFailed': 'theme save failed: {message}',
   'notice.languageSaveFailed': 'language save failed: {message}',
   'notice.alreadyActive': 'that session is already active',
+  'notice.permissionPresetsUnmounted': 'permission presets are not mounted in this composition',
   'notice.queueCancelled': 'queued message cancelled',
   'notice.queueActionFailed': 'queue action failed: {message}',
   'notice.queueUnavailable': 'queued message is no longer pending',
@@ -262,6 +307,8 @@ export const en = {
   'notice.usage.animation': 'usage: /animation [on|off]',
   'notice.usage.language': 'usage: /language [en|zh]',
   'notice.usage.rainbow': 'usage: /rainbow [seed]',
+  'notice.usage.bareCommand': 'usage: /{name}',
+  'notice.switchInProgress': 'switching sessions — send again once the new session is up, or /resume cancel',
   'notice.imageCancelled': 'image submission cancelled',
   'notice.themeConfigUnreadable': 'theme config unreadable, using dark: {message}',
   'notice.languageConfigUnreadable': 'language config unreadable, using english: {message}',
@@ -292,6 +339,13 @@ export const en = {
   'notice.resumeFailed': 'resume failed: {message}',
   'notice.forkFailed': 'fork failed: {message}',
   'notice.sessionSwitchFailed': 'session switch failed: {message}',
+  'notice.sessionCreated': 'created {id} · mode {mode}',
+  'notice.sessionResumed': 'resumed {id} · mode {mode}',
+  'notice.sessionSwitchedDirty': 'switched to {id}, but {detail}',
+  'notice.flushFailed': 'previous session flush failed: {message}',
+  'notice.agentReleaseFailed': 'previous agent release failed: {message}',
+  'notice.copyEmpty': 'nothing to copy yet',
+  'notice.copied': 'copied latest response',
   'notice.switchQueued': 'will switch to {label} when the current turn finishes · /resume cancel to abort',
   'notice.reviewStarted': 'review started under read-only permissions',
   'notice.reviewFailed': 'review failed: {message}',
@@ -345,7 +399,8 @@ export const en = {
   'panel.footer.chooseSelect': '↑↓ choose · enter select · r refresh · esc close',
   'panel.footer.inspectDetails': '↑↓ inspect · enter details · r refresh · esc close',
   'panel.footer.inspectRefresh': '↑↓ inspect · r refresh · esc close',
-  'panel.footer.resume': 'tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · d delete · enter resume',
+  'panel.footer.resume': 'tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · enter resume',
+  'panel.footer.delete': 'tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · enter delete · esc close',
   'panel.footer.transcript': 'lines {from}-{to}/{total} · ↑↓/pg/g/G · t/esc close',
   'panel.footer.history': '↑↓ move · g/G ends · enter fill · esc close',
   'panel.footer.review': '↑↓ move · enter select · esc back · q close',
@@ -357,6 +412,7 @@ export const en = {
   'panel.jobs.title': '/jobs · background tasks · {count}',
   'panel.resume.deleteTitle': 'permanently delete {target}? this cannot be undone · subagent threads go too',
   'panel.resume.title': '/resume{mode}{search} · {toolbar}',
+  'panel.delete.title': '/delete{search} · {toolbar}',
   'panel.noActiveReminders': 'no active reminders — the model schedules via schedule_create',
   'panel.notMounted': 'not mounted',
   'panel.broken': 'broken: {message}',
@@ -407,7 +463,6 @@ export const en = {
   'panel.provider.notConfiguredDivider': '── not configured ──',
   'panel.provider.title': '/model — providers',
   'panel.provider.titleCount': '/model — providers · {index}/{total}',
-  'panel.provider.state': '{route} · {value}',
   'panel.provider.key': 'key {value}',
   'panel.provider.authConfigured': 'provider auth',
   'panel.provider.noKey': 'key missing',
@@ -422,7 +477,7 @@ export const en = {
   'panel.provider.readOnlyLogin': 'this login record is read-only',
   'panel.provider.notManaged': 'this provider is not managed by Harness settings',
   'panel.providers.compact': '/model providers · enter configure · d remove key · esc back',
-  'panel.providers.footer': '↑↓ move · enter configure · l login · o logout · d remove key · x remove provider · r retry · esc back',
+  'panel.providers.footer': '↑↓ move · enter configure · d remove key · x remove provider · r retry · esc back',
   'panel.update.compact': '/update · {summary}',
   'panel.update.checking': 'checking…',
   'panel.update.probeFailed': 'probe failed',
@@ -450,8 +505,14 @@ export const en = {
   'panel.setup.copyInto': 'copy verbatim into {id}',
   'panel.setup.copyTitle': '/model — copy efforts',
   'panel.setup.copyFooter': '↑↓ move · enter copy · esc back',
+  'panel.setup.mode.subscribe': 'Subscription',
+  'panel.setup.mode.key': 'Key',
+  'panel.setup.mode.login.plan': 'signed in · plan',
+  'panel.setup.mode.login.none': 'not signed in',
+  'panel.setup.mode.login.running': 'signing in…',
+  'panel.setup.mode.overridden': '⚠ the settings key overrides the plan sign-in',
   'panel.setup.title': '/model — configure {provider}',
-  'panel.setup.footer': '↑↓ move · ←→ in/out · space remove · e efforts · c copy efforts · tab discover · enter save · esc back',
+  'panel.setup.footer': '↑↓ move · ←→ in/out · space remove · e efforts · c copy efforts · tab per channel (subscription = web sign-in, key = discover) · enter save · esc back',
   'panel.discovery.compact': 'model discovery · terminal too small · esc back',
   'panel.discovery.loading': 'discovering models…',
   'panel.discovery.empty': 'the endpoint advertised no models; add ids by hand on the setup page',

package/src/locales/zh.ts

@@ -65,7 +65,38 @@ export const zh: MessageCatalog = {
   'search.footer': '↑↓ 移动 · 回车 搜索/恢复 · esc 关闭',
 
   // /statusline panel
+  'header.hint': '/help · Esc 中断 · Ctrl+C 退出',
+  'header.hintResumed': '已恢复 · /help · Esc 中断',
+
   'statusline.title': '/statusline · 选项实时应用到下方状态栏',
+  'statusline.item.model': '模型',
+  'statusline.item.model.desc': '本会话使用的 provider/model',
+  'statusline.item.cwd': '目录',
+  'statusline.item.cwd.desc': '工作目录基名',
+  'statusline.item.mode': '模式',
+  'statusline.item.mode.desc': '当前 agent 预设',
+  'statusline.item.branch': '分支',
+  'statusline.item.branch.desc': '仓库内 git 分支',
+  'statusline.item.context': '上下文',
+  'statusline.item.context.desc': '上下文窗口占用',
+  'statusline.item.permission': '权限',
+  'statusline.item.permission.desc': '权限预设徽章与循环提示',
+  'statusline.item.plan': '计划',
+  'statusline.item.plan.desc': '计划模式标记',
+  'statusline.item.turns': '回合',
+  'statusline.item.turns.desc': '回合与步骤计数',
+  'statusline.item.durations': '耗时',
+  'statusline.item.durations.desc': '模型/首字/解码/工具墙钟',
+  'statusline.item.cache': '缓存',
+  'statusline.item.cache.desc': '计费输入的缓存命中占比',
+  'statusline.item.tokens': '用量',
+  'statusline.item.tokens.desc': '累计输入/输出 token',
+  'statusline.item.title': '标题',
+  'statusline.item.title.desc': '会话标题或短 id',
+  'statusline.item.goal': '目标',
+  'statusline.item.goal.desc': '进行中的目标阶段与轮次',
+  'statusline.item.sandbox': '沙箱',
+  'statusline.item.sandbox.desc': '与预设不同的沙箱覆盖',
 
   // /schedule panel
   'schedule.title': '/schedule · {count} 条活动提醒',
@@ -74,8 +105,15 @@ export const zh: MessageCatalog = {
 
   // Transcript document panel (/resume details)
   'document.loading': '转录加载中…',
+  'attach.bar': '观察模式 · {label} · r 重新载入 · esc/ctrl+d 返回',
+  'attach.loading': '正在载入 {label} 的子会话…',
+  'attach.status': '子代理 {label} · {id} · {turns} 回合',
+  'notice.attachUnavailable': '当前配置无法附加子代理会话',
   'document.compact': '转录 · esc 关闭',
-  'document.footer': '行 {from}-{to}/{total} · ↑↓/pg/g/G · t/esc 关闭',
+  'document.expanded': '全屏',
+  'document.refreshHint': 'r 刷新',
+  'document.footerExpanded': '行 {from}-{to}/{total} · ↑↓/pg/g/G{refresh} · esc/ctrl+d 返回',
+  'document.footer': '行 {from}-{to}/{total} · ↑↓/pg/g/G · enter/f 全屏 · t/esc 关闭',
 
   // /review picker
   'review.picker.title': '/review · 选择审查目标',
@@ -229,12 +267,18 @@ export const zh: MessageCatalog = {
   'status.label.out': '出',
   'status.label.mode': '/mode',
   'status.label.context': '上下文',
+  'status.label.sandbox': '沙箱',
+  'status.plan.on': '计划开',
+  'status.plan.mark': '⧉ 计划',
+  'status.goal.round': '◎ 第 {current}/{max} 轮',
+  'status.goal.phase': '◎ {phase}',
 
   // Frozen band
   'frozen.keysGoTo': '按键交给{owner} · esc {action}',
   'frozen.action.rejects': '拒绝',
   'frozen.action.cancels': '取消',
   'frozen.action.closes': '关闭',
+  'frozen.action.waits': '等待',
 
   // Relative time (panel list timestamps)
   'time.justNow': '刚刚',
@@ -250,6 +294,7 @@ export const zh: MessageCatalog = {
   'notice.themeSaveFailed': '主题保存失败：{message}',
   'notice.languageSaveFailed': '语言保存失败：{message}',
   'notice.alreadyActive': '该会话已是当前会话',
+  'notice.permissionPresetsUnmounted': '当前组合未挂载权限预设',
   'notice.queueCancelled': '已取消排队消息',
   'notice.queueActionFailed': '队列操作失败：{message}',
   'notice.queueUnavailable': '该消息已不在队列中',
@@ -264,6 +309,8 @@ export const zh: MessageCatalog = {
   'notice.usage.animation': '用法：/animation [on|off]',
   'notice.usage.language': '用法：/language [en|zh]',
   'notice.usage.rainbow': '用法：/rainbow [seed]',
+  'notice.usage.bareCommand': '用法：/{name}',
+  'notice.switchInProgress': '正在切换会话 —— 等新会话就绪后再发送，或用 /resume cancel 取消',
   'notice.imageCancelled': '图片提交已取消',
   'notice.themeConfigUnreadable': '主题配置无法读取，使用暗色：{message}',
   'notice.languageConfigUnreadable': '语言配置无法读取，使用英文：{message}',
@@ -294,6 +341,13 @@ export const zh: MessageCatalog = {
   'notice.resumeFailed': '恢复失败：{message}',
   'notice.forkFailed': '分叉失败：{message}',
   'notice.sessionSwitchFailed': '会话切换失败：{message}',
+  'notice.sessionCreated': '已创建 {id} · 模式 {mode}',
+  'notice.sessionResumed': '已恢复 {id} · 模式 {mode}',
+  'notice.sessionSwitchedDirty': '已切换到 {id}，但 {detail}',
+  'notice.flushFailed': '上一会话刷新失败：{message}',
+  'notice.agentReleaseFailed': '上一代理释放失败：{message}',
+  'notice.copyEmpty': '还没有可复制的回复',
+  'notice.copied': '已复制最近一条回复',
   'notice.switchQueued': '当前回合结束后将切换到 {label} · 可用 /resume cancel 取消',
   'notice.reviewStarted': '审查已在只读权限下开始',
   'notice.reviewFailed': '审查失败：{message}',
@@ -347,7 +401,8 @@ export const zh: MessageCatalog = {
   'panel.footer.chooseSelect': '↑↓ 移动 · 回车 选择 · r 刷新 · esc 关闭',
   'panel.footer.inspectDetails': '↑↓ 查看 · 回车 详情 · r 刷新 · esc 关闭',
   'panel.footer.inspectRefresh': '↑↓ 查看 · r 刷新 · esc 关闭',
-  'panel.footer.resume': 'tab/←→ 筛选 · ↑↓/pg 翻页 · ctrl+f 搜索 · e 详情 · t 转录 · d 删除 · 回车恢复',
+  'panel.footer.resume': 'tab/←→ 筛选 · ↑↓/pg 翻页 · ctrl+f 搜索 · e 详情 · t 转录 · 回车恢复',
+  'panel.footer.delete': 'tab/←→ 筛选 · ↑↓/pg 翻页 · ctrl+f 搜索 · e 详情 · t 转录 · 回车删除 · esc 关闭',
   'panel.footer.transcript': '行 {from}-{to}/{total} · ↑↓/pg/g/G · t/esc 关闭',
   'panel.footer.history': '↑↓ 移动 · g/G 首尾 · 回车填入 · esc 关闭',
   'panel.footer.review': '↑↓ 移动 · 回车选择 · esc 返回 · q 关闭',
@@ -359,6 +414,7 @@ export const zh: MessageCatalog = {
   'panel.jobs.title': '/jobs · 后台任务 · {count}',
   'panel.resume.deleteTitle': '永久删除 {target}？此操作无法撤销，子代理线程也会删除',
   'panel.resume.title': '/resume{mode}{search} · {toolbar}',
+  'panel.delete.title': '/delete{search} · {toolbar}',
   'panel.noActiveReminders': '暂无活动提醒——模型通过 schedule_create 创建',
   'panel.notMounted': '未加载',
   'panel.broken': '异常：{message}',
@@ -409,7 +465,6 @@ export const zh: MessageCatalog = {
   'panel.provider.notConfiguredDivider': '── 未配置 ──',
   'panel.provider.title': '/model — 供应商',
   'panel.provider.titleCount': '/model — 供应商 · {index}/{total}',
-  'panel.provider.state': '{route} · {value}',
   'panel.provider.key': '密钥 {value}',
   'panel.provider.authConfigured': '供应商认证',
   'panel.provider.noKey': '缺少密钥',
@@ -424,7 +479,7 @@ export const zh: MessageCatalog = {
   'panel.provider.readOnlyLogin': '该登录记录为只读',
   'panel.provider.notManaged': '该供应商不受 Harness settings 管理',
   'panel.providers.compact': '/model providers · 回车配置 · d 删除密钥 · esc 返回',
-  'panel.providers.footer': '↑↓ 移动 · 回车配置 · l 登录 · o 登出 · d 删除密钥 · x 删除供应商 · r 重试 · esc 返回',
+  'panel.providers.footer': '↑↓ 移动 · 回车配置 · d 删除密钥 · x 删除供应商 · r 重试 · esc 返回',
   'panel.update.compact': '/update · {summary}',
   'panel.update.checking': '检查中…',
   'panel.update.probeFailed': '检查失败',
@@ -452,8 +507,14 @@ export const zh: MessageCatalog = {
   'panel.setup.copyInto': '原样复制到 {id}',
   'panel.setup.copyTitle': '/model — 复制推理档位',
   'panel.setup.copyFooter': '↑↓ 移动 · 回车复制 · esc 返回',
+  'panel.setup.mode.subscribe': '订阅',
+  'panel.setup.mode.key': 'Key',
+  'panel.setup.mode.login.plan': '已登录 · 套餐',
+  'panel.setup.mode.login.none': '未登录',
+  'panel.setup.mode.login.running': '登录中…',
+  'panel.setup.mode.overridden': '⚠ 设置中的 Key 覆盖订阅登录',
   'panel.setup.title': '/model — 配置 {provider}',
-  'panel.setup.footer': '↑↓ 移动 · ←→ 输入/输出 · 空格移除 · e 推理档位 · c 复制推理档位 · tab 发现 · 回车保存 · esc 返回',
+  'panel.setup.footer': '↑↓ 移动 · ←→ 输入/输出 · 空格移除 · e 推理档位 · c 复制推理档位 · tab 按当前方式（订阅=网页登录 / Key=发现） · 回车保存 · esc 返回',
   'panel.discovery.compact': '模型发现 · 终端过窄 · esc 返回',
   'panel.discovery.loading': '正在发现模型…',
   'panel.discovery.empty': '端点未提供模型；请在配置页手动添加 ID',

package/src/{authorization-panel.ts → panels/authorization-panel.ts}

@@ -10,12 +10,12 @@ import {
   type AuthorizationStatus,
 } from '@deepseek-ai/dsh-authorization'
 import type { CredentialKey } from '@deepseek-ai/dsh-credentials'
-import type { ProviderAuthorizationRow } from './authorization.ts'
-import { panelViewport } from './render/inspector.ts'
-import { displayText, singleLineText, truncateColumns } from './render/text.ts'
-import { panelAccent } from './panel-accent.ts'
-import { getPalette, inkColor } from './theme.ts'
-import { t } from './i18n.ts'
+import type { ProviderAuthorizationRow } from '../authorization.ts'
+import { panelViewport } from '../render/inspector.ts'
+import { displayText, singleLineText, truncateColumns } from '../render/text.ts'
+import { panelAccent } from '../ui/panel-accent.ts'
+import { getPalette, inkColor } from '../theme.ts'
+import { t } from '../i18n.ts'
 
 interface PromptReply {
   readonly resolve: (value: string) => void
@@ -25,6 +25,11 @@ interface PromptReply {
 
 export interface ProviderAuthorizationPanelProps {
   readonly row: ProviderAuthorizationRow
+  /**
+   * Start this method immediately instead of showing the picker: a
+   * single-method provider signs in with no extra step.
+   */
+  readonly autoStartMethod?: string
   begin(
     row: ProviderAuthorizationRow,
     method: string,
@@ -75,14 +80,31 @@ export function ProviderAuthorizationPanel(props: ProviderAuthorizationPanelProp
     decline()
   }
 
+  const propsRef = useRef(props)
+  propsRef.current = props
+  const rowKey = props.row.key
+  // One-shot auto start (single-method providers): guarded by a ref so a
+  // remount of the same row cannot start a second attempt.
+  const autoStarted = useRef(false)
+  useEffect(() => {
+    const method = props.autoStartMethod
+    if (method === undefined || autoStarted.current) return
+    autoStarted.current = true
+    if (phase !== 'methods') return
+    if (props.row.methods.some(entry => entry.id === method)) start(method)
+    // One mount-time decision: the auto method, the method list, and the
+    // phase are fixed for this mount, so re-running on their identity would
+    // risk starting a second attempt.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [props.autoStartMethod])
   useEffect(() => () => {
     controllerRef.current?.abort()
-    props.cancel(props.row.key)
+    propsRef.current.cancel(rowKey)
     const reply = replyRef.current
     replyRef.current = undefined
     reply?.detach()
     reply?.reject(new AuthorizationDeclinedError())
-  }, [props.row.key])
+  }, [rowKey])
 
   const start = (method: string): void => {
     setPhase('running')

package/src/panels/completion-panel.ts

@@ -0,0 +1,79 @@
+/** Bounded slash-command and mention completion menu. */
+
+import { createElement, type ReactElement } from 'react'
+import { Box, Text, useStdout } from 'ink'
+import type { CompletionCandidate } from '../completion.ts'
+import { selectionWindow } from '../render/inspector.ts'
+import { visibleColumns } from '../render/markdown.ts'
+import { displayText, padColumns, singleLineText, truncateColumns } from '../render/text.ts'
+import { dim, getPalette, inkColor } from '../theme.ts'
+
+/** Shared geometry used by both the menu view and the App dynamic-row budget. */
+function completionMenuMetrics(terminalRows: number): { limit: number; showFooter: boolean; verticalPadding: number } {
+  const showFooter = terminalRows >= 12
+  const verticalPadding = terminalRows >= 14 ? 1 : 0
+  const limit = Math.max(1, Math.min(6, terminalRows - (showFooter ? 11 : 10) - verticalPadding * 2))
+  return { limit, showFooter, verticalPadding }
+}
+
+/** Total physical rows occupied by the completion menu at this terminal height. */
+export function completionMenuRowCount(terminalRows: number, rowCount: number): number {
+  const { limit, showFooter, verticalPadding } = completionMenuMetrics(terminalRows)
+  const visible = rowCount === 0 ? 1 : Math.min(rowCount, limit)
+  const hidden = rowCount === 0 ? 0 : rowCount - visible
+  return visible + (hidden > 0 ? 1 : 0) + (showFooter ? 1 : 0) + verticalPadding * 2
+}
+
+/** Completion view anchored directly above the composer band. */
+export function CompletionMenu({ active, mention, index, rows, error }: {
+  active: boolean
+  mention: boolean
+  index: number
+  rows: readonly CompletionCandidate[]
+  error?: string
+}): ReactElement | undefined {
+  const stdout = useStdout().stdout
+  const columns = stdout?.columns ?? 80
+  const terminalRows = stdout?.rows ?? 30
+  if (!active) return undefined
+  const contentColumns = Math.max(1, columns - 4)
+  const nameWidth = mention
+    ? Math.max(1, contentColumns - 2)
+    : Math.min(18, Math.max(1, contentColumns - 2), Math.max(0, ...rows.map(row => visibleColumns(row.label))) + 2)
+  const descBudget = Math.max(0, contentColumns - nameWidth - 2)
+  const { limit, showFooter, verticalPadding } = completionMenuMetrics(terminalRows)
+  const selected = rows.length === 0 ? 0 : index % rows.length
+  const first = selectionWindow(selected, rows.length, limit)
+  const visible = rows.slice(first, first + limit)
+  const hidden = rows.length - visible.length
+  return createElement(
+    Box,
+    { flexDirection: 'column', marginLeft: 2, paddingY: verticalPadding },
+    ...(rows.length === 0
+      ? [error === undefined
+        ? createElement(Text, { key: 'loading', dimColor: true }, 'searching…')
+        : createElement(
+          Text,
+          { key: 'error', color: inkColor(getPalette().error), wrap: 'truncate-end' },
+          truncateColumns(`workspace search unavailable: ${singleLineText(error)} · keep typing to retry`, contentColumns),
+        )]
+      : visible.map((candidate, at) => {
+        const absolute = first + at
+        return createElement(
+          Text,
+          {
+            key: candidate.label,
+            color: absolute === selected ? inkColor(getPalette().brandBright) : inkColor(getPalette().dim),
+            wrap: 'truncate-end',
+          },
+          `${absolute === selected ? '❯ ' : '  '}${padColumns(candidate.label, nameWidth)}${dim(truncateColumns(displayText(candidate.description), descBudget))}`,
+        )
+      })),
+    hidden > 0
+      ? createElement(Text, { key: 'more', color: inkColor(getPalette().dim), wrap: 'truncate-end' }, `  … +${hidden} more`)
+      : undefined,
+    showFooter
+      ? createElement(Text, { color: inkColor(getPalette().dim), wrap: 'truncate-end' }, dim(mention ? `↑↓ choose · ${rows.length} items · tab insert` : `↑↓ choose · ${rows.length} items · tab complete`))
+      : undefined,
+  )
+}