@cjhyy/code-shell 0.3.0 → 0.5.0-rc.1

package/dist/ui/components/MessageRow.d.ts

@@ -1,54 +0,0 @@
-/**
- * MessageRow — memo boundary around a single chat entry's rendered output.
- *
- * Why this exists: stream events fire dozens of times per second. Without
- * a memo boundary, every entry's renderer (markdown lexing, Yoga layout,
- * syntax-highlight token cache) re-runs on every frame, defeating ink's
- * blit fast-path. The hand-written comparator below mirrors Claude Code
- * 2.1.88's areMessageRowPropsEqual: bail only when we are CERTAIN the
- * entry didn't change.
- *
- * Why `render` is excluded from the comparator (intentional, see CC's
- * VirtualItem note): when entry/columns/isStreaming all match, React.memo
- * returns the PREVIOUS rendered ReactNode — it does NOT invoke render
- * again with the new closure, so a stale-closure-on-bail scenario is
- * impossible. Including `render` in the comparator would defeat memo
- * entirely (render is fresh on every parent render).
- */
-import React, { type ReactNode } from "react";
-import type { ChatEntry } from "../store.js";
-export interface MessageRowProps {
-    entry: ChatEntry;
-    /** Terminal columns — affects text wrap inside the renderer. */
-    columns: number;
-    /**
-     * True iff this entry is the one currently receiving stream deltas.
-     * Streaming rows never memo-bail (their text grows mid-frame).
-     */
-    isStreaming: boolean;
-    /**
-     * True iff this entry is the transcript-mode cursor target. State
-     * external to the entry that affects rendering (cursor outline) must
-     * be a prop so the comparator can invalidate when it flips. CC handles
-     * cursor/hover/expanded the same way on its VirtualItem.
-     */
-    isSelected: boolean;
-    /**
-     * True when long entries should render expanded (transcript mode).
-     * Flipping this re-renders every row — low-frequency event, acceptable.
-     */
-    expanded: boolean;
-    /**
-     * Called with the entry when we actually need to render. Excluded
-     * from the memo comparator on purpose (see file header).
-     */
-    render: (entry: ChatEntry) => ReactNode;
-}
-declare function MessageRowImpl({ entry, render }: MessageRowProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Returns true when the row can safely skip re-render. False on any
- * uncertainty — we fail safe by re-rendering.
- */
-export declare function areMessageRowPropsEqual(prev: MessageRowProps, next: MessageRowProps): boolean;
-export declare const MessageRow: React.MemoExoticComponent<typeof MessageRowImpl>;
-export {};

package/dist/ui/components/ModelManager.d.ts

@@ -1,68 +0,0 @@
-import type { ProtocolModelEntry } from "../../protocol/types.js";
-interface SnapshotInfo {
-    count: number;
-    fetchedAt: string;
-}
-/**
- * Settings stores arena.participants as Array<string | object>. The panel
- * surfaces strings (pool keys); object-form entries are shown read-only so
- * we don't clobber a user's hand-edited config.
- */
-export type ArenaParticipantEntry = {
-    kind: "key";
-    value: string;
-} | {
-    kind: "object";
-    label: string;
-};
-/**
- * Row data shown in the Providers tab. Counts/timestamps are derived by the
- * parent from settings.providers[] + the model cache so this component stays
- * presentational.
- */
-export interface ProviderManagerEntry {
-    key: string;
-    label: string;
-    kind: string;
-    modelCount: number;
-    cachedModels?: number;
-    cachedAt?: string;
-    baseUrl?: string;
-    apiKey?: string;
-    protocol?: string;
-    modelsPath?: string;
-}
-interface ModelManagerProps {
-    entries: ProtocolModelEntry[];
-    snapshot: SnapshotInfo;
-    arenaParticipants: ArenaParticipantEntry[];
-    /** Providers configured in settings.providers[] (Task 11+). */
-    providers?: ProviderManagerEntry[];
-    /** Activate a model. */
-    onSwitch: (key: string) => Promise<void>;
-    /** Trigger an OpenRouter snapshot refresh. */
-    onSync: () => Promise<{
-        ok: boolean;
-        count: number;
-        error?: string;
-    }>;
-    /** Persist updated participant list (string[]) to settings. */
-    onSaveArena: (participants: string[]) => Promise<void>;
-    /** Open the parent-rendered ProviderModelFlow (covers both add-provider and add-model). */
-    onOpenFlow?: () => void;
-    /** Force-refresh a provider's cached model list. */
-    onRefreshProvider?: (key: string) => Promise<{
-        count: number;
-        error?: string;
-    }>;
-    /** Delete a provider (blocked if any model references it). */
-    onDeleteProvider?: (key: string) => Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Delete a model entry. */
-    onDeleteModel?: (key: string) => Promise<void>;
-    onClose: () => void;
-}
-export declare function ModelManager({ entries, snapshot, arenaParticipants, providers, onSwitch, onSync, onSaveArena, onOpenFlow, onRefreshProvider, onDeleteProvider, onDeleteModel, onClose, }: ModelManagerProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ModelSelector.d.ts

@@ -1,10 +0,0 @@
-import type { ProtocolModelEntry } from "../../protocol/types.js";
-/** Re-export under the UI name for convenience. */
-export type ModelEntry = ProtocolModelEntry;
-interface ModelSelectorProps {
-    entries: ModelEntry[];
-    onSelect: (key: string) => void;
-    onCancel: () => void;
-}
-export declare function ModelSelector({ entries, onSelect, onCancel }: ModelSelectorProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/OnboardingPrompt.d.ts

@@ -1,16 +0,0 @@
-import { type OnboardingResult } from "../../cli/onboarding.js";
-import type { ProviderConfig } from "../../llm/provider-catalog.js";
-interface OnboardingPromptProps {
-    onComplete: (result: OnboardingResult) => void;
-    onCancel: () => void;
-    /** Existing providers — surfaces "Use existing" in the flow's first step.
-     *  Optional: empty by default (first-run case). */
-    existingProviders?: ProviderConfig[];
-    /** Existing model aliases — used by the flow to derive unique aliases. */
-    existingModelKeys?: string[];
-    /** Model ids already in settings.models[] — used by the flow to disable
-     *  rows for models the user has already added. */
-    existingModelIds?: string[];
-}
-export declare function OnboardingPrompt({ onComplete, onCancel, existingProviders, existingModelKeys, existingModelIds, }: OnboardingPromptProps): import("react/jsx-runtime").JSX.Element | null;
-export {};

package/dist/ui/components/PermissionDialog.d.ts

@@ -1,8 +0,0 @@
-interface PermissionDialogProps {
-    toolName: string;
-    description: string;
-    riskLevel: "low" | "medium" | "high";
-    onDecision: (approved: boolean, permanent?: boolean) => void;
-}
-export declare function PermissionDialog({ toolName, description, riskLevel, onDecision }: PermissionDialogProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/PermissionPrompt.d.ts

@@ -1,11 +0,0 @@
-import type { ApprovalScope } from "../../types.js";
-interface PermissionPromptProps {
-    toolName: string;
-    description: string;
-    riskLevel: string;
-    args: Record<string, unknown>;
-    cwd: string;
-    onDecision: (approved: boolean, scope: ApprovalScope) => void;
-}
-export declare function PermissionPrompt({ toolName, description, riskLevel, args, cwd, onDecision, }: PermissionPromptProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ProviderModelFlow.d.ts

@@ -1,58 +0,0 @@
-import { type ProviderKindName } from "../../llm/provider-kinds.js";
-import type { ProviderConfig } from "../../llm/provider-catalog.js";
-export interface EnvKeyHint {
-    envKey: string;
-    apiKey: string;
-    kindHint: ProviderKindName;
-}
-export interface FlowResult {
-    addedProvider?: ProviderConfig;
-    /**
-     * Self-describing model entries — credentials are duplicated from the
-     * provider on purpose. The engine reads these without a ProviderCatalog
-     * round-trip; providers[] is kept only as a credential source for the
-     * wizard's future "add model to existing provider" flow.
-     */
-    addedModels: Array<{
-        key: string;
-        label?: string;
-        providerKey: string;
-        /** LLM client/protocol ("openai"/"anthropic"). */
-        protocol: string;
-        /** Legacy mirror of `protocol` for downstream readers that still query it. */
-        provider: string;
-        model: string;
-        baseUrl: string;
-        apiKey?: string;
-        maxContextTokens?: number;
-        maxOutputTokens?: number;
-    }>;
-    activeModelKey?: string;
-}
-export interface ProviderModelFlowProps {
-    existingProviders: ProviderConfig[];
-    existingModelKeys: string[];
-    /**
-     * Model ids (e.g. "deepseek-v4-pro") already present in settings.models[]
-     * under SOME provider. The fetch step uses this to disable rows for
-     * models the user has already added — keeps the menu informative (shows
-     * the full catalog) without letting the user re-add duplicates that
-     * appendOnboardingResult would silently drop.
-     */
-    existingModelIds?: string[];
-    detectedEnvKeys?: EnvKeyHint[];
-    switchToNewModelOnFinish: boolean;
-    onFinish: (r: FlowResult) => void;
-    onCancel: () => void;
-}
-/**
- * Pool-key generator for wizard-added models. Format is `provider-model` so
- * the alias self-identifies (e.g. "deepseek-v4-pro", not just "v4-pro" or
- * "deepseek"). Collisions get a numeric suffix.
- *
- * If the model id already starts with `<provider>-`, we don't duplicate.
- */
-export declare function deriveModelAlias(modelId: string, used: string[], providerKind?: string): string;
-export declare function deriveProviderKey(kindOrUrl: string, used: string[]): string;
-export declare function validateAlias(alias: string, used: string[]): string | null;
-export declare function ProviderModelFlow({ existingProviders, existingModelKeys, existingModelIds, detectedEnvKeys, switchToNewModelOnFinish, onFinish, onCancel, }: ProviderModelFlowProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ScrollView.d.ts

@@ -1,34 +0,0 @@
-/**
- * ScrollView — virtual scrolling container for terminal UI.
- *
- * Inspired by Claude Code's ScrollBox component. Key design:
- * - Manages scrollTop + viewport height
- * - Only renders children visible in the viewport (virtual scrolling)
- * - stickyScroll: auto-follows new content (like "tail -f")
- * - Mouse wheel scrolling support
- * - Exposes imperative handle for programmatic scroll control
- *
- * Unlike CC's ScrollBox which uses a custom Yoga-based renderer,
- * this implementation works with standard Ink by slicing the
- * children array to only render visible items.
- */
-import { type ReactNode } from "react";
-export interface ScrollViewHandle {
-    scrollTo: (y: number) => void;
-    scrollBy: (dy: number) => void;
-    scrollToBottom: () => void;
-    getScrollTop: () => number;
-    isAtBottom: () => boolean;
-}
-interface ScrollViewProps {
-    /** Total number of items (not pixels). */
-    itemCount: number;
-    /** Render a single item by index. */
-    renderItem: (index: number) => ReactNode;
-    /** If true, auto-scroll to bottom when new items appear. */
-    stickyScroll?: boolean;
-    /** Height in terminal rows to reserve for non-scrollable UI (input, status). */
-    reservedRows?: number;
-}
-export declare const ScrollView: import("react").ForwardRefExoticComponent<ScrollViewProps & import("react").RefAttributes<ScrollViewHandle>>;
-export {};

package/dist/ui/components/SessionPicker.d.ts

@@ -1,16 +0,0 @@
-export interface SessionPickerEntry {
-    sessionId: string;
-    startedAt: number;
-    /** Last activity time — used to sort and display the row. */
-    lastActiveAt?: number;
-    turnCount: number;
-    preview?: string;
-    cwd?: string;
-}
-interface SessionPickerProps {
-    entries: SessionPickerEntry[];
-    onSelect: (sessionId: string) => void;
-    onCancel: () => void;
-}
-export declare function SessionPicker({ entries, onSelect, onCancel }: SessionPickerProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/Spinner.d.ts

@@ -1,8 +0,0 @@
-interface SpinnerProps {
-    label?: string;
-    color?: string;
-    showElapsed?: boolean;
-    tokens?: number;
-}
-export declare function Spinner({ label, color, showElapsed, tokens }: SpinnerProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/SpinnerWithVerb.d.ts

@@ -1,19 +0,0 @@
-/**
- * SpinnerWithVerb — animated spinner with random verbs, elapsed time, and token count.
- */
-import { type MutableRefObject } from "react";
-export type SpinnerMode = "responding" | "tool-use" | "thinking";
-interface SpinnerWithVerbProps {
-    mode: SpinnerMode;
-    /**
-     * Per-turn streamed token count — used purely as a "still alive" signal so
-     * the user sees activity. NOT a measure of context size; that's in the
-     * StatusLine ctx bar.
-     */
-    streamingTokensRef?: MutableRefObject<number>;
-    runStartRef?: MutableRefObject<number>;
-    thinkingContent?: string;
-}
-declare function SpinnerWithVerbImpl({ mode, streamingTokensRef, runStartRef, thinkingContent, }: SpinnerWithVerbProps): import("react/jsx-runtime").JSX.Element;
-export declare const SpinnerWithVerb: import("react").MemoExoticComponent<typeof SpinnerWithVerbImpl>;
-export {};

package/dist/ui/components/StatusLine.d.ts

@@ -1,28 +0,0 @@
-/**
- * StatusLine — compact bottom status bar matching Claude Code's style.
- *
- * Layout: [running indicator] model · context bar % · $cost
- *
- * Manages its own 1s interval so the parent App doesn't re-render.
- */
-import { type MutableRefObject } from "react";
-interface StatusLineProps {
-    model: string;
-    effort: string;
-    tokens: number;
-    cost: number;
-    sessionId?: string;
-    /**
-     * Authoritative live context size. The engine emits `usage_update` at every
-     * message-array mutation (post-tool-result, post-compact, post-LLM), so this
-     * tracks the real prompt token count without UI-side accumulation.
-     */
-    baseContextTokens?: number;
-    maxContextTokens?: number;
-    gitBranch?: string;
-    isRunning?: boolean;
-    streamingTokensRef?: MutableRefObject<number>;
-    runStartRef?: MutableRefObject<number>;
-}
-export declare function StatusLine({ model, effort, tokens, cost, sessionId, baseContextTokens, maxContextTokens, gitBranch, isRunning, streamingTokensRef, runStartRef, }: StatusLineProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/StructuredDiff.d.ts

@@ -1,8 +0,0 @@
-interface StructuredDiffProps {
-    filePath: string;
-    oldString: string;
-    newString: string;
-    replaceAll?: boolean;
-}
-export declare function StructuredDiff({ filePath, oldString, newString, replaceAll }: StructuredDiffProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/TaskList.d.ts

@@ -1,6 +0,0 @@
-import type { TaskInfo } from "../../types.js";
-interface TaskListProps {
-    tasks: TaskInfo[];
-}
-export declare function TaskList({ tasks }: TaskListProps): import("react/jsx-runtime").JSX.Element | null;
-export {};

package/dist/ui/components/TextInput.d.ts

@@ -1,17 +0,0 @@
-interface TextInputProps {
-    value: string;
-    onChange: (value: string) => void;
-    onSubmit?: (value: string) => void;
-    placeholder?: string;
-    focus?: boolean;
-    /** Suffix rendered dim after the cursor — e.g. "on|off" arg hint for
-     *  a slash command. Not part of `value`; not editable. */
-    hint?: string;
-    /** Bumping this number snaps the cursor to value.length on the next
-     *  render. Use when the parent rewrites `value` externally (e.g. tab
-     *  completion) — the in-component cursor would otherwise stay at its
-     *  pre-rewrite offset and land in the middle of the new text. */
-    cursorResetCounter?: number;
-}
-export default function TextInput({ value, onChange, onSubmit, placeholder, focus, hint, cursorResetCounter, }: TextInputProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ThemedBox.d.ts

@@ -1,19 +0,0 @@
-/**
- * ThemedBox — Box that accepts theme keys for color props.
- *
- * Uses the canonical Theme type from utils/theme.ts (shared with
- * components/design-system/ThemedBox). Kept as a separate file because
- * the design-system version depends on the heavy ThemeProvider; this
- * version uses the lightweight ui/theme.ts context.
- */
-import React from "react";
-import { type BoxProps } from "../../render/index.js";
-import type { Theme } from "../../utils/theme.js";
-type ColorProp = keyof Theme | string;
-export interface ThemedBoxProps extends Omit<BoxProps, "borderColor" | "backgroundColor"> {
-    borderColor?: ColorProp;
-    backgroundColor?: ColorProp;
-    children?: React.ReactNode;
-}
-export declare function ThemedBox({ borderColor, backgroundColor, ...rest }: ThemedBoxProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ThemedText.d.ts

@@ -1,26 +0,0 @@
-/**
- * ThemedText — Text that accepts theme keys for color props.
- *
- * Uses the canonical Theme type from utils/theme.ts (shared with
- * components/design-system/ThemedText). Kept separate because the
- * design-system version depends on the heavy ThemeProvider; this
- * version uses the lightweight ui/theme.ts context.
- */
-import React from "react";
-import type { Theme } from "../../utils/theme.js";
-type ColorProp = keyof Theme | string;
-export interface ThemedTextProps {
-    color?: ColorProp;
-    backgroundColor?: ColorProp;
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    strikethrough?: boolean;
-    inverse?: boolean;
-    dimColor?: boolean;
-    dim?: boolean;
-    wrap?: "wrap" | "truncate" | "truncate-start" | "truncate-middle" | "truncate-end";
-    children?: React.ReactNode;
-}
-export declare function ThemedText({ color, backgroundColor, dimColor, dim, ...rest }: ThemedTextProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ToolCall.d.ts

@@ -1,28 +0,0 @@
-interface ToolCallStartProps {
-    toolName: string;
-    args: Record<string, unknown>;
-    nested?: boolean;
-}
-export declare function ToolCallStart({ toolName, args, nested }: ToolCallStartProps): import("react/jsx-runtime").JSX.Element;
-interface ToolCallRunningProps {
-    toolName: string;
-    nested?: boolean;
-}
-export declare function ToolCallRunning({ toolName, nested }: ToolCallRunningProps): import("react/jsx-runtime").JSX.Element;
-interface ToolCallResultProps {
-    toolName: string;
-    result?: string;
-    error?: string;
-    nested?: boolean;
-    /** When true, show full output instead of collapsed preview. */
-    expanded?: boolean;
-    /**
-     * When true, render as a single dim line — used for transient
-     * "this attempt failed and was retried" cases (e.g. Arena's
-     * fail-fast endpoint check) so the feed isn't swamped with scary
-     * red error cards for what was just a parameter fix-up.
-     */
-    compact?: boolean;
-}
-export declare function ToolCallResult({ toolName, result, error, nested, expanded: forceExpand, compact, }: ToolCallResultProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/UpdateBanner.d.ts

@@ -1 +0,0 @@
-export declare function UpdateBanner(): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/components/VirtualMessageList.d.ts

@@ -1,43 +0,0 @@
-/**
- * VirtualMessageList — ScrollBox + viewport-windowed chat rendering.
- *
- * Owns its own ScrollBox + useVirtualScroll. Only items in the viewport
- * (+ overscan) are mounted as React fibers / Yoga nodes; the rest live
- * as height-equivalent topSpacer / bottomSpacer boxes. ScrollBox handles
- * sticky-bottom, wheel/key scroll, render-time clamping.
- *
- * Each rendered item is wrapped in <MessageRow> (React.memo) so historical
- * entries skip re-render entirely on stream ticks. Cursor-outline decoration
- * is applied OUTSIDE the memo boundary so the render closure stays cursor-
- * agnostic.
- *
- * Auto-stick: when entries grow while ScrollBox is "sticky" (default + after
- * scrollToBottom), the view follows the tail. User scrolling up breaks
- * stickiness; clicking the "N new messages" pill should call onJumpToNew
- * which ultimately invokes scrollToBottom (wired via the imperative handle).
- */
-import React, { type ReactNode } from "react";
-import { type ChatEntry } from "../store.js";
-interface VirtualMessageListProps {
-    entries: ChatEntry[];
-    renderEntry: (entry: ChatEntry, key: string, expanded: boolean) => ReactNode;
-    /** Terminal width — threaded into MessageRow so width changes invalidate memo. */
-    columns: number;
-    /** Id of the entry currently receiving stream deltas (null = no stream). */
-    streamingEntryId?: string | null;
-    /** Id of the entry under the transcript-mode cursor (null = no cursor). */
-    selectedEntryId?: string | null;
-    /** True when long entries should render expanded (transcript mode). */
-    expanded?: boolean;
-    /** Index where "N new" divider should render (null = no divider). */
-    dividerIndex?: number | null;
-    /** Count of unseen messages to show in divider. */
-    unseenCount?: number;
-}
-export interface VirtualMessageListHandle {
-    scrollToBottom: () => void;
-    scrollBy: (dy: number) => void;
-    getViewportHeight: () => number;
-}
-export declare const VirtualMessageList: React.ForwardRefExoticComponent<VirtualMessageListProps & React.RefAttributes<VirtualMessageListHandle>>;
-export {};

package/dist/ui/components/WelcomeTips.d.ts

@@ -1,5 +0,0 @@
-interface WelcomeTipsProps {
-    cwd: string;
-}
-export declare function WelcomeTips({ cwd }: WelcomeTipsProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/dev-seed.d.ts

@@ -1 +0,0 @@
-export declare function applyDevSeed(): void;

package/dist/ui/fullscreen-mode.d.ts

@@ -1,9 +0,0 @@
-export declare const TAIL_ENTRY_LIMIT = 500;
-export declare const INITIAL_FULLSCREEN_MODE: boolean;
-export interface FullscreenModeValue {
-    fullscreen: boolean;
-    setFullscreen: (next: boolean) => void;
-    toggleFullscreen: () => void;
-}
-export declare const FullscreenModeContext: import("react").Context<FullscreenModeValue>;
-export declare function useFullscreenMode(): FullscreenModeValue;

package/dist/ui/hooks/useCostSummary.d.ts

@@ -1 +0,0 @@
-export declare function useCostSummary(): void;

package/dist/ui/hooks/useVirtualScroll.d.ts

@@ -1,101 +0,0 @@
-import type { RefObject } from 'react';
-import type { ScrollBoxHandle } from '../../render/components/ScrollBox.js';
-import type { DOMElement } from '../../render/dom.js';
-export type VirtualScrollResult = {
-    /** [startIndex, endIndex) half-open slice of items to render. */
-    range: readonly [number, number];
-    /** Height (rows) of spacer before the first rendered item. */
-    topSpacer: number;
-    /** Height (rows) of spacer after the last rendered item. */
-    bottomSpacer: number;
-    /**
-     * Callback ref factory. Attach `measureRef(itemKey)` to each rendered
-     * item's root Box; after Yoga layout, the computed height is cached.
-     */
-    measureRef: (key: string) => (el: DOMElement | null) => void;
-    /**
-     * Attach to the topSpacer Box. Its Yoga computedTop IS listOrigin
-     * (first child of the virtualized region, so its top = cumulative
-     * height of everything rendered before the list in the ScrollBox).
-     * Drift-free: no subtraction of offsets, no dependence on item
-     * heights that change between renders (tmux resize).
-     */
-    spacerRef: RefObject<DOMElement | null>;
-    /**
-     * Cumulative y-offset of each item in list-wrapper coords (NOT scrollbox
-     * coords — logo/siblings before this list shift the origin).
-     * offsets[i] = rows above item i; offsets[n] = totalHeight.
-     * Recomputed every render — don't memo on identity.
-     */
-    offsets: ArrayLike<number>;
-    /**
-     * Read Yoga computedTop for item at index. Returns -1 if the item isn't
-     * mounted or hasn't been laid out. Item Boxes are direct Yoga children
-     * of the ScrollBox content wrapper (fragments collapse in the Ink DOM),
-     * so this is content-wrapper-relative — same coordinate space as
-     * scrollTop. Yoga layout is scroll-independent (translation happens
-     * later in renderNodeToOutput), so positions stay valid across scrolls
-     * without waiting for Ink to re-render. StickyTracker walks the mount
-     * range with this to find the viewport boundary at per-scroll-tick
-     * granularity (finer than the 40-row quantum this hook re-renders at).
-     */
-    getItemTop: (index: number) => number;
-    /**
-     * Get the mounted DOMElement for item at index, or null. For
-     * ScrollBox.scrollToElement — anchoring by element ref defers the
-     * Yoga-position read to render time (deterministic; no throttle race).
-     */
-    getItemElement: (index: number) => DOMElement | null;
-    /** Measured Yoga height. undefined = not yet measured; 0 = rendered nothing. */
-    getItemHeight: (index: number) => number | undefined;
-    /**
-     * Scroll so item `i` is in the mounted range. Sets scrollTop =
-     * offsets[i] + listOrigin. The range logic finds start from
-     * scrollTop vs offsets[] — BOTH use the same offsets value, so they
-     * agree by construction regardless of whether offsets[i] is the
-     * "true" position. Item i mounts; its screen position may be off by
-     * a few-dozen rows (overscan-worth of estimate drift), but it's in
-     * the DOM. Follow with getItemTop(i) for the precise position.
-     */
-    scrollToIndex: (i: number) => void;
-};
-/**
- * React-level virtualization for items inside a ScrollBox.
- *
- * The ScrollBox already does Ink-output-level viewport culling
- * (render-node-to-output.ts:617 skips children outside the visible window),
- * but all React fibers + Yoga nodes are still allocated. At ~250 KB RSS per
- * MessageRow, a 1000-message session costs ~250 MB of grow-only memory
- * (Ink screen buffer, WASM linear memory, JSC page retention all grow-only).
- *
- * This hook mounts only items in viewport + overscan. Spacer boxes hold the
- * scroll height constant for the rest at O(1) fiber cost each.
- *
- * Height estimation: fixed DEFAULT_ESTIMATE for unmeasured items, replaced
- * by real Yoga heights after first layout. No scroll anchoring — overscan
- * absorbs estimate errors. If drift is noticeable in practice, anchoring
- * (scrollBy(delta) when topSpacer changes) is a straightforward followup.
- *
- * stickyScroll caveat: render-node-to-output.ts:450 sets scrollTop=maxScroll
- * during Ink's render phase, which does NOT fire ScrollBox.subscribe. The
- * at-bottom check below handles this — when pinned to the bottom, we render
- * the last N items regardless of what scrollTop claims.
- */
-export declare function useVirtualScroll(scrollRef: RefObject<ScrollBoxHandle | null>, itemKeys: readonly string[], 
-/**
- * Terminal column count. On change, cached heights are stale (text
- * rewraps) — SCALED by oldCols/newCols rather than cleared. Clearing
- * made the pessimistic coverage back-walk mount ~190 items (every
- * uncached item → PESSIMISTIC_HEIGHT=1 → walk 190 to reach
- * viewport+2×overscan). Each fresh mount runs marked.lexer + syntax
- * highlighting ≈ 3ms; ~600ms React reconcile on first resize with a
- * long conversation. Scaling keeps heightCache populated → back-walk
- * uses real-ish heights → mount range stays tight. Scaled estimates
- * are overwritten by real Yoga heights on next useLayoutEffect.
- *
- * Scaled heights are close enough that the black-screen-on-widen bug
- * (inflated pre-resize offsets overshoot post-resize scrollTop → end
- * loop stops short of tail) doesn't trigger: ratio<1 on widen scales
- * heights DOWN, keeping offsets roughly aligned with post-resize Yoga.
- */
-columns: number): VirtualScrollResult;

package/dist/ui/index.d.ts

@@ -1,12 +0,0 @@
-import type { AgentClient } from "../protocol/client.js";
-export interface InkReplOptions {
-    client: AgentClient;
-    model: string;
-    effort: string;
-    maxTurns: number;
-    cwd: string;
-    maxContextTokens: number;
-    sessionId?: string;
-    prefill?: string;
-}
-export declare function startInkRepl(options: InkReplOptions): Promise<void>;