@webskill/sdk 0.29.0 → 0.30.0-next.1

package/dist/ui-react.js

@@ -7,7 +7,7 @@ import minpath from "node:path";
 import { fileURLToPath as urlToPath } from "node:url";
 import { z } from "zod";
 import * as React$10 from "react";
-import React, { createContext, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import React, { createContext, createElement, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import * as ReactDOM from "react-dom";
 import { flushSync } from "react-dom";
@@ -412,8 +412,8 @@ var ReactBridgeState = class {
 /**
 * 表单与宿主控件文案的注入口（FR-22.4 / 偏差 D-14 方向 A）。
 *
-* `ui-react` 自己**不持有任何文案**：字典在 chatbot 与 console 各一份，
-* 而 `ui-react` 被两者共同消费，import 任何一方都是错的依赖方向。
+* 嵌入套件是唯一持有文案的例外：它的宿主没有 chatbot 字典。
+* 对照测试防止嵌入字典与 chatbot 的同名文案漂移；其它路径仍由宿主注入。
 * 缺省值是英文，不注入时行为与改造前一致。
 */
 const SurfaceFormTextsContext = createContext(DEFAULT_SURFACE_FORM_TEXTS);
@@ -747,6 +747,17 @@ function SurfaceDegradationNote({ degradations }) {
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(SurfaceRejectionAlert, { degradations }), /* @__PURE__ */ jsx(SurfaceSimplifiedNote, { degradations })] });
 }
 
+//#endregion
+//#region ../ui-kit/src/i18n/createI18n.ts
+const LocaleContext = createContext("en");
+function LocaleProvider({ locale, children }) {
+	return createElement(LocaleContext.Provider, { value: locale }, children);
+}
+/** 当前 locale；未包 LocaleProvider 时默认 'en' */
+function useLocale() {
+	return useContext(LocaleContext);
+}
+
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/cjs/lucide-react.js
 /**
@@ -40767,6 +40778,32 @@ function useThemeValue() {
 function usePortalContainer() {
 	return useContext(PortalContainerContext);
 }
+/**
+* 渲染主题作用域容器。暗色下同时挂 `.dark` 与 `data-theme='dark'`：
+* 前者是 tailwind 变体的钩子，后者供不依赖 class 的消费方（图表、代码高亮）判定。
+* @experimental
+*/
+function ThemeScope({ theme, className = "", children, ref, ...props }) {
+	const [portalContainer, setPortalContainer] = useState(void 0);
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		ref,
+		className: `${theme === "dark" ? "dark " : ""}${className}`,
+		"data-webskill-theme": theme,
+		"data-theme": theme,
+		children: [/* @__PURE__ */ jsx(ThemeValueContext.Provider, {
+			value: theme,
+			children: /* @__PURE__ */ jsx(PortalContainerContext.Provider, {
+				value: portalContainer,
+				children
+			})
+		}), /* @__PURE__ */ jsx("div", {
+			ref: (node) => setPortalContainer(node ?? void 0),
+			"data-webskill-portal-root": "",
+			className: "fixed top-0 left-0 z-[var(--webskill-z-overlay)] h-0 w-0"
+		})]
+	});
+}
 
 //#endregion
 //#region ../../node_modules/.pnpm/@radix-ui+number@1.1.3/node_modules/@radix-ui/number/dist/index.mjs
@@ -135857,12 +135894,17 @@ function hasNoChoices(field) {
 * `number` 那条不是可有可无的：数字框里打字母得到 `NaN`，而 `NaN` 不属于 `isBlank`，
 * 过去能通过必填校验并原样提交出去。
 */
-function schemaOfField(field, texts) {
+const REQUIRED_ERROR = "webskill.required";
+function validationMessage(message, texts) {
+	if (typeof message !== "string") return void 0;
+	return message === REQUIRED_ERROR ? texts.required : message;
+}
+function schemaOfField(field) {
 	const required = field["required"] === true;
 	const type = str(field, "type", "text");
 	if (hasNoChoices(field)) return z.unknown();
 	if (type === "number") {
-		const base = z.number({ error: texts.required }).refine((value) => !Number.isNaN(value), texts.required);
+		const base = z.number({ error: REQUIRED_ERROR }).refine((value) => !Number.isNaN(value), REQUIRED_ERROR);
 		return required ? base : z.union([
 			base,
 			z.undefined(),
@@ -135870,7 +135912,7 @@ function schemaOfField(field, texts) {
 		]);
 	}
 	if (type === "toggle") return z.unknown();
-	const base = z.unknown().refine((value) => !isBlank(value), texts.required);
+	const base = z.unknown().refine((value) => !isBlank(value), REQUIRED_ERROR);
 	return required ? base : z.unknown();
 }
 /**
@@ -135949,11 +135991,10 @@ function useSurfaceForm({ surfaceId, spec, actions, runId, draft, onAction, onDr
 		scoping
 	]);
 	const schema = useMemo(() => z.object({
-		...Object.fromEntries(registry.entries.map((entry) => [registry.nameOf.get(entry.key), schemaOfField(entry.field, texts)])),
-		...Object.fromEntries(fieldArrays.map((array) => [arrayNames.get(array.key), z.array(z.object(Object.fromEntries(array.fields.map((f) => [String(f["name"]), schemaOfField(f, texts)]))))]))
+		...Object.fromEntries(registry.entries.map((entry) => [registry.nameOf.get(entry.key), schemaOfField(entry.field)])),
+		...Object.fromEntries(fieldArrays.map((array) => [arrayNames.get(array.key), z.array(z.object(Object.fromEntries(array.fields.map((f) => [String(f["name"]), schemaOfField(f)]))))]))
 	}), [
 		registry,
-		texts,
 		fieldArrays,
 		arrayNames
 	]);
@@ -136003,10 +136044,15 @@ function useSurfaceForm({ surfaceId, spec, actions, runId, draft, onAction, onDr
 		const out = {};
 		for (const [name, issue] of Object.entries(rhf.formState.errors)) {
 			const key = registry.keyOf.get(name);
-			if (key !== void 0 && typeof issue?.message === "string") out[key] = issue.message;
+			const message = validationMessage(issue?.message, texts);
+			if (key !== void 0 && message !== void 0) out[key] = message;
 		}
 		return out;
-	}, [registry, rhf.formState.errors]);
+	}, [
+		registry,
+		rhf.formState.errors,
+		texts
+	]);
 	/**
 	* `visibleWhen` 求值（FR-23.1）。条件里的字段名按同一作用域限定，
 	* 否则两个 Form 里的同名字段会互相控制对方的显隐。
@@ -136099,8 +136145,7 @@ function useSurfaceForm({ surfaceId, spec, actions, runId, draft, onAction, onDr
 			rhf.clearErrors(name);
 		},
 		errorAt: (name) => {
-			const message = name.split(".").reduce((current, part) => current?.[part], rhf.formState.errors)?.message;
-			return typeof message === "string" ? message : void 0;
+			return validationMessage(name.split(".").reduce((current, part) => current?.[part], rhf.formState.errors)?.message, texts);
 		},
 		fieldArray: (key) => fieldArrays.find((array) => array.key === key),
 		resolveActionId,
@@ -136357,6 +136402,7 @@ function SurfaceFieldArray({ form, props, scope }) {
 function SurfaceFormButtons({ form, props, scope }) {
 	const submitId = scope ? scope.submitActionId : form.resolveActionId("submit");
 	const cancelId = scope ? scope.cancelActionId : form.resolveActionId("cancel");
+	const texts = useSurfaceFormTexts();
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-wrap items-center justify-end gap-2",
 		children: [props["cancelLabel"] ? /* @__PURE__ */ jsx(Button, {
@@ -136370,7 +136416,7 @@ function SurfaceFormButtons({ form, props, scope }) {
 			type: "submit",
 			size: "sm",
 			"data-webskill-surface-action": submitId,
-			children: str(props, "submitLabel", "Submit")
+			children: str(props, "submitLabel", texts.submit)
 		})]
 	});
 }
@@ -136493,6 +136539,7 @@ function SpecTimeline({ props }) {
 function SpecProgress({ props }) {
 	const value = Math.max(0, Math.min(100, num(props, "value", 0)));
 	const label = str(props, "label");
+	const locale = useLocale();
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col gap-1",
 		children: [label ? /* @__PURE__ */ jsx("span", {
@@ -136500,7 +136547,7 @@ function SpecProgress({ props }) {
 			children: label
 		}) : null, /* @__PURE__ */ jsx("div", {
 			role: "progressbar",
-			"aria-label": label || "Progress",
+			"aria-label": label || (locale === "zh" ? "进度" : "Progress"),
 			"aria-valuenow": value,
 			"aria-valuemin": 0,
 			"aria-valuemax": 100,
@@ -136612,6 +136659,7 @@ function SpecKeyValue({ props }) {
 	});
 }
 function SpecGauge({ props }) {
+	const locale = useLocale();
 	const min = num(props, "min", 0);
 	const max = num(props, "max", 100);
 	const value = num(props, "value", min);
@@ -136627,7 +136675,7 @@ function SpecGauge({ props }) {
 			}) : null,
 			/* @__PURE__ */ jsx("div", {
 				role: "meter",
-				"aria-label": label || "Gauge",
+				"aria-label": label || (locale === "zh" ? "仪表" : "Gauge"),
 				"aria-valuenow": value,
 				"aria-valuemin": min,
 				"aria-valuemax": max,
@@ -136751,6 +136799,10 @@ const TONE_CLASS = {
 	info: "text-info",
 	destructive: "text-destructive"
 };
+const FILE_LINK_TEXTS = {
+	en: "Download",
+	zh: "下载"
+};
 function renderNode(node, context, key, scope) {
 	const props = node.props ?? {};
 	const nodeScope = node.component === "Form" ? context.scopeOfNode(node) : scope;
@@ -136813,7 +136865,7 @@ function renderNode(node, context, key, scope) {
 			return /* @__PURE__ */ jsx(SpecTable, {
 				columns,
 				rows,
-				label: str(props, "title", "Data"),
+				label: str(props, "title", context.locale === "zh" ? "数据" : "Data"),
 				...columnWidths ? { columnWidths } : {}
 			}, key);
 		}
@@ -136851,7 +136903,7 @@ function renderNode(node, context, key, scope) {
 				variant: "secondary",
 				"data-webskill-surface-action": context.resolveActionId("download", node.id),
 				onClick: () => context.emit(context.resolveActionId("download", node.id)),
-				children: str(props, "label", "Download")
+				children: str(props, "label", FILE_LINK_TEXTS[context.locale])
 			})]
 		}, key);
 		case "Form": return /* @__PURE__ */ jsxs("form", {
@@ -136958,6 +137010,7 @@ function NativeSpecSurface({ surfaceId, spec, actions, registry, runId, draft, o
 	});
 	const context = {
 		...form,
+		locale: useLocale(),
 		registry,
 		onAction,
 		documentSurface,
@@ -137080,11 +137133,16 @@ const CatalogSurfaceContext = createContext(void 0);
 /**
 * 文档投放面在 json-render / openui 两档里的能力缺失说明（0.15.0 分册 13 §3.3）。
 *
-* 面向的是**接入方**而不是终端用户，因此按 AGENTS.md 第 1 条写成英文、不进字典——
-* 与同文件里的 `Unsupported registered surface`、`Invalid UI spec` 同一体例。
-* AC-13.9 要求双语的是按钮文案，那一条走 `SurfaceFormTexts`，两者不冲突。
+* 嵌入套件内按宿主语言显示；其它组件缺依赖的诊断仍保持英文。
+* AC-13.9 的按钮文案走 `SurfaceFormTexts`，两者不冲突。
 */
-const DOCUMENT_SURFACE_UNSUPPORTED = "Document surface is not supported by this renderer";
+function CatalogOpenDocument() {
+	return /* @__PURE__ */ jsx("div", {
+		role: "alert",
+		className: "text-sm text-destructive",
+		children: useLocale() === "zh" ? "当前渲染器不支持文档投放" : "Document surface is not supported by this renderer"
+	});
+}
 function useCatalogSurfaceForm() {
 	const form = useContext(CatalogSurfaceContext);
 	if (!form) throw new WebSkillError("UI_UNAVAILABLE", "Catalog surface components must be rendered inside a CatalogSurfaceProvider");
@@ -137257,7 +137315,7 @@ const catalogComponentImpls = {
 		const columns = Array.isArray(props["columns"]) ? props["columns"] : [];
 		const rows = Array.isArray(props["rows"]) ? props["rows"] : [];
 		return /* @__PURE__ */ jsxs(DataTable, {
-			"aria-label": str(props, "title", "Data"),
+			"aria-label": str(props, "title", useLocale() === "zh" ? "数据" : "Data"),
 			children: [/* @__PURE__ */ jsx("thead", {
 				className: "webskill-surface__table-header",
 				children: /* @__PURE__ */ jsx("tr", { children: columns.map((column) => /* @__PURE__ */ jsx("th", {
@@ -137315,11 +137373,7 @@ const catalogComponentImpls = {
 		className: "text-sm text-destructive",
 		children: ["Unsupported registered surface: ", str(props, "name")]
 	}),
-	OpenDocument: () => /* @__PURE__ */ jsx("div", {
-		role: "alert",
-		className: "text-sm text-destructive",
-		children: DOCUMENT_SURFACE_UNSUPPORTED
-	})
+	OpenDocument: CatalogOpenDocument
 };
 
 //#endregion
@@ -140019,7 +140073,7 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 	const [unavailable, setUnavailable] = useState(false);
 	useEffect(() => {
 		let cancelled = false;
-		import("./openUiLibrary-BnhYUlqY.js").then((loaded) => {
+		import("./openUiLibrary-BjRDYyTe.js").then((loaded) => {
 			if (!cancelled) setModule(loaded);
 		}).catch(() => {
 			if (!cancelled) setUnavailable(true);
@@ -140058,4 +140112,70 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 }
 
 //#endregion
-export { ChartColorsProvider, ChartFontSizesProvider, InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceFormTextsProvider, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, CatalogNode as t, useChartColors, useChartFontSizes, useSurfaceFormTexts, useSurfaceHostControlTexts };
+//#region ../ui-react/src/embed/texts.ts
+const EMBED_FORM_TEXTS = {
+	en: {
+		required: "This field is required",
+		submit: "Submit",
+		cancel: "Cancel",
+		addItem: "Add",
+		removeItem: "Remove",
+		arrayFirstItemOnly: "This renderer shows only the first item of a repeatable group.",
+		readOnlySnapshot: "This is a saved record — its actions are no longer available.",
+		suggested: "Suggested:",
+		useSuggestion: "Use",
+		openDocument: "Open document",
+		noOptions: "No options are available for this field."
+	},
+	zh: {
+		required: "该字段为必填项",
+		submit: "提交",
+		cancel: "取消",
+		addItem: "添加",
+		removeItem: "移除",
+		arrayFirstItemOnly: "当前渲染档只显示重复组的第一项。",
+		readOnlySnapshot: "这是已保存的记录，其中的操作已不可用。",
+		suggested: "建议：",
+		useSuggestion: "使用",
+		openDocument: "打开文档",
+		noOptions: "该字段没有可选项。"
+	}
+};
+const EMBED_CONTROL_TEXTS = {
+	en: {
+		previousPage: "Previous page",
+		previous: "Previous",
+		nextPage: "Next page",
+		next: "Next",
+		carousel: "Carousel"
+	},
+	zh: {
+		previousPage: "上一页",
+		previous: "上一页",
+		nextPage: "下一页",
+		next: "下一页",
+		carousel: "轮播"
+	}
+};
+
+//#endregion
+//#region ../ui-react/src/embed/EmbedScope.tsx
+/** @experimental */
+function EmbedScope({ theme, locale, className, children }) {
+	return /* @__PURE__ */ jsx(ThemeScope, {
+		theme,
+		className,
+		"data-webskill-embed": "",
+		children: /* @__PURE__ */ jsx(LocaleProvider, {
+			locale,
+			children: /* @__PURE__ */ jsx(SurfaceFormTextsProvider, {
+				texts: EMBED_FORM_TEXTS[locale],
+				hostControlTexts: EMBED_CONTROL_TEXTS[locale],
+				children
+			})
+		})
+	});
+}
+
+//#endregion
+export { ChartColorsProvider, ChartFontSizesProvider, EmbedScope, InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceFormTextsProvider, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, CatalogNode as t, useChartColors, useChartFontSizes, usePortalContainer, useSurfaceFormTexts, useSurfaceHostControlTexts };

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { S as UiBridge, b as RenderResultRequest, c as InteractionResponse, s as InteractionRequest } from "./types-wKp3YBSM-D7w-ZbsB.js";
+import { S as UiBridge, b as RenderResultRequest, c as InteractionResponse, s as InteractionRequest } from "./types-wKp3YBSM-CSeFUL9R.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts

package/dist/ui.d.ts

@@ -1,4 +1,4 @@
-import { Nt as UiSpecNode } from "./types-wKp3YBSM-D7w-ZbsB.js";
-import { Cr as buildRenderResult } from "./index-Cngzg2WS.js";
-import { $ as SPEC_TABLE_MIN_COLUMN_WIDTH, $t as fromA2uiSpecAction, A as DocumentComponentName, An as toJsonRenderSpec, At as ViewerComponentsOptions, B as FieldOption, Bt as buildA2uiCatalogDefinition, C as DEFAULT_CHART_COLORS, Cn as resolveSurfaceFormTexts, Ct as VERCEL_INTERACTION_TOOL_NAME, D as DEFAULT_SURFACE_HOST_CONTROL_TEXTS, Dn as toA2uiSpecMessages, Dt as VercelToolInvocation, E as DEFAULT_SURFACE_FORM_TEXTS, En as shapeInteractionValue, Et as VIEWER_PROPS_ATTR, F as EchartOptionDegradation, Fn as uiPreset, Ft as ZodRuntime, G as LoadedOpenUiPeers, Gt as collectScopedValues, H as InteractionSpecLabels, Ht as chartSpecFromProps, I as EchartOptionHandle, It as a2uiComponentSchema, J as OpenUiRendererProps, Jt as createUiCatalogToolSource, K as MAX_CONDITION_DEPTH, Kt as collectSpecActions, L as EvaluateFieldConditionOptions, Lt as a2uiComponentShapes, M as EchartFallback, Mn as toUiSurfaceActionDispatch, Mt as WEBSKILL_STYLES_CSS, N as EchartHandle, Nn as toVercelToolInvocation, Nt as WEBSKILL_SURFACE_ACTION, O as DESCRIBE_UI_PRESET_TOOL, On as toA2uiSurfaceAction, Ot as VercelUiBridge, P as EchartOption, Pn as uiCatalog, Pt as WebFormBridge, Q as SPEC_TABLE_MIN_COLUMN_VAR, Qt as evaluateFieldCondition, R as FieldCondition, Rt as applyEchartTheme, S as ControlModel, Sn as resolveInteractionTexts, St as UiSurfaceActionDispatch, T as DEFAULT_INTERACTION_TEXTS, Tn as sanitizeEchartOption, Tt as VIEWER_FALLBACK_ATTR, U as InteractionTexts, Ut as chartToTable, V as FormModel, Vt as chartSpecFromEchartsOption, W as JsonRenderSpec, Wt as collectFormScopes, X as PLANNED_INCREMENT, Xt as echartOptionFromProps, Y as OpenUiRuntime, Yt as defineUiCatalog, Z as RENDER_UI_TOOL, Zt as ensureStyles, _ as CHART_PALETTE, _n as renderMiniMarkdown, _t as UiSpecDegradation, a as A2UI_SURFACE_ACTION, an as interactionToUiSpec, at as UI_CATALOG_PROMPT_BUDGET_BYTES, b as CollectedValues, bn as resolveChartFontSizes, bt as UiSpecSanitization, c as A2uiCatalogDefinition, cn as mountEchart, ct as UiActionDef, d as A2uiMessage, dn as normalizeColumnWidths, dt as UiCatalogPromptOptions, en as fromA2uiSurfaceAction, et as SanitizedEchartOption, f as A2uiSpecActionEvent, fn as normalizeFieldOptions, ft as UiCatalogToolSourceOptions, g as CATALOG_SCHEMA_MAX, gn as renderMiniChart, gt as UiPresetName, h as CATALOG_PROMPT_MAX, hn as renderEchartFallback, ht as UiPreset, i as A2UI_SPEC_FORM_PATH, in as interactionToFormModel, it as UI_CATALOG_GROUPS, j as ECHART_SERIES_TYPES, jn as toOpenUiSpecLang, jt as WEBSKILL_A2UI_CATALOG_ID, k as DOCUMENT_COMPONENTS, kn as toEchartsOption, kt as ViewerComponentsHandle, l as A2uiCatalogHandle, ln as mountEchartOption, lt as UiCatalog, m as CATALOG_BUDGET_STAGE, mn as renderBlocks, mt as UiFormScope, n as A2UI_COMMON_TYPES, nn as fromVercelToolResult, nt as SurfaceFormTexts, o as A2UI_VERSION, on as loadOpenUiPeers, ot as UI_PRESETS, p as A2uiSpecMessageOptions, pn as qualifyFieldName, pt as UiComponentDef, q as NormalizedColumnWidths, qt as collectValues, r as A2UI_SPEC_ACTION, rn as gaugePercent, rt as SurfaceHostControlTexts, s as A2uiCatalogComponent, sn as loadWebSkillLitCatalog, st as UI_PRESET_NAMES, t as A2UI_BASIC_CATALOG_ID, tn as fromUiSurfaceActionDispatch, tt as SpecColumnMeta, u as A2uiComponentShape, un as mountViewerComponents, ut as UiCatalogInput, v as ChartColors, vn as renderRenderResult, vt as UiSpecDegradationCode, w as DEFAULT_CHART_FONT_SIZES, wn as resolveSurfaceHostControlTexts, wt as VIEWER_COMPONENT_ATTR, x as ColumnWidthsRejection, xn as resolveColumnWidths, xt as UiSpecValidation, y as ChartFontSizes, yn as resolveChartColors, yt as UiSpecIssue, z as FieldConditionResult, zt as applySuggestion } from "./index-C3t1jKAs.js";
+import { Nt as UiSpecNode } from "./types-wKp3YBSM-CSeFUL9R.js";
+import { Cr as buildRenderResult } from "./index-UbNuzd2a.js";
+import { $ as SPEC_TABLE_MIN_COLUMN_WIDTH, $t as fromA2uiSpecAction, A as DocumentComponentName, An as toJsonRenderSpec, At as ViewerComponentsOptions, B as FieldOption, Bt as buildA2uiCatalogDefinition, C as DEFAULT_CHART_COLORS, Cn as resolveSurfaceFormTexts, Ct as VERCEL_INTERACTION_TOOL_NAME, D as DEFAULT_SURFACE_HOST_CONTROL_TEXTS, Dn as toA2uiSpecMessages, Dt as VercelToolInvocation, E as DEFAULT_SURFACE_FORM_TEXTS, En as shapeInteractionValue, Et as VIEWER_PROPS_ATTR, F as EchartOptionDegradation, Fn as uiPreset, Ft as ZodRuntime, G as LoadedOpenUiPeers, Gt as collectScopedValues, H as InteractionSpecLabels, Ht as chartSpecFromProps, I as EchartOptionHandle, It as a2uiComponentSchema, J as OpenUiRendererProps, Jt as createUiCatalogToolSource, K as MAX_CONDITION_DEPTH, Kt as collectSpecActions, L as EvaluateFieldConditionOptions, Lt as a2uiComponentShapes, M as EchartFallback, Mn as toUiSurfaceActionDispatch, Mt as WEBSKILL_STYLES_CSS, N as EchartHandle, Nn as toVercelToolInvocation, Nt as WEBSKILL_SURFACE_ACTION, O as DESCRIBE_UI_PRESET_TOOL, On as toA2uiSurfaceAction, Ot as VercelUiBridge, P as EchartOption, Pn as uiCatalog, Pt as WebFormBridge, Q as SPEC_TABLE_MIN_COLUMN_VAR, Qt as evaluateFieldCondition, R as FieldCondition, Rt as applyEchartTheme, S as ControlModel, Sn as resolveInteractionTexts, St as UiSurfaceActionDispatch, T as DEFAULT_INTERACTION_TEXTS, Tn as sanitizeEchartOption, Tt as VIEWER_FALLBACK_ATTR, U as InteractionTexts, Ut as chartToTable, V as FormModel, Vt as chartSpecFromEchartsOption, W as JsonRenderSpec, Wt as collectFormScopes, X as PLANNED_INCREMENT, Xt as echartOptionFromProps, Y as OpenUiRuntime, Yt as defineUiCatalog, Z as RENDER_UI_TOOL, Zt as ensureStyles, _ as CHART_PALETTE, _n as renderMiniMarkdown, _t as UiSpecDegradation, a as A2UI_SURFACE_ACTION, an as interactionToUiSpec, at as UI_CATALOG_PROMPT_BUDGET_BYTES, b as CollectedValues, bn as resolveChartFontSizes, bt as UiSpecSanitization, c as A2uiCatalogDefinition, cn as mountEchart, ct as UiActionDef, d as A2uiMessage, dn as normalizeColumnWidths, dt as UiCatalogPromptOptions, en as fromA2uiSurfaceAction, et as SanitizedEchartOption, f as A2uiSpecActionEvent, fn as normalizeFieldOptions, ft as UiCatalogToolSourceOptions, g as CATALOG_SCHEMA_MAX, gn as renderMiniChart, gt as UiPresetName, h as CATALOG_PROMPT_MAX, hn as renderEchartFallback, ht as UiPreset, i as A2UI_SPEC_FORM_PATH, in as interactionToFormModel, it as UI_CATALOG_GROUPS, j as ECHART_SERIES_TYPES, jn as toOpenUiSpecLang, jt as WEBSKILL_A2UI_CATALOG_ID, k as DOCUMENT_COMPONENTS, kn as toEchartsOption, kt as ViewerComponentsHandle, l as A2uiCatalogHandle, ln as mountEchartOption, lt as UiCatalog, m as CATALOG_BUDGET_STAGE, mn as renderBlocks, mt as UiFormScope, n as A2UI_COMMON_TYPES, nn as fromVercelToolResult, nt as SurfaceFormTexts, o as A2UI_VERSION, on as loadOpenUiPeers, ot as UI_PRESETS, p as A2uiSpecMessageOptions, pn as qualifyFieldName, pt as UiComponentDef, q as NormalizedColumnWidths, qt as collectValues, r as A2UI_SPEC_ACTION, rn as gaugePercent, rt as SurfaceHostControlTexts, s as A2uiCatalogComponent, sn as loadWebSkillLitCatalog, st as UI_PRESET_NAMES, t as A2UI_BASIC_CATALOG_ID, tn as fromUiSurfaceActionDispatch, tt as SpecColumnMeta, u as A2uiComponentShape, un as mountViewerComponents, ut as UiCatalogInput, v as ChartColors, vn as renderRenderResult, vt as UiSpecDegradationCode, w as DEFAULT_CHART_FONT_SIZES, wn as resolveSurfaceHostControlTexts, wt as VIEWER_COMPONENT_ATTR, x as ColumnWidthsRejection, xn as resolveColumnWidths, xt as UiSpecValidation, y as ChartFontSizes, yn as resolveChartColors, yt as UiSpecIssue, z as FieldConditionResult, zt as applySuggestion } from "./index-1ASrUwzn.js";
 export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, type A2uiCatalogComponent, type A2uiCatalogDefinition, type A2uiCatalogHandle, type A2uiComponentShape, type A2uiMessage, type A2uiSpecActionEvent, type A2uiSpecMessageOptions, CATALOG_BUDGET_STAGE, CATALOG_PROMPT_MAX, CATALOG_SCHEMA_MAX, CHART_PALETTE, type ChartColors, type ChartFontSizes, type CollectedValues, type ColumnWidthsRejection, type ControlModel, DEFAULT_CHART_COLORS, DEFAULT_CHART_FONT_SIZES, DEFAULT_INTERACTION_TEXTS, DEFAULT_SURFACE_FORM_TEXTS, DEFAULT_SURFACE_HOST_CONTROL_TEXTS, DESCRIBE_UI_PRESET_TOOL, DOCUMENT_COMPONENTS, type DocumentComponentName, ECHART_SERIES_TYPES, type EchartFallback, type EchartHandle, type EchartOption, type EchartOptionDegradation, type EchartOptionHandle, type EvaluateFieldConditionOptions, type FieldCondition, type FieldConditionResult, type FieldOption, type FormModel, type InteractionSpecLabels, type InteractionTexts, type JsonRenderSpec, type LoadedOpenUiPeers, MAX_CONDITION_DEPTH, type NormalizedColumnWidths, type OpenUiRendererProps, type OpenUiRuntime, PLANNED_INCREMENT, RENDER_UI_TOOL, SPEC_TABLE_MIN_COLUMN_VAR, SPEC_TABLE_MIN_COLUMN_WIDTH, type SanitizedEchartOption, type SpecColumnMeta, type SurfaceFormTexts, type SurfaceHostControlTexts, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiFormScope, type UiPreset, type UiPresetName, type UiSpecDegradation, type UiSpecDegradationCode, type UiSpecIssue, type UiSpecNode, type UiSpecSanitization, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, VIEWER_COMPONENT_ATTR, VIEWER_FALLBACK_ATTR, VIEWER_PROPS_ATTR, type VercelToolInvocation, VercelUiBridge, type ViewerComponentsHandle, type ViewerComponentsOptions, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, applyEchartTheme, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromEchartsOption, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, echartOptionFromProps, ensureStyles, evaluateFieldCondition, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, gaugePercent, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, mountEchartOption, mountViewerComponents, normalizeColumnWidths, normalizeFieldOptions, qualifyFieldName, renderBlocks, renderEchartFallback, renderMiniChart, renderMiniMarkdown, renderRenderResult, resolveChartColors, resolveChartFontSizes, resolveColumnWidths, resolveInteractionTexts, resolveSurfaceFormTexts, resolveSurfaceHostControlTexts, sanitizeEchartOption, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toEchartsOption, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/ui.js

@@ -1257,7 +1257,7 @@ async function loadWebSkillLitCatalog() {
 */
 async function loadOpenUiPeers() {
 	try {
-		const [openuiModule, zodModule] = await Promise.all([import("./dist-CTsxblSD.js"), import("zod")]);
+		const [openuiModule, zodModule] = await Promise.all([import("./dist-Ww6TChcf.js"), import("zod")]);
 		return {
 			openui: openuiModule,
 			z: zodModule.z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.29.0",
+  "version": "0.30.0-next.1",
   "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
@@ -48,6 +48,11 @@
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
     },
+    "./controller": {
+      "types": "./dist/controller.d.ts",
+      "import": "./dist/controller.js"
+    },
+    "./ui-react.css": "./dist/ui-react.css",
     "./package.json": "./package.json"
   },
   "files": [
@@ -56,13 +61,14 @@
   "publishConfig": {
     "access": "public"
   },
-  "sideEffects": false,
+  "sideEffects": ["*.css"],
   "scripts": {
     "prebuild": "node ../../scripts/syncVersionConstant.mjs sdk",
-    "build": "tsdown",
+    "build": "tsdown && tailwindcss -i ../ui-react/src/embed.css -o dist/ui-react.raw.css && node ../../scripts/scopeEmbedCss.mjs dist/ui-react.raw.css dist/ui-react.css",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@cfworker/json-schema": "4.1.6",
     "@e965/xlsx": "0.20.3",
     "fflate": "0.8.3",
     "saxes": "6.0.0",
@@ -76,7 +82,8 @@
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "tar": ">=7.5.0",
-    "vue": ">=3.5.0"
+    "vue": ">=3.5.0",
+    "ws": ">=8.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -96,12 +103,17 @@
     },
     "tar": {
       "optional": true
+    },
+    "ws": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@tailwindcss/cli": "^4.3.3",
     "@types/node": "24.13.3",
     "@webskill/agent": "workspace:*",
     "@webskill/browser": "workspace:*",
+    "@webskill/controller": "workspace:*",
     "@webskill/core": "workspace:*",
     "@webskill/governance": "workspace:*",
     "@webskill/mcp": "workspace:*",
@@ -111,6 +123,7 @@
     "@webskill/ui-kit": "workspace:*",
     "@webskill/ui-react": "workspace:*",
     "@webskill/ui-vue": "workspace:*",
+    "tailwindcss": "^4.3.3",
     "tsdown": "0.22.13",
     "typescript": "6.0.3"
   }