@elizaos/ui 2.0.0-beta.2 → 2.0.3-beta.2

package/spatial/tui/framing.js

@@ -0,0 +1,189 @@
+/**
+ * Framing linter for terminal renders.
+ *
+ * The engine guarantees each line is exactly `width` visible columns, but that
+ * alone doesn't prove a render *looks* right: box borders must form closed,
+ * column-aligned rectangles; verticals (│ ║) must stack in the same columns;
+ * horizontal edges (─ ═) must run unbroken between corners; and content must
+ * never poke through a border. This module checks all of that on the rendered
+ * lines (after stripping ANSI) so tests and the review harness can assert a
+ * render is structurally sound — not just width-correct.
+ */
+import { visibleWidth } from "@elizaos/tui";
+const TL = new Set(["┌", "╭", "╔"]);
+const TR = new Set(["┐", "╮", "╗"]);
+const BL = new Set(["└", "╰", "╚"]);
+const BR = new Set(["┘", "╯", "╝"]);
+const HBORDER = new Set(["─", "═"]);
+const VBORDER = new Set(["│", "║"]);
+/** Strip ANSI SGR/OSC sequences, returning the visible glyph string. */
+export function stripAnsi(line) {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: strips ANSI ESC (\x1b) CSI sequences
+    const csiPattern = /\x1b\[[0-9;?]*[A-Za-z]/g;
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: strips ANSI OSC (\x1b ... \x07) sequences
+    const oscPattern = /\x1b\][^\x07]*\x07/g;
+    return line.replace(csiPattern, "").replace(oscPattern, "");
+}
+/**
+ * Convert a visible string into an array of single-column cells, where a
+ * double-width glyph occupies its cell followed by an empty continuation cell.
+ * This makes column indices line up with terminal columns.
+ */
+function toCells(visible) {
+    const cells = [];
+    const seg = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+    for (const { segment } of seg.segment(visible)) {
+        const w = visibleWidth(segment);
+        cells.push(segment);
+        for (let i = 1; i < w; i++)
+            cells.push("");
+    }
+    return cells;
+}
+/** Analyse a block of rendered lines for framing integrity. */
+export function analyzeFraming(lines) {
+    const issues = [];
+    const visibleLines = lines.map(stripAnsi);
+    const widths = visibleLines.map((l) => visibleWidth(l));
+    const width = widths.length ? Math.max(...widths) : 0;
+    const uniformWidth = widths.every((w) => w === width);
+    if (!uniformWidth) {
+        widths.forEach((w, row) => {
+            if (w !== width) {
+                issues.push({
+                    kind: "width-mismatch",
+                    row,
+                    detail: `line width ${w} != block width ${width}`,
+                });
+            }
+        });
+    }
+    // Build a column grid (rows × cols of single-column cells).
+    const grid = visibleLines.map(toCells);
+    const at = (r, c) => r >= 0 && r < grid.length && c >= 0 && c < grid[r].length ? grid[r][c] : "";
+    // Detect boxes by their top-left corners and validate the rectangle.
+    let boxes = 0;
+    const rects = [];
+    const counted = new Set();
+    for (let r = 0; r < grid.length; r++) {
+        for (let c = 0; c < grid[r].length; c++) {
+            if (!TL.has(at(r, c)))
+                continue;
+            // The top edge starts with a rule, may carry a title in the middle
+            // (`╭─ Title ───╮`), and ends with a rule before the top-right corner.
+            if (!HBORDER.has(at(r, c + 1)))
+                continue;
+            let rc = c + 2;
+            while (rc < grid[r].length && !TR.has(at(r, rc)))
+                rc++;
+            if (rc >= grid[r].length || !TR.has(at(r, rc)))
+                continue; // no top-right
+            if (!HBORDER.has(at(r, rc - 1)))
+                continue; // top edge must end with a rule
+            // Find the bottom edge: scan down the left column for a BL corner.
+            let br = r + 1;
+            while (br < grid.length && VBORDER.has(at(br, c)))
+                br++;
+            if (!BL.has(at(br, c))) {
+                issues.push({
+                    kind: "unclosed-box",
+                    row: r,
+                    col: c,
+                    detail: `top-left at (${r},${c}) has no closing bottom-left in column ${c}`,
+                });
+                continue;
+            }
+            const key = `${r},${c},${br},${rc}`;
+            if (counted.has(key))
+                continue;
+            counted.add(key);
+            // Validate bottom-right corner + bottom edge run.
+            if (!BR.has(at(br, rc))) {
+                issues.push({
+                    kind: "broken-bottom-edge",
+                    row: br,
+                    col: rc,
+                    detail: `bottom-right corner missing at (${br},${rc})`,
+                });
+            }
+            for (let cc = c + 1; cc < rc; cc++) {
+                if (!HBORDER.has(at(br, cc))) {
+                    issues.push({
+                        kind: "broken-bottom-edge",
+                        row: br,
+                        col: cc,
+                        detail: `bottom edge broken at (${br},${cc}): "${at(br, cc) || " "}"`,
+                    });
+                    break;
+                }
+            }
+            // Validate the two vertical edges align in their columns for every inner row.
+            for (let rr = r + 1; rr < br; rr++) {
+                if (!VBORDER.has(at(rr, c))) {
+                    issues.push({
+                        kind: "misaligned-vertical",
+                        row: rr,
+                        col: c,
+                        detail: `left border missing at (${rr},${c}): "${at(rr, c) || " "}"`,
+                    });
+                }
+                if (!VBORDER.has(at(rr, rc))) {
+                    issues.push({
+                        kind: "misaligned-vertical",
+                        row: rr,
+                        col: rc,
+                        detail: `right border missing at (${rr},${rc}): "${at(rr, rc) || " "}"`,
+                    });
+                }
+                // Note: a separate "content past the right border" scan is intentionally
+                // omitted — sibling boxes legitimately occupy columns to the right, and a
+                // real overflow already shows up as a missing right border (above) or a
+                // width mismatch. Checking raw columns would false-positive on siblings.
+            }
+            boxes++;
+            rects.push({ r, c, br, rc });
+        }
+    }
+    // Detect truncated buttons: a button renders as `[ label ]`; when a row is
+    // over budget it gets shrunk and the closing ` ]` is cut, leaving `[ label`.
+    // An unbalanced count of `[ ` openers vs ` ]` closers on a line flags it.
+    visibleLines.forEach((line, row) => {
+        const opens = (line.match(/\[ /g) ?? []).length;
+        const closes = (line.match(/ \]/g) ?? []).length;
+        if (opens > closes) {
+            issues.push({
+                kind: "truncated-affordance",
+                row,
+                detail: `line has ${opens} "[ " openers but ${closes} " ]" closers — a button is cut off`,
+            });
+        }
+    });
+    // Minimise framing: flag any box fully contained inside another (nesting).
+    // A single outer frame per view is the house style; sections use dividers.
+    for (const inner of rects) {
+        const parent = rects.find((o) => o !== inner &&
+            o.r < inner.r &&
+            o.c < inner.c &&
+            o.br > inner.br &&
+            o.rc > inner.rc);
+        if (parent) {
+            issues.push({
+                kind: "nested-box",
+                row: inner.r,
+                col: inner.c,
+                detail: `box (${inner.r},${inner.c})-(${inner.br},${inner.rc}) is nested inside (${parent.r},${parent.c})-(${parent.br},${parent.rc}); use a divider instead`,
+            });
+        }
+    }
+    return { width, height: lines.length, uniformWidth, boxes, issues };
+}
+/** A one-line column ruler for eyeballing alignment in a text export. */
+export function columnRuler(width) {
+    let tens = "";
+    let ones = "";
+    for (let i = 0; i < width; i++) {
+        ones += String(i % 10);
+        tens += i % 10 === 0 ? String(Math.floor(i / 10) % 10) : " ";
+    }
+    return `${tens}\n${ones}`;
+}

package/spatial/tui/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@elizaos/ui/spatial/tui` — the terminal renderer for unified spatial views.
+ *
+ * Node-only (depends on `@elizaos/tui`). Import this from a terminal host (the
+ * agent CLI), never from browser code — the browser uses `@elizaos/ui/spatial`.
+ */
+export { getTerminalView, hasTerminalView, listTerminalViewIds, registerTerminalView, } from "@elizaos/tui";
+export { measureWidth, render as renderSpatialNode } from "./engine.ts";
+export { createSpatialTuiComponent, registerSpatialTerminalView, renderSpatialToLines, renderViewToLines, type SpatialTuiComponentOptions, } from "./renderer.ts";
+//# sourceMappingURL=index.d.ts.map

package/spatial/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/spatial/tui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC"}

package/spatial/tui/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@elizaos/ui/spatial/tui` — the terminal renderer for unified spatial views.
+ *
+ * Node-only (depends on `@elizaos/tui`). Import this from a terminal host (the
+ * agent CLI), never from browser code — the browser uses `@elizaos/ui/spatial`.
+ */
+// Re-export the terminal-view registry so plugins/hosts use one import surface.
+export { getTerminalView, hasTerminalView, listTerminalViewIds, registerTerminalView, } from "@elizaos/tui";
+export { measureWidth, render as renderSpatialNode } from "./engine.js";
+export { createSpatialTuiComponent, registerSpatialTerminalView, renderSpatialToLines, renderViewToLines, } from "./renderer.js";

package/spatial/tui/renderer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * TUI renderer entry points.
+ *
+ * These take the SAME authored React view that GUI/XR render and produce
+ * terminal lines, by evaluating it to the IR (`evaluate.ts`) and laying it out
+ * (`engine.ts`). `createSpatialTuiComponent` adapts a view to the `@elizaos/tui`
+ * `Component` interface so a unified view drops straight into the agent terminal
+ * alongside the existing imperative TUI components.
+ *
+ * This module is Node-only (it pulls in `@elizaos/tui`); it is exposed under the
+ * `@elizaos/ui/spatial/tui` subpath and is never imported by the browser barrel.
+ */
+import { type Component } from "@elizaos/tui";
+import type { ReactNode } from "react";
+import { type EvaluateOptions, type SpatialStateStore } from "../evaluate.ts";
+import type { SpatialNode } from "../ir.ts";
+/** Lay out an already-evaluated IR node to terminal lines. */
+export declare function renderSpatialToLines(node: SpatialNode, width: number): string[];
+/** Evaluate an authored view to IR and lay it out to terminal lines (one frame). */
+export declare function renderViewToLines(view: ReactNode, width: number, options?: EvaluateOptions): string[];
+export interface SpatialTuiComponentOptions {
+    /** Called when a `useSpatialState` setter fires so the host can re-render. */
+    onChange?: () => void;
+    /** Reuse an external store (else one is created and owned by the component). */
+    store?: SpatialStateStore;
+    /** Fired with the agent id when a focused control is activated (Enter). */
+    onActivate?: (agentId: string) => void;
+}
+/**
+ * Adapt a spatial view to the `@elizaos/tui` `Component` interface.
+ *
+ * `view` is a thunk so state changes (via `useSpatialState`) re-evaluate the
+ * latest tree. Lines are cached per width until `invalidate()` or a state change.
+ *
+ * ```ts
+ * const profile = createSpatialTuiComponent(() => <ProfileView profile={p} />, {
+ *   onChange: () => tui.requestRender(),
+ * });
+ * tui.addChild(profile);
+ * ```
+ */
+export declare function createSpatialTuiComponent(view: () => ReactNode, options?: SpatialTuiComponentOptions): Component;
+/**
+ * Author a terminal-rendered view once and register it so a terminal host (the
+ * agent terminal) can mount it by id. This is the single call a plugin makes to
+ * make a `viewType: "tui"` view render for real in the terminal:
+ *
+ * ```ts
+ * registerSpatialTerminalView("phone", () => <PhoneSpatialView snapshot={get()} />);
+ * ```
+ *
+ * Returns an unregister function.
+ */
+export declare function registerSpatialTerminalView(id: string, view: () => ReactNode, options?: SpatialTuiComponentOptions): () => void;
+//# sourceMappingURL=renderer.d.ts.map

package/spatial/tui/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../../src/spatial/tui/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAwB,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAEV;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,EAAE,CAEV;AAED,MAAM,WAAW,0BAA0B;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gFAAgF;IAChF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,SAAS,EACrB,OAAO,GAAE,0BAA+B,GACvC,SAAS,CAiEX;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,SAAS,EACrB,OAAO,GAAE,0BAA+B,GACvC,MAAM,IAAI,CAEZ"}

package/spatial/tui/renderer.js

@@ -0,0 +1,116 @@
+/**
+ * TUI renderer entry points.
+ *
+ * These take the SAME authored React view that GUI/XR render and produce
+ * terminal lines, by evaluating it to the IR (`evaluate.ts`) and laying it out
+ * (`engine.ts`). `createSpatialTuiComponent` adapts a view to the `@elizaos/tui`
+ * `Component` interface so a unified view drops straight into the agent terminal
+ * alongside the existing imperative TUI components.
+ *
+ * This module is Node-only (it pulls in `@elizaos/tui`); it is exposed under the
+ * `@elizaos/ui/spatial/tui` subpath and is never imported by the browser barrel.
+ */
+import { registerTerminalView } from "@elizaos/tui";
+import { createSpatialStateStore, evaluateToSpatialTree, } from "../evaluate.js";
+import { render as renderEngine, setFocusedAgentId } from "./engine.js";
+/** Lay out an already-evaluated IR node to terminal lines. */
+export function renderSpatialToLines(node, width) {
+    return renderEngine(node, width);
+}
+/** Evaluate an authored view to IR and lay it out to terminal lines (one frame). */
+export function renderViewToLines(view, width, options) {
+    return renderEngine(evaluateToSpatialTree(view, options), width);
+}
+/**
+ * Adapt a spatial view to the `@elizaos/tui` `Component` interface.
+ *
+ * `view` is a thunk so state changes (via `useSpatialState`) re-evaluate the
+ * latest tree. Lines are cached per width until `invalidate()` or a state change.
+ *
+ * ```ts
+ * const profile = createSpatialTuiComponent(() => <ProfileView profile={p} />, {
+ *   onChange: () => tui.requestRender(),
+ * });
+ * tui.addChild(profile);
+ * ```
+ */
+export function createSpatialTuiComponent(view, options = {}) {
+    const store = options.store ?? createSpatialStateStore();
+    let cache = null;
+    // Keyboard focus: ids of activatable buttons (in document order) + handlers.
+    let focusable = [];
+    let handlers = new Map();
+    let focusedId = null;
+    const invalidate = () => {
+        cache = null;
+    };
+    const requestRender = () => {
+        invalidate();
+        options.onChange?.();
+    };
+    function evaluate() {
+        handlers = new Map();
+        const tree = evaluateToSpatialTree(view(), {
+            store,
+            requestRender,
+            handlers,
+        });
+        focusable = [...handlers.keys()];
+        // Keep focus on the same control across re-renders; default to the first.
+        if (focusedId === null || !focusable.includes(focusedId)) {
+            focusedId = focusable[0] ?? null;
+        }
+        return tree;
+    }
+    function move(delta) {
+        if (focusable.length === 0)
+            return;
+        const i = focusedId ? focusable.indexOf(focusedId) : -1;
+        const next = (i + delta + focusable.length) % focusable.length;
+        focusedId = focusable[next];
+        requestRender();
+    }
+    return {
+        render(width) {
+            if (cache && cache.width === width)
+                return cache.lines;
+            const tree = evaluate();
+            setFocusedAgentId(focusedId);
+            const lines = renderEngine(tree, width);
+            setFocusedAgentId(null);
+            cache = { width, lines };
+            return lines;
+        },
+        handleInput(data) {
+            if (focusable.length === 0 && handlers.size === 0)
+                evaluate();
+            // Tab / arrows move focus; Enter / Space activate the focused control.
+            if (data === "\t" || data === "\x1b[B" || data === "\x0e")
+                move(1);
+            else if (data === "\x1b[Z" || data === "\x1b[A" || data === "\x10")
+                move(-1);
+            else if (data === "\r" || data === "\n" || data === " ") {
+                if (focusedId) {
+                    handlers.get(focusedId)?.();
+                    options.onActivate?.(focusedId);
+                    requestRender();
+                }
+            }
+        },
+        invalidate,
+    };
+}
+/**
+ * Author a terminal-rendered view once and register it so a terminal host (the
+ * agent terminal) can mount it by id. This is the single call a plugin makes to
+ * make a `viewType: "tui"` view render for real in the terminal:
+ *
+ * ```ts
+ * registerSpatialTerminalView("phone", () => <PhoneSpatialView snapshot={get()} />);
+ * ```
+ *
+ * Returns an unregister function.
+ */
+export function registerSpatialTerminalView(id, view, options = {}) {
+    return registerTerminalView(id, createSpatialTuiComponent(view, options));
+}

package/state/AppContext.d.ts

@@ -4,8 +4,6 @@
  * Children access state and actions through the useApp() hook.
  */
 import { type ReactNode } from "react";
-export { type ActionNotice, AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, type AppActions, AppContext, type AppContextValue, type AppState, applyUiTheme, asApiLikeError, type ChatTurnUsage, type CompanionHalfFramerateMode, type CompanionVrmPowerMode, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, type GamePostMessageAuthPayload, getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmCount, getVrmPreviewUrl, getVrmTitle, getVrmUrl, LIFECYCLE_MESSAGES, type LifecycleAction, type LoadConversationMessagesResult, loadAvatarIndex, loadChatAvatarVisible, loadChatMode, loadChatVoiceMuted, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionVrmPowerMode, loadUiLanguage, loadUiShellMode, loadUiTheme, mergeStreamingText, type NavigationEventsApi, normalizeAvatarIndex, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeCustomActionName, normalizeStreamComparisonText, normalizeUiShellMode, normalizeUiTheme, ONBOARDING_PERMISSION_LABELS, type OnboardingNextOptions, type OnboardingStep, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseAgentStatusFromMainMenuResetPayload, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, type ShellView, type SlashCommandInput, type StartupErrorReason, type StartupErrorState, type StartupPhase, saveAvatarIndex, saveChatAvatarVisible, saveChatMode, saveChatVoiceMuted, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionVrmPowerMode, saveUiLanguage, saveUiShellMode, saveUiTheme, shouldApplyFinalStreamText, type TabCommittedDetail, type TranslationContextValue, type UiShellMode, type UiTheme, useApp, VRM_COUNT, } from "./internal";
-export { AGENT_READY_TIMEOUT_MS } from "./types";
 export declare function AppProvider({ children, branding: brandingOverride, }: {
     children: ReactNode;
     branding?: Partial<import("../config/branding").BrandingConfig>;

package/state/AppContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppContext.d.ts","sourceRoot":"","sources":["../../../../../src/state/AppContext.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAwDf,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,kCAAkC,EAClC,KAAK,UAAU,EACf,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,YAAY,EACZ,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,8BAA8B,EACnC,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,8BAA8B,EAC9B,8BAA8B,EAC9B,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,mCAAmC,EACnC,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,wCAAwC,EACxC,6BAA6B,EAC7B,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,8BAA8B,EAC9B,8BAA8B,EAC9B,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,WAAW,EACX,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,MAAM,EACN,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAejD,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EAAE,gBAAgB,GAC3B,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,oBAAoB,EAAE,cAAc,CAAC,CAAC;CACjE,2CAgBA"}
+{"version":3,"file":"AppContext.d.ts","sourceRoot":"","sources":["../../../../../src/state/AppContext.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAsFf,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EAAE,gBAAgB,GAC3B,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,oBAAoB,EAAE,cAAc,CAAC,CAAC;CACjE,2CAcA"}

package/state/AppContext.hooks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Non-component values split out of AppContext.tsx so the Provider component
+ * file is not the home for runtime constants. Imported back into AppContext.tsx
+ * for use inside AppProvider.
+ */
+/**
+ * DOM event dispatched after a WebSocket reconnect so conversation views can
+ * refetch their recent messages and repair state that drifted during the gap.
+ * `detail.conversationId` is the active conversation at reconnect time (or null).
+ */
+export declare const RESYNC_EVENT = "elizaos:needs-resync";
+export interface ResyncEventDetail {
+    conversationId: string | null;
+}
+//# sourceMappingURL=AppContext.hooks.d.ts.map

package/state/AppContext.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppContext.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/state/AppContext.hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/state/AppContext.hooks.js

@@ -0,0 +1,11 @@
+/**
+ * Non-component values split out of AppContext.tsx so the Provider component
+ * file is not the home for runtime constants. Imported back into AppContext.tsx
+ * for use inside AppProvider.
+ */
+/**
+ * DOM event dispatched after a WebSocket reconnect so conversation views can
+ * refetch their recent messages and repair state that drifted during the gap.
+ * `detail.conversationId` is the active conversation at reconnect time (or null).
+ */
+export const RESYNC_EVENT = "elizaos:needs-resync";