cortena-ui 1.3.0 → 1.4.0

package/dist/a2ui/message.js

@@ -0,0 +1,365 @@
+"use client";
+//#region src/a2ui/message.ts
+/**
+* A2UI message layer.
+*
+* The wire format cortena-ui accepts, and the fold from a stream of messages
+* onto a set of surfaces. Deliberately free of React so it can be reused by a
+* canvas host, a test fixture, or the catalogue doc generator.
+*
+* ## Two dialects, one fold
+*
+* **v0.9** is the current A2UI protocol (`createSurface`, `updateComponents`,
+* `updateDataModel`, `deleteSurface`) and is what an agent should emit.
+*
+* **v0.8** is what Cortena already speaks: core bundles Google's A2UI Lit
+* renderer at `src/canvas-host/a2ui/` and its `A2uiMessageProcessor` handles
+* `beginRendering`, `surfaceUpdate`, `dataModelUpdate` and `deleteSurface`.
+* The `canvas` agent tool pushes exactly those, as JSON lines, through
+* `canvas.a2ui.pushJSONL`. Accepting both means one renderer serves the chat,
+* the web canvas panel and every payload already written against the native
+* nodes.
+*
+* ## Transport
+*
+* Per `05-agent-ui.md`, an A2UI block travels as an AG-UI `CUSTOM` event. The
+* event value is a message, an array of messages, or the JSONL text the canvas
+* tool sends; {@link parseA2UIMessages} takes all three.
+*/
+/** Surface id used when a message omits one, matching core's Lit processor. */
+const A2UI_DEFAULT_SURFACE_ID = "@default";
+/** Protocol version this package speaks. */
+const A2UI_VERSION = "v0.9";
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** True when a value is a `{ path }` data binding rather than a literal object. */
+function isDataBinding(value) {
+	return isRecord(value) && typeof value.path === "string" && Object.keys(value).length === 1;
+}
+/**
+* Parse whatever arrived into a message list.
+*
+* A string is tried as JSON first (an array or a single message) and then as
+* JSONL, which is the form `canvas.a2ui.pushJSONL` sends. A line that does not
+* parse is reported rather than dropped: silently rendering three of four
+* pushed messages is the failure mode this returns errors for.
+*/
+function parseA2UIMessages(input) {
+	if (input === null || input === void 0) return {
+		messages: [],
+		errors: []
+	};
+	if (typeof input === "string") {
+		const trimmed = input.trim();
+		if (!trimmed) return {
+			messages: [],
+			errors: []
+		};
+		if (trimmed.startsWith("[")) try {
+			const parsed = JSON.parse(trimmed);
+			if (Array.isArray(parsed)) return collect(parsed);
+			return {
+				messages: [],
+				errors: ["Expected an array of A2UI messages."]
+			};
+		} catch (error) {
+			return {
+				messages: [],
+				errors: [`Malformed JSON: ${errorText(error)}`]
+			};
+		}
+		const messages = [];
+		const errors = [];
+		const lines = trimmed.split("\n");
+		for (let index = 0; index < lines.length; index += 1) {
+			const line = (lines[index] ?? "").trim();
+			if (!line) continue;
+			try {
+				const one = collect([JSON.parse(line)]);
+				messages.push(...one.messages);
+				errors.push(...one.errors.map((text) => `Line ${index + 1}: ${text}`));
+			} catch (error) {
+				errors.push(`Line ${index + 1}: malformed JSON (${errorText(error)}).`);
+			}
+		}
+		return {
+			messages,
+			errors
+		};
+	}
+	return collect(Array.isArray(input) ? input : [input]);
+}
+function collect(values) {
+	const messages = [];
+	const errors = [];
+	for (let index = 0; index < values.length; index += 1) {
+		const value = values[index];
+		if (!isRecord(value)) {
+			errors.push(`Message ${index + 1} is not an object.`);
+			continue;
+		}
+		messages.push(value);
+	}
+	return {
+		messages,
+		errors
+	};
+}
+function errorText(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* Fold a message stream onto surfaces.
+*
+* Updates accumulate: a later `updateComponents` replaces the components it
+* names and leaves the rest, and a later `updateDataModel` writes at its path
+* only. That is what makes the JSONL push form work — the agent sends the
+* shell, then the rows, then a correction, and each one folds onto the same
+* surface.
+*/
+function foldMessages(input) {
+	const { messages, errors } = parseA2UIMessages(input);
+	const surfaces = /* @__PURE__ */ new Map();
+	const order = [];
+	const surfaceFor = (id) => {
+		const key = id && id.trim() ? id : A2UI_DEFAULT_SURFACE_ID;
+		let surface = surfaces.get(key);
+		if (!surface) {
+			surface = {
+				id: key,
+				root: void 0,
+				components: /* @__PURE__ */ new Map(),
+				dataModel: {},
+				styles: {}
+			};
+			surfaces.set(key, surface);
+			order.push(key);
+		}
+		return surface;
+	};
+	const applyComponents = (payload, index) => {
+		if (!payload) return;
+		const surface = surfaceFor(payload.surfaceId);
+		if (!Array.isArray(payload.components)) {
+			errors.push(`Message ${index + 1}: components must be an array.`);
+			return;
+		}
+		for (const spec of payload.components) {
+			if (!isRecord(spec) || typeof spec.id !== "string" || !spec.id) {
+				errors.push(`Message ${index + 1}: a component is missing a string id.`);
+				continue;
+			}
+			surface.components.set(spec.id, spec);
+		}
+		if (typeof payload.root === "string" && payload.root) surface.root = payload.root;
+	};
+	const applyData = (payload) => {
+		if (!payload) return;
+		const surface = surfaceFor(payload.surfaceId);
+		const value = payload.value !== void 0 ? payload.value : payload.contents;
+		const path = payload.path && payload.path.trim() ? payload.path : "/";
+		surface.dataModel = setAtPointer(surface.dataModel, path, value);
+	};
+	for (let index = 0; index < messages.length; index += 1) {
+		const message = messages[index];
+		if (!message) continue;
+		if (message.createSurface) {
+			const surface = surfaceFor(message.createSurface.surfaceId);
+			if (typeof message.createSurface.root === "string" && message.createSurface.root) surface.root = message.createSurface.root;
+		}
+		if (message.beginRendering) {
+			const surface = surfaceFor(message.beginRendering.surfaceId);
+			if (typeof message.beginRendering.root === "string" && message.beginRendering.root) surface.root = message.beginRendering.root;
+			if (isRecord(message.beginRendering.styles)) surface.styles = {
+				...surface.styles,
+				...message.beginRendering.styles
+			};
+		}
+		applyComponents(message.updateComponents, index);
+		applyComponents(message.surfaceUpdate, index);
+		applyData(message.updateDataModel);
+		applyData(message.dataModelUpdate);
+		if (message.deleteSurface) {
+			const key = message.deleteSurface.surfaceId ?? "@default";
+			surfaces.delete(key);
+			const at = order.indexOf(key);
+			if (at !== -1) order.splice(at, 1);
+		}
+		if (!(message.createSurface ?? message.updateComponents ?? message.updateDataModel ?? message.deleteSurface ?? message.beginRendering ?? message.surfaceUpdate ?? message.dataModelUpdate)) errors.push(`Message ${index + 1}: no known operation (createSurface, updateComponents, updateDataModel, deleteSurface, beginRendering, surfaceUpdate, dataModelUpdate).`);
+	}
+	const result = [];
+	for (const key of order) {
+		const surface = surfaces.get(key);
+		if (!surface) continue;
+		result.push({
+			id: surface.id,
+			root: surface.root ?? defaultRoot(surface.components),
+			components: surface.components,
+			dataModel: surface.dataModel,
+			styles: surface.styles
+		});
+	}
+	return {
+		surfaces: result,
+		errors
+	};
+}
+/** No explicit root: prefer the conventional `root` id, else the first component. */
+function defaultRoot(components) {
+	if (components.has("root")) return "root";
+	for (const id of components.keys()) return id;
+}
+/** Split a JSON pointer into its unescaped segments. */
+function pointerSegments(pointer) {
+	const trimmed = pointer.trim();
+	if (!trimmed || trimmed === "/" || trimmed === ".") return [];
+	return (trimmed.startsWith("/") ? trimmed.slice(1) : trimmed).split("/").filter((segment) => segment !== "").map((segment) => segment.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+/** Resolve a possibly relative pointer against a data context. */
+function resolvePointer(path, contextPath) {
+	if (path.startsWith("/")) return path;
+	const relative = path === "." || path === "" ? "" : path.replace(/^\.?\//, "");
+	const base = contextPath === "/" || !contextPath ? "" : contextPath.replace(/\/$/, "");
+	if (!relative) return base || "/";
+	return `${base}/${relative}`;
+}
+/** Read a JSON pointer out of the data model. */
+function getAtPointer(model, pointer) {
+	let current = model;
+	for (const segment of pointerSegments(pointer)) {
+		if (Array.isArray(current)) {
+			const index = Number(segment);
+			current = Number.isInteger(index) ? current[index] : void 0;
+		} else if (isRecord(current)) current = current[segment];
+		else return;
+		if (current === void 0) return;
+	}
+	return current;
+}
+/**
+* Write a JSON pointer into the data model, returning a new model.
+*
+* Immutable because the renderer keeps the model in React state: a mutation in
+* place would not re-render, which is the kind of silent nothing-happens bug
+* that is hard to see in a browser test.
+*/
+function setAtPointer(model, pointer, value) {
+	const segments = pointerSegments(pointer);
+	if (segments.length === 0) return isRecord(value) ? { ...value } : {};
+	const clone = { ...model };
+	let cursor = clone;
+	for (let index = 0; index < segments.length - 1; index += 1) {
+		const segment = segments[index] ?? "";
+		const nextSegment = segments[index + 1] ?? "";
+		const wantsArray = /^\d+$/.test(nextSegment);
+		const existing = Array.isArray(cursor) ? cursor[Number(segment)] : cursor[segment];
+		let next;
+		if (Array.isArray(existing)) next = [...existing];
+		else if (isRecord(existing)) next = { ...existing };
+		else next = wantsArray ? [] : {};
+		if (Array.isArray(cursor)) cursor[Number(segment)] = next;
+		else cursor[segment] = next;
+		cursor = next;
+	}
+	const last = segments[segments.length - 1] ?? "";
+	if (Array.isArray(cursor)) cursor[Number(last)] = value;
+	else cursor[last] = value;
+	return clone;
+}
+function readChildren(spec, properties) {
+	const raw = spec.children ?? properties.children;
+	if (!raw) return { kind: "none" };
+	if (Array.isArray(raw)) return {
+		kind: "list",
+		ids: raw.filter((id) => typeof id === "string")
+	};
+	if (isRecord(raw)) {
+		const record = raw;
+		const explicitList = record.explicitList;
+		if (Array.isArray(explicitList)) return {
+			kind: "list",
+			ids: explicitList.filter((id) => typeof id === "string")
+		};
+		const template = record.template;
+		if (isRecord(template)) {
+			const { componentId, dataBinding } = template;
+			if (typeof componentId === "string" && typeof dataBinding === "string") return {
+				kind: "template",
+				componentId,
+				path: dataBinding
+			};
+		}
+		if (typeof record.componentId === "string" && typeof record.path === "string") return {
+			kind: "template",
+			componentId: record.componentId,
+			path: record.path
+		};
+	}
+	return { kind: "none" };
+}
+/**
+* Split a component spec into its type name and its raw (unresolved) properties,
+* across both dialects. Returns `undefined` when the spec names no type.
+*/
+function readComponent(spec) {
+	if (typeof spec.component === "string") {
+		const { id: _id, component: _component, children: _children, weight: _weight, ...rest } = spec;
+		return {
+			name: spec.component,
+			properties: rest
+		};
+	}
+	if (isRecord(spec.component)) {
+		const name = Object.keys(spec.component)[0];
+		if (!name) return;
+		const properties = spec.component[name];
+		return {
+			name,
+			properties: isRecord(properties) ? properties : {}
+		};
+	}
+}
+/**
+* Resolve one property value against the data model.
+*
+* `{ path }` reads the model, `{ literal }` / `{ literalString }` unwrap, and
+* everything else is returned as written, recursing through arrays and objects
+* so a binding nested inside a prop object still resolves.
+*/
+function resolveValue(value, model, contextPath) {
+	if (Array.isArray(value)) return value.map((item) => resolveValue(item, model, contextPath));
+	if (isRecord(value)) {
+		if (isDataBinding(value)) return getAtPointer(model, resolvePointer(value.path, contextPath));
+		if ("literalString" in value && typeof value.literalString === "string") return value.literalString;
+		if ("literal" in value && Object.keys(value).length === 1) return value.literal;
+		const out = {};
+		for (const [key, item] of Object.entries(value)) out[key] = resolveValue(item, model, contextPath);
+		return out;
+	}
+	return value;
+}
+/**
+* Normalise an action property into `{ name, context }`.
+*
+* Accepts v0.9's `{ event: { name, context } }`, the bare `{ name, context }`
+* shape, and a plain string, which is what an agent writes most often.
+*/
+function readAction(value) {
+	if (typeof value === "string" && value.trim()) return {
+		name: value,
+		context: {}
+	};
+	if (!isRecord(value)) return;
+	const event = isRecord(value.event) ? value.event : value;
+	const name = event.name;
+	if (typeof name !== "string" || !name) return;
+	return {
+		name,
+		context: isRecord(event.context) ? event.context : {}
+	};
+}
+//#endregion
+export { A2UI_DEFAULT_SURFACE_ID, A2UI_VERSION, foldMessages, getAtPointer, isDataBinding, parseA2UIMessages, pointerSegments, readAction, readChildren, readComponent, resolvePointer, resolveValue, setAtPointer };
+
+//# sourceMappingURL=message.js.map

package/dist/a2ui/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","names":[],"sources":["../../src/a2ui/message.ts"],"sourcesContent":["/**\n * A2UI message layer.\n *\n * The wire format cortena-ui accepts, and the fold from a stream of messages\n * onto a set of surfaces. Deliberately free of React so it can be reused by a\n * canvas host, a test fixture, or the catalogue doc generator.\n *\n * ## Two dialects, one fold\n *\n * **v0.9** is the current A2UI protocol (`createSurface`, `updateComponents`,\n * `updateDataModel`, `deleteSurface`) and is what an agent should emit.\n *\n * **v0.8** is what Cortena already speaks: core bundles Google's A2UI Lit\n * renderer at `src/canvas-host/a2ui/` and its `A2uiMessageProcessor` handles\n * `beginRendering`, `surfaceUpdate`, `dataModelUpdate` and `deleteSurface`.\n * The `canvas` agent tool pushes exactly those, as JSON lines, through\n * `canvas.a2ui.pushJSONL`. Accepting both means one renderer serves the chat,\n * the web canvas panel and every payload already written against the native\n * nodes.\n *\n * ## Transport\n *\n * Per `05-agent-ui.md`, an A2UI block travels as an AG-UI `CUSTOM` event. The\n * event value is a message, an array of messages, or the JSONL text the canvas\n * tool sends; {@link parseA2UIMessages} takes all three.\n */\n\n/** Surface id used when a message omits one, matching core's Lit processor. */\nexport const A2UI_DEFAULT_SURFACE_ID = \"@default\";\n\n/** Protocol version this package speaks. */\nexport const A2UI_VERSION = \"v0.9\";\n\n/** A reference to a value in the surface's data model, as a JSON pointer. */\nexport interface A2UIDataBinding {\n  path: string;\n}\n\n/**\n * A property value as an agent writes it: a literal, a data binding, or one of\n * the v0.8 literal wrappers the Lit renderer accepts.\n */\nexport type A2UIPropertyValue =\n  | string\n  | number\n  | boolean\n  | null\n  | A2UIDataBinding\n  | { literal: unknown }\n  | { literalString: string }\n  | readonly A2UIPropertyValue[]\n  | { readonly [key: string]: unknown };\n\n/**\n * A component's children. v0.9 uses a plain id array or a `{ componentId, path }`\n * template; v0.8 wraps the same two in `explicitList` / `template`.\n */\nexport type A2UIChildList =\n  | readonly string[]\n  | { componentId: string; path: string }\n  | { explicitList: readonly string[] }\n  | { template: { componentId: string; dataBinding: string } };\n\n/** An action an agent attaches to an interactive property. */\nexport type A2UIActionSpec =\n  | string\n  | { event: { name: string; context?: Record<string, unknown> } }\n  | { name: string; context?: Record<string, unknown> };\n\n/**\n * One component in a surface.\n *\n * v0.9 is flat — `{ id, component: \"Text\", text: \"hi\" }` — and v0.8 wraps the\n * properties under the type name — `{ id, component: { Text: { text: \"hi\" } } }`.\n */\nexport interface A2UIComponentSpec {\n  id: string;\n  component: string | Record<string, Record<string, unknown>>;\n  children?: A2UIChildList;\n  /** v0.8 flex weight; carried through but not used for layout here. */\n  weight?: number | string;\n  [property: string]: unknown;\n}\n\nexport interface A2UICreateSurface {\n  surfaceId?: string;\n  catalogId?: string;\n  /** Not in the v0.9 schema; accepted so a single message can seed a surface. */\n  root?: string;\n  sendDataModel?: boolean;\n}\n\nexport interface A2UIUpdateComponents {\n  surfaceId?: string;\n  components: A2UIComponentSpec[];\n  root?: string;\n}\n\nexport interface A2UIUpdateDataModel {\n  surfaceId?: string;\n  path?: string;\n  value?: unknown;\n  /** v0.8 spelling of `value`. */\n  contents?: unknown;\n}\n\nexport interface A2UIBeginRendering {\n  surfaceId?: string;\n  root?: string;\n  styles?: Record<string, unknown>;\n}\n\nexport interface A2UIDeleteSurface {\n  surfaceId?: string;\n}\n\n/** One message on the wire. Exactly one operation key is read per message. */\nexport interface A2UIMessage {\n  version?: string;\n  createSurface?: A2UICreateSurface;\n  updateComponents?: A2UIUpdateComponents;\n  updateDataModel?: A2UIUpdateDataModel;\n  deleteSurface?: A2UIDeleteSurface;\n  /** v0.8 */\n  beginRendering?: A2UIBeginRendering;\n  /** v0.8 */\n  surfaceUpdate?: A2UIUpdateComponents;\n  /** v0.8 */\n  dataModelUpdate?: A2UIUpdateDataModel;\n}\n\n/**\n * Everything the renderer's `message` prop takes: one message, a list of them\n * (the AG-UI `CUSTOM` payload), or JSONL / a JSON array as text (the canvas\n * tool's `a2ui_push`).\n */\nexport type A2UIMessageInput = A2UIMessage | readonly A2UIMessage[] | string | null | undefined;\n\n/** A folded surface: what the renderer draws. */\nexport interface A2UISurface {\n  id: string;\n  /** Id of the root component; `undefined` until a message names one. */\n  root: string | undefined;\n  components: ReadonlyMap<string, A2UIComponentSpec>;\n  dataModel: Record<string, unknown>;\n  styles: Record<string, unknown>;\n}\n\nexport interface A2UIFoldResult {\n  surfaces: A2UISurface[];\n  /** One line per malformed message; the renderer shows these in an error card. */\n  errors: string[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** True when a value is a `{ path }` data binding rather than a literal object. */\nexport function isDataBinding(value: unknown): value is A2UIDataBinding {\n  return isRecord(value) && typeof value.path === \"string\" && Object.keys(value).length === 1;\n}\n\n/**\n * Parse whatever arrived into a message list.\n *\n * A string is tried as JSON first (an array or a single message) and then as\n * JSONL, which is the form `canvas.a2ui.pushJSONL` sends. A line that does not\n * parse is reported rather than dropped: silently rendering three of four\n * pushed messages is the failure mode this returns errors for.\n */\nexport function parseA2UIMessages(input: A2UIMessageInput): {\n  messages: A2UIMessage[];\n  errors: string[];\n} {\n  if (input === null || input === undefined) {\n    return { messages: [], errors: [] };\n  }\n  if (typeof input === \"string\") {\n    const trimmed = input.trim();\n    if (!trimmed) {\n      return { messages: [], errors: [] };\n    }\n    if (trimmed.startsWith(\"[\")) {\n      try {\n        const parsed: unknown = JSON.parse(trimmed);\n        if (Array.isArray(parsed)) {\n          return collect(parsed);\n        }\n        return { messages: [], errors: [\"Expected an array of A2UI messages.\"] };\n      } catch (error) {\n        return { messages: [], errors: [`Malformed JSON: ${errorText(error)}`] };\n      }\n    }\n    const messages: A2UIMessage[] = [];\n    const errors: string[] = [];\n    const lines = trimmed.split(\"\\n\");\n    for (let index = 0; index < lines.length; index += 1) {\n      const line = (lines[index] ?? \"\").trim();\n      if (!line) {\n        continue;\n      }\n      try {\n        const parsed: unknown = JSON.parse(line);\n        const one = collect([parsed]);\n        messages.push(...one.messages);\n        errors.push(...one.errors.map((text) => `Line ${index + 1}: ${text}`));\n      } catch (error) {\n        errors.push(`Line ${index + 1}: malformed JSON (${errorText(error)}).`);\n      }\n    }\n    return { messages, errors };\n  }\n  return collect(Array.isArray(input) ? input : [input]);\n}\n\nfunction collect(values: readonly unknown[]): { messages: A2UIMessage[]; errors: string[] } {\n  const messages: A2UIMessage[] = [];\n  const errors: string[] = [];\n  for (let index = 0; index < values.length; index += 1) {\n    const value = values[index];\n    if (!isRecord(value)) {\n      errors.push(`Message ${index + 1} is not an object.`);\n      continue;\n    }\n    messages.push(value as A2UIMessage);\n  }\n  return { messages, errors };\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\ninterface MutableSurface {\n  id: string;\n  root: string | undefined;\n  components: Map<string, A2UIComponentSpec>;\n  dataModel: Record<string, unknown>;\n  styles: Record<string, unknown>;\n}\n\n/**\n * Fold a message stream onto surfaces.\n *\n * Updates accumulate: a later `updateComponents` replaces the components it\n * names and leaves the rest, and a later `updateDataModel` writes at its path\n * only. That is what makes the JSONL push form work — the agent sends the\n * shell, then the rows, then a correction, and each one folds onto the same\n * surface.\n */\nexport function foldMessages(input: A2UIMessageInput): A2UIFoldResult {\n  const { messages, errors } = parseA2UIMessages(input);\n  const surfaces = new Map<string, MutableSurface>();\n  const order: string[] = [];\n\n  const surfaceFor = (id: string | undefined): MutableSurface => {\n    const key = id && id.trim() ? id : A2UI_DEFAULT_SURFACE_ID;\n    let surface = surfaces.get(key);\n    if (!surface) {\n      surface = { id: key, root: undefined, components: new Map(), dataModel: {}, styles: {} };\n      surfaces.set(key, surface);\n      order.push(key);\n    }\n    return surface;\n  };\n\n  const applyComponents = (payload: A2UIUpdateComponents | undefined, index: number): void => {\n    if (!payload) {\n      return;\n    }\n    const surface = surfaceFor(payload.surfaceId);\n    if (!Array.isArray(payload.components)) {\n      errors.push(`Message ${index + 1}: components must be an array.`);\n      return;\n    }\n    for (const spec of payload.components) {\n      if (!isRecord(spec) || typeof spec.id !== \"string\" || !spec.id) {\n        errors.push(`Message ${index + 1}: a component is missing a string id.`);\n        continue;\n      }\n      surface.components.set(spec.id, spec as A2UIComponentSpec);\n    }\n    if (typeof payload.root === \"string\" && payload.root) {\n      surface.root = payload.root;\n    }\n  };\n\n  const applyData = (payload: A2UIUpdateDataModel | undefined): void => {\n    if (!payload) {\n      return;\n    }\n    const surface = surfaceFor(payload.surfaceId);\n    const value = payload.value !== undefined ? payload.value : payload.contents;\n    const path = payload.path && payload.path.trim() ? payload.path : \"/\";\n    surface.dataModel = setAtPointer(surface.dataModel, path, value);\n  };\n\n  for (let index = 0; index < messages.length; index += 1) {\n    const message = messages[index];\n    if (!message) {\n      continue;\n    }\n    if (message.createSurface) {\n      const surface = surfaceFor(message.createSurface.surfaceId);\n      if (typeof message.createSurface.root === \"string\" && message.createSurface.root) {\n        surface.root = message.createSurface.root;\n      }\n    }\n    if (message.beginRendering) {\n      const surface = surfaceFor(message.beginRendering.surfaceId);\n      if (typeof message.beginRendering.root === \"string\" && message.beginRendering.root) {\n        surface.root = message.beginRendering.root;\n      }\n      if (isRecord(message.beginRendering.styles)) {\n        surface.styles = { ...surface.styles, ...message.beginRendering.styles };\n      }\n    }\n    applyComponents(message.updateComponents, index);\n    applyComponents(message.surfaceUpdate, index);\n    applyData(message.updateDataModel);\n    applyData(message.dataModelUpdate);\n    if (message.deleteSurface) {\n      const key = message.deleteSurface.surfaceId ?? A2UI_DEFAULT_SURFACE_ID;\n      surfaces.delete(key);\n      const at = order.indexOf(key);\n      if (at !== -1) {\n        order.splice(at, 1);\n      }\n    }\n    const known =\n      message.createSurface ??\n      message.updateComponents ??\n      message.updateDataModel ??\n      message.deleteSurface ??\n      message.beginRendering ??\n      message.surfaceUpdate ??\n      message.dataModelUpdate;\n    if (!known) {\n      errors.push(\n        `Message ${index + 1}: no known operation (createSurface, updateComponents, updateDataModel, deleteSurface, beginRendering, surfaceUpdate, dataModelUpdate).`,\n      );\n    }\n  }\n\n  const result: A2UISurface[] = [];\n  for (const key of order) {\n    const surface = surfaces.get(key);\n    if (!surface) {\n      continue;\n    }\n    result.push({\n      id: surface.id,\n      root: surface.root ?? defaultRoot(surface.components),\n      components: surface.components,\n      dataModel: surface.dataModel,\n      styles: surface.styles,\n    });\n  }\n  return { surfaces: result, errors };\n}\n\n/** No explicit root: prefer the conventional `root` id, else the first component. */\nfunction defaultRoot(components: ReadonlyMap<string, A2UIComponentSpec>): string | undefined {\n  if (components.has(\"root\")) {\n    return \"root\";\n  }\n  for (const id of components.keys()) {\n    return id;\n  }\n  return undefined;\n}\n\n/** Split a JSON pointer into its unescaped segments. */\nexport function pointerSegments(pointer: string): string[] {\n  const trimmed = pointer.trim();\n  if (!trimmed || trimmed === \"/\" || trimmed === \".\") {\n    return [];\n  }\n  const body = trimmed.startsWith(\"/\") ? trimmed.slice(1) : trimmed;\n  return body\n    .split(\"/\")\n    .filter((segment) => segment !== \"\")\n    .map((segment) => segment.replace(/~1/g, \"/\").replace(/~0/g, \"~\"));\n}\n\n/** Resolve a possibly relative pointer against a data context. */\nexport function resolvePointer(path: string, contextPath: string): string {\n  if (path.startsWith(\"/\")) {\n    return path;\n  }\n  const relative = path === \".\" || path === \"\" ? \"\" : path.replace(/^\\.?\\//, \"\");\n  const base = contextPath === \"/\" || !contextPath ? \"\" : contextPath.replace(/\\/$/, \"\");\n  if (!relative) {\n    return base || \"/\";\n  }\n  return `${base}/${relative}`;\n}\n\n/** Read a JSON pointer out of the data model. */\nexport function getAtPointer(model: unknown, pointer: string): unknown {\n  let current: unknown = model;\n  for (const segment of pointerSegments(pointer)) {\n    if (Array.isArray(current)) {\n      const index = Number(segment);\n      current = Number.isInteger(index) ? current[index] : undefined;\n    } else if (isRecord(current)) {\n      current = current[segment];\n    } else {\n      return undefined;\n    }\n    if (current === undefined) {\n      return undefined;\n    }\n  }\n  return current;\n}\n\n/**\n * Write a JSON pointer into the data model, returning a new model.\n *\n * Immutable because the renderer keeps the model in React state: a mutation in\n * place would not re-render, which is the kind of silent nothing-happens bug\n * that is hard to see in a browser test.\n */\nexport function setAtPointer(\n  model: Record<string, unknown>,\n  pointer: string,\n  value: unknown,\n): Record<string, unknown> {\n  const segments = pointerSegments(pointer);\n  if (segments.length === 0) {\n    return isRecord(value) ? { ...value } : {};\n  }\n  const clone: Record<string, unknown> = { ...model };\n  let cursor: Record<string, unknown> | unknown[] = clone;\n  for (let index = 0; index < segments.length - 1; index += 1) {\n    const segment = segments[index] ?? \"\";\n    const nextSegment = segments[index + 1] ?? \"\";\n    const wantsArray = /^\\d+$/.test(nextSegment);\n    const existing: unknown = Array.isArray(cursor)\n      ? cursor[Number(segment)]\n      : (cursor as Record<string, unknown>)[segment];\n    let next: Record<string, unknown> | unknown[];\n    if (Array.isArray(existing)) {\n      next = [...existing];\n    } else if (isRecord(existing)) {\n      next = { ...existing };\n    } else {\n      next = wantsArray ? [] : {};\n    }\n    if (Array.isArray(cursor)) {\n      cursor[Number(segment)] = next;\n    } else {\n      (cursor as Record<string, unknown>)[segment] = next;\n    }\n    cursor = next;\n  }\n  const last = segments[segments.length - 1] ?? \"\";\n  if (Array.isArray(cursor)) {\n    cursor[Number(last)] = value;\n  } else {\n    (cursor as Record<string, unknown>)[last] = value;\n  }\n  return clone;\n}\n\n/** Normalise the children of a component spec into a single description. */\nexport type A2UIChildren =\n  | { kind: \"list\"; ids: readonly string[] }\n  | { kind: \"template\"; componentId: string; path: string }\n  | { kind: \"none\" };\n\nexport function readChildren(spec: A2UIComponentSpec, properties: Record<string, unknown>): A2UIChildren {\n  const raw = (spec.children ?? properties.children) as A2UIChildList | undefined;\n  if (!raw) {\n    return { kind: \"none\" };\n  }\n  if (Array.isArray(raw)) {\n    return { kind: \"list\", ids: raw.filter((id): id is string => typeof id === \"string\") };\n  }\n  if (isRecord(raw)) {\n    const record: Record<string, unknown> = raw;\n    const explicitList = record.explicitList;\n    if (Array.isArray(explicitList)) {\n      return {\n        kind: \"list\",\n        ids: explicitList.filter((id): id is string => typeof id === \"string\"),\n      };\n    }\n    const template = record.template;\n    if (isRecord(template)) {\n      const { componentId, dataBinding } = template;\n      if (typeof componentId === \"string\" && typeof dataBinding === \"string\") {\n        return { kind: \"template\", componentId, path: dataBinding };\n      }\n    }\n    if (typeof record.componentId === \"string\" && typeof record.path === \"string\") {\n      return { kind: \"template\", componentId: record.componentId, path: record.path };\n    }\n  }\n  return { kind: \"none\" };\n}\n\n/**\n * Split a component spec into its type name and its raw (unresolved) properties,\n * across both dialects. Returns `undefined` when the spec names no type.\n */\nexport function readComponent(\n  spec: A2UIComponentSpec,\n): { name: string; properties: Record<string, unknown> } | undefined {\n  if (typeof spec.component === \"string\") {\n    const { id: _id, component: _component, children: _children, weight: _weight, ...rest } = spec;\n    return { name: spec.component, properties: rest };\n  }\n  if (isRecord(spec.component)) {\n    const name = Object.keys(spec.component)[0];\n    if (!name) {\n      return undefined;\n    }\n    const properties = (spec.component as Record<string, unknown>)[name];\n    return { name, properties: isRecord(properties) ? properties : {} };\n  }\n  return undefined;\n}\n\n/**\n * Resolve one property value against the data model.\n *\n * `{ path }` reads the model, `{ literal }` / `{ literalString }` unwrap, and\n * everything else is returned as written, recursing through arrays and objects\n * so a binding nested inside a prop object still resolves.\n */\nexport function resolveValue(\n  value: unknown,\n  model: Record<string, unknown>,\n  contextPath: string,\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => resolveValue(item, model, contextPath));\n  }\n  if (isRecord(value)) {\n    if (isDataBinding(value)) {\n      return getAtPointer(model, resolvePointer(value.path, contextPath));\n    }\n    if (\"literalString\" in value && typeof value.literalString === \"string\") {\n      return value.literalString;\n    }\n    if (\"literal\" in value && Object.keys(value).length === 1) {\n      return value.literal;\n    }\n    const out: Record<string, unknown> = {};\n    for (const [key, item] of Object.entries(value)) {\n      out[key] = resolveValue(item, model, contextPath);\n    }\n    return out;\n  }\n  return value;\n}\n\n/** A user action leaving the renderer, shaped like A2UI's client-to-server action. */\nexport interface A2UIAction {\n  surfaceId: string;\n  componentId: string;\n  name: string;\n  payload: Record<string, unknown>;\n}\n\n/**\n * Normalise an action property into `{ name, context }`.\n *\n * Accepts v0.9's `{ event: { name, context } }`, the bare `{ name, context }`\n * shape, and a plain string, which is what an agent writes most often.\n */\nexport function readAction(\n  value: unknown,\n): { name: string; context: Record<string, unknown> } | undefined {\n  if (typeof value === \"string\" && value.trim()) {\n    return { name: value, context: {} };\n  }\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  const event = isRecord(value.event) ? value.event : value;\n  const name = event.name;\n  if (typeof name !== \"string\" || !name) {\n    return undefined;\n  }\n  return { name, context: isRecord(event.context) ? event.context : {} };\n}\n"],"mappings":"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"}

package/dist/a2ui/renderer.d.ts

@@ -0,0 +1,46 @@
+"use client";
+import { A2UIAction, A2UIMessageInput, A2UI_DEFAULT_SURFACE_ID } from "./message.js";
+import { DataSource } from "../components/data-table/types.js";
+import "../components/data-table/index.js";
+import { A2UIRow } from "./views.js";
+import { A2UICatalogue } from "./catalogue.js";
+import * as React from "react";
+//#region src/a2ui/renderer.d.ts
+export interface A2UIRendererProps {
+  /**
+   * The payload. One message, the list an AG-UI `CUSTOM` event carries, or the
+   * JSONL text `canvas.a2ui.pushJSONL` sends. Later messages fold onto earlier
+   * ones, so a push stream can be accumulated by the host and handed here whole.
+   */
+  message: A2UIMessageInput;
+  /** The component vocabulary. Defaults to the whole cortena-ui catalogue. */
+  catalogue?: A2UICatalogue;
+  /** Receives every user event, shaped like A2UI's client-to-server action. */
+  onAction?: (action: A2UIAction) => void;
+  /**
+   * Resolves a `{ kind: "server", sourceId }` table handle into a real data
+   * source. Without it, a server table renders an error card rather than an
+   * empty one, because a silently empty table reads as "no results".
+   */
+  resolveDataSource?: (sourceId: string) => DataSource<A2UIRow> | undefined;
+  /** Render only this surface. Default: every surface, in arrival order. */
+  surfaceId?: string;
+  /** Debounce before a continuous input becomes an action. @default 300 */
+  debounceMs?: number;
+  className?: string;
+}
+/**
+ * A2UIRenderer — draws A2UI messages through cortena-ui.
+ *
+ * ```tsx
+ * <A2UIRenderer
+ *   message={customEvent.value}
+ *   catalogue={defaultCatalogue}
+ *   onAction={(action) => agent.send(action)}
+ *   resolveDataSource={(id) => sources[id]}
+ * />
+ * ```
+ */
+export declare function A2UIRenderer({ message, catalogue, onAction, resolveDataSource, surfaceId, debounceMs, className }: A2UIRendererProps): React.JSX.Element;
+//#endregion
+//# sourceMappingURL=renderer.d.ts.map