@adonis-agora/agent 0.60.1 → 0.62.0

package/dist/src/engine.d.ts

@@ -0,0 +1,77 @@
+import type { AgentDepsFactory } from './agent-deps-factory.js';
+import type { ChatQueueService } from './chat-queue-service.js';
+import type { AgentRunner } from './spi/agent-runner.js';
+import type { AgentStore } from './spi/agent-store.js';
+import type { ModelProvider } from './spi/model-provider.js';
+import type { ProtocolAdapter } from './spi/protocol-adapter.js';
+import type { TokenStreamSink } from './spi/token-stream-sink.js';
+import type { ToolRegistry } from './tool-registry.js';
+/**
+ * What the provider hands an engine when it builds the runner: the same graph the library's own
+ * runners are built from. Everything around a turn stays the library's — the routes and the stream
+ * protocol, threads and the store, the sink, approvals and answers routed through `AgentService`, the
+ * queue — and the engine reads the agent's prompt, approval policy, skills and memory off `factory`.
+ */
+export interface AgentEngineContext {
+    factory: AgentDepsFactory;
+    store: AgentStore;
+    sink: TokenStreamSink;
+    registry: ToolRegistry;
+    /** The thread message queue: a settling turn hands its thread to the next queued message. */
+    queue: ChatQueueService;
+    /**
+     * Resolve a container binding (e.g. `@adonis-agora/durable`'s `WorkflowEngine`). Absent when the
+     * engine is wired outside an AdonisJS app (a test building the graph by hand).
+     */
+    make?: <T = unknown>(binding: unknown) => Promise<T>;
+    /** The app's `APP_KEY`, when there is one — a stable secret for whatever the engine signs. */
+    appKey?: string;
+}
+/**
+ * Something other than this library's loop that runs a turn — what `engine` in `config/agent.ts`
+ * takes. An engine owns the turn end to end (the model calls, the tools, the context it keeps) and
+ * builds the {@link AgentRunner} the service runs turns on; everything around the turn stays the
+ * library's.
+ *
+ * `openCode()` (`@adonis-agora/agent/opencode`) is the one that ships. An engine replaces the loop,
+ * so the options only the loop reads (`model`, processors, `maxSteps`, `historyWindow`, `retriever`,
+ * delegation) do nothing under one, and `model` becomes optional.
+ */
+export interface AgentEngine {
+    /** For logs and diagnostics. */
+    readonly name: string;
+    /**
+     * The engine checkpoints its own turns (`openCodeDurable()`). `durable: true` in the config names the
+     * LOOP's durable runner, which an engine replaces — so it is refused next to an engine that is not
+     * durable itself, rather than silently ignored.
+     */
+    readonly durable?: boolean;
+    /** Build the runner the service starts, signals and cancels turns on. Called once, at boot. */
+    createRunner(context: AgentEngineContext): AgentRunner | Promise<AgentRunner>;
+    /**
+     * Routes the engine serves next to the agent's own (e.g. the MCP endpoint OpenCode reaches the
+     * app's tools through), mounted like `adapters` once {@link createRunner} has run.
+     */
+    adapters?(): readonly ProtocolAdapter[];
+    /** Release what the engine holds (event streams, timers) when the app shuts down. */
+    shutdown?(): void | Promise<void>;
+}
+/** `engine` in `config/agent.ts`: an engine, or a lazy factory so its module loads with the config. */
+export type AgentEngineFactory = () => AgentEngine | Promise<AgentEngine>;
+/**
+ * Refuse a wiring that cannot run a turn, at boot rather than on the first message: no `model` and
+ * no `engine` leaves the loop nothing to call, and `durable: true` names the loop's own durable
+ * runner, which a non-durable engine replaces (a durable engine brings its own durability).
+ */
+export declare function assertRunnable(options: {
+    model?: unknown;
+    engine?: AgentEngine | undefined;
+    durable?: boolean | undefined;
+}): void;
+/**
+ * The model the loop is handed when an engine runs the turns and no `model` is configured: nothing
+ * of the library's calls it on that path, and a caller that does (a background summarizer reading
+ * `deps.model`) is told why instead of crashing on `undefined`.
+ */
+export declare function engineOnlyModel(engine: AgentEngine): ModelProvider;
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,6FAA6F;IAC7F,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrD,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,+FAA+F;IAC/F,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E;;;OAGG;IACH,QAAQ,CAAC,IAAI,SAAS,eAAe,EAAE,CAAC;IACxC,qFAAqF;IACrF,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,uGAAuG;AACvG,MAAM,MAAM,kBAAkB,GAAG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,GAAG,IAAI,CAYP;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAQlE"}

package/dist/src/engine.js

@@ -0,0 +1,27 @@
+/**
+ * Refuse a wiring that cannot run a turn, at boot rather than on the first message: no `model` and
+ * no `engine` leaves the loop nothing to call, and `durable: true` names the loop's own durable
+ * runner, which a non-durable engine replaces (a durable engine brings its own durability).
+ */
+export function assertRunnable(options) {
+    const { engine } = options;
+    if (engine !== undefined && options.durable === true && engine.durable !== true) {
+        throw new Error(`[@adonis-agora/agent] \`durable: true\` runs turns on the library's loop, but the \`${engine.name}\` engine runs them instead. Drop \`durable\`, or use the engine's durable variant.`);
+    }
+    if (engine === undefined && options.model === undefined) {
+        throw new Error('[@adonis-agora/agent] set `model` in config/agent.ts (the loop runs the turns) or `engine` (something else does).');
+    }
+}
+/**
+ * The model the loop is handed when an engine runs the turns and no `model` is configured: nothing
+ * of the library's calls it on that path, and a caller that does (a background summarizer reading
+ * `deps.model`) is told why instead of crashing on `undefined`.
+ */
+export function engineOnlyModel(engine) {
+    return {
+        async runTurn() {
+            throw new Error(`[@adonis-agora/agent] the \`${engine.name}\` engine runs this deployment's turns and no \`model\` is configured; set \`model\` for anything that calls the loop's model directly.`);
+        },
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/engine.ts"],"names":[],"mappings":"AAgEA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAI9B;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CACb,uFAAuF,MAAM,CAAC,IAAI,qFAAqF,CACxL,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO;QACL,KAAK,CAAC,OAAO;YACX,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,IAAI,yIAAyI,CACpL,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/genui/builtins.d.ts

@@ -1,6 +1,76 @@
 /**
- * `@adonis-agora/agent/genui/builtins` — the builtin component definitions (`DataTable`, `Chart`,
- * `KpiCards`, …) of `@dudousxd/nestjs-agent-core/genui/builtins`, re-exported unchanged.
+ * Optional builtin component DEFINITIONS — names, props schemas, model descriptions and plain-text
+ * fallbacks for the components most chat apps want. No visuals: an app renders each with its own
+ * look, keyed by name. Use them as-is, pick some, or extend them:
+ *
+ * ```ts
+ * const catalog = defineCatalog([...BUILTIN_COMPONENTS, ...LAYOUT_COMPONENTS, myDealCard]);
+ * ```
  */
-export * from '@dudousxd/nestjs-agent-core/genui/builtins';
+import { type ComponentDefinition } from './catalog.js';
+import type { ChartProps, TableProps } from './registry.js';
+type Props = Record<string, unknown>;
+/** A fixed-width text table in a code block, at most `max` rows. */
+export declare function textTable(columns: readonly {
+    key: string;
+    label: string;
+}[], rows: readonly Props[], max?: number): string;
+export interface DiffLine {
+    op: 'same' | 'add' | 'del';
+    text: string;
+}
+/** Line diff (LCS) — good enough for snippets up to a few hundred lines. */
+export declare function lineDiff(before: string, after: string): DiffLine[];
+export declare const DataTable: ComponentDefinition<TableProps>;
+export declare const Chart: ComponentDefinition<ChartProps>;
+export declare const KpiCards: ComponentDefinition<{
+    title?: string;
+    items: {
+        label: string;
+        value: string | number;
+        delta?: string;
+        trend?: 'up' | 'down' | 'flat';
+        hint?: string;
+    }[];
+}>;
+export declare const SourceCards: ComponentDefinition<{
+    title?: string;
+    items: {
+        title: string;
+        url?: string;
+        snippet?: string;
+        source?: string;
+    }[];
+}>;
+export declare const Checklist: ComponentDefinition<{
+    title?: string;
+    items: {
+        label: string;
+        done?: boolean;
+        note?: string;
+    }[];
+}>;
+export declare const Timeline: ComponentDefinition<{
+    title?: string;
+    events: {
+        date?: string;
+        title: string;
+        description?: string;
+    }[];
+}>;
+export declare const CodeBlock: ComponentDefinition<Props>;
+export declare const Diff: ComponentDefinition<Props>;
+export declare const Callout: ComponentDefinition<Props>;
+export declare const Stack: ComponentDefinition<Props>;
+export declare const Card: ComponentDefinition<Props>;
+export declare const Heading: ComponentDefinition<Props>;
+export declare const Text: ComponentDefinition<Props>;
+export declare const Badge: ComponentDefinition<Props>;
+export declare const Link: ComponentDefinition<Props>;
+export declare const Image: ComponentDefinition<Props>;
+/** Content components: data a model shows. */
+export declare const BUILTIN_COMPONENTS: readonly ComponentDefinition<unknown>[];
+/** Layout and text primitives, mostly for composing trees (`Stack`, `Card` take children). */
+export declare const LAYOUT_COMPONENTS: readonly ComponentDefinition<unknown>[];
+export {};
 //# sourceMappingURL=builtins.d.ts.map

package/dist/src/genui/builtins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/genui/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4CAA4C,CAAC"}
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/genui/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,mBAAmB,EAAmB,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG5D,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyBrC,oEAAoE;AACpE,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAClD,IAAI,EAAE,SAAS,KAAK,EAAE,EACtB,GAAG,SAAK,GACP,MAAM,CAgBR;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAoClE;AAOD,eAAO,MAAM,SAAS,iCA2BpB,CAAC;AAEH,eAAO,MAAM,KAAK,iCAiChB,CAAC;AAEH,eAAO,MAAM,QAAQ;YACX,MAAM;WACP;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EAAE;EA+BH,CAAC;AAEH,eAAO,MAAM,WAAW;YACd,MAAM;WACP;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;EAwB3E,CAAC;AAEH,eAAO,MAAM,SAAS;YACZ,MAAM;WACP;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;EAsBzD,CAAC;AAEH,eAAO,MAAM,QAAQ;YACX,MAAM;YACN;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;EAsBhE,CAAC;AAEH,eAAO,MAAM,SAAS,4BAMpB,CAAC;AAEH,eAAO,MAAM,IAAI,4BASf,CAAC;AAEH,eAAO,MAAM,OAAO,4BAclB,CAAC;AAEH,eAAO,MAAM,KAAK,4BAOhB,CAAC;AAEH,eAAO,MAAM,IAAI,4BAQf,CAAC;AAEH,eAAO,MAAM,OAAO,4BAMlB,CAAC;AAEH,eAAO,MAAM,IAAI,4BAMf,CAAC;AAEH,eAAO,MAAM,KAAK,4BAYhB,CAAC;AAEH,eAAO,MAAM,IAAI,4BAMf,CAAC;AAEH,eAAO,MAAM,KAAK,4BAMhB,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,EAAE,SAAS,mBAAmB,CAAC,OAAO,CAAC,EAUrE,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,EAAE,SAAS,mBAAmB,CAAC,OAAO,CAAC,EAQpE,CAAC"}

package/dist/src/genui/builtins.js

@@ -1,6 +1,301 @@
 /**
- * `@adonis-agora/agent/genui/builtins` — the builtin component definitions (`DataTable`, `Chart`,
- * `KpiCards`, …) of `@dudousxd/nestjs-agent-core/genui/builtins`, re-exported unchanged.
+ * Optional builtin component DEFINITIONS — names, props schemas, model descriptions and plain-text
+ * fallbacks for the components most chat apps want. No visuals: an app renders each with its own
+ * look, keyed by name. Use them as-is, pick some, or extend them:
+ *
+ * ```ts
+ * const catalog = defineCatalog([...BUILTIN_COMPONENTS, ...LAYOUT_COMPONENTS, myDealCard]);
+ * ```
  */
-export * from '@dudousxd/nestjs-agent-core/genui/builtins';
+import { defineComponent } from './catalog.js';
+const str = (description, extra = {}) => ({
+    type: 'string',
+    ...(description !== undefined ? { description } : {}),
+    ...extra,
+});
+const obj = (properties, required = []) => ({
+    type: 'object',
+    properties,
+    required,
+    additionalProperties: false,
+});
+const arr = (items, extra = {}) => ({
+    type: 'array',
+    items,
+    ...extra,
+});
+const cell = { type: ['string', 'number', 'boolean', 'null'] };
+const row = { type: 'object', additionalProperties: cell };
+const s = (value) => (value === null || value === undefined ? '' : String(value));
+const heading = (props) => props.title ? `*${s(props.title)}*\n` : '';
+/** A fixed-width text table in a code block, at most `max` rows. */
+export function textTable(columns, rows, max = 15) {
+    const shown = rows.slice(0, max);
+    const widths = columns.map((column) => Math.min(28, Math.max(column.label.length, ...shown.map((r) => s(r[column.key]).length))));
+    const format = (values) => values
+        .map((value, index) => value.slice(0, widths[index]).padEnd(widths[index] ?? 0))
+        .join('  ');
+    const lines = [
+        format(columns.map((column) => column.label)),
+        widths.map((width) => '-'.repeat(width)).join('  '),
+        ...shown.map((r) => format(columns.map((column) => s(r[column.key])))),
+    ];
+    if (rows.length > max)
+        lines.push(`… ${rows.length - max} more rows`);
+    return `\`\`\`\n${lines.join('\n')}\n\`\`\``;
+}
+/** Line diff (LCS) — good enough for snippets up to a few hundred lines. */
+export function lineDiff(before, after) {
+    const a = before.split('\n');
+    const b = after.split('\n');
+    if (a.length * b.length > 250_000) {
+        return [
+            ...a.map((text) => ({ op: 'del', text })),
+            ...b.map((text) => ({ op: 'add', text })),
+        ];
+    }
+    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    const at = (i, j) => dp[i]?.[j] ?? 0;
+    for (let i = a.length - 1; i >= 0; i--) {
+        for (let j = b.length - 1; j >= 0; j--) {
+            dp[i][j] =
+                a[i] === b[j] ? at(i + 1, j + 1) + 1 : Math.max(at(i + 1, j), at(i, j + 1));
+        }
+    }
+    const out = [];
+    let i = 0;
+    let j = 0;
+    while (i < a.length && j < b.length) {
+        if (a[i] === b[j]) {
+            out.push({ op: 'same', text: a[i] });
+            i++;
+            j++;
+        }
+        else if (at(i + 1, j) >= at(i, j + 1)) {
+            out.push({ op: 'del', text: a[i++] });
+        }
+        else {
+            out.push({ op: 'add', text: b[j++] });
+        }
+    }
+    while (i < a.length)
+        out.push({ op: 'del', text: a[i++] });
+    while (j < b.length)
+        out.push({ op: 'add', text: b[j++] });
+    return out;
+}
+function bar(value, max, width = 20) {
+    const n = max > 0 ? Math.round((Math.abs(value) / max) * width) : 0;
+    return '█'.repeat(n) || '▏';
+}
+export const DataTable = defineComponent({
+    name: 'DataTable',
+    title: 'Data table',
+    description: 'Tabular data (records with the same fields) as a sortable table. Prefer it over markdown tables for more than 3 rows.',
+    props: obj({
+        title: str('Short caption'),
+        columns: arr(obj({
+            key: str('Field name in each row'),
+            label: str('Column header'),
+            align: str(undefined, { enum: ['left', 'right', 'center'] }),
+            format: str('How to format values', {
+                enum: ['text', 'number', 'currency', 'percent', 'date', 'link'],
+            }),
+        }, ['key', 'label']), { minItems: 1, maxItems: 12 }),
+        rows: arr(row, { maxItems: 500 }),
+    }, ['columns', 'rows']),
+    fallbackText: (props) => `${heading(props)}${textTable(props.columns ?? [], props.rows ?? [])}`,
+});
+export const Chart = defineComponent({
+    name: 'Chart',
+    title: 'Chart',
+    description: '`bar` to compare categories, `line` for a trend over time. `data` is a list of points; `xKey` names the category/time field and each series names a numeric field.',
+    props: obj({
+        type: str('Chart type', { enum: ['bar', 'line'] }),
+        title: str(),
+        xKey: str('Field of each point used for the x axis'),
+        series: arr(obj({ key: str('Numeric field'), label: str() }, ['key']), {
+            minItems: 1,
+            maxItems: 6,
+        }),
+        data: arr(row, { minItems: 1, maxItems: 200 }),
+        unit: str('Unit shown after values, e.g. `KB` or `%`'),
+    }, ['type', 'xKey', 'series', 'data']),
+    fallbackText: (props) => {
+        const series = props.series ?? [];
+        const data = props.data ?? [];
+        const first = series[0]?.key ?? '';
+        const max = Math.max(0, ...data.map((point) => Math.abs(Number(point[first]) || 0)));
+        const unit = props.unit ? ` ${s(props.unit)}` : '';
+        const lines = data
+            .slice(0, 20)
+            .map((point) => `${s(point[props.xKey]).slice(0, 18).padEnd(18)} ${bar(Number(point[first]) || 0, max)} ${s(point[first])}${unit}`);
+        return `${heading(props)}\`\`\`\n${lines.join('\n')}\n\`\`\``;
+    },
+});
+export const KpiCards = defineComponent({
+    name: 'KpiCards',
+    title: 'KPI cards',
+    description: 'A few key numbers (metrics, totals, counts) as cards.',
+    props: obj({
+        title: str(),
+        items: arr(obj({
+            label: str(),
+            value: { type: ['string', 'number'] },
+            delta: str('Change, e.g. `+12%`'),
+            trend: str(undefined, { enum: ['up', 'down', 'flat'] }),
+            hint: str(),
+        }, ['label', 'value']), { minItems: 1, maxItems: 8 }),
+    }, ['items']),
+    fallbackText: (props) => `${heading(props)}${(props.items ?? [])
+        .map((item) => `• *${s(item.label)}:* ${s(item.value)}${item.delta ? ` (${s(item.delta)})` : ''}`)
+        .join('\n')}`,
+});
+export const SourceCards = defineComponent({
+    name: 'SourceCards',
+    title: 'Sources',
+    description: 'The documents, pages or links an answer is based on, as cards.',
+    props: obj({
+        title: str(),
+        items: arr(obj({ title: str(), url: str(), snippet: str(), source: str('e.g. Wiki, GitHub') }, [
+            'title',
+        ]), { minItems: 1, maxItems: 12 }),
+    }, ['items']),
+    fallbackText: (props) => `${heading(props)}${(props.items ?? [])
+        .map((item) => `• ${item.url ? `<${s(item.url)}|${s(item.title)}>` : s(item.title)}${item.source ? ` — ${s(item.source)}` : ''}`)
+        .join('\n')}`,
+});
+export const Checklist = defineComponent({
+    name: 'Checklist',
+    title: 'Checklist',
+    description: 'Steps or a to-do list with done/not-done state.',
+    props: obj({
+        title: str(),
+        items: arr(obj({ label: str(), done: { type: 'boolean' }, note: str() }, ['label']), {
+            minItems: 1,
+            maxItems: 50,
+        }),
+    }, ['items']),
+    fallbackText: (props) => `${heading(props)}${(props.items ?? [])
+        .map((item) => `${item.done ? '☑' : '☐'} ${s(item.label)}${item.note ? ` — _${s(item.note)}_` : ''}`)
+        .join('\n')}`,
+});
+export const Timeline = defineComponent({
+    name: 'Timeline',
+    title: 'Timeline',
+    description: 'Events in chronological order (the history of a project, an incident, a deal).',
+    props: obj({
+        title: str(),
+        events: arr(obj({ date: str(), title: str(), description: str() }, ['title']), {
+            minItems: 1,
+            maxItems: 50,
+        }),
+    }, ['events']),
+    fallbackText: (props) => `${heading(props)}${(props.events ?? [])
+        .map((event) => `• ${event.date ? `*${s(event.date)}* ` : ''}${s(event.title)}${event.description ? ` — ${s(event.description)}` : ''}`)
+        .join('\n')}`,
+});
+export const CodeBlock = defineComponent({
+    name: 'CodeBlock',
+    title: 'Code',
+    description: 'A code snippet or file excerpt with syntax highlighting.',
+    props: obj({ title: str(), language: str(), code: str() }, ['code']),
+    fallbackText: (props) => `${heading(props)}\`\`\`\n${s(props.code)}\n\`\`\``,
+});
+export const Diff = defineComponent({
+    name: 'Diff',
+    title: 'Diff',
+    description: 'A before/after change to a text or code file, as a line diff.',
+    props: obj({ title: str(), language: str(), before: str(), after: str() }, ['before', 'after']),
+    fallbackText: (props) => `${heading(props)}\`\`\`\n${lineDiff(s(props.before), s(props.after))
+        .map((line) => `${line.op === 'add' ? '+' : line.op === 'del' ? '-' : ' '} ${line.text}`)
+        .join('\n')}\n\`\`\``,
+});
+export const Callout = defineComponent({
+    name: 'Callout',
+    title: 'Callout',
+    description: 'A short note, warning or success message, emphasized.',
+    props: obj({
+        tone: str(undefined, { enum: ['info', 'success', 'warning', 'danger'] }),
+        title: str(),
+        text: str(),
+    }, ['text']),
+    fallbackText: (props) => `${props.tone === 'warning' || props.tone === 'danger' ? ':warning: ' : ':information_source: '}${heading(props)}${s(props.text)}`,
+});
+export const Stack = defineComponent({
+    name: 'Stack',
+    title: 'Stack',
+    description: 'Lays its children out vertically (or horizontally with direction=row).',
+    props: obj({ direction: str(undefined, { enum: ['column', 'row'] }), gap: { type: 'number' } }),
+    children: true,
+    fallbackText: () => '',
+});
+export const Card = defineComponent({
+    name: 'Card',
+    title: 'Card',
+    description: 'A box with an optional title around its children.',
+    props: obj({ title: str(), subtitle: str() }),
+    children: true,
+    fallbackText: (props) => props.title ? `*${s(props.title)}*${props.subtitle ? ` — ${s(props.subtitle)}` : ''}` : '',
+});
+export const Heading = defineComponent({
+    name: 'Heading',
+    title: 'Heading',
+    description: 'A heading.',
+    props: obj({ text: str() }, ['text']),
+    fallbackText: (props) => `*${s(props.text)}*`,
+});
+export const Text = defineComponent({
+    name: 'Text',
+    title: 'Text',
+    description: 'A paragraph of plain text (no markdown).',
+    props: obj({ text: str(), muted: { type: 'boolean' } }, ['text']),
+    fallbackText: (props) => s(props.text),
+});
+export const Badge = defineComponent({
+    name: 'Badge',
+    title: 'Badge',
+    description: 'A small label.',
+    props: obj({
+        text: str(),
+        tone: str(undefined, { enum: ['neutral', 'brand', 'success', 'warning', 'danger'] }),
+    }, ['text']),
+    fallbackText: (props) => `[${s(props.text)}]`,
+});
+export const Link = defineComponent({
+    name: 'Link',
+    title: 'Link',
+    description: 'A link to an http(s) URL.',
+    props: obj({ text: str(), url: str(undefined, { pattern: '^https?://' }) }, ['text', 'url']),
+    fallbackText: (props) => `<${s(props.url)}|${s(props.text || props.url)}>`,
+});
+export const Image = defineComponent({
+    name: 'Image',
+    title: 'Image',
+    description: 'An image from an https URL.',
+    props: obj({ url: str(undefined, { pattern: '^https://' }), alt: str() }, ['url']),
+    fallbackText: (props) => s(props.url),
+});
+/** Content components: data a model shows. */
+export const BUILTIN_COMPONENTS = [
+    DataTable,
+    Chart,
+    KpiCards,
+    SourceCards,
+    Checklist,
+    Timeline,
+    CodeBlock,
+    Diff,
+    Callout,
+];
+/** Layout and text primitives, mostly for composing trees (`Stack`, `Card` take children). */
+export const LAYOUT_COMPONENTS = [
+    Stack,
+    Card,
+    Heading,
+    Text,
+    Badge,
+    Link,
+    Image,
+];
 //# sourceMappingURL=builtins.js.map

package/dist/src/genui/builtins.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../../src/genui/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4CAA4C,CAAC"}
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../../src/genui/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAA4B,eAAe,EAAE,MAAM,cAAc,CAAC;AAMzE,MAAM,GAAG,GAAG,CAAC,WAAoB,EAAE,KAAK,GAAe,EAAE,EAAc,EAAE,CAAC,CAAC;IACzE,IAAI,EAAE,QAAQ;IACd,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,GAAG,KAAK;CACT,CAAC,CAAC;AACH,MAAM,GAAG,GAAG,CAAC,UAAsC,EAAE,QAAQ,GAAa,EAAE,EAAc,EAAE,CAAC,CAAC;IAC5F,IAAI,EAAE,QAAQ;IACd,UAAU;IACV,QAAQ;IACR,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAC;AACH,MAAM,GAAG,GAAG,CAAC,KAAiB,EAAE,KAAK,GAAe,EAAE,EAAc,EAAE,CAAC,CAAC;IACtE,IAAI,EAAE,OAAO;IACb,KAAK;IACL,GAAG,KAAK;CACT,CAAC,CAAC;AACH,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;AAC3E,MAAM,GAAG,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;AAEvE,MAAM,CAAC,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnG,MAAM,OAAO,GAAG,CAAC,KAA0B,EAAU,EAAE,CACrD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAE7C,oEAAoE;AACpE,MAAM,UAAU,SAAS,CACvB,OAAkD,EAClD,IAAsB,EACtB,GAAG,GAAG,EAAE;IAER,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACpC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC1F,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,MAAgB,EAAE,EAAE,CAClC,MAAM;SACH,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;SAC/E,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACvE,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC;IACtE,OAAO,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;AAC/C,CAAC;AAOD,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAa;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QAClC,OAAO;YACL,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,CAAC,CAAC;SACnD,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAC/D,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACxC,CAAC;IACF,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,EAAE,CAAC,CAAC,CAAc,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAW,EAAE,CAAC,CAAC;YAC/C,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAW,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAW,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAW,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAW,EAAE,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,KAAK,GAAG,EAAE;IACjD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAa;IACnD,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,uHAAuH;IACzH,KAAK,EAAE,GAAG,CACR;QACE,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC;QAC3B,OAAO,EAAE,GAAG,CACV,GAAG,CACD;YACE,GAAG,EAAE,GAAG,CAAC,wBAAwB,CAAC;YAClC,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC;YAC3B,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5D,MAAM,EAAE,GAAG,CAAC,sBAAsB,EAAE;gBAClC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;aAChE,CAAC;SACH,EACD,CAAC,KAAK,EAAE,OAAO,CAAC,CACjB,EACD,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC9B;QACD,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;KAClC,EACD,CAAC,SAAS,EAAE,MAAM,CAAC,CACpB;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;CAChG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAa;IAC/C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EACT,oKAAoK;IACtK,KAAK,EAAE,GAAG,CACR;QACE,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAClD,KAAK,EAAE,GAAG,EAAE;QACZ,IAAI,EAAE,GAAG,CAAC,yCAAyC,CAAC;QACpD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE;YACrE,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;SACZ,CAAC;QACF,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC9C,IAAI,EAAE,GAAG,CAAC,2CAA2C,CAAC;KACvD,EACD,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CACnC;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI;aACf,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CACR,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,CACrH,CAAC;QACJ,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAChE,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CASpC;IACD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,uDAAuD;IACpE,KAAK,EAAE,GAAG,CACR;QACE,KAAK,EAAE,GAAG,EAAE;QACZ,KAAK,EAAE,GAAG,CACR,GAAG,CACD;YACE,KAAK,EAAE,GAAG,EAAE;YACZ,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACrC,KAAK,EAAE,GAAG,CAAC,qBAAqB,CAAC;YACjC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YACvD,IAAI,EAAE,GAAG,EAAE;SACZ,EACD,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,EACD,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAC7B;KACF,EACD,CAAC,OAAO,CAAC,CACV;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;SACpC,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACrF;SACA,IAAI,CAAC,IAAI,CAAC,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAGvC;IACD,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,gEAAgE;IAC7E,KAAK,EAAE,GAAG,CACR;QACE,KAAK,EAAE,GAAG,EAAE;QACZ,KAAK,EAAE,GAAG,CACR,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,mBAAmB,CAAC,EAAE,EAAE;YAClF,OAAO;SACR,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC9B;KACF,EACD,CAAC,OAAO,CAAC,CACV;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;SACpC,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACpH;SACA,IAAI,CAAC,IAAI,CAAC,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAGrC;IACD,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,iDAAiD;IAC9D,KAAK,EAAE,GAAG,CACR;QACE,KAAK,EAAE,GAAG,EAAE;QACZ,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE;YACnF,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;KACH,EACD,CAAC,OAAO,CAAC,CACV;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;SACpC,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACxF;SACA,IAAI,CAAC,IAAI,CAAC,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAGpC;IACD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gFAAgF;IAC7F,KAAK,EAAE,GAAG,CACR;QACE,KAAK,EAAE,GAAG,EAAE;QACZ,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE;YAC7E,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;KACH,EACD,CAAC,QAAQ,CAAC,CACX;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;SACrC,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1H;SACA,IAAI,CAAC,IAAI,CAAC,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAQ;IAC9C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,0DAA0D;IACvE,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU;CAC7E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAQ;IACzC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,+DAA+D;IAC5E,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/F,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;SACxF,IAAI,CAAC,IAAI,CAAC,UAAU;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAQ;IAC5C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,uDAAuD;IACpE,KAAK,EAAE,GAAG,CACR;QACE,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxE,KAAK,EAAE,GAAG,EAAE;QACZ,IAAI,EAAE,GAAG,EAAE;KACZ,EACD,CAAC,MAAM,CAAC,CACT;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,uBAAuB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;CACrI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAQ;IAC1C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,wEAAwE;IACrF,KAAK,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IAC/F,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAQ;IACzC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,mDAAmD;IAChE,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;IAC7C,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;CAC7F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAQ;IAC5C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,YAAY;IACzB,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAQ;IACzC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,0CAA0C;IACvD,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IACjE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAQ;IAC1C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,gBAAgB;IAC7B,KAAK,EAAE,GAAG,CACR;QACE,IAAI,EAAE,GAAG,EAAE;QACX,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;KACrF,EACD,CAAC,MAAM,CAAC,CACT;IACD,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAQ;IACzC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,2BAA2B;IACxC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5F,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG;CAC3E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAQ;IAC1C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAClF,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;CACtC,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAA4C;IACzE,SAAS;IACT,KAAK;IACL,QAAQ;IACR,WAAW;IACX,SAAS;IACT,QAAQ;IACR,SAAS;IACT,IAAI;IACJ,OAAO;CACR,CAAC;AAEF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAA4C;IACxE,KAAK;IACL,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;CACN,CAAC"}

package/dist/src/genui/capabilities.d.ts

@@ -0,0 +1,24 @@
+import { type Catalog } from './catalog.js';
+/** Renderer support only. Component definitions and authorization remain server-owned. */
+export interface UiCapabilities {
+    components: Array<{
+        name: string;
+        version: number;
+    }>;
+}
+export declare function validateUiCapabilities(value: unknown): UiCapabilities;
+export declare function negotiateCatalog(catalog: Catalog, capabilities?: UiCapabilities): Catalog;
+export type PreparedUiEmission = {
+    kind: 'ui';
+    component: string;
+    props: Record<string, unknown>;
+    version: number;
+    fallbackText: string;
+    componentVersions?: Record<string, number>;
+} | {
+    kind: 'text';
+    text: string;
+};
+/** Validate against current trusted definitions before drawing or generating complete text. */
+export declare function prepareUiEmission(catalog: Catalog, capabilities: UiCapabilities | undefined, component: string, props: Record<string, unknown>, version?: number): Promise<PreparedUiEmission>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/src/genui/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/genui/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,cAAc,CAAC;AAK3E,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAuBrE;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,cAAc,GAAG,OAAO,CAWzF;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,+FAA+F;AAC/F,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,cAAc,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAyC7B"}

package/dist/src/genui/capabilities.js

@@ -0,0 +1,81 @@
+import { COMPONENT_NAME, defineCatalog } from './catalog.js';
+import { formatIssues } from './schema.js';
+import { componentToText, treeToText } from './text.js';
+import { GENUI_TREE_COMPONENT, validateTree } from './tree.js';
+export function validateUiCapabilities(value) {
+    if (!record(value) ||
+        Object.keys(value).some((key) => key !== 'components') ||
+        !Array.isArray(value.components))
+        throw new TypeError('Invalid UI capabilities');
+    const seen = new Set();
+    const components = value.components.map((component) => {
+        if (!record(component) ||
+            Object.keys(component).some((key) => key !== 'name' && key !== 'version') ||
+            typeof component.name !== 'string' ||
+            !COMPONENT_NAME.test(component.name) ||
+            !Number.isSafeInteger(component.version) ||
+            Number(component.version) <= 0 ||
+            seen.has(component.name))
+            throw new TypeError('Invalid UI component capability');
+        seen.add(component.name);
+        return { name: component.name, version: Number(component.version) };
+    });
+    return { components };
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function negotiateCatalog(catalog, capabilities) {
+    if (capabilities === undefined)
+        return catalog;
+    const supported = validateUiCapabilities(capabilities).components;
+    return defineCatalog(catalog.components.filter((component) => supported.some((entry) => entry.name === component.name && entry.version === (component.version ?? 1))), { jsonSchemaValidator: catalog.validator });
+}
+/** Validate against current trusted definitions before drawing or generating complete text. */
+export async function prepareUiEmission(catalog, capabilities, component, props, version) {
+    const drawable = negotiateCatalog(catalog, capabilities);
+    if (component === GENUI_TREE_COMPONENT) {
+        if (version !== undefined && version !== 1)
+            throw new Error('Invalid UI tree version');
+        const validated = await validateTree(catalog, props.root);
+        if (!validated.ok)
+            throw new Error(`Invalid UI tree: ${formatIssues(validated.issues)}`);
+        const supported = (node) => drawable.has(node.type) && (node.children ?? []).every(supported);
+        const versions = new Map();
+        const collectVersions = (node) => {
+            versions.set(node.type, catalog.get(node.type)?.version ?? 1);
+            for (const child of node.children ?? [])
+                collectVersions(child);
+        };
+        collectVersions(validated.value);
+        return supported(validated.value)
+            ? {
+                kind: 'ui',
+                component,
+                props: { root: validated.value },
+                version: 1,
+                fallbackText: treeToText(catalog, validated.value),
+                componentVersions: Object.fromEntries(versions),
+            }
+            : { kind: 'text', text: treeToText(catalog, validated.value) };
+    }
+    const definition = catalog.get(component);
+    if (definition === undefined)
+        throw new Error(`Unknown UI component "${component}"`);
+    const currentVersion = definition.version ?? 1;
+    if (version !== undefined && version !== currentVersion)
+        throw new Error(`Invalid UI component version for "${component}"`);
+    const validated = await catalog.validate(component, props);
+    if (!validated.ok)
+        throw new Error(`Invalid UI props: ${formatIssues(validated.issues)}`);
+    return drawable.has(component)
+        ? {
+            kind: 'ui',
+            component,
+            props: validated.value,
+            version: currentVersion,
+            fallbackText: componentToText(catalog, component, validated.value),
+        }
+        : { kind: 'text', text: componentToText(catalog, component, validated.value) };
+}
+//# sourceMappingURL=capabilities.js.map