@webskill/sdk 0.2.5 → 0.2.7

package/dist/{dist-DNSG9FqC.js → dist-CtBLBbEz.js}

@@ -1,127 +1,7 @@
 import { u as WebSkillError } from "./dist-BQzncxXg.js";
+import { toJSONSchema, z } from "zod";
 
-//#region ../ui/dist/index.js
-/** 提交值按请求类型归形（WebFormBridge 与框架组件库共享单一来源） */
-function shapeInteractionValue(model, values) {
-	switch (model.kind) {
-		case "ask": return values["answer"];
-		case "confirm": return values["confirmed"] === true;
-		case "select": return values["selected"];
-		case "authorize": return true;
-		case "form": return values;
-	}
-}
-/** 五类 InteractionRequest → 统一中间模型（框架无关） */
-function interactionToFormModel(request) {
-	switch (request.type) {
-		case "ask": return {
-			kind: "ask",
-			message: request.message,
-			controls: [{
-				name: "answer",
-				label: request.message,
-				control: "text",
-				required: true
-			}],
-			submitLabel: "Submit",
-			cancelLabel: "Cancel"
-		};
-		case "confirm": return {
-			kind: "confirm",
-			message: request.message,
-			controls: [{
-				name: "confirmed",
-				label: request.message,
-				control: "boolean",
-				defaultValue: request.defaultValue ?? true
-			}],
-			submitLabel: "Confirm",
-			cancelLabel: "Cancel"
-		};
-		case "form": return {
-			kind: "form",
-			...request.title ? { title: request.title } : {},
-			controls: request.fields.map((f) => ({
-				name: f.name,
-				label: f.label,
-				control: f.type,
-				...f.required ? { required: true } : {},
-				...f.description ? { description: f.description } : {},
-				...f.defaultValue !== void 0 ? { defaultValue: f.defaultValue } : {},
-				...f.options ? { options: f.options } : {}
-			})),
-			submitLabel: "Submit",
-			cancelLabel: "Cancel"
-		};
-		case "select": return {
-			kind: "select",
-			message: request.message,
-			controls: [{
-				name: "selected",
-				label: request.message,
-				control: "select",
-				required: true,
-				options: request.options
-			}],
-			submitLabel: "Select",
-			cancelLabel: "Cancel"
-		};
-		case "authorize": return {
-			kind: "authorize",
-			title: "Authorization required",
-			message: request.message,
-			controls: [],
-			submitLabel: "Allow",
-			cancelLabel: "Deny"
-		};
-	}
-}
-const isEmpty = (v) => v === void 0 || v === "";
-/**
-* 控件名 → 属性选择器：优先 CSS.escape（标识符形式，免引号转义）；
-* 无 CSS.escape 的环境退化为引号包裹 + 转义反斜杠/双引号（防选择器注入崩溃）
-*/
-function controlSelector(name) {
-	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return `[data-webskill-control=${CSS.escape(name)}]`;
-	return `[data-webskill-control="${name.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"]`;
-}
-/**
-* 严格类型化控件值收集：
-* - number 空串 → undefined（非 0）；非数值输入（NaN）按缺失处理（required 时入 missingRequired）
-* - select 用 option 值本身经 JSON 编码比对命中（对象值可正确命中）
-* - required 空值列入 missingRequired（由调用方阻止提交并标记）
-*/
-function collectValues(controls, container) {
-	const values = {};
-	const missingRequired = [];
-	for (const control of controls) {
-		const el = container.querySelector(controlSelector(control.name));
-		let value;
-		if (el === null) value = void 0;
-		else if (control.control === "boolean") value = el.checked;
-		else if (control.control === "number") {
-			const raw = el.value.trim();
-			if (raw === "") value = void 0;
-			else {
-				const n = Number(raw);
-				value = Number.isNaN(n) ? void 0 : n;
-			}
-		} else if (control.control === "select") {
-			const attr = el.value;
-			const hit = control.options?.find((o) => JSON.stringify(o.value) === attr);
-			value = hit ? hit.value : attr === "" ? void 0 : attr;
-		} else {
-			const raw = el.value;
-			value = raw === "" ? void 0 : raw;
-		}
-		values[control.name] = value;
-		if (control.required && isEmpty(value)) missingRequired.push(control.name);
-	}
-	return {
-		values,
-		missingRequired
-	};
-}
+//#region ../ui/dist/webskillCatalog-B4pZvE74.js
 /**
 * 最小子集 markdown → DOM：标题（#..###）、无序列表、代码块（```）、加粗、链接。
 * 全部内容经 textContent 写入，用户内容天然转义防 HTML 注入。
@@ -414,6 +294,779 @@ function chartToTable(chart) {
 		rows: chart.labels.map((label, li) => [label, ...chart.series.map((s) => s.data[li] ?? null)])
 	};
 }
+function componentSchema(def) {
+	const props = toJSONSchema(def.props, { io: "input" });
+	const node = {
+		type: "object",
+		description: def.description,
+		properties: {
+			component: {
+				type: "string",
+				const: def.name
+			},
+			id: {
+				type: "string",
+				description: "Stable node id, reused on replay"
+			},
+			props
+		},
+		required: ["component"]
+	};
+	if (def.children !== void 0) node.properties = {
+		...node.properties,
+		children: {
+			type: "array",
+			description: def.children === "any" ? "Any catalog component" : `One of: ${[...def.children].join(", ")}`,
+			items: { $ref: "#" }
+		}
+	};
+	return node;
+}
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function typeOf(schema) {
+	if (Array.isArray(schema.enum)) return schema.enum.map((option) => JSON.stringify(option)).join(" | ");
+	if (schema["const"] !== void 0) return JSON.stringify(schema["const"]);
+	const union = schema["anyOf"] ?? schema["oneOf"];
+	if (Array.isArray(union)) return union.map(typeOf).join(" | ");
+	if (schema.type === "array" && schema.items) return `${typeOf(schema.items)}[]`;
+	return typeof schema.type === "string" ? schema.type : "unknown";
+}
+function describeProps(def) {
+	const schema = toJSONSchema(def.props, { io: "input" });
+	const properties = schema.properties ?? {};
+	const required = new Set(schema.required ?? []);
+	const entries = Object.entries(properties).map(([key, value]) => `${key}${required.has(key) ? "" : "?"}: ${typeOf(value)}`);
+	return entries.length === 0 ? "—" : entries.join(", ");
+}
+function promptFor(catalog, options) {
+	const lines = [(options.mode === "tool-description" ? "" : `# ${catalog.title} (${catalog.version})\n\n`) + catalog.instructions.trim(), ""];
+	const groups = /* @__PURE__ */ new Map();
+	for (const def of catalog.components) groups.set(def.group, [...groups.get(def.group) ?? [], def]);
+	for (const [group, defs] of groups) {
+		lines.push(`## ${group}`, "");
+		for (const def of defs) {
+			lines.push(`### ${def.name}`, def.description, "", `props: ${describeProps(def)}`);
+			if (def.children !== void 0) lines.push(`children: ${def.children === "any" ? "any component" : [...def.children].join(" | ")}`);
+			for (const constraint of def.constraints ?? []) lines.push(`- ${constraint}`);
+			if (def.example) lines.push("", "```json", JSON.stringify(def.example), "```");
+			lines.push("");
+		}
+	}
+	if (catalog.actions.length > 0) {
+		lines.push("## actions", "");
+		for (const action of catalog.actions) lines.push(`- \`${action.name}\` — ${action.description}`);
+		lines.push("");
+	}
+	return lines.join("\n").trimEnd();
+}
+function validateNode(catalog, byName, node, path, issues) {
+	if (!isRecord$1(node)) {
+		issues.push({
+			path,
+			message: "Node must be an object"
+		});
+		return;
+	}
+	const name = node["component"];
+	if (typeof name !== "string") {
+		issues.push({
+			path,
+			message: "Node is missing a \"component\" name"
+		});
+		return;
+	}
+	const def = byName.get(name);
+	if (!def) {
+		issues.push({
+			path,
+			message: `Unknown component "${name}"; the catalog declares: ${catalog.components.map((c) => c.name).join(", ")}`
+		});
+		return;
+	}
+	const parsed = def.props.safeParse(node["props"] ?? {});
+	if (!parsed.success) for (const issue of parsed.error.issues) issues.push({
+		path: `${path}.props${issue.path.map((part) => `.${String(part)}`).join("")}`,
+		message: issue.message
+	});
+	const children = node["children"];
+	if (children === void 0) return;
+	if (!Array.isArray(children)) {
+		issues.push({
+			path: `${path}.children`,
+			message: "children must be an array"
+		});
+		return;
+	}
+	if (def.children === void 0) {
+		issues.push({
+			path: `${path}.children`,
+			message: `Component "${name}" is a leaf and cannot have children`
+		});
+		return;
+	}
+	const allowed = def.children;
+	children.forEach((child, index) => {
+		const childPath = `${path}.children[${index}]`;
+		if (allowed !== "any" && isRecord$1(child) && typeof child["component"] === "string") {
+			if (!allowed.includes(child["component"])) {
+				issues.push({
+					path: childPath,
+					message: `Component "${name}" only accepts children: ${[...allowed].join(", ")}`
+				});
+				return;
+			}
+		}
+		validateNode(catalog, byName, child, childPath, issues);
+	});
+}
+/**
+* 同一份定义派生出 JSON Schema / prompt / validator 三种投影，
+* 不允许任何一方手写副本（21 号文档 §1）。
+*/
+function defineUiCatalog(input) {
+	const byName = new Map(input.components.map((def) => [def.name, def]));
+	if (byName.size !== input.components.length) {
+		const seen = /* @__PURE__ */ new Set();
+		const duplicate = input.components.find((def) => seen.has(def.name) ? true : (seen.add(def.name), false));
+		throw new Error(`Duplicate component name "${duplicate?.name}" in UI catalog "${input.id}"`);
+	}
+	return {
+		...input,
+		componentNames: input.components.map((def) => def.name),
+		actionNames: input.actions.map((action) => action.name),
+		component: (name) => byName.get(name),
+		toJsonSchema: () => ({
+			$schema: "https://json-schema.org/draft/2020-12/schema",
+			$id: input.id,
+			title: input.title,
+			description: input.instructions,
+			oneOf: input.components.map(componentSchema)
+		}),
+		toPrompt: (options = {}) => promptFor(input, options),
+		validate: (spec) => {
+			const issues = [];
+			validateNode(input, byName, spec, "root", issues);
+			return issues.length === 0 ? { ok: true } : {
+				ok: false,
+				issues
+			};
+		}
+	};
+}
+const tone = z.enum([
+	"neutral",
+	"success",
+	"warning",
+	"info",
+	"destructive"
+]);
+const actionRef = z.object({
+	/** catalog actions 里声明过的名字 */
+	action: z.string().describe("Action name declared by the catalog"),
+	label: z.string(),
+	disabled: z.boolean().optional()
+});
+const CONTENT = [
+	"Stack",
+	"Card",
+	"Separator",
+	"Heading",
+	"Text",
+	"Markdown",
+	"Badge"
+];
+const DATA = [
+	"Metric",
+	"Table",
+	"Chart",
+	"FileLink"
+];
+const INPUT = [
+	"Form",
+	"Field",
+	"Button"
+];
+/**
+* v3 首发 catalog：覆盖既有 `UiSurface` 六类的全部表达力，先窄后宽。
+* 只依赖 zod —— 不 import 任何 UI framework（21 号文档 §5.1）。
+*/
+const uiCatalog = defineUiCatalog({
+	id: "https://webskill.dev/catalogs/v1",
+	version: "1.0.0",
+	title: "WebSkill AI Component Catalog",
+	instructions: [
+		"Compose the answer UI from the components below. Rules:",
+		"",
+		"- The root node of a surface must be `Stack` or `Card`.",
+		"- Ask for user input with `Form` + `Field`; never describe an input in `Text`.",
+		"- A `Button`'s `action` must be one of the catalog actions.",
+		"- Never emit HTML, scripts or remote images.",
+		"- Prefer `Table` for many rows, `Chart` for trends, `Metric` for a single number.",
+		"- At most one `Form` per surface."
+	].join("\n"),
+	components: [
+		{
+			name: "Stack",
+			group: "layout",
+			description: "Vertical or horizontal container. Use it as the root of most surfaces.",
+			props: z.object({
+				direction: z.enum(["vertical", "horizontal"]).default("vertical"),
+				gap: z.enum([
+					"sm",
+					"md",
+					"lg"
+				]).default("md"),
+				align: z.enum([
+					"start",
+					"center",
+					"end",
+					"stretch"
+				]).optional()
+			}),
+			children: "any",
+			example: {
+				component: "Stack",
+				props: { direction: "vertical" },
+				children: [{
+					component: "Heading",
+					props: {
+						level: 2,
+						text: "Q4 results"
+					}
+				}]
+			}
+		},
+		{
+			name: "Card",
+			group: "layout",
+			description: "A titled section that groups related content.",
+			props: z.object({
+				title: z.string(),
+				description: z.string().optional()
+			}),
+			children: "any",
+			example: {
+				component: "Card",
+				props: { title: "Revenue" },
+				children: [{
+					component: "Metric",
+					props: {
+						label: "MRR",
+						value: "12,400"
+					}
+				}]
+			}
+		},
+		{
+			name: "Separator",
+			group: "layout",
+			description: "A horizontal rule between sections.",
+			props: z.object({}),
+			example: { component: "Separator" }
+		},
+		{
+			name: "Heading",
+			group: "content",
+			description: "Section heading. Level 2 is the largest allowed inside a message.",
+			props: z.object({
+				level: z.union([
+					z.literal(2),
+					z.literal(3),
+					z.literal(4)
+				]).default(3),
+				text: z.string()
+			}),
+			example: {
+				component: "Heading",
+				props: {
+					level: 3,
+					text: "Summary"
+				}
+			}
+		},
+		{
+			name: "Text",
+			group: "content",
+			description: "A paragraph of plain text.",
+			props: z.object({
+				text: z.string(),
+				tone: z.enum(["default", "muted"]).default("default")
+			}),
+			example: {
+				component: "Text",
+				props: { text: "Revenue grew 12% quarter over quarter." }
+			}
+		},
+		{
+			name: "Markdown",
+			group: "content",
+			description: "Restricted Markdown (no HTML). Use for lists and emphasis, not for tables.",
+			props: z.object({ text: z.string() }),
+			constraints: ["HTML tags are rejected; use Table for tabular data"],
+			example: {
+				component: "Markdown",
+				props: { text: "- first\n- second" }
+			}
+		},
+		{
+			name: "Badge",
+			group: "content",
+			description: "A short status label.",
+			props: z.object({
+				text: z.string(),
+				tone: tone.default("neutral")
+			}),
+			example: {
+				component: "Badge",
+				props: {
+					text: "active",
+					tone: "success"
+				}
+			}
+		},
+		{
+			name: "Metric",
+			group: "data",
+			description: "A single headline number with an optional change indicator.",
+			props: z.object({
+				label: z.string(),
+				value: z.union([z.string(), z.number()]),
+				change: z.string().optional(),
+				trend: z.enum([
+					"up",
+					"down",
+					"neutral"
+				]).optional()
+			}),
+			example: {
+				component: "Metric",
+				props: {
+					label: "MRR",
+					value: "12,400",
+					trend: "up",
+					change: "+12%"
+				}
+			}
+		},
+		{
+			name: "Table",
+			group: "data",
+			description: "Tabular data with explicit columns. Prefer it over Markdown tables.",
+			props: z.object({
+				columns: z.array(z.string()).min(1),
+				rows: z.array(z.array(z.union([
+					z.string(),
+					z.number(),
+					z.boolean(),
+					z.null()
+				])))
+			}),
+			example: {
+				component: "Table",
+				props: {
+					columns: ["Quarter", "Revenue"],
+					rows: [["Q3", 9800], ["Q4", 12400]]
+				}
+			}
+		},
+		{
+			name: "Chart",
+			group: "data",
+			description: "A bar, line, area or pie chart over labelled series.",
+			props: z.object({
+				type: z.enum([
+					"bar",
+					"line",
+					"area",
+					"pie"
+				]),
+				title: z.string().optional(),
+				labels: z.array(z.string()).min(1),
+				series: z.array(z.object({
+					name: z.string(),
+					values: z.array(z.number())
+				})).min(1)
+			}),
+			example: {
+				component: "Chart",
+				props: {
+					type: "bar",
+					labels: ["Q3", "Q4"],
+					series: [{
+						name: "Revenue",
+						values: [9800, 12400]
+					}]
+				}
+			}
+		},
+		{
+			name: "FileLink",
+			group: "data",
+			description: "A download entry for a run artifact.",
+			props: z.object({
+				path: z.string(),
+				label: z.string().optional(),
+				mimeType: z.string().optional()
+			}),
+			example: {
+				component: "FileLink",
+				props: {
+					path: "report.csv",
+					label: "Download report"
+				}
+			}
+		},
+		{
+			name: "Form",
+			group: "input",
+			description: "Collects user input. Children must be Field nodes; actions go in the buttons prop.",
+			props: z.object({
+				title: z.string().optional(),
+				submitLabel: z.string().default("Submit"),
+				cancelLabel: z.string().optional()
+			}),
+			children: ["Field"],
+			constraints: ["At most one Form per surface", "Every Field name must be unique inside the Form"],
+			example: {
+				component: "Form",
+				props: { title: "Schedule report" },
+				children: [{
+					component: "Field",
+					props: {
+						name: "email",
+						label: "Email",
+						type: "text",
+						required: true
+					}
+				}]
+			}
+		},
+		{
+			name: "Field",
+			group: "input",
+			description: "A single form control. Only valid inside a Form.",
+			props: z.object({
+				name: z.string(),
+				label: z.string(),
+				type: z.enum([
+					"text",
+					"number",
+					"date",
+					"textarea",
+					"select",
+					"multi-select",
+					"toggle",
+					"file"
+				]),
+				required: z.boolean().optional(),
+				description: z.string().optional(),
+				defaultValue: z.unknown().optional(),
+				options: z.array(z.object({
+					label: z.string(),
+					value: z.union([z.string(), z.number()])
+				})).optional()
+			}),
+			constraints: ["select / multi-select must provide options"],
+			example: {
+				component: "Field",
+				props: {
+					name: "range",
+					label: "Range",
+					type: "select",
+					options: []
+				}
+			}
+		},
+		{
+			name: "Button",
+			group: "input",
+			description: "Triggers one of the catalog actions.",
+			props: actionRef,
+			example: {
+				component: "Button",
+				props: {
+					action: "submit",
+					label: "Send"
+				}
+			}
+		},
+		{
+			name: "Alert",
+			group: "feedback",
+			description: "Draws attention to a state the user must know about.",
+			props: z.object({
+				tone: z.enum([
+					"info",
+					"warning",
+					"destructive"
+				]).default("info"),
+				title: z.string(),
+				description: z.string().optional()
+			}),
+			example: {
+				component: "Alert",
+				props: {
+					tone: "warning",
+					title: "Partial data"
+				}
+			}
+		},
+		{
+			name: "Custom",
+			group: "layout",
+			description: "Host extension point; the name must be registered in the host SurfaceRegistry.",
+			props: z.object({
+				name: z.string(),
+				props: z.record(z.string(), z.unknown()).default({})
+			}),
+			constraints: ["Rejected when the host has not registered the component name"],
+			example: {
+				component: "Custom",
+				props: {
+					name: "sales-map",
+					props: {}
+				}
+			}
+		}
+	],
+	actions: [
+		{
+			name: "submit",
+			description: "Submit the surface form values back to the waiting run."
+		},
+		{
+			name: "cancel",
+			description: "Dismiss the surface without submitting."
+		},
+		{
+			name: "select",
+			description: "Report a selected row or option."
+		},
+		{
+			name: "download",
+			description: "Download the referenced artifact."
+		},
+		{
+			name: "refresh",
+			description: "Ask the run to recompute the surface."
+		}
+	]
+});
+/** prompt / 文档里引用的分组顺序（Console 展示同序） */
+const UI_CATALOG_GROUPS = {
+	content: CONTENT,
+	data: DATA,
+	input: INPUT
+};
+/** A2UI 协议公共类型（与 @a2ui/web_core 的 common-types 同一套定义） */
+const A2UI_COMMON_TYPES = "https://a2ui.org/specification/v0_9/common_types.json";
+const CHILD_LIST_REF = `${A2UI_COMMON_TYPES}#/$defs/ChildList`;
+const ACTION_REF = `${A2UI_COMMON_TYPES}#/$defs/Action`;
+const DYNAMIC_VALUE_REF = `${A2UI_COMMON_TYPES}#/$defs/DynamicValue`;
+/** catalog 里承载 action 名的 props 字段 */
+const ACTION_PROP = "action";
+/** 表单控件的标识字段；有它才谈得上把值写进数据模型 */
+const NAME_PROP = "name";
+const SUBMIT_LABEL_PROP = "submitLabel";
+const CANCEL_LABEL_PROP = "cancelLabel";
+/** A2UI 线上形状里表单控件的取值字段 */
+const A2UI_VALUE_PROP = "value";
+/** A2UI 线上形状里的子节点字段 */
+const A2UI_CHILDREN_PROP = "children";
+/** catalog → 每个组件的 A2UI 线上形状 */
+function a2uiComponentShapes(catalog) {
+	const branches = catalog.toJsonSchema()["oneOf"] ?? [];
+	const byName = /* @__PURE__ */ new Map();
+	for (const branch of branches) {
+		const name = (branch.properties?.["component"])?.["const"];
+		if (typeof name === "string") byName.set(name, branch);
+	}
+	return catalog.components.map((def) => {
+		const branch = byName.get(def.name);
+		const props = branch?.properties?.["props"] ?? { type: "object" };
+		const keys = Object.keys(props.properties ?? {});
+		const childrenDescription = (branch?.properties?.["children"])?.description;
+		return {
+			name: def.name,
+			description: def.description,
+			props,
+			staticProps: keys.filter((key) => key !== ACTION_PROP),
+			childList: def.children !== void 0,
+			...childrenDescription ? { childListDescription: childrenDescription } : {},
+			actionProps: keys.filter((key) => key === ACTION_PROP),
+			valueProps: def.group === "input" && keys.includes(NAME_PROP) ? [A2UI_VALUE_PROP] : [],
+			...keys.includes(SUBMIT_LABEL_PROP) ? { submitLabelProp: SUBMIT_LABEL_PROP } : {},
+			...keys.includes(CANCEL_LABEL_PROP) ? { cancelLabelProp: CANCEL_LABEL_PROP } : {}
+		};
+	});
+}
+/** 单个组件的 A2UI props JSON Schema（协议要求每个组件是一份 schema） */
+function a2uiComponentSchema(shape) {
+	const properties = { ...shape.props.properties ?? {} };
+	for (const key of shape.actionProps) properties[key] = {
+		$ref: ACTION_REF,
+		description: "What happens when the user activates this component."
+	};
+	for (const key of shape.valueProps) properties[key] = {
+		$ref: DYNAMIC_VALUE_REF,
+		description: "Two-way binding to the surface data model."
+	};
+	if (shape.childList) properties[A2UI_CHILDREN_PROP] = {
+		$ref: CHILD_LIST_REF,
+		description: shape.childListDescription ? `${shape.childListDescription}. Children are referenced by id, never inlined.` : "Child component ids, in render order."
+	};
+	return {
+		...shape.props,
+		description: shape.description,
+		properties
+	};
+}
+/** 自定义 catalog 的协议 id（对齐 https://a2ui.org/specification/v1_0/catalog_definition.json） */
+const WEBSKILL_A2UI_CATALOG_ID = "https://webskill.dev/a2ui/catalogs/v1/catalog.json";
+/**
+* WebSkill catalog → A2UI `catalog_definition.json`。
+* 组件 schema 由 catalog 的 JSON Schema 投影经 `a2uiComponentShapes` 改写成 A2UI 线上形状
+* （嵌套变 id 引用、action 名变协议信封），不手写第二份词汇表——
+* Lit 元素的 zod API 也由同一份 shape 派生。
+*/
+function buildA2uiCatalogDefinition(catalog) {
+	const components = {};
+	for (const shape of a2uiComponentShapes(catalog)) components[shape.name] = a2uiComponentSchema(shape);
+	return {
+		catalogId: WEBSKILL_A2UI_CATALOG_ID,
+		title: catalog.title,
+		description: `${catalog.title} ${catalog.version}`,
+		instructions: catalog.instructions,
+		components,
+		functions: Object.fromEntries(catalog.actions.map((action) => [action.name, { description: action.description }]))
+	};
+}
+
+//#endregion
+//#region ../ui/dist/index.js
+/** 提交值按请求类型归形（WebFormBridge 与框架组件库共享单一来源） */
+function shapeInteractionValue(model, values) {
+	switch (model.kind) {
+		case "ask": return values["answer"];
+		case "confirm": return values["confirmed"] === true;
+		case "select": return values["selected"];
+		case "authorize": return true;
+		case "form": return values;
+	}
+}
+/** 五类 InteractionRequest → 统一中间模型（框架无关） */
+function interactionToFormModel(request) {
+	switch (request.type) {
+		case "ask": return {
+			kind: "ask",
+			message: request.message,
+			controls: [{
+				name: "answer",
+				label: request.message,
+				control: "text",
+				required: true
+			}],
+			submitLabel: "Submit",
+			cancelLabel: "Cancel"
+		};
+		case "confirm": return {
+			kind: "confirm",
+			message: request.message,
+			controls: [{
+				name: "confirmed",
+				label: request.message,
+				control: "boolean",
+				defaultValue: request.defaultValue ?? true
+			}],
+			submitLabel: "Confirm",
+			cancelLabel: "Cancel"
+		};
+		case "form": return {
+			kind: "form",
+			...request.title ? { title: request.title } : {},
+			controls: request.fields.map((f) => ({
+				name: f.name,
+				label: f.label,
+				control: f.type,
+				...f.required ? { required: true } : {},
+				...f.description ? { description: f.description } : {},
+				...f.defaultValue !== void 0 ? { defaultValue: f.defaultValue } : {},
+				...f.options ? { options: f.options } : {}
+			})),
+			submitLabel: "Submit",
+			cancelLabel: "Cancel"
+		};
+		case "select": return {
+			kind: "select",
+			message: request.message,
+			controls: [{
+				name: "selected",
+				label: request.message,
+				control: "select",
+				required: true,
+				options: request.options
+			}],
+			submitLabel: "Select",
+			cancelLabel: "Cancel"
+		};
+		case "authorize": return {
+			kind: "authorize",
+			title: "Authorization required",
+			message: request.message,
+			controls: [],
+			submitLabel: "Allow",
+			cancelLabel: "Deny"
+		};
+	}
+}
+const isEmpty = (v) => v === void 0 || v === "";
+/**
+* 控件名 → 属性选择器：优先 CSS.escape（标识符形式，免引号转义）；
+* 无 CSS.escape 的环境退化为引号包裹 + 转义反斜杠/双引号（防选择器注入崩溃）
+*/
+function controlSelector(name) {
+	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return `[data-webskill-control=${CSS.escape(name)}]`;
+	return `[data-webskill-control="${name.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"]`;
+}
+/**
+* 严格类型化控件值收集：
+* - number 空串 → undefined（非 0）；非数值输入（NaN）按缺失处理（required 时入 missingRequired）
+* - select 用 option 值本身经 JSON 编码比对命中（对象值可正确命中）
+* - required 空值列入 missingRequired（由调用方阻止提交并标记）
+*/
+function collectValues(controls, container) {
+	const values = {};
+	const missingRequired = [];
+	for (const control of controls) {
+		const el = container.querySelector(controlSelector(control.name));
+		let value;
+		if (el === null) value = void 0;
+		else if (control.control === "boolean") value = el.checked;
+		else if (control.control === "number") {
+			const raw = el.value.trim();
+			if (raw === "") value = void 0;
+			else {
+				const n = Number(raw);
+				value = Number.isNaN(n) ? void 0 : n;
+			}
+		} else if (control.control === "select") {
+			const attr = el.value;
+			const hit = control.options?.find((o) => JSON.stringify(o.value) === attr);
+			value = hit ? hit.value : attr === "" ? void 0 : attr;
+		} else {
+			const raw = el.value;
+			value = raw === "" ? void 0 : raw;
+		}
+		values[control.name] = value;
+		if (control.required && isEmpty(value)) missingRequired.push(control.name);
+	}
+	return {
+		values,
+		missingRequired
+	};
+}
 /** RenderBlock → DOM（markdown/json/table/image/file/chart 六种） */
 function renderBlocks(container, blocks, doc) {
 	for (const block of blocks) switch (block.type) {
@@ -706,7 +1359,174 @@ var WebFormBridge = class {
 		return wrapper;
 	}
 };
+/**
+* 保留的 custom 组件名：catalog 声明树整棵挂在这个 surface 上。
+* `UiSurface` 的六类联合表达不了通用节点树，改造它属破坏性变更（21 号文档 §7 已备案），
+* 因此本轮用一个保留 component 名承载，四档 registry 各自识别它。
+*/
+const UI_SPEC_COMPONENT = "webskill.ui-spec";
+function collectActions(node, out) {
+	if (node.component === "Button" && typeof node.props?.["action"] === "string") out.add(node.props["action"]);
+	if (node.component === "Form") {
+		out.add("submit");
+		if (typeof node.props?.["cancelLabel"] === "string") out.add("cancel");
+	}
+	for (const child of node.children ?? []) collectActions(child, out);
+}
+const INTENTS = /* @__PURE__ */ new Set([
+	"submit",
+	"cancel",
+	"select",
+	"download",
+	"refresh"
+]);
+/** 声明树 → `UiSurface`。id 缺省时由调用方给（工具源用 runtime 生成的 id）。 */
+function toSurface(catalog, spec, id) {
+	const names = /* @__PURE__ */ new Set();
+	collectActions(spec, names);
+	const actions = [...names].filter((name) => INTENTS.has(name)).map((intent) => ({
+		id: intent,
+		label: catalog.actions.find((action) => action.name === intent)?.name ?? intent,
+		intent,
+		...intent === "submit" ? { awaitResponse: true } : {}
+	}));
+	const props = {
+		catalogId: catalog.id,
+		catalogVersion: catalog.version,
+		spec,
+		actions: [...names]
+	};
+	return {
+		kind: "custom",
+		id,
+		component: UI_SPEC_COMPONENT,
+		props,
+		...actions.length > 0 ? { actions } : {}
+	};
+}
+/** surface 是否承载 catalog 声明树（四档 renderer 的分派入口） */
+function isUiSpecSurface(surface) {
+	return surface.kind === "custom" && surface.component === "webskill.ui-spec";
+}
+/**
+* catalog 声明树 → json-render 扁平 spec。纯数据变换，不 import json-render
+* （`@webskill/ui` 保持环境无关）。
+*/
+function toJsonRenderSpec(spec) {
+	const elements = {};
+	let counter = 0;
+	const walk = (node) => {
+		const key = node.id ?? `${node.component.toLowerCase()}-${counter++}`;
+		const children = (node.children ?? []).map(walk);
+		elements[key] = {
+			type: node.component,
+			props: node.props ?? {},
+			...children.length > 0 ? { children } : {}
+		};
+		return key;
+	};
+	return {
+		root: walk(spec),
+		elements
+	};
+}
+const RENDER_UI_TOOL = "render_ui";
+const defaultId = () => `ui-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+/**
+* 把 catalog 变成一个工具的入参 Schema，让模型直接生成声明式 UI（21 号文档 §3）：
+* agentLoop / UiBridge / extractUiSurfaceEvents 全部零改动，装配处只多一个 externalTools 条目。
+*/
+function createUiCatalogToolSource(options = {}) {
+	const catalog = options.catalog ?? uiCatalog;
+	const newSurfaceId = options.newSurfaceId ?? defaultId;
+	return {
+		kind: "ui-catalog",
+		listToolSpecs: () => Promise.resolve([{
+			name: RENDER_UI_TOOL,
+			description: [
+				"Render a user interface for the answer instead of describing it in prose.",
+				"Call it when the user asks for a form, a table, a chart, a metric or a file download.",
+				"",
+				catalog.toPrompt({ mode: "tool-description" })
+			].join("\n"),
+			inputSchema: {
+				type: "object",
+				properties: { spec: catalog.toJsonSchema() },
+				required: ["spec"],
+				additionalProperties: false
+			}
+		}]),
+		canHandle: (name) => name === RENDER_UI_TOOL,
+		call: (_name, args) => {
+			const spec = args["spec"];
+			const result = catalog.validate(spec);
+			if (!result.ok) return Promise.resolve({
+				ok: false,
+				content: [],
+				error: {
+					code: "UI_SPEC_INVALID",
+					message: `The UI spec does not match the catalog: ${result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")}`
+				}
+			});
+			const surface = toSurface(catalog, spec, newSurfaceId());
+			return Promise.resolve({
+				ok: true,
+				content: [{
+					type: "json",
+					data: { $surface: {
+						type: "open",
+						surface
+					} }
+				}, {
+					type: "text",
+					text: `Rendered surface ${surface.id}.`
+				}]
+			});
+		}
+	};
+}
+const WEBSKILL_SURFACE_ACTION = "webskill:surface-action";
+function toUiSurfaceDescriptor(snapshot, provenance) {
+	return {
+		type: "webskill-surface",
+		snapshot,
+		provenance
+	};
+}
+function toUiSurfaceActionDispatch(snapshot, action, value) {
+	return {
+		...snapshot.runId ? { runId: snapshot.runId } : {},
+		surfaceId: snapshot.surface.id,
+		actionId: action.id,
+		intent: action.intent,
+		...action.nonce ? { nonce: action.nonce } : {},
+		...value ? { value } : {}
+	};
+}
+/** Returns undefined for malformed or non-WebSkill renderer events. @experimental */
+function fromUiSurfaceActionDispatch(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const event = value;
+	if (typeof event["surfaceId"] !== "string" || typeof event["actionId"] !== "string" || !isSurfaceActionIntent(event["intent"])) return;
+	return {
+		...typeof event["runId"] === "string" ? { runId: event["runId"] } : {},
+		surfaceId: event["surfaceId"],
+		actionId: event["actionId"],
+		intent: event["intent"],
+		...typeof event["nonce"] === "string" ? { nonce: event["nonce"] } : {},
+		...isRecord(event["value"]) ? { value: event["value"] } : {},
+		...event["cancelled"] === true ? { cancelled: true } : {}
+	};
+}
+function isSurfaceActionIntent(value) {
+	return value === "submit" || value === "cancel" || value === "select" || value === "download" || value === "refresh";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 const VERCEL_INTERACTION_TOOL_NAME = "webskill_interaction";
+const VERCEL_SURFACE_DATA_PART_TYPE = "data-webskill-surface";
+const VERCEL_SURFACE_ACTION_DATA_PART_TYPE = WEBSKILL_SURFACE_ACTION;
 /** InteractionRequest → SDK tool UI 结构（应用聊天 UI 直接消费） */
 function toVercelToolInvocation(request) {
 	return {
@@ -729,6 +1549,20 @@ function fromVercelToolResult(part) {
 		value: p["output"] ?? p["result"] ?? p["value"]
 	};
 }
+/** UiSurfaceSnapshot → AI SDK data part; the SurfaceHost owns renderer selection. @experimental */
+function toVercelSurfaceDataPart(snapshot) {
+	return {
+		type: VERCEL_SURFACE_DATA_PART_TYPE,
+		id: `webskill-surface-${snapshot.surface.id}`,
+		data: toUiSurfaceDescriptor(snapshot, "vercel-surface-host")
+	};
+}
+/** Decodes a nonce-bound action data part emitted by a Vercel SurfaceHost. @experimental */
+function fromVercelSurfaceAction(part) {
+	const event = part;
+	if (event?.type !== "webskill:surface-action") return void 0;
+	return fromUiSurfaceActionDispatch(event.data);
+}
 /**
 * 薄桥接类：request → SDK tool UI 结构 → 应用的聊天 UI（sendInteraction 回调实现）
 * → SDK 回传 → InteractionResponse。
@@ -757,6 +1591,7 @@ const OPENUI_SUBMIT_ACTION = "webskill:submit";
 const OPENUI_CANCEL_ACTION = "webskill:cancel";
 /** authorize 的 Allow 专用动作（提交即批准 → value:true；Deny 走 cancel → cancelled:true） */
 const OPENUI_AUTHORIZE_ACTION = "webskill:authorize";
+const OPENUI_SURFACE_ACTION = WEBSKILL_SURFACE_ACTION;
 const str = (s) => JSON.stringify(s);
 const val = (v) => JSON.stringify(v ?? null);
 function fieldStatements(fields) {
@@ -844,6 +1679,21 @@ function toOpenUiLang(request) {
 	return lines.join("\n");
 }
 /**
+* UiSurfaceSnapshot → OpenUI library program. OpenUI applications provide WebSkillSurfaceHost;
+* its descriptor tells the host whether it is a native extension rather than an OpenUI-native component.
+* @experimental
+*/
+function toOpenUiSurfaceLang(snapshot) {
+	const descriptor = toUiSurfaceDescriptor(snapshot, snapshot.surface.kind === "chart" || snapshot.surface.kind === "table" || snapshot.surface.kind === "custom" ? "openui-extension" : "openui-library");
+	return `root = WebSkillSurfaceHost(${val(descriptor)})`;
+}
+/** Decodes a nonce-bound action emitted by an OpenUI WebSkillSurfaceHost. @experimental */
+function fromOpenUiSurfaceAction(action) {
+	const event = action;
+	if (event?.type !== "webskill:surface-action") return void 0;
+	return fromUiSurfaceActionDispatch(event.params);
+}
+/**
 * OpenUI ActionEvent → InteractionResponse（formState 优先，取消单独分支）
 * @experimental
 */
@@ -874,6 +1724,38 @@ function fromOpenUiAction(action) {
 		value: a.params
 	};
 }
+const literal = (value) => JSON.stringify(value ?? null);
+/** 组件的位置参数顺序 = catalog props 的 schema key 顺序（OpenUI 的 param map 同源） */
+function propOrder(catalog) {
+	const branches = catalog.toJsonSchema()["oneOf"] ?? [];
+	const order = /* @__PURE__ */ new Map();
+	for (const branch of branches) {
+		const name = (branch.properties?.["component"])?.["const"];
+		const props = branch.properties?.["props"];
+		if (typeof name === "string") order.set(name, Object.keys(props?.properties ?? {}));
+	}
+	return order;
+}
+/**
+* catalog 声明树 → openui-lang 文本。语法为每行一条 `id = Component(位置参数…)`，
+* `root = …` 为入口；容器组件的子节点作为最后一个参数传 id 数组。
+*/
+function toOpenUiSpecLang(spec, catalog = uiCatalog) {
+	const order = propOrder(catalog);
+	const lines = [];
+	let counter = 0;
+	const walk = (node) => {
+		const id = node.id ?? `n${counter++}`;
+		const childIds = (node.children ?? []).map(walk);
+		const def = catalog.component(node.component);
+		const args = (order.get(node.component) ?? []).map((key) => literal(node.props?.[key]));
+		if (def?.children !== void 0) args.push(`[${childIds.join(", ")}]`);
+		lines.push(`${id} = ${node.component}(${args.join(", ")})`);
+		return id;
+	};
+	const rootId = walk(spec);
+	return [...lines.filter((line) => !line.startsWith(`${rootId} =`)), `root = ${lines.find((line) => line.startsWith(`${rootId} =`)).slice(rootId.length + 3)}`].join("\n");
+}
 /**
 * InteractionRequest → A2UI 协议消息（v0.9.1，Basic Catalog）。
 * 依据 https://a2ui.org/specification/v0.9-a2ui/：
@@ -889,6 +1771,7 @@ const A2UI_VERSION = "v0.9.1";
 const A2UI_BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json";
 const A2UI_SUBMIT_ACTION = "webskill:submit";
 const A2UI_CANCEL_ACTION = "webskill:cancel";
+const A2UI_SURFACE_ACTION = WEBSKILL_SURFACE_ACTION;
 const text = (id, content, variant) => ({
 	id,
 	component: "Text",
@@ -1022,6 +1905,59 @@ function toA2uiMessages(request) {
 	return messages;
 }
 /**
+* UiSurfaceSnapshot → A2UI extension-host messages.
+* Basic Catalog has no chart/table vocabulary, so a labelled WebSkill host owns these controlled renderers.
+* @experimental
+*/
+function toA2uiSurfaceMessages(snapshot) {
+	const surfaceId = `webskill-surface-${snapshot.surface.id}`;
+	const standard = snapshot.surface.kind === "metric" || snapshot.surface.kind === "file";
+	const descriptor = toUiSurfaceDescriptor(snapshot, standard ? "a2ui-standard" : "a2ui-extension");
+	const component = standard ? {
+		id: "content",
+		component: "Text",
+		text: snapshot.surface.kind === "metric" ? `${snapshot.surface.label}: ${snapshot.surface.value}` : snapshot.surface.kind === "file" ? snapshot.surface.path : ""
+	} : {
+		id: "content",
+		component: "WebSkillSurfaceHost",
+		descriptor,
+		provenance: "WebSkill extension host"
+	};
+	return [{
+		version: A2UI_VERSION,
+		createSurface: {
+			surfaceId,
+			catalogId: A2UI_BASIC_CATALOG_ID,
+			sendDataModel: true
+		}
+	}, {
+		version: A2UI_VERSION,
+		updateComponents: {
+			surfaceId,
+			components: [{
+				id: "root",
+				component: "Column",
+				children: ["content"],
+				justify: "start",
+				align: "stretch"
+			}, component]
+		}
+	}];
+}
+/** Decodes a nonce-bound action emitted by a WebSkill A2UI extension host. @experimental */
+function fromA2uiSurfaceAction(event) {
+	const action = event;
+	if (action?.name !== "webskill:surface-action") return void 0;
+	return fromUiSurfaceActionDispatch(action.context);
+}
+/** Builds the A2UI event payload an extension host sends after a user action. @experimental */
+function toA2uiSurfaceAction(snapshot, action, value) {
+	return {
+		name: A2UI_SURFACE_ACTION,
+		context: toUiSurfaceActionDispatch(snapshot, action, value)
+	};
+}
+/**
 * 按 InteractionRequest.type 解码提交值（绑定模型原样回传的是表单对象）：
 * confirm 仅 confirmed===true 批准；select 还原原始 option 值（非字符串值经 JSON 编码比对）；
 * form 的 number 字段转 number（NaN 保留原值）；ask 取 answer；authorize 提交即批准。
@@ -1091,6 +2027,101 @@ function fromA2uiAction(event, request) {
 		value: e.context
 	};
 }
+/** 声明树里按钮触发的事件名（宿主据 context.actionId 回传 surface action） */
+const A2UI_SPEC_ACTION = "webskill:spec-action";
+/** 表单值在 A2UI 数据模型里的根路径 */
+const A2UI_SPEC_FORM_PATH = "/form";
+/**
+* catalog 声明树 → A2UI 消息序列。
+*
+* 协议要求组件是扁平邻接表且根节点 id 为 `root`，因此这里做树 → 邻接表的展开。
+* 三处改写全部由 `a2uiComponentShapes` 决定，本函数不认识任何具体组件名：
+* - 子节点变成 props.children 里的 id 引用
+* - 表单控件的值经 JSON Pointer 与数据模型双向绑定
+* - 自带提交/取消标签的组件（A2UI 没有表单提交事件）把按钮物化成 Button 子节点，
+*   与 `toA2uiMessages` 对交互请求的处理同一手法
+*/
+function toA2uiSpecMessages(catalog, spec, options) {
+	const shapes = new Map(a2uiComponentShapes(catalog).map((shape) => [shape.name, shape]));
+	const components = [];
+	const defaults = {};
+	let counter = 0;
+	const event = (actionId) => ({ event: {
+		name: A2UI_SPEC_ACTION,
+		context: {
+			...options.context,
+			actionId
+		}
+	} });
+	const button = (id, text, actionId) => {
+		components.push({
+			id,
+			component: "Button",
+			label: text,
+			action: event(actionId)
+		});
+		return id;
+	};
+	const walk = (node, id) => {
+		const props = { ...node.props };
+		const shape = shapes.get(node.component);
+		const children = (node.children ?? []).map((child) => walk(child, child.id ?? `n${counter++}`));
+		for (const key of shape?.valueProps ?? []) {
+			const name = typeof props["name"] === "string" ? props["name"] : id;
+			if (props["defaultValue"] !== void 0) defaults[name] = props["defaultValue"];
+			props[key] = { path: `${A2UI_SPEC_FORM_PATH}/${name}` };
+		}
+		for (const key of shape?.actionProps ?? []) props[key] = event(typeof props[key] === "string" ? props[key] : "select");
+		if (shape?.submitLabelProp) {
+			const text = props[shape.submitLabelProp];
+			children.push(button(`${id}-submit`, typeof text === "string" ? text : "Submit", "submit"));
+		}
+		if (shape?.cancelLabelProp && typeof props[shape.cancelLabelProp] === "string") children.push(button(`${id}-cancel`, props[shape.cancelLabelProp], "cancel"));
+		if (children.length > 0) props[A2UI_CHILDREN_PROP] = children;
+		components.push({
+			...props,
+			id,
+			component: node.component
+		});
+		return id;
+	};
+	walk(spec, "root");
+	const messages = [{
+		version: A2UI_VERSION,
+		createSurface: {
+			surfaceId: options.surfaceId,
+			catalogId: options.catalogId ?? "https://webskill.dev/a2ui/catalogs/v1/catalog.json",
+			sendDataModel: true
+		}
+	}, {
+		version: A2UI_VERSION,
+		updateComponents: {
+			surfaceId: options.surfaceId,
+			components
+		}
+	}];
+	if (Object.keys(defaults).length > 0) messages.push({
+		version: A2UI_VERSION,
+		updateDataModel: {
+			surfaceId: options.surfaceId,
+			path: A2UI_SPEC_FORM_PATH,
+			value: defaults
+		}
+	});
+	return messages;
+}
+/** A2UI action 事件 → 声明树 action（非本 catalog 的事件返回 undefined） */
+function fromA2uiSpecAction(event) {
+	const action = event;
+	if (action?.name !== "webskill:spec-action") return void 0;
+	const context = action.context ?? {};
+	const actionId = context["actionId"];
+	if (typeof actionId !== "string") return void 0;
+	return {
+		actionId,
+		context
+	};
+}
 let loading;
 function loadA2uiRuntime() {
 	loading ??= (async () => {
@@ -1158,6 +2189,38 @@ var LitRendererBridge = class {
 		});
 	}
 };
+/**
+* BYOC Lit 元素的加载入口。
+*
+* 元素模块静态依赖 `lit` 与 `@a2ui/*`（三者都是 optional peer），
+* 因此只能经动态 import 进来：未用 A2UI 档的应用不为这段体积买单，
+* 缺依赖时给出带安装提示的 `UI_UNAVAILABLE`，而不是一个空白 surface。
+*/
+async function loadWebSkillLitCatalog() {
+	try {
+		const { webskillLitCatalog } = await import("./webskillLitCatalog-CNaUpasU-CfSRvqCZ.js");
+		return webskillLitCatalog();
+	} catch (cause) {
+		throw new WebSkillError("UI_UNAVAILABLE", "The WebSkill A2UI catalog is unavailable; install @a2ui/lit, @a2ui/web_core and lit to render catalog surfaces with A2UI", cause);
+	}
+}
+/**
+* Loads the optional OpenUI peers (@openuidev/react-lang and zod) for the OpenUI
+* interaction/surface paths. Throws a WebSkillError with code UI_UNAVAILABLE and an
+* install hint when either peer is missing, so callers can fall back to native
+* rendering instead of leaving a blank surface.
+*/
+async function loadOpenUiPeers() {
+	try {
+		const [openuiModule, zodModule] = await Promise.all([import("./dist-DxyxmXPU-DGC-dpXf.js"), import("zod")]);
+		return {
+			openui: openuiModule,
+			z: zodModule.z
+		};
+	} catch (cause) {
+		throw new WebSkillError("UI_UNAVAILABLE", "The OpenUI renderer is unavailable; install @openuidev/react-lang and zod to render surfaces and interactions with the OpenUI track", cause);
+	}
+}
 
 //#endregion
-export { renderMiniChart as C, toA2uiMessages as D, shapeInteractionValue as E, toOpenUiLang as O, renderBlocks as S, renderRenderResult as T, ensureStyles as _, CHART_PALETTE as a, fromVercelToolResult as b, OPENUI_CANCEL_ACTION as c, VercelUiBridge as d, WEBSKILL_STYLES_CSS as f, decodeInteractionResponse as g, collectValues as h, A2UI_VERSION as i, toVercelToolInvocation as k, OPENUI_SUBMIT_ACTION as l, chartToTable as m, A2UI_CANCEL_ACTION as n, LitRendererBridge as o, WebFormBridge as p, A2UI_SUBMIT_ACTION as r, OPENUI_AUTHORIZE_ACTION as s, A2UI_BASIC_CATALOG_ID as t, VERCEL_INTERACTION_TOOL_NAME as u, fromA2uiAction as v, renderMiniMarkdown as w, interactionToFormModel as x, fromOpenUiAction as y };
+export { toVercelToolInvocation as $, fromOpenUiSurfaceAction as A, shapeInteractionValue as B, createUiCatalogToolSource as C, fromA2uiSpecAction as D, fromA2uiAction as E, isUiSpecSurface as F, toJsonRenderSpec as G, toA2uiSpecMessages as H, loadOpenUiPeers as I, toOpenUiSurfaceLang as J, toOpenUiLang as K, loadWebSkillLitCatalog as L, fromVercelSurfaceAction as M, fromVercelToolResult as N, fromA2uiSurfaceAction as O, interactionToFormModel as P, toVercelSurfaceDataPart as Q, renderBlocks as R, collectValues as S, ensureStyles as T, toA2uiSurfaceAction as U, toA2uiMessages as V, toA2uiSurfaceMessages as W, toUiSurfaceActionDispatch as X, toSurface as Y, toUiSurfaceDescriptor as Z, VERCEL_SURFACE_DATA_PART_TYPE as _, A2UI_SUBMIT_ACTION as a, a2uiComponentSchema as at, WEBSKILL_SURFACE_ACTION as b, LitRendererBridge as c, chartToTable as ct, OPENUI_SUBMIT_ACTION as d, renderMiniMarkdown as dt, A2UI_CHILDREN_PROP as et, OPENUI_SURFACE_ACTION as f, uiCatalog as ft, VERCEL_SURFACE_ACTION_DATA_PART_TYPE as g, VERCEL_INTERACTION_TOOL_NAME as h, A2UI_SPEC_FORM_PATH as i, WEBSKILL_A2UI_CATALOG_ID as it, fromUiSurfaceActionDispatch as j, fromOpenUiAction as k, OPENUI_AUTHORIZE_ACTION as l, defineUiCatalog as lt, UI_SPEC_COMPONENT as m, A2UI_CANCEL_ACTION as n, CHART_PALETTE as nt, A2UI_SURFACE_ACTION as o, a2uiComponentShapes as ot, RENDER_UI_TOOL as p, toOpenUiSpecLang as q, A2UI_SPEC_ACTION as r, UI_CATALOG_GROUPS as rt, A2UI_VERSION as s, buildA2uiCatalogDefinition as st, A2UI_BASIC_CATALOG_ID as t, A2UI_COMMON_TYPES as tt, OPENUI_CANCEL_ACTION as u, renderMiniChart as ut, VercelUiBridge as v, decodeInteractionResponse as w, WebFormBridge as x, WEBSKILL_STYLES_CSS as y, renderRenderResult as z };