@provos/ironcurtain 0.10.0 → 0.12.0

package/dist/observe/observe-tui-types.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Shared types, constants, and layout calculation for the observe TUI.
+ *
+ * This module is types-and-constants only -- no behavior, no rendering,
+ * no I/O. All TUI modules depend on this file; it depends on nothing
+ * except Node built-ins (for locale detection).
+ */
+import type { TokenStreamEvent } from '../docker/token-stream-types.js';
+/** Half-width katakana + digits -- same set as mux-splash.ts RAIN_CHARS. */
+export declare const RAIN_CHARS = "\uFF66\uFF71\uFF72\uFF73\uFF74\uFF75\uFF76\uFF77\uFF78\uFF79\uFF7A\uFF7B\uFF7C\uFF7D\uFF7E\uFF7F\uFF80\uFF81\uFF82\uFF83\uFF84\uFF85\uFF86\uFF87\uFF88\uFF89\uFF8A\uFF8B\uFF8C\uFF8D\uFF8E\uFF8F\uFF90\uFF91\uFF92\uFF93\uFF94\uFF95\uFF96\uFF97\uFF98\uFF99\uFF9A\uFF9B\uFF9C\uFF9D0123456789";
+/** ASCII fallback for non-UTF-8 locales. */
+export declare const ASCII_RAIN_CHARS = "0123456789abcdefghijklmnopqrstuvwxyz@#$%&*+=<>~";
+/** Target frame interval in milliseconds (~15 FPS). */
+export declare const FRAME_MS = 66;
+/** Fraction of terminal width allocated to the rain panel. */
+export declare const RAIN_WIDTH_FRACTION = 0.18;
+/** Minimum columns for the rain panel when visible. */
+export declare const MIN_RAIN_COLS = 15;
+/** Minimum columns for the text panel. */
+export declare const MIN_TEXT_COLS = 40;
+/** Below this total width, rain is hidden and text takes the full width. */
+export declare const MIN_TOTAL_COLS = 60;
+/** Below this row count, only the status bar is rendered (rain + text suppressed). */
+export declare const MIN_USABLE_ROWS = 5;
+/** Width of the vertical divider between rain and text panels. */
+export declare const DIVIDER_WIDTH = 1;
+/** Maximum characters queued for rain display before oldest are dropped. */
+export declare const RAIN_QUEUE_CAPACITY = 2048;
+/** Maximum lines retained in the text panel ring buffer. */
+export declare const TEXT_BUFFER_CAPACITY = 10000;
+/**
+ * SGR escape sequences (true-color 24-bit).
+ * Adapted from mux-splash.ts CLR_* constants.
+ * Inline SGR avoids chalk dependency for zero-allocation frame rendering.
+ */
+export declare const SGR: {
+    readonly RESET: "\u001B[0m";
+    readonly RAIN_HEAD_TEXT: "\u001B[1;38;2;180;255;180m";
+    readonly RAIN_NEAR_TEXT: "\u001B[38;2;0;255;70m";
+    readonly RAIN_FAR_TEXT: "\u001B[38;2;0;120;0m";
+    readonly RAIN_HEAD_TOOL: "\u001B[1;38;2;180;255;255m";
+    readonly RAIN_NEAR_TOOL: "\u001B[38;2;0;200;255m";
+    readonly RAIN_FAR_TOOL: "\u001B[38;2;0;100;130m";
+    readonly RAIN_HEAD_ERROR: "\u001B[1;38;2;255;180;180m";
+    readonly RAIN_NEAR_ERROR: "\u001B[38;2;255;70;70m";
+    readonly RAIN_FAR_ERROR: "\u001B[38;2;130;0;0m";
+    readonly RAIN_IDLE: "\u001B[38;2;0;80;0m";
+    readonly TEXT_NORMAL: "\u001B[38;2;200;200;200m";
+    readonly TEXT_TOOL: "\u001B[38;2;0;200;255m";
+    readonly TEXT_TOOL_DIM: "\u001B[38;2;0;130;170m";
+    readonly TEXT_ERROR: "\u001B[38;2;255;80;80m";
+    readonly TEXT_SEPARATOR: "\u001B[38;2;80;80;80m";
+    readonly TEXT_META: "\u001B[38;2;100;100;100m";
+    readonly TEXT_DIM: "\u001B[2m";
+    readonly SESSION_0: "\u001B[38;2;0;255;70m";
+    readonly SESSION_1: "\u001B[38;2;0;200;255m";
+    readonly SESSION_2: "\u001B[38;2;200;150;255m";
+    readonly SESSION_3: "\u001B[38;2;255;200;0m";
+    readonly SESSION_4: "\u001B[38;2;255;100;100m";
+    readonly SESSION_5: "\u001B[38;2;100;255;200m";
+    readonly DIVIDER: "\u001B[38;2;40;60;40m";
+    readonly STATUS_BG: "\u001B[48;2;10;15;10m";
+    readonly STATUS_LABEL: "\u001B[1;38;2;0;255;70m";
+    readonly STATUS_VALUE: "\u001B[38;2;0;200;180m";
+    readonly STATUS_SEPARATOR: "\u001B[38;2;40;70;40m";
+    readonly STATUS_HINT: "\u001B[38;2;60;80;60m";
+    readonly STATUS_ERROR: "\u001B[1;38;2;255;70;70m";
+    readonly WORD_TEXT: "\u001B[1;38;2;150;255;150m";
+    readonly WORD_TOOL: "\u001B[1;38;2;100;255;255m";
+    readonly WORD_PHASE: "\u001B[1;38;2;255;255;180m";
+    readonly WORD_MODEL: "\u001B[1;38;2;180;180;255m";
+    readonly TEXT_THINKING: "\u001B[2;3;38;2;0;200;100m";
+    readonly STATUS_PHASE_THINKING: "\u001B[38;2;0;255;70m";
+    readonly STATUS_PHASE_TOOL: "\u001B[38;2;0;200;255m";
+    readonly STATUS_PHASE_IDLE: "\u001B[38;2;80;80;80m";
+    readonly STATUS_PHASE_ERROR: "\u001B[38;2;255;70;70m";
+};
+/** Session label colors, indexed by `label % SESSION_COLORS.length`. */
+export declare const SESSION_COLORS: readonly ["\u001B[38;2;0;255;70m", "\u001B[38;2;0;200;255m", "\u001B[38;2;200;150;255m", "\u001B[38;2;255;200;0m", "\u001B[38;2;255;100;100m", "\u001B[38;2;100;255;200m"];
+/** Returns the SGR color sequence for a given session label number. */
+export declare function sessionColor(label: number): string;
+/** Computed screen layout for the TUI. */
+export interface TuiLayout {
+    readonly cols: number;
+    readonly rows: number;
+    /** Number of columns for the rain panel (0 when terminal too narrow). */
+    readonly rainCols: number;
+    /** Column index of the vertical divider. */
+    readonly dividerCol: number;
+    /** First column of the text panel. */
+    readonly textStartCol: number;
+    /** Usable width of the text panel. */
+    readonly textCols: number;
+    /** Rows available for text content (rows - 1, reserving status bar). */
+    readonly textRows: number;
+    /** 0-indexed row for the status bar. */
+    readonly statusRow: number;
+}
+/**
+ * Computes the TUI layout for the given terminal dimensions.
+ *
+ * When `cols >= MIN_TOTAL_COLS`, the rain panel gets ~18% of the width.
+ * Otherwise the rain panel is hidden and text takes the full width.
+ */
+export declare function calculateTuiLayout(cols: number, rows: number): TuiLayout;
+/**
+ * Agent phase as tracked by the orchestrator and communicated
+ * to the rain engine for color selection.
+ *
+ * Extends the existing SessionState.phase with an 'error' pseudo-phase
+ * that the rain engine can react to (triggered by error events, auto-clears).
+ */
+export type AgentPhase = 'thinking' | 'tool_use' | 'idle' | 'error';
+/** Lifecycle phase of a word drop. */
+export type WordDropPhase = 'forming' | 'holding' | 'dissolving';
+/** Source category for word drop content, determines color. */
+export type WordDropSource = 'tool' | 'phase' | 'model' | 'text';
+/**
+ * A word that materializes horizontally in the rain panel.
+ *
+ * The word occupies a contiguous horizontal span at a fixed row.
+ * Each character tracks whether it has been "revealed" (formation),
+ * is "held" (static), or "released" (converted to a falling drop).
+ */
+export interface WordDrop {
+    /** The word to display. */
+    readonly word: string;
+    /** Source category (determines color). */
+    readonly source: WordDropSource;
+    /** Top-left column (0-indexed within rain panel). */
+    readonly col: number;
+    /** Row position (0-indexed). */
+    readonly row: number;
+    /** Current lifecycle phase. */
+    phase: WordDropPhase;
+    /** Frame counter within the current phase. */
+    phaseFrame: number;
+    /**
+     * Per-character state.
+     * - During 'forming': index < revealedCount are visible.
+     * - During 'holding': all visible.
+     * - During 'dissolving': dissolveOrder tracks release sequence.
+     */
+    revealedCount: number;
+    /**
+     * Randomized dissolution order. Indices into `word` specifying
+     * which character dissolves on each frame of the dissolving phase.
+     * Length = word.length. Built once at transition to 'dissolving'.
+     */
+    dissolveOrder: number[];
+    /** Number of characters dissolved so far. */
+    dissolvedCount: number;
+    /** Number of frames to hold (chosen at formation). */
+    holdDuration: number;
+}
+/** Tracks accumulated tool_use input fragments per session. */
+export interface ToolAccumulator {
+    /** Tool name from the content_block_start event. */
+    toolName: string;
+    /** Accumulated inputDelta JSON fragments. */
+    inputBuffer: string;
+    /** Whether we have received at least one inputDelta fragment. */
+    hasInput: boolean;
+}
+/** Raw SSE event types that are suppressed in --raw mode (shown only in --debug). */
+export declare const SUPPRESSED_RAW_EVENTS: ReadonlySet<string>;
+/** Event kind that determines rain drop coloring. */
+export type RainColorKind = 'text' | 'tool' | 'error' | 'idle';
+/** A character queued for rain display, tagged with its event kind. */
+export interface RainToken {
+    readonly char: string;
+    readonly kind: 'text' | 'tool' | 'error';
+}
+/** State of a single falling rain drop. */
+export interface RainDrop {
+    /** Column within the rain panel (0-indexed). */
+    col: number;
+    /** Current head row position (can be negative during entry). */
+    headRow: number;
+    /** Rows per frame (1-3, fractional via speedAccum). */
+    speed: number;
+    /** Fractional speed accumulator for sub-integer movement. */
+    speedAccum: number;
+    /** Number of trailing characters (3-6). */
+    trailLen: number;
+    /** Color scheme for this drop. */
+    colorKind: RainColorKind;
+    /** Fixed-size ring buffer of characters (length = trailLen + 1). */
+    chars: string[];
+    /** Rotating write index into chars; wraps at chars.length. */
+    headIdx: number;
+    /** False once the drop has fully exited the screen. */
+    alive: boolean;
+}
+/** A single pre-formatted line in the text panel ring buffer. */
+export interface PanelLine {
+    /** Pre-formatted content with SGR codes (no cursor positioning). */
+    readonly ansi: string;
+    /** Visible character width (excluding ANSI escape sequences). */
+    readonly plainLen: number;
+}
+/** Tracks an incomplete text line for a session (text_delta accumulation). */
+export interface SessionPartialLine {
+    /** Accumulated text not yet terminated by a newline. */
+    buffer: string;
+    /** ANSI prefix for the current line (session label SGR, if showLabel). */
+    prefix: string;
+}
+/** Per-session tracking for the TUI status bar and metrics. */
+export interface SessionState {
+    /** Session label number. */
+    readonly label: number;
+    /** Running sum of input tokens from message_end events. */
+    inputTokens: number;
+    /** Running sum of output tokens from message_end events. */
+    outputTokens: number;
+    /** Count of tool_use events observed. */
+    toolCount: number;
+    /** Model name from the most recent message_start event. */
+    model: string | null;
+    /** Current agent phase: thinking, using tools, or idle. */
+    phase: 'thinking' | 'tool_use' | 'idle';
+    /** Timestamp (Date.now()) of the last event received. */
+    lastEventTime: number;
+    /** Whether the session has ended. */
+    ended: boolean;
+    /** Reason for session end, if ended. */
+    endReason: string | null;
+    /** Name of the tool currently being invoked (null when not in tool_use phase). */
+    currentToolName: string | null;
+}
+/**
+ * Abstraction over the rendering backend for observe events.
+ * Both the plain text renderer and the TUI implement this interface,
+ * allowing observe-command.ts to route events without knowing which
+ * renderer is active.
+ */
+export interface ObserveEventSink {
+    /** Feed a batch of token stream events from one session. */
+    pushEvents(label: number, events: readonly TokenStreamEvent[]): void;
+    /** Notify that a session ended. */
+    sessionEnded(label: number, reason: string): void;
+    /** Notify that the WebSocket connection to the daemon was lost. */
+    connectionLost(reason: string): void;
+}
+/** Options for creating an ObserveTui instance. */
+export interface ObserveTuiOptions {
+    /** Show all event kinds, not just text_delta. */
+    readonly raw: boolean;
+    /** Prefix output lines with a session label (multi-session mode). */
+    readonly showLabel: boolean;
+    /** Show absolutely all events including protocol noise. Implies raw. */
+    readonly debug: boolean;
+}
+/**
+ * Returns true when the current locale supports UTF-8 output.
+ * Checks `LANG`, `LC_ALL`, and `LC_CTYPE` environment variables.
+ */
+export declare function isUtf8Locale(): boolean;
+/**
+ * Returns the appropriate rain character set based on locale.
+ * Uses half-width katakana for UTF-8 locales, ASCII fallback otherwise.
+ */
+export declare function getRainChars(): string;
+/** Regex matching SGR escape sequences (e.g. \x1b[38;2;0;255;70m). */
+export declare const ANSI_RE: RegExp;
+/** Strip SGR escape sequences, returning only visible characters. */
+export declare function stripAnsi(s: string): string;
+/** Visible character count of a string with embedded ANSI escape sequences. */
+export declare function visibleLength(s: string): number;

package/dist/observe/observe-tui-types.js

@@ -0,0 +1,200 @@
+/**
+ * Shared types, constants, and layout calculation for the observe TUI.
+ *
+ * This module is types-and-constants only -- no behavior, no rendering,
+ * no I/O. All TUI modules depend on this file; it depends on nothing
+ * except Node built-ins (for locale detection).
+ */
+// ---------------------------------------------------------------------------
+// Character sets
+// ---------------------------------------------------------------------------
+/** Half-width katakana + digits -- same set as mux-splash.ts RAIN_CHARS. */
+export const RAIN_CHARS = 'ｦｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜﾝ0123456789';
+/** ASCII fallback for non-UTF-8 locales. */
+export const ASCII_RAIN_CHARS = '0123456789abcdefghijklmnopqrstuvwxyz@#$%&*+=<>~';
+// ---------------------------------------------------------------------------
+// Timing
+// ---------------------------------------------------------------------------
+/** Target frame interval in milliseconds (~15 FPS). */
+export const FRAME_MS = 66;
+// ---------------------------------------------------------------------------
+// Layout constants
+// ---------------------------------------------------------------------------
+/** Fraction of terminal width allocated to the rain panel. */
+export const RAIN_WIDTH_FRACTION = 0.18;
+/** Minimum columns for the rain panel when visible. */
+export const MIN_RAIN_COLS = 15;
+/** Minimum columns for the text panel. */
+export const MIN_TEXT_COLS = 40;
+/** Below this total width, rain is hidden and text takes the full width. */
+export const MIN_TOTAL_COLS = 60;
+/** Below this row count, only the status bar is rendered (rain + text suppressed). */
+export const MIN_USABLE_ROWS = 5;
+/** Width of the vertical divider between rain and text panels. */
+export const DIVIDER_WIDTH = 1;
+// ---------------------------------------------------------------------------
+// Capacity limits
+// ---------------------------------------------------------------------------
+/** Maximum characters queued for rain display before oldest are dropped. */
+export const RAIN_QUEUE_CAPACITY = 2048;
+/** Maximum lines retained in the text panel ring buffer. */
+export const TEXT_BUFFER_CAPACITY = 10_000;
+// ---------------------------------------------------------------------------
+// SGR color palette
+// ---------------------------------------------------------------------------
+/**
+ * SGR escape sequences (true-color 24-bit).
+ * Adapted from mux-splash.ts CLR_* constants.
+ * Inline SGR avoids chalk dependency for zero-allocation frame rendering.
+ */
+export const SGR = {
+    RESET: '\x1b[0m',
+    // Rain colors by event kind
+    RAIN_HEAD_TEXT: '\x1b[1;38;2;180;255;180m', // bright white-green (text_delta head)
+    RAIN_NEAR_TEXT: '\x1b[38;2;0;255;70m', // bright green trail
+    RAIN_FAR_TEXT: '\x1b[38;2;0;120;0m', // dim green trail
+    RAIN_HEAD_TOOL: '\x1b[1;38;2;180;255;255m', // bright white-cyan (tool_use head)
+    RAIN_NEAR_TOOL: '\x1b[38;2;0;200;255m', // bright cyan trail
+    RAIN_FAR_TOOL: '\x1b[38;2;0;100;130m', // dim cyan trail
+    RAIN_HEAD_ERROR: '\x1b[1;38;2;255;180;180m', // bright white-red (error head)
+    RAIN_NEAR_ERROR: '\x1b[38;2;255;70;70m', // bright red trail
+    RAIN_FAR_ERROR: '\x1b[38;2;130;0;0m', // dim red trail
+    RAIN_IDLE: '\x1b[38;2;0;80;0m', // very dim green (ambient)
+    // Text panel
+    TEXT_NORMAL: '\x1b[38;2;200;200;200m', // light grey prose
+    TEXT_TOOL: '\x1b[38;2;0;200;255m', // cyan tool headers
+    TEXT_TOOL_DIM: '\x1b[38;2;0;130;170m', // dim cyan tool input
+    TEXT_ERROR: '\x1b[38;2;255;80;80m', // red errors
+    TEXT_SEPARATOR: '\x1b[38;2;80;80;80m', // dim grey separators
+    TEXT_META: '\x1b[38;2;100;100;100m', // very dim metadata
+    TEXT_DIM: '\x1b[2m', // generic dim
+    // Session label colors (cycled per label number)
+    SESSION_0: '\x1b[38;2;0;255;70m', // green
+    SESSION_1: '\x1b[38;2;0;200;255m', // cyan
+    SESSION_2: '\x1b[38;2;200;150;255m', // purple
+    SESSION_3: '\x1b[38;2;255;200;0m', // amber
+    SESSION_4: '\x1b[38;2;255;100;100m', // salmon
+    SESSION_5: '\x1b[38;2;100;255;200m', // mint
+    // Divider
+    DIVIDER: '\x1b[38;2;40;60;40m', // very dim green vertical line
+    // Status bar (cyberpunk palette)
+    STATUS_BG: '\x1b[48;2;10;15;10m', // near-black green tint background
+    STATUS_LABEL: '\x1b[1;38;2;0;255;70m', // bright green labels
+    STATUS_VALUE: '\x1b[38;2;0;200;180m', // teal values
+    STATUS_SEPARATOR: '\x1b[38;2;40;70;40m', // dim green separators
+    STATUS_HINT: '\x1b[38;2;60;80;60m', // very dim hint text
+    STATUS_ERROR: '\x1b[1;38;2;255;70;70m', // bright red for connection lost
+    // Word drop colors (brighter than regular rain to stand out)
+    WORD_TEXT: '\x1b[1;38;2;150;255;150m', // bright green (text fragments)
+    WORD_TOOL: '\x1b[1;38;2;100;255;255m', // bright cyan (tool names)
+    WORD_PHASE: '\x1b[1;38;2;255;255;180m', // bright warm yellow (phase labels)
+    WORD_MODEL: '\x1b[1;38;2;180;180;255m', // bright lavender (model name)
+    // Thinking text in text panel
+    TEXT_THINKING: '\x1b[2;3;38;2;0;200;100m', // dim italic green
+    // Status bar phase indicators
+    STATUS_PHASE_THINKING: '\x1b[38;2;0;255;70m', // green
+    STATUS_PHASE_TOOL: '\x1b[38;2;0;200;255m', // cyan
+    STATUS_PHASE_IDLE: '\x1b[38;2;80;80;80m', // dim grey
+    STATUS_PHASE_ERROR: '\x1b[38;2;255;70;70m', // red
+};
+/** Session label colors, indexed by `label % SESSION_COLORS.length`. */
+export const SESSION_COLORS = [
+    SGR.SESSION_0,
+    SGR.SESSION_1,
+    SGR.SESSION_2,
+    SGR.SESSION_3,
+    SGR.SESSION_4,
+    SGR.SESSION_5,
+];
+/** Returns the SGR color sequence for a given session label number. */
+export function sessionColor(label) {
+    return SESSION_COLORS[label % SESSION_COLORS.length];
+}
+/**
+ * Computes the TUI layout for the given terminal dimensions.
+ *
+ * When `cols >= MIN_TOTAL_COLS`, the rain panel gets ~18% of the width.
+ * Otherwise the rain panel is hidden and text takes the full width.
+ */
+export function calculateTuiLayout(cols, rows) {
+    const statusRow = rows - 1;
+    const textRows = rows - 1;
+    if (cols < MIN_TOTAL_COLS) {
+        // Too narrow for split: full-width text panel, no rain
+        return {
+            cols,
+            rows,
+            rainCols: 0,
+            dividerCol: 0,
+            textStartCol: 0,
+            textCols: cols,
+            textRows,
+            statusRow,
+        };
+    }
+    const rainCols = Math.max(MIN_RAIN_COLS, Math.floor(cols * RAIN_WIDTH_FRACTION));
+    const dividerCol = rainCols;
+    const textStartCol = rainCols + DIVIDER_WIDTH;
+    const textCols = cols - textStartCol;
+    return {
+        cols,
+        rows,
+        rainCols,
+        dividerCol,
+        textStartCol,
+        textCols: Math.max(1, textCols),
+        textRows,
+        statusRow,
+    };
+}
+// ---------------------------------------------------------------------------
+// Filtered raw event types
+// ---------------------------------------------------------------------------
+/** Raw SSE event types that are suppressed in --raw mode (shown only in --debug). */
+export const SUPPRESSED_RAW_EVENTS = new Set([
+    'content_block_stop',
+    'message_stop',
+    'ping',
+    'signature_delta',
+]);
+// ---------------------------------------------------------------------------
+// Locale detection
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when the current locale supports UTF-8 output.
+ * Checks `LANG`, `LC_ALL`, and `LC_CTYPE` environment variables.
+ */
+export function isUtf8Locale() {
+    const vars = [process.env.LC_ALL, process.env.LC_CTYPE, process.env.LANG];
+    for (const v of vars) {
+        if (v) {
+            const upper = v.toUpperCase();
+            if (upper.includes('UTF-8') || upper.includes('UTF8')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Returns the appropriate rain character set based on locale.
+ * Uses half-width katakana for UTF-8 locales, ASCII fallback otherwise.
+ */
+export function getRainChars() {
+    return isUtf8Locale() ? RAIN_CHARS : ASCII_RAIN_CHARS;
+}
+// ---------------------------------------------------------------------------
+// ANSI helpers
+// ---------------------------------------------------------------------------
+/** Regex matching SGR escape sequences (e.g. \x1b[38;2;0;255;70m). */
+// eslint-disable-next-line no-control-regex
+export const ANSI_RE = /\x1b\[[0-9;]*m/g;
+/** Strip SGR escape sequences, returning only visible characters. */
+export function stripAnsi(s) {
+    return s.replace(ANSI_RE, '');
+}
+/** Visible character count of a string with embedded ANSI escape sequences. */
+export function visibleLength(s) {
+    return stripAnsi(s).length;
+}
+//# sourceMappingURL=observe-tui-types.js.map

package/dist/observe/observe-tui-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-tui-types.js","sourceRoot":"","sources":["../../src/observe/observe-tui-types.ts"],"names":[],"mappings":"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"}

package/dist/observe/observe-tui-word-scorer.d.ts

@@ -0,0 +1,143 @@
+/**
+ * TF-IDF word scorer for the observe TUI rain panel.
+ *
+ * Maintains a running TF-IDF model over the session, treating each
+ * message turn or tool call as a "document" and the full session
+ * history as the corpus. Produces top-scoring words for rain panel
+ * word drops, with throttle/dedup to avoid repetition.
+ *
+ * Depends on observe-tui-types.ts only. No external dependencies.
+ */
+import type { TokenStreamEvent } from '../docker/token-stream-types.js';
+import type { WordDropSource } from './observe-tui-types.js';
+/**
+ * Extract candidate words from plain text.
+ *
+ * Returns an array of { original, lower } tuples where `original`
+ * preserves the source casing for display and `lower` is used for
+ * matching and dedup.
+ */
+export declare function extractWordsFromText(text: string): Array<{
+    original: string;
+    lower: string;
+}>;
+/**
+ * Extract words from code content (e.g., the `code` field of execute_code).
+ *
+ * Extracts function/method call names, meaningful string literals,
+ * dotted tool names, and also runs the regular word extractor on
+ * the full text.
+ */
+export declare function extractWordsFromCode(code: string): Array<{
+    original: string;
+    lower: string;
+}>;
+/**
+ * Try to extract the `code` field from accumulated tool input JSON.
+ * Returns the code string, or null if parsing fails or no code field.
+ */
+export declare function extractCodeFromToolInput(accumulatedJson: string): string | null;
+/**
+ * Scored word result from TF-IDF computation.
+ */
+export interface ScoredWord {
+    /** Original-cased word for display. */
+    word: string;
+    /** Lowercase key for dedup. */
+    key: string;
+    /** TF-IDF score. */
+    score: number;
+}
+/** Public interface for the word scorer. */
+export interface WordScorer {
+    /**
+     * Score a new document (message text or tool input).
+     * Adds it to the corpus and returns the top-scoring words.
+     */
+    scoreDocument(words: Array<{
+        original: string;
+        lower: string;
+    }>): ScoredWord[];
+    /**
+     * Check if a word can be shown (not recently displayed).
+     * If allowed, records it as shown.
+     */
+    tryShow(key: string, now?: number): boolean;
+    /** Number of documents in the corpus. */
+    readonly documentCount: number;
+}
+/**
+ * Create a WordScorer that maintains a running TF-IDF model.
+ *
+ * @param topN - Number of top-scoring words to return (default: 3)
+ * @param dedupWindowMs - Milliseconds before re-showing a word (default: 30s)
+ */
+export declare function createWordScorer(topN?: number, dedupWindowMs?: number): WordScorer;
+/**
+ * Clean up MCP tool names for display.
+ * Strips `mcp__` prefix and server name prefix.
+ * e.g., `mcp__ironcurtain__execute_code` -> `execute_code`
+ */
+export declare function cleanToolName(toolName: string): string;
+/**
+ * Shorten a model name for display.
+ * Strips the "claude-" prefix if present.
+ * e.g., "claude-sonnet-4-20250514" -> "sonnet-4-20250514"
+ */
+export declare function shortenModelName(model: string): string;
+/** Tracks accumulated text for periodic mid-stream word extraction. */
+export interface TextAccumulator {
+    /** Append text and return words if the threshold is reached. */
+    append(text: string): Array<{
+        original: string;
+        lower: string;
+    }> | null;
+    /** Flush remaining text and return words (for message_end). */
+    flush(): Array<{
+        original: string;
+        lower: string;
+    }>;
+    /** Reset the accumulator (for message_start). */
+    reset(): void;
+    /** Current accumulated text length. */
+    readonly length: number;
+}
+export declare function createTextAccumulator(threshold?: number): TextAccumulator;
+/** Tracks accumulated tool input JSON for word extraction on completion. */
+export interface ToolInputAccumulator {
+    /** Start a new tool call. */
+    start(toolName: string): void;
+    /** Append an input JSON delta fragment. */
+    appendDelta(delta: string): void;
+    /** Flush the accumulated input and return extracted words plus the tool name. */
+    flush(): {
+        toolName: string;
+        words: Array<{
+            original: string;
+            lower: string;
+        }>;
+    } | null;
+    /** Whether a tool call is in progress. */
+    readonly active: boolean;
+}
+export declare function createToolInputAccumulator(): ToolInputAccumulator;
+/** Per-session scoring state (text accumulator + tool input accumulator). */
+export interface SessionWordState {
+    readonly textAccumulator: TextAccumulator;
+    readonly toolAccumulator: ToolInputAccumulator;
+}
+export declare function createSessionWordState(): SessionWordState;
+/** A word drop candidate ready for enqueuing. */
+export interface WordDropCandidate {
+    word: string;
+    source: WordDropSource;
+}
+/**
+ * Process a token stream event through the word scorer and produce
+ * word drop candidates. Returns an array of candidates to enqueue.
+ *
+ * This is the main integration point between the orchestrator and
+ * the word scorer. The caller is responsible for calling
+ * `rainEngine.enqueueWord()` for each returned candidate.
+ */
+export declare function processEventForWords(event: TokenStreamEvent, sessionWordState: SessionWordState, scorer: WordScorer, now?: number): WordDropCandidate[];