@webskill/sdk 0.4.0 → 0.6.0

package/dist/ui-react.js

@@ -1,8 +1,8 @@
 import { r as __exportAll$1 } from "./rolldown-runtime-BOF7iYI8.js";
 import { m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { X as validateUiSpecEvent, Z as validateUiSpecNode } from "./dist-C-Sh0MDU.js";
-import { C as interactionToUiSpec, D as renderMiniChart, K as renderMiniMarkdown, M as toJsonRenderSpec, N as toOpenUiSpecLang, S as interactionToFormModel, U as chartSpecFromProps, h as collectValues, k as shapeInteractionValue, q as uiCatalog } from "./dist-D9Lcn5Pp.js";
-import { _ as DropdownMenuContent, a as SurfaceField, b as Markdown, c as str, d as Badge, f as Button, g as DropdownMenuCheckboxItem, h as DropdownMenu, i as SurfaceButton, l as useCatalogSurfaceForm, m as DataTable, n as CatalogSurfaceProvider, o as SurfaceFormButtons, p as Checkbox, r as EChart, s as catalogComponentImpls, u as useSurfaceForm, v as DropdownMenuTrigger, x as Separator, y as Input } from "./catalogComponents-KsujmL4b-Clx1kCnU.js";
+import { Ct as validateUiSpecEvent, wt as validateUiSpecNode } from "./dist-DusANsrn.js";
+import { B as toOpenUiSpecLang, I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, g as applySuggestion, k as interactionToUiSpec, nt as uiCatalog, tt as renderMiniMarkdown, x as collectValues, z as toJsonRenderSpec } from "./dist-DnYG2-eY.js";
+import { C as Input, S as DropdownMenuTrigger, T as Separator, _ as Checkbox, a as SpecProgress, b as DropdownMenuCheckboxItem, c as SurfaceButton, d as catalogComponentImpls, f as str, g as Button, h as Badge, i as SpecGrid, l as SurfaceField, m as useSurfaceForm, n as CatalogSurfaceProvider, o as SpecTabs, p as useCatalogSurfaceForm, r as EChart, s as SpecTimeline, u as SurfaceFormButtons, v as DataTable, w as Markdown, x as DropdownMenuContent, y as DropdownMenu } from "./catalogComponents-Dr5dFMAb-Dacibl1e.js";
 import { z } from "zod";
 import * as React$1 from "react";
 import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -6367,9 +6367,19 @@ function applyPatch(node, patch) {
 	}
 	return copy;
 }
+/** 键序无关的序列化：同一份内容不能因写入顺序不同而算两个 surface（FR-21.5） */
+function stableStringify(value) {
+	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
+	if (isRecord(value)) return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
+	return JSON.stringify(value) ?? "null";
+}
 /** Observable, revision-checked snapshot store for framework-neutral UI surfaces. @experimental */
 var UiSurfaceStore = class {
 	#entries = /* @__PURE__ */ new Map();
+	/** 内容指纹 → 首次开的 surface id；仅在同一 runId 内合并 */
+	#fingerprints = /* @__PURE__ */ new Map();
+	/** 后到的重复 id → 已存在的 surface id，让后续 patch/complete 仍然寻址得到 */
+	#aliases = /* @__PURE__ */ new Map();
 	#listeners = /* @__PURE__ */ new Set();
 	#snapshots = [];
 	#patchEmitTimer;
@@ -6383,23 +6393,36 @@ var UiSurfaceStore = class {
 	apply(event) {
 		event = validateUiSpecEvent(event);
 		switch (event.type) {
-			case "open":
-				this.#entries.set(event.id, {
+			case "open": {
+				const snapshot = {
 					id: event.id,
 					node: structuredClone(event.node),
 					...event.actions ? { actions: structuredClone(event.actions) } : {},
 					revision: 0,
 					status: "active",
 					...event.runId ? { runId: event.runId } : {}
-				});
+				};
+				const fingerprint = this.#fingerprint(event);
+				const merged = fingerprint === void 0 ? void 0 : this.#fingerprints.get(fingerprint);
+				if (merged !== void 0 && this.#entries.has(merged)) {
+					this.#aliases.set(event.id, merged);
+					this.#entries.set(merged, {
+						...snapshot,
+						id: merged
+					});
+				} else {
+					if (fingerprint !== void 0) this.#fingerprints.set(fingerprint, event.id);
+					this.#entries.set(event.id, snapshot);
+				}
 				break;
+			}
 			case "patch": {
 				const current = this.#entry(event.id);
 				this.#assertRunId(current, event.runId);
 				if (current.status !== "active" || event.revision !== current.revision + 1) throw new WebSkillError("VALIDATION_FAILED", `Surface patch revision is invalid for "${event.id}"`);
 				let node = current.node;
 				for (const operation of event.operations) node = applyPatch(node, operation);
-				this.#entries.set(event.id, {
+				this.#entries.set(current.id, {
 					...current,
 					node: validateUiSpecNode(node),
 					revision: event.revision
@@ -6410,7 +6433,7 @@ var UiSurfaceStore = class {
 				const current = this.#entry(event.id);
 				this.#assertRunId(current, event.runId);
 				if (event.revision !== current.revision) throw new WebSkillError("VALIDATION_FAILED", `Surface completion revision is invalid for "${event.id}"`);
-				this.#entries.set(event.id, {
+				this.#entries.set(current.id, {
 					...current,
 					status: "complete"
 				});
@@ -6419,7 +6442,7 @@ var UiSurfaceStore = class {
 			case "error": {
 				const current = this.#entry(event.id);
 				this.#assertRunId(current, event.runId);
-				this.#entries.set(event.id, {
+				this.#entries.set(current.id, {
 					...current,
 					status: "error",
 					error: {
@@ -6432,7 +6455,7 @@ var UiSurfaceStore = class {
 			case "cancel": {
 				const current = this.#entry(event.id);
 				this.#assertRunId(current, event.runId);
-				this.#entries.set(event.id, {
+				this.#entries.set(current.id, {
 					...current,
 					status: "cancelled"
 				});
@@ -6446,8 +6469,16 @@ var UiSurfaceStore = class {
 			this.#emit();
 		}
 	}
+	/** 跨 run 的相同界面是合法重复（用户又问了一次），所以无 runId 时不合并 */
+	#fingerprint(event) {
+		if (event.runId === void 0) return void 0;
+		return `${event.runId}\u0000${stableStringify({
+			node: event.node,
+			actions: event.actions ?? null
+		})}`;
+	}
 	#entry(id) {
-		const entry = this.#entries.get(id);
+		const entry = this.#entries.get(this.#aliases.get(id) ?? id);
 		if (!entry) throw new WebSkillError("VALIDATION_FAILED", `Unknown UI surface "${id}"`);
 		return entry;
 	}
@@ -6489,8 +6520,10 @@ var ReactBridgeState = class {
 	#processedSurfaceActionNonces = /* @__PURE__ */ new Set();
 	#surfaceDrafts = /* @__PURE__ */ new Map();
 	#onSurfaceDraftChange;
+	#onDroppedSurfaceAction;
 	constructor(options = {}) {
 		this.#onSurfaceDraftChange = options.onSurfaceDraftChange;
+		this.#onDroppedSurfaceAction = options.onDroppedSurfaceAction;
 		this.surfaceStore.subscribe(() => this.#emit());
 	}
 	get surfaceSnapshots() {
@@ -6559,12 +6592,25 @@ var ReactBridgeState = class {
 			this.#surfaceActionResolvers.set(input.nonce, resolve);
 		});
 	}
-	/** Resolves exactly one pending action capability; stale or duplicate nonces are ignored. */
+	/**
+	* Resolves exactly one pending action capability; stale or duplicate nonces are ignored.
+	* Every ignored response is reported through `onDroppedSurfaceAction` (FR-11.7).
+	*/
 	resolveSurfaceAction(response) {
-		if (this.#processedSurfaceActionNonces.has(response.nonce)) return false;
+		if (this.#processedSurfaceActionNonces.has(response.nonce)) {
+			this.#reportDropped("duplicate", response);
+			return false;
+		}
 		const resolver = this.#surfaceActionResolvers.get(response.nonce);
 		const pending = this.pendingSurfaceAction;
-		if (!resolver || !pending || pending.runId !== response.runId || pending.surfaceId !== response.surfaceId || pending.actionId !== response.actionId || pending.nonce !== response.nonce) return false;
+		if (!resolver || !pending) {
+			this.#reportDropped("no-pending", response);
+			return false;
+		}
+		if (pending.runId !== response.runId || pending.surfaceId !== response.surfaceId || pending.actionId !== response.actionId || pending.nonce !== response.nonce) {
+			this.#reportDropped("mismatch", response);
+			return false;
+		}
 		this.#processedSurfaceActionNonces.add(response.nonce);
 		this.#surfaceActionResolvers.delete(response.nonce);
 		this.pendingSurfaceAction = null;
@@ -6585,6 +6631,21 @@ var ReactBridgeState = class {
 			cancelled: true
 		});
 	}
+	#reportDropped(reason, response) {
+		const pending = this.pendingSurfaceAction;
+		const state = pending === null ? "no action is pending" : `pending action is ${pending.surfaceId}/${pending.actionId} (nonce ${pending.nonce}, run ${pending.runId})`;
+		const warning = {
+			reason,
+			nonce: response.nonce,
+			message: `Dropped UI surface action ${response.surfaceId}/${response.actionId} with nonce ${response.nonce}: ${reason}; ${state}`,
+			pending
+		};
+		if (this.#onDroppedSurfaceAction) {
+			this.#onDroppedSurfaceAction(warning);
+			return;
+		}
+		console.warn(`[webskill] ${warning.message}`);
+	}
 	async onTextDelta(runId, delta) {
 		if (this.streamingRunId !== runId) {
 			this.streamingRunId = runId;
@@ -6594,6 +6655,40 @@ var ReactBridgeState = class {
 		this.#emit();
 	}
 };
+/**
+* 建议值以**建议**形态出现（FR-19.4）：控件初始值仍为空，
+* 用户点「使用」才写入。切勿改成 defaultValue。
+*/
+function Suggestion({ control, onUse }) {
+	if (control.suggestion === void 0) return null;
+	const preview = String(control.suggestion.value);
+	const reason = control.suggestion.reason;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "webskill-form__suggestion",
+		"data-webskill-suggestion": control.name,
+		children: [
+			/* @__PURE__ */ jsxs("span", {
+				className: "webskill-form__suggestion-value",
+				children: ["Suggested: ", preview]
+			}),
+			reason ? /* @__PURE__ */ jsxs("span", {
+				className: "webskill-form__suggestion-reason",
+				children: [
+					"(",
+					reason,
+					")"
+				]
+			}) : null,
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "webskill-form__suggestion-use",
+				"data-webskill-suggestion-use": control.name,
+				onClick: onUse,
+				children: "Use"
+			})
+		]
+	});
+}
 function Control({ control, invalid }) {
 	const controlId = `webskill-field-${control.name}`;
 	const label = /* @__PURE__ */ jsxs("label", {
@@ -6709,15 +6804,24 @@ function InteractionForm({ bridge }) {
 			}) : null,
 			model.controls.map((control) => /* @__PURE__ */ jsxs("div", {
 				className: invalid.includes(control.name) ? "webskill-form__control--invalid" : void 0,
-				children: [/* @__PURE__ */ jsx(Control, {
-					control,
-					invalid: invalid.includes(control.name)
-				}), invalid.includes(control.name) ? /* @__PURE__ */ jsx("div", {
-					id: `webskill-error-${control.name}`,
-					role: "alert",
-					className: "webskill-form__error",
-					children: "This field is required"
-				}) : null]
+				children: [
+					/* @__PURE__ */ jsx(Control, {
+						control,
+						invalid: invalid.includes(control.name)
+					}),
+					/* @__PURE__ */ jsx(Suggestion, {
+						control,
+						onUse: () => {
+							if (formRef.current) applySuggestion(control, formRef.current);
+						}
+					}),
+					invalid.includes(control.name) ? /* @__PURE__ */ jsx("div", {
+						id: `webskill-error-${control.name}`,
+						role: "alert",
+						className: "webskill-form__error",
+						children: "This field is required"
+					}) : null
+				]
 			}, control.name)),
 			/* @__PURE__ */ jsxs("div", {
 				className: "webskill-form__actions",
@@ -6955,9 +7059,10 @@ const TONE_CLASS = {
 	info: "text-info",
 	destructive: "text-destructive"
 };
-function renderNode(node, context, key) {
+function renderNode(node, context, key, scope) {
 	const props = node.props ?? {};
-	const children = (node.children ?? []).map((child, index) => renderNode(child, context, `${key}.${index}`));
+	const nodeScope = node.component === "Form" ? context.scopeOfNode(node) : scope;
+	const children = (node.children ?? []).map((child, index) => renderNode(child, context, `${key}.${index}`, nodeScope));
 	switch (node.component) {
 		case "Stack": return /* @__PURE__ */ jsx("div", {
 			className: `flex gap-3 ${str(props, "direction", "vertical") === "horizontal" ? "flex-row items-center" : "flex-col"}`,
@@ -7015,6 +7120,16 @@ function renderNode(node, context, key) {
 			label: str(props, "title", "Data")
 		}, key);
 		case "Chart": return /* @__PURE__ */ jsx(EChart, { chart: chartSpecFromProps(props) }, key);
+		case "Tabs": return /* @__PURE__ */ jsx(SpecTabs, {
+			props,
+			children
+		}, key);
+		case "Grid": return /* @__PURE__ */ jsx(SpecGrid, {
+			props,
+			children
+		}, key);
+		case "Timeline": return /* @__PURE__ */ jsx(SpecTimeline, { props }, key);
+		case "Progress": return /* @__PURE__ */ jsx(SpecProgress, { props }, key);
 		case "FileLink": return /* @__PURE__ */ jsxs("div", {
 			className: "flex items-center gap-2 text-sm",
 			children: [/* @__PURE__ */ jsx("span", {
@@ -7032,7 +7147,7 @@ function renderNode(node, context, key) {
 			className: "flex flex-col gap-3",
 			onSubmit: (event) => {
 				event.preventDefault();
-				context.submit("submit");
+				context.submit("submit", void 0, nodeScope);
 			},
 			noValidate: true,
 			children: [
@@ -7043,17 +7158,20 @@ function renderNode(node, context, key) {
 				children,
 				/* @__PURE__ */ jsx(SurfaceFormButtons, {
 					form: context,
-					props
+					props,
+					scope: nodeScope
 				})
 			]
 		}, key);
 		case "Field": return /* @__PURE__ */ jsx(SurfaceField, {
 			form: context,
-			props
+			props,
+			scope
 		}, key);
 		case "Button": return /* @__PURE__ */ jsx(SurfaceButton, {
 			form: context,
 			props,
+			scope,
 			...node.id ? { nodeId: node.id } : {}
 		}, key);
 		case "Alert": return /* @__PURE__ */ jsxs("div", {
@@ -7418,7 +7536,7 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 	const [unavailable, setUnavailable] = useState(false);
 	useEffect(() => {
 		let cancelled = false;
-		import("./openUiLibrary-YLS-cxyT-C96jWDQq.js").then((loaded) => {
+		import("./openUiLibrary-Bdrji9qK-DzAxRlTY.js").then((loaded) => {
 			if (!cancelled) setModule(loaded);
 		}).catch(() => {
 			if (!cancelled) setUnavailable(true);

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { o as InteractionRequest, s as InteractionResponse, v as RenderResultRequest, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
+import { b as UiBridge, c as InteractionResponse, s as InteractionRequest, y as RenderResultRequest } from "./types-4pg-qp_I-Gq63X8Oa.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts

package/dist/ui-vue.js

@@ -1,4 +1,4 @@
-import { D as renderMiniChart, K as renderMiniMarkdown, S as interactionToFormModel, h as collectValues, k as shapeInteractionValue } from "./dist-D9Lcn5Pp.js";
+import { I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, g as applySuggestion, tt as renderMiniMarkdown, x as collectValues } from "./dist-DnYG2-eY.js";
 import { defineComponent, h, reactive, ref } from "vue";
 
 //#region ../ui-vue/dist/index.js
@@ -46,6 +46,24 @@ var VueBridgeState = class {
 		this.state.streamingText += delta;
 	}
 };
+/** 建议值以**建议**形态出现（FR-19.4）：控件初始值仍为空，用户点「使用」才写入 */
+function renderSuggestion(control, onUse) {
+	if (control.suggestion === void 0) return null;
+	const reason = control.suggestion.reason;
+	return h("div", {
+		class: "webskill-form__suggestion",
+		"data-webskill-suggestion": control.name
+	}, [
+		h("span", { class: "webskill-form__suggestion-value" }, `Suggested: ${String(control.suggestion.value)}`),
+		...reason ? [h("span", { class: "webskill-form__suggestion-reason" }, `(${reason})`)] : [],
+		h("button", {
+			type: "button",
+			class: "webskill-form__suggestion-use",
+			"data-webskill-suggestion-use": control.name,
+			onClick: onUse
+		}, "Use")
+	]);
+}
 function renderControl(control, invalid) {
 	const controlId = `webskill-field-${control.name}`;
 	const label = h("label", {
@@ -137,11 +155,17 @@ const InteractionForm = defineComponent({
 			}, [
 				model.title ? h("div", { class: "webskill-form__title" }, model.title) : null,
 				model.message && (model.kind === "form" || model.kind === "authorize") ? h("p", { class: "webskill-form__message" }, model.message) : null,
-				...model.controls.map((control) => h("div", { key: control.name }, [renderControl(control, invalid.value.includes(control.name)), invalid.value.includes(control.name) ? h("div", {
-					id: `webskill-error-${control.name}`,
-					role: "alert",
-					class: "webskill-form__error"
-				}, "This field is required") : null])),
+				...model.controls.map((control) => h("div", { key: control.name }, [
+					renderControl(control, invalid.value.includes(control.name)),
+					renderSuggestion(control, () => {
+						if (formRef.value) applySuggestion(control, formRef.value);
+					}),
+					invalid.value.includes(control.name) ? h("div", {
+						id: `webskill-error-${control.name}`,
+						role: "alert",
+						class: "webskill-form__error"
+					}, "This field is required") : null
+				])),
 				h("div", { class: "webskill-form__actions" }, [h("button", {
 					type: "submit",
 					class: "webskill-form__button webskill-form__button--primary"

package/dist/ui.d.ts

@@ -1,4 +1,4 @@
-import { pt as UiSpecNode } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-import { Bt as buildRenderResult } from "./index-DLfR2Y6I.js";
-import { $ as fromA2uiSpecAction, A as UiCatalogToolSourceOptions, B as WEBSKILL_SURFACE_ACTION, C as OpenUiRuntime, D as UiCatalog, E as UiActionDef, F as VERCEL_INTERACTION_TOOL_NAME, G as buildA2uiCatalogDefinition, H as ZodRuntime, I as VercelToolInvocation, J as collectSpecActions, K as chartSpecFromProps, L as VercelUiBridge, M as UiSpecIssue, N as UiSpecValidation, O as UiCatalogInput, P as UiSurfaceActionDispatch, Q as ensureStyles, R as WEBSKILL_A2UI_CATALOG_ID, S as OpenUiRendererProps, T as UI_CATALOG_GROUPS, U as a2uiComponentSchema, V as WebFormBridge, W as a2uiComponentShapes, X as createUiCatalogToolSource, Y as collectValues, Z as defineUiCatalog, _ as EchartHandle, _t as toUiSurfaceActionDispatch, a as A2UI_SURFACE_ACTION, at as loadOpenUiPeers, b as JsonRenderSpec, c as A2uiCatalogDefinition, ct as renderBlocks, d as A2uiMessage, dt as renderRenderResult, et as fromA2uiSurfaceAction, f as A2uiSpecActionEvent, ft as shapeInteractionValue, g as ControlModel, gt as toOpenUiSpecLang, h as CollectedValues, ht as toJsonRenderSpec, i as A2UI_SPEC_FORM_PATH, it as interactionToUiSpec, j as UiComponentDef, k as UiCatalogPromptOptions, l as A2uiCatalogHandle, lt as renderMiniChart, m as CHART_PALETTE, mt as toA2uiSurfaceAction, n as A2UI_COMMON_TYPES, nt as fromVercelToolResult, o as A2UI_VERSION, ot as loadWebSkillLitCatalog, p as A2uiSpecMessageOptions, pt as toA2uiSpecMessages, q as chartToTable, r as A2UI_SPEC_ACTION, rt as interactionToFormModel, s as A2uiCatalogComponent, st as mountEchart, t as A2UI_BASIC_CATALOG_ID, tt as fromUiSurfaceActionDispatch, u as A2uiComponentShape, ut as renderMiniMarkdown, v as FormModel, vt as toVercelToolInvocation, w as RENDER_UI_TOOL, x as LoadedOpenUiPeers, y as InteractionSpecLabels, yt as uiCatalog, z as WEBSKILL_STYLES_CSS } from "./index-CHXxDccV.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, CHART_PALETTE, type CollectedValues, type ControlModel, type EchartHandle, type FormModel, type InteractionSpecLabels, type JsonRenderSpec, type LoadedOpenUiPeers, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, UI_CATALOG_GROUPS, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiSpecIssue, type UiSpecNode, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog };
+import { mt as UiSpecNode } from "./types-4pg-qp_I-Gq63X8Oa.js";
+import { dn as buildRenderResult } from "./index-C-KFAZoF.js";
+import { $ as buildA2uiCatalogDefinition, A as UiActionDef, At as uiCatalog, B as UiSpecValidation, C as OpenUiRendererProps, Ct as shapeInteractionValue, D as UI_CATALOG_PROMPT_BUDGET_BYTES, Dt as toOpenUiSpecLang, E as UI_CATALOG_GROUPS, Et as toJsonRenderSpec, F as UiComponentDef, G as WEBSKILL_A2UI_CATALOG_ID, H as VERCEL_INTERACTION_TOOL_NAME, I as UiFormScope, J as WebFormBridge, K as WEBSKILL_STYLES_CSS, L as UiPreset, M as UiCatalogInput, N as UiCatalogPromptOptions, O as UI_PRESETS, Ot as toUiSurfaceActionDispatch, P as UiCatalogToolSourceOptions, Q as applySuggestion, R as UiPresetName, S as LoadedOpenUiPeers, St as renderRenderResult, T as RENDER_UI_TOOL, Tt as toA2uiSurfaceAction, U as VercelToolInvocation, V as UiSurfaceActionDispatch, W as VercelUiBridge, X as a2uiComponentSchema, Y as ZodRuntime, Z as a2uiComponentShapes, _ as DESCRIBE_UI_PRESET_TOOL, _t as mountEchart, a as A2UI_SURFACE_ACTION, at as collectValues, b as InteractionSpecLabels, bt as renderMiniChart, c as A2uiCatalogDefinition, ct as ensureStyles, d as A2uiMessage, dt as fromUiSurfaceActionDispatch, et as chartSpecFromProps, f as A2uiSpecActionEvent, ft as fromVercelToolResult, g as ControlModel, gt as loadWebSkillLitCatalog, h as CollectedValues, ht as loadOpenUiPeers, i as A2UI_SPEC_FORM_PATH, it as collectSpecActions, j as UiCatalog, jt as uiPreset, k as UI_PRESET_NAMES, kt as toVercelToolInvocation, l as A2uiCatalogHandle, lt as fromA2uiSpecAction, m as CHART_PALETTE, mt as interactionToUiSpec, n as A2UI_COMMON_TYPES, nt as collectFormScopes, o as A2UI_VERSION, ot as createUiCatalogToolSource, p as A2uiSpecMessageOptions, pt as interactionToFormModel, q as WEBSKILL_SURFACE_ACTION, r as A2UI_SPEC_ACTION, rt as collectScopedValues, s as A2uiCatalogComponent, st as defineUiCatalog, t as A2UI_BASIC_CATALOG_ID, tt as chartToTable, u as A2uiComponentShape, ut as fromA2uiSurfaceAction, v as EchartHandle, vt as qualifyFieldName, w as OpenUiRuntime, wt as toA2uiSpecMessages, x as JsonRenderSpec, xt as renderMiniMarkdown, y as FormModel, yt as renderBlocks, z as UiSpecIssue } from "./index-BMocOEi0.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, CHART_PALETTE, type CollectedValues, type ControlModel, DESCRIBE_UI_PRESET_TOOL, type EchartHandle, type FormModel, type InteractionSpecLabels, type JsonRenderSpec, type LoadedOpenUiPeers, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, 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 UiSpecIssue, type UiSpecNode, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { k as buildRenderResult } from "./dist-C-Sh0MDU.js";
-import { A as toA2uiSpecMessages, B as a2uiComponentSchema, C as interactionToUiSpec, D as renderMiniChart, E as renderBlocks, F as toVercelToolInvocation, G as mountEchart, H as buildA2uiCatalogDefinition, K as renderMiniMarkdown, L as A2UI_COMMON_TYPES, M as toJsonRenderSpec, N as toOpenUiSpecLang, O as renderRenderResult, P as toUiSurfaceActionDispatch, R as UI_CATALOG_GROUPS, S as interactionToFormModel, T as loadWebSkillLitCatalog, U as chartSpecFromProps, V as a2uiComponentShapes, W as defineUiCatalog, _ as ensureStyles, a as A2UI_VERSION, b as fromUiSurfaceActionDispatch, c as VERCEL_INTERACTION_TOOL_NAME, d as WEBSKILL_SURFACE_ACTION, f as WebFormBridge, g as createUiCatalogToolSource, h as collectValues, i as A2UI_SURFACE_ACTION, j as toA2uiSurfaceAction, k as shapeInteractionValue, l as VercelUiBridge, m as collectSpecActions, n as A2UI_SPEC_ACTION, o as CHART_PALETTE, p as chartToTable, q as uiCatalog, r as A2UI_SPEC_FORM_PATH, s as RENDER_UI_TOOL, t as A2UI_BASIC_CATALOG_ID, u as WEBSKILL_STYLES_CSS, v as fromA2uiSpecAction, w as loadOpenUiPeers, x as fromVercelToolResult, y as fromA2uiSurfaceAction, z as WEBSKILL_A2UI_CATALOG_ID } from "./dist-D9Lcn5Pp.js";
+import { B as buildRenderResult } from "./dist-DusANsrn.js";
+import { $ as defineUiCatalog, A as loadOpenUiPeers, B as toOpenUiSpecLang, C as ensureStyles, D as fromVercelToolResult, E as fromUiSurfaceActionDispatch, F as renderRenderResult, G as A2UI_COMMON_TYPES, H as toVercelToolInvocation, I as shapeInteractionValue, J as WEBSKILL_A2UI_CATALOG_ID, K as UI_CATALOG_GROUPS, L as toA2uiSpecMessages, M as qualifyFieldName, N as renderBlocks, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, R as toA2uiSurfaceAction, S as createUiCatalogToolSource, T as fromA2uiSurfaceAction, U as uiPreset, V as toUiSurfaceActionDispatch, X as a2uiComponentShapes, Y as a2uiComponentSchema, Z as buildA2uiCatalogDefinition, _ as chartToTable, a as A2UI_VERSION, b as collectSpecActions, c as RENDER_UI_TOOL, d as VERCEL_INTERACTION_TOOL_NAME, et as mountEchart, f as VercelUiBridge, g as applySuggestion, h as WebFormBridge, i as A2UI_SURFACE_ACTION, j as loadWebSkillLitCatalog, k as interactionToUiSpec, l as UI_PRESETS, m as WEBSKILL_SURFACE_ACTION, n as A2UI_SPEC_ACTION, nt as uiCatalog, o as CHART_PALETTE, p as WEBSKILL_STYLES_CSS, q as UI_CATALOG_PROMPT_BUDGET_BYTES, r as A2UI_SPEC_FORM_PATH, s as DESCRIBE_UI_PRESET_TOOL, t as A2UI_BASIC_CATALOG_ID, tt as renderMiniMarkdown, u as UI_PRESET_NAMES, v as collectFormScopes, w as fromA2uiSpecAction, x as collectValues, y as collectScopedValues, z as toJsonRenderSpec } from "./dist-DnYG2-eY.js";
 
-export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, RENDER_UI_TOOL, UI_CATALOG_GROUPS, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog };
+export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, DESCRIBE_UI_PRESET_TOOL, RENDER_UI_TOOL, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/{webskillLitCatalog-CSTbhBe_-CYIs5BX8.js → webskillLitCatalog-_mugzRHx-B_54vxum.js}

@@ -1,4 +1,4 @@
-import { G as mountEchart, I as A2UI_CHILDREN_PROP, K as renderMiniMarkdown, U as chartSpecFromProps, V as a2uiComponentShapes, q as uiCatalog, z as WEBSKILL_A2UI_CATALOG_ID } from "./dist-D9Lcn5Pp.js";
+import { J as WEBSKILL_A2UI_CATALOG_ID, Q as chartSpecFromProps, W as A2UI_CHILDREN_PROP, X as a2uiComponentShapes, et as mountEchart, nt as uiCatalog, tt as renderMiniMarkdown } from "./dist-DnYG2-eY.js";
 import { A2uiController, A2uiLitElement } from "@a2ui/lit/v0_9";
 import { Catalog } from "@a2ui/web_core/v0_9";
 import { z } from "zod/v3";
@@ -1419,7 +1419,7 @@ var f = class extends i {
 };
 
 //#endregion
-//#region ../ui/dist/webskillLitCatalog-CSTbhBe_.js
+//#region ../ui/dist/webskillLitCatalog-_mugzRHx.js
 /**
 * Lit 元素上的 echarts 挂载指令。
 * A2UI 档的 catalog `Chart` 渲染在 shadow root 里，实例必须随元素断开而 dispose，
@@ -1598,6 +1598,33 @@ const sharedStyles = i$4`
   .error {
     color: var(--destructive);
   }
+  .tabs {
+    display: flex;
+    gap: 0.25rem;
+    border-bottom: 1px solid var(--border);
+  }
+  .grid {
+    display: grid;
+    gap: 0.75rem;
+  }
+  ol.timeline {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    margin: 0;
+    padding-left: 1rem;
+  }
+  .bar {
+    height: 0.5rem;
+    border-radius: 999px;
+    background: var(--secondary);
+    overflow: hidden;
+  }
+  .bar > span {
+    display: block;
+    height: 100%;
+    background: var(--foreground);
+  }
 `;
 const str = (props, key, fallback = "") => typeof props[key] === "string" ? props[key] : fallback;
 const list = (value) => Array.isArray(value) ? value : [];
@@ -1618,6 +1645,34 @@ const renderers = {
     </section>
   `,
 	Separator: () => T`<hr />`,
+	Tabs: (props, host) => {
+		const labels = list(props["labels"]);
+		const panels = props.children ?? [];
+		const active = Math.min(host.view["tab"] ?? 0, Math.max(panels.length - 1, 0));
+		return T`
+      <div class="stack" data-direction="vertical">
+        <div class="tabs" role="tablist">
+          ${labels.map((label, index) => T`<button
+              type="button"
+              role="tab"
+              aria-selected=${index === active ? "true" : "false"}
+              @click=${() => {
+			host.view["tab"] = index;
+			host.refresh();
+		}}
+            >
+              ${label}
+            </button>`)}
+        </div>
+        ${panels[active] ? host.renderChild(panels[active]) : A}
+      </div>
+    `;
+	},
+	Grid: (props, host) => T`
+    <div class="grid" style=${`grid-template-columns: repeat(${Number(props["columns"] ?? 2)}, minmax(0, 1fr))`}>
+      ${children(props, host)}
+    </div>
+  `,
 	Heading: (props) => {
 		const text = str(props, "text");
 		if (props["level"] === 2) return T`<h2>${text}</h2>`;
@@ -1651,6 +1706,33 @@ const renderers = {
     </div>
   `,
 	Chart: (props) => T`<div class="chart" ${echart(chartSpecFromProps(props))}></div>`,
+	Timeline: (props) => T`
+    <ol class="timeline">
+      ${list(props["items"]).map((item) => T`<li>
+          <strong>${String(item["title"] ?? "")}</strong>
+          ${item["time"] ? T`<p class="muted">${String(item["time"])}</p>` : A}
+          ${item["description"] ? T`<p>${String(item["description"])}</p>` : A}
+        </li>`)}
+    </ol>
+  `,
+	Progress: (props) => {
+		const value = Math.max(0, Math.min(100, Number(props["value"] ?? 0)));
+		return T`
+      <div class="metric">
+        ${props["label"] ? T`<span class="muted">${str(props, "label")}</span>` : A}
+        <div
+          class="bar"
+          role="progressbar"
+          aria-valuenow=${value}
+          aria-valuemin="0"
+          aria-valuemax="100"
+          aria-label=${str(props, "label", "Progress")}
+        >
+          <span style=${`width: ${value}%`}></span>
+        </div>
+      </div>
+    `;
+	},
 	FileLink: (props) => T`<p>${str(props, "label", str(props, "path"))}</p>`,
 	Form: (props, host) => T`
     <form @submit=${(event) => event.preventDefault()}>
@@ -1752,12 +1834,16 @@ function apiSchema(shape) {
 function defineElement(api, render) {
 	class WebSkillA2uiElement extends A2uiLitElement {
 		static styles = sharedStyles;
+		view = {};
 		createController() {
 			return new A2uiController(this, api);
 		}
 		renderChild(ref) {
 			return this.renderNode(ref);
 		}
+		refresh() {
+			this.requestUpdate();
+		}
 		render() {
 			const props = this.controller?.props;
 			return props ? render(props, this) : A;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "WebSkill \u2014 browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
@@ -40,6 +40,10 @@
       "types": "./dist/governance.d.ts",
       "import": "./dist/governance.js"
     },
+    "./agent": {
+      "types": "./dist/agent.d.ts",
+      "import": "./dist/agent.js"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
@@ -92,6 +96,7 @@
   },
   "devDependencies": {
     "@types/node": "24.13.3",
+    "@webskill/agent": "workspace:*",
     "@webskill/browser": "workspace:*",
     "@webskill/core": "workspace:*",
     "@webskill/governance": "workspace:*",