@x-otto/tui 0.0.1-alpha.9 → 0.1.0-alpha.9

package/README.md

@@ -2,7 +2,7 @@
 
 ## Module Purpose
 
-The terminal UI application layer: a React + Ink component tree that provides streaming Markdown rendering, permission dialogs, input stack, message flow, and the full terminal interaction experience. Built on the npm `ink` v7 rendering engine and the `@x-otto/keybindings` keypress system.
+The terminal UI application layer: a React + Ink component tree that provides streaming Markdown rendering, permission dialogs, input stack, message flow, and the full terminal interaction experience. Built on the npm `ink` v7 rendering engine, with keybinding, theme, and fuzzy-search systems living in-package (`src/keybindings`, `src/theme`, `src/search`).
 
 ## Installation
 
@@ -18,23 +18,23 @@ import { startTui } from '@x-otto/tui'
 const tui = await startTui({
   stdin: process.stdin,
   stdout: process.stdout,
-  onMessage: async (msg) => { /* send to agent */ },
+  onSubmit: (text) => { /* send to agent */ },
 })
 
-tui.pushMessage({ role: 'assistant', content: 'Hello! I am otto.' })
-tui.showToast('Task completed')
+tui.messages.pushMessage({ role: 'assistant', content: 'Hello! I am otto.' })
+tui.info.showToast('Task completed', 'Done')
 
-await tui.dispose()
+tui.lifecycle.stop()
 ```
 
 ## Core Features
 
 | Module            | Function                                                    |
 | --------------- | ------------------------------------------------------- |
-| Store           | Application state management (zustand-driven, useAppState / createStore) |
+| Store           | Application state management (zustand-driven, useAppState / makeStore) |
 | Input           | Input stack: Cursor model + InputBuffer + History + Typeahead |
-| Messages        | Message flow: StreamState + QueryGuard + Collapse + Diff      |
-| Dialogs         | Dialog arbitration: permission queue + Select state machine + dialog components |
+| Messages        | Message flow: stream commit/coalesce + QueryGuard + Collapse + Diff |
+| Dialogs         | Dialog arbitration: routed permission dialogs + Select state machine + dialog components |
 | Components      | Common components: App / Welcome / StatusBar / Spinner / Button / DataList |
 | Term            | Terminal primitives: BracketedPaste / OSC 8/52 / SyncFrame |
 | Theme           | Color palette + icon glyphs + spinner frames + theme preset registry |
@@ -46,10 +46,8 @@ await tui.dispose()
 
 | Component          | Function                          |
 | ------------------ | ----------------------------- |
-| BaseTextInput      | Base text input (cursor/edit/paste) |
+| TextInput          | Text input (cursor/edit/paste) |
 | PromptInput        | Main prompt input box                  |
-| PromptInputFooter  | Input box status footer              |
-| HistorySearchInput | History search input |
 | QueuedCommands     | Queued command display             |
 
 ## Message Rendering
@@ -57,37 +55,44 @@ await tui.dispose()
 | Component          | Function                          |
 | ------------------ | ----------------------------- |
 | Message            | Message container (role/collapse/branch)    |
-| Markdown           | Static Markdown rendering             |
-| StreamingMarkdown  | Streaming Markdown rendering (flicker-free) |
-| StructuredDiff     | Structured diff rendering             |
-| HighlightedCode    | Syntax-highlighted code blocks |
-| ToolUseLoader      | Tool call loading animation             |
 | REPLRegion         | REPL message region container             |
+| renderMessageLines | Line-based message rendering (streaming-aware) |
+| renderMarkdownToLines | Markdown → ANSI line rendering       |
+| preloadHighlighter / highlightBlock | Syntax-highlighted code blocks |
 
 ## Directory Overview
 
 ```
 src/
-  types.ts           # TUI-local type stubs (no dependency on @x-otto/ai)
-  theme.ts           # THEME / PALETTE / FIGURES / SPINNER_FRAMES
-  startTui.tsx       # production entry point
-  print-messages.ts   # print mode
-  compat.ts          # backward-compatibility (legacy API shim)
-  index.ts           # barrel export
-  store/             # application state management
-  term/              # terminal primitives (paste/keys/OSC)
-  input/             # input stack (Cursor/Buffer/History/Typeahead)
-  messages/          # message flow (Stream/QueryGuard/Collapse/Diff)
-  dialogs/           # dialogs (Permission/Select/Arbiter)
-  components/        # common components (App/Welcome/StatusBar/Spinner)
-tests/               # 20 test files
+  types.ts             # TUI-local type stubs (no dependency on @x-otto/ai)
+  theme.ts             # THEME / PALETTE / FIGURES / SPINNER_FRAMES
+  main.ts              # production entry point (startTui)
+  compat.ts            # backward-compatibility (legacy API shim)
+  index.ts             # barrel export
+  stores/              # application state (zustand: message/stream/task/context/...)
+  term/                # terminal primitives (paste/keys/OSC/sync/scrollback)
+  input/               # input stack (Cursor/Buffer/History/Typeahead)
+  messages/            # message flow (commit/QueryGuard/Collapse/Diff)
+  dialogs/             # dialogs (Permission/Select/Confirm/Alert/...)
+  components/          # common components (App/Welcome/StatusBar/Spinner)
+  panes/               # side panes (Context/Task/Subagents/Sigil/Schedule/...)
+  router/ + routes/    # router-driven views & modal routes (FocusBus/Router/Tabable)
+  overlays/            # overlay components
+  status-bar/          # status bar widgets (provider usage badge, background tasks)
+  keybindings/         # keybinding parsing & overrides
+  history/             # shell history parsing (zsh/bash/fish)
+  search/              # fuzzy search
+  sigil/               # #/@ sigil input completion
+  bootstrap/           # TuiHandle/TuiOptions types + session data-source bridges
+  app/                 # App shell assembly (input/dialog/panel/status regions)
+tests/               # 385 test files
 ```
 
 ## Public Exports
 
 ```ts
 // State management
-export { createStore, useAppState }
+export { useAppState, makeStore }
 export type { Store }
 
 // Terminal primitives
@@ -99,17 +104,18 @@ export { insertHistory, preWrapLine, displayWidth, guardScrollbackStdout }
 export { Cursor, MeasuredText, stringWidth }
 export { createInputBuffer, createInputHistory, createPasteStore }
 export { createCommandRegistry, getCommandSuggestions, applySlashCompletion }
-export { TextInput, PromptInput, QueuedCommands, HistorySearchInput }
+export { TextInput, PromptInput, QueuedCommands }
 export type { InputBuffer, BufferEntry }
 
 // Message flow
-export { createStreamState, reduceStreamEvent, reduceStreamEvents }
+export { safeCommitBoundary, initStreamCommit, streamCommitStep, makeCoalescer }
 export { createQueryGuard, collapseMessages, toggleCollapse, expandCollapsed }
-export { Markdown, Message, REPLRegion, StructuredDiff, ToolUseLoader, StreamingMarkdown }
+export { Message, REPLRegion }
+export { renderMessageLines, renderMarkdownToLines, preloadHighlighter, highlightBlock }
 export { registerPluginRenderers, clearPluginRenderers }
 
 // Dialogs
-export { createDialogArbiter, createPermissionQueue, createSelectState }
+export { createSelectState }
 export { Select, PermissionDialogDialog, BashPermissionDialog, ConfirmDialog, AlertDialog, PromptDialog, MemoryDialog }
 
 // Components
@@ -124,9 +130,6 @@ export type { ThemePreset, ThemePresetInput, ThemePresetSelection, ThemeAppearan
 // Search
 export { rankCandidates, rankNamedItems, rankLabeledItems, createIncrementalSearcher }
 
-// Inspect
-export { createInspectorStore, InspectorPane, buildEventTree, buildToolList }
-
 // i18n
 export { detectLanguage, t, i18next, initI18n }
 export type { Lang, LangMode }
@@ -147,4 +150,4 @@ pnpm --filter @x-otto/tui clean
 
 ## Related Packages
 
-`@x-otto/keybindings`
+`@x-otto/interchange`, `@x-otto/session-contract`, `@x-otto/shared`, `@x-otto/env`

package/dist/{Tabable-BIsfZJSG.d.ts → Tabable-BRz398OB.d.ts}

@@ -91,6 +91,8 @@ interface SummaryMessage {
   tasksTotal?: number;
   /** 回合完成时刻（epoch ms，cli 侧 reducer 生成）。摘要行末尾灰色渲染 "YYYY-MM-DD HH:MM:SS"。 */
   completedAt?: number;
+  /** 错误终止时的错误消息（status='error' 时），摘要行下方红色渲染错误详情。 */
+  errorMessage?: string;
   id?: string;
 }
 /**
@@ -148,8 +150,7 @@ interface PruneBoundaryMessage {
  * 死历史（R12 压缩前置保证），但压缩连续失败后的兜底裁剪（`lossy`）会真实削减模型上下文，
  * 此时该表述不成立，必须按 lossy 分型提示。**RFC-159 起持久层为
  * append-forever**：默认 SQLite 后端从不因此裁剪删除已持久化的 DB 行，被移出内存视图的
- * 消息仍完整保留在存储中（`/session export` 可导出全量）；仅已废弃的 `OTTO_SESSION_BLOB=1`
- * 逃生口后端会整份快照覆写、导致真实数据丢失。携带具体条数（`removedCount`）供用户感知
+ * 消息仍完整保留在存储中（`/session export` 可导出全量）。携带具体条数（`removedCount`）供用户感知
  * 内存视图收窄的范围。
  */
 interface HistoryCappedMessage {
@@ -296,6 +297,17 @@ interface AppNotification {
   /** 可选操作（如 "/delegates"、"/extension"，enter 时触发）。 */
   action?: string;
 }
+/** 待决权限请求 */
+interface PendingPermission {
+  id: string;
+  tool: string;
+  input: string;
+  risk?: 'low' | 'medium' | 'high';
+  /** 模型生成的命令解释文本 */
+  description?: string;
+  /** bash「始终允许」拟持久化的命令前缀（如 `git status`），弹窗显式呈现给用户。 */
+  alwaysAllowLabel?: string;
+}
 /**
  * RFC-186 D3：暂停浮层数据项。notificationStore.pauseDialog 非 null 时 App.tsx 渲染
  * PauseDialog 组件。两个阶段：requested（等待 turn 边界）+ active（已暂停）。
@@ -449,7 +461,8 @@ declare const DEFAULT_FIGURES: {
   readonly gaugeFilled: "━"; /** LineGauge 未完成段 ╌ */
   readonly gaugeRest: "╌"; /** Scrollbar thumb 右半块 ▐ */
   readonly scrollThumb: "▐"; /** 委托任务识别到的服务前缀 ↕ */
-  readonly service: "↕"; /** 已编辑文件标记 ✎（RFC-309 SummaryStrip） */
+  readonly service: "↕"; /** SignalBar services 信号前缀 ⇢（RFC-377 D4，与 delegates 的 ↕ 不同形） */
+  readonly serviceSignal: "⇢"; /** 已编辑文件标记 ✎（RFC-309 SummaryStrip） */
   readonly edited: "✎"; /** 定时/计划任务标记 ◷（RFC-309 SummaryStrip） */
   readonly scheduled: "◷"; /** 剪贴板信号 ✓（复制成功提示） */
   readonly clipboard: "✓"; /** LLM 调用阶段箭头：requesting ↑，responding ↓ */
@@ -482,8 +495,8 @@ declare const PANEL_BORDER: {
  * **单一真源**：所有经 DialogFrame 呈现的弹层写此常量。历史上曾有 `BORDER_VARIANTS`
  * 三档（hard/nav/overlay）按界面层级分不同形态（RFC-183 D1），但 2026-07-22 commit
  * 9466cb7c9「统一所有弹层为四边圆角」有意将三档收敛为同一形态；RFC-266 D1 据此删除
- * 无差异的 variant API，收敛为本单一常量（语义分层由 focus-registry band 承载，边框层
- * 不再重复编码）。将来若需按层级再分化边框，以新 RFC 重新设计，不保留投机性 API。
+ * 无差异的 variant API，收敛为本单一常量（界面层级语义分层已由路由层焦点归属单一判定
+ * 承载，边框层不再重复编码）。将来若需按层级再分化边框，以新 RFC 重新设计，不保留投机性 API。
  */
 declare const DIALOG_BORDER: {
   readonly borderStyle: "round";
@@ -610,16 +623,16 @@ interface Store<T> {
 }
 declare function useAppState<T, R>(store: Store<T>, selector: (state: T) => R): R;
 //#endregion
-//#region src/stores/perf-store.d.ts
+//#region src/stores/status-store.d.ts
 /** 内存快照——字段对齐 `@x-otto/coding` 的 `MemorySample`（不直接 import 跨包类型，
- *  tui 包不依赖 coding 包，由 cli 层组装时结构对齐即可，见 RFC-116 D2）。 */
+ *  tui 包不依赖 coding 包，由 cli 层组装时结构对齐即可）。 */
 interface PerfMemorySnapshot {
   level: 'healthy' | 'warning' | 'critical';
   heapUsed: number;
   heapSizeLimit: number;
   usedPct: number;
 }
-/** 渲染健康度快照——字段对齐 `NotifyStats`（M2 里程碑填充，M1 阶段为 undefined）。 */
+/** 渲染健康度快照——字段对齐 `NotifyStats`。 */
 interface PerfNotifySnapshot {
   coalescedCalls: number;
   coalescedFires: number;
@@ -630,43 +643,50 @@ interface PerfNotifySnapshot {
 }
 /**
  * 单个插件采集器的结果。
- * RFC-118 小修（S10）：原 RFC-116 D2 的手动镜像定义已收口——类型本体上移
- * `@x-otto/interchange`（coding 生产侧同源），此处别名保持 tui 内既有消费方命名兼容。
+ * RFC-118 小修（S10）：类型本体上移 `@x-otto/interchange`，此处别名保持兼容。
  */
 type PluginMetricResult = _$_x_otto_interchange0.PluginPerfMetricResult;
-interface PerfPaneState {
+/** Session 概览快照——由 CLI 层 handleStatus 从 AgentSession 实时采集。 */
+interface StatusSessionSnapshot {
+  title: string;
+  sessionId: string;
+  modelId: string;
+  messageCount: number;
+  occupancy: number;
+  contextWindow: number | undefined;
+  occupancyPct: number | undefined;
+  cumOutput: number;
+  writeLeaseReadOnly: boolean;
+  isPaused: boolean;
+}
+interface StatusPaneState {
+  /** Session 概览——面板打开/刷新时采集。undefined = 尚未采集。 */
+  session: StatusSessionSnapshot | undefined;
   memory: PerfMemorySnapshot | undefined;
-  /** 内存采样历史（RFC-183 M4：PerfPane sparkline 趋势，环形窗口 ≤32 点，heapUsed 字节）。 */
+  /** 内存采样历史（sparkline 趋势，环形窗口 ≤32 点，heapUsed 字节）。 */
   memoryHistory: number[];
-  /** M1 阶段恒为 undefined（渲染区占位）；M2 起由 CLI 层喂入真实值。 */
   notify: PerfNotifySnapshot | undefined;
   /**
-   * RFC-116 M3：footer 常驻指示器的实时分级——与 `memory`（面板手动刷新快照）解耦，
-   * 因为 footer 需要"异常时才浮现、健康时零宽度"的常驻感知（不依赖用户是否打开过
-   * `/perf` 面板），由 `MemoryGovernor.onLevelChange` 回调驱动（每次分级变化都推送，
-   * 含恢复到 healthy 的方向）。初始为 'healthy'（保守假设，避免启动瞬间误报）。
+   * footer 常驻指示器的实时分级——与面板数据解耦，
+   * 由 `MemoryGovernor.onLevelChange` 回调驱动。初始为 'healthy'。
    */
   indicatorLevel: 'healthy' | 'warning' | 'critical';
-  /**
-   * RFC-116 M5：插件贡献的性能采集器结果——手动刷新时喂入（对齐 D7 手动刷新决策，
-   * 不做自动轮询）。空数组 = 无插件贡献采集器或本次刷新尚未获取，两者在渲染层
-   * 不做区分（均不显示该区块），因为区分"无贡献"与"未刷新"对用户价值不大。
-   */
+  /** 插件贡献的性能采集器结果——手动刷新时喂入（不做自动轮询）。 */
   pluginMetrics: PluginMetricResult[];
 }
-interface PerfStore {
-  store: Store<PerfPaneState>;
-  /** /clear 会话重置——全字段回初始值（indicatorLevel 回 'healthy' 保守假设）。
-   *  RFC-256 收尾：面板可见性已改由 Router 栈单一真源派生（isInStack('/pane/perf')），
-   *  store 不再持 `open` 布尔——原 toggle() 已删除。 */
+interface StatusStore {
+  store: Store<StatusPaneState>;
+  /** /clear 会话重置——全字段回初始值。 */
   reset(): void;
-  /** CLI 喂入最新内存快照（面板手动刷新）。 */
+  /** CLI 喂入 session 概览快照（面板打开/刷新时）。 */
+  setSession(snapshot: StatusSessionSnapshot): void;
+  /** CLI 喂入最新内存快照。 */
   setMemory(snapshot: PerfMemorySnapshot): void;
-  /** CLI 喂入最新渲染健康度快照（M2 起使用；M1 阶段调用方不传，保持 undefined）。 */
+  /** CLI 喂入最新渲染健康度快照。 */
   setNotify(snapshot: PerfNotifySnapshot): void;
-  /** CLI 喂入 footer 常驻指示器的最新分级（`MemoryGovernor.onLevelChange` 驱动）。 */
+  /** CLI 喂入 footer 常驻指示器的最新分级。 */
   setIndicatorLevel(level: 'healthy' | 'warning' | 'critical'): void;
-  /** CLI 喂入最新插件采集器结果（手动刷新触发）。 */
+  /** CLI 喂入最新插件采集器结果。 */
   setPluginMetrics(results: PluginMetricResult[]): void;
 }
 //#endregion
@@ -1233,7 +1253,7 @@ interface PasteStore {
   /** 当前 store 占用字节数（LRU 容量判据的另一维度）。 */
   readonly bytesUsed: number;
   /** 累计驱逐次数（LRU 超限淘汰 + 内存紧张分级用完即释放，两者都计数）。纯计数器，不驱动
-   *  任何行为，供未来 `/perf` 面板或调试场景观测。 */
+  * 任何行为，供未来 `/status` 面板或调试场景观测。 */
   readonly evictionCount: number;
   /**
    * 清空全部映射。
@@ -1370,7 +1390,8 @@ interface SigilSearchRegistry {
 type SubmitMode = 'send' | 'bash' | 'bash_async' | 'memory';
 interface PromptInputProps {
   columns?: number;
-  /** RFC-306 后修复（光标锚定）：终端总行数——用于把光标锚定到输入行（Ink 输出原点相对坐标）。 */
+  /** RFC-306 遗留 prop：终端总行数。RFC-311 起光标锚定改由 useMeasuredCursorOrigin
+   *  布局实测（见 computeCursorInline），本 prop 已不再被读取。 */
   rows?: number;
   placeholder?: string;
   /** RFC-294 D7：真禁用（强制升级/确认框占据交互）→ 塌缩为单行提示。 */
@@ -1378,15 +1399,19 @@ interface PromptInputProps {
   /** RFC-300 优化：回看态（滚动回看中）——保留完整外观（不塌缩），仅不注册键盘
    *  （滚动独占）且不渲染光标。区别于 disabled：disabled 塌缩，reviewing 不塌缩。 */
   reviewing?: boolean;
-  /** 空闲提示卡片是否可见——卡片在输入框上方占 3+ 行且有 480ms 动画，
-   *  出现时物理光标隐藏（光标残影防护）。 */
+  /** 空闲提示卡片是否可见（卡片在输入框上方占 3+ 行且有 480ms 动画）。
+   *  注意：本 prop **不参与**物理光标 gate——早期曾用于"出现时隐藏光标（残影防护）"，
+   *  后确认是 bug（setCursorPosition(undefined) 会把 IME 候选框甩到状态栏下），
+   *  见 cursorActive 处注释；prop 保留仅为外部调用方兼容。 */
   idleTipVisible?: boolean;
   /** 斜杠命令表（typeahead 数据源） */
   commands?: CommandEntry[];
-  /** force=true 表示修饰键+Enter（Alt/Ctrl/Cmd）——上层据此映射为 followUp/排队;plain Enter→steer/send。 */
   /**
    * 提交回调。
    *
+   * `force=true` 表示修饰键+Enter（Alt/Ctrl/Cmd）——上层据此映射为 followUp/排队；
+   * plain Enter → steer/send。
+   *
    * 返回 `'rejected'` 表示宿主**拒绝了本次提交**（如 FTUE 未就绪、无可用模型），
    * 此时输入框**保留原文**，用户修完配置可直接重发（RFC-326 §6.7：
    * "未发出的 prompt 保留在输入框"）。返回 void/其它值一律按已受理处理并清空。
@@ -1447,6 +1472,20 @@ interface PromptInputProps {
     current: {
       fill: (text: string) => void;
       append?: (text: string) => void;
+      /**
+       * 当前草稿是否为空（trim 后）。供 App 级数字键分支做前置门——Home 建议 chips /
+       * 能力推荐卡的 `[1]`-`[3]` 是**空输入框专属**快捷键：这些 handler 挂在
+       * `PRIORITY_APP_FALLBACK`（低于 prompt-input 的 FALLBACK 层），而 PromptInput 的
+       * 字符插入路径**不消费**按键（返回 void），于是数字键会一路冒泡下来。若不看草稿
+       * 状态，用户打字到一半按 `1` 会先插入 `1`、再被 `fill()` 整段覆盖成建议文案。
+       */
+      isEmpty?: () => boolean;
+      /**
+       * 在光标处插入换行（2026-08 键位重设计：Shift+Enter 换行）。供 enter-family
+       * 旁路（onShiftEnter → main.ts ref → 本方法）调用——裸 `\n` 字节在 Ink 键层
+       * 不可识别（与 F1-F12 同为「空 input 无修饰」），必须走命令式桥。
+       */
+      insertNewline?: () => void;
     } | null;
   };
   /**
@@ -1705,6 +1744,11 @@ interface TaskState {
   clipboardText: string;
   /** 复制写入两路通道均失败（SignalBar 显示失败兜底信号，非 Toast）。TTL 后归零。 */
   clipboardFailed: boolean;
+  /** 失败信号的分诊原因（RFC-486 D3）：'tool-missing' = Linux 无剪贴板工具且
+   *  OSC52 在此终端无效（SignalBar 给安装指引）；'native-hint' = 其他失败
+   *  （给终端原生选择修饰键指引）；undefined = 无失败态。与 clipboardFailed
+   *  同生命周期（同时置/同时清）。 */
+  clipboardFailedReason: 'tool-missing' | 'native-hint' | undefined;
   /** 刚复制成功的短时脉冲态（~1.5s，独立于 clipboardChars 12s TTL）——SignalBar
    *  剪贴板信号在此窗口内渲染绿底 + ✓，随后回落为常态 ✓ 已复制 N（同一 12s 窗口内）。
    *  纯 React 状态驱动的 Typography backgroundColor，不涉及选区层直写 stdout。 */
@@ -1769,6 +1813,20 @@ interface TaskState {
    * 拒绝过某个扩展）。
    */
   capabilityDismissed: boolean;
+  /**
+   * 版本更新提示（cli 侧 `checkForUpdate()` 启动异步检查的产出，经
+   * `setUpdateAvailable` 单向下推）。与 Home 首屏 `welcome.updateAvailable`
+   * 同构——后者是启动期静态快照（cli 侧一直传 undefined，从未接线），本字段是
+   * 运行时真源：检测到新版后 Home 版本行右侧渲染常驻横幅
+   * （`update.availableBanner`/`update.forcedBanner`）。`undefined` = 已是最新/
+   * 尚未检出（不渲染横幅）。
+   */
+  updateAvailable: {
+    latest: string;
+    current: string;
+    newer: boolean;
+    forced: boolean;
+  } | undefined;
 }
 interface TaskStore {
   store: Store<TaskState>;
@@ -1782,7 +1840,7 @@ interface TaskStore {
   /**
    * 注入副作用钩子（RFC-335 T335-07 前置 P0a）。原 TuiHandle 残留 setter 是"字段 setter
    * + 副作用"混合体（如 setForcedUpgrade = setState + syncOverlayRoute + notify）——
-   * 直接变纯 action 会丢副作用。setEffects 把副作用接入口子化注入（仿 setNotify 的
+   * 直接变纯 action 会丢副作用。setEffects 把副作用接入口注入（仿 setNotify 的
    * post-creation 注入范式），store 层不 import 树外 ref（routerRef/plugin registry），
    * 由 main.ts 接线处把闭包函数传进来。未注入时副作用为 no-op（对齐 notify 防过早调用）。
    */
@@ -1795,7 +1853,7 @@ interface TaskStore {
   actions: TaskActions;
 }
 /**
- * taskStore 副作用接入口子。注入方（main.ts）把闭包函数绑进来——这些闭包内部可
+ * taskStore 副作用接入口。注入方（main.ts）把闭包函数绑进来——这些闭包内部可
  * `getRouterRef()` 取真 router / `registerPlugin` 调中央 registry，故接口不把 router/
  * registry 作为参数传递（保持 store 层不引用任何树外类型）。这是"store 不依赖树外
  * 全局"的类型层体现（P0c 先导）。
@@ -1833,6 +1891,12 @@ interface TaskActions {
   setCapabilityRecommendations(items: TaskState['capabilityRecommendations']): void;
   /** RFC-326 §6.6 / M5-02：用户按 "Not now" 关闭能力推荐卡（本会话瞬态，不持久化）。 */
   dismissCapabilityRecommendations(): void;
+  /**
+   * 版本更新提示单向下推（cli 侧 `applyUpdateCheckResult` 调用）。传 null/undefined
+   * 清除（理论上是已升级至最新后的复位路径，当前无调用方——Home 横幅只在值非空时
+   * 渲染，清除可留空）。
+   */
+  setUpdateAvailable(info: TaskState['updateAvailable']): void;
   setPermissionMode(mode: string): void;
   /** 强制升级提示（RFC-335 P0a 自 TuiHandle.setForcedUpgrade 下沉）：字段 + overlay 路由 + notify。 */
   setForcedUpgrade(msg: string | null): void;
@@ -1863,9 +1927,9 @@ interface BudgetView {
   totalUsed: number;
   /** 可用 token = contextWindow − overhead − messages（三段恒闭合；正常态 = window − totalUsed）。 */
   free: number;
-  /** prune 触发线 token 数（70% contextWindow）。 */
+  /** prune 触发线 token 数（派生自 memory 的 DEFAULT_PRUNE_CONFIG，200K 窗口≈60%）。 */
   pruneLine: number;
-  /** compact 触发线 token 数（85% contextWindow）。 */
+  /** compact 触发线 token 数（派生自 memory 的 DEFAULT_COMPACTION_CONFIG，200K 窗口≈80%）。 */
   compactLine: number;
   /** 最近一轮 input（非 cache 部分，API 返回）。 */
   lastInput: number;
@@ -2075,8 +2139,8 @@ interface NotificationStore {
   setPulseSurvey(item: NotificationState['pulseSurvey']): void;
 }
 /**
- * notificationStore 副作用接入口子。注入方（main.ts）闭包内取真 router / drainQueue —
- * —接口不暴露树外类型，与 taskStore 同款。
+ * notificationStore 副作用接入口。注入方（main.ts）闭包内取真 router / drainQueue，
+ * 接口不暴露树外类型，与 taskStore 同款。
  */
 interface NotificationStoreEffects {
   /** paused 由 true→false 时尝试出队（原 inline 的 drainQueue()）。 */
@@ -2282,6 +2346,25 @@ interface ExtensionDetailRequest {
   /** 执行某控制按钮（value）。 */
   onAction: (value: string) => void;
   onClose: () => void;
+  /**
+   * RFC-401 M3：插件配置表单数据。提供时在 DataList 之后渲染配置字段展示，
+   * 并在 actions 末尾追加"编辑配置"按钮（触发 onEditConfig 回调）。
+   * 编辑 UI 由宿主侧独立实现（经 updatePluginConfig 写入 PluginConfigStore）。
+   */
+  configForm?: {
+    /** manifest 声明的 config schema 片段（JSON Schema 子集，含 properties/type/description）。 */schema: {
+      type?: string;
+      description?: string;
+      properties?: Record<string, {
+        type?: string;
+        description?: string;
+        default?: unknown;
+        enum?: unknown[];
+      }>;
+    }; /** 当前配置值（合并 manifest 默认值 + PluginConfigStore 持久化值后）。 */
+    values: Record<string, unknown>; /** 点击"编辑配置"按钮时调用（宿主侧打开编辑 UI 或直接写入）。 */
+    onEditConfig?: () => void;
+  };
 }
 //#endregion
 //#region src/dialogs/FileViewerDialog.d.ts
@@ -2760,6 +2843,12 @@ type TuiStreamEvent = {
   notify?: PerfNotifySnapshot;
   indicatorLevel?: 'healthy' | 'warning' | 'critical';
   pluginMetrics?: PluginMetricResult[];
+} | {
+  kind: 'status';
+  session?: StatusSessionSnapshot;
+  memory?: PerfMemorySnapshot;
+  notify?: PerfNotifySnapshot;
+  pluginMetrics?: PluginMetricResult[];
 } | ({
   kind: 'compactionLog';
   entryKind: 'compact';
@@ -2780,10 +2869,13 @@ type TuiStreamEvent = {
  * 提交意图（前端无关语义层）：cli 据此决定如何处理一次提交。
  *   - 'send'  : 起新回合（空闲时的普通提交，或斜杠命令分发）。
  *   - 'steer' : agent 运行中时注入当前回合（session.steer）。
+ *   - 'action': 纯 action chip（[@model:...]/[@effort:...] 单独提交）——切换模型/档位的
+ *               命令语义，不走 busy 分流、不注入对话流（终局设计 2026-08-14，见
+ *               submit-routing.ts isPureActionChip）。
  * followUp/排队 由 TUI 自身的 state.queued 承载（空闲即出队），不经此枚举。
  * 后续移植 GUI：同一 intent 层，GUI 直接绑 Enter→steer / Cmd+Enter→followUp，语义零改。
  */
-type SubmitIntent = 'send' | 'steer';
+type SubmitIntent = 'send' | 'steer' | 'action';
 /**
  * RFC-148 M3：模态对话框判别联合——收敛原 TuiHandle 9 个独立 open* 方法
  * （openInfo/openPermissions/openContext/openMemory/openSelect/openExtensionDetail/
@@ -2872,13 +2964,6 @@ interface ProgressDialogProps {
   /** 四个阶段标签 */
   phases: string[];
 }
-/** Setup 向导弹窗请求（openModal({kind:'wizard',...}) 入参）。 */
-/**
- * OAuth 流程句柄——向导内嵌授权，不跳转独立面板。
- * RFC-274 M2：补 `code`/`instructions`（对齐真实 `OAuthInfo` 字段），供等待态渲染
- * device-flow 场景（有 code 展示设备码 UI，无 code 展示纯浏览器 UI）——不在选项列表层
- * 区分 pkce/device-flow，只在这个等待态句柄层区分。
- */
 /**
  * OAuth 轮询失败分类（RFC-326 §6.3）——决定 UI 给出哪个主 CTA。
  *  - `network`：连不上授权服务（含代理不通）→ 主 CTA 为「打开代理设置」
@@ -2893,6 +2978,12 @@ type OAuthPollResult = 'pending' | 'done' | 'error' | {
   status: 'error';
   reason: OAuthFailureReason;
 };
+/**
+ * OAuth 流程句柄——向导内嵌授权，不跳转独立面板。
+ * RFC-274 M2：补 `code`/`instructions`（对齐真实 `OAuthInfo` 字段），供等待态渲染
+ * device-flow 场景（有 code 展示设备码 UI，无 code 展示纯浏览器 UI）——不在选项列表层
+ * 区分 pkce/device-flow，只在这个等待态句柄层区分。
+ */
 interface OAuthHandle {
   authorizationUrl: string;
   /** 设备码流程的 user code（`OAuthInfo.code`）；pkce 浏览器流程通常为空。 */
@@ -2920,6 +3011,7 @@ interface OAuthHandle {
    */
   openAgain?: () => void;
 }
+/** Setup 向导弹窗请求（openModal({kind:'wizard',...}) 入参）。 */
 interface WizardRequest {
   kind: 'wizard';
   title: string;
@@ -2975,7 +3067,7 @@ interface WizardRequest {
     value: string;
     detail?: string;
     recommended?: boolean;
-    unusableReason?: 'unauthenticated' | 'oauth-429-risk';
+    unusableReason?: 'unauthenticated' | 'oauth-429-risk' | 'intranet-unreachable';
   }>;
   /**
    * 重新计算 Step 2 模型选项（RFC-341 修复）。登录成功（API key 提交成功 / OAuth
@@ -2987,7 +3079,7 @@ interface WizardRequest {
     value: string;
     detail?: string;
     recommended?: boolean;
-    unusableReason?: 'unauthenticated' | 'oauth-429-risk';
+    unusableReason?: 'unauthenticated' | 'oauth-429-risk' | 'intranet-unreachable';
   }>>;
   examplePrompts: readonly string[];
   /** 信任步骤（Step 1）中显示的工作区路径。 */
@@ -3108,7 +3200,7 @@ type QuestionsAnswer = {
  *
  * 不收编 toggleEditedFiles（全仓 grep 零调用点，见 findings-backlog.md 死代码候选）。
  */
-type PaneName = 'history' | 'backgroundTasks' | 'draftPane' | 'queuePane' | 'notifications' | 'schedulePane' | 'perf' | 'cacheStats' | 'compactionLog' | 'gallery' | 'proxy' | 'prompts';
+type PaneName = 'history' | 'backgroundTasks' | 'draftPane' | 'queuePane' | 'notifications' | 'schedulePane' | 'status' | 'cacheStats' | 'compactionLog' | 'gallery' | 'proxy' | 'prompts';
 interface TuiOptions {
   stdin: NodeJS.ReadStream;
   stdout: NodeJS.WriteStream;
@@ -3220,7 +3312,6 @@ interface TuiOptions {
   /** RFC-089 M8 spike：Ink ConcurrentRoot（键击 DiscreteEventPriority 插队 + 可中断 reconcile）。
    *  缺省读 OTTO_TUI_CONCURRENT=1；A/B 稳定后再定默认。 */
   concurrent?: boolean;
-  /** intent='steer' 时 cli 应注入当前运行回合（session.steer）而非起新回合；缺省/'send' 走原路径。 */
   /**
    * 提交回调（fire-and-forget）。
    *
@@ -3285,11 +3376,11 @@ interface TuiOptions {
    */
   onA2uiAction?: (componentId: string, action: string, payload?: Record<string, unknown>) => void;
   /**
-   * RFC-116 M5：`/perf` 面板内手动刷新键（r）触发——CLI 侧重新执行 `handlePerf` 的核心
+   * Status 面板内手动刷新键（r）触发——CLI 侧重新执行 `handleStatus` 的核心
    * 采集逻辑（内存/渲染/插件三类数据源），回填后面板自动重渲（数据经 setPerf* 系列
    * TuiHandle 方法喂回，不由本回调直接返回值）。手动触发，不做自动轮询（对齐 D7）。
    */
-  onPerfRefresh?: () => void;
+  onStatusRefresh?: () => void;
   /** /tasks 面板：k 杀选中后台进程。 */
   onBackgroundKill?: (id: string) => void;
   /** /tasks 面板：o 看选中后台进程输出（cli 据此启动 logPath tail 轮询）。 */
@@ -3449,8 +3540,10 @@ interface TuiPendingHandle {
   setPendingEcho(text: string, mode: string): void;
   /** 模型已接起首字节，关闭 ESC 撤回窗口（pending 转正）。 */
   clearPendingEcho(): void;
-  /** ESC 撤回 pending 消息——从对话流移除最后一条 user echo + 回填输入框 + 清 pendingEcho。 */
-  withdrawPendingEcho(): void;
+  /** ESC 撤回 pending 消息——从对话流移除最后一条 user echo + 清 pendingEcho。
+   *  返回是否真的撤回了（false = pendingEcho 已空/已转正，调用方不应回填输入框——否则
+   *  消息已留在对话流却把文本再塞回输入框，制造"撤回失败但输入框有内容"的重复）。 */
+  withdrawPendingEcho(): boolean;
   /** RFC-337 D3：注入一条运行中追加（steer）的待定 echo（延迟 commit，live 区渲染）。 */
   setPendingSteer(text: string, id: string): void;
   /** RFC-337 D3：steer 被模型消费 → 转正 commit 到 scrollback（此后不再可撤回）。 */
@@ -3565,7 +3658,8 @@ interface TuiEngineHandle {
     mode: SubmitMode;
   } | undefined;
   /**
-   * 把一条提交塞进"回合之后"队列（state.queued，与 Shift+Enter 同一队列），引擎空闲时自动出队起新回合。
+   * 把一条提交塞进"回合之后"队列（state.queued，与 Option/Ctrl+Enter 排队同一队列），
+   * 引擎空闲时自动出队起新回合。
    * 供 cli 兜底：若消息因镜像态去同步漏到"引擎仍忙却走起新回合"的路，按此回落到回合后队列，
    * 而非撞裸 prompt() 抛错。出队由 drainQueue 以引擎真·忙判定为闸，不会在忙时立即回拉打转。
    */
@@ -3618,8 +3712,14 @@ interface TuiMessagesHandle {
   getEditedFiles(): EditedFileEntry[];
 }
 interface TuiLifecycleHandle {
-  /** 停止 TUI（卸载 Ink 渲染树 + 清理平台副作用）。 */
-  stop(): void;
+  /**
+   * 停止 TUI（卸载 Ink 渲染树 + 清理平台副作用）。
+   *
+   * 2026-08-14 退出乱码 P0：改为 **async**——内含 OSC 11 吸收窗（200ms），在恢复
+   * 终端回显前消费在途回复。调用方**应当 await**（否则吸收窗可能未完成即被
+   * 后续 process.exit 截断）；不 await 时由 3s 兜底/进程 exit 兜底覆盖（best-effort）。
+   */
+  stop(): Promise<void>;
   /** 清屏并重置会话界面状态（/clear）：
    *   - 清终端（ANSI \x1B[2J\x1B[H）和 scrollback 状态
    *   - 清除任务面板、委托面板、动态区状态
@@ -4025,5 +4125,5 @@ declare function Tabable({
   children
 }: TabableProps): React.ReactElement;
 //#endregion
-export { ExtensionMenuContribution as $, ToolMessage as $n, subagentEntryStatus as $t, RemoteSessionSnapshot as A, ThemeRegistry as An, SigilPrefix as At, createSelectState as B, THEME as Bn, navigateSuggestions as Bt, TuiHandle as C, Risk as Cn, formatProviderUsageLimitTypeFull as Ct, WizardRequest as D, ThemePresetInput as Dn, SubmitMode as Dt, TuiStreamEvent as E, ThemePreset as En, PromptInput as Et, MessageStore as F, PANEL_BORDER as Fn, TypeaheadState as Ft, MemoryDialog as G, MessageContent as Gn, PasteStoreResidencySource as Gt, NotifyScheduler as H, A2uiContent as Hn, PasteSnapshot as Ht, Question as I, FIGURES as In, applySlashCompletion as It, MemoryEntrySource as J, StreamEvent as Jn, ObservationLike as Jt, MemoryDialogProps as K, PulseSurveyItem as Kn, createPasteStore as Kt, SelectOption as L, FiguresMap as Ln, createCommandRegistry as Lt, SessionDataTarget as M, LAYOUT as Mn, CommandEntry as Mt, SessionTransport as N, SPACING as Nn, CommandRegistry as Nt, AttachDataSourceDeps as O, ThemePresetSelection as On, SigilEntry as Ot, createAttachSessionDataSource as P, DIALOG_BORDER as Pn, SlashNavigateAction as Pt, ExtensionListEntry as Q, ToolCompletionMessage as Qn, observationRow as Qt, SelectOptions as R, PALETTE as Rn, extractSlashPrefix as Rt, SubagentContext as S, LangMode as Sn, ProviderUsageBadgeItem as St, TuiPanelRegistration as T, ThemeAppearance as Tn, QueuedCommands as Tt, NotifyStats as U, AssistantMessage as Un, PasteSnapshotEntry as Ut, A2uiButtonInfo as V, ThemeColors as Vn, CreatePasteStoreOptions as Vt, makeNotifyScheduler as W, ChatMessage as Wn, PasteStore as Wt, InfoDialogAction as X, ThinkingContent as Xn, formatTurnTimeline as Xt, InfoDialog as Y, TextContent as Yn, formatAgentDiagnosticsText as Yt, InfoDialogProps as Z, ToolCall as Zn, observationLiveFields as Zt, ModalRequestInput as _, detectLanguage as _n, createBudgetStore as _t, TabableContextValue as a, RateLimitType as an, ButtonProps as at, PluginRegistration as b, t as bn, HomeProps as bt, TabableRegistry as c, KeyBindingPredicate as cn, RegisteredRenderer as ct, useTabableContext as d, DataListProps as dn, NotificationStore as dt, subagentRestoreFields as en, UserMessage as er, ExtensionsListRequest as et, ConfirmDialog as f, DataListRow as fn, ProxyStore as ft, DraftItemView as g, useAppState as gn, BudgetView as gt, ConfirmRequest as h, Store as hn, BudgetStore as ht, Tabable as i, ErrorRetryItem as in, ButtonColor as it, SessionDataSource as j, createBuiltinThemeRegistry as jn, SigilSearchRegistry as jt, RemoteSessionEvent as k, ThemePresetSource as kn, SigilKind as kt, UseTabableOptions as l, DataList as ln, clearPluginRenderers as lt, AlertRequest as m, PerfStore as mn, BudgetState as mt, RouteContext as n, ErrorRetryAction as nn, ExtensionDetailRequest as nt, TabableEntry as o, ContextStore as on, ButtonVariant as ot, ConfirmDialogProps as p, DataListTone as pn, CacheStore as pt, MemoryEntry as q, StopReason as qn, Completer as qt, RouteContextValue as r, ErrorRetryActionKind as rn, Button as rt, TabableProps as s, OnboardingResult as sn, PluginMessageRenderer as st, FocusStyle as t, EditedFileEntry as tn, ExtensionDetailAction as tt, useTabable as u, DataListEntry as un, registerPluginRenderers as ut, ModalRequestVoid as v, i18next as vn, TaskStore as vt, TuiOptions as w, MarkdownThemeOverrides as wn, isUsingOverage as wt, PromptRequest as x, Lang as xn, SessionListItem as xt, PermissionDecision as y, initI18n as yn, Home as yt, SelectState as z, STATUS as zn, getCommandSuggestions as zt };
-//# sourceMappingURL=Tabable-BIsfZJSG.d.ts.map
+export { ExtensionMenuContribution as $, ToolCompletionMessage as $n, subagentEntryStatus as $t, RemoteSessionSnapshot as A, ThemeRegistry as An, SigilPrefix as At, createSelectState as B, THEME as Bn, navigateSuggestions as Bt, TuiHandle as C, Risk as Cn, formatProviderUsageLimitTypeFull as Ct, WizardRequest as D, ThemePresetInput as Dn, SubmitMode as Dt, TuiStreamEvent as E, ThemePreset as En, PromptInput as Et, MessageStore as F, PANEL_BORDER as Fn, TypeaheadState as Ft, MemoryDialog as G, MessageContent as Gn, PasteStoreResidencySource as Gt, NotifyScheduler as H, A2uiContent as Hn, PasteSnapshot as Ht, Question as I, FIGURES as In, applySlashCompletion as It, MemoryEntrySource as J, StopReason as Jn, ObservationLike as Jt, MemoryDialogProps as K, PendingPermission as Kn, createPasteStore as Kt, SelectOption as L, FiguresMap as Ln, createCommandRegistry as Lt, SessionDataTarget as M, LAYOUT as Mn, CommandEntry as Mt, SessionTransport as N, SPACING as Nn, CommandRegistry as Nt, AttachDataSourceDeps as O, ThemePresetSelection as On, SigilEntry as Ot, createAttachSessionDataSource as P, DIALOG_BORDER as Pn, SlashNavigateAction as Pt, ExtensionListEntry as Q, ToolCall as Qn, observationRow as Qt, SelectOptions as R, PALETTE as Rn, extractSlashPrefix as Rt, SubagentContext as S, LangMode as Sn, ProviderUsageBadgeItem as St, TuiPanelRegistration as T, ThemeAppearance as Tn, QueuedCommands as Tt, NotifyStats as U, AssistantMessage as Un, PasteSnapshotEntry as Ut, A2uiButtonInfo as V, ThemeColors as Vn, CreatePasteStoreOptions as Vt, makeNotifyScheduler as W, ChatMessage as Wn, PasteStore as Wt, InfoDialogAction as X, TextContent as Xn, formatTurnTimeline as Xt, InfoDialog as Y, StreamEvent as Yn, formatAgentDiagnosticsText as Yt, InfoDialogProps as Z, ThinkingContent as Zn, observationLiveFields as Zt, ModalRequestInput as _, detectLanguage as _n, createBudgetStore as _t, TabableContextValue as a, RateLimitType as an, ButtonProps as at, PluginRegistration as b, t as bn, HomeProps as bt, TabableRegistry as c, KeyBindingPredicate as cn, RegisteredRenderer as ct, useTabableContext as d, DataListProps as dn, NotificationStore as dt, subagentRestoreFields as en, ToolMessage as er, ExtensionsListRequest as et, ConfirmDialog as f, DataListRow as fn, ProxyStore as ft, DraftItemView as g, useAppState as gn, BudgetView as gt, ConfirmRequest as h, Store as hn, BudgetStore as ht, Tabable as i, ErrorRetryItem as in, ButtonColor as it, SessionDataSource as j, createBuiltinThemeRegistry as jn, SigilSearchRegistry as jt, RemoteSessionEvent as k, ThemePresetSource as kn, SigilKind as kt, UseTabableOptions as l, DataList as ln, clearPluginRenderers as lt, AlertRequest as m, StatusStore as mn, BudgetState as mt, RouteContext as n, ErrorRetryAction as nn, ExtensionDetailRequest as nt, TabableEntry as o, ContextStore as on, ButtonVariant as ot, ConfirmDialogProps as p, DataListTone as pn, CacheStore as pt, MemoryEntry as q, PulseSurveyItem as qn, Completer as qt, RouteContextValue as r, ErrorRetryActionKind as rn, Button as rt, TabableProps as s, OnboardingResult as sn, PluginMessageRenderer as st, FocusStyle as t, EditedFileEntry as tn, UserMessage as tr, ExtensionDetailAction as tt, useTabable as u, DataListEntry as un, registerPluginRenderers as ut, ModalRequestVoid as v, i18next as vn, TaskStore as vt, TuiOptions as w, MarkdownThemeOverrides as wn, isUsingOverage as wt, PromptRequest as x, Lang as xn, SessionListItem as xt, PermissionDecision as y, initI18n as yn, Home as yt, SelectState as z, STATUS as zn, getCommandSuggestions as zt };
+//# sourceMappingURL=Tabable-BRz398OB.d.ts.map