@nex-ai/nex 0.1.21 → 0.1.23

package/dist/tui/generative/bindings.js

@@ -0,0 +1,152 @@
+/**
+ * RFC 6901 JSON Pointer implementation for A2UI data binding.
+ * Provides resolve/set/apply operations over a flat data model.
+ */
+/**
+ * Parse a JSON Pointer string into path segments.
+ * Handles RFC 6901 escaping: ~1 -> /, ~0 -> ~
+ */
+function parseSegments(pointer) {
+    if (pointer === '' || pointer === '/')
+        return [];
+    // Strip leading /
+    const raw = pointer.startsWith('/') ? pointer.slice(1) : pointer;
+    return raw.split('/').map((seg) => seg.replace(/~1/g, '/').replace(/~0/g, '~'));
+}
+/**
+ * Resolve a JSON Pointer against a data object.
+ *
+ * @example
+ * resolvePointer({ user: { name: "Alice" } }, "/user/name") // "Alice"
+ * resolvePointer({ items: [{ status: "done" }] }, "/items/0/status") // "done"
+ */
+export function resolvePointer(data, pointer) {
+    const segments = parseSegments(pointer);
+    let current = data;
+    for (const seg of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (Array.isArray(current)) {
+            const idx = Number(seg);
+            if (Number.isNaN(idx))
+                return undefined;
+            current = current[idx];
+        }
+        else if (typeof current === 'object') {
+            current = current[seg];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Set a value at a JSON Pointer path, creating intermediate objects as needed.
+ * Mutates the data object in place.
+ */
+export function setPointer(data, pointer, value) {
+    const segments = parseSegments(pointer);
+    if (segments.length === 0)
+        return;
+    let current = data;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        const nextSeg = segments[i + 1];
+        const isNextArray = /^\d+$/.test(nextSeg);
+        if (!(seg in current) || current[seg] === null || current[seg] === undefined) {
+            current[seg] = isNextArray ? [] : {};
+        }
+        const next = current[seg];
+        if (Array.isArray(next)) {
+            const idx = Number(segments[i + 1]);
+            // Ensure array is long enough
+            while (next.length <= idx)
+                next.push(undefined);
+            if (i + 1 === segments.length - 1) {
+                next[idx] = value;
+                return;
+            }
+            if (typeof next[idx] !== 'object' || next[idx] === null) {
+                next[idx] = {};
+            }
+            current = next[idx];
+            i++; // skip the array index segment
+        }
+        else if (typeof next === 'object') {
+            current = next;
+        }
+        else {
+            current[seg] = {};
+            current = current[seg];
+        }
+    }
+    const lastSeg = segments[segments.length - 1];
+    if (Array.isArray(current)) {
+        const idx = Number(lastSeg);
+        if (!Number.isNaN(idx)) {
+            while (current.length <= idx)
+                current.push(undefined);
+            current[idx] = value;
+        }
+    }
+    else {
+        current[lastSeg] = value;
+    }
+}
+/**
+ * Check if a string looks like a JSON Pointer (starts with "/").
+ */
+export function isPointer(value) {
+    return value.startsWith('/');
+}
+/**
+ * Apply a batch of updates to a data model.
+ * Returns a shallow copy of the model with updates applied.
+ */
+export function applyUpdates(model, updates) {
+    const result = { ...model };
+    for (const update of updates) {
+        switch (update.type) {
+            case 'set':
+                setPointer(result, update.path, update.value);
+                break;
+            case 'merge': {
+                const existing = resolvePointer(result, update.path);
+                if (typeof existing === 'object' &&
+                    existing !== null &&
+                    typeof update.value === 'object' &&
+                    update.value !== null &&
+                    !Array.isArray(existing)) {
+                    setPointer(result, update.path, {
+                        ...existing,
+                        ...update.value,
+                    });
+                }
+                else {
+                    // Fallback to set if not mergeable
+                    setPointer(result, update.path, update.value);
+                }
+                break;
+            }
+            case 'delete': {
+                const segments = update.path.startsWith('/')
+                    ? update.path.slice(1).split('/')
+                    : [];
+                if (segments.length === 1) {
+                    delete result[segments[0]];
+                }
+                else if (segments.length > 1) {
+                    const parentPath = '/' + segments.slice(0, -1).join('/');
+                    const parent = resolvePointer(result, parentPath);
+                    if (typeof parent === 'object' && parent !== null && !Array.isArray(parent)) {
+                        delete parent[segments[segments.length - 1]];
+                    }
+                }
+                break;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=bindings.js.map

package/dist/tui/generative/bindings.js.map

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

package/dist/tui/generative/registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Component registry: maps A2UI component type strings to their
+ * Ink renderer components.
+ */
+import type React from 'react';
+import type { A2UIComponent } from './types.js';
+export type RendererComponent = React.ComponentType<{
+    schema: A2UIComponent;
+    data: Record<string, unknown>;
+    onAction?: (action: string, payload?: unknown) => void;
+}>;
+/** Register a renderer for a component type. */
+export declare function registerRenderer(type: string, component: RendererComponent): void;
+/** Look up the renderer for a component type. */
+export declare function getRenderer(type: string): RendererComponent | undefined;
+/** Get all registered type names. */
+export declare function getRegisteredTypes(): string[];
+/** Known A2UI component types. */
+export declare const COMPONENT_TYPES: readonly ["row", "column", "card", "text", "textfield", "list", "table", "progress", "spacer"];

package/dist/tui/generative/registry.js

@@ -0,0 +1,31 @@
+/**
+ * Component registry: maps A2UI component type strings to their
+ * Ink renderer components.
+ */
+// Registry is populated by renderer.tsx at module load time
+const registry = new Map();
+/** Register a renderer for a component type. */
+export function registerRenderer(type, component) {
+    registry.set(type, component);
+}
+/** Look up the renderer for a component type. */
+export function getRenderer(type) {
+    return registry.get(type);
+}
+/** Get all registered type names. */
+export function getRegisteredTypes() {
+    return [...registry.keys()];
+}
+/** Known A2UI component types. */
+export const COMPONENT_TYPES = [
+    'row',
+    'column',
+    'card',
+    'text',
+    'textfield',
+    'list',
+    'table',
+    'progress',
+    'spacer',
+];
+//# sourceMappingURL=registry.js.map

package/dist/tui/generative/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tui/generative/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,4DAA4D;AAC5D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,SAA4B;IAE5B,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;IACL,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,MAAM;IACN,OAAO;IACP,UAAU;IACV,QAAQ;CACA,CAAC"}

package/dist/tui/generative/renderer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generative TUI renderer: converts A2UI JSON schema into an Ink
+ * component tree at runtime.
+ *
+ * Agents emit JSON matching the A2UIComponent schema; this module
+ * validates it, resolves JSON Pointer data bindings, and renders
+ * the corresponding Ink components.
+ */
+import React from 'react';
+import type { A2UIComponent, A2UIDataModel } from './types.js';
+export declare function validateSchema(schema: unknown): {
+    valid: boolean;
+    errors?: string[];
+};
+export interface GenerativeRendererProps {
+    schema: A2UIComponent;
+    data: A2UIDataModel;
+    onAction?: (action: string, payload?: unknown) => void;
+}
+/**
+ * Validates schema, resolves data bindings, and renders the
+ * A2UI component tree as Ink components.
+ */
+export declare function GenerativeRenderer({ schema, data, onAction, }: GenerativeRendererProps): React.JSX.Element;

package/dist/tui/generative/renderer.js

@@ -0,0 +1,160 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { resolvePointer, isPointer } from './bindings.js';
+import { COMPONENT_TYPES } from './registry.js';
+// ── Schema validation ───────────────────────────────────────────────
+export function validateSchema(schema) {
+    const errors = [];
+    if (typeof schema !== 'object' || schema === null) {
+        return { valid: false, errors: ['Schema must be a non-null object'] };
+    }
+    const obj = schema;
+    if (typeof obj.type !== 'string') {
+        errors.push('Component must have a "type" string property');
+        return { valid: false, errors };
+    }
+    if (!COMPONENT_TYPES.includes(obj.type)) {
+        errors.push(`Unknown component type "${obj.type}". Valid types: ${COMPONENT_TYPES.join(', ')}`);
+    }
+    // Container types must have children array
+    if (['row', 'column', 'card'].includes(obj.type)) {
+        if (!Array.isArray(obj.children)) {
+            errors.push(`"${obj.type}" component must have a "children" array`);
+        }
+    }
+    // Text must have content
+    if (obj.type === 'text') {
+        if (typeof obj.content !== 'string') {
+            errors.push('"text" component must have a "content" string');
+        }
+    }
+    // Progress must have numeric value
+    if (obj.type === 'progress') {
+        if (typeof obj.value !== 'number') {
+            errors.push('"progress" component must have a numeric "value"');
+        }
+    }
+    // Table must have headers
+    if (obj.type === 'table') {
+        if (!Array.isArray(obj.headers)) {
+            errors.push('"table" component must have a "headers" array');
+        }
+    }
+    // List must have items
+    if (obj.type === 'list') {
+        if (!Array.isArray(obj.items) && typeof obj.items !== 'string') {
+            errors.push('"list" component must have "items" (array or string pointer)');
+        }
+    }
+    return errors.length === 0 ? { valid: true } : { valid: false, errors };
+}
+// ── Resolve helper ──────────────────────────────────────────────────
+function resolveString(value, data) {
+    if (isPointer(value)) {
+        const resolved = resolvePointer(data, value);
+        return resolved !== undefined ? String(resolved) : value;
+    }
+    return value;
+}
+function RenderChildren({ children, data, onAction, }) {
+    return (_jsx(_Fragment, { children: children.map((child, i) => (_jsx(RenderComponent, { schema: child, data: data, onAction: onAction }, i))) }));
+}
+function RowRenderer({ schema, data, onAction, }) {
+    return (_jsx(Box, { flexDirection: "row", gap: schema.gap, padding: schema.padding, children: _jsx(RenderChildren, { children: schema.children, data: data, onAction: onAction }) }));
+}
+function ColumnRenderer({ schema, data, onAction, }) {
+    return (_jsx(Box, { flexDirection: "column", gap: schema.gap, padding: schema.padding, children: _jsx(RenderChildren, { children: schema.children, data: data, onAction: onAction }) }));
+}
+function CardRenderer({ schema, data, onAction, }) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: schema.borderColor ?? 'white', paddingX: 1, children: [schema.title && (_jsx(Text, { bold: true, children: resolveString(schema.title, data) })), _jsx(RenderChildren, { children: schema.children, data: data, onAction: onAction })] }));
+}
+function TextRenderer({ schema, data, }) {
+    const content = resolveString(schema.content, data);
+    return (_jsx(Text, { bold: schema.bold, color: schema.color, dimColor: schema.dimmed, children: content }));
+}
+function TextFieldRenderer({ schema, data, }) {
+    const value = schema.value
+        ? resolveString(schema.value, data)
+        : '';
+    const display = value || schema.placeholder || '';
+    return (_jsx(Box, { children: _jsx(Text, { color: value ? undefined : 'gray', children: display }) }));
+}
+function ListRenderer({ schema, data, onAction, }) {
+    let items;
+    if (typeof schema.items === 'string') {
+        const resolved = resolvePointer(data, schema.items);
+        items = Array.isArray(resolved) ? resolved.map(String) : [];
+    }
+    else {
+        items = schema.items;
+    }
+    return (_jsx(Box, { flexDirection: "column", children: items.map((item, i) => {
+            const isSelected = schema.selected === i;
+            return (_jsx(Box, { children: _jsxs(Text, { color: isSelected ? 'cyan' : undefined, children: [isSelected ? '> ' : '  ', item] }) }, i));
+        }) }));
+}
+function TableRenderer({ schema, data, }) {
+    let rows;
+    if (typeof schema.rows === 'string') {
+        const resolved = resolvePointer(data, schema.rows);
+        rows = Array.isArray(resolved)
+            ? resolved.map((r) => (Array.isArray(r) ? r.map(String) : [String(r)]))
+            : [];
+    }
+    else if (Array.isArray(schema.rows)) {
+        rows = schema.rows;
+    }
+    else {
+        rows = [];
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: schema.headers.map((h, i) => (_jsx(Box, { minWidth: 16, children: _jsx(Text, { bold: true, children: h }) }, i))) }), rows.map((row, ri) => (_jsx(Box, { children: row.map((cell, ci) => (_jsx(Box, { minWidth: 16, children: _jsx(Text, { children: cell }) }, ci))) }, ri)))] }));
+}
+function ProgressRenderer({ schema, }) {
+    const pct = Math.max(0, Math.min(100, schema.value));
+    const filled = Math.round(pct / 5);
+    const empty = 20 - filled;
+    const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(empty);
+    const label = schema.label ? `${schema.label} ` : '';
+    return (_jsxs(Text, { children: [label, "[", bar, "] ", Math.round(pct), "%"] }));
+}
+function SpacerRenderer({ schema, }) {
+    return _jsx(Box, { height: schema.height ?? 1 });
+}
+// ── Main dispatcher ─────────────────────────────────────────────────
+function RenderComponent({ schema, data, onAction, }) {
+    const childProps = { data, onAction };
+    switch (schema.type) {
+        case 'row':
+            return _jsx(RowRenderer, { schema: schema, ...childProps });
+        case 'column':
+            return _jsx(ColumnRenderer, { schema: schema, ...childProps });
+        case 'card':
+            return _jsx(CardRenderer, { schema: schema, ...childProps });
+        case 'text':
+            return _jsx(TextRenderer, { schema: schema, ...childProps });
+        case 'textfield':
+            return _jsx(TextFieldRenderer, { schema: schema, ...childProps });
+        case 'list':
+            return _jsx(ListRenderer, { schema: schema, ...childProps });
+        case 'table':
+            return _jsx(TableRenderer, { schema: schema, ...childProps });
+        case 'progress':
+            return _jsx(ProgressRenderer, { schema: schema, ...childProps });
+        case 'spacer':
+            return _jsx(SpacerRenderer, { schema: schema });
+        default:
+            return _jsxs(Text, { color: "red", children: ["Unknown component: ", schema.type] });
+    }
+}
+/**
+ * Validates schema, resolves data bindings, and renders the
+ * A2UI component tree as Ink components.
+ */
+export function GenerativeRenderer({ schema, data, onAction, }) {
+    const validation = validateSchema(schema);
+    if (!validation.valid) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "red", bold: true, children: "Invalid A2UI schema:" }), validation.errors?.map((err, i) => (_jsxs(Text, { color: "red", children: ["  - ", err] }, i)))] }));
+    }
+    return _jsx(RenderComponent, { schema: schema, data: data, onAction: onAction });
+}
+//# sourceMappingURL=renderer.js.map

package/dist/tui/generative/renderer.js.map

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

package/dist/tui/generative/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * A2UI-compatible component schema for the generative TUI.
+ * Agents emit JSON matching these types; the renderer converts them
+ * to Ink component trees at runtime.
+ */
+export type A2UIComponent = A2UIRow | A2UIColumn | A2UICard | A2UIText | A2UITextField | A2UIList | A2UITable | A2UIProgress | A2UISpacer;
+export interface A2UIRow {
+    type: 'row';
+    children: A2UIComponent[];
+    gap?: number;
+    padding?: number;
+}
+export interface A2UIColumn {
+    type: 'column';
+    children: A2UIComponent[];
+    gap?: number;
+    padding?: number;
+}
+export interface A2UICard {
+    type: 'card';
+    title?: string;
+    children: A2UIComponent[];
+    borderColor?: string;
+}
+export interface A2UIText {
+    type: 'text';
+    content: string;
+    bold?: boolean;
+    color?: string;
+    dimmed?: boolean;
+}
+export interface A2UITextField {
+    type: 'textfield';
+    placeholder?: string;
+    value?: string;
+    onSubmit?: string;
+}
+export interface A2UIList {
+    type: 'list';
+    items: string[] | string;
+    selected?: number;
+    onSelect?: string;
+}
+export interface A2UITable {
+    type: 'table';
+    headers: string[];
+    rows: string[][] | string;
+    onRowSelect?: string;
+}
+export interface A2UIProgress {
+    type: 'progress';
+    value: number;
+    label?: string;
+}
+export interface A2UISpacer {
+    type: 'spacer';
+    height?: number;
+}
+/** Data model that components bind to via JSON Pointers. */
+export interface A2UIDataModel {
+    [path: string]: unknown;
+}
+/** Streaming update message for modifying the data model. */
+export interface A2UIUpdate {
+    type: 'set' | 'merge' | 'delete';
+    path: string;
+    value?: unknown;
+}

package/dist/tui/generative/types.js

@@ -0,0 +1,7 @@
+/**
+ * A2UI-compatible component schema for the generative TUI.
+ * Agents emit JSON matching these types; the renderer converts them
+ * to Ink component trees at runtime.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tui/generative/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tui/generative/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tui/hooks/use-cancellable.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook for cancellable async operations with AbortController pattern.
+ *
+ * Provides:
+ *  - `signal` — pass to fetch / async operations
+ *  - `cancel()` — aborts the current controller
+ *  - `reset()` — creates a fresh AbortController
+ *  - `isCancelled` — true after cancel(), cleared on reset()
+ */
+export interface UseCancellableReturn {
+    signal: AbortSignal;
+    cancel: () => void;
+    reset: () => void;
+    isCancelled: boolean;
+}
+export declare function useCancellable(): UseCancellableReturn;
+/**
+ * Creates a Ctrl+C handler with the following behavior:
+ *  - During loading: first Ctrl+C cancels the operation
+ *  - When idle: first Ctrl+C records timestamp and returns "pending_exit",
+ *    second Ctrl+C within `windowMs` exits the process
+ *
+ * Returns "cancelled" | "exit" | "pending_exit".
+ */
+export interface CtrlCHandler {
+    handle: () => "cancelled" | "exit" | "pending_exit";
+}
+export declare function createCtrlCHandler(cancelFn: () => boolean, exitFn?: () => void, windowMs?: number): CtrlCHandler;

package/dist/tui/hooks/use-cancellable.js

@@ -0,0 +1,51 @@
+/**
+ * Hook for cancellable async operations with AbortController pattern.
+ *
+ * Provides:
+ *  - `signal` — pass to fetch / async operations
+ *  - `cancel()` — aborts the current controller
+ *  - `reset()` — creates a fresh AbortController
+ *  - `isCancelled` — true after cancel(), cleared on reset()
+ */
+import { useState, useRef, useCallback } from "react";
+export function useCancellable() {
+    const controllerRef = useRef(new AbortController());
+    const [isCancelled, setIsCancelled] = useState(false);
+    const cancel = useCallback(() => {
+        controllerRef.current.abort();
+        setIsCancelled(true);
+    }, []);
+    const reset = useCallback(() => {
+        controllerRef.current = new AbortController();
+        setIsCancelled(false);
+    }, []);
+    return {
+        signal: controllerRef.current.signal,
+        cancel,
+        reset,
+        isCancelled,
+    };
+}
+export function createCtrlCHandler(cancelFn, exitFn = () => process.exit(0), windowMs = 1000) {
+    let lastPressTime = 0;
+    return {
+        handle() {
+            const now = Date.now();
+            // Try to cancel a running operation first
+            const wasCancelled = cancelFn();
+            if (wasCancelled) {
+                lastPressTime = now;
+                return "cancelled";
+            }
+            // Nothing to cancel — double-press check
+            if (now - lastPressTime <= windowMs) {
+                exitFn();
+                return "exit";
+            }
+            // First idle press — record time, show hint
+            lastPressTime = now;
+            return "pending_exit";
+        },
+    };
+}
+//# sourceMappingURL=use-cancellable.js.map

package/dist/tui/hooks/use-cancellable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cancellable.js","sourceRoot":"","sources":["../../../src/tui/hooks/use-cancellable.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAWtD,MAAM,UAAU,cAAc;IAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9B,cAAc,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,aAAa,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;QACpC,MAAM;QACN,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,SAAqB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAC1C,WAAmB,IAAI;IAEvB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,OAAO;QACL,MAAM;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,0CAA0C;YAC1C,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC;YAChC,IAAI,YAAY,EAAE,CAAC;gBACjB,aAAa,GAAG,GAAG,CAAC;gBACpB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,yCAAyC;YACzC,IAAI,GAAG,GAAG,aAAa,IAAI,QAAQ,EAAE,CAAC;gBACpC,MAAM,EAAE,CAAC;gBACT,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,4CAA4C;YAC5C,aAAa,GAAG,GAAG,CAAC;YACpB,OAAO,cAAc,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tui/hooks/use-streaming.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Hook for simulated streaming text reveal.
+ *
+ * Reveals text word-by-word using setInterval, giving an
+ * animated "typing" appearance. When real SSE streaming is available,
+ * this can be replaced with actual token-level streaming.
+ *
+ * Features:
+ *  - Word-level chunking at configurable interval (default 30ms)
+ *  - `isStreaming` flag for trailing cursor display
+ *  - `stopStreaming()` immediately shows full text
+ */
+export interface UseStreamingReturn {
+    /** The currently visible portion of the text */
+    text: string;
+    /** Whether text is still being revealed */
+    isStreaming: boolean;
+    /**
+     * Start streaming a text string word-by-word.
+     * @param fullText The complete text to reveal
+     * @param chunkMs Interval between word reveals in ms (default 30)
+     */
+    startStreaming: (fullText: string, chunkMs?: number) => void;
+    /** Immediately show all remaining text and stop streaming */
+    stopStreaming: () => void;
+}
+/**
+ * Split text into word-level chunks, preserving whitespace.
+ * Each chunk is a word plus its trailing whitespace.
+ * E.g. "hello world" → ["hello ", "world"]
+ */
+export declare function splitIntoWordChunks(text: string): string[];
+export declare function useStreaming(): UseStreamingReturn;
+export interface StreamingOptions {
+    /** Interval between word reveals in ms. Default: 30 */
+    chunkMs?: number;
+}
+/**
+ * Async generator that yields progressively revealed text, word by word.
+ */
+export declare function streamText(fullText: string, options?: StreamingOptions, signal?: AbortSignal): AsyncGenerator<{
+    text: string;
+    isStreaming: boolean;
+}>;