@24klynx/tui 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,1309 @@
+import React, { ReactNode } from "react";
+import { Key } from "ink";
+import { Message, Session } from "@lynx/core";
+
+//#region src/components/PermissionRequest.d.ts
+/** Safety level determines badge color and severity. */
+type SafetyLevel = "Safe" | "WorkspaceSafe" | "RequiresApproval" | "Dangerous";
+/** Information about a pending permission request. */
+interface PermissionRequestData {
+  /** Unique request identifier. */
+  requestId: string;
+  /** Name of the tool being invoked. */
+  toolName: string;
+  /** Safety level of the tool. */
+  safety: SafetyLevel;
+  /** Human‑readable description of what the tool will do. */
+  description: string;
+  /** Optional parameter summary for display. */
+  parameters?: Record<string, unknown>;
+}
+/** Callback when the user makes a decision. */
+type PermissionChoice = "allow" | "deny" | "always_allow";
+type PermissionCallback = (requestId: string, choice: PermissionChoice) => void;
+/** Props for the PermissionRequest modal. */
+interface PermissionRequestProps {
+  request: PermissionRequestData;
+  onDecide: PermissionCallback;
+  onCancel: () => void;
+}
+/**
+ * Permission request dialog.
+ *
+ * Users navigate with A/D/L keys and can press Escape to cancel.
+ * After AUTO_DENY_MS, the dialog auto‑denies.
+ */
+declare function PermissionRequest({
+  request,
+  onDecide,
+  onCancel
+}: PermissionRequestProps): React.ReactElement;
+//#endregion
+//#region src/types.d.ts
+/** Model descriptor for the model picker. Mirrors @lynx/llm's ModelInfo. */
+interface TuiModelInfo {
+  /** Provider‑unique model identifier. */
+  id: string;
+  /** Human‑readable label. */
+  label: string;
+  /** Maximum context window in tokens. */
+  contextWindow: number;
+  /** Maximum output tokens. */
+  maxOutput: number;
+  /** Approximate USD per 1M input tokens. */
+  inputPrice?: number;
+  /** Approximate USD per 1M output tokens. */
+  outputPrice?: number;
+}
+interface TuiCallbacks {
+  /** User submitted a message. Returns the assistant response stream. */
+  onInput(message: string): AsyncGenerator<TuiStreamEvent, void, void>;
+  /** User requested session switch. */
+  onSessionPick(sessionId: string): void;
+  /** User requested a permission action. */
+  onPermissionReply(requestId: string, approved: boolean): void;
+  /** User triggered abort (first Ctrl+C). */
+  onAbort(): void;
+  /** User selected a model. */
+  onModelPick?(modelId: string): void;
+  /** User toggled a config setting. */
+  onConfigChange?(key: string, value: unknown): void;
+  /** User selected a theme. */
+  onThemeChange?(themeName: string): void;
+  /** Budget update after each turn — token count and estimated cost. */
+  onBudgetUpdate?: (tokensUsed: number, costUsd: number, maxUsd: number) => void;
+  /** Connect to an MCP server by name. */
+  onMcpConnect?(serverName: string): void;
+  /** Disconnect from an MCP server by name. */
+  onMcpDisconnect?(serverName: string): void;
+  /** Reconnect a failed MCP server by name. */
+  onMcpReconnect?(serverName: string): void;
+  /** Called when user wants to add an MCP server via the panel. */
+  onMcpAddServer?: (serverConfig: {
+    name: string;
+    transport: string;
+    url?: string;
+    command?: string;
+    args?: string[];
+  }) => void;
+  /** Called when user wants to remove an MCP server. */
+  onMcpRemoveServer?: (serverName: string) => void;
+  /** Load a plugin by name. */
+  onPluginLoad?(pluginName: string): void;
+  /** Unload a plugin by name. */
+  onPluginUnload?(pluginName: string): void;
+  /** Create a new session with the given label. */
+  onSessionCreate?(label: string): void;
+  /** Fork the current session with the given label. */
+  onSessionFork?(newLabel: string): void;
+  /** Rename the current session. */
+  onSessionRename?(newLabel: string): void;
+  /** Delete a session by ID. */
+  onSessionDelete?(sessionId: string): void;
+  /** Resume a session by ID (switch active session). */
+  onSessionResume?(sessionId: string): void;
+  /** Compact the current session's conversation context. */
+  onSessionCompact?(): void;
+  /** Request diff output for git changes. */
+  onRequestDiff?(): Promise<Array<{
+    path: string;
+    status: string;
+    diff: string;
+  }>>;
+  /** Request snapshot list. */
+  onRequestSnapshots?(): Promise<Array<{
+    id: string;
+    timestamp: number;
+    label: string;
+  }>>;
+  /** Request background task list. */
+  onRequestTasks?(): Promise<Array<{
+    id: string;
+    name: string;
+    status: "running" | "queued" | "done" | "failed";
+    error?: string;
+  }>>;
+  /** Open external editor for the current input, returns edited text or null if cancelled. */
+  onOpenExternalEditor?(currentText: string): Promise<string | null>;
+}
+/** Stream event from the agent engine, simplified for TUI rendering. */
+type TuiStreamEvent = {
+  type: "text_delta";
+  text: string;
+} | {
+  type: "tool_use";
+  name: string;
+  callId: string;
+} | {
+  type: "tool_result";
+  callId: string;
+  content: string;
+} | {
+  type: "reasoning_status";
+  status: "started" | "ended";
+  durationMs?: number;
+  text?: string;
+} | {
+  type: "tool_recap";
+  summary: string;
+  toolCount: number;
+  durationMs: number;
+} | {
+  type: "error";
+  message: string;
+} | {
+  type: "done";
+  totalTokens?: number;
+  costUsd?: number;
+};
+type ViewId = "chat" | "sessions" | "help" | "permission" | "settings" | "commands" | "model" | "theme" | "confirm" | "input_prompt" | "doctor" | "file_picker" | "stash" | "mcp" | "plugin" | "skills" | "context" | "usage" | "diff" | "snapshots" | "tasks" | "skill_pick";
+interface ViewEntry {
+  id: ViewId;
+  props?: Record<string, unknown>;
+}
+interface ViewStack {
+  push(view: ViewEntry): void;
+  pop(): ViewEntry | undefined;
+  replace(view: ViewEntry): void;
+  top(): ViewEntry | undefined;
+  toArray(): ViewEntry[];
+}
+type ThemeName = "dark" | "light" | "catppuccin" | "monokai" | "solarized" | "dracula";
+interface TuiTheme {
+  name: ThemeName;
+  /** Semantic color tokens — 60+ available, grouped by purpose. */
+  colors: Record<string, string>;
+}
+/** Status of an MCP server connection. */
+type McpConnectionStatus = "disconnected" | "connecting" | "connected" | "error";
+/** MCP server connection info displayed in the /mcp panel. */
+interface McpConnectionInfo {
+  /** Server name (unique key). */
+  name: string;
+  /** Connection status. */
+  status: McpConnectionStatus;
+  /** Number of tools exported by this server. */
+  toolCount: number;
+  /** Human-readable status or error detail. */
+  detail: string;
+  /** Transport type: "stdio" | "sse" | "ws" | "inproc". */
+  transport?: string;
+  /** Authentication status for OAuth/XAA-enabled servers. */
+  authStatus?: "none" | "authenticated" | "expired";
+  /** Number of resources exported by this server. */
+  resourceCount?: number;
+  /** Tools exported by this server (for detail view). */
+  tools?: Array<{
+    name: string;
+    description: string;
+  }>;
+  /** Resources exported by this server (for detail view). */
+  resources?: Array<{
+    name: string;
+    uri: string;
+  }>;
+}
+/** Plugin descriptor displayed in the /plugin panel. */
+interface PluginInfo {
+  /** Plugin name (unique key). */
+  name: string;
+  /** Installed version. */
+  version: string;
+  /** Short description of what the plugin does. */
+  description: string;
+  /** Whether the plugin is currently loaded. */
+  loaded: boolean;
+}
+/** Skill descriptor displayed in the /skills panel. */
+interface SkillInfo {
+  /** Skill name (unique key). */
+  name: string;
+  /** Short description of what the skill does. */
+  description: string;
+  /** Source origin: builtin / user / project. */
+  source: "builtin" | "user" | "project";
+}
+/** Context information displayed in the /context panel. */
+interface ContextInfo {
+  /** Number of facts loaded from memory. */
+  memoryFacts: number;
+  /** Number of rules loaded from ~/.lynx/rules/ and workspace .claude/rules/. */
+  rules: number;
+  /** Number of skills discovered from all sources. */
+  skills: number;
+  /** Currently active model ID. */
+  model: string;
+  /** Workspace directory path. */
+  workspace: string;
+  /** Active session label. */
+  sessionLabel: string;
+}
+/** Usage information displayed in the /usage panel. */
+interface UsageInfo {
+  /** Total tokens used in the current session. */
+  tokensUsed: number;
+  /** Estimated cost in USD. */
+  costUsd: number;
+  /** Soft budget limit in tokens, or 0 if unlimited. */
+  budgetMaxTokens: number;
+  /** Hard budget limit in USD, or 0 if unlimited. */
+  budgetMaxUsd: number;
+  /** Number of turns executed so far. */
+  turns: number;
+  /** Per-model pricing info in the format "model: $N/M input · $N/M output". */
+  modelPricing: string;
+}
+interface AppProps {
+  /** Callbacks wired by the CLI bootstrap layer. */
+  callbacks: TuiCallbacks;
+  /** Current session (null when no session is active). */
+  session: Session | null;
+  /** All sessions for the session picker. */
+  sessions: Session[];
+  /** Available models for the model picker. */
+  models?: TuiModelInfo[];
+  /** Currently active model ID. */
+  currentModel?: string;
+  /** Whether to show the safety confirmation screen before the REPL. Default: true. */
+  showWelcome?: boolean;
+  /** Terminal dimensions at startup. */
+  columns: number;
+  rows: number;
+  /**
+   * Called by the TUI on mount to register the permission dialog trigger.
+   * The handler receives permission request data and should show the
+   * PermissionRequest modal. Pass `null` to unregister on unmount.
+   */
+  onPermissionReady?: (handler: ((req: {
+    requestId: string;
+    toolName: string;
+    description: string;
+    safety: SafetyLevel;
+  }) => void) | null) => void;
+  /** MCP server connections for the /mcp panel. */
+  mcpConnections?: McpConnectionInfo[];
+  /** Installed plugins for the /plugin panel. */
+  plugins?: PluginInfo[];
+  /** Discovered skills for the /skills panel. */
+  skills?: SkillInfo[];
+  /** Context summary for the /context panel. */
+  contextInfo?: ContextInfo;
+  /** Usage statistics for the /usage panel. */
+  usageInfo?: UsageInfo;
+}
+//#endregion
+//#region src/app.d.ts
+/** Main application component rendered by Ink. */
+declare function App(props: AppProps): React.ReactElement;
+//#endregion
+//#region src/components/ChatView.d.ts
+interface ChatViewProps {
+  messages: Message[];
+  streaming: boolean;
+}
+declare function ChatView({
+  messages,
+  streaming
+}: ChatViewProps): React.ReactElement;
+//#endregion
+//#region src/components/ChatLog.d.ts
+/** A single entry in the chat transcript. */
+interface ChatLogEntry {
+  readonly id: string;
+  readonly kind: "system" | "user" | "assistant" | "tool_use" | "tool_result" | "btw" | "thinking";
+  readonly text: string;
+  readonly streaming?: boolean;
+  readonly pending?: boolean;
+  readonly toolName?: string;
+  readonly toolCallId?: string;
+  readonly toolStartedAt?: number;
+  readonly level?: "info" | "warn" | "error";
+  /** Duration in ms for thinking entries (shown as "已思考 X.Xs"). */
+  readonly durationMs?: number;
+  readonly timestamp: number;
+}
+/** Imperative handle exposed to the parent (agent loop / App). */
+interface ChatLogHandle {
+  /** Append a system message (info, warning, or error). */
+  addSystem(text: string, level?: "info" | "warn" | "error"): void;
+  /** Append a user message, optionally marked as pending (optimistic). */
+  addUser(text: string, pending?: boolean): void;
+  /** Remove the pending marker from the most recent user message. */
+  commitPendingUser(): void;
+  /** Remove the pending user message entirely. */
+  dropPendingUser(): void;
+  /** Create (or update) a streaming assistant message. */
+  startAssistant(text?: string): void;
+  /** Incrementally update the streaming assistant's text. */
+  updateAssistant(text: string): void;
+  /** Finalize the streaming assistant message — sets streaming=false. */
+  finalizeAssistant(text?: string): void;
+  /** Remove the streaming assistant message (on error / abort). */
+  dropAssistant(): void;
+  /** Append a tool‑use entry. */
+  addTool(name: string, callId: string): void;
+  /** Update the result of a previously added tool‑use entry. */
+  updateToolResult(callId: string, result: string): void;
+  /** Show a by‑the‑way hint (non‑conversational guidance). */
+  showBtw(text: string): void;
+  /** Remove the btw message. */
+  dismissBtw(): void;
+  /** Show a collapsible thinking entry with duration. Default collapsed, Enter toggles. */
+  showThinking(text: string, durationMs: number): void;
+  /** Remove the thinking message. */
+  dismissThinking(): void;
+  /** Clear the entire transcript. */
+  clearAll(): void;
+  /** Return the total number of entries (for scroll calculation). */
+  getEntryCount(): number;
+}
+/** Props passed to the ChatLog component. */
+interface ChatLogProps {
+  readonly visibleRange?: {
+    readonly start: number;
+    readonly end: number;
+  };
+  /** Called when search mode is toggled (so parent can disable InputBox). */
+  readonly onSearchActiveChange?: (active: boolean) => void;
+  /** Transcript display mode: compact hides timestamps, full shows them + expanded content. */
+  readonly transcriptMode?: "compact" | "full";
+}
+/** ChatLog component — renders the message transcript driven by a handle. */
+declare const ChatLog: React.ForwardRefExoticComponent<ChatLogProps & React.RefAttributes<ChatLogHandle>>;
+//#endregion
+//#region src/components/InputBox.d.ts
+/** Vim editing mode. */
+type VimMode = "insert" | "normal" | "visual";
+interface InputBoxProps {
+  /** Called when the user submits text. */
+  onSubmit: (text: string) => void;
+  /** Called on each Ctrl+C press (parent tracks abort count). */
+  onAbort: () => void;
+  /** Whether input is disabled (e.g. during streaming). */
+  disabled: boolean;
+  /** Placeholder text shown when input is empty. */
+  placeholder?: string;
+  /** Called when the user presses Ctrl+S to stash the current input. */
+  onStash?: (text: string) => void;
+  /** Text to append at cursor position (from FilePicker, @-mention, etc.). */
+  appendText?: string;
+  /** Called after appendText has been consumed. */
+  onAppendTextConsumed?: () => void;
+  /** Workspace directory for @‑mention file autocomplete. */
+  workspace?: string;
+  /** Enable vim‑style editing modes (INSERT/NORMAL/VISUAL). */
+  vimMode?: boolean;
+  /** Called when vim mode changes (for status display). */
+  onVimModeChange?: (mode: VimMode) => void;
+}
+declare function InputBox({
+  onSubmit,
+  onAbort,
+  disabled,
+  placeholder,
+  onStash,
+  appendText,
+  onAppendTextConsumed,
+  workspace,
+  vimMode: vimEnabled,
+  onVimModeChange
+}: InputBoxProps): React.ReactElement;
+//#endregion
+//#region src/components/StatusBar.d.ts
+interface StatusBarProps {
+  mode: string;
+  model: string;
+  streaming: boolean;
+  viewName: string;
+  /** Total tokens consumed in the current session. */
+  tokensUsed?: number;
+  /** Estimated cost in USD for the current session. */
+  costUsd?: number;
+  /** Budget maximum USD for color coding. */
+  budgetMaxUsd?: number;
+}
+declare function StatusBar({
+  mode,
+  model,
+  streaming,
+  viewName,
+  tokensUsed,
+  costUsd,
+  budgetMaxUsd
+}: StatusBarProps): React.ReactElement;
+//#endregion
+//#region src/components/Dialog.d.ts
+/** Props for the Dialog shell component. */
+interface DialogProps {
+  /** Modal title shown in the top border. */
+  title: string;
+  /** Optional accent color for title and border (theme color key). */
+  accentColor?: string;
+  /** Optional subtitle shown below the title. */
+  subtitle?: string;
+  /** Bottom hint text (e.g. "Enter to confirm · Esc to cancel"). */
+  inputGuide?: string;
+  /** Width of the dialog in characters. Default: 60. */
+  width?: number;
+  /** Children rendered as the dialog body. */
+  children?: React.ReactNode;
+}
+/**
+ * Unified dialog wrapper for modals, pickers, and confirmations.
+ *
+ * All modals in the TUI use this component to ensure visual consistency.
+ * The dialog renders as an absolutely positioned overlay with a
+ * double‑border style.
+ */
+declare function Dialog({
+  title,
+  accentColor,
+  subtitle,
+  inputGuide,
+  width,
+  children
+}: DialogProps): React.ReactElement;
+//#endregion
+//#region src/components/SessionPicker.d.ts
+/** Props for the SessionPicker modal. */
+interface SessionPickerProps {
+  /** All available sessions. */
+  sessions: Session[];
+  /** Called when the user selects a session (Enter key). */
+  onSelect(sessionId: string): void;
+  /** Called when the user dismisses the picker (Escape key). */
+  onCancel(): void;
+}
+/**
+ * Session picker modal.
+ *
+ * Filters sessions by label substring, displays them in a scrollable
+ * list, and handles selection via Enter key.
+ */
+declare function SessionPicker({
+  sessions: allSessions,
+  onSelect,
+  onCancel
+}: SessionPickerProps): React.ReactElement;
+//#endregion
+//#region src/components/HelpModal.d.ts
+/** Props for the HelpModal. */
+interface HelpModalProps {
+  onCancel(): void;
+}
+/**
+ * Help modal displaying keyboard shortcuts.
+ *
+ * Categorized display with search filtering.
+ */
+declare function HelpModal({
+  onCancel
+}: HelpModalProps): React.ReactElement;
+//#endregion
+//#region src/components/CommandPalette.d.ts
+/** A single command entry in the palette. */
+interface CommandEntry {
+  name: string;
+  description: string;
+}
+/** Props for the CommandPalette. */
+interface CommandPaletteProps {
+  /** Called when the user selects a command (Enter key). */
+  onSelect(command: string): void;
+  /** Called when the user dismisses (Escape key). */
+  onCancel(): void;
+  /** Additional commands from plugins/extensions. */
+  extraCommands?: CommandEntry[];
+}
+/**
+ * Command palette modal.
+ *
+ * Fuzzy‑filters the command list as the user types and supports
+ * arrow‑key navigation with Enter to execute.
+ */
+declare function CommandPalette({
+  onSelect,
+  onCancel,
+  extraCommands
+}: CommandPaletteProps): React.ReactElement;
+//#endregion
+//#region src/components/ToolRenderer.d.ts
+/** Props passed to the ToolRenderer. */
+interface ToolRendererProps {
+  /** Name of the tool being rendered. */
+  toolName: string;
+  /** Whether this is the tool call (header) or the result. */
+  phase: "call" | "result";
+  /** Content to display (command, file path, result text). */
+  content: string;
+}
+/**
+ * ToolRenderer component.
+ *
+ * Renders tool invocations and results with appropriate icons and colors.
+ * Different tool categories get different visual treatments.
+ */
+declare function ToolRenderer({
+  toolName,
+  phase,
+  content
+}: ToolRendererProps): React.ReactElement;
+//#endregion
+//#region src/components/Mascot.d.ts
+/** The five mascot states. */
+type MascotState = "idle" | "listen" | "think" | "speak" | "error";
+/** Props for the Mascot component. */
+interface MascotProps {
+  /** Current mascot state. */
+  state: MascotState;
+  /** Whether animation is enabled (respects reduce‑motion preference). */
+  animate?: boolean;
+}
+/**
+ * Animated mascot character.
+ *
+ * Renders a single emoji that changes based on the current state.
+ * Animation is frame‑based with configurable intervals per state.
+ */
+declare function Mascot({
+  state,
+  animate
+}: MascotProps): React.ReactElement;
+//#endregion
+//#region src/hooks/useTerminalSize.d.ts
+/**
+ * useTerminalSize — track stdout dimensions via Ink's useStdout hook.
+ *
+ * Returns { columns, rows } and updates on terminal resize events.
+ */
+interface TerminalSize {
+  columns: number;
+  rows: number;
+}
+/**
+ * Hook that returns the current terminal dimensions.
+ * Updates when the terminal is resized.
+ */
+declare function useTerminalSize(): TerminalSize;
+//#endregion
+//#region src/hooks/useInput.d.ts
+interface InputState {
+  /** Current text in the input box. */
+  value: string;
+  /** Cursor position within the value. */
+  cursor: number;
+  /** Whether the input is currently focused. */
+  focused: boolean;
+}
+interface InputActions {
+  /** Set the full value. */
+  setValue: (value: string) => void;
+  /** Clear the input. */
+  clear: () => void;
+  /** Focus the input. */
+  focus: () => void;
+  /** Blur the input. */
+  blur: () => void;
+  /** Submit the current value. Returns the submitted text. */
+  submit: () => string;
+  /** Insert text at cursor position. */
+  insert: (text: string) => void;
+}
+/**
+ * Controlled input hook for the main REPL input area.
+ *
+ * @param onSubmit Called when the user presses Enter with non‑empty input.
+ * @param onKey Optional handler for non‑Enter key presses (slash menu, shortcuts, etc.).
+ */
+declare function useInput(onSubmit: (text: string) => void, onKey?: (input: string, key: Key) => void): [InputState, InputActions];
+//#endregion
+//#region src/hooks/useScroll.d.ts
+/** Scroll state returned by useScroll. */
+interface ScrollState {
+  /** Start index of the visible message range. */
+  visibleStart: number;
+  /** End index (exclusive) of the visible message range. */
+  visibleEnd: number;
+  /** Whether the view is auto‑following new messages. */
+  stickyScroll: boolean;
+  /** How many new messages are below the current viewport (for pill display). */
+  unseenCount: number;
+  /** Call to jump back to the bottom (resumes auto‑scroll). */
+  jumpToBottom(): void;
+  /** Handle keyboard input for scroll navigation. */
+  handleKey(input: string, key: Key): boolean;
+  /** Scroll up by one line (for mouse wheel). */
+  scrollUp(): void;
+  /** Scroll down by one line (for mouse wheel). */
+  scrollDown(): void;
+  /** Update the total entry count (call from a ref or interval). */
+  setTotalEntries(count: number): void;
+}
+/** Options for useScroll. */
+interface UseScrollOptions {
+  /** Number of visible rows in the chat area (from terminal size). */
+  visibleRows: number;
+}
+/**
+ * React hook that manages scrolling behaviour for the ChatLog.
+ *
+ * Call `setTotalEntries(getEntryCount())` periodically to keep
+ * the hook in sync with the ChatLog's entry list.
+ */
+declare function useScroll({
+  visibleRows
+}: UseScrollOptions): ScrollState;
+//#endregion
+//#region src/theme/theme.d.ts
+/** Initialize the theme system. Call once at startup. */
+declare function initTheme(): void;
+/** Get the current theme. */
+declare function getTheme(): TuiTheme;
+/** Switch to a different theme. */
+declare function setTheme(name: ThemeName): void;
+/** Get a specific color from the current theme. */
+declare function color(name: string): string;
+/** List all available theme names. */
+declare function listThemes(): ThemeName[];
+//#endregion
+//#region src/renderer/markdown.d.ts
+interface MarkdownBlock {
+  type: "paragraph" | "heading" | "code" | "list_item" | "blockquote" | "hr" | "diff" | "table";
+  /** Heading level (1–6), only for heading blocks. */
+  level?: number;
+  /** Source text for this block. */
+  text: string;
+  /** Language tag for fenced code blocks. */
+  language?: string;
+  /** For ordered list items, the number. */
+  listNumber?: number;
+  /** For diff blocks, the diff line type. */
+  diffLineType?: "header" | "hunk" | "add" | "remove" | "context";
+  /** For task list items, whether the checkbox is checked. */
+  checked?: boolean;
+  /** Indentation depth for nested list items (0 = top level). */
+  indentLevel?: number;
+  /** For table blocks, the column headers. */
+  tableHeaders?: string[];
+  /** For table blocks, the data rows (each row is an array of cell text). */
+  tableRows?: string[][];
+  /** For table blocks, column alignments. */
+  tableAligns?: ("left" | "center" | "right")[];
+}
+interface RenderOptions {
+  /** Max number of blocks to render (limits re‑render cost). */
+  maxBlocks?: number;
+  /** If true, only parse complete blocks (for streaming). */
+  stableOnly?: boolean;
+}
+/** Simple line‑by‑line markdown parser. Returns blocks in order. */
+declare function parseMarkdown(md: string, opts?: RenderOptions): MarkdownBlock[];
+/**
+ * For streaming text, find the last "stable" offset — the position
+ * after the last complete block. Everything before this offset can
+ * be memoized; only the suffix needs re‑parsing.
+ */
+declare function findStableOffset(text: string): number;
+/**
+ * Render parsed markdown blocks as Ink elements.
+ *
+ * Uses a Box with flexDirection="column" as the container so that
+ * code blocks (which are Box elements with borders) can coexist with
+ * text blocks (which are Text elements).
+ */
+declare function renderBlocks(blocks: MarkdownBlock[]): ReactNode;
+//#endregion
+//#region src/renderer/sanitize.d.ts
+/**
+ * Text sanitization — strip control characters, ANSI escapes, and
+ * handle Unicode RTL isolation for safe terminal rendering.
+ *
+ * All functions are sync and pure — they take a string and return a
+ * cleaned version suitable for display.
+ */
+/**
+ * Strip ANSI escape sequences (CSI, OSC, etc.) from text.
+ *
+ * Matches: CSI (\\x1b[), OSC (\\x1b]), and single‑character escapes.
+ * Does NOT strip SGR‑only sequences within Ink elements —
+ * this is for raw text from tool output or LLM responses.
+ */
+declare function stripAnsi(text: string): string;
+/**
+ * Strip control characters from text, preserving tab and newline.
+ *
+ * Removes: NUL, BEL, BS, FF, CR, SO, SI, DLE–US, DEL.
+ * Preserves: \\t (tab), \\n (newline), \\r (carriage return).
+ */
+declare function stripControlChars(text: string): string;
+/**
+ * Wrap RTL (right‑to‑left) text with Unicode bidirectional isolation
+ * characters to prevent it from corrupting surrounding LTR layout.
+ *
+ * RTL scripts detected: Arabic, Hebrew, Syriac, Thaana, N'Ko.
+ */
+declare function isolateRtl(text: string): string;
+/**
+ * Insert soft line‑break opportunities into long "words" (tokens) to
+ * prevent terminal line overflow. URLs and code blocks are preserved.
+ *
+ * Tokens longer than {@link LONG_TOKEN_LENGTH} characters are split
+ * with zero‑width spaces every 33 characters.
+ */
+declare function chunkLongTokens(text: string, maxLen?: number): string;
+/**
+ * Detect binary content by measuring the ratio of non‑printable
+ * characters (excluding common whitespace).
+ *
+ * If the binary ratio exceeds 50%, returns `"[binary content]"`;
+ * otherwise returns the original text.
+ */
+declare function redactBinaryContent(text: string): string;
+/**
+ * Full sanitization pipeline — applies all sanitizers in order.
+ *
+ * This is the recommended entry point for cleaning tool output
+ * before rendering in the TUI.
+ */
+declare function sanitize(text: string): string;
+//#endregion
+//#region src/renderer/frame-limiter.d.ts
+/**
+ * FrameRateLimiter — throttle Ink re‑renders to ~30 FPS via microtask batching.
+ *
+ * Ink renders on every state change. For high‑frequency updates (streaming
+ * text deltas, tool output), this can cause excessive re‑renders.
+ * FrameRateLimiter coalesces state updates within a 16 ms window.
+ *
+ * Design (§5.9i):
+ *   - 30 fps throttle (~33 ms frame budget, 16 ms coalesce window)
+ *   - In‑memory transcript cache for static entries
+ *   - React.memo on static message blocks
+ */
+/**
+ * Simple frame‑rate limiter.
+ *
+ * Uses a pending flag and microtask scheduling to ensure
+ * callbacks fire at most once per `frameMs` window.
+ */
+declare class FrameRateLimiter {
+  private lastFrame;
+  private pending;
+  private readonly frameMs;
+  constructor(frameMs?: number);
+  /**
+   * Schedule a callback to run on the next available frame.
+   *
+   * If a callback was already scheduled within the current frame window,
+   * the new callback replaces it (last‑writer‑wins semantics).
+   */
+  schedule(fn: () => void): void;
+  /** Reset the limiter state. */
+  reset(): void;
+}
+/**
+ * Create a transcript cache key for stable React.memo comparison.
+ *
+ * Static messages (non‑streaming, non‑pending) can be memoized
+ * since their rendered output never changes.
+ */
+declare function transcriptCacheKey(entryId: string, isStreaming: boolean, isPending: boolean): string;
+/**
+ * Default frame rate limiter instance for transcript rendering.
+ *
+ * Created once per ChatLog mount to throttle streaming updates.
+ */
+declare function createFrameRateLimiter(frameMs?: number): FrameRateLimiter;
+//#endregion
+//#region src/keybindings/keybindings.d.ts
+interface KeyBinding {
+  /** Human‑readable description shown in the help modal. */
+  description: string;
+  /** Which views this binding applies to (empty = all views). */
+  scopes: string[];
+  /** Key matcher function. */
+  match: (input: string, key: Key) => boolean;
+  /** Action to execute. */
+  action: () => void;
+}
+type KeyBindingCatalog = KeyBinding[];
+/**
+ * Create the default keybinding catalog.
+ *
+ * Callers provide concrete actions for each binding.
+ * The catalog is stateless — each binding is a closure
+ * over the action it should perform.
+ */
+declare function createDefaultBindings(actions: {
+  abort: () => void;
+  help: () => void;
+  sessionPicker: () => void;
+  clearScreen: () => void;
+  scrollUp: () => void;
+  scrollDown: () => void;
+}): KeyBindingCatalog;
+/**
+ * Find and execute the first matching keybinding for the current scope.
+ *
+ * @returns true if a binding matched and was executed.
+ */
+declare function dispatchBinding(catalog: KeyBindingCatalog, scope: string, input: string, key: Key): boolean;
+//#endregion
+//#region src/components/ModelPicker.d.ts
+/** Props for the ModelPicker component. */
+interface ModelPickerProps {
+  /** Available models to display. */
+  models: TuiModelInfo[];
+  /** Currently selected model ID. */
+  currentModel?: string;
+  /** Called when the user selects a model. */
+  onSelect: (modelId: string) => void;
+  /** Called when the user sets a model as default. */
+  onSetDefault?: (modelId: string) => void;
+  /** Called when the user cancels. */
+  onCancel: () => void;
+}
+/**
+ * Interactive model picker modal with search filtering.
+ *
+ * Navigation:
+ *   Type text → filter models by id/label
+ *   ↑/↓ — move cursor
+ *   Enter — select and close
+ *   s — set as default (does not close)
+ *   Esc — cancel
+ */
+declare function ModelPicker({
+  models,
+  currentModel,
+  onSelect,
+  onSetDefault,
+  onCancel
+}: ModelPickerProps): React.ReactElement;
+//#endregion
+//#region src/components/ConfigMenu.d.ts
+/** A single configurable setting. */
+interface ConfigSetting {
+  /** Setting key, e.g. "autoCompact". */
+  key: string;
+  /** Human‑readable label. */
+  label: string;
+  /** Current value. Type determines rendering: boolean → checkbox, string/number → inline display. */
+  value: boolean | string | number;
+  /** Category tab this setting belongs to. */
+  category: string;
+}
+/** Props for the ConfigMenu component. */
+interface ConfigMenuProps {
+  /** Active settings (optional; falls back to defaults). */
+  settings?: ConfigSetting[];
+  /** Called when a boolean setting is toggled. */
+  onToggle: (key: string, value: boolean) => void;
+  /** Called when a text/number setting needs editing. valueType helps the handler decide whether to parse as number. */
+  onEdit?: (key: string, label: string, currentValue: string, valueType: "text" | "number") => void;
+  /** Called when the user cancels. */
+  onCancel: () => void;
+}
+/**
+ * Interactive settings panel with tabbed categories.
+ *
+ * Navigation:
+ *   ←/→ — switch tabs
+ *   ↑/↓ — move cursor
+ *   Enter — toggle boolean / edit text / edit number
+ *   Esc — close
+ */
+declare function ConfigMenu({
+  settings,
+  onToggle,
+  onEdit,
+  onCancel
+}: ConfigMenuProps): React.ReactElement;
+//#endregion
+//#region src/components/ThemePicker.d.ts
+/** Props for the ThemePicker component. */
+interface ThemePickerProps {
+  /** Currently active theme name. */
+  currentTheme?: ThemeName;
+  /** Called when the user selects a theme. */
+  onSelect: (themeName: ThemeName) => void;
+  /** Called when the user cancels. */
+  onCancel: () => void;
+}
+/**
+ * Interactive theme picker modal.
+ *
+ * Navigation:
+ *   ↑/↓ — move cursor
+ *   Enter — apply theme and close
+ *   Esc — cancel
+ */
+declare function ThemePicker({
+  currentTheme,
+  onSelect,
+  onCancel
+}: ThemePickerProps): React.ReactElement;
+//#endregion
+//#region src/components/ConfirmDialog.d.ts
+/** Props for the ConfirmDialog component. */
+interface ConfirmDialogProps {
+  /** Title shown in the border. */
+  title: string;
+  /** Body message explaining the action. */
+  message: string;
+  /** Label for the confirm option. Default: "Yes" */
+  confirmLabel?: string;
+  /** Label for the cancel option. Default: "No" */
+  cancelLabel?: string;
+  /** Called when the user confirms. */
+  onConfirm: () => void;
+  /** Called when the user cancels. */
+  onCancel: () => void;
+}
+/**
+ * Generic confirmation dialog with Yes/No options.
+ *
+ * Navigation:
+ *   ↑/↓ — switch between options
+ *   Enter — confirm current selection
+ *   Esc — cancel
+ */
+declare function ConfirmDialog({
+  title,
+  message,
+  confirmLabel,
+  cancelLabel,
+  onConfirm,
+  onCancel
+}: ConfirmDialogProps): React.ReactElement;
+//#endregion
+//#region src/components/InputPrompt.d.ts
+/** Props for the InputPrompt component. */
+interface InputPromptProps {
+  /** Title shown in the border. */
+  title: string;
+  /** Initial value to pre‑fill the input. */
+  initialValue?: string;
+  /** Placeholder shown when input is empty. */
+  placeholder?: string;
+  /** Called when the user confirms with Enter. */
+  onConfirm: (value: string) => void;
+  /** Called when the user cancels with Esc. */
+  onCancel: () => void;
+  /** Maximum allowed input length. Default: 100. */
+  maxLength?: number;
+}
+/**
+ * Single‑line text input modal.
+ *
+ * Key bindings:
+ *   Enter — confirm and return value
+ *   Esc — cancel
+ *   Backspace — delete character before cursor
+ *   Delete — delete character at cursor
+ *   ←/→ — move cursor
+ *   Home/End — jump to start/end
+ *   Ctrl+A/E — jump to start/end
+ *   Ctrl+K — delete to end of line
+ *   Ctrl+W — delete previous word
+ */
+declare function InputPrompt({
+  title,
+  initialValue,
+  placeholder,
+  onConfirm,
+  onCancel,
+  maxLength
+}: InputPromptProps): React.ReactElement;
+//#endregion
+//#region src/components/DoctorPanel.d.ts
+/** Result of a single diagnostic check. */
+interface DoctorCheck {
+  /** Human‑readable name of the check. */
+  label: string;
+  /** Status: "ok" = pass, "warn" = warning, "error" = failed. */
+  status: "ok" | "warn" | "error";
+  /** Optional detail shown on the same line. */
+  detail?: string;
+  /** Optional fix hint shown in dimmed text below the check. */
+  fixHint?: string;
+}
+/** Props for the DoctorPanel component. */
+interface DoctorPanelProps {
+  /** List of check results to display. */
+  checks: DoctorCheck[];
+  /** Called when the user cancels (Escape). */
+  onCancel: () => void;
+}
+/**
+ * System diagnostics panel.
+ *
+ * Displays each check result with a status icon and optional detail.
+ * The Escape key closes the panel (handled by the global handler).
+ */
+declare function DoctorPanel({
+  checks: initialChecks,
+  onCancel
+}: DoctorPanelProps): React.ReactElement;
+/**
+ * Run built‑in checks synchronously and return results.
+ *
+ * These checks run within the TUI process and don't require
+ * spawning a separate `lynx doctor` subprocess.
+ */
+declare function runBuiltinChecks(): DoctorCheck[];
+//#endregion
+//#region src/components/FilePicker.d.ts
+/** Props for the FilePicker modal. */
+interface FilePickerProps {
+  /** Workspace root directory to walk. */
+  workspace: string;
+  /** Called when the user selects a file (Enter). */
+  onSelect: (filePath: string) => void;
+  /** Called when the user dismisses (Escape). */
+  onCancel: () => void;
+  /** Initial filter text (e.g. from @-mention). */
+  initialFilter?: string;
+}
+/**
+ * Interactive file picker modal with flat list and tree view modes.
+ *
+ * Flat mode: files sorted by relevance. Tree mode: files grouped by
+ * directory with expand/collapse. Git status colors indicate modifications.
+ */
+declare function FilePicker({
+  workspace,
+  onSelect,
+  onCancel,
+  initialFilter
+}: FilePickerProps): React.ReactElement;
+//#endregion
+//#region src/components/StashPicker.d.ts
+/** A single stashed item. */
+interface StashEntry {
+  /** Unique identifier. */
+  id: string;
+  /** Truncated content preview. */
+  preview: string;
+  /** Unix timestamp when stashed. */
+  timestamp: number;
+}
+/** Props for the StashPicker modal. */
+interface StashPickerProps {
+  /** Stashed items (newest first). */
+  items: StashEntry[];
+  /** Called when the user restores an item (Enter). */
+  onRestore: (id: string) => void;
+  /** Called when the user deletes an item (Ctrl+D). */
+  onDelete: (id: string) => void;
+  /** Called when the user dismisses (Escape). */
+  onCancel: () => void;
+}
+/**
+ * Stash picker modal.
+ *
+ * Lists stashed inputs with restore and delete actions.
+ */
+declare function StashPicker({
+  items,
+  onRestore,
+  onDelete,
+  onCancel
+}: StashPickerProps): React.ReactElement;
+//#endregion
+//#region src/components/ErrorBoundary.d.ts
+/** Props for the ErrorBoundary. */
+interface ErrorBoundaryProps {
+  children: React.ReactNode;
+}
+/** State tracked by the ErrorBoundary. */
+interface ErrorBoundaryState {
+  hasError: boolean;
+  error: Error | null;
+}
+/**
+ * React error boundary for Ink components.
+ *
+ * Catches rendering errors and displays a fallback UI instead of
+ * crashing the entire terminal application.
+ */
+declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+  constructor(props: ErrorBoundaryProps);
+  static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+  render(): React.ReactNode;
+}
+//#endregion
+//#region src/components/AlternateScreen.d.ts
+/** Props for the AlternateScreen wrapper. */
+interface AlternateScreenProps {
+  /** Children rendered inside the alt buffer. */
+  children: ReactNode;
+  /** Called when entering fullscreen mode. */
+  onEnter(): void;
+  /** Called when exiting fullscreen mode. */
+  onExit(): void;
+}
+/**
+ * Wraps children in alternate‑buffer lifecycle management.
+ *
+ * Calls `onEnter` on mount and `onExit` on unmount,
+ * ensuring terminal recovery even on unexpected crashes.
+ */
+declare function AlternateScreen({
+  children,
+  onEnter,
+  onExit
+}: AlternateScreenProps): React.ReactElement;
+//#endregion
+//#region src/components/DiffViewer.d.ts
+/** A single changed file with diff content. */
+interface DiffFile {
+  /** Relative file path. */
+  path: string;
+  /** Git status: M(odified), A(dded), D(eleted), R(enamed). */
+  status: string;
+  /** Unified diff text. */
+  diff: string;
+}
+/** Props for the DiffViewer component. */
+interface DiffViewerProps {
+  /** Async callback that fetches the diff data from git. */
+  onRequestDiff?: () => Promise<DiffFile[]>;
+  /** Called when the user dismisses the viewer. */
+  onCancel: () => void;
+}
+/**
+ * Git diff visualisation panel.
+ *
+ * Two modes:
+ *   - File list (default): shows changed files with status, preview snippet.
+ *   - Detail view: full unified diff for the selected file.
+ * Arrow keys navigate the file list; Enter opens detail; Escape goes back.
+ */
+declare function DiffViewer({
+  onRequestDiff,
+  onCancel
+}: DiffViewerProps): React.ReactElement;
+//#endregion
+//#region src/components/SnapshotBrowser.d.ts
+/** A single snapshot record. */
+interface SnapshotEntry {
+  /** Unique snapshot identifier. */
+  id: string;
+  /** Unix-ms timestamp when the snapshot was captured. */
+  timestamp: number;
+  /** Human-readable snapshot label. */
+  label: string;
+}
+/** Props for the SnapshotBrowser component. */
+interface SnapshotBrowserProps {
+  /** Async callback that fetches snapshot records. */
+  onRequestSnapshots?: () => Promise<SnapshotEntry[]>;
+  /** Called when the user dismisses the browser. */
+  onCancel: () => void;
+}
+/**
+ * File snapshot browser.
+ *
+ * Lists all captured snapshots sorted by timestamp (newest first).
+ * Arrow keys navigate; currently read‑only (restore support in a future phase).
+ */
+declare function SnapshotBrowser({
+  onRequestSnapshots,
+  onCancel
+}: SnapshotBrowserProps): React.ReactElement;
+//#endregion
+//#region src/components/TasksPanel.d.ts
+/** Task status enum. */
+type TaskStatus = "running" | "queued" | "done" | "failed";
+/** A single background task record. */
+interface TaskEntry {
+  /** Unique task identifier. */
+  id: string;
+  /** Human-readable task name. */
+  name: string;
+  /** Current task status. */
+  status: TaskStatus;
+  /** Error message if status is "failed". */
+  error?: string;
+}
+/** Props for the TasksPanel component. */
+interface TasksPanelProps {
+  /** Async callback that fetches the current task list. */
+  onRequestTasks?: () => Promise<TaskEntry[]>;
+  /** Called when the user dismisses the panel. */
+  onCancel: () => void;
+}
+/**
+ * Background task monitor panel.
+ *
+ * Auto‑polls the task list every 2 seconds. Shows status icon,
+ * task name, and error detail for failed tasks.
+ * Press 'r' to manually refresh.
+ */
+declare function TasksPanel({
+  onRequestTasks,
+  onCancel
+}: TasksPanelProps): React.ReactElement;
+//#endregion
+//#region src/components/SkillPicker.d.ts
+/** Props for the SkillPicker component. */
+interface SkillPickerProps {
+  /** All available skills (from builtin, user, project). */
+  skills: SkillInfo[];
+  /** Called when the user selects a skill (Enter). */
+  onSelect(skillName: string): void;
+  /** Called when the user dismisses (Escape). */
+  onCancel(): void;
+}
+/**
+ * Fuzzy skill search modal.
+ *
+ * The user types a query to filter skills. Results are ranked by
+ * fuzzy match score. Arrow keys select; Enter invokes; Escape closes.
+ */
+declare function SkillPicker({
+  skills,
+  onSelect,
+  onCancel
+}: SkillPickerProps): React.ReactElement;
+//#endregion
+//#region src/screens/WelcomeScreen.d.ts
+/** Props for the WelcomeScreen component. */
+interface WelcomeScreenProps {
+  /** Workspace directory path. */
+  workspace: string;
+  /** Lynx version string. */
+  version: string;
+  /** Last session info — null on first visit. */
+  lastSession?: {
+    label: string;
+    relativeTime: string;
+    sessionCount: number;
+  };
+  /** Called when the user confirms (trusts the workspace). */
+  onConfirm: () => void;
+  /** Called when the user exits (does not trust / cancels). */
+  onExit: () => void;
+}
+/**
+ * Safety confirmation screen.
+ *
+ * The user is shown workspace info and must confirm before
+ * Lynx starts Phase 2 (loading sessions, MCP, memory, etc.).
+ */
+declare function WelcomeScreen({
+  workspace,
+  version,
+  lastSession,
+  onConfirm,
+  onExit
+}: WelcomeScreenProps): React.ReactElement;
+//#endregion
+//#region src/views/stack.d.ts
+/** Create a new view stack with an initial view. */
+declare function createViewStack(initial?: ViewId): ViewStack;
+//#endregion
+export { AlternateScreen, type AlternateScreenProps, App, type AppProps, ChatLog, type ChatLogEntry, type ChatLogHandle, type ChatLogProps, ChatView, type ChatViewProps, type CommandEntry, CommandPalette, type CommandPaletteProps, ConfigMenu, type ConfigMenuProps, ConfirmDialog, type ConfirmDialogProps, type ContextInfo, Dialog, type DialogProps, type DiffFile, DiffViewer, type DiffViewerProps, type DoctorCheck, DoctorPanel, type DoctorPanelProps, ErrorBoundary, FilePicker, type FilePickerProps, FrameRateLimiter, HelpModal, type HelpModalProps, type InputActions, InputBox, type InputBoxProps, InputPrompt, type InputPromptProps, type InputState, type KeyBinding, type KeyBindingCatalog, type MarkdownBlock, Mascot, type MascotProps, type MascotState, type McpConnectionInfo, ModelPicker, type ModelPickerProps, type PermissionChoice, PermissionRequest, type PermissionRequestData, type PermissionRequestProps, type PluginInfo, type RenderOptions, type SafetyLevel, type ScrollState, SessionPicker, type SessionPickerProps, type SkillInfo, SkillPicker, type SkillPickerProps, SnapshotBrowser, type SnapshotBrowserProps, type SnapshotEntry, type StashEntry, StashPicker, type StashPickerProps, StatusBar, type StatusBarProps, type TaskEntry, type TaskStatus, TasksPanel, type TasksPanelProps, type TerminalSize, type ThemeName, ThemePicker, type ThemePickerProps, ToolRenderer, type ToolRendererProps, type TuiCallbacks, type TuiModelInfo, type TuiStreamEvent, type TuiTheme, type UsageInfo, type UseScrollOptions, type ViewEntry, type ViewId, type ViewStack, type VimMode, WelcomeScreen, type WelcomeScreenProps, chunkLongTokens, color, createDefaultBindings, createFrameRateLimiter, createViewStack, dispatchBinding, findStableOffset, getTheme, initTheme, isolateRtl, listThemes, parseMarkdown, redactBinaryContent, renderBlocks, runBuiltinChecks, sanitize, setTheme, stripAnsi, stripControlChars, transcriptCacheKey, useInput, useScroll, useTerminalSize };
+//# sourceMappingURL=index.d.mts.map