aeon-ui-engine 1.0.2 → 1.1.0

package/packages/scene/node_modules/.bin/jiti

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+fi

package/packages/scene/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/scene/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/scene/node_modules/.bin/tsup

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsup/dist/cli-default.js" "$@"
+else
+  exec node  "$basedir/../tsup/dist/cli-default.js" "$@"
+fi

package/packages/scene/node_modules/.bin/tsup-node

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsup/dist/cli-node.js" "$@"
+else
+  exec node  "$basedir/../tsup/dist/cli-node.js" "$@"
+fi

package/packages/scene/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/cli.mjs" "$@"
+fi

package/packages/schemas/README.md

@@ -0,0 +1,52 @@
+# @aeon-ui/schemas
+
+Deterministic **JSON Schemas**, **statechart → LLM prompts**, and **agent event bridges** for Aeon UI.
+
+## Install
+
+```bash
+npm install @aeon-ui/schemas
+npx aeon-ui init
+```
+
+## Statechart-as-a-prompt
+
+```ts
+import { createActor } from 'xstate'
+import { asyncMachine } from '@aeon-ui/primitives'
+import { aeonToSchema, aeonToPrompt, aeonSnapshotSchema, createAgentEventBridge } from '@aeon-ui/schemas'
+
+const schema = aeonToSchema(asyncMachine)
+// hierarchical tree + events — feed to tools / zod enums
+
+const actor = createActor(asyncMachine)
+actor.start()
+const prompt = aeonToPrompt(asyncMachine, actor.getSnapshot())
+const live = aeonSnapshotSchema(asyncMachine, actor.getSnapshot())
+// live.validEvents → only what the agent may send *now*
+
+const bridge = createAgentEventBridge(actor, {
+  map: {
+    AGENT_STREAM_START: 'FETCH',
+    AGENT_STREAM_ERROR: (e) =>
+      e.type === 'AGENT_STREAM_ERROR' ? { type: 'REJECT', error: e.error } : null,
+  },
+})
+bridge.push({ type: 'AGENT_STREAM_START' })
+```
+
+## Registry
+
+Runtime fetch (also mirrored on the demo at `/registry/`):
+
+- `https://aeon-ui.com/registry/catalog.json`
+- `https://aeon-ui.com/registry/components/button.json`
+- `https://aeon-ui.com/registry/machines/async.json`
+
+## Cookbook
+
+[Vercel AI SDK + streamUI](../../docs/cookbook/vercel-ai-sdk.md)
+
+## Principle
+
+**UI = f(state)** — if it is not on the chart / in `validEvents`, do not send it.

package/packages/schemas/dist/index.d.ts

@@ -0,0 +1,287 @@
+import { AnyStateMachine, SnapshotFrom, AnyEventObject, AnyActorRef } from 'xstate';
+
+/** JSON Schema 2020-12 helpers for Aeon component contracts. */
+type JsonSchema = Record<string, unknown>;
+declare function componentSchema(opts: {
+    id: string;
+    title: string;
+    description: string;
+    scope: string;
+    parts: readonly string[];
+    states: readonly string[];
+    props?: Record<string, JsonSchema>;
+    slots?: Record<string, string>;
+    machine?: string | null;
+    runtime?: string;
+    events?: readonly string[];
+    examples?: readonly string[];
+}): JsonSchema;
+
+/** Deterministic component contracts for LLM / Generative UI consumption. */
+declare const componentSchemas: {
+    readonly button: JsonSchema;
+    readonly async: JsonSchema;
+    readonly field: JsonSchema;
+    readonly dialog: JsonSchema;
+    readonly switch: JsonSchema;
+    readonly checkbox: JsonSchema;
+    readonly tabs: JsonSchema;
+    readonly accordion: JsonSchema;
+    readonly popover: JsonSchema;
+    readonly menu: JsonSchema;
+    readonly select: JsonSchema;
+    readonly combobox: JsonSchema;
+    readonly tooltip: JsonSchema;
+    readonly toast: JsonSchema;
+    readonly scroll: JsonSchema;
+    readonly progress: JsonSchema;
+};
+type ComponentSchemaId = keyof typeof componentSchemas;
+declare const catalog: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://aeon-ui.com/schemas/catalog.json";
+    readonly title: "Aeon UI Component Catalog";
+    readonly description: "Machine-legible index of Aeon UI components. Prefer these schemas over inventing props, states, or boolean UI flags.";
+    readonly version: "0.1.0";
+    readonly principle: "UI = f(state)";
+    readonly attributes: readonly ["data-aeon-scope", "data-aeon-part", "data-aeon-state"];
+    readonly components: string[];
+    readonly schemas: {
+        readonly button: JsonSchema;
+        readonly async: JsonSchema;
+        readonly field: JsonSchema;
+        readonly dialog: JsonSchema;
+        readonly switch: JsonSchema;
+        readonly checkbox: JsonSchema;
+        readonly tabs: JsonSchema;
+        readonly accordion: JsonSchema;
+        readonly popover: JsonSchema;
+        readonly menu: JsonSchema;
+        readonly select: JsonSchema;
+        readonly combobox: JsonSchema;
+        readonly tooltip: JsonSchema;
+        readonly toast: JsonSchema;
+        readonly scroll: JsonSchema;
+        readonly progress: JsonSchema;
+    };
+};
+
+/**
+ * Statecharts packaged as system-prompt fragments for AI coding agents.
+ * Embed before code generation so agents cannot invent impossible UI states.
+ */
+declare const AEON_SYSTEM_PROMPT = "# Aeon UI \u2014 agent system prompt\n\nYou are building UI with **Aeon UI**, a React component library powered by finite statecharts.\n\n## Order of work (mandatory)\n1. **Build the state machines first** \u2014 name every lifecycle the UX needs (states + events). Prefer machines from `@aeon-ui/primitives` (or documented prop projections such as Button `status`).\n2. **Then project UI from those machines** \u2014 compound parts, copy, and layout exist only to reflect the chart. Never invent UI for states that are not in a machine.\n3. **UI = f(state)** \u2014 the DOM exposes `data-aeon-scope`, `data-aeon-part`, `data-aeon-state`. Style targets those attributes. Do not drive the same concern with parallel React `useState` flags.\n\n## Non-negotiable rules\n1. Do not duplicate open/checked/lifecycle in `useState` when a machine exists in `@aeon-ui/primitives`.\n2. **Button `status` is a prop** (`idle|pending|success|failure|disabled`). Optional: drive it from `buttonLifecycleMachine` via `useAeonMachine` in app code.\n3. **Select / Menu / Popover** share `popoverMachine` \u2014 never fork another open/closed chart.\n4. **Combobox** and **Tooltip** use React state today \u2014 do not add floating machines without the component checklist.\n5. **Scroll** uses `getScrollSnapshot()` \u2014 no XState machine.\n6. If a machine lists N stable states, the UI must represent all N (totality).\n7. Prefer `@aeon-ui/react` (headless) or `@aeon-ui/ui` (styled). Relative TS imports use `.js` extensions inside the Aeon monorepo only.\n8. Primitives stay **universal** \u2014 never invent niche components (dating, colour-blind test, pong). Compose from generic parts.\n\n## DOM contract\nEvery interactive surface sets anatomy via `partAttrs` from `@aeon-ui/core`:\n- `data-aeon-scope` \u2014 family (`button`, `async`, `field`, \u2026)\n- `data-aeon-part` \u2014 anatomy key (`root`, `trigger`, \u2026)\n- `data-aeon-state` \u2014 allowed snapshot / prop state only\n\n## Before writing JSX\n1. Enumerate machines (or documented status props) for the flow \u2014 states and events.\n2. Read the component JSON Schema from `@aeon-ui/schemas` (or pasted catalog) and match parts to those charts.\n3. Compose with documented compound parts (`Dialog.Root`, `Field.Control`, \u2026).\n4. Wire events to machine events or documented props \u2014 never invent `isLoading && !isError && hasData` spaghetti when a named state exists.\n";
+declare const STATECHART_PROMPTS: {
+    readonly async: "## Async region statechart\nStates: idle → loading → (success | empty | failure); REFRESH from success/empty/failure; STALE flag while success.\nEvents: FETCH, RESOLVE{data}, REJECT{error}, RESET, STALE, REFRESH.\nRule: Render track segments for idle, loading, success, empty, failure. Never hide empty/failure behind a generic spinner.";
+    readonly field: "## Field parallel statechart\nRegions:\n- interaction: pristine | dirty\n- validation: valid | invalid\n- submission: idle | pending\nEvents: INPUT, BLUR, VALIDATE{valid}, SUBMIT, SUBMIT_DONE, SUBMIT_FAIL, RESET.\nRule: Do not collapse validation + submission into one `error` boolean. Message UI follows validation region; pending follows submission.";
+    readonly button: "## Button lifecycle\nPreferred headless API: `status` prop ∈ idle | pending | success | failure | disabled.\nOptional machine: buttonLifecycleMachine with PRESS / RESOLVE / REJECT / RESET.\nRule: Pending must set aria-busy. Do not use disabled alone to mean \"saving\".";
+    readonly dialog: "## Dialog statechart\nStates: open | closed. Events: OPEN, CLOSE, TOGGLE.\nRule: Backdrop click and Escape are CLOSE transitions. Title/Description are required for a11y when open.";
+    readonly popoverFamily: "## Popover family (Popover, Menu, Select open state)\nMachine: popoverMachine — states open | closed.\nRule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine forks.";
+    readonly toggle: "## Switch / Checkbox\nMachine: toggleMachine — checked | unchecked. Events: TOGGLE, CHECK, UNCHECK.\nRule: Hidden input stays in sync with snapshot for forms.";
+};
+/** Checkout-form example used on the landing "AI playground" proof. */
+declare const GENERATIVE_UI_EXAMPLE: {
+    readonly prompt: "Create a multi-step checkout form with error handling.";
+    readonly schemaOutput: {
+        readonly component: "CheckoutFlow";
+        readonly steps: readonly [{
+            readonly id: "shipping";
+            readonly fields: readonly [{
+                readonly component: "Field";
+                readonly name: "email";
+                readonly states: readonly ["interaction", "validation", "submission"];
+            }, {
+                readonly component: "Field";
+                readonly name: "address";
+                readonly states: readonly ["interaction", "validation", "submission"];
+            }];
+        }, {
+            readonly id: "payment";
+            readonly fields: readonly [{
+                readonly component: "Field";
+                readonly name: "card";
+                readonly states: readonly ["interaction", "validation", "submission"];
+            }];
+        }];
+        readonly submit: {
+            readonly component: "Button";
+            readonly statusMachine: "buttonLifecycleMachine";
+            readonly allowedStatuses: readonly ["idle", "pending", "success", "failure"];
+        };
+        readonly asyncRegion: {
+            readonly component: "Async";
+            readonly allowedStates: readonly ["idle", "loading", "success", "empty", "failure"];
+            readonly onFailure: "show Field.message + Button status=failure";
+        };
+    };
+    readonly renderedHint: "Aeon maps each step to Field (parallel regions) + Button status + Async lifecycle — named states throughout.";
+};
+declare const CURSOR_RULES_SNIPPET: string;
+
+/** Hierarchical state-tree node for LLM / Generative UI consumption. */
+type AeonStateTreeNode = {
+    key: string;
+    id: string;
+    type: string;
+    events: string[];
+    transitions: Array<{
+        event: string;
+        target: string[];
+        guarded: boolean;
+    }>;
+    children: AeonStateTreeNode[];
+};
+/** Deterministic statechart JSON an agent can read at any micro-moment. */
+type AeonMachineSchema = {
+    id: string;
+    initial: string | undefined;
+    events: string[];
+    tree: AeonStateTreeNode;
+    /** Flat map: state id → events defined on that node */
+    states: Record<string, {
+        events: string[];
+        type: string;
+    }>;
+};
+type AeonSnapshotSchema = {
+    machineId: string;
+    value: unknown;
+    /** Event types valid from the active configuration (no getNextEvents in XState v5). */
+    validEvents: string[];
+    /** Transition rows including guard presence — agents should prefer unguarded or known payloads. */
+    nextTransitions: Array<{
+        event: string;
+        target: string[];
+        guarded: boolean;
+    }>;
+    activeStateIds: string[];
+};
+/**
+ * Stringify an XState machine into a clean hierarchical state-tree JSON.
+ * Use this as the runtime contract for agents that must know which events
+ * (TOGGLE, SUBMIT, FETCH, …) are legal before calling `send`.
+ * Internal timers (`xstate.after.*`) are omitted — agents send public events only.
+ */
+declare function aeonToSchema(machine: AnyStateMachine): AeonMachineSchema;
+/**
+ * Snapshot-aware companion to `aeonToSchema`.
+ * Call whenever the actor advances so the LLM only proposes legal next events.
+ */
+declare function aeonSnapshotSchema(machine: AnyStateMachine, snapshot: SnapshotFrom<AnyStateMachine>): AeonSnapshotSchema;
+/**
+ * Turn a machine (+ optional live snapshot) into a deterministic system-prompt fragment.
+ */
+declare function aeonToPrompt(machine: AnyStateMachine, snapshot?: SnapshotFrom<AnyStateMachine>): string;
+/**
+ * Convenience: start a throwaway actor at the initial state and return both
+ * static schema + snapshot schema for prompt injection.
+ */
+declare function aeonInitialAgentContext(machine: AnyStateMachine): {
+    schema: AeonMachineSchema;
+    snapshot: AeonSnapshotSchema;
+    prompt: string;
+};
+
+/** Streaming / tool-loop events from an LLM or automation. */
+type AgentStreamEvent = {
+    type: 'AGENT_STREAM_START';
+    taskId?: string;
+} | {
+    type: 'AGENT_STREAM_CHUNK';
+    taskId?: string;
+    data?: unknown;
+} | {
+    type: 'AGENT_STREAM_END';
+    taskId?: string;
+    data?: unknown;
+} | {
+    type: 'AGENT_STREAM_ERROR';
+    taskId?: string;
+    error: string;
+} | {
+    type: 'AGENT_TOOL_CALL';
+    name: string;
+    args?: unknown;
+} | {
+    type: 'AGENT_TOOL_RESULT';
+    name: string;
+    result?: unknown;
+} | {
+    type: string;
+    [key: string]: unknown;
+};
+type AgentEventMap = Record<string, string | ((event: AgentStreamEvent) => AnyEventObject | null)>;
+type AgentBridgeOptions = {
+    /**
+     * Map inbound agent event types → machine event types or transformers.
+     * Example: `{ AGENT_STREAM_START: 'FETCH', AGENT_STREAM_ERROR: (e) => ({ type: 'REJECT', error: e.error }) }`
+     */
+    map: AgentEventMap;
+    /** Optional filter — return false to drop the event. */
+    accept?: (event: AgentStreamEvent) => boolean;
+    /** Called when a mapped event is not allowed by `snapshot.can` (if actor exposes getSnapshot). */
+    onIllegal?: (event: AnyEventObject, reason: string) => void;
+};
+type Sendable = {
+    send: (event: AnyEventObject) => void;
+    getSnapshot?: () => {
+        can: (event: AnyEventObject) => boolean;
+    };
+};
+/**
+ * Bind streaming LLM / tool-loop events to an Aeon machine actor.
+ * Prevents agents from firing transitions the chart will reject.
+ */
+declare function createAgentEventBridge(actor: Sendable | AnyActorRef, options: AgentBridgeOptions): {
+    /** Push one agent/stream event through the map into `machine.send`. */
+    push: (incoming: AgentStreamEvent) => boolean;
+    /** Map of known agent → machine bindings (for prompts / docs). */
+    map: AgentEventMap;
+    /** Describe the bridge for system prompts. */
+    toPrompt(): string;
+};
+type AgentEventBridge = ReturnType<typeof createAgentEventBridge>;
+
+/**
+ * Aeon UI agent registry — machine-legible component contracts for Generative UI.
+ * Fetch at runtime: GET https://aeon-ui.com/registry/catalog.json
+ * Per component: GET https://aeon-ui.com/registry/components/{id}.json
+ * Machines: GET https://aeon-ui.com/registry/machines/{id}.json
+ */
+type RegistryEntry = {
+    id: string;
+    title: string;
+    scope: string;
+    schemaUrl: string;
+    machineUrl?: string;
+    runtime: string;
+    description: string;
+};
+declare const REGISTRY_BASE: "https://aeon-ui.com/registry";
+declare const registryCatalog: {
+    readonly $id: "https://aeon-ui.com/registry/catalog.json";
+    readonly version: "0.1.0";
+    readonly principle: "UI = f(state)";
+    readonly description: "Lightweight runtime registry — fetch Aeon component schemas and state-tree JSON on demand instead of bundling every primitive.";
+    readonly endpoints: {
+        readonly catalog: "https://aeon-ui.com/registry/catalog.json";
+        readonly component: "https://aeon-ui.com/registry/components/{id}.json";
+        readonly machine: "https://aeon-ui.com/registry/machines/{id}.json";
+    };
+    readonly components: {
+        id: string;
+        title: string;
+        scope: string;
+        schemaUrl: string;
+        machineUrl: string;
+        runtime: string;
+        description: string;
+    }[];
+    readonly client: {
+        readonly fetchCatalog: "fetch('https://aeon-ui.com/registry/catalog.json').then(r => r.json())";
+        readonly fetchComponent: "id => fetch(`https://aeon-ui.com/registry/components/${id}.json`).then(r => r.json())";
+        readonly fetchMachine: "id => fetch(`https://aeon-ui.com/registry/machines/${id}.json`).then(r => r.json())";
+    };
+};
+
+export { AEON_SYSTEM_PROMPT, type AeonMachineSchema, type AeonSnapshotSchema, type AeonStateTreeNode, type AgentBridgeOptions, type AgentEventBridge, type AgentEventMap, type AgentStreamEvent, CURSOR_RULES_SNIPPET, type ComponentSchemaId, GENERATIVE_UI_EXAMPLE, type JsonSchema, REGISTRY_BASE, type RegistryEntry, STATECHART_PROMPTS, aeonInitialAgentContext, aeonSnapshotSchema, aeonToPrompt, aeonToSchema, catalog, componentSchema, componentSchemas, createAgentEventBridge, registryCatalog };