@x-otto/tui 0.0.1-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,1917 @@
+import { Command, CommandContext, CommandRegistry, CommandResult, RenderOptions, createBuiltinCommands, showCommandPalette } from "./compat.js";
+import { $ as ExtensionListEntry, $n as ToolCompletionMessage, $t as observationRow, A as RemoteSessionSnapshot, An as ThemePresetSource, At as SigilKind, B as SelectState, Bn as STATUS, Bt as getCommandSuggestions, C as TuiHandle, Cn as LangMode, Ct as ProviderUsageBadgeItem, Dn as ThemePreset, Dt as PromptInput, E as TuiStreamEvent, En as ThemeAppearance, Et as QueuedCommands, F as createLocalSessionDataSource, Fn as DIALOG_BORDER, Ft as SlashNavigateAction, G as makeNotifyScheduler, Gn as ChatMessage, Gt as PasteStore, H as A2uiButtonInfo, Hn as ThemeColors, Ht as CreatePasteStoreOptions, I as MessageStore, In as PANEL_BORDER, It as TypeaheadState, J as MemoryEntry, Jn as StopReason, Jt as Completer, K as MemoryDialog, Kn as MessageContent, Kt as PasteStoreResidencySource, Ln as FIGURES, Lt as applySlashCompletion, M as SessionDataTarget, Mn as createBuiltinThemeRegistry, Mt as SigilSearchRegistry, N as SessionTransport, Nn as LAYOUT, Nt as CommandEntry, O as AttachDataSourceDeps, On as ThemePresetInput, Ot as SubmitMode, P as createAttachSessionDataSource, Pn as SPACING, Pt as CommandRegistry$1, Qn as ToolCall, Qt as observationLiveFields, R as SelectOption, Rn as FiguresMap, Rt as createCommandRegistry, S as SubagentContext, Sn as Lang, St as SessionListItem, T as TuiPanelRegistration, Tn as MarkdownThemeOverrides, Tt as isUsingOverage, U as NotifyScheduler, Un as A2uiContent, Ut as PasteSnapshot, V as createSelectState, Vn as THEME, Vt as navigateSuggestions, W as NotifyStats, Wn as AssistantMessage, Wt as PasteSnapshotEntry, Xn as TextContent, Xt as formatAgentDiagnosticsText, Y as MemoryEntrySource, Yn as StreamEvent, Yt as ObservationLike, Zn as ThinkingContent, Zt as formatTurnTimeline, _ as ModalRequestInput, _n as useAppState, _t as BudgetView, an as ErrorRetryItem, at as ButtonColor, b as PluginRegistration, bn as initI18n, bt as Home, c as TabableRegistry, cn as OnboardingResult, ct as PluginMessageRenderer, dn as DataListEntry, dt as registerPluginRenderers, en as subagentEntryStatus, er as ToolMessage, et as ExtensionMenuContribution, f as ConfirmDialog, fn as DataListProps, ft as NotificationStore, g as DraftItemView, gn as Store, gt as BudgetStore, h as ConfirmRequest, hn as PerfStore, ht as BudgetState, i as Tabable, in as ErrorRetryActionKind, it as Button, j as SessionDataSource, jn as ThemeRegistry, jt as SigilPrefix, k as RemoteSessionEvent, kn as ThemePresetSelection, kt as SigilEntry, l as UseTabableOptions, ln as KeyBindingPredicate, lt as RegisteredRenderer, m as AlertRequest, mn as DataListTone, mt as CacheStore, nn as EditedFileEntry, nt as ExtensionDetailAction, on as RateLimitType, ot as ButtonProps, p as ConfirmDialogProps, pn as DataListRow, pt as ProxyStore, q as MemoryDialogProps, qn as PulseSurveyItem, qt as createPasteStore, rn as ErrorRetryAction, rt as ExtensionDetailRequest, s as TabableProps, sn as ContextStore, st as ButtonVariant, t as FocusStyle, tn as subagentRestoreFields, tr as UserMessage, tt as ExtensionsListRequest, u as useTabable, un as DataList, ut as clearPluginRenderers, v as ModalRequestVoid, vn as detectLanguage, vt as createBudgetStore, w as TuiOptions, wn as Risk, wt as formatProviderUsageLimitTypeFull, x as PromptRequest, xn as t, xt as HomeProps, y as PermissionDecision, yn as i18next, yt as TaskStore, z as SelectOptions, zn as PALETTE, zt as extractSlashPrefix } from "./Tabable-B7PtwING.js";
+import React from "react";
+import { DOMElement, Key } from "ink";
+import { FuzzySearchOptions, HighlightRange, RankedMatch, SearchableItem, SubsequenceResult, matchSubsequence, positionsToHighlightRanges, rankCandidates, rankLabeledItems, rankNamedItems, scoreSubsequence } from "@x-otto/shared";
+import { SigilTrigger, applySigilCompletion, extractSigilPrefix } from "@x-otto/interchange";
+import { SessionEvent, TaskItem } from "@x-otto/session-contract";
+
+//#region src/overlays/TrustPromptDialog.d.ts
+type TrustPromptChoice = 'trust' | 'readonly' | 'exit';
+//#endregion
+//#region src/WorkspaceTrustPrompt.d.ts
+interface WorkspaceTrustPromptOptions {
+  /** 解析到的工作区根（展示给用户 + 信任记录单元）。 */
+  root: string;
+  /** 用户配置语言（zh/en/auto），使弹窗与会话一致。 */
+  language?: string;
+}
+/**
+ * 弹出工作区信任弹窗，resolve 用户选择（'trust' | 'readonly' | 'exit'）。
+ * 仅在 cli 判定 `evaluateWorkspaceTrustPrompt().shouldPrompt` 后调用。
+ */
+declare function promptWorkspaceTrust(opts: WorkspaceTrustPromptOptions): Promise<TrustPromptChoice>;
+//#endregion
+//#region src/overlays/ParentWorkspaceDialog.d.ts
+type ParentWorkspaceChoice = 'use_parent' | 'create_new' | 'exit';
+//#endregion
+//#region src/ParentWorkspacePrompt.d.ts
+interface ParentWorkspacePromptOptions {
+  parentRoot: string;
+  currentRoot: string;
+  language?: string;
+}
+declare function promptParentWorkspaceChoice(opts: ParentWorkspacePromptOptions): Promise<ParentWorkspaceChoice>;
+//#endregion
+//#region src/ui-state/types.d.ts
+/** 此刻持有键盘焦点的拥有者。优先级见 focus.ts FOCUS_PRIORITY。 */
+type FocusOwner = 'home' | 'forcedUpgrade' | 'prompt'
+/** `/help` 命令面板独立查看器（复用 FileContentViewer 固定高度+滚动逻辑，同 fileViewer 一类）。 */
+/** RFC-212 D3：Enter-on-chip 打开的只读内容查看器（paste chip 原文查看）。 */
+/** shell 面板 `v` 键打开的全量输出查看器（复用 FileContentViewer 固定高度+滚动逻辑）。 */
+| 'shellFullOutput' | 'notifications' | 'background' | 'pasteConfirm' | 'editedFiles' | 'schedule' | 'subagents' | 'clipboard' | 'taskFocus' | 'taskDetail' | 'subagentContext' | 'editedFileFull' | 'sigilPane' | 'shell' | 'draft' | 'queue' | 'info' | 'queueEdit' | 'perf' | 'cacheStats' | 'compactionLog' | 'gallery'
+/** RFC-255 终局：/pane/proxy 面板焦点归属。此前 App.tsx routeDerivedOwner 已返回 'proxy'
+ *  但缺类型成员（靠 as FocusOwner 强转），useRouteDerivedOwner hook 则降级为 'prompt'
+ *  丢失语义——补成员后两处统一为 'proxy'（proxy 面板打开时 onFocusOwnerChange 得到非
+ *  'prompt' 值 → buffer 正确缓冲不 flush，同 perf/cacheStats 等同类只读面板）。 */
+| 'proxy' | 'prompts' | 'retry' | 'errorRetry'
+/** RFC-208：满意度脉冲调查弹层（Band B 标准形态，同 toast/errorRetry）。
+ *  RFC-251 Phase 4f 后键盘由 PulseSurveyOverlay 通过 FocusBus 自管。 */
+| 'pulseSurvey' | 'toast';
+//#endregion
+//#region src/term/paste.d.ts
+/**
+ * paste.ts — bracketed paste 状态机（D7 终端协议旁路）。
+ *
+ * 在 Ink useInput 之外操作 stdin，检测 \x1b[200~ / \x1b[201~ 区间。
+ *
+ * 优化点：后期可加 100ms 超时回退 + image 剪贴板检测钩子（见 V1 paste.ts）。
+ * 当前实现：最小可用——完整记录粘贴开始/结束 + 全文缓冲。
+ */
+type PasteEvent = {
+  type: 'paste_start';
+} | {
+  type: 'paste_end';
+  text: string;
+  isEmpty: boolean;
+} | {
+  type: 'paste_timeout';
+  partialText: string;
+};
+interface BracketedPasteOptions {
+  timeoutMs?: number;
+  onEmptyPaste?: () => void;
+}
+declare class BracketedPasteHandler {
+  private buffer;
+  private active;
+  private timer;
+  private readonly timeoutMs;
+  private readonly onEmptyPaste?;
+  constructor(opts?: BracketedPasteOptions);
+  get isPasting(): boolean;
+  get currentBuffer(): string;
+  feed(chunk: string): PasteEvent[];
+  forceEnd(): PasteEvent | null;
+  reset(): void;
+  destroy(): void;
+  private resetTimer;
+  private clearTimer;
+  private flushPasteEnd;
+}
+//#endregion
+//#region src/term/keys.d.ts
+/**
+ * keys.ts — 扩展键解析器（D7 终端协议旁路）。
+ *
+ * kitty CSI u + modifyOtherKeys + CSI 方向键/功能键 + SS3。
+ * 在 Ink useInput 之外操作，解析后的结果可注入输入栈。
+ *
+ * 优化点：后期可加入不完整序列缓冲 + 50ms flush 定时器。
+ */
+interface ParsedExtendedKey {
+  name: string;
+  ctrl: boolean;
+  shift: boolean;
+  alt: boolean;
+  meta: boolean;
+  sequence: string;
+}
+declare function parseExtendedKey(seq: string): ParsedExtendedKey | null;
+//#endregion
+//#region src/term/osc.d.ts
+declare function osc8Hyperlink(text: string, url: string | null, id?: string): string;
+declare function osc8FilePath(text: string, filePath: string, line?: number, col?: number): string;
+declare function osc52Write(text: string, clipboard?: 'c' | 'p'): void;
+declare function osc52QuerySequence(clipboard?: 'c' | 'p'): string;
+declare function beginSyncFrame(): void;
+declare function endSyncFrame(): void;
+declare function withSyncFrame<T>(fn: () => T): T;
+//#endregion
+//#region src/term/sync-output.d.ts
+/**
+ * sync-output.ts — P3 anti-flicker：tmux 下剥离同步输出（BSU/ESU）。
+ *
+ * Ink v7 自带同步输出（DEC private mode 2026：ESC[?2026h 开 / ESC[?2026l 关），把整帧包成
+ * 原子写避免撕裂——这本是好事。但它仅按 `stdout.isTTY && interactive` 开关，不跳过 tmux；
+ * 部分 tmux 不可靠透传 ?2026（残留可见序列 / 嵌套语义错位）。故在 tmux 下禁用同步输出：
+ * tmux 环境下从写出流里剥掉整段（含 ESC）。
+ *
+ * Ink 无关闭同步输出的选项（`shouldSync()` 只读 isTTY+interactive），故用 stdout 代理在
+ * 写出层剥离——非 fork、零侵入，且仅 tmux 下启用，其余路径完全不受影响。
+ */
+/** 剥离 DEC 2026 同步输出 begin/end 序列（BSU ESC[?2026h / ESU ESC[?2026l）。 */
+declare function stripSyncSequences(s: string): string;
+/** 包一层 stdout 代理：写出时剥离 ?2026，其余成员原样转发到真实流。 */
+declare function stripSyncStdout(stdout: NodeJS.WriteStream): NodeJS.WriteStream;
+/** 是否应在当前环境剥离同步输出：tmux 下默认开；`OTTO_TUI_SYNC=1` 可强制保留。 */
+declare function shouldStripSyncOutput(env?: NodeJS.ProcessEnv): boolean;
+//#endregion
+//#region src/term/insert-history.d.ts
+type InsertHistoryMode = 'standard' | 'raw';
+type WrapPolicy = 'pre' | 'terminal';
+interface InsertHistoryOptions {
+  /** 终端总行数。 */
+  rows: number;
+  /** 终端总列数（= 预换行宽度）。 */
+  columns: number;
+  /** Ink live 区顶部所在屏幕行（0-based）。历史插在它之上。
+   *  live 区紧贴底部时 = rows - liveHeight。 */
+  liveTop: number;
+  /** 插入后光标还原位置（缺省 = live 区左上角 {0, liveTop}）。 */
+  cursor?: {
+    x: number;
+    y: number;
+  };
+  /** 标准（DECSTBM 滚动区）/ raw（Zellij/老终端兜底，直写+预留空行）。 */
+  mode?: InsertHistoryMode;
+  /** pre = 我们按宽度预换行；terminal = 交给终端软换行。缺省 pre。 */
+  wrap?: WrapPolicy;
+}
+/** 可视宽度（剥 ANSI + CJK 宽字符占 2 + ambiguous-width 按终端 locale 校准）。 */
+declare const displayWidth: (s: string) => number;
+/**
+ * 把一条逻辑行预换行成若干物理行。
+ * - `terminal` 策略 / 宽度 ≤ 0：原样返回（交给终端软换行）。
+ * - 含 URL 的行：软换行（`hard:false`）——长 URL token 不被切断，可保持可点。
+ * - 普通散文行：硬换行（`hard:true`）——任何超宽行都被切到 ≤ 宽度，渲染可预测。
+ * 保留行首缩进（`trim:false`）；空行→单个空物理行（保留段落间距）。
+ */
+declare function preWrapLine(line: string, width: number, policy?: WrapPolicy): string[];
+/** 把多条逻辑行展开为物理行序列。 */
+declare function preWrapLines(lines: readonly string[], width: number, policy?: WrapPolicy): string[];
+/**
+ * 生成把 `lines` 插进 scrollback（live 区之上）的转义序列。纯函数，不触 I/O。
+ * 返回空串表示无可写内容。
+ */
+declare function insertHistorySequence(lines: readonly string[], opts: InsertHistoryOptions): string;
+/** 写出历史插入序列到流（薄封装）。 */
+declare function insertHistory(out: NodeJS.WriteStream, lines: readonly string[], opts: InsertHistoryOptions): void;
+/** 按环境选模式：Zellij 走 raw，其余走标准 DECSTBM。 */
+declare function pickInsertMode(env?: NodeJS.ProcessEnv): InsertHistoryMode;
+//#endregion
+//#region src/term/clear-guard.d.ts
+/** 从一段输出里剥掉 scrollback 清除序列（`\x1b[3J`），保留其余清屏序列。 */
+declare function stripScrollbackClear(s: string): string;
+/** 包一层 stdout 代理：写出时剥掉 `\x1b[3J`，其余成员原样转发。 */
+declare function guardScrollbackStdout(stdout: NodeJS.WriteStream): NodeJS.WriteStream;
+//#endregion
+//#region src/input/cursor.d.ts
+/**
+ * cursor.ts — Immutable Cursor model (CC utils/Cursor.ts port).
+ * Intl.Segmenter grapheme boundaries, CJK width 2, ZWJ-aware via string-width v8.x.
+ * Two deltas: tab→width 1 special case; per-grapheme width cache (4096 entries).
+ */
+declare function stringWidth(str: string): number;
+declare class MeasuredText {
+  readonly text: string;
+  readonly columns: number;
+  readonly lines: string[];
+  private _graphemes?;
+  private _wordBreaks?;
+  constructor(text: string, columns: number);
+  get graphemeList(): Array<{
+    segment: string;
+    index: number;
+  }>;
+  get wordBreaks(): number[];
+  get lineCount(): number;
+  offsetToLineCol(offset: number): {
+    line: number;
+    col: number;
+  };
+  lineColToOffset(line: number, col: number): number;
+}
+declare class Cursor {
+  readonly measuredText: MeasuredText;
+  readonly offset: number;
+  readonly selection: number;
+  private constructor();
+  static fromText(text: string, columns: number, offset?: number): Cursor;
+  static fromCursor(cursor: Cursor, columns?: number): Cursor;
+  get text(): string;
+  get columns(): number;
+  get position(): {
+    line: number;
+    col: number;
+  };
+  get hasSelection(): boolean;
+  equals(other: Cursor): boolean;
+  right(): Cursor;
+  left(): Cursor;
+  up(): Cursor;
+  down(): Cursor;
+  prevWord(): Cursor;
+  nextWord(): Cursor;
+  insert(value: string): Cursor;
+  backspace(): Cursor;
+  delete(): Cursor;
+  killToLineEnd(): {
+    cursor: Cursor;
+    killed: string;
+  };
+  killToLineStart(): {
+    cursor: Cursor;
+    killed: string;
+  };
+  killWordBefore(): {
+    cursor: Cursor;
+    killed: string;
+  };
+  modifyText(end: number, ins?: string): Cursor;
+  deleteTokenBefore(): Cursor | null;
+  getViewportStartLine(maxVisible: number): number;
+  toEnd(): Cursor;
+  toStart(): Cursor;
+  toLineStart(): Cursor;
+  toLineEnd(): Cursor;
+}
+//#endregion
+//#region src/input/text-input-logic.d.ts
+interface EditKeyEvent {
+  name: string;
+  ctrl: boolean;
+  shift: boolean;
+  alt: boolean;
+  meta: boolean;
+}
+type EditAction = 'insert' | 'delete_backward' | 'delete_forward' | 'kill_to_end' | 'kill_to_start' | 'kill_word_before' | 'move_to_start' | 'move_to_end' | 'move_left' | 'move_right' | 'move_word_left' | 'move_word_right' | 'submit' | 'submit_force' | 'none' | 'clear_text';
+interface EditResult {
+  cursor: Cursor;
+  action: EditAction;
+  killed?: string;
+}
+declare function handleEditingKey(cursor: Cursor, key: EditKeyEvent): EditResult | null;
+declare function getKillRingEntries(): readonly string[];
+declare function resetKillRing(): void;
+declare function handleEditingKeyExtended(cursor: Cursor, key: EditKeyEvent): EditResult | null;
+declare function shouldUseViewport(cursor: Cursor): boolean;
+declare function getInputViewport(cursor: Cursor, maxVisible: number): {
+  startLine: number;
+  endLine: number;
+  visibleLines: string[];
+  cursorLine: number;
+} | null;
+//#endregion
+//#region src/input/input-buffer.d.ts
+/**
+ * input-buffer.ts — Undo snapshot stack (CC useInputBuffer port, M48-04).
+ * (renamed from useInputBuffer.ts — factory function, no React hooks; `use*` prefix was misleading)
+ *
+ * Module-level undo buffer: snapshot BEFORE each edit, ctrl+_ triggers undo.
+ *
+ * Constraints:
+ * - Time debounce 1000ms (not per-key)
+ * - Skip duplicates (same text+offset as top)
+ * - MAX=50 (slice(-50) on overflow)
+ * - No redo
+ * - Snapshot timing: "snapshot old value before change"
+ *
+ * Usage:
+ *   const buf = createInputBuffer()
+ *   buf.snapshot({ text: cursor.text, offset: cursor.offset }) // before edit
+ *   const prev = buf.undo() // ctrl+_
+ */
+interface BufferEntry {
+  text: string;
+  offset: number;
+  timestamp: number;
+}
+interface InputBuffer {
+  snapshot(state: {
+    text: string;
+    offset: number;
+  }): void;
+  undo(): BufferEntry | null;
+  readonly depth: number;
+  reset(): void;
+}
+declare function createInputBuffer(maxSize?: number): InputBuffer;
+//#endregion
+//#region src/input/history-provider.d.ts
+interface SearchMatch {
+  entry: string;
+  matchStart: number;
+  matchEnd: number;
+  /** 非连续模糊命中区间（RFC-125 M125-4 高亮） */
+  highlightRanges?: HighlightRange[];
+}
+interface InputHistory {
+  push(entry: string): void;
+  navigateUp(currentDraft: string): string | null;
+  navigateDown(): string | null;
+  beginSearch(draft: string): void;
+  search(query: string): SearchMatch[];
+  acceptSearch(index: number): string | null;
+  cancelSearch(): string | null;
+  resetNavigation(): void;
+  readonly size: number;
+  /**
+   * 当前历史导航态。未导航（游标在底部草稿）时返回 null；
+   * 导航中返回 { position, total }——position 为「距最新的位置」（1=最近一条），
+   * total 为历史总条数。供会话头 HUD 展示「N/total + 当前条目」。
+   */
+  readonly navState: {
+    position: number;
+    total: number;
+  } | null;
+  /** 获取全部历史条目（最近在末尾）。/history 面板用。 */
+  getAll(): readonly string[];
+  clear(): void;
+}
+interface CreateInputHistoryOptions {
+  maxSize?: number;
+  initialEntries?: readonly string[];
+}
+declare function createInputHistory(options?: CreateInputHistoryOptions): InputHistory;
+//#endregion
+//#region src/input/TextInput.d.ts
+type InputMode = 'send' | 'bash' | 'bash_async' | 'memory' | 'steer' | 'dialog';
+interface TextInputProps {
+  value: string;
+  offset: number;
+  columns: number;
+  mode?: InputMode;
+  placeholder?: string;
+  maxVisibleLines?: number;
+  /** @deprecated 使用 tabIndex 替代。向后兼容：传入时覆盖 useTabable 结果。 */
+  focused?: boolean;
+  /** tabIndex for focus traversal（默认 -1 = 不参与 Tab 切换；0+ = 参与）。 */
+  tabIndex?: number;
+  /** 遮罩渲染（如 API Key）——显示为 '•' 占位，不回显明文；跳过 chip 高亮解析。 */
+  mask?: boolean;
+  /**
+   * 抑制模式前缀（RFC-273 D3）——调用方**自带前缀**时传 true，避免双前缀。
+   * 例：SelectDialog 的 filter 框外部已渲染 `/ ` 搜索前缀，此时 TextInput 不应再加 `> `。
+   */
+  noPrefix?: boolean;
+  /** 行内 dim ghost 补全后缀（RFC-128 Fish-like autosuggestion）。 */
+  ghostSuffix?: string;
+  /** RFC-198 §5.3：当前失效的粘贴引用 id 集合（`PasteStore.findMissingIds` 结果）——
+   *  命中的 `[@paste:#N]` chip 渲染为失效样式（错误色 + 删除线），不覆盖 `[@paste:image #N]`
+   *  （image refs 不参与本机制，见 cursor.ts `parsePasteChipId` 头注释）。 */
+  invalidPasteIds?: ReadonlySet<number>;
+  /** RFC-311：根 Box 节点 ref——useMeasuredCursorOrigin 实测光标绝对原点用。
+   *  挂根（稳定节点）而非光标行（行节点 key 含内容、每帧重建）；光标行相对根的
+   *  偏移由 computeCursorInline 同帧算出（与渲染结构逐行同源）。 */
+  containerRef?: React.Ref<DOMElement>;
+  /**
+   * RFC-317：是否声明**物理光标**（IME 候选框锚定的前提）。
+   *
+   * 默认 false（既有消费方行为不变）。为 true 时 TextInput 用**自身渲染期的几何
+   * 真值**（softWrap 结果 + 窗口化偏移）声明光标位置——不再由上层重算同一份几何，
+   * 消除双源漂移；且任何消费方挂上即得正确的候选框位置（RFC-317 下沉主旨）。
+   *
+   * 需要配合 containerRef（原点实测锚点）。
+   */
+  physicalCursor?: boolean;
+  /** 最近一次退格/删除键时刻——解除 IME 冻结闸武装（退格与 preedit 同样使 text
+   *  变短，必须用按键事件区分，否则删除时光标冻结在原位）。 */
+  deleteKeyAt?: number;
+}
+declare const TextInput: React.MemoExoticComponent<({
+  value,
+  offset,
+  columns,
+  mode,
+  placeholder,
+  maxVisibleLines,
+  focused: focusedProp,
+  tabIndex,
+  mask,
+  noPrefix,
+  ghostSuffix,
+  invalidPasteIds,
+  containerRef,
+  physicalCursor,
+  deleteKeyAt
+}: TextInputProps) => React.ReactElement>;
+//#endregion
+//#region src/input/horizontal-step.d.ts
+/**
+ * 横排按钮组的方向解算（单一真源）。
+ *
+ * 语义（对齐 Segmented.tsx / GalleryPane.tsx 既有正确实现）：
+ *   ← / Shift+Tab  → -1（反向）
+ *   → / Tab        → +1（正向）
+ *   其余            → 0（不消费）
+ *
+ * 历史缺陷（RFC-289 §2.3）：方向量曾写成 `key.shift && key.tab ? -1 : 1`，
+ * 只区分 Shift+Tab，导致 leftArrow 与 rightArrow 同走 +1——左箭头行为等同右箭头。
+ * 该写法被复制到 7 个 dialog，因测试只覆盖右箭头而长期未被发现。
+ */
+declare function resolveHorizontalStep(key: Key): -1 | 0 | 1;
+/** 环形步进：在 [0, count) 内按 step 回绕。 */
+declare function cycleIndex(current: number, step: number, count: number): number;
+//#endregion
+//#region src/input/submit-routing.d.ts
+type SubmitRoute = 'command' | 'steer' | 'queue' | 'send';
+interface SubmitRouteCtx {
+  /** agent 是否正在跑(TUI 镜像态)。 */
+  processing: boolean;
+  /** 命令名(小写,无前导 /)是否为「本地立即处理、不起 agent 回合」的注册命令。 */
+  isImmediateCommand: (name: string) => boolean;
+  /**
+   * 命令名是否为「中止当前回合」命令(/abort 等)。这类命令的语义恰恰是**打断正在跑的回合**,
+   * 必须在运行中立即放行(否则被当普通斜杠命令入队→等回合自然跑完才回放,中止彻底失效)。
+   * cli 侧 onSubmit 据此直接走中断入口(等价 Ctrl+C),不起新回合、不污染处理态。
+   */
+  isInterruptCommand?: (name: string) => boolean;
+}
+/** 提取斜杠命令名(小写,无 /);非 send 模式或非 / 开头 → 空串。 */
+declare function slashCommandName(text: string, mode: SubmitMode): string;
+/**
+ * cli 端"有效忙"= 引擎 prompt in-flight(engineBusy=session.isBusy) **或** cli 处理周期内
+ * (cliProcessing=agentProcessing,含续轮循环)。取**或**是要害：续轮循环两轮 handleInput 之间
+ * engineBusy 会瞬时落 false，单看引擎会让续轮间隙的提交起 reentrant 新回合；cliProcessing 整个
+ * onSubmit 周期恒为 true(finally 复位,不 stuck)，补上这段缝。**别简化成只看 engineBusy**(本函数即为
+ * 防该回退而存在,见 submit-routing.test.ts 的 (false,true)→true 断言)。
+ */
+declare function effectiveBusy(engineBusy: boolean, cliProcessing: boolean): boolean;
+declare function routeSubmit(text: string, mode: SubmitMode, force: boolean, ctx: SubmitRouteCtx): SubmitRoute;
+//#endregion
+//#region src/history/types.d.ts
+interface HistoryEntry {
+  command: string;
+  /** unix 毫秒；部分源（如 bash plain）无时间戳 */
+  timestamp?: number;
+  source: string;
+}
+interface HistorySource {
+  readonly id: string;
+  load(): Promise<readonly HistoryEntry[]>;
+}
+interface MergedHistoryProvider {
+  /** 供 pickAutosuggestion / createInputHistory；旧→新，最新在末尾 */
+  getCommands(): readonly string[];
+  getEntries(): readonly HistoryEntry[];
+}
+//#endregion
+//#region src/history/sensitive-patterns.d.ts
+/** RFC-129 §3 D3：可选敏感行过滤（默认模式，可被配置覆盖） */
+declare const DEFAULT_SENSITIVE_PATTERNS: readonly RegExp[];
+declare function isSensitiveCommand(command: string, patterns?: readonly RegExp[]): boolean;
+//#endregion
+//#region src/history/zsh-history-parser.d.ts
+declare const ZSH_HISTFILE_SOURCE = "zsh-histfile";
+interface ParseZshHistoryOptions {
+  source?: string;
+  sensitivePatterns?: readonly RegExp[];
+  /** 为 true 时丢弃匹配 sensitivePatterns 的行 */
+  filterSensitive?: boolean;
+}
+/** 解析 zsh history 文件内容（extended + plain），纯函数、不读盘。 */
+declare function parseZshHistory(content: string, options?: ParseZshHistoryOptions): HistoryEntry[];
+declare function normalizeCommand(command: string): string;
+//#endregion
+//#region src/history/bash-history-parser.d.ts
+declare const BASH_HISTFILE_SOURCE = "bash-histfile";
+interface ParseBashHistoryOptions {
+  source?: string;
+  sensitivePatterns?: readonly RegExp[];
+  filterSensitive?: boolean;
+}
+/**
+ * 解析 bash history 文件（一行一条；可选 `#<unix_ts>` 时间戳行 + 命令行对）。
+ */
+declare function parseBashHistory(content: string, options?: ParseBashHistoryOptions): HistoryEntry[];
+//#endregion
+//#region src/history/fish-history-parser.d.ts
+declare const FISH_HISTFILE_SOURCE = "fish-histfile";
+interface ParseFishHistoryOptions {
+  source?: string;
+  sensitivePatterns?: readonly RegExp[];
+  filterSensitive?: boolean;
+}
+/** 解析 fish history YAML 块（`- cmd:` / `when:`），纯函数。 */
+declare function parseFishHistory(content: string, options?: ParseFishHistoryOptions): HistoryEntry[];
+//#endregion
+//#region src/history/merged-history-provider.d.ts
+declare const OTTO_SESSION_SOURCE = "otto-session";
+interface MergeHistoryOptions {
+  /** 合成时间戳起点，保证 otto 会话内顺序（旧→新） */
+  ottoTimestampBase?: number;
+}
+/** 合并 otto 会话历史与外部源；otto 同源优先，再比时间戳。 */
+declare function mergeHistoryEntries(ottoSessionCommands: readonly string[], externalEntries: readonly HistoryEntry[], options?: MergeHistoryOptions): HistoryEntry[];
+declare function entriesToCommands(entries: readonly HistoryEntry[]): string[];
+declare function createMergedHistoryProvider(ottoSessionCommands: readonly string[], externalEntries: readonly HistoryEntry[], options?: MergeHistoryOptions): MergedHistoryProvider;
+//#endregion
+//#region src/panes/SigilPane.d.ts
+interface SigilPaneProps {
+  /** 触发的 sigil（决定面板过滤哪一类）。 */
+  sigil: SigilPrefix;
+  /** 触发时的初始查询串（sigil 后已输入的字符）。 */
+  initialQuery: string;
+  /** 数据源（只读 search / searchAsync）。 */
+  registry: SigilSearchRegistry;
+  /** 键盘接管开关（focusOwner==='sigilPane' 时为 true）。 */
+  active: boolean;
+  /** 终端总行数（FileContentViewer 需要）。 */
+  rows: number;
+  /** 过滤输入框可用列宽（Cursor 折行计算需要，缺省 60，对齐 InputDialog/SelectDialog 默认值）。 */
+  columns?: number;
+  /**
+   * 终端总列宽（RFC-187：@file 全文查看候选视图预折行需要，与 `columns`——过滤框可用
+   * 列宽——语义不同，不能复用；缺省 80，同 EditedFileFullPane/ExtensionDetailDialog）。
+   */
+  viewerColumns?: number;
+  /** 选中条目。 */
+  onSelect: (entry: SigilEntry) => void;
+  /** 关闭面板（Esc，或空过滤再退格删 sigil）。deletedSigil 表示是否应连带删除 sigil 字符。 */
+  onClose: (opts: {
+    deleteSigil: boolean;
+  }) => void;
+  /**
+   * 覆盖默认标题。缺省按 sigil 前缀：@ → 提及，# → 标签。
+   * Ctrl+R / /history 历史搜索模式用「历史」（history.label）覆盖。
+   */
+  title?: string;
+  /** 过滤串变化（用于 App 同步「面板内输入」到 prompt 文本，可选）。 */
+  onQueryChange?: (query: string) => void;
+  /**
+   * 读取文件全文（用于 @file 条目的 FileContentViewer 预览）。
+   * 未提供时 file 条目回退到 preview 截断文本（旧行为）。
+   *
+   * `truncated=true`（RFC-189 追加修复：`readFileCapped` 读取层熔断场景）时
+   * `resolveFileContentViews` 须强制走大文件降级候选，见下方 `preTruncated` 用法。
+   */
+  readFileContent?: (path: string) => Promise<{
+    content: string;
+    truncated: boolean;
+  }>;
+  /**
+   * 最近选中的条目（MRU，跨 kind 混合，最多 RECENT_MAX 条，最近在前）。
+   * 仅在过滤框为空（`query === ''`）时置顶展示为独立「最近使用」分组——一旦用户开始
+   * 输入过滤字符，该分组让位给正常按 kind 分组的搜索结果（对齐 /model 面板的
+   * MRU 心智，但只在空查询时出现，避免与真实搜索结果的分组次序混淆）。
+   * 与 registry 搜索结果不去重（同一条目可能同时出现在「最近使用」与其原生分组里，
+   * 对齐 /model recentOptions 同款设计）。
+   */
+  recentEntries?: SigilEntry[];
+}
+declare function SigilPane({
+  sigil,
+  initialQuery,
+  registry,
+  active,
+  rows,
+  columns,
+  viewerColumns,
+  onSelect,
+  onClose,
+  onQueryChange,
+  readFileContent,
+  recentEntries,
+  title
+}: SigilPaneProps): React.ReactElement;
+//#endregion
+//#region src/messages/stream-commit.d.ts
+/**
+ * stream-commit.ts — P0 anti-flicker：流式正文「已稳定块」增量提交模型。
+ *
+ * 背景：把整轮不断增高、且每帧回流的流式正文留在动态区，是 Ink TUI 闪烁的主因。
+ * 采用 scrollback-aware 增量提交（滚动区把完成行推进 scrollback，配合稳定/尾段切分）——
+ * 核心是「已完成内容尽快离开动态区，永不再画」。
+ *
+ * 本模块是纯函数状态机：喂入累计全文，吐出「应提交进 <Static> 的新块」+「仍需动态
+ * 渲染的未稳定尾段」。startTui 据此把块推进 messages（走 Static 一次性渲染），动态区
+ * 只剩尾段→高度恒定→消闪烁。纯函数便于单测，且是唯一真源（startTui 仅做适配）。
+ */
+/** 可安全提交的边界：最后一个不在未闭合代码围栏内的空行（\n\n）之后的位置。 */
+declare function safeCommitBoundary(text: string): number;
+interface StreamCommitState {
+  /** 本回复累计全文（最近一次 step 入参） */
+  prev: string;
+  /** 已提交进 Static 的字节数 */
+  committedLen: number;
+  /** 本回复是否已提交首块（决定续块 lead 标志） */
+  led: boolean;
+}
+interface StreamChunk {
+  text: string;
+  /** 该回复首块 → 渲 ⏺ 圆点；续块对齐缩进无圆点 */
+  lead: boolean;
+}
+interface StreamCommitResult {
+  /** 本次新产生、应追加进 Static 的块（按序） */
+  chunks: StreamChunk[];
+  /** 仍需动态渲染的未稳定尾段 */
+  tail: string;
+  /** 新状态（喂给下一次 step） */
+  state: StreamCommitState;
+}
+declare function initStreamCommit(): StreamCommitState;
+/**
+ * 喂入累计全文 t（空串 = 块/回合结束，收尾残余尾段）。
+ * 返回新提交块 + 动态尾段 + 新状态。纯函数，无副作用。
+ */
+declare function streamCommitStep(s: StreamCommitState, t: string): StreamCommitResult;
+//#endregion
+//#region src/messages/stream-coalesce.d.ts
+declare const STREAM_COALESCE_MS: number;
+interface Coalescer {
+  /** immediate=true 时立即 flush 挂起值并同步 apply(v)（用于 finalize）。 */
+  push(v: string, immediate: boolean): void;
+  /** 取消挂起的定时器（unmount/stop 时调用）。 */
+  cancel(): void;
+}
+declare function makeCoalescer(apply: (v: string) => void, intervalMs?: number): Coalescer;
+//#endregion
+//#region src/messages/query-guard.d.ts
+/**
+ * query-guard.ts — Generation-counting state machine (M49-02).
+ * Prevents stale async finally blocks from corrupting state.
+ */
+type GuardState = 'idle' | 'dispatching' | 'running';
+interface QueryGuard {
+  reserve(): boolean;
+  /** Cancel reservation (dispatching→idle, no gen bump). Used when await fails before tryStart. */
+  cancelReservation(): void;
+  tryStart(): number;
+  end(generation: number, callback?: () => void): void;
+  forceEnd(): void;
+  readonly state: GuardState;
+  readonly generation: number;
+  readonly isRunning: boolean;
+  subscribe(listener: () => void): () => void;
+  reset(): void;
+}
+declare function createQueryGuard(): QueryGuard;
+//#endregion
+//#region src/messages/collapse.d.ts
+interface CollapsedBlock {
+  type: 'collapsed';
+  messages: AssistantMessage[];
+  summary: string;
+  collapsed: boolean;
+}
+type CollapsibleMessage = AssistantMessage | CollapsedBlock;
+declare function collapseMessages(msgs: AssistantMessage[], threshold?: number): CollapsibleMessage[];
+declare function toggleCollapse(block: CollapsedBlock): CollapsedBlock;
+declare function expandCollapsed(msgs: CollapsibleMessage[]): AssistantMessage[];
+//#endregion
+//#region src/messages/Message.d.ts
+interface MessageProps {
+  message: ChatMessage;
+  columns?: number;
+}
+declare function MessageView({
+  message,
+  columns
+}: MessageProps): React.ReactElement;
+declare const Message: React.MemoExoticComponent<typeof MessageView>;
+//#endregion
+//#region src/stores/scroll-store.d.ts
+interface ScrollState {
+  /** 距底部行数（0 = 贴底 follow；> 0 = 回看态）。 */
+  offset: number;
+  /** 内容总行数（消费方上报——上界 clamp 防 overscroll 死区）。 */
+  totalLines: number;
+}
+interface ScrollStore {
+  store: Store<ScrollState>;
+  /** 相对滚动（正 = 向更早/上方，负 = 向最新/下方）。clamp 由渲染端 computeScrollWindow 保证。 */
+  scrollBy(delta: number): void;
+  /** 翻一页（一屏行数）。dir=1 向更早，-1 向最新。 */
+  page(dir: 1 | -1, rows: number): void;
+  /** 跳到最早（顶部）。 */
+  toTop(): void;
+  /** 回 live（offset=0，follow 恢复）。 */
+  toBottom(): void;
+  /** RFC-300 M3a：绝对定位（find 导航跳转用——目标 offset 由渲染端换算传入）。 */
+  setOffset(n: number): void;
+  /** RFC-300 终局（A⑤ overscroll 死区）：上报内容总行数——scrollBy/page 上界 clamp。 */
+  setTotalLines(n: number): void;
+  /**
+   * RFC-300 M3c：滚轮事件总线——其他滚动视图（FileContentViewer 等）mount 时
+   * 注册滚轮回调（delta=±1/格），main.ts 的 wheelCoalescer 把滚轮事件分发给
+   * 当前持焦视图。返回注销函数。
+   */
+  registerWheel(handler: (delta: number) => void): () => void;
+  /** RFC-300 M3c：把滚轮事件分发给最近注册的订阅者（视图栈顶——当前焦点视图）。 */
+  dispatchWheel(delta: number): boolean;
+}
+//#endregion
+//#region src/stores/stream-store.d.ts
+interface StreamState {
+  streamingText: string;
+  streamingThinking: string;
+  streamCommit: StreamCommitState;
+  /** 上一次流式尾段（scrollback 模式 streamControllerStep 用于判断是否需要重渲）。 */
+  lastTail: string | undefined;
+  spinnerMode: 'requesting' | 'responding' | null;
+  outputTokensThisTurn: number;
+  maxOutputTokens: number | undefined;
+  toolTurnCount: number;
+  maxToolTurns: number;
+  promptOutputTokens: number;
+  promptOutputTokenBudget: number;
+  processing: boolean;
+  activeTool: string | null;
+}
+interface StreamStore {
+  store: Store<StreamState>;
+  /** `/clear`（clearSession）用：重置全部 13 字段到初始值（覆盖迁移前只重置 3 个的缺口）。 */
+  reset(): void;
+}
+//#endregion
+//#region src/messages/REPLRegion.d.ts
+interface REPLRegionProps {
+  streamStore: StreamStore;
+  completedMessages: ChatMessage[];
+  columns?: number;
+  rows?: number;
+  maxPreviewRows?: number;
+  suppressLive?: boolean;
+  /** RFC-283 D1：pending echo 在 live 区渲染（灰色），转正时由 clearPendingEcho commit 到 scrollback。 */
+  pendingEcho?: {
+    text: string;
+    mode: string;
+  } | null;
+  /** scrollback 模式（OTTO_TUI_SCROLLBACK=1）：pending echo 不进 store，仅靠 live 区渲染。
+   *  非 scrollback（窗口模式/legacy Static）下 echoUserInput 已把 streaming:true 消息 append
+   *  进 store（转录区渲染），此处不得再画 live 行——否则同一条 prompt 双回显（真实用户反馈）。 */
+  scrollbackMode?: boolean;
+  /** RFC-337 D3：待定 steer（运行中追加）在 live 区渲染（灰色），转正/撤回时移除。 */
+  pendingSteers?: readonly {
+    text: string;
+    id: string;
+  }[];
+  /** RFC-300 D1：窗口模式（默认）——已完成消息走 ScrollableTranscript 窗口渲染（可滚动/可回看）；
+   *  legacy Static 模式（OTTO_TUI_SCROLLBACK=0）保持 <Static> 全量渲染。 */
+  windowMode?: boolean;
+  /** RFC-300 M1b：对话流滚动状态（回看态 offset；0=贴底 follow）。 */
+  scrollStore: ScrollStore;
+  /** RFC-300 M2：补页状态与回调（App 层编排）。 */
+  earlierLoading?: boolean;
+  earlierEnded?: boolean;
+  onNeedEarlier?: () => void;
+  onPrepend?: (deltaLines: number) => void;
+  /** RFC-300 M3a：find 搜索（query/活跃匹配/导航）。 */
+  findQuery?: string;
+  findActiveMatch?: number;
+  onFindNavigateTo?: (offset: number) => void;
+  onFindCountChange?: (count: number) => void;
+  onReviewHintChange?: (hint: string | null) => void;
+  renderReviewHint?: boolean;
+}
+declare function REPLRegion({
+  streamStore,
+  completedMessages,
+  columns,
+  rows,
+  maxPreviewRows,
+  suppressLive,
+  pendingEcho,
+  scrollbackMode,
+  pendingSteers,
+  windowMode,
+  scrollStore,
+  earlierLoading,
+  earlierEnded,
+  onNeedEarlier,
+  onPrepend,
+  findQuery,
+  findActiveMatch,
+  onFindNavigateTo,
+  onFindCountChange,
+  onReviewHintChange,
+  renderReviewHint
+}: REPLRegionProps): React.ReactElement;
+//#endregion
+//#region src/messages/diff-logic.d.ts
+/**
+ * diff-logic.ts — Pure diff logic (no React). Extracted from StructuredDiff for testability.
+ */
+interface DiffHunkLine {
+  type: 'add' | 'remove' | 'context';
+  content: string;
+  oldLine?: number;
+  newLine?: number;
+  wordSegments?: Array<{
+    text: string;
+    changed: boolean;
+  }>;
+}
+interface DiffHunk {
+  header: string;
+  lines: DiffHunkLine[];
+}
+//#endregion
+//#region src/messages/message-lines.d.ts
+/**
+ * 一条消息 → ANSI 文本行（去首尾空行）。Mode A 提交路径与 B 模式 <Message> 薄包共用此单一真源。
+ */
+declare function renderMessageLines(message: unknown, columns?: number): string[];
+//#endregion
+//#region src/messages/markdown-typography.d.ts
+interface MarkdownTypographyTheme {
+  /** H1 标题色（默认 accent）。 */
+  heading1: string;
+  /** H2 标题色（默认 secondary）。 */
+  heading2: string;
+  /** H5/H6 弱标题色（默认 inactive）。H3/H4 不着色，只 bold，不在此收口。 */
+  headingWeak: string;
+  /** 一级列表 marker 色（默认 secondary）。 */
+  listMarkerPrimary: string;
+  /** 二级及以下列表 marker 色（默认 inactive）。 */
+  listMarkerMuted: string;
+  /** 引用竖条色（默认 accentDim）。 */
+  quoteBar: string;
+  /** 引用正文色（默认 secondary）。 */
+  quoteText: string;
+  /** 链接色（默认 accentBright）。 */
+  link: string;
+  /** 行内 code 色（默认 codeText）。 */
+  inlineCode: string;
+  /** code fence divider 色（默认 inactive）。 */
+  codeFenceDivider: string;
+  /** 表格 header/竖屏 fallback key 色（默认 secondary）。 */
+  tableHeader: string;
+  /** 表格 divider 色（默认 inactive）。 */
+  tableDivider: string;
+  /** 列表每层缩进（RFC-276 D3：默认 2，M3 暂不接入 override 生效路径，仅保留字段）。 */
+  listIndent: 2 | 3;
+  /** 无序列表按深度轮换的 marker 字形，必须全部单宽。 */
+  listMarkers: readonly [string, string, string, string];
+  /** code fence divider 开关（默认 'hr'；'none' 时只隐藏 divider，不影响 line-number gutter）。 */
+  codeBlockDivider: 'hr' | 'none';
+  /** H1 divider 色——不可覆盖的固定装饰色，仍统一走本函数解析。 */
+  h1Divider: string;
+  /** 纯 `---` 水平线色——不可覆盖。 */
+  hr: string;
+  /** code block 行号 gutter 色——不可覆盖（RFC-021 基石特性，不受 preset 影响）。 */
+  codeGutter: string;
+  /** code block language label 色——不可覆盖。 */
+  codeLabel: string;
+  /** 表格正文/value 色——不可覆盖。 */
+  tableBody: string | undefined;
+  /** task list 已勾选 checkbox 色——不可覆盖（状态语义色 success，非排版角色，不在 D3 覆盖面内）。 */
+  taskChecked: string;
+}
+declare function setMarkdownThemeUserOverrides(overrides: MarkdownThemeOverrides | undefined): void;
+declare function getMarkdownThemeUserOverrides(): MarkdownThemeOverrides | undefined;
+//#endregion
+//#region src/messages/markdown-to-lines.d.ts
+/**
+ * 行内：走 marked 行内 token → 带 ANSI（plain=true 仅取文本，剥样式）。
+ * 真解析器正确处理：嵌套强调（`**粗 *斜***`）、转义（`\*`）、代码 span 内标记不被吃（`` `a*b*` ``）。
+ */
+declare function renderInline(line: string, plain?: boolean, typography?: MarkdownTypographyTheme): string;
+declare function renderMarkdownToLines(text: string, columns?: number, typography?: MarkdownTypographyTheme): string[];
+//#endregion
+//#region src/messages/transcript-text.d.ts
+/**
+ * 渲染纯文本转录。`streamingText` 为当前 turn 尚未落入 messages 的 in-flight 流式尾巴（可选）。
+ * 块间空行分隔；user=`▸ you`、assistant=`⏺ assistant`（thinking 前缀 `∴`）、tool=`⎿ name → result`。
+ *
+ * 下方 switch 无 `default` 分支——本函数专供子代理观测面板（DelegateOutputPane）的纯文本
+ * 转录导出，边界类消息（`compact_boundary`/`prune_boundary`/`history_capped`/`model_switch`/
+ * `model_fallback`/`tool_completion`/`pane`/`write_lease_denied`/`write_lease_restored`）
+ * 有意静默丢弃，不进纯文本导出（这些是主转录流的 UI 提示层，子代理观测面板只关心
+ * user/assistant/tool 三类实质对话内容）。9 类消息统一按此约定处理，非遗漏——独立 review
+ * 已核实一致性（2026-07-12；write_lease_* 于 2026-07-14 修复新增时复核仍适用同一约定）。
+ */
+declare function formatTranscriptText(messages: ChatMessage[], streamingText?: string): string;
+//#endregion
+//#region src/messages/key-value-lines.d.ts
+/** 一行键值对：`label: value`。 */
+interface KeyValueRow {
+  label: string;
+  value: string;
+}
+type KeyValueEntry = KeyValueRow | null;
+/**
+ * Format entries into aligned text lines for openModal({ kind: 'info', lines }).
+ * label column aligned by max displayWidth; null → empty line.
+ */
+declare function formatKeyValueLines(entries: readonly KeyValueEntry[]): string[];
+//#endregion
+//#region src/dialogs/SelectPrimitive.d.ts
+interface SelectItemProps {
+  value: string;
+  disabled?: boolean;
+  /** 附加说明（渲染为选中项下方一行弱化色文本，对齐 `SelectOption.detail`）。 */
+  detail?: string;
+  /** 条目行前导空白（默认一个空格）。 */
+  indent?: string;
+  /**
+   * 序号标记：`'number'` 渲染该项在整个列表中的序数（1-based，跨分组连续计数）；
+   * `'-'` / `'·'` 渲染固定项目符。不传 = 不渲染标记（默认现状）。
+   */
+  marker?: 'number' | '-' | '·';
+  /** 行内尾随文案（同一行右侧，非另起一行的 `detail`）。 */
+  trailingLabel?: string;
+  /** `trailingLabel` 的颜色（默认 colors.inactive）。 */
+  trailingColor?: string;
+  /** label 颜色覆盖（独立于 `disabled`，不追加任何文案后缀）。 */
+  labelColor?: string;
+  children: React.ReactNode;
+}
+/** 单个可选条目。本身不渲染——`Select.Root` 遍历 children 树时提取其 props 编译为 `SelectOption`。 */
+declare function SelectItem(_props: SelectItemProps): null;
+declare namespace SelectItem {
+  var displayName: string;
+}
+interface SelectLabelProps {
+  children: React.ReactNode;
+}
+/** 分组标题。本身不渲染——`Select.Group` 读取其 children 文本作为分组标签。 */
+declare function SelectLabel(_props: SelectLabelProps): null;
+declare namespace SelectLabel {
+  var displayName: string;
+}
+interface SelectGroupProps {
+  children: React.ReactNode;
+}
+/** 分组容器：内部第一个 `Select.Label` 作为组标签，其余 `Select.Item` 归入该组。 */
+declare function SelectGroup(_props: SelectGroupProps): null;
+declare namespace SelectGroup {
+  var displayName: string;
+}
+/** 视觉分隔（渲染为一行空白，供顶层 `Select.Group` 之间留白）。本身不渲染——仅作 children 树标记。 */
+declare function SelectSeparator(): null;
+declare namespace SelectSeparator {
+  var displayName: string;
+}
+/** 结构占位符：无内联展开/popover 定位场景，仅透传 children 供 `Select.Root` 直接消费。 */
+declare function SelectContent({
+  children
+}: {
+  children: React.ReactNode;
+}): React.ReactElement;
+declare namespace SelectContent {
+  var displayName: string;
+}
+/** 结构占位符：本仓无"点击展开"交互，Trigger 不渲染任何内容（openModal 已在外层触发展开）。 */
+declare function SelectTrigger(_props: {
+  children?: React.ReactNode;
+}): null;
+declare namespace SelectTrigger {
+  var displayName: string;
+}
+interface SelectRootProps {
+  /** 标题行（DialogFrame header，可选）。 */
+  title?: string;
+  /** 副标题（弱化色，标题下一行，可选）。 */
+  subtitle?: string;
+  /**
+   * 标题下的可聚焦入口（对齐 `/model` 的「N 个 provider 插件待授权 [ 去授权 ]」提示范式，
+   * 即 `SelectDialog` 的 `subtitle && hasActions` 分支）——渲染为 accent 边框盒：
+   * `hint` 提示文案 + 行内 `[ label ]` ghost 按钮，位于 subtitle 之下、列表之上。
+   * 焦点机：列表首项 ↑ → 入口；入口 ↓ → 列表首项；入口 Enter → 触发 `onPress`
+   * （不经 onValueChange，语义是"列表外的动作"）。缺省无入口，行为不变。
+   */
+  headerAction?: {
+    hint: string;
+    label: string;
+    onPress: () => void;
+  };
+  /** 受控选中值；不传则内部自持状态（对齐 Radix `defaultValue`/`value` 双模式，本组件仅支持 defaultValue 语义）。 */
+  defaultValue?: string;
+  /** 选中值变化回调（Enter 确认时触发，而非每次移动都触发——对齐 SelectDialog 现有语义）。 */
+  onValueChange?: (value: string) => void;
+  /** 取消回调（Esc）。 */
+  onCancel?: () => void;
+  /** 单屏可见条目数（默认 10，对齐 SelectDialog）。 */
+  maxVisible?: number;
+  /** 底部快捷键提示（不传则用默认 ↑↓/Enter/Esc 三件套）。 */
+  footer?: React.ReactNode;
+  /** 是否持有键盘焦点（对齐仓库"焦点门禁"惯例，默认 true）。 */
+  active?: boolean;
+  /**
+   * 扩展键盘处理器（对齐 `FileContentViewer.onKey` 先例）：在标准 ↑↓/Enter/Esc/数字直达
+   * 之前调用，收到当前选中项（可能为 `null`，如空列表）；返回 `true` 表示已消费，
+   * 本次按键不再进入标准 select 键位处理（用于扩展如"d 删除选中项"这类消费方自定义动作）。
+   */
+  onKey?: (input: string, key: Key, selected: SelectOption | null) => boolean;
+  /**
+   * 是否套 `DialogFrame` 独立边框（默认 `true`）。传 `false` 时不渲染边框/背景/内边距，
+   * 仅输出 header + rows + footer 三段裸内容——供已有自己外层容器的消费方（如 Welcome
+   * 启动横幅）嵌入复用同一套分组/条目视觉规范，避免双层边框。
+   */
+  frame?: boolean;
+  /**
+   * 是否渲染选中态高亮（默认 `true`）。传 `false` 时所有条目按各自 disabled 态着色，
+   * 不应用 `colors.selection`——供纯展示（无键盘导航意义）场景使用，如 `active=false`
+   * 的静态列表，避免出现"看起来被选中"但实际不可交互的视觉误导。
+   */
+  highlightSelection?: boolean;
+  /** 终端总行数（RFC-301 窗口上限）。缺省 24。 */
+  rows?: number;
+  /**
+   * extension 家族专用高度模式（优化 2026-08-09 用户定稿）：总帧高上限 rows/3
+   * （更紧于全局 RFC-301 的 2/5），透传给 DialogFrame.maxHeight。true 时窗口预算
+   * 同步按 1/3 预算重算（不再叠加 15 min），避免窗口本身已经顶到 min 15 超出上限
+   * 再被 maxHeight 硬切。其他消费方保持全局 2/5 不受影响。
+   */
+  extensionHeightBudget?: boolean;
+  /**
+   * detail 排布位置——对齐 SelectDialog 同名 prop：
+   *   `'below'`（缺省）detail 独占条目下方一行；
+   *   `'inline'` label → trailingLabel → detail 三列同行左对齐（各自按全表最大宽度 pad）。
+   * 缺省 below 保持现有行为不变；inline 适用于 KeybindingsDialog 等需要键位+说明同行的场景。
+   */
+  detailPlacement?: 'below' | 'inline';
+  children: React.ReactNode;
+}
+declare function SelectRoot({
+  title,
+  subtitle,
+  headerAction,
+  defaultValue,
+  onValueChange,
+  onCancel,
+  maxVisible,
+  footer,
+  active,
+  onKey,
+  frame,
+  highlightSelection,
+  rows,
+  extensionHeightBudget,
+  detailPlacement,
+  children
+}: SelectRootProps): React.ReactElement;
+/** `Select.*` 命名空间导出（对齐 `<Select.Root><Select.Group>…` 组合语法）。 */
+declare const Select: {
+  Root: typeof SelectRoot;
+  Trigger: typeof SelectTrigger;
+  Content: typeof SelectContent;
+  Group: typeof SelectGroup;
+  Label: typeof SelectLabel;
+  Item: typeof SelectItem;
+  Separator: typeof SelectSeparator;
+};
+//#endregion
+//#region src/dialogs/PermissionDialog.d.ts
+interface PermissionDialogProps {
+  tool: string;
+  input: string;
+  risk: 'low' | 'medium' | 'high';
+  onApprove: (mode?: 'once' | 'always') => void;
+  onDeny: () => void;
+}
+declare function PermissionDialog({
+  tool,
+  input,
+  risk,
+  onApprove,
+  onDeny
+}: PermissionDialogProps): React.ReactElement;
+//#endregion
+//#region src/dialogs/BashPermissionDialog.d.ts
+interface BashPermissionDialogProps {
+  command: string;
+  risk: 'low' | 'medium' | 'high';
+  /** 模型生成的命令解释文本 */
+  description?: string;
+  /** 「始终允许」拟记住的命令前缀（如 `git status`）；显式呈现避免盲授权。 */
+  alwaysAllowLabel?: string;
+  onApprove: (mode?: 'once' | 'always') => void;
+  onDeny: () => void;
+}
+declare function BashPermissionDialog({
+  command,
+  risk,
+  description,
+  alwaysAllowLabel,
+  onApprove,
+  onDeny
+}: BashPermissionDialogProps): React.ReactElement;
+//#endregion
+//#region src/dialogs/AlertDialog.d.ts
+interface AlertDialogProps {
+  title: string;
+  /** 正文（单行或多行）。 */
+  message: string | string[];
+  /** OK 按钮文案（默认 i18next.t('common.okButton')）。 */
+  okLabel?: string;
+  onOk: () => void;
+}
+declare function AlertDialog({
+  title,
+  message,
+  okLabel,
+  onOk
+}: AlertDialogProps): React.ReactElement;
+//#endregion
+//#region src/dialogs/PromptDialog.d.ts
+interface PromptDialogProps {
+  title?: string;
+  /** 提示正文（单行或多行）。 */
+  message?: string | string[];
+  /** 输入框占位符。 */
+  placeholder?: string;
+  /** 初始值。 */
+  initialValue?: string;
+  /** 提交按钮文案（默认 i18next.t('prompt.submitButton')）。 */
+  submitLabel?: string;
+  /** 取消按钮文案（默认 i18next.t('common.genericCancelButton')）。 */
+  cancelLabel?: string;
+  /** 输入框可用列宽（Cursor 折行计算需要，缺省 60，对齐 InputDialog 默认值）。 */
+  columns?: number;
+  onSubmit: (value: string) => void;
+  onCancel: () => void;
+}
+declare function PromptDialog({
+  title,
+  message,
+  placeholder,
+  initialValue,
+  submitLabel,
+  cancelLabel,
+  columns,
+  onSubmit,
+  onCancel
+}: PromptDialogProps): React.ReactElement;
+//#endregion
+//#region src/stores/compaction-log-store.d.ts
+interface CompactionLogEntry {
+  /** 单调递增 id（store 内生成，供列表 key 与详情选中定位）。 */
+  id: number;
+  timestamp: number;
+  kind: 'compact' | 'prune' | 'history_capped';
+  /** compact：压缩前消息数；prune/history_capped 不适用。 */
+  before?: number;
+  /** compact：压缩后消息数。 */
+  after?: number;
+  /** compact：完整摘要文本（详情视图展示；列表视图只显示计数）。 */
+  summary?: string;
+  /** prune：节省的 token 数。 */
+  tokensSaved?: number;
+  /** prune：本次裁剪的工具输出条数。 */
+  prunedCount?: number;
+  /** history_capped：物理删除的消息条目数。 */
+  removedCount?: number;
+}
+interface CompactionLogState {
+  entries: CompactionLogEntry[];
+}
+interface CompactionLogStore {
+  store: Store<CompactionLogState>;
+  /** RFC-256 收尾：面板可见性由 Router 栈单一真源派生（isInStack('/pane/compaction-log')），
+   *  store 不再持 `open` 布尔——原 toggle() 已删除。 */
+  /** 记一条压缩事件（CLI 订阅 compaction.end 时调用）。 */
+  recordCompaction(before: number, after: number, summary?: string): void;
+  /** 记一条裁剪事件（CLI 订阅 memory.pruned 时调用）。 */
+  recordPrune(tokensSaved: number, prunedCount?: number): void;
+  /** 记一条历史封顶事件（CLI 订阅 session.history-capped 时调用）。 */
+  recordHistoryCapped(removedCount: number): void;
+}
+//#endregion
+//#region src/stores/gallery-store.d.ts
+interface GalleryState {
+  categoryIndex: number;
+  itemIndex: number;
+  variantIndex: number;
+}
+interface GalleryStore {
+  store: Store<GalleryState>;
+  /** RFC-256 收尾：面板可见性由 Router 栈单一真源派生（isInStack('/pane/gallery')），
+   *  store 不再持 `open` 布尔——原 toggle() 已删除。 */
+  reset(): void;
+  setCategoryIndex(i: number): void;
+  setItemIndex(i: number): void;
+  setVariantIndex(i: number): void;
+}
+//#endregion
+//#region src/panes/ShellPane.d.ts
+interface ShellExecution {
+  command: string;
+  output: string;
+  status: 'running' | 'done' | 'error';
+  exitCode: number | null;
+  /** 非空表示被信号终止（如 SIGTERM）。 */
+  terminated?: boolean;
+}
+//#endregion
+//#region src/app-props.d.ts
+interface AppProps {
+  columns?: number;
+  /** 终端总行数（自适应预览高度用）。 */
+  rows?: number;
+  /** 注入 Ink 的 writeToStdout（useStdout().write）给 startTui，
+   *  让已完成历史经 Ink 协调的方式滚进 scrollback（log.clear→写→restoreLastOutput）。 */
+  registerWrite?: (write: (data: string) => void) => void;
+  /** 强制流式预览行数上限（scrollback 模式置 1，动态区恒小避免泄漏）。 */
+  maxPreviewRows?: number;
+  /** 是否已有历史进 scrollback（A 模式 messages 恒空，靠此隐藏 Welcome）。 */
+  hasHistory?: boolean;
+  /** RFC-300 D1：窗口模式（默认）——消息进 store + ScrollableTranscript 窗口渲染。 */
+  windowMode?: boolean;
+  /** RFC-283 D1：scrollback 逃生口模式（OTTO_TUI_SCROLLBACK=1）——pending echo 只走 live 区，
+   *  不进 store。窗口/legacy 模式恒 false（消息已 append 进 store）。 */
+  scrollbackMode?: boolean;
+  /** RFC-345 D5：影子模式——不写盘会话可见性双通道（状态栏徽标 + 输入区 chip）。 */
+  shadow?: boolean;
+  /** RFC-300 M1b：对话流滚动状态（回看态 offset）。 */
+  scrollStore?: ScrollStore;
+  /** RFC-300 M2：加载更早历史（DB 补页）——CLI 注入，返回带 id/seq 的 ChatMessage[] 或 null。 */
+  loadHistory?: (req: {
+    limit: number;
+  }) => Promise<ChatMessage[] | null>;
+  /** RFC-300 M2：messageStore handle（补页头部插入需要）。 */
+  messageStore?: MessageStore;
+  messages?: ChatMessage[];
+  /** 当前界面语言（状态栏徽标显示；en/zh）。 */
+  language?: Lang;
+  /** RFC-263 M5：TUI 主题初值（缺省 dark）；'system' 时配合 systemTheme 解析明暗。 */
+  /** RFC-263 M5：system 模式的终端背景探测结果（启动时 OSC 11 求得）；undefined = 未测到走 dark。 */
+  systemTheme?: 'dark' | 'light';
+  /**
+   * RFC-277 M6：主题预设注册表（含内置 dark/light + extension 贡献的 preset，见
+   * `ThemeRegistry`/M5 `theme-preset-wiring.ts`）。未传时 `ThemeProvider` 落回
+   * `createBuiltinThemeRegistry()`（M1-M5 既有行为，纯内置 dark/light，向后兼容）。
+   */
+  themeRegistry?: ThemeRegistry;
+  /**
+   * RFC-277 M6：按 appearance 分槽的 preset 选择（settings `theme_preset` 字段初值）。
+   * 未传时每个 appearance 都用其 builtin preset（`dark`/`light`），行为等价于 M1-M5。
+   */
+  presetSelection?: ThemePresetSelection;
+  /**
+   * 用户快捷键覆盖表（settings `keybinding_overrides`）——喂给 useAppKeyboard 的
+   * `matchKeyBinding`，使面板/settings.json 里的重绑真正作用于按键分发。
+   * 详见 bootstrap/types.ts 同名字段注释（RFC-174 运行时消费缺口修复）。
+   */
+  keybindingOverrides?: Record<string, KeyBindingPredicate>;
+  /** Shift+Tab 循环切换权限 mode 回调（cli 切并落盘）。 */
+  onCyclePermissionMode?: () => void;
+  cost?: string;
+  /** #/@ sigil 条目数据源（coding 层 PluginInputRegistry，结构同构）。
+   *  仅消费 search；App 持有面板状态、渲染 SigilPane（FocusOwner='sigilPane'）。 */
+  pluginInput?: SigilSearchRegistry;
+  /**
+   * 读取文件全文（用于 @file 条目 Enter 后 FileContentViewer 预览）。
+   * 未提供时 file 条目回退到 preview 截断文本（旧行为）。
+   *
+   * 返回 `{content, truncated}`（RFC-189 追加修复：`readFileCapped` 读取层熔断场景，
+   * `truncated=true` 时下游 `SigilPane` 须强制 `resolveFileContentViews` 的
+   * `preTruncated` 参数走大文件降级候选，不依赖不可靠的长度比较）。
+   */
+  readFileContent?: (path: string) => Promise<{
+    content: string;
+    truncated: boolean;
+  }>;
+  /**
+   * RFC-217 D1：EditedFileFullPane「整个文件 diff」（vs git HEAD）异步取数 provider——
+   * 透传自 TuiOptions.resolveWholeFileDiff，cli 层绑定 projectRoot 注入。缺省
+   * `undefined` 时该模式不可用，`f` 键三态循环退化为现状二态。
+   */
+  resolveWholeFileDiff?: (path: string, operation: EditedFileEntry['operation']) => Promise<{
+    oldContent?: string;
+    newContent?: string;
+    error?: string;
+  }>;
+  /** 按回合编号获取消息切片（1-based turn → 对应回合的 assistant/tool 消息）。 */
+  getTurnMessages?: (turn: number) => ChatMessage[];
+  /** 编辑文件面板是否打开（Ctrl+V 翻转） */
+  editedFilesOpen?: boolean;
+  /** Ctrl+V 翻转编辑文件面板 */
+  onToggleEditedFiles?: () => void;
+  /** 子代理面板是否聚焦（Ctrl+T 翻转） */
+  subagentsOpen?: boolean;
+  /** Ctrl+T 翻转子代理面板聚焦 */
+  onToggleSubagents?: () => void;
+  /** SchedulePane 是否打开。 */
+  scheduleOpen?: boolean;
+  /** 回调打开/关闭 SchedulePane。 */
+  onToggleSchedule?: () => void;
+  /** DraftPane 是否打开（Ctrl+O 或 /draft 命令）。 */
+  draftOpen?: boolean;
+  /** 回调打开/关闭 DraftPane。 */
+  onToggleDraftPane?: () => void;
+  /** ctrl+s 保存当前输入为一条自动命名的草稿（cli 侧写入 session.session.setDrafts() 并落盘）。 */
+  onDraftSave?: (text: string) => void;
+  /** `@` 面板选中一条条目后回调（cli 侧据此维护 settings.recent_mentions MRU 并落盘，
+   *  见 startTui-types.ts TuiOptions.onSigilSelect 同名字段注释）。 */
+  onSigilSelect?: (entry: SigilEntry) => void;
+  /** DraftPane 内 d 删除选中草稿（按当前渲染列表下标，cli 侧据此定位 id 后从 session.setDrafts 移除）。 */
+  onDraftDelete?: (index: number) => void;
+  /** DraftPane 内 d 批量删除全部勾选（Space 多选）的草稿，入参为草稿 id 集合。 */
+  onDraftDeleteMany?: (ids: string[]) => void;
+  /** QueuePane 是否打开（Ctrl+Q 或 /queue 命令）。 */
+  queueOpen?: boolean;
+  /** 回调打开/关闭 QueuePane。 */
+  onToggleQueuePane?: () => void;
+  /** 回调打开/关闭 PromptLogPane（/prompts 命令）。 */
+  onTogglePrompts?: () => void;
+  /** QueuePane 内 d 删除选中排队项。 */
+  onQueueDelete?: (index: number) => void;
+  /** QueuePane 内 J/K 把选中项在队列中下移/上移一位（调整执行顺序）。 */
+  onQueueMove?: (index: number, delta: number) => void;
+  /** QueueEditDialog「确定」：仅更新队列内该 index 项的文本，位置/模式不变。 */
+  onQueueEditText?: (index: number, text: string) => void;
+  /** QueueEditDialog「直接发送」：出队 + 按该项原始 mode 分流执行（send→steer/send，
+   *  bash/memory→原始通道，见 QueueEditDialog 头注释）。 */
+  onQueueSendNow?: (index: number, text: string) => void;
+  /** 持久化输入历史初始条目（从磁盘恢复，传给 PromptInput）。 */
+  initialHistory?: string[];
+  /** RFC-129：外部 shell 历史命令（只读，ghost/Ctrl+R）。 */
+  externalHistoryCommands?: readonly string[];
+  /** 每次 push 新历史条目时回调——携带完整 entries 供上层落盘。 */
+  onHistoryPush?: (entries: readonly string[]) => void;
+  /** RFC-198 §4.4：PasteStore 内存压力分级来源只读视图（cli 层传入，透传给 PromptInput
+   *  构造 createPasteStore）。省略时 PasteStore 固定 healthy 上限。 */
+  residencyGovernor?: PasteStoreResidencySource;
+  /**
+   * errorRetry 卡片焦点索引变更回调（←/→/Tab 触发）。修复：键盘层此前直接原地
+   * mutate `errorRetry.focusIndex`，同一对象引用穿透 `React.memo(App)` 浅比较判定
+   * "props 未变"，导致方向键切焦点在 UI 上不可见（mode='manual' 场景无倒计时兜底，
+   * 表现为永久卡死）。改为经此回调 → 上层 store 生成新对象 → notify() 的响应式路径，
+   * 对齐 setEditedSelIndex/onQueueMove 等既有可导航列表的既定模式。
+   */
+  onErrorRetryFocusChange?: (index: number) => void;
+  /**
+   * RFC-208：脉冲调查瞬态 UI 状态合并更新（phase/selectedIndex/commentText/commentOffset）
+   * ——同 onErrorRetryFocusChange 模式，由 PulseSurveyOverlay 的 FocusBus handler
+   * 调用，经上层 store 生成新对象引用触发响应式重渲。
+   */
+  onPulseSurveyChange?: (updates: Partial<PulseSurveyItem>) => void;
+  /** /tasks 面板是否打开（聚焦时接管 ↑↓/k/o/esc） */
+  backgroundTasksOpen?: boolean;
+  /** Ctrl+P 翻转委派面板聚焦（对齐 Ctrl+T 子代理 / Ctrl+V 编辑文件） */
+  onToggleDelegates?: () => void;
+  /** 关闭 /tasks 面板（esc） */
+  onBackgroundClose?: () => void;
+  /** 杀选中后台进程（k） */
+  onBackgroundKill?: (id: string) => void;
+  /** 看选中后台进程输出（o）→ 进入实时跟随 */
+  onBackgroundViewOutput?: (id: string) => void;
+  /** 退出实时跟随回到列表（esc） */
+  onBackgroundOutputClose?: () => void;
+  /** 应用 ready 的 agent-session 作业（a 键） */
+  onBackgroundApply?: (id: string) => void;
+  /** enter 键切换对话流到 sub-agent。 */
+  onBackgroundSwitch?: (id: string) => void;
+  /** 删除选中的已终结委派项（d 键，运行中/待处理项不可用）。 */
+  onBackgroundDelete?: (id: string) => void;
+  /** esc 退出 sub-agent 对话流（恢复主对话）。 */
+  onExitSubagentContext?: () => void;
+  /** App-local 全屏面板（editedFileFull/taskDetail）开/关时下推 detour 态给 startTui，
+   *  使主代理在面板底下的产出也被缓冲（消残影第二源）。active=false 须在关闭 setState **之前**同步调用（D4）。 */
+  onPaneOwnsViewportChange?: (active: boolean) => void;
+  /**
+   * `focusOwner` 每次变化时下推给 startTui（含变回 'prompt'）——用于对话选中态保护
+   * （用户报告"流式期间弹窗打开时终端全选闪烁"的修复）：任意模态/浮层/导航栈
+   * 面板在场时（`focusOwner !== 'prompt'`）暂停主代理 scrollback 写入，与 `paneOwnsViewport`
+   * 现有的全屏面板缓冲逻辑 OR 合并，见 startTui.tsx。零新增按键、零新增用户心智负担——
+   * 复用 resolveFocus 已有的单一焦点归属判定，弹窗本身就是"用户想要画面稳定"的信号。
+   *
+   * **范围边界（独立审核确认）**：仅覆盖"弹窗/面板在场"这一路径；不覆盖"从未打开任何
+   * 弹窗、纯流式输出期间直接选中文字"——那是终端字符网格持续被 Ink log-update 改写导致
+   * 的更广问题（根因见 packages/tui 相关调研记录），需要独立的"暂停"原语才能覆盖，
+   * 本次不在范围内。
+   */
+  onFocusOwnerChange?: (owner: FocusOwner) => void;
+  /**
+   * RFC-253 M-T5：对话流滚动是否活跃（当前是对话路由 '/' 且无阻断式确认框）。下推给
+   * 树外滚轮消费端（main.ts wheelCoalescer），使**滚轮门与键盘门同源**——非路由确认框
+   * （forcedUpgrade/queueClose/interrupt/popQueued，currentPath 仍为 '/'）在场时同步禁滚。
+   */
+  onScrollActiveChange?: (active: boolean) => void;
+  /** 向运行中的 delegate 补充信息（输出视图内打字 + Enter）。 */
+  onDelegateSupply?: (id: string, text: string) => void;
+  /**
+   * RFC-253 M-T5：初始路由。resume 到有历史会话时传 '/'（直接进对话，消除首帧闪 Home）；
+   * 全新会话缺省 '/home'。Home 与对话是互斥路由，prompt 作为共享 chrome 在两者都活跃。
+   */
+  initialPath?: string;
+  /** 启动横幅参数（version/cwd）；未提供则不显示横幅 */
+  welcome?: {
+    version?: string;
+    buildId?: number;
+    cwd?: string; /** 用户昵称（settings.nickname）：Welcome 具名问候；缺省无名版。 */
+    nickname?: string;
+    updateAvailable?: {
+      latest: string;
+      current: string;
+      newer: boolean;
+      forced: boolean;
+    };
+    weather?: {
+      condition: string;
+      temp: number;
+      location: string;
+    };
+  };
+  /** RFC-234 P2-b：选择会话回调。 */
+  onSessionSelect?: (id: string) => void;
+  /** RFC-335 M6：上下文预算 store（状态栏占用条 + ContextPane 消费）。 */
+  budgetStore?: BudgetStore;
+  contextStore?: ContextStore;
+  /** RFC-333 M3-a：通知/暂停态 store（notifications/paused/pausePending/toast 等真源）。
+   *  M3 让 Region 经 AppStoresContext 自订阅这些字段，替代 cli 计算后 props 下传。 */
+  notificationStore?: NotificationStore;
+  /** RFC-116 M1：性能监控面板 store（startTui 注入）；缺省时内部建空 store（永不开启）。 */
+  perfStore?: PerfStore;
+  /** RFC-019 M2：缓存命中率面板 store（startTui 注入）；缺省时内部建空 store（永不开启）。 */
+  cacheStore?: CacheStore;
+  /** /proxy 面板 store（startTui 注入）；缺省时内部建空 store（永不开启）。 */
+  proxyStore?: ProxyStore;
+  /** /proxy 面板是否打开。 */
+  proxyOpen?: boolean;
+  /** /proxy 面板关闭回调。 */
+  onProxyDismiss?: () => void;
+  /**
+   * /proxy 面板呼出模态对话框（编辑地址走 InputDialog，清除配置走 ConfirmDialog）——
+   * 同 `TuiHandle.openModal`，仅取 ProxyPane 需要的两个重载。
+   */
+  onProxyOpenModal?: {
+    (req: ModalRequestInput): Promise<string | null>;
+    (req: ModalRequestVoid): void;
+  };
+  /** /proxy 面板提交代理地址（编辑/设置）。 */
+  onProxySubmitUrl?: (url: string) => void;
+  /** /proxy 面板切换启用/停用。 */
+  onProxyToggleEnabled?: () => void;
+  /** /proxy 面板清除配置（ConfirmDialog 确认后调用）。 */
+  onProxyClear?: () => void;
+  /** /proxy 面板「测试连接」动作（RFC-288 D4）。 */
+  onProxyTest?: () => void;
+  /** 压缩/裁剪事件日志 store（startTui 注入）；缺省时内部建空 store（永不开启）。 */
+  compactionLogStore?: CompactionLogStore;
+  /** RFC-147 M2：组件画廊面板 store（startTui 注入）；缺省时内部建空 store（永不开启）。 */
+  galleryStore?: GalleryStore;
+  /**
+   * RFC-106 M2：流式高频状态 store（streamingText/streamingThinking/spinnerMode 等 13
+   * 字段，startTui 注入）。消费方（StreamingSpinner/REPLRegion）经 `useAppState(streamStore,
+   * selector)` 细粒度订阅——替代此前的 StreamingContext（D5，已移除）。缺省时内部建空
+   * store（与 inspector 同款兜底模式）。
+   */
+  streamStore?: StreamStore;
+  taskStore?: TaskStore;
+  /** RFC-116 M5：`/perf` 面板内手动刷新键（r）触发。 */
+  onPerfRefresh?: () => void;
+  /** force=true 表示修饰键+Enter（Alt/Ctrl/Cmd）；透传给 startTui 的 submitOrQueue 决定 steer/followUp。 */
+  onSubmit?: (text: string, mode: SubmitMode, force?: boolean) => void;
+  onInterrupt?: () => void;
+  /** Esc：队列非空时逐条删（每按一次删最近一条 followUp 排队）；队列空时才中断。 */
+  onPopQueued?: () => void;
+  onPermissionDecision?: (id: string, approved: boolean, mode?: 'once' | 'always') => void;
+  /** 选定(value)/取消(null) 回调。 */
+  onSelectResolve?: (value: string | null) => void;
+  /** 提交(value)/取消(null) 回调。 */
+  onInputResolve?: (value: string | null) => void;
+  /** 输入对话框的 action 按钮回调（如 OAuth「打开浏览器」）。 */
+  onInputAction?: () => void;
+  /** 首次引导弹层完成回调（携带昵称/语言/主题；未设置的字段=用户跳过）。 */
+  onOnboardingResolve?: (result: OnboardingResult) => void;
+  /** 提交(answers + freeformText)/取消(null) 回调。 */
+  onQuestionsResolve?: (answers: Record<string, string[]> | null, freeformText?: string) => void;
+  /** 确认(confirmed)/取消 回调。 */
+  onConfirmResolve?: (confirmed: boolean, extra?: boolean) => void;
+  /** OK 回调。 */
+  onAlertResolve?: () => void;
+  /** 提交(value)/取消(null) 回调。 */
+  onPromptResolve?: (value: string | null) => void;
+  /** 关闭信息模态窗。 */
+  onInfoDismiss?: () => void;
+  /** RFC-256 收尾：/context 详情子态由 Router 栈派生（/pane/context/detail），非 store 布尔。
+   *  contextDetail 为 App 内部 route 派生值（PanelRegion 消费以抑制 InspectorPane 同屏）。 */
+  contextDetail?: boolean;
+  /** ContextPane「View details」→ push /pane/context/detail（进入逐 turn 明细）。 */
+  onViewDetails?: () => void;
+  /** ContextDetailPane「Esc back」→ goBack 退回 ContextPane。 */
+  onBackToContextPane?: () => void;
+  /** /context 面板整体关闭（ContextPane Esc）——逐层退回主输入。 */
+  onContextDismiss?: () => void;
+  /** RFC-116 M1：关闭性能监控面板（PerfPane 内部 Esc 触发）。 */
+  onPerfDismiss?: () => void;
+  /** RFC-019 M2：关闭缓存命中率面板（CachePane 内部 Esc 触发）。 */
+  onCacheDismiss?: () => void;
+  /** 关闭压缩/裁剪日志面板（CompactionLogPane 内部 Esc 触发）。 */
+  onCompactionLogDismiss?: () => void;
+  /** RFC-147 M2：关闭组件画廊面板（GalleryPane 内部 Esc 触发）。 */
+  onGalleryDismiss?: () => void;
+  /** 关闭记忆模态窗。 */
+  onMemoryDismiss?: () => void;
+  /** 关闭快捷键面板（keybindingPanelProps.onDismiss 回填源，RFC-106 M4 补完）。 */
+  onKeybindingPanelDismiss?: () => void;
+  /** 关闭快捷方式管理面板（shortcutsPanelProps.onDismiss 回填源，RFC-233）。 */
+  onShortcutsDialogDismiss?: () => void;
+  /** 通知中心是否打开（ctrl+n 翻转）。 */
+  notificationsOpen?: boolean;
+  /** ctrl+n 翻转通知中心。 */
+  onToggleNotifications?: () => void;
+  /** 消除单条通知。 */
+  onDismissNotification?: (id: number) => void;
+  /** 关闭通知中心（esc，全部标已读）。 */
+  onCloseNotifications?: () => void;
+  /** 强制升级：点击 [Upgrade] 触发（执行 /upgrade）。 */
+  onUpgrade?: () => void;
+  /** 强制升级：点击 [Cancel] 触发（退出 TUI）。 */
+  onCancelUpgrade?: () => void;
+  /** toast 通知回调（透传给 PromptInput，ctrl+s/o 草稿操作时调用） */
+  onToast?: (title: string, content: string) => void;
+  /** ESC 关闭当前 toast 回调（清除计时器并立即消失）。 */
+  onDismissToast?: () => void;
+  /** 命令 registry ref（向 PromptInput 传递，用于外层注册参数补全函数） */
+  registryRef?: {
+    current: CommandRegistry$1 | null;
+  };
+  /** Shell 补全编排器 ref（向 PromptInput 传递，由 startTui 创建并管理生命周期） */
+  shellBackendRef?: {
+    current: Completer | null;
+  };
+  /** 异步 shell 执行状态（`!! <cmd>` 面板）。 */
+  shellExecution?: ShellExecution | null;
+  /** shell 执行中 Ctrl+C 回调（终止进程）。 */
+  onShellAbort?: () => void;
+  /** shell 执行完成后 Esc 回调（关闭面板）。 */
+  onShellDismiss?: () => void;
+  /** 复制完整 shell 输出到剪贴板（c 键，RFC-225 M1）。 */
+  onShellCopyOutput?: () => void;
+  /** 问 AI（a 键，仅错误态，RFC-225 M2）。 */
+  onShellAskAi?: () => void;
+  /** M-N3：当前消息流中注册的 A2UI 按钮（数字键 1-9 快捷触发）。 */
+  a2uiButtons?: A2uiButtonInfo[];
+  /** M-N3：A2UI 按钮触发回调（componentId, action, payload）。 */
+  onA2uiAction?: (componentId: string, action: string, payload?: Record<string, unknown>) => void;
+  /** ESC 撤回时把文本回填到 PromptInput 的桥接 ref。 */
+  restoreInputRef?: {
+    current: {
+      fill: (text: string) => void;
+    } | null;
+  };
+  /** RFC-338 D7a：粘贴缓存树外桥接 ref（cli hydrate/落盘），同 restoreInputRef 模式。 */
+  pasteBridgeRef?: {
+    current: {
+      hydrate: (snapshot: PasteSnapshot | null | undefined) => void;
+      export: () => PasteSnapshot;
+    } | null;
+  };
+  /** 刚 echo、模型尚未返回首字节的 user 消息（ESC 撤回窗口态快照）。 */
+  pendingEcho?: {
+    text: string;
+    mode: string;
+  } | null;
+  /** ESC 撤回 pending 消息时通知上层（text=原文、mode=提交模式）。 */
+  onWithdrawPending?: (text: string, mode: string) => void;
+  /** RFC-337 D3：ESC 撤回一条运行中追加（steer）时通知上层（id=steer 稳定 id）。
+   *  cli 侧 removeSteer 命中（未消费）→ 撤回 live 回显；未命中（已 drain）→ 退化中止整回合。 */
+  onWithdrawSteer?: (id: string) => void;
+}
+//#endregion
+//#region src/App.d.ts
+declare const App: React.MemoExoticComponent<(props: AppProps) => React.ReactElement>;
+//#endregion
+//#region src/components/Spinner.d.ts
+interface SpinnerProps {
+  verb?: string;
+  elapsed?: boolean;
+  paused?: boolean;
+  /** Monotonically increasing response length — used for stall detection */
+  responseLength?: number;
+  /** Whether any tools are currently active */
+  hasActiveTools?: boolean;
+  /** 累计 token 数（显示 ↓ Nk tokens；0 则不显示） */
+  tokens?: number;
+  /** RFC-097：LLM 调用阶段——requesting（已发起/等待首字节）｜responding（已收到首字节/流式中）。
+   *  缺省不显示阶段箭头（向后兼容既有调用方，如压缩场景不区分阶段）。 */
+  mode?: 'requesting' | 'responding';
+  /** RFC-097：输出占比（0-100，= min(outputTokens/maxOutput,1)*100）。仅 responding 阶段显示；
+   *  `maxOutput` 缺失/非法时调用方应传 undefined——组件不做除法，只做纯展示，避免 NaN 由此扩散。 */
+  progressPercent?: number;
+  /** 工具调用预算：本窗口已用轮次（与 maxToolTurns 一起决定是否显示 x/y tools）。 */
+  toolTurnCount?: number;
+  /** 工具调用预算：本窗口上限（0/undefined = 未知，不显示 x/y 提示）。 */
+  maxToolTurns?: number;
+  /** RFC-097 M5：压缩场景的虚假进度条——无真实完成度信号（黑盒单次 LLM 调用），按耗时
+   *  渐近估算（`~{pct}%`，硬顶 92%，见下方 estimatedProgressPercent）。与 `progressPercent`
+   *  互斥使用（后者是真实 token/maxOutput 占比），两者共用同一展示位但语义不同——诚实标记
+   *  是 `~` 前缀（STR.spinner.estimatedPercent），不额外用配色区分（配色已被 stall/budget 占用）。 */
+  estimatedProgress?: boolean;
+}
+declare function Spinner({
+  verb,
+  elapsed,
+  paused,
+  responseLength,
+  hasActiveTools,
+  tokens,
+  mode,
+  progressPercent,
+  toolTurnCount,
+  maxToolTurns,
+  estimatedProgress
+}: SpinnerProps): React.ReactElement;
+//#endregion
+//#region src/layouts/GroupDivider.d.ts
+interface GroupDividerProps {
+  label: string;
+  /** 前导空白字符串（默认 1 个空格，对齐多数消费方）。 */
+  indent?: string;
+}
+declare function GroupDivider({
+  label,
+  indent
+}: GroupDividerProps): React.ReactElement;
+//#endregion
+//#region src/utils/tool-label.d.ts
+/**
+ * tool-label.ts — 工具名 → 人类友好展示名（统一所有工具的展示）.
+ *
+ * 规则：显式 label 优先；否则美化名字：
+ *   - MCP 工具 `mcp__<server>__<tool>` → "<server> / <tool>"（剥前缀，否则丑成 "Mcp X Y"）
+ *   - snake_case / kebab-case → Title Case（task_delegate → "Task Delegate"、grill_me → "Grill Me"）
+ * "没 label 用名字"——但名字先过美化。
+ */
+/** RFC-097 M2：压缩期间复用 `activeTool` 状态机的哨兵值（非真实工具名，`__` 双下划线前后缀
+ *  避免与任何真实工具名/MCP 命名空间碰撞）。消费方（`StreamingSpinner.tsx`）据此走
+ *  `STR.compact.ingVerb` 分支而非 `STR.bg.runningVerb(activeTool)`。 */
+declare const COMPACTING_SENTINEL = "__compacting__";
+//#endregion
+//#region src/components/Segmented.d.ts
+interface SegmentItemSpec {
+  key: string;
+  label: string;
+  disabled?: boolean;
+}
+interface SegmentedProps {
+  items: SegmentItemSpec[];
+  /** 当前激活 tab 的 key。 */
+  activeKey: string;
+  /** 激活态背景色（对齐 Button color，默认 accent 蓝）。 */
+  color?: ButtonColor;
+  /** tabIndex for focus traversal（默认 -1 = 不参与）。 */
+  tabIndex?: number;
+  /** ←→ 切换时回调。 */
+  onSelect?: (key: string) => void;
+  /**
+   * 可用总宽（RFC-272 D2）。传入后启用**宽度自适应窗口**：以激活项为中心裁出可见窗口，
+   * 溢出侧渲染 `← N` / `→ N`，超长标签按显示宽度截断（CJK 安全）。
+   *
+   * **未传时退化为全展开**（原行为，向后兼容）——但那样在窄终端会溢出，
+   * 而 stock Ink 不裁溢出即残影（RFC-271 §1.2），故新消费方应始终传入。
+   */
+  availableWidth?: number;
+  /**
+   * 数字键 1-9 直达（RFC-272 D3）——**缺省关闭，必须显式开启**。
+   *
+   * 不可默认开启的原因（评审 P1-1，实证核实）：`SelectDialog` 的 searchable 模式规定
+   * 「所有可打印字符进入过滤输入框」（`SelectDialog.tsx` 头注释），数字键若被本组件
+   * 无条件吞掉会劫持用户的过滤输入。故仅 tab 数 ≤9 且无文本输入的场景（如 InspectorPane）
+   * 显式开启。
+   */
+  enableDigitAccess?: boolean;
+}
+declare function Segmented({
+  items,
+  activeKey,
+  color,
+  tabIndex,
+  onSelect,
+  availableWidth,
+  enableDigitAccess
+}: SegmentedProps): React.ReactElement;
+//#endregion
+//#region src/components/ScrollIndicators.d.ts
+interface ScrollIndicatorAboveProps {
+  /** 上方是否还有更多内容。 */
+  hasMore: boolean;
+  /** 上方隐藏的条目/行数（提供时渲染精确计数 `↑ 上方 N 行`；不提供则渲染无计数的 `▲ 更多`）。 */
+  count?: number;
+  /** 前导空白（默认一个空格，对齐多数消费方；部分消费方如 SigilPane 用两格）。 */
+  indent?: string;
+}
+/** 上方"还有更多"指示行。`hasMore=false` 时不渲染任何内容（含外层容器）。 */
+declare function ScrollIndicatorAbove({
+  hasMore,
+  count,
+  indent
+}: ScrollIndicatorAboveProps): React.ReactElement | null;
+interface ScrollIndicatorBelowProps {
+  /** 下方是否还有更多内容。 */
+  hasMore: boolean;
+  /** 下方隐藏的条目/行数（提供时渲染精确计数 `↓ 下方 N 行`；不提供则渲染无计数的 `▼ 更多`）。 */
+  count?: number;
+  /** 前导空白（默认一个空格，对齐多数消费方；部分消费方如 SigilPane 用两格）。 */
+  indent?: string;
+}
+/** 下方"还有更多"指示行。`hasMore=false` 时不渲染任何内容（含外层容器）。 */
+declare function ScrollIndicatorBelow({
+  hasMore,
+  count,
+  indent
+}: ScrollIndicatorBelowProps): React.ReactElement | null;
+//#endregion
+//#region src/router/TabScope.d.ts
+interface TabScopeProps {
+  /** 私有虚拟路径，隔离本 scope 与外部（不参与任何导航匹配，仅作 registry 路由键）。 */
+  scopeId: string;
+  children: React.ReactNode;
+}
+/**
+ * TabScope 上下文——子组件可读取本 scope 的焦点状态（替代裸 useRouter 的降级读法）。
+ */
+interface TabScopeContextValue {
+  activeId: string | null;
+  registry: TabableRegistry;
+}
+declare function useTabScope(): TabScopeContextValue;
+declare function TabScope({
+  scopeId,
+  children
+}: TabScopeProps): React.ReactElement;
+//#endregion
+//#region src/main.d.ts
+declare function startTui(opts: TuiOptions): Promise<TuiHandle>;
+//#endregion
+//#region src/session-contract/reduce.d.ts
+/** reduce 目标：TuiHandle 的渲染子集（结构镜像；真 tui 满足；测试用录制 fake）。tui 特定，不进共享包。 */
+interface TuiSink {
+  pushMessage(msg: ChatMessage): void;
+  echoUserInput(text: string): void;
+  pushEngineEvent(event: TuiStreamEvent): void;
+  setTasks(tasks: TaskItem[], title?: string): void;
+  addTurnBoundary?(messageIndex: number): void;
+  getNotifyStats?(): NotifyStats;
+}
+interface ReducerState {
+  streamBuf: string;
+  thinkBuf: string;
+  turnStart: number;
+  turnToolCount: number;
+  lastTasks: TaskItem[];
+  messageIndex: number;
+}
+declare function createReducerState(): ReducerState;
+/**
+ * resume 时从 ChatMessage 流**派生** turnBoundaries（不存索引，避免 rebase）。
+ *
+ * 回合起点 = role:'user' 的 ChatMessage（agentMessagesToChatMessages 已滤掉 internal 注入消息）。
+ * 幸存的 K 个 user 消息 = 最近 K 个回合 [turnCount-K+1 .. turnCount]（被 pruneOldMessages 裁掉的
+ * 早期回合不在其中）。产物满足 getTurnMessages(turn)=slice(b[turn-2]??0, b[turn-1]??len) 契约：
+ *   - b 长度 = turnCount-1（turnCount 个回合的 turnCount-1 个分隔点；末回合 end 越界→undefined→len）。
+ *   - b[k] = 绝对回合 k+2 的起始消息位置。
+ *   - 末尾对齐：userPositions[i] 属绝对回合 (turnCount-K+1+i)，置 b[turnCount-K-1+i]=userPositions[i]。
+ *   - 早期 pruned 回合的分隔点压平到首个幸存位 → slice 为空（其消息确已不存在，合理降级）。
+ *
+ * turnCount 缺失（旧快照）时传 K（= user 消息数）→ 退化为无 prune 的自然对齐。
+ */
+declare function deriveTurnBoundaries(messages: ReadonlyArray<{
+  role?: string;
+}>, turnCount: number): number[];
+/** 持久化回合摘要条目的最小字段面（与 @x-otto/session TurnSummaryEntry 结构一致，不直接依赖该包）。 */
+interface PersistedTurnSummary {
+  turn: number;
+  status: 'done' | 'error' | 'interrupted' | 'incomplete';
+  toolCount: number;
+  elapsedMs: number;
+  tokensUsed?: number;
+  cacheHitRatio?: number;
+  model?: string;
+  tasksDone?: number;
+  tasksTotal?: number;
+  completedAt: number;
+}
+/**
+ * resume 时把持久化的回合摘要插回 ChatMessage 流对应位置——复用 `deriveTurnBoundaries`
+ * 同款的"user 消息位置 = 绝对回合起点"对齐算法（幸存 K 个 user 消息 = 最近 K 个回合
+ * [turnCount-K+1 .. turnCount]），保证摘要行落在它所属回合的转录内容之后、下一回合
+ * 开始之前——与实时产出时（`prompt.end` 时机）的相对位置一致。
+ *
+ * 早于幸存范围的摘要（turn < turnCount-K+1，对应转录已被 pruneOldMessages 裁掉）静默
+ * 丢弃——它们指向的转录内容本就不存在，插入一条"孤儿摘要"（前面没有对应回合内容）
+ * 比完全不显示更容易误导用户，故按不可恢复处理（同 deriveTurnBoundaries 头注释
+ * "早期 pruned 回合的分隔点压平...其消息确已不存在，合理降级"的既有降级原则）。
+ *
+ * 纯函数：入参不被修改，返回插入后的新数组。
+ */
+declare function insertTurnSummaries(messages: readonly ChatMessage[], turnSummaries: readonly PersistedTurnSummary[], turnCount: number): ChatMessage[];
+/** `prompt.end` 事件的最小字段面——`buildTurnSummary` 只读这几个字段，不依赖完整 SessionEvent 判别式。 */
+interface PromptEndFields {
+  tokens?: number;
+  model?: string;
+  cacheHitRatio?: number;
+  /** RFC-235：本回合实际 effort 档（供回合摘要行显示 ·Effort）。 */
+  effort?: string;
+  /** 回合结束原因（缺省 = 'completed'，向后兼容旧事件/resume 历史）。 */
+  stopReason?: 'completed' | 'interrupted' | 'error';
+}
+/**
+ * 回合完成摘要对象——渲染（`reduceToTui` 内部 `sink.pushMessage`）与持久化
+ * （`interactive-events.ts` 的 `se.kind === 'prompt.end'` 分支，对齐 `tasks.update` →
+ * `setTodoList` 既有写法）共用同一份构造逻辑，避免两处独立实现产生字段漂移。
+ *
+ * status 优先级（从高到低）：
+ *   1. stopReason = 'error' → status = 'error'（错误终止）
+ *   2. stopReason = 'interrupted' → status = 'interrupted'（用户中断）
+ *   3. 有未完成 task → status = 'incomplete'（LLM 主动结束但 task 没做完）
+ *   4. 其余 → status = 'done'（正常完成）
+ */
+declare function buildTurnSummary(ev: PromptEndFields, state: ReducerState): {
+  status: "incomplete";
+  tasksDone: number;
+  tasksTotal: number;
+  toolCount: number;
+  elapsedMs: number;
+  tokensUsed: number | undefined;
+  model: string | undefined;
+  effort: string | undefined;
+  cacheHitRatio: number | undefined;
+} | {
+  status: "interrupted" | "error" | "done";
+  toolCount: number;
+  elapsedMs: number;
+  tokensUsed: number | undefined;
+  model: string | undefined;
+  effort: string | undefined;
+  cacheHitRatio: number | undefined;
+};
+declare function reduceToTui(ev: SessionEvent, sink: TuiSink, state: ReducerState): void;
+//#endregion
+//#region src/utils/print-messages.d.ts
+/**
+ * print-messages.ts — Backward-compatible ANSI message printer for non-interactive mode.
+ *
+ * Used by packages/coding/src/modes/run-modes.ts in print mode.
+ * Prints AgentMessages to stdout with minimal ANSI formatting.
+ */
+interface PrintOptions {
+  /** Terminal columns */
+  columns?: number;
+  /** Whether to show thinking content */
+  showThinking?: boolean;
+  /** Context window size (unused, kept for API compat) */
+  contextWindow?: number;
+  /** Start time for elapsed calculation */
+  startTime?: number;
+}
+/** 结构化最小消息形状——运行时按 role 分发，接受任意消息联合（AgentMessage 等）。 */
+interface PrintableMessage {
+  role?: string;
+  content?: unknown;
+  tool_calls?: unknown;
+}
+declare function printMessages(messages: readonly PrintableMessage[], _opts?: PrintOptions): void;
+//#endregion
+//#region src/search/incremental-search.d.ts
+interface IncrementalSearcher<T> {
+  search(query: string): RankedMatch<T>[];
+}
+/** 绑定固定候选集，返回同步增量搜索函数。 */
+declare function createIncrementalSearcher<T>(items: readonly SearchableItem<T>[], options?: FuzzySearchOptions): IncrementalSearcher<T>;
+//#endregion
+//#region src/bootstrap/store-tui-sink.d.ts
+interface StoreTuiSink {
+  pushMessage(msg: ChatMessage): void;
+  echoUserInput(text: string): void;
+  pushEngineEvent(event: TuiStreamEvent): void;
+  getNotifyStats?(): NotifyStats;
+  setTasks?(tasks: TaskItem[], title?: string): void;
+  addTurnBoundary?(messageIndex: number): void;
+}
+interface StoreTuiSinkDeps {
+  pushMessage(msg: ChatMessage): void;
+  echoUserInput(text: string): void;
+  pushEngineEvent(event: TuiStreamEvent): void;
+  getNotifyStats(): NotifyStats;
+  setTasks(tasks: TaskItem[], title?: string): void;
+  addTurnBoundary(messageIndex: number): void;
+}
+declare function createStoreTuiSink(deps: StoreTuiSinkDeps): StoreTuiSink;
+//#endregion
+//#region src/bootstrap/session-event-reduce-bridge.d.ts
+interface AttachEventBridge {
+  handle(event: RemoteSessionEvent): void;
+  /** Reset reducer state after authoritative snapshot hydration. */
+  reset(messageCount?: number): void;
+}
+declare function createSessionEventReduceBridge(sink: StoreTuiSink): AttachEventBridge;
+//#endregion
+export { type A2uiContent, AlertDialog, type AlertDialogProps, type AlertRequest, App, type AppProps, type AssistantMessage, type AttachDataSourceDeps, BASH_HISTFILE_SOURCE, BashPermissionDialog, BracketedPasteHandler, type BracketedPasteOptions, type BudgetState, type BudgetStore, type BudgetView, type BufferEntry, Button, type ButtonColor, type ButtonProps, type ButtonVariant, COMPACTING_SENTINEL, type ChatMessage, type Coalescer, type CollapsedBlock, type CollapsibleMessage, type Command, type CommandContext, type CommandEntry, type CommandRegistry, type CommandResult, ConfirmDialog, type ConfirmDialogProps, type ConfirmRequest, type CreatePasteStoreOptions, Cursor, DEFAULT_SENSITIVE_PATTERNS, DIALOG_BORDER, DataList, type DataListEntry, type DataListProps, type DataListRow, type DataListTone, type DiffHunk, type DiffHunkLine, type DraftItemView, type EditAction, type EditKeyEvent, type EditResult, type ErrorRetryAction, type ErrorRetryActionKind, type ErrorRetryItem, type ExtensionDetailAction, type ExtensionDetailRequest, type ExtensionListEntry, type ExtensionMenuContribution, type ExtensionsListRequest, FIGURES, FISH_HISTFILE_SOURCE, type FiguresMap, type FocusOwner, type FocusStyle, type FuzzySearchOptions, GroupDivider, type GroupDividerProps, type GuardState, type HighlightRange, type HistoryEntry, type HistorySource, Home, type HomeProps, type IncrementalSearcher, type InputBuffer, type InputHistory, type InputMode, type InsertHistoryMode, type InsertHistoryOptions, type KeyBindingPredicate, type KeyValueEntry, type KeyValueRow, LAYOUT, type Lang, type LangMode, type MarkdownThemeOverrides, MeasuredText, MemoryDialog, type MemoryDialogProps, type MemoryEntry, type MemoryEntrySource, type MergeHistoryOptions, type MergedHistoryProvider, Message, type MessageContent, type MessageProps, type NotifyScheduler, type NotifyStats, OTTO_SESSION_SOURCE, type ObservationLike, PALETTE, PANEL_BORDER, type ParentWorkspaceChoice, type ParentWorkspacePromptOptions, type ParseBashHistoryOptions, type ParseFishHistoryOptions, type ParseZshHistoryOptions, type ParsedExtendedKey, type PasteEvent, type PasteSnapshot, type PasteSnapshotEntry, type PasteStore, type PasteStoreResidencySource, type PermissionDecision, PermissionDialog as PermissionDialogDialog, type PersistedTurnSummary, type PluginMessageRenderer, type PluginRegistration, type PrintOptions, type PrintableMessage, PromptDialog, type PromptDialogProps, type PromptEndFields, PromptInput, type PromptRequest, type ProviderUsageBadgeItem, type QueryGuard, QueuedCommands, REPLRegion, type REPLRegionProps, type RankedMatch, type RateLimitType, type ReducerState, type RegisteredRenderer, type RemoteSessionEvent, type RemoteSessionSnapshot, type RenderOptions, type Risk, SPACING, STATUS, STREAM_COALESCE_MS, ScrollIndicatorAbove, ScrollIndicatorBelow, type SearchMatch, type SearchableItem, Segmented, Segmented as Tabs, type SegmentedProps, Select, type SelectGroupProps, type SelectItemProps, type SelectLabelProps, type SelectOption, type SelectOptions, type SelectRootProps, type SelectState, type SessionDataSource, type SessionDataTarget, type SessionListItem, type SessionTransport, type SigilEntry, type SigilKind, SigilPane, type SigilPaneProps, type SigilPrefix, type SigilSearchRegistry, type SigilTrigger, type SlashNavigateAction, Spinner, type SpinnerProps, type StopReason, type Store, type StreamChunk, type StreamCommitResult, type StreamCommitState, type StreamEvent, type SubagentContext, type SubmitMode, type SubmitRoute, type SubmitRouteCtx, type SubsequenceResult, THEME, TabScope, type TabScopeProps, Tabable, type TabableProps, type TextContent, TextInput, type TextInputProps, type ThemeAppearance, type ThemeColors, type ThemePreset, type ThemePresetInput, type ThemePresetSelection, type ThemePresetSource, ThemeRegistry, type ThinkingContent, type ToolCall, type ToolCompletionMessage, type ToolMessage, type TrustPromptChoice, type TuiHandle, type TuiPanelRegistration, type TuiSink, type TuiStreamEvent, type TypeaheadState, type UseTabableOptions, type UserMessage, type WorkspaceTrustPromptOptions, type WrapPolicy, ZSH_HISTFILE_SOURCE, applySigilCompletion, applySlashCompletion, beginSyncFrame, buildTurnSummary, clearPluginRenderers, collapseMessages, createAttachSessionDataSource, createBudgetStore, createBuiltinCommands, createBuiltinThemeRegistry, createCommandRegistry, createIncrementalSearcher, createInputBuffer, createInputHistory, createLocalSessionDataSource, createMergedHistoryProvider, createPasteStore, createQueryGuard, createReducerState, createSelectState, createSessionEventReduceBridge, createStoreTuiSink, cycleIndex, deriveTurnBoundaries, detectLanguage, displayWidth, effectiveBusy, endSyncFrame, entriesToCommands, expandCollapsed, extractSigilPrefix, extractSlashPrefix, formatAgentDiagnosticsText, formatKeyValueLines, formatProviderUsageLimitTypeFull, formatTranscriptText, formatTurnTimeline, getCommandSuggestions, getInputViewport, getKillRingEntries, getMarkdownThemeUserOverrides, guardScrollbackStdout, handleEditingKey, handleEditingKeyExtended, i18next, initI18n, initStreamCommit, insertHistory, insertHistorySequence, insertTurnSummaries, isSensitiveCommand, isUsingOverage, makeCoalescer, makeNotifyScheduler, matchSubsequence, mergeHistoryEntries, navigateSuggestions, normalizeCommand, observationLiveFields, observationRow, osc52QuerySequence, osc52Write, osc8FilePath, osc8Hyperlink, parseBashHistory, parseExtendedKey, parseFishHistory, parseZshHistory, pickInsertMode, positionsToHighlightRanges, preWrapLine, preWrapLines, printMessages, promptParentWorkspaceChoice, promptWorkspaceTrust, rankCandidates, rankLabeledItems, rankNamedItems, reduceToTui, registerPluginRenderers, renderInline, renderMarkdownToLines, renderMessageLines, resetKillRing, resolveHorizontalStep, routeSubmit, safeCommitBoundary, scoreSubsequence, setMarkdownThemeUserOverrides, shouldStripSyncOutput, shouldUseViewport, showCommandPalette, slashCommandName, startTui, streamCommitStep, stringWidth, stripScrollbackClear, stripSyncSequences, stripSyncStdout, subagentEntryStatus, subagentRestoreFields, t, toggleCollapse, useAppState, useTabScope, useTabable, withSyncFrame };
+//# sourceMappingURL=index.d.ts.map