@box-kite/react 2.0.1 → 2.2.0

package/interop.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./specDefs.cjs"),t=require("./specData.cjs");var n;(function(e){let t={"input-streaming":`pending`,"input-available":`running`,"output-available":`success`,"output-error":`error`,"approval-requested":`approval`,"approval-responded":`approval`},n={inProgress:`pending`,executing:`running`,complete:`success`},r={running:`running`,complete:`success`,incomplete:`error`,"requires-action":`pending`};function i(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:null}function a(e){return typeof e==`string`&&e!==``?e:void 0}function o(e){return e.input??e.args??e.argsText}function s(e){return e.output??e.result}function c(e){let c=i(e);if(c===null)return null;let l=o(c),u=s(c),d=a(c.state);if(d!==void 0&&d in t){let e=t[d];if(e!==`approval`)return{kind:`call`,status:e,decision:null,input:l,output:u,error:a(c.errorText)};let n=i(c.approval)?.approved;return{kind:`approval`,status:`pending`,decision:typeof n==`boolean`?n?`approved`:`rejected`:null,input:l}}let f=c.status,p=i(f);if(p!==null){let e=a(p.type)??``;return{kind:e===`requires-action`?`approval`:`call`,status:r[e]??`pending`,decision:null,input:l,output:u,error:a(i(p.error)?.message)??a(p.error)}}let m=a(f);if(m!==void 0&&m in n){let e=typeof c.respond==`function`&&m===`executing`;return{kind:e?`approval`:`call`,status:e?`pending`:n[m],decision:null,input:l,output:u}}return null}e.toolPart=c;function l(e,t){let n=i(t),r=a(n?.toolCallId);if(n===null||r===void 0)return e;let o=a(n.type),s=e[r]??{kind:`call`,status:`pending`,decision:null};return o===`TOOL_CALL_START`?{...e,[r]:{...s,kind:`call`,status:`pending`}}:o===`TOOL_CALL_ARGS`?{...e,[r]:{...s,status:`pending`}}:o===`TOOL_CALL_END`?{...e,[r]:{...s,status:`running`}}:o===`TOOL_CALL_RESULT`?{...e,[r]:{...s,status:`success`,output:n.content??n.result}}:o===`INTERRUPT`||o===`RUN_INTERRUPT`?{...e,[r]:{...s,kind:`approval`,status:`pending`}}:o===`RUN_ERROR`?{...e,[r]:{...s,status:`error`,error:a(n.message)}}:e}e.applyEvent=l})(n||={});var r=n,i;(function(t){let n=t.ROOT_ID=`root`,r=t.DEFAULT_SURFACE=`main`;t.EMPTY={surfaces:{},order:[]};function i(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:null}function a(e){return typeof e==`string`&&e!==``?e:void 0}function o(e){return{id:e,components:{},data:{}}}function s(e,t,n){return{surfaces:{...e.surfaces,[t]:n},order:e.order.includes(t)?e.order:[...e.order,t]}}function c(e){let t=i(e),n=a(t?.id);if(t===null||n===void 0)return null;let r=t.component;if(typeof r==`string`){let{id:e,component:i,...a}=t;return{id:n,component:r,...a}}let o=i(r),[s]=o?Object.keys(o):[];return o===null||s===void 0?null:{id:n,component:s,...i(o[s])??{}}}function l(e){return e.replace(/~1/g,`/`).replace(/~0/g,`~`)}function u(e){return e===void 0||e===``||e===`/`?[]:(e.startsWith(`/`)?e.slice(1):e).split(`/`).map(l)}function d(e,t){return t.reduce((e,t)=>i(e)?.[t],e)}function f(e,t,n){if(t.length===0)return n;let[r,...a]=t,o=i(e)??{};if(a.length>0)return{...o,[r]:f(o[r],a,n)};if(n!==void 0)return{...o,[r]:n};let{[r]:s,...c}=o;return c}function p(e){if(!Array.isArray(e))return{};let t={};for(let n of e){let e=i(n),r=a(e?.key);e!==null&&r!==void 0&&(`valueString`in e?t[r]=e.valueString:`valueNumber`in e?t[r]=e.valueNumber:`valueBoolean`in e?t[r]=e.valueBoolean:`valueMap`in e&&(t[r]=p(e.valueMap)))}return t}function m(e,t){let n=i(t);if(n===null)return e;let l=i(n.createSurface)??i(n.beginRendering);if(l!==null){let t=a(l.surfaceId)??r,n=e.surfaces[t]??o(t);return s(e,t,{...n,catalogId:a(l.catalogId)??n.catalogId,root:a(l.root)??n.root,theme:i(l.theme)??i(l.styles)??n.theme})}let m=i(n.updateComponents)??i(n.surfaceUpdate);if(m!==null){let t=a(m.surfaceId)??r,n=e.surfaces[t]??o(t),i={...n.components},l=!1;for(let e of Array.isArray(m.components)?m.components:[]){let t=c(e);t!==null&&(i[t.id]=t,l=!0)}return l||!e.surfaces[t]?s(e,t,{...n,components:i}):e}let h=i(n.updateDataModel)??i(n.dataModelUpdate);if(h!==null){let t=a(h.surfaceId)??r,n=e.surfaces[t]??o(t),c=u(a(h.path)),l=`contents`in h?{...i(d(n.data,c))??{},...p(h.contents)}:void 0,m=f(n.data,c,l??h.value);return s(e,t,{...n,data:i(m)??{}})}let g=i(n.deleteSurface);if(g!==null){let t=a(g.surfaceId)??r;if(!e.surfaces[t])return e;let{[t]:n,...i}=e.surfaces;return{surfaces:i,order:e.order.filter(e=>e!==t)}}return e}t.apply=m;function h(e,t){return t.reduce(m,e)}t.applyAll=h;function g(e,t){return t===void 0?e.surfaces[e.order[0]]??null:e.surfaces[t]??null}t.surface=g;function _(e){let t=i(e);return t===null?e:`literalString`in t?t.literalString:`literalNumber`in t?t.literalNumber:`literalBoolean`in t?t.literalBoolean:typeof t.path==`string`?{$data:t.path}:e}function v(e){let t=i(e);return t===null?a(e):a(i(t.event)?.name)??a(t.name)}function y(e){let t=a(e.child);if(t!==void 0)return{ids:[t]};let n=e.children;if(Array.isArray(n))return{ids:n.filter(e=>typeof e==`string`)};let r=i(n);if(r===null)return{ids:[]};if(Array.isArray(r.explicitList))return{ids:r.explicitList.filter(e=>typeof e==`string`)};let o=i(r.template)??r,s=a(o.componentId),c=a(o.path)??a(o.dataBinding);return s!==void 0&&c!==void 0?{ids:[],template:{componentId:s,path:c}}:{ids:[]}}let b=new Set([`id`,`component`,`child`,`children`,`action`]);function x(e,t,n,r,i){let a=e.components[t];if(a===void 0||i>32||r.has(t))return null;let o=new Set(n.catalog?.components[a.component]?.events??[]),s={},c={};for(let[e,t]of Object.entries(a)){if(b.has(e))continue;if(!o.has(e)){s[e]=_(t);continue}let n=v(t);n!==void 0&&(c[e]=n)}let l=v(a.action);l!==void 0&&(c.action=l);let{ids:u,template:d}=y(a),f=new Set([...r,t]),p=[];for(let t of u){let r=x(e,t,n,f,i+1);r!==null&&p.push(r)}if(d!==void 0){let t=x(e,d.componentId,n,f,i+1);t!==null&&p.push({...t,repeat:{$data:d.path}})}return{type:a.component,key:t,...Object.keys(s).length?{props:s}:{},...p.length?{children:p}:{},...Object.keys(c).length?{on:c}:{}}}function S(e,t={}){return e===null?null:x(e,t.root??e.root??n,t,new Set,0)}t.toSpec=S;let C={type:`array`,items:{type:`string`},description:`The ids of this component’s children, each a component of its own in the same surface.`},w={type:`string`,description:`The name of an action the host handles.`};function T(e,t){let n=i(i(e.components)?.[t]);if(n===null)return null;let r=i(e.$defs);return r===null?n:{...n,$defs:r}}t.componentSchema=T;function E(t,n={}){let r=n.catalogId??`urn:box-kite:catalog:${t.version}`,i={},a={};for(let[n,r]of Object.entries(t.components)){let t=e.t.hoist(r.props,i);a[n]={type:`object`,description:r.description,properties:{id:{type:`string`,description:`This component’s id, unique within the surface.`},component:{type:`string`,enum:[n]},...t.properties??{},...Object.fromEntries(r.events.map(e=>[e,w])),...r.slots.length?{children:C}:{}},required:[`id`,`component`,...t.required??[]],additionalProperties:!1}}return{$schema:`https://json-schema.org/draft/2020-12/schema`,$id:r,catalogId:r,title:n.title??`${t.library} catalog`,description:n.description??t.rules.join(` `),...Object.keys(i).length?{$defs:i}:{},components:a}}t.catalogDocument=E})(i||={});var a=i,o;(function(e){function n(e,t){if(typeof e==`string`)return e;if(t>32||typeof e!=`object`||!e||typeof e.component!=`string`)return null;let r=(e.children??[]).map(e=>n(e,t+1)).filter(e=>e!==null);return{type:e.component,...e.key===void 0?{}:{key:e.key},...e.props?{props:e.props}:{},...r.length?{children:r}:{}}}function r(e){return e==null?[]:(Array.isArray(e.root)?e.root:[e.root]).map(e=>n(e,0)).filter(e=>typeof e==`object`&&!!e)}e.toSpec=r;function i(e,n,r,a){if(e==null)return null;if(typeof e==`string`)return e;if(typeof e==`number`||typeof e==`boolean`)return String(e);if(t.t.isRef(e))return r.push({code:`data-binding`,path:n}),null;if(a>32||typeof e.type!=`string`)return null;let o=e;if(o.repeat&&r.push({code:`repeat`,path:n}),o.on)for(let e of Object.keys(o.on))r.push({code:`event`,path:`${n}.on.${e}`});let s=(o.children===void 0?[]:Array.isArray(o.children)?o.children:[o.children]).map((e,t)=>i(e,`${n}.children.${t}`,r,a+1)).filter(e=>e!==null);return{component:o.type,...o.key===void 0?{}:{key:o.key},...o.props?{props:o.props}:{},...s.length?{children:s}:{}}}function a(e){let t=[];return{spec:{root:(Array.isArray(e)?e:[e]).map((e,n)=>i(e,`root.${n}`,t,0)).filter(e=>e!==null)},losses:t}}e.fromSpec=a})(o||={});var s=o,c=r.toolPart,l=r.applyEvent,u=a.apply,d=a.applyAll,f=a.surface,p=a.toSpec,m=a.catalogDocument,h=a.componentSchema,g=a.EMPTY,_=s.toSpec,v=s.fromSpec;exports.A2uiInterop=a,exports.AssistantUiInterop=s,exports.ToolInterop=r,exports.a2uiApply=u,exports.a2uiApplyAll=d,exports.a2uiCatalog=m,exports.a2uiComponentSchema=h,exports.a2uiEmpty=g,exports.a2uiSurface=f,exports.a2uiToSpec=p,exports.applyToolEvent=l,exports.fromGenerativeUi=_,exports.toGenerativeUi=v,exports.toolPart=c;

package/interop.d.ts

@@ -0,0 +1,51 @@
+import { default as A2uiInterop } from './utils/interop/a2uiInterop';
+import { default as AssistantUiInterop } from './utils/interop/assistantUiInterop';
+import { default as ToolInterop } from './utils/interop/toolInterop';
+/**
+ * `@box-kite/react/interop` — the agentic runtimes, in this library's shapes.
+ *
+ * ```ts
+ * import { toolPart, a2uiSurface, a2uiToSpec } from '@box-kite/react/interop';
+ *
+ * const part = toolPart(message);                        // AI SDK, assistant-ui or CopilotKit
+ * const spec = a2uiToSpec(a2uiSurface(state), { catalog }); // an A2UI stream, as a <SpecRenderer> tree
+ * ```
+ *
+ * Four runtimes generate UI and ask for permission, and every one of them describes the same two things
+ * — a tool call, and a tree of components — in words of its own. What ships here is the half this
+ * library owns: the mapping, framework-free, with no dependency on any of them. An adapter that pulled
+ * in a runtime would be choosing it for the app, and the app has already chosen.
+ *
+ * Its own entry, and it carries neither the engine nor React: a route handler building an agent's
+ * catalog and a client folding its messages both import from here, and neither pays for the other.
+ *
+ * `docs/interop.md` has the recipe per runtime, json-render and AG-UI included.
+ */
+export { default as ToolInterop } from './utils/interop/toolInterop';
+export type { ToolPart, ToolPartKind } from './utils/interop/toolInterop';
+export { default as A2uiInterop } from './utils/interop/a2uiInterop';
+export type { A2uiCatalogOptions, A2uiComponent, A2uiSpecOptions, A2uiState, A2uiSurface } from './utils/interop/a2uiInterop';
+export { default as AssistantUiInterop } from './utils/interop/assistantUiInterop';
+export type { GenerativeUiLoss, GenerativeUiNode, GenerativeUiSpec } from './utils/interop/assistantUiInterop';
+export type { ApprovalDecision, ToolCallStatus } from './utils/agent/agentUtils';
+export type { SpecNode } from './utils/spec/specTypes';
+/** Where a tool call is, from whichever of the three runtimes handed you the part. */
+export declare const toolPart: typeof ToolInterop.toolPart;
+/** AG-UI reports events rather than parts, so its cards are a fold: one call per event, oldest first. */
+export declare const applyToolEvent: typeof ToolInterop.applyEvent;
+/** One A2UI message folded into the surfaces it names. Pure, and the same state back when nothing moved. */
+export declare const a2uiApply: typeof A2uiInterop.apply;
+export declare const a2uiApplyAll: typeof A2uiInterop.applyAll;
+/** A surface by id, or the first one the agent opened. */
+export declare const a2uiSurface: typeof A2uiInterop.surface;
+/** A surface's adjacency list as one `<SpecRenderer>` tree. */
+export declare const a2uiToSpec: typeof A2uiInterop.toSpec;
+/** `catalog()` as an A2UI catalog document — what an agent generates against. */
+export declare const a2uiCatalog: typeof A2uiInterop.catalogDocument;
+/** One component of that document, self-contained: a `$ref` resolves against the document, not the part. */
+export declare const a2uiComponentSchema: typeof A2uiInterop.componentSchema;
+/** The state an A2UI fold starts from. */
+export declare const a2uiEmpty: import('./interop').A2uiState;
+/** assistant-ui's generative-UI spec as ours, and back. */
+export declare const fromGenerativeUi: typeof AssistantUiInterop.toSpec;
+export declare const toGenerativeUi: typeof AssistantUiInterop.fromSpec;

package/interop.mjs

@@ -0,0 +1,454 @@
+import { t as e } from "./specDefs.mjs";
+import { t } from "./specData.mjs";
+//#region src/utils/interop/toolInterop.ts
+var n;
+(function(e) {
+	let t = {
+		"input-streaming": "pending",
+		"input-available": "running",
+		"output-available": "success",
+		"output-error": "error",
+		"approval-requested": "approval",
+		"approval-responded": "approval"
+	}, n = {
+		inProgress: "pending",
+		executing: "running",
+		complete: "success"
+	}, r = {
+		running: "running",
+		complete: "success",
+		incomplete: "error",
+		"requires-action": "pending"
+	};
+	function i(e) {
+		return typeof e == "object" && e && !Array.isArray(e) ? e : null;
+	}
+	function a(e) {
+		return typeof e == "string" && e !== "" ? e : void 0;
+	}
+	function o(e) {
+		return e.input ?? e.args ?? e.argsText;
+	}
+	function s(e) {
+		return e.output ?? e.result;
+	}
+	function c(e) {
+		let c = i(e);
+		if (c === null) return null;
+		let l = o(c), u = s(c), d = a(c.state);
+		if (d !== void 0 && d in t) {
+			let e = t[d];
+			if (e !== "approval") return {
+				kind: "call",
+				status: e,
+				decision: null,
+				input: l,
+				output: u,
+				error: a(c.errorText)
+			};
+			let n = i(c.approval)?.approved;
+			return {
+				kind: "approval",
+				status: "pending",
+				decision: typeof n == "boolean" ? n ? "approved" : "rejected" : null,
+				input: l
+			};
+		}
+		let f = c.status, p = i(f);
+		if (p !== null) {
+			let e = a(p.type) ?? "";
+			return {
+				kind: e === "requires-action" ? "approval" : "call",
+				status: r[e] ?? "pending",
+				decision: null,
+				input: l,
+				output: u,
+				error: a(i(p.error)?.message) ?? a(p.error)
+			};
+		}
+		let m = a(f);
+		if (m !== void 0 && m in n) {
+			let e = typeof c.respond == "function" && m === "executing";
+			return {
+				kind: e ? "approval" : "call",
+				status: e ? "pending" : n[m],
+				decision: null,
+				input: l,
+				output: u
+			};
+		}
+		return null;
+	}
+	e.toolPart = c;
+	function l(e, t) {
+		let n = i(t), r = a(n?.toolCallId);
+		if (n === null || r === void 0) return e;
+		let o = a(n.type), s = e[r] ?? {
+			kind: "call",
+			status: "pending",
+			decision: null
+		};
+		return o === "TOOL_CALL_START" ? {
+			...e,
+			[r]: {
+				...s,
+				kind: "call",
+				status: "pending"
+			}
+		} : o === "TOOL_CALL_ARGS" ? {
+			...e,
+			[r]: {
+				...s,
+				status: "pending"
+			}
+		} : o === "TOOL_CALL_END" ? {
+			...e,
+			[r]: {
+				...s,
+				status: "running"
+			}
+		} : o === "TOOL_CALL_RESULT" ? {
+			...e,
+			[r]: {
+				...s,
+				status: "success",
+				output: n.content ?? n.result
+			}
+		} : o === "INTERRUPT" || o === "RUN_INTERRUPT" ? {
+			...e,
+			[r]: {
+				...s,
+				kind: "approval",
+				status: "pending"
+			}
+		} : o === "RUN_ERROR" ? {
+			...e,
+			[r]: {
+				...s,
+				status: "error",
+				error: a(n.message)
+			}
+		} : e;
+	}
+	e.applyEvent = l;
+})(n ||= {});
+var r = n, i;
+(function(t) {
+	let n = t.ROOT_ID = "root", r = t.DEFAULT_SURFACE = "main";
+	t.EMPTY = {
+		surfaces: {},
+		order: []
+	};
+	function i(e) {
+		return typeof e == "object" && e && !Array.isArray(e) ? e : null;
+	}
+	function a(e) {
+		return typeof e == "string" && e !== "" ? e : void 0;
+	}
+	function o(e) {
+		return {
+			id: e,
+			components: {},
+			data: {}
+		};
+	}
+	function s(e, t, n) {
+		return {
+			surfaces: {
+				...e.surfaces,
+				[t]: n
+			},
+			order: e.order.includes(t) ? e.order : [...e.order, t]
+		};
+	}
+	function c(e) {
+		let t = i(e), n = a(t?.id);
+		if (t === null || n === void 0) return null;
+		let r = t.component;
+		if (typeof r == "string") {
+			let { id: e, component: i, ...a } = t;
+			return {
+				id: n,
+				component: r,
+				...a
+			};
+		}
+		let o = i(r), [s] = o ? Object.keys(o) : [];
+		return o === null || s === void 0 ? null : {
+			id: n,
+			component: s,
+			...i(o[s]) ?? {}
+		};
+	}
+	function l(e) {
+		return e.replace(/~1/g, "/").replace(/~0/g, "~");
+	}
+	function u(e) {
+		return e === void 0 || e === "" || e === "/" ? [] : (e.startsWith("/") ? e.slice(1) : e).split("/").map(l);
+	}
+	function d(e, t) {
+		return t.reduce((e, t) => i(e)?.[t], e);
+	}
+	function f(e, t, n) {
+		if (t.length === 0) return n;
+		let [r, ...a] = t, o = i(e) ?? {};
+		if (a.length > 0) return {
+			...o,
+			[r]: f(o[r], a, n)
+		};
+		if (n !== void 0) return {
+			...o,
+			[r]: n
+		};
+		let { [r]: s, ...c } = o;
+		return c;
+	}
+	function p(e) {
+		if (!Array.isArray(e)) return {};
+		let t = {};
+		for (let n of e) {
+			let e = i(n), r = a(e?.key);
+			e !== null && r !== void 0 && ("valueString" in e ? t[r] = e.valueString : "valueNumber" in e ? t[r] = e.valueNumber : "valueBoolean" in e ? t[r] = e.valueBoolean : "valueMap" in e && (t[r] = p(e.valueMap)));
+		}
+		return t;
+	}
+	function m(e, t) {
+		let n = i(t);
+		if (n === null) return e;
+		let l = i(n.createSurface) ?? i(n.beginRendering);
+		if (l !== null) {
+			let t = a(l.surfaceId) ?? r, n = e.surfaces[t] ?? o(t);
+			return s(e, t, {
+				...n,
+				catalogId: a(l.catalogId) ?? n.catalogId,
+				root: a(l.root) ?? n.root,
+				theme: i(l.theme) ?? i(l.styles) ?? n.theme
+			});
+		}
+		let m = i(n.updateComponents) ?? i(n.surfaceUpdate);
+		if (m !== null) {
+			let t = a(m.surfaceId) ?? r, n = e.surfaces[t] ?? o(t), i = { ...n.components }, l = !1;
+			for (let e of Array.isArray(m.components) ? m.components : []) {
+				let t = c(e);
+				t !== null && (i[t.id] = t, l = !0);
+			}
+			return l || !e.surfaces[t] ? s(e, t, {
+				...n,
+				components: i
+			}) : e;
+		}
+		let h = i(n.updateDataModel) ?? i(n.dataModelUpdate);
+		if (h !== null) {
+			let t = a(h.surfaceId) ?? r, n = e.surfaces[t] ?? o(t), c = u(a(h.path)), l = "contents" in h ? {
+				...i(d(n.data, c)) ?? {},
+				...p(h.contents)
+			} : void 0, m = f(n.data, c, l ?? h.value);
+			return s(e, t, {
+				...n,
+				data: i(m) ?? {}
+			});
+		}
+		let g = i(n.deleteSurface);
+		if (g !== null) {
+			let t = a(g.surfaceId) ?? r;
+			if (!e.surfaces[t]) return e;
+			let { [t]: n, ...i } = e.surfaces;
+			return {
+				surfaces: i,
+				order: e.order.filter((e) => e !== t)
+			};
+		}
+		return e;
+	}
+	t.apply = m;
+	function h(e, t) {
+		return t.reduce(m, e);
+	}
+	t.applyAll = h;
+	function g(e, t) {
+		return t === void 0 ? e.surfaces[e.order[0]] ?? null : e.surfaces[t] ?? null;
+	}
+	t.surface = g;
+	function _(e) {
+		let t = i(e);
+		return t === null ? e : "literalString" in t ? t.literalString : "literalNumber" in t ? t.literalNumber : "literalBoolean" in t ? t.literalBoolean : typeof t.path == "string" ? { $data: t.path } : e;
+	}
+	function v(e) {
+		let t = i(e);
+		return t === null ? a(e) : a(i(t.event)?.name) ?? a(t.name);
+	}
+	function y(e) {
+		let t = a(e.child);
+		if (t !== void 0) return { ids: [t] };
+		let n = e.children;
+		if (Array.isArray(n)) return { ids: n.filter((e) => typeof e == "string") };
+		let r = i(n);
+		if (r === null) return { ids: [] };
+		if (Array.isArray(r.explicitList)) return { ids: r.explicitList.filter((e) => typeof e == "string") };
+		let o = i(r.template) ?? r, s = a(o.componentId), c = a(o.path) ?? a(o.dataBinding);
+		return s !== void 0 && c !== void 0 ? {
+			ids: [],
+			template: {
+				componentId: s,
+				path: c
+			}
+		} : { ids: [] };
+	}
+	let b = /* @__PURE__ */ new Set([
+		"id",
+		"component",
+		"child",
+		"children",
+		"action"
+	]);
+	function x(e, t, n, r, i) {
+		let a = e.components[t];
+		if (a === void 0 || i > 32 || r.has(t)) return null;
+		let o = new Set(n.catalog?.components[a.component]?.events ?? []), s = {}, c = {};
+		for (let [e, t] of Object.entries(a)) {
+			if (b.has(e)) continue;
+			if (!o.has(e)) {
+				s[e] = _(t);
+				continue;
+			}
+			let n = v(t);
+			n !== void 0 && (c[e] = n);
+		}
+		let l = v(a.action);
+		l !== void 0 && (c.action = l);
+		let { ids: u, template: d } = y(a), f = /* @__PURE__ */ new Set([...r, t]), p = [];
+		for (let t of u) {
+			let r = x(e, t, n, f, i + 1);
+			r !== null && p.push(r);
+		}
+		if (d !== void 0) {
+			let t = x(e, d.componentId, n, f, i + 1);
+			t !== null && p.push({
+				...t,
+				repeat: { $data: d.path }
+			});
+		}
+		return {
+			type: a.component,
+			key: t,
+			...Object.keys(s).length ? { props: s } : {},
+			...p.length ? { children: p } : {},
+			...Object.keys(c).length ? { on: c } : {}
+		};
+	}
+	function S(e, t = {}) {
+		return e === null ? null : x(e, t.root ?? e.root ?? n, t, /* @__PURE__ */ new Set(), 0);
+	}
+	t.toSpec = S;
+	let C = {
+		type: "array",
+		items: { type: "string" },
+		description: "The ids of this component’s children, each a component of its own in the same surface."
+	}, w = {
+		type: "string",
+		description: "The name of an action the host handles."
+	};
+	function T(e, t) {
+		let n = i(i(e.components)?.[t]);
+		if (n === null) return null;
+		let r = i(e.$defs);
+		return r === null ? n : {
+			...n,
+			$defs: r
+		};
+	}
+	t.componentSchema = T;
+	function E(t, n = {}) {
+		let r = n.catalogId ?? `urn:box-kite:catalog:${t.version}`, i = {}, a = {};
+		for (let [n, r] of Object.entries(t.components)) {
+			let t = e.hoist(r.props, i);
+			a[n] = {
+				type: "object",
+				description: r.description,
+				properties: {
+					id: {
+						type: "string",
+						description: "This component’s id, unique within the surface."
+					},
+					component: {
+						type: "string",
+						enum: [n]
+					},
+					...t.properties ?? {},
+					...Object.fromEntries(r.events.map((e) => [e, w])),
+					...r.slots.length ? { children: C } : {}
+				},
+				required: [
+					"id",
+					"component",
+					...t.required ?? []
+				],
+				additionalProperties: !1
+			};
+		}
+		return {
+			$schema: "https://json-schema.org/draft/2020-12/schema",
+			$id: r,
+			catalogId: r,
+			title: n.title ?? `${t.library} catalog`,
+			description: n.description ?? t.rules.join(" "),
+			...Object.keys(i).length ? { $defs: i } : {},
+			components: a
+		};
+	}
+	t.catalogDocument = E;
+})(i ||= {});
+var a = i, o;
+(function(e) {
+	function n(e, t) {
+		if (typeof e == "string") return e;
+		if (t > 32 || typeof e != "object" || !e || typeof e.component != "string") return null;
+		let r = (e.children ?? []).map((e) => n(e, t + 1)).filter((e) => e !== null);
+		return {
+			type: e.component,
+			...e.key === void 0 ? {} : { key: e.key },
+			...e.props ? { props: e.props } : {},
+			...r.length ? { children: r } : {}
+		};
+	}
+	function r(e) {
+		return e == null ? [] : (Array.isArray(e.root) ? e.root : [e.root]).map((e) => n(e, 0)).filter((e) => typeof e == "object" && !!e);
+	}
+	e.toSpec = r;
+	function i(e, n, r, a) {
+		if (e == null) return null;
+		if (typeof e == "string") return e;
+		if (typeof e == "number" || typeof e == "boolean") return String(e);
+		if (t.isRef(e)) return r.push({
+			code: "data-binding",
+			path: n
+		}), null;
+		if (a > 32 || typeof e.type != "string") return null;
+		let o = e;
+		if (o.repeat && r.push({
+			code: "repeat",
+			path: n
+		}), o.on) for (let e of Object.keys(o.on)) r.push({
+			code: "event",
+			path: `${n}.on.${e}`
+		});
+		let s = (o.children === void 0 ? [] : Array.isArray(o.children) ? o.children : [o.children]).map((e, t) => i(e, `${n}.children.${t}`, r, a + 1)).filter((e) => e !== null);
+		return {
+			component: o.type,
+			...o.key === void 0 ? {} : { key: o.key },
+			...o.props ? { props: o.props } : {},
+			...s.length ? { children: s } : {}
+		};
+	}
+	function a(e) {
+		let t = [];
+		return {
+			spec: { root: (Array.isArray(e) ? e : [e]).map((e, n) => i(e, `root.${n}`, t, 0)).filter((e) => e !== null) },
+			losses: t
+		};
+	}
+	e.fromSpec = a;
+})(o ||= {});
+var s = o, c = r.toolPart, l = r.applyEvent, u = a.apply, d = a.applyAll, f = a.surface, p = a.toSpec, m = a.catalogDocument, h = a.componentSchema, g = a.EMPTY, _ = s.toSpec, v = s.fromSpec;
+//#endregion
+export { a as A2uiInterop, s as AssistantUiInterop, r as ToolInterop, u as a2uiApply, d as a2uiApplyAll, m as a2uiCatalog, h as a2uiComponentSchema, g as a2uiEmpty, f as a2uiSurface, p as a2uiToSpec, l as applyToolEvent, _ as fromGenerativeUi, v as toGenerativeUi, c as toolPart };

package/layer.cjs

@@ -1 +1 @@
-const e=require("./platform.cjs"),t=require("./effects.cjs"),n=require("./behavior.cjs"),r=require("./identity.cjs");let i=require("react");function a(a){let{haspopup:o,id:s,idPrefix:c,open:l,defaultOpen:u=!1,onOpenChange:d,onOpened:f,onClosing:p,inside:m}=a,h=r.t(c),g=s??h,[_,v]=n.i({value:l,defaultValue:u,onChange:d}),[y,b]=(0,i.useState)(null),[x,S]=(0,i.useState)(null),[C,w]=(0,i.useState)(!0),[T,E]=(0,i.useState)(!1),[D,O]=(0,i.useState)(),k=(0,i.useRef)(`imperative`),A=(0,i.useRef)(!1);t.n(()=>{e.a()||w(!1)},[]);let j=n.a(f),M=n.a(p),N=n.a(e=>{let t=e.newState===`open`,n=e.currentTarget;if(t&&l===!1){e.preventDefault();return}t||(A.current=n.contains(document.activeElement),M(A.current,y)),E(t);let r=t?`trigger`:k.current;k.current=`imperative`,v(t,{reason:r,event:e})}),P=n.a(e=>{let t=e.currentTarget;e.newState===`open`&&j(t)});t.n(()=>{if(!C||!x)return;let e=new AbortController;return x.addEventListener(`beforetoggle`,N,{signal:e.signal}),x.addEventListener(`toggle`,P,{signal:e.signal}),()=>e.abort()},[C,x,N,P]),t.n(()=>{!C||!x||_===T||(_?x.showPopover():x.hidePopover())},[_,T,x,C]),t.n(()=>{if(!C||!_)return;let t=new AbortController,n=(e,n)=>document.addEventListener(e,n,{signal:t.signal,capture:!0});return n(`keydown`,e=>{e.key===`Escape`&&(k.current=`escape`)}),n(`pointerdown`,t=>{let n=!!y&&e.l(t,[y]);k.current=n?`trigger`:`outside-pointer`}),()=>t.abort()},[C,_,y]),t.n(()=>{y&&(y.id||y.setAttribute(`id`,`${g}-trigger`),O(y.id))},[y,g]),t.n(()=>{if(!(!C||!y))return y.setAttribute(`popovertarget`,g),()=>y.removeAttribute(`popovertarget`)},[C,y,g]),t.n(()=>{C||!_||!x||j(x)},[C,_,x,j]),n.r({enabled:!C&&_,inside:[x,y,...m??[]],onDismiss:(e,t)=>v(!1,{reason:e,event:t})}),n.n({enabled:!C&&_,returnTo:y});let F=n.a(e=>{v(e=>!e,{reason:`trigger`,event:e})});return{platform:C,isOpen:_,setOpen:v,id:g,trigger:(0,i.useMemo)(()=>({ref:b,props:{"aria-expanded":_,"aria-haspopup":o,"aria-controls":_?g:void 0,...C?{}:{onClick:F}}}),[F,o,_,g,C]),triggerElement:y,triggerId:D,setPanel:S,panelElement:x}}Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return a}});
+const e=require("./platform.cjs"),t=require("./effects.cjs"),n=require("./behavior.cjs"),r=require("./identity.cjs");let i=require("react");var a=()=>()=>{},o=()=>!0;function s(){return(0,i.useSyncExternalStore)(a,e.a,o)}function c(a){let{haspopup:o,id:c,idPrefix:l,open:u,defaultOpen:d=!1,onOpenChange:f,onOpened:p,onClosing:m,inside:h}=a,g=r.t(l),_=c??g,[v,y]=n.i({value:u,defaultValue:d,onChange:f}),[b,x]=(0,i.useState)(null),[S,C]=(0,i.useState)(null),w=s(),[T,E]=(0,i.useState)(!1),[D,O]=(0,i.useState)(),k=(0,i.useRef)(`imperative`),A=(0,i.useRef)(!1),j=n.a(p),M=n.a(m),N=n.a(e=>{let t=e.newState===`open`,n=e.currentTarget;if(t&&u===!1){e.preventDefault();return}t||(A.current=n.contains(document.activeElement),M(A.current,b)),E(t);let r=t?`trigger`:k.current;k.current=`imperative`,y(t,{reason:r,event:e})}),P=n.a(e=>{let t=e.currentTarget;e.newState===`open`&&j(t)});t.n(()=>{if(!w||!S)return;let e=new AbortController;return S.addEventListener(`beforetoggle`,N,{signal:e.signal}),S.addEventListener(`toggle`,P,{signal:e.signal}),()=>e.abort()},[w,S,N,P]),t.n(()=>{!w||!e.a()||!S||v===T||(v?S.showPopover():S.hidePopover())},[v,T,S,w]),t.n(()=>{if(!w||!v)return;let t=new AbortController,n=(e,n)=>document.addEventListener(e,n,{signal:t.signal,capture:!0});return n(`keydown`,e=>{e.key===`Escape`&&(k.current=`escape`)}),n(`pointerdown`,t=>{let n=!!b&&e.l(t,[b]);k.current=n?`trigger`:`outside-pointer`}),()=>t.abort()},[w,v,b]),t.n(()=>{b&&(b.id||b.setAttribute(`id`,`${_}-trigger`),O(b.id))},[b,_]),t.n(()=>{if(!(!w||!b))return b.setAttribute(`popovertarget`,_),()=>b.removeAttribute(`popovertarget`)},[w,b,_]),t.n(()=>{w||!v||!S||j(S)},[w,v,S,j]),n.r({enabled:!w&&v,inside:[S,b,...h??[]],onDismiss:(e,t)=>y(!1,{reason:e,event:t})}),n.n({enabled:!w&&v,returnTo:b});let F=n.a(e=>{y(e=>!e,{reason:`trigger`,event:e})});return{platform:w,isOpen:v,setOpen:y,id:_,trigger:(0,i.useMemo)(()=>({ref:x,props:{"aria-expanded":v,"aria-haspopup":o,"aria-controls":v?_:void 0,...w?{}:{onClick:F}}}),[F,o,v,_,w]),triggerElement:b,triggerId:D,setPanel:C,panelElement:S}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return c}});