@adonis-agora/agent 0.60.1 → 0.62.0

package/dist/src/react/core/config/use-agent-config.js

@@ -0,0 +1,57 @@
+import { useEffect, useState } from 'react';
+import { useAgentBackend } from '../provider.js';
+// One request per backend for the whole page: the config is a deployment constant. A failure is
+// forgotten so the next mount retries.
+const shared = new WeakMap();
+function load(backend) {
+    const getConfig = backend.getConfig;
+    if (typeof getConfig !== 'function')
+        return undefined;
+    let pending = shared.get(backend);
+    if (pending === undefined) {
+        pending = getConfig.call(backend).catch((error) => {
+            shared.delete(backend);
+            throw error;
+        });
+        shared.set(backend, pending);
+    }
+    return pending;
+}
+/**
+ * The server's client config (`GET <base>/config`): attachment limits and upload mode, and whether a
+ * model picker, a quota and anonymous identities are in play. Fetched once per backend and shared;
+ * `useAttachments` takes its defaults from it.
+ */
+export function useAgentConfig(options = {}) {
+    const backend = useAgentBackend(options.backend);
+    const enabled = options.enabled !== false;
+    const [config, setConfig] = useState(undefined);
+    const [isLoading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const pending = load(backend);
+        if (pending === undefined)
+            return;
+        let cancelled = false;
+        setLoading(true);
+        pending.then((loaded) => {
+            if (cancelled)
+                return;
+            setConfig(loaded !== null && typeof loaded === 'object' ? loaded : undefined);
+            setError(null);
+            setLoading(false);
+        }, (failure) => {
+            if (cancelled)
+                return;
+            setError(failure instanceof Error ? failure : new Error(String(failure)));
+            setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [backend, enabled]);
+    return { config, isLoading, error };
+}
+//# sourceMappingURL=use-agent-config.js.map

package/dist/src/react/core/config/use-agent-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-config.js","sourceRoot":"","sources":["../../../../../src/react/core/config/use-agent-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAgBjD,gGAAgG;AAChG,uCAAuC;AACvC,MAAM,MAAM,GAAG,IAAI,OAAO,EAA4C,CAAC;AAEvE,SAAS,IAAI,CAAC,OAAqB;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAA0B,EAAE;IAChE,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAC1C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgC,SAAS,CAAC,CAAC;IAC/E,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAClC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CACV,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC9E,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,EACD,CAAC,OAAgB,EAAE,EAAE;YACnB,IAAI,SAAS;gBAAE,OAAO;YACtB,QAAQ,CAAC,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1E,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/dist/src/react/core/elicitation/answers.d.ts

@@ -0,0 +1,22 @@
+import type { ElicitationInputType, ElicitationQuestion } from '../../../index.js';
+export { type ElicitationInput, type ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue, } from '../../../elicitation-input.js';
+/** What a form control can hand over: a field's value, a checkbox's state, a picked date, a list. */
+export type RawAnswer = string | number | boolean | Date | null | undefined | readonly RawAnswer[];
+/** The question fields {@link coerceAnswer} reads. A transcript question and a core one both fit. */
+export type CoercibleQuestion = Pick<ElicitationQuestion, 'multiple'> & {
+    input?: {
+        type: ElicitationInputType;
+    } | null;
+};
+/**
+ * Turn whatever a form control produced into the `string[]` the answer route takes, in the
+ * question's canonical form: numbers as decimals, booleans as `"true"`/`"false"`, dates as
+ * `YYYY-MM-DD` (a `Date` is read as the local calendar day), trimmed where whitespace means
+ * nothing. An empty value becomes `[]` — no answer, not an empty string. A single-choice question
+ * keeps the first value.
+ *
+ * Coercion never judges: pair it with {@link validateAnswer} (the same rules the server applies) to
+ * say what is wrong before sending.
+ */
+export declare function coerceAnswer(question: CoercibleQuestion, raw: RawAnswer): string[];
+//# sourceMappingURL=answers.d.ts.map

package/dist/src/react/core/elicitation/answers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/elicitation/answers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,yBAAyB,IAAI,cAAc,EAC3C,wBAAwB,IAAI,mBAAmB,GAChD,MAAM,+BAA+B,CAAC;AAEvC,qGAAqG;AACrG,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAEnG,qGAAqG;AACrG,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,GAAG;IACtE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C,CAAC;AAgDF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAOlF"}

package/dist/src/react/core/elicitation/answers.js

@@ -0,0 +1,65 @@
+export { validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue, } from '../../../elicitation-input.js';
+function pad(value) {
+    return String(value).padStart(2, '0');
+}
+/** A `Date` as the calendar day the person picked — local time, which is the day they saw. */
+function toDay(date) {
+    if (Number.isNaN(date.getTime())) {
+        return null;
+    }
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+function coerceOne(type, raw) {
+    if (raw === null || raw === undefined) {
+        return null;
+    }
+    if (Array.isArray(raw)) {
+        return null;
+    }
+    if (raw instanceof Date) {
+        return type === 'date' || type === undefined ? toDay(raw) : raw.toISOString();
+    }
+    if (typeof raw === 'boolean') {
+        return raw ? 'true' : 'false';
+    }
+    if (typeof raw === 'number') {
+        return Number.isFinite(raw) ? String(raw) : null;
+    }
+    const text = raw;
+    switch (type) {
+        case 'number':
+        case 'email':
+        case 'url':
+        case 'date':
+            return text.trim() === '' ? null : text.trim();
+        case 'boolean': {
+            const lowered = text.trim().toLowerCase();
+            if (lowered === 'true' || lowered === 'on' || lowered === 'yes')
+                return 'true';
+            if (lowered === 'false' || lowered === 'off' || lowered === 'no')
+                return 'false';
+            return lowered === '' ? null : text;
+        }
+        default:
+            return text === '' ? null : text;
+    }
+}
+/**
+ * Turn whatever a form control produced into the `string[]` the answer route takes, in the
+ * question's canonical form: numbers as decimals, booleans as `"true"`/`"false"`, dates as
+ * `YYYY-MM-DD` (a `Date` is read as the local calendar day), trimmed where whitespace means
+ * nothing. An empty value becomes `[]` — no answer, not an empty string. A single-choice question
+ * keeps the first value.
+ *
+ * Coercion never judges: pair it with {@link validateAnswer} (the same rules the server applies) to
+ * say what is wrong before sending.
+ */
+export function coerceAnswer(question, raw) {
+    const type = question.input?.type;
+    const items = Array.isArray(raw) ? raw : [raw];
+    const values = items
+        .map((item) => coerceOne(type, item))
+        .filter((value) => value !== null);
+    return question.multiple === true ? values : values.slice(0, 1);
+}
+//# sourceMappingURL=answers.js.map

package/dist/src/react/core/elicitation/answers.js.map

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

package/dist/src/react/core/feedback/use-message-feedback.d.ts

@@ -0,0 +1,32 @@
+import type { UIMessage } from 'ai';
+import type { MessageFeedback, MessageFeedbackValue } from '../../../index.js';
+import { type AgentBackend } from '../backend.js';
+export interface UseMessageFeedbackOptions {
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `setMessageFeedback`. */
+    backend?: AgentBackend;
+    /**
+     * The thread the messages belong to — `useAgentChat(...).getThreadId`, or an id. Needed to rate a
+     * message streamed in this session: its id is the client's own, so the persisted row it became is
+     * looked up by the run that wrote it.
+     */
+    threadId?: string | (() => string | undefined);
+}
+export interface MessageFeedbackState {
+    /** The rating to show: the one set in this session, else the persisted one, else `null`. */
+    feedbackOf: (message: UIMessage) => MessageFeedback | null;
+    /** A rating for this message is on its way to the server. */
+    isPending: (message: UIMessage) => boolean;
+    /** Set `'up'`/`'down'` (optionally with a comment), or clear with `null`. Optimistic. */
+    rate: (message: UIMessage, value: MessageFeedbackValue | null, comment?: string) => Promise<void>;
+    /** Thumbs-button semantics: the same value again clears it, another value replaces it. */
+    toggle: (message: UIMessage, value: MessageFeedbackValue) => Promise<void>;
+    /** The last failure; cleared by the next successful rating. */
+    error: Error | null;
+}
+/**
+ * Thumbs-up/down (+ comment) on assistant messages, over `POST <base>/messages/:id/feedback`.
+ * Headless: it holds the state and the calls, the host draws the buttons. A rating shows at once
+ * and rolls back if the server refuses it.
+ */
+export declare function useMessageFeedback(options?: UseMessageFeedbackOptions): MessageFeedbackState;
+//# sourceMappingURL=use-message-feedback.d.ts.map

package/dist/src/react/core/feedback/use-message-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-feedback.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/feedback/use-message-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,eAAe,CAAC;AAIxE,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,eAAe,GAAG,IAAI,CAAC;IAC3D,6DAA6D;IAC7D,SAAS,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC;IAC3C,yFAAyF;IACzF,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,0FAA0F;IAC1F,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,+DAA+D;IAC/D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,oBAAoB,CAmGhG"}

package/dist/src/react/core/feedback/use-message-feedback.js

@@ -0,0 +1,106 @@
+import { useCallback, useRef, useState } from 'react';
+import { requireBackendMethod } from '../backend.js';
+import { useAgentBackend } from '../provider.js';
+/**
+ * Thumbs-up/down (+ comment) on assistant messages, over `POST <base>/messages/:id/feedback`.
+ * Headless: it holds the state and the calls, the host draws the buttons. A rating shows at once
+ * and rolls back if the server refuses it.
+ */
+export function useMessageFeedback(options = {}) {
+    const backend = useAgentBackend(options.backend);
+    const latest = useRef({ ...options, backend });
+    latest.current = { ...options, backend };
+    const [local, setLocal] = useState(new Map());
+    const [pending, setPending] = useState(new Set());
+    const [error, setError] = useState(null);
+    const localRef = useRef(local);
+    localRef.current = local;
+    // Live message id → the persisted row it resolved to, so a message is looked up once.
+    const resolved = useRef(new Map());
+    const feedbackOf = useCallback((message) => {
+        const mine = local.get(message.id);
+        if (mine !== undefined)
+            return mine.feedback;
+        return metadataOf(message).feedback ?? null;
+    }, [local]);
+    const isPending = useCallback((message) => pending.has(message.id), [pending]);
+    const storedIdFor = useCallback(async (message) => {
+        const runId = metadataOf(message).runId;
+        if (runId === undefined)
+            return message.id;
+        const known = resolved.current.get(message.id);
+        if (known !== undefined)
+            return known;
+        const { backend, threadId } = latest.current;
+        const thread = typeof threadId === 'function' ? threadId() : threadId;
+        if (thread === undefined) {
+            throw new Error('useMessageFeedback: a streamed message needs `threadId` to be rated');
+        }
+        const detail = await backend.getThread(thread);
+        const row = [...detail.messages]
+            .reverse()
+            .find((candidate) => candidate.role === 'assistant' && candidate.runId === runId);
+        if (row === undefined) {
+            throw new Error(`useMessageFeedback: run ${runId} has no persisted answer yet`);
+        }
+        resolved.current.set(message.id, row.id);
+        return row.id;
+    }, []);
+    const rate = useCallback(async (message, value, comment) => {
+        const setFeedback = requireBackendMethod(latest.current.backend, 'setMessageFeedback');
+        const had = localRef.current.get(message.id);
+        const optimistic = value === null
+            ? null
+            : {
+                value,
+                ...(comment !== undefined && comment.trim().length > 0
+                    ? { comment: comment.trim() }
+                    : {}),
+                updatedAt: new Date().toISOString(),
+            };
+        setLocal((current) => new Map(current).set(message.id, { feedback: optimistic }));
+        setPending((current) => new Set(current).add(message.id));
+        try {
+            const storedId = await storedIdFor(message);
+            const { feedback } = await setFeedback(storedId, {
+                value,
+                ...(comment !== undefined ? { comment } : {}),
+            });
+            setLocal((current) => new Map(current).set(message.id, { feedback }));
+            setError(null);
+        }
+        catch (caught) {
+            setLocal((current) => {
+                const next = new Map(current);
+                if (had === undefined)
+                    next.delete(message.id);
+                else
+                    next.set(message.id, had);
+                return next;
+            });
+            const failure = caught instanceof Error ? caught : new Error(String(caught));
+            setError(failure);
+            throw failure;
+        }
+        finally {
+            setPending((current) => {
+                const next = new Set(current);
+                next.delete(message.id);
+                return next;
+            });
+        }
+    }, [storedIdFor]);
+    const toggle = useCallback((message, value) => {
+        const mine = localRef.current.get(message.id);
+        const current = mine !== undefined ? mine.feedback : (metadataOf(message).feedback ?? null);
+        return rate(message, current?.value === value ? null : value);
+    }, [rate]);
+    return { feedbackOf, isPending, rate, toggle, error };
+}
+function metadataOf(message) {
+    const metadata = message.metadata;
+    return metadata !== null && typeof metadata === 'object'
+        ? metadata
+        : {};
+}
+//# sourceMappingURL=use-message-feedback.js.map

package/dist/src/react/core/feedback/use-message-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-feedback.js","sourceRoot":"","sources":["../../../../../src/react/core/feedback/use-message-feedback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA6BjD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAA8B,EAAE;IACxE,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;IACzC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA6B,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,sFAAsF;IACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,GAAG,EAAkB,CAAC,CAAC;IAEnD,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,OAAkB,EAA0B,EAAE;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QAC7C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC9C,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,OAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1F,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,EAAE,OAAkB,EAAmB,EAAE;QAC5E,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;aAC7B,OAAO,EAAE;aACT,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACpF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,8BAA8B,CAAC,CAAC;QAClF,CAAC;QACD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,OAAkB,EAAE,KAAkC,EAAE,OAAgB,EAAE,EAAE;QACjF,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACvF,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GACd,KAAK,KAAK,IAAI;YACZ,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,KAAK;gBACL,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;oBACpD,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE;oBAC7B,CAAC,CAAC,EAAE,CAAC;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACR,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAClF,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;gBAC/C,KAAK;gBACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAC;YACH,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YACtE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,IAAI,GAAG,KAAK,SAAS;oBAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;;oBAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7E,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,MAAM,OAAO,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE;gBACrB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,OAAkB,EAAE,KAA2B,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,OAAkB;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,OAAO,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QACtD,CAAC,CAAE,QAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/src/react/core/genui/generative-ui.d.ts

@@ -0,0 +1,76 @@
+import { type ReactNode } from 'react';
+import type { TranscriptUiBlock } from '../transcript/model.js';
+import type { GenerativeUIElement, GenerativeUIItem, GenerativeUIOptions, GenerativeUIProblem, GenerativeUIState } from './types.js';
+/** What to draw instead of a component that did not render. Default: nothing. */
+export type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
+/**
+ * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and
+ * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`
+ * (e.g. the json-render one) or a registry entry for `genui:tree` takes over.
+ */
+export declare function GenuiTree({ root }: {
+    root?: GenerativeUIElement;
+}): import("react").JSX.Element | null;
+export interface GenerativeUIScopeProps extends GenerativeUIOptions {
+    fallbackText?: string;
+    componentVersions?: Record<string, number>;
+    fallback?: GenerativeUIFallback;
+    loading?: ReactNode;
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+    children?: ReactNode;
+}
+/**
+ * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap
+ * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.
+ */
+export declare function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading, onError, children, }: GenerativeUIScopeProps): import("react").JSX.Element;
+/** What `<GenuiProvider>` hands every `<GenerativeUI>` / `useGenerativeUI` below it. */
+export interface GenuiProviderValue extends Partial<GenerativeUIOptions> {
+    fallback?: GenerativeUIFallback;
+    loading?: ReactNode;
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+}
+/** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */
+export declare function useGenuiProvider(): GenuiProviderValue | null;
+export interface GenuiProviderProps extends GenuiProviderValue {
+    children?: ReactNode;
+}
+/**
+ * Set generative UI up once, at the app root: the registry of your renderers, the catalog to
+ * validate against, a resolver for components the registry lacks, and what to draw when one does
+ * not render. Every `<GenerativeUI>` below reads it (its own props still win), and `MessageItem` /
+ * `MessageList` draw pushed components with it — no `renderUi` per message.
+ *
+ * ```tsx
+ * <GenuiProvider registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />}>
+ *   <App />
+ * </GenuiProvider>
+ * ```
+ */
+export declare function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError, children, }: GenuiProviderProps): import("react").JSX.Element;
+/**
+ * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when
+ * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.
+ */
+export declare function useGenerativeUI(part: unknown, options?: Partial<GenerativeUIOptions>): GenerativeUIState | null;
+export interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
+    /** A transcript `ui` block, a `data-ui` message part, or a stored `{ id, component, props, version? }`. */
+    part: TranscriptUiBlock | GenerativeUIItem | unknown;
+    /** Drawn for an unknown component, invalid props, or a renderer that threw. Default: the provider's, then the item's persisted text. */
+    fallback?: GenerativeUIFallback;
+    /** Drawn while a resolver or an async validation is pending. Default: the provider's, else nothing. */
+    loading?: ReactNode;
+    /** A renderer threw (the item shows `fallback`). */
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+}
+/**
+ * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and
+ * no style of its own — only what the registry's component renders (and whatever `fallback` /
+ * `loading` you pass). Everything but `part` defaults to the enclosing `<GenuiProvider>`.
+ *
+ * ```tsx
+ * <GenerativeUI part={block} />
+ * ```
+ */
+export declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;
+//# sourceMappingURL=generative-ui.d.ts.map

package/dist/src/react/core/genui/generative-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/generative-ui.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAOpB,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAC,CAAC;AA6H7F;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAAE,sCAGjE;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,OAAc,EACd,OAAO,EACP,QAAQ,GACT,EAAE,sBAAsB,+BA0BxB;AAED,wFAAwF;AACxF,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IACtE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC5D;AAQD,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,kBAAkB,GAAG,IAAI,CAE5D;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,kBAAkB,+BAmBpB;AAsBD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,iBAAiB,GAAG,IAAI,CAG1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IACrE,2GAA2G;IAC3G,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAAC;IACrD,wIAAwI;IACxI,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,uGAAuG;IACvG,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,UAAU,GACpB,EAAE,iBAAiB,+TAuCnB"}

package/dist/src/react/core/genui/generative-ui.js

@@ -0,0 +1,210 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component, createContext, useCallback, useContext, useMemo, } from 'react';
+import { AmbientRenderUiContext, sharedContext } from '../components/ambient-ui.js';
+import { useGenerativeUIState, useResolvedComponent, useValidatedProps, } from './use-generative-ui.js';
+const TreeScopeContext = createContext(null);
+function renderFallback(fallback, problem) {
+    if (typeof fallback === 'function')
+        return fallback(problem);
+    if (fallback !== undefined)
+        return fallback;
+    return problem.item.fallbackText !== undefined ? (_jsx("span", { style: { whiteSpace: 'pre-wrap' }, children: problem.item.fallbackText })) : null;
+}
+/** One failing renderer takes down its own item, never the message around it. */
+class ItemBoundary extends Component {
+    state = { error: undefined, failed: false };
+    static getDerivedStateFromError(error) {
+        return { error, failed: true };
+    }
+    componentDidCatch(error, _info) {
+        this.props.onError?.(error, this.props.item);
+    }
+    componentDidUpdate(previous) {
+        // New props for the same item (a streamed update) get a fresh chance to render.
+        if (this.state.failed && previous.item !== this.props.item) {
+            this.setState({ error: undefined, failed: false });
+        }
+    }
+    render() {
+        if (this.state.failed) {
+            return renderFallback(this.props.fallback, {
+                reason: 'error',
+                item: this.props.item,
+                error: this.state.error,
+            });
+        }
+        return this.props.children;
+    }
+}
+function nodeItem(node, id) {
+    return { id, component: node.type, props: node.props ?? {}, version: null, toolCallId: null };
+}
+/** One tree node: resolved and validated like a top-level item, children rendered as its `children`. */
+function TreeNode({ node, id }) {
+    const scope = useContext(TreeScopeContext);
+    const item = useMemo(() => nodeItem(node, id), [node, id]);
+    const storedVersion = scope?.componentVersions?.[node.type];
+    const definition = scope?.options.catalog?.get?.(node.type);
+    const incompatible = storedVersion !== undefined &&
+        definition !== undefined &&
+        storedVersion !== (definition.version ?? 1);
+    const resolution = useResolvedComponent(node.type, storedVersion ?? null, incompatible ? {} : (scope?.options.registry ?? {}), scope?.options.resolveComponent);
+    const validation = useValidatedProps(incompatible ? undefined : scope?.options.catalog, node.type, item.props);
+    if (scope === null)
+        return null;
+    if (resolution.status === 'loading' || validation.status === 'pending')
+        return scope.loading;
+    if (resolution.status === 'unknown') {
+        if (scope.fallback === undefined && scope.fallbackText !== undefined)
+            throw new Error('Unknown tree component');
+        return renderFallback(scope.fallback, { reason: 'unknown', item });
+    }
+    if (resolution.status === 'error') {
+        if (scope.fallback === undefined && scope.fallbackText !== undefined)
+            throw resolution.error;
+        return renderFallback(scope.fallback, { reason: 'error', item, error: resolution.error });
+    }
+    if (validation.status === 'invalid') {
+        if (scope.fallback === undefined && scope.fallbackText !== undefined)
+            throw new Error('Invalid tree component');
+        return renderFallback(scope.fallback, { reason: 'invalid', item, issues: validation.issues });
+    }
+    const Renderer = resolution.Component;
+    const children = Array.isArray(node.children) ? node.children : [];
+    return (_jsx(Renderer, { ...validation.props, children: children.length > 0
+            ? children.map((child, index) => {
+                const childId = `${id}.${index}`;
+                if (scope.fallback === undefined && scope.fallbackText !== undefined)
+                    return _jsx(TreeNode, { node: child, id: childId }, childId);
+                return (_jsx(ItemBoundary, { item: nodeItem(child, childId), fallback: scope.fallback, onError: scope.onError, children: _jsx(TreeNode, { node: child, id: childId }) }, childId));
+            })
+            : undefined }));
+}
+/**
+ * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and
+ * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`
+ * (e.g. the json-render one) or a registry entry for `genui:tree` takes over.
+ */
+export function GenuiTree({ root }) {
+    if (root === undefined || root === null || typeof root.type !== 'string')
+        return null;
+    return _jsx(TreeNode, { node: root, id: "root" });
+}
+/**
+ * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap
+ * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.
+ */
+export function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading = null, onError, children, }) {
+    const scope = useMemo(() => ({
+        options: {
+            registry,
+            ...(catalog !== undefined ? { catalog } : {}),
+            ...(resolveComponent !== undefined ? { resolveComponent } : {}),
+        },
+        fallback,
+        ...(componentVersions !== undefined ? { componentVersions } : {}),
+        ...(fallbackText !== undefined ? { fallbackText } : {}),
+        loading,
+        onError,
+    }), [
+        registry,
+        catalog,
+        resolveComponent,
+        fallback,
+        fallbackText,
+        componentVersions,
+        loading,
+        onError,
+    ]);
+    return _jsx(TreeScopeContext.Provider, { value: scope, children: children });
+}
+// Shared by key: `/genui` and `/genui/json-render` are separate bundles, and a provider from one
+// must reach a `<GenerativeUI>` from the other.
+const GenuiContext = sharedContext('@adonis-agora/agent/react:genui-provider');
+/** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */
+export function useGenuiProvider() {
+    return useContext(GenuiContext);
+}
+/**
+ * Set generative UI up once, at the app root: the registry of your renderers, the catalog to
+ * validate against, a resolver for components the registry lacks, and what to draw when one does
+ * not render. Every `<GenerativeUI>` below reads it (its own props still win), and `MessageItem` /
+ * `MessageList` draw pushed components with it — no `renderUi` per message.
+ *
+ * ```tsx
+ * <GenuiProvider registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />}>
+ *   <App />
+ * </GenuiProvider>
+ * ```
+ */
+export function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError, children, }) {
+    const value = useMemo(() => ({
+        ...(registry !== undefined ? { registry } : {}),
+        ...(catalog !== undefined ? { catalog } : {}),
+        ...(resolveComponent !== undefined ? { resolveComponent } : {}),
+        ...(treeRenderer !== undefined ? { treeRenderer } : {}),
+        ...(fallback !== undefined ? { fallback } : {}),
+        ...(loading !== undefined ? { loading } : {}),
+        ...(onError !== undefined ? { onError } : {}),
+    }), [registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError]);
+    const renderUi = useCallback((block) => _jsx(GenerativeUI, { part: block }), []);
+    return (_jsx(GenuiContext.Provider, { value: value, children: _jsx(AmbientRenderUiContext.Provider, { value: renderUi, children: children }) }));
+}
+const NO_REGISTRY = {};
+/** Provider settings overlaid with explicit ones (explicit wins), memoized on their parts. */
+function useMergedOptions(own) {
+    const provided = useContext(GenuiContext);
+    const registry = own.registry ?? provided?.registry ?? NO_REGISTRY;
+    const catalog = own.catalog ?? provided?.catalog;
+    const resolveComponent = own.resolveComponent ?? provided?.resolveComponent;
+    const treeRenderer = own.treeRenderer ?? provided?.treeRenderer;
+    return useMemo(() => ({
+        registry,
+        ...(catalog !== undefined ? { catalog } : {}),
+        ...(resolveComponent !== undefined ? { resolveComponent } : {}),
+        ...(treeRenderer !== undefined ? { treeRenderer } : {}),
+    }), [registry, catalog, resolveComponent, treeRenderer]);
+}
+/**
+ * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when
+ * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.
+ */
+export function useGenerativeUI(part, options = {}) {
+    const merged = useMergedOptions(options);
+    return useGenerativeUIState(part, merged, merged.treeRenderer ?? GenuiTree);
+}
+/**
+ * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and
+ * no style of its own — only what the registry's component renders (and whatever `fallback` /
+ * `loading` you pass). Everything but `part` defaults to the enclosing `<GenuiProvider>`.
+ *
+ * ```tsx
+ * <GenerativeUI part={block} />
+ * ```
+ */
+export function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }) {
+    const provided = useContext(GenuiContext);
+    const fallback = ownFallback !== undefined ? ownFallback : provided?.fallback;
+    const loading = ownLoading ?? provided?.loading ?? null;
+    const onError = ownOnError ?? provided?.onError;
+    const options = useMergedOptions({
+        ...(registry !== undefined ? { registry } : {}),
+        ...(catalog !== undefined ? { catalog } : {}),
+        ...(resolveComponent !== undefined ? { resolveComponent } : {}),
+        ...(treeRenderer !== undefined ? { treeRenderer } : {}),
+    });
+    const state = useGenerativeUIState(part, options, options.treeRenderer ?? GenuiTree);
+    if (state === null)
+        return null;
+    if (state.status === 'loading')
+        return loading;
+    if (state.status === 'problem') {
+        const { status: _status, ...problem } = state;
+        return renderFallback(fallback, problem);
+    }
+    const Renderer = state.Component;
+    return (_jsx(GenerativeUIScope, { ...options, ...(state.item.componentVersions !== undefined
+            ? { componentVersions: state.item.componentVersions }
+            : {}), ...(state.item.fallbackText !== undefined ? { fallbackText: state.item.fallbackText } : {}), fallback: fallback, loading: loading, ...(onError !== undefined ? { onError } : {}), children: _jsx(ItemBoundary, { item: state.item, fallback: fallback, onError: onError, children: _jsx(Renderer, { ...state.props }) }) }));
+}
+//# sourceMappingURL=generative-ui.js.map

package/dist/src/react/core/genui/generative-ui.js.map

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

package/dist/src/react/core/genui/index.d.ts

@@ -0,0 +1,5 @@
+export { GenerativeUI, type GenerativeUIFallback, type GenerativeUIProps, GenerativeUIScope, type GenerativeUIScopeProps, GenuiProvider, type GenuiProviderProps, type GenuiProviderValue, GenuiTree, useGenerativeUI, useGenuiProvider, } from './generative-ui.js';
+export { createReactComponentRegistry, type ReactComponentRegistry, type ReactComponentRenderers, } from './react-registry.js';
+export { GENUI_TREE_COMPONENT, type GenerativeUIElement, type GenerativeUIItem, type GenerativeUIOptions, type GenerativeUIProblem, type GenerativeUIState, type GenuiCatalogLike, type GenuiIssueLike, type GenuiRegistry, type GenuiRenderer, type ResolveComponent, } from './types.js';
+export { toGenerativeUIItem } from './use-generative-ui.js';
+//# sourceMappingURL=index.d.ts.map