@adonis-agora/agent 0.61.0 → 0.63.0

package/dist/src/react/core/genui/types.d.ts.map

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

package/dist/src/react/core/genui/types.js

@@ -0,0 +1,3 @@
+/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@adonis-agora/agent/genui`). */
+export const GENUI_TREE_COMPONENT = 'genui:tree';
+//# sourceMappingURL=types.js.map

package/dist/src/react/core/genui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/types.ts"],"names":[],"mappings":"AAEA,wHAAwH;AACxH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC"}

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

@@ -0,0 +1,42 @@
+import { type GenerativeUIItem, type GenerativeUIOptions, type GenerativeUIState, type GenuiCatalogLike, type GenuiIssueLike, type GenuiRegistry, type GenuiRenderer, type ResolveComponent } from './types.js';
+/**
+ * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part
+ * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for
+ * anything else.
+ */
+export declare function toGenerativeUIItem(part: unknown): GenerativeUIItem | null;
+type Resolution = {
+    status: 'ready';
+    Component: GenuiRenderer;
+} | {
+    status: 'loading';
+} | {
+    status: 'unknown';
+} | {
+    status: 'error';
+    error: unknown;
+};
+/**
+ * Which renderer draws `name`: the registry first, then `resolveComponent` (cached; async results
+ * re-render the caller when they land). `fallbackTree` answers the tree component when the
+ * registry does not override it.
+ */
+export declare function useResolvedComponent(name: string, version: number | null, registry: GenuiRegistry, resolve: ResolveComponent | undefined, fallbackTree?: GenuiRenderer): Resolution;
+type Validation = {
+    status: 'ok';
+    props: Record<string, unknown>;
+} | {
+    status: 'pending';
+} | {
+    status: 'invalid';
+    issues: GenuiIssueLike[];
+};
+/**
+ * Props checked against the catalog: synchronously when the catalog can (`validateSync`), else
+ * after the async check settles. A component the catalog does not know passes through unchecked.
+ */
+export declare function useValidatedProps(catalog: GenuiCatalogLike | undefined, name: string, props: Record<string, unknown>): Validation;
+/** {@link import('./generative-ui.js').useGenerativeUI}, with the tree renderer handed in (avoids an import cycle). */
+export declare function useGenerativeUIState(part: unknown, options: GenerativeUIOptions, fallbackTree: GenuiRenderer | undefined): GenerativeUIState | null;
+export {};
+//# sourceMappingURL=use-generative-ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-generative-ui.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/use-generative-ui.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAqBzE;AAED,KAAK,UAAU,GACX;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAgDxC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,YAAY,CAAC,EAAE,aAAa,GAC3B,UAAU,CAsBZ;AAED,KAAK,UAAU,GACX;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,UAAU,CA2CZ;AAED,uHAAuH;AACvH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,aAAa,GAAG,SAAS,GACtC,iBAAiB,GAAG,IAAI,CA6C1B"}

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

@@ -0,0 +1,186 @@
+import { useEffect, useMemo, useState } from 'react';
+import { GENUI_TREE_COMPONENT, } from './types.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part
+ * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for
+ * anything else.
+ */
+export function toGenerativeUIItem(part) {
+    if (!isRecord(part))
+        return null;
+    const source = part.type === 'data-ui' && isRecord(part.data) ? part.data : part;
+    if (typeof source.component !== 'string')
+        return null;
+    const id = typeof source.id === 'string' ? source.id : typeof part.id === 'string' ? part.id : null;
+    if (id === null)
+        return null;
+    return {
+        id,
+        component: source.component,
+        ...(isRecord(source.componentVersions) &&
+            Object.values(source.componentVersions).every((version) => typeof version === 'number' && Number.isSafeInteger(version) && version > 0)
+            ? { componentVersions: { ...source.componentVersions } }
+            : {}),
+        ...(typeof source.fallbackText === 'string' ? { fallbackText: source.fallbackText } : {}),
+        props: isRecord(source.props) ? source.props : {},
+        version: typeof source.version === 'number' ? source.version : null,
+        toolCallId: typeof source.toolCallId === 'string' ? source.toolCallId : null,
+    };
+}
+const resolverCaches = new WeakMap();
+function resolveCached(resolve, name, version) {
+    let cache = resolverCaches.get(resolve);
+    if (cache === undefined) {
+        cache = new Map();
+        resolverCaches.set(resolve, cache);
+    }
+    const key = `${name}@${version ?? ''}`;
+    const hit = cache.get(key);
+    if (hit !== undefined)
+        return hit;
+    let entry;
+    try {
+        const result = resolve(name, version);
+        if (result instanceof Promise) {
+            entry = { resolution: { status: 'loading' }, settled: null };
+            entry.settled = result.then((Component) => {
+                entry.resolution = Component ? { status: 'ready', Component } : { status: 'unknown' };
+            }, (error) => {
+                entry.resolution = { status: 'error', error };
+            });
+        }
+        else {
+            entry = {
+                resolution: result ? { status: 'ready', Component: result } : { status: 'unknown' },
+                settled: null,
+            };
+        }
+    }
+    catch (error) {
+        entry = { resolution: { status: 'error', error }, settled: null };
+    }
+    cache.set(key, entry);
+    return entry;
+}
+/**
+ * Which renderer draws `name`: the registry first, then `resolveComponent` (cached; async results
+ * re-render the caller when they land). `fallbackTree` answers the tree component when the
+ * registry does not override it.
+ */
+export function useResolvedComponent(name, version, registry, resolve, fallbackTree) {
+    const [, setTick] = useState(0);
+    const own = registry[name];
+    const entry = own !== undefined || resolve === undefined ? null : resolveCached(resolve, name, version);
+    const pending = entry?.resolution.status === 'loading' ? entry.settled : null;
+    useEffect(() => {
+        if (pending === null)
+            return;
+        let live = true;
+        void pending.then(() => {
+            if (live)
+                setTick((tick) => tick + 1);
+        });
+        return () => {
+            live = false;
+        };
+    }, [pending]);
+    if (own !== undefined)
+        return { status: 'ready', Component: own };
+    if (entry !== null && entry.resolution.status !== 'unknown')
+        return entry.resolution;
+    if (name === GENUI_TREE_COMPONENT && fallbackTree !== undefined) {
+        return { status: 'ready', Component: fallbackTree };
+    }
+    return { status: 'unknown' };
+}
+/**
+ * Props checked against the catalog: synchronously when the catalog can (`validateSync`), else
+ * after the async check settles. A component the catalog does not know passes through unchecked.
+ */
+export function useValidatedProps(catalog, name, props) {
+    const checked = catalog?.has(name) === true;
+    const immediate = useMemo(() => {
+        if (!checked || catalog === undefined)
+            return { status: 'ok', props };
+        const result = catalog.validateSync?.(name, props);
+        if (result === undefined)
+            return null;
+        return result.ok
+            ? { status: 'ok', props: result.value }
+            : { status: 'invalid', issues: result.issues };
+    }, [checked, catalog, name, props]);
+    const [late, setLate] = useState(null);
+    useEffect(() => {
+        if (immediate !== null || catalog === undefined)
+            return;
+        let live = true;
+        catalog.validate(name, props).then((result) => {
+            if (!live)
+                return;
+            setLate({
+                props,
+                result: result.ok
+                    ? { status: 'ok', props: result.value }
+                    : { status: 'invalid', issues: result.issues },
+            });
+        }, (error) => {
+            if (!live)
+                return;
+            setLate({
+                props,
+                result: {
+                    status: 'invalid',
+                    issues: [{ path: [], message: error instanceof Error ? error.message : String(error) }],
+                },
+            });
+        });
+        return () => {
+            live = false;
+        };
+    }, [immediate, catalog, name, props]);
+    if (immediate !== null)
+        return immediate;
+    return late !== null && late.props === props ? late.result : { status: 'pending' };
+}
+/** {@link import('./generative-ui.js').useGenerativeUI}, with the tree renderer handed in (avoids an import cycle). */
+export function useGenerativeUIState(part, options, fallbackTree) {
+    const item = useMemo(() => toGenerativeUIItem(part), [part]);
+    const name = item?.component ?? '';
+    const definition = options.catalog?.get?.(name);
+    const incompatible = item?.fallbackText !== undefined &&
+        item.version !== null &&
+        definition !== undefined &&
+        item.version !== (definition.version ?? 1);
+    const resolution = useResolvedComponent(name, item?.version ?? null, incompatible ? {} : options.registry, item === null ? undefined : options.resolveComponent, fallbackTree);
+    const empty = useMemo(() => ({}), []);
+    // A tree is validated node by node as it renders, not as one component.
+    const validation = useValidatedProps(item === null || name === GENUI_TREE_COMPONENT || incompatible ? undefined : options.catalog, name, item?.props ?? empty);
+    if (item === null)
+        return null;
+    if (name === GENUI_TREE_COMPONENT &&
+        item.fallbackText !== undefined &&
+        (!isRecord(item.props.root) || typeof item.props.root.type !== 'string'))
+        return {
+            status: 'problem',
+            reason: 'invalid',
+            item,
+            issues: [{ path: ['root'], message: 'Invalid UI tree root' }],
+        };
+    if (resolution.status === 'loading')
+        return { status: 'loading', item };
+    if (resolution.status === 'unknown')
+        return { status: 'problem', reason: 'unknown', item };
+    if (resolution.status === 'error') {
+        return { status: 'problem', reason: 'error', item, error: resolution.error };
+    }
+    if (validation.status === 'pending')
+        return { status: 'loading', item };
+    if (validation.status === 'invalid') {
+        return { status: 'problem', reason: 'invalid', item, issues: validation.issues };
+    }
+    return { status: 'ready', item, Component: resolution.Component, props: validation.props };
+}
+//# sourceMappingURL=use-generative-ui.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-generative-ui.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/use-generative-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EACL,oBAAoB,GASrB,MAAM,YAAY,CAAC;AAEpB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,EAAE,GACN,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO;QACL,EAAE;QACF,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAC3C,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CACzF;YACC,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,GAAG,MAAM,CAAC,iBAAiB,EAA4B,EAAE;YAClF,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACjD,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACnE,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;KAC7E,CAAC;AACJ,CAAC;AAaD,MAAM,cAAc,GAAG,IAAI,OAAO,EAA6C,CAAC;AAEhF,SAAS,aAAa,CACpB,OAAyB,EACzB,IAAY,EACZ,OAAsB;IAEtB,IAAI,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,IAAI,KAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,KAAK,GAAG,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7D,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,CAAC,SAAS,EAAE,EAAE;gBACZ,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACxF,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;gBACjB,KAAK,CAAC,UAAU,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAChD,CAAC,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,GAAG;gBACN,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE;gBACnF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,GAAG,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,OAAsB,EACtB,QAAuB,EACvB,OAAqC,EACrC,YAA4B;IAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,KAAK,GACT,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QAC7B,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,IAAI;gBAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IAClE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IACrF,IAAI,IAAI,KAAK,oBAAoB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAqC,EACrC,IAAY,EACZ,KAA8B;IAE9B,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAoB,GAAG,EAAE;QAChD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE;YACd,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YACvC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAC9B,IAAI,CACL,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QACxD,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,CAChC,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,OAAO,CAAC;gBACN,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,EAAE;oBACf,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;oBACvC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;aACjD,CAAC,CAAC;QACL,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,OAAO,CAAC;gBACN,KAAK;gBACL,MAAM,EAAE;oBACN,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;iBACxF;aACF,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACtC,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrF,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,oBAAoB,CAClC,IAAa,EACb,OAA4B,EAC5B,YAAuC;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,YAAY,GAChB,IAAI,EAAE,YAAY,KAAK,SAAS;QAChC,IAAI,CAAC,OAAO,KAAK,IAAI;QACrB,UAAU,KAAK,SAAS;QACxB,IAAI,CAAC,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,oBAAoB,CACrC,IAAI,EACJ,IAAI,EAAE,OAAO,IAAI,IAAI,EACrB,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EACpC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EACpD,YAAY,CACb,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAA0B,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/D,wEAAwE;IACxE,MAAM,UAAU,GAAG,iBAAiB,CAClC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,oBAAoB,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAC5F,IAAI,EACJ,IAAI,EAAE,KAAK,IAAI,KAAK,CACrB,CAAC;IACF,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IACE,IAAI,KAAK,oBAAoB;QAC7B,IAAI,CAAC,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;QAExE,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,IAAI;YACJ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;SAC9D,CAAC;IACJ,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACxE,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3F,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACxE,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;AAC7F,CAAC"}

package/dist/src/react/core/http-error.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What a server said when it refused a request, read once so every error class of this package
+ * reports it the same way. Bundled into each entry that throws (the root and `/media`), which is
+ * why it holds no class of its own.
+ */
+export interface ErrorAnswer {
+    /** The body, parsed as JSON when it is JSON, else the raw text; `undefined` when empty. */
+    body: unknown;
+    /** `body.message` — a string, or NestJS's list of validation messages joined with `; `. */
+    message: string | undefined;
+    /** `body.code`, the machine-readable reason (`quota_exceeded`, …), when the server sent one. */
+    code: string | undefined;
+}
+/** Read an error answer's body text. Never throws: a body that cannot be read is just absent. */
+export declare function readErrorAnswer(text: string | null | undefined): ErrorAnswer;
+/** {@link readErrorAnswer} over a `Response` whose status is not 2xx. */
+export declare function readErrorResponse(response: Response): Promise<ErrorAnswer>;
+/**
+ * The shape both {@link import('./client.js').AgentHttpError} and `MediaUploadError` share, for
+ * code that handles either without an `instanceof` (the two live in separate bundles).
+ */
+export interface AgentRequestError extends Error {
+    status: number;
+    method: string;
+    path: string;
+    body: unknown;
+    code: string | undefined;
+}
+/** Called with every error answer before it is thrown — for app-wide reactions (401, 402, …). */
+export type HttpErrorListener = (error: AgentRequestError) => void;
+/** Tell `listener` about `error`; a listener that throws never replaces the error itself. */
+export declare function reportHttpError(listener: HttpErrorListener | undefined, error: AgentRequestError): void;
+//# sourceMappingURL=http-error.d.ts.map

package/dist/src/react/core/http-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.d.ts","sourceRoot":"","sources":["../../../../src/react/core/http-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2FAA2F;IAC3F,IAAI,EAAE,OAAO,CAAC;IACd,2FAA2F;IAC3F,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gGAAgG;IAChG,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAqB5E;AAED,yEAAyE;AACzE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAQhF;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,iGAAiG;AACjG,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEnE,6FAA6F;AAC7F,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,KAAK,EAAE,iBAAiB,GACvB,IAAI,CAON"}

package/dist/src/react/core/http-error.js

@@ -0,0 +1,47 @@
+/** Read an error answer's body text. Never throws: a body that cannot be read is just absent. */
+export function readErrorAnswer(text) {
+    if (text == null || text === '')
+        return { body: undefined, message: undefined, code: undefined };
+    let body = text;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        return { body: text, message: undefined, code: undefined };
+    }
+    if (body === null || typeof body !== 'object')
+        return { body, message: undefined, code: undefined };
+    const record = body;
+    const message = typeof record.message === 'string' && record.message !== ''
+        ? record.message
+        : Array.isArray(record.message) &&
+            record.message.length > 0 &&
+            record.message.every((each) => typeof each === 'string')
+            ? record.message.join('; ')
+            : undefined;
+    const code = typeof record.code === 'string' && record.code !== '' ? record.code : undefined;
+    return { body, message, code };
+}
+/** {@link readErrorAnswer} over a `Response` whose status is not 2xx. */
+export async function readErrorResponse(response) {
+    let text;
+    try {
+        text = await response.text();
+    }
+    catch {
+        text = undefined;
+    }
+    return readErrorAnswer(text);
+}
+/** Tell `listener` about `error`; a listener that throws never replaces the error itself. */
+export function reportHttpError(listener, error) {
+    if (listener === undefined)
+        return;
+    try {
+        listener(error);
+    }
+    catch {
+        /* the request's own error is what the caller gets */
+    }
+}
+//# sourceMappingURL=http-error.js.map

package/dist/src/react/core/http-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../../../src/react/core/http-error.ts"],"names":[],"mappings":"AAcA,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,IAA+B;IAC7D,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACjG,IAAI,IAAI,GAAY,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAC3C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,IAA6C,CAAC;IAC7D,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,EAAE;QACzD,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACzB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;YAC1D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAiBD,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAC7B,QAAuC,EACvC,KAAwB;IAExB,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,35 @@
+export type { UiCapabilities } from '../../genui/index.js';
+export type { ChatQueueState, QueuedMessageView, QueuePause, QueuePauseReason, } from '../../index.js';
+export { type AgUiChatStreamOptions, type AgUiContentPart, agUiChatStream, reframeAgUiStream, } from './ag-ui-backend.js';
+export { AgentChatTransport, type AgentChatTransportOptions, type AgentStreamMeta, type ReconnectOptions, type StreamConnectionState, } from './agent-chat-transport.js';
+export { type ApprovalCountdown, approvalCountdown, type UseApprovalCountdownOptions, useApprovalCountdown, } from './approvals/countdown.js';
+export { type ApprovalTarget, proposalNeedsPolling, reconcileProposalMessages, } from './approvals/proposals.js';
+export { type ActionProposalsState, useActionProposals } from './approvals/use-action-proposals.js';
+export { acceptsFile, attachmentFile, dragHasFiles, fileKind, filesFromClipboard, type MessageFile, type MessageFileKind, messageFiles, } from './attachments/files.js';
+export { type AttachmentRejection, type AttachmentsState, type ClipboardLikeEvent, type DragLikeEvent, type StagedAttachment, type StagedAttachmentStatus, type UseAttachmentsOptions, useAttachments, } from './attachments/use-attachments.js';
+export { type AgentBackend, AgentBackendUnsupportedError, type AgentConnection, type AttachmentUploadStrategy, type ChatStreamFile, type ChatStreamRequest, type ChatStreamResponse, type MessageFeedbackInput, type QueuedMessageUpdate, type QueuedSendResult, type ResumeStreamRequest, requireBackendMethod, type UploadAttachmentOptions, } from './backend.js';
+export { type BackgroundRun, backgroundRunsFromThread } from './background-runs.js';
+export { type AgentsState, type UseAgentsOptions, useAgents } from './catalog/use-agents.js';
+export { type ModelOption, type ModelsState, type UseModelsOptions, useModels, } from './catalog/use-models.js';
+export { AgentClient, type AgentClientOptions, AgentHttpError, type AgentRequestError, type CancelResult, type HttpErrorListener, type ThreadPatch, } from './client.js';
+export { type AmbientRenderUi, AmbientRenderUiContext, type AnyToolUIPart, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, formatRelativeTime, loadStoredSpeechLang, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, persistSpeechLang, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseSpeechRecognitionOptions, useAmbientRenderUi, useSpeechRecognition, } from './components/index.js';
+export { type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, applyCompletion, type CompletionEdit, type ComposerAutocomplete, createSkillsSource, filterAutocompleteItems, findActiveTrigger, type SkillSuggestionData, type SkillsSourceOptions, type TriggerMatch, type TriggerPosition, type UseComposerAutocompleteOptions, useComposerAutocomplete, } from './composer/index.js';
+export { type AgentConfigState, type UseAgentConfigOptions, useAgentConfig, } from './config/use-agent-config.js';
+export { type CoercibleQuestion, coerceAnswer, type ElicitationInput, type ElicitationInputType, type RawAnswer, validateAnswer, validateAnswerValue, } from './elicitation/answers.js';
+export { type MessageFeedbackState, type UseMessageFeedbackOptions, useMessageFeedback, } from './feedback/use-message-feedback.js';
+export { fillTemplate, phraseFor, readPath, type ToolCatalog, toolCatalogFrom, } from './presentation/phrasing.js';
+export { inferResultView, type ResolvedReading, type ResolvedResultView, resolveResultView, } from './presentation/result-view.js';
+export { correctedCallIds, type DescribeToolCallOptions, describeToolCall, type GroupToolActivityOptions, groupToolActivity, isActionCall, type ToolActivityGroup, type ToolCallDescription, type ToolCallState, type ToolCallStatus, toolCallState, } from './presentation/tool-activity.js';
+export { ALL_AGENTS, type ToolCatalogState, type UseToolCatalogOptions, useToolCatalog, } from './presentation/use-tool-catalog.js';
+export { AgentProvider, type AgentProviderProps, useAgentBackend } from './provider.js';
+export type { ChatQueue, QueuedChatMessage, SendWhileRunning, WhileRunning, } from './queue/model.js';
+export { type QuotaState, type UseQuotaOptions, useQuota } from './quota/use-quota.js';
+export { formatElapsed, readReasoningMs, type UseElapsedOptions, useElapsed, } from './reasoning/timing.js';
+export { AGENT_RUN_ERROR_CODES, type AgentRunErrorCode, type AgentRunFailure, isRunNotActiveError, RUN_NOT_ACTIVE_CODE, } from './run-errors.js';
+export { storedMessageToUiMessage } from './stored-message-to-ui-message.js';
+export { type AgentMessageMetadata, type AggregatedTurnUsage, type StoredTurnMetadata, storedThreadToUiMessages, } from './stored-thread-to-ui-messages.js';
+export { notifyThreads, onThreadsEvent, type ThreadsEvent, } from './threads/threads-events.js';
+export { type ThreadsState, type UseThreadsOptions, useThreads } from './threads/use-threads.js';
+export { type AnswerInput, type ApprovalBlockOptions, type ApproveInput, type ApproveOptions, type BuildBlocksOptions, buildTranscriptBlocks, type ChatTranscript, describeTimestamp, describeUsage, type EditSubmitInput, type ElicitationBlockOptions, extractMessageText, type MessageActionInput, type RejectInput, type RetrievedPassage, type SettleAction, type SkipInput, type StickToBottom, type StickToBottomOptions, type TimestampInfo, type TranscriptActionState, type TranscriptApproval, type TranscriptApprovalStatus, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptUiBlock, type TranscriptWindow, type UsageSummary, type UseChatTranscriptOptions, type UseTranscriptItemOptions, useChatTranscript, useStickToBottom, useTranscriptItem, } from './transcript/index.js';
+export { type ChatBackground, QuotaBlockedError, type UseAgentChatOptions, useAgentChat, } from './use-agent-chat.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/react/core/index.js

@@ -0,0 +1,34 @@
+export { agUiChatStream, reframeAgUiStream, } from './ag-ui-backend.js';
+export { AgentChatTransport, } from './agent-chat-transport.js';
+export { approvalCountdown, useApprovalCountdown, } from './approvals/countdown.js';
+export { proposalNeedsPolling, reconcileProposalMessages, } from './approvals/proposals.js';
+export { useActionProposals } from './approvals/use-action-proposals.js';
+export { acceptsFile, attachmentFile, dragHasFiles, fileKind, filesFromClipboard, messageFiles, } from './attachments/files.js';
+export { useAttachments, } from './attachments/use-attachments.js';
+export { AgentBackendUnsupportedError, requireBackendMethod, } from './backend.js';
+export { backgroundRunsFromThread } from './background-runs.js';
+export { useAgents } from './catalog/use-agents.js';
+export { useModels, } from './catalog/use-models.js';
+export { AgentClient, AgentHttpError, } from './client.js';
+// Named, never `export *`: a wildcard re-export from a barrel defeats a bundler's ability to see
+// which names a consumer actually uses, and has broken a downstream build in this ecosystem before.
+export { AmbientRenderUiContext, ChatInput, DEFAULT_SPEECH_LANG, formatRelativeTime, loadStoredSpeechLang, MessageItem, MessageItemView, MessageList, persistSpeechLang, SPEECH_LANGUAGES, useAmbientRenderUi, useSpeechRecognition, } from './components/index.js';
+export { applyCompletion, createSkillsSource, filterAutocompleteItems, findActiveTrigger, useComposerAutocomplete, } from './composer/index.js';
+export { useAgentConfig, } from './config/use-agent-config.js';
+export { coerceAnswer, validateAnswer, validateAnswerValue, } from './elicitation/answers.js';
+export { useMessageFeedback, } from './feedback/use-message-feedback.js';
+export { fillTemplate, phraseFor, readPath, toolCatalogFrom, } from './presentation/phrasing.js';
+export { inferResultView, resolveResultView, } from './presentation/result-view.js';
+export { correctedCallIds, describeToolCall, groupToolActivity, isActionCall, toolCallState, } from './presentation/tool-activity.js';
+export { ALL_AGENTS, useToolCatalog, } from './presentation/use-tool-catalog.js';
+export { AgentProvider, useAgentBackend } from './provider.js';
+export { useQuota } from './quota/use-quota.js';
+export { formatElapsed, readReasoningMs, useElapsed, } from './reasoning/timing.js';
+export { AGENT_RUN_ERROR_CODES, isRunNotActiveError, RUN_NOT_ACTIVE_CODE, } from './run-errors.js';
+export { storedMessageToUiMessage } from './stored-message-to-ui-message.js';
+export { storedThreadToUiMessages, } from './stored-thread-to-ui-messages.js';
+export { notifyThreads, onThreadsEvent, } from './threads/threads-events.js';
+export { useThreads } from './threads/use-threads.js';
+export { buildTranscriptBlocks, describeTimestamp, describeUsage, extractMessageText, useChatTranscript, useStickToBottom, useTranscriptItem, } from './transcript/index.js';
+export { QuotaBlockedError, useAgentChat, } from './use-agent-chat.js';
+//# sourceMappingURL=index.js.map

package/dist/src/react/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/react/core/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,GAKnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,iBAAiB,EAEjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAA6B,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACpG,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAGlB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAQL,cAAc,GACf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,4BAA4B,EAU5B,oBAAoB,GAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAA2C,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAIL,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EAEX,cAAc,GAKf,MAAM,aAAa,CAAC;AACrB,iGAAiG;AACjG,oGAAoG;AACpG,OAAO,EAEL,sBAAsB,EAEtB,SAAS,EAGT,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EAGX,eAAe,EAEf,WAAW,EAIX,iBAAiB,EAOjB,gBAAgB,EAIhB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAML,eAAe,EAGf,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EAMjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,YAAY,EAIZ,cAAc,EACd,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,QAAQ,EAER,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EAGf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAEhB,gBAAgB,EAEhB,iBAAiB,EACjB,YAAY,EAKZ,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,UAAU,EAGV,cAAc,GACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAA2B,eAAe,EAAE,MAAM,eAAe,CAAC;AAOxF,OAAO,EAAyC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EACL,aAAa,EACb,eAAe,EAEf,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EAGrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAIL,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,cAAc,GAEf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAA6C,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAML,qBAAqB,EAErB,iBAAiB,EACjB,aAAa,EAGb,kBAAkB,EAsClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,iBAAiB,EAEjB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/src/react/core/markdown/agent-markdown.d.ts

@@ -0,0 +1,39 @@
+import 'katex/dist/katex.min.css';
+import 'streamdown/styles.css';
+import type { ComponentProps } from 'react';
+import { Streamdown } from 'streamdown';
+type StreamdownProps = ComponentProps<typeof Streamdown>;
+export interface AgentMarkdownProps {
+    /** The markdown source (typically the streaming assistant text). */
+    children: string;
+    /**
+     * True while the surrounding chat believes the model is still streaming this message. Streamdown
+     * uses the hint to defer expensive renders (Mermaid, syntax highlighting) until the block settles.
+     */
+    isStreaming?: boolean;
+    /**
+     * Extra remark plugins. This is the seam for app-specific markdown — e.g. flip splices its
+     * `@base:/@user:` mention chips in via a remark plugin + a matching `components` entry here,
+     * keeping that domain logic in the app rather than the library.
+     */
+    remarkPlugins?: StreamdownProps['remarkPlugins'];
+    /** Custom element renderers (keyed by tag name), paired with `remarkPlugins`/`allowedTags`. */
+    components?: StreamdownProps['components'];
+    /** Custom tags (and their attributes) to keep through Streamdown's hardened sanitize schema. */
+    allowedTags?: Record<string, string[]>;
+    /** Tags whose children Streamdown should keep as literal text (not re-parse as markdown). */
+    literalTagContent?: string[];
+}
+/**
+ * The optional rich markdown renderer for agent chat — the exact streamdown stack flip uses
+ * (GFM, KaTeX math, syntax-highlighted code, Mermaid), ported 1:1 but with the flip-specific
+ * mention handling lifted out into the `remarkPlugins`/`components` props so the library stays
+ * domain-agnostic. Lives behind the `@adonis-agora/agent/react/markdown` subpath so the base
+ * package never forces these heavy peers on consumers that don't want them.
+ *
+ * Pass it to a `MessageItem`/`MessageList` `renderText` slot:
+ *   `renderText={(text, { isStreaming }) => <AgentMarkdown isStreaming={isStreaming}>{text}</AgentMarkdown>}`
+ */
+export declare function AgentMarkdown({ children, isStreaming, remarkPlugins, components, allowedTags, literalTagContent, }: AgentMarkdownProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=agent-markdown.d.ts.map

package/dist/src/react/core/markdown/agent-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-markdown.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/markdown/agent-markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,KAAK,eAAe,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IACjD,+FAA+F;IAC/F,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,WAAmB,EACnB,aAAa,EACb,UAAU,EACV,WAAW,EACX,iBAAiB,GAClB,EAAE,kBAAkB,+BAcpB"}

package/dist/src/react/core/markdown/agent-markdown.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import 'katex/dist/katex.min.css';
+import 'streamdown/styles.css';
+import { code } from '@streamdown/code';
+import { math } from '@streamdown/math';
+import { mermaid } from '@streamdown/mermaid';
+import { Streamdown } from 'streamdown';
+const STREAMDOWN_PLUGINS = { code, mermaid, math };
+/**
+ * The optional rich markdown renderer for agent chat — the exact streamdown stack flip uses
+ * (GFM, KaTeX math, syntax-highlighted code, Mermaid), ported 1:1 but with the flip-specific
+ * mention handling lifted out into the `remarkPlugins`/`components` props so the library stays
+ * domain-agnostic. Lives behind the `@adonis-agora/agent/react/markdown` subpath so the base
+ * package never forces these heavy peers on consumers that don't want them.
+ *
+ * Pass it to a `MessageItem`/`MessageList` `renderText` slot:
+ *   `renderText={(text, { isStreaming }) => <AgentMarkdown isStreaming={isStreaming}>{text}</AgentMarkdown>}`
+ */
+export function AgentMarkdown({ children, isStreaming = false, remarkPlugins, components, allowedTags, literalTagContent, }) {
+    return (_jsx(Streamdown, { animated: true, isAnimating: isStreaming, plugins: STREAMDOWN_PLUGINS, ...(remarkPlugins !== undefined ? { remarkPlugins } : {}), ...(components !== undefined ? { components } : {}), ...(allowedTags !== undefined ? { allowedTags } : {}), ...(literalTagContent !== undefined ? { literalTagContent } : {}), children: children }));
+}
+//# sourceMappingURL=agent-markdown.js.map

package/dist/src/react/core/markdown/agent-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-markdown.js","sourceRoot":"","sources":["../../../../../src/react/core/markdown/agent-markdown.tsx"],"names":[],"mappings":";AAAA,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0BxC,MAAM,kBAAkB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAW,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,WAAW,GAAG,KAAK,EACnB,aAAa,EACb,UAAU,EACV,WAAW,EACX,iBAAiB,GACE;IACnB,OAAO,CACL,KAAC,UAAU,IACT,QAAQ,QACR,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,kBAAkB,KACvB,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACtD,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAChD,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAClD,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAEjE,QAAQ,GACE,CACd,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export { AgentMarkdown, type AgentMarkdownProps } from './agent-markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/react/core/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/markdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/react/core/markdown/index.js

@@ -0,0 +1,2 @@
+export { AgentMarkdown } from './agent-markdown.js';
+//# sourceMappingURL=index.js.map

package/dist/src/react/core/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/react/core/markdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,64 @@
+import type { MessageAttachment } from '../../../index.js';
+import type { AttachmentUploadStrategy, UploadAttachmentOptions } from '../backend.js';
+import { type AgentClientOptions } from '../client.js';
+import { type AgentRequestError, type ErrorAnswer } from '../http-error.js';
+/** Tuning for {@link mediaAttachments}; every field optional. */
+export interface MediaAttachmentsOptions {
+    /** Bytes per tus `PATCH`. Default 5 MiB. */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/**
+ * Resumable attachment uploads through `@adonis-agora/media`, in one line:
+ *
+ * ```tsx
+ * <AgentProvider attachments={{ upload: mediaAttachments() }}>
+ * ```
+ *
+ * Reuses the client's own connection (origin, path, headers, credentials), so it needs no
+ * configuration. Also takes `new AgentClient({ attachments: { upload: mediaAttachments() } })`.
+ */
+export declare function mediaAttachments(options?: MediaAttachmentsOptions): AttachmentUploadStrategy;
+/**
+ * Where and how {@link createMediaUpload} talks to the server. The connection fields are
+ * {@link AgentClientOptions}' — pass the same ones your `AgentClient` gets, so the tus requests
+ * carry the same cookies / CSRF header / bearer token as the rest of the chat.
+ */
+export interface MediaUploadOptions extends AgentClientOptions {
+    /** Bytes per tus `PATCH`. Default 5 MiB (the default). */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/** What `useAttachments({ upload })` and `AgentBackend.uploadAttachment` both take. */
+export type AttachmentUpload = (file: File, options?: UploadAttachmentOptions) => Promise<MessageAttachment>;
+/**
+ * A non-2xx answer from the agent's upload routes. Carries what `AgentHttpError` does — `status`
+ * (413 too large, 415 type refused, 404 not yours), the server's `message`, `code` and `body` —
+ * as its own class because this subpath is bundled apart from the root entry, where an
+ * `instanceof AgentHttpError` would not match a copy. Both satisfy `AgentRequestError`.
+ */
+export declare class MediaUploadError extends Error implements AgentRequestError {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    readonly body: unknown;
+    readonly code: string | undefined;
+    constructor(status: number, method: string, path: string, statusText: string, answer?: ErrorAnswer);
+}
+/**
+ * A resumable `upload` for `useAttachments`, backed by `@adonis-agora/media` on the server
+ * (`MediaAttachmentStaging` from `@adonis-agora/agent/media`):
+ *
+ * 1. `POST <path>/attachments/uploads` — the agent validates the file and opens a tus session the
+ *    actor owns;
+ * 2. the bytes stream to the media adapter’s own tus endpoint in chunks (`streamChunks`), reporting
+ *    progress and honouring the abort signal;
+ * 3. `POST <path>/attachments/uploads/:mediaId/complete` — the agent confirms the bytes landed and
+ *    answers the `MessageAttachment` the turn will reference by `mediaId`.
+ *
+ * An aborted or failed upload is discarded server-side (`DELETE`), best effort.
+ */
+export declare function createMediaUpload(options?: MediaUploadOptions): AttachmentUpload;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/react/core/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,iEAAiE;AACjE,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,wBAAwB,CAWhG;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,iBAAiB;IAKpE,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IANvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,YACW,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,WAAsE,EAQ/E;CACF;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,CAkFpF"}