@webskill/sdk 0.5.0 → 0.6.0

package/dist/{catalogComponents-DV7cPpUm-C77AEEx9.js → catalogComponents-Dr5dFMAb-Dacibl1e.js}

@@ -1,6 +1,6 @@
 import { a as __require, i as __reExport, n as __esmMin, o as __toCommonJS, r as __exportAll$2, s as __toESM$1, t as __commonJSMin$1 } from "./rolldown-runtime-BOF7iYI8.js";
 import { m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { M as qualifyFieldName, Q as chartSpecFromProps, et as mountEchart, v as collectFormScopes, y as collectScopedValues } from "./dist-bewtXYlO.js";
+import { M as qualifyFieldName, Q as chartSpecFromProps, et as mountEchart, v as collectFormScopes, y as collectScopedValues } from "./dist-DnYG2-eY.js";
 import minpath$1 from "node:path";
 import { fileURLToPath as urlToPath$1 } from "node:url";
 import * as React$10 from "react";
@@ -3407,11 +3407,49 @@ const getDefaultConfig = () => {
 const twMerge = /*#__PURE__*/ createTailwindMerge(getDefaultConfig);
 
 //#endregion
-//#region ../ui-kit/dist/cn-Dt6Yi1Qv.js
+//#region ../ui-kit/dist/useDarkAncestor-D41bzGNA.js
 /** shadcn 约定的类名合并：后写的 Tailwind 类覆盖先写的同族类。 */
 function cn(...inputs) {
 	return twMerge(clsx(inputs));
 }
+/**
+* 声明了主题的祖先：`data-theme` 由 ThemeScope 挂（亮暗都挂），`.dark` 是宿主页面惯用的暗色类名。
+* 两者一起选，`closest` 才会停在**最近**的那一层，而不是越过亮色实例去命中外层的暗色宿主。
+*/
+const THEME_ANCESTOR = "[data-theme], .dark";
+/**
+* 判定挂载点**最近的**主题祖先是否处于暗色（0.6.0 FR-20.4）。
+*
+* 不用 `document.querySelector('.dark')`：那是全局查询，宿主页面是暗色时，
+* 嵌在暗色宿主里的亮色 SDK 实例也会被判成暗色（反之亦然）。
+*
+* 返回 ref 回调而不是接受 ref 对象：ref 对象的赋值不触发渲染，拿不到「已挂载」这个时机。
+*/
+function useDarkAncestor() {
+	const [node, setNode] = useState(null);
+	const [dark, setDark] = useState(false);
+	useEffect(() => {
+		if (!node) return;
+		const update = () => {
+			const scope = node.closest(THEME_ANCESTOR);
+			if (!scope) {
+				setDark(false);
+				return;
+			}
+			const declared = scope.getAttribute("data-theme");
+			setDark(declared === null ? true : declared === "dark");
+		};
+		update();
+		const observer = new MutationObserver(update);
+		observer.observe(document.documentElement, {
+			attributes: true,
+			attributeFilter: ["class", "data-theme"],
+			subtree: true
+		});
+		return () => observer.disconnect();
+	}, [node]);
+	return [dark, setNode];
+}
 
 //#endregion
 //#region ../../node_modules/.pnpm/@radix-ui+react-compose-refs@1.1.5_@types+react@19.2.17_react@19.2.8/node_modules/@radix-ui/react-compose-refs/dist/index.mjs
@@ -99560,6 +99598,19 @@ const PanelLeft = createLucideIcon("panel-left", [["rect", {
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
+const Plus = createLucideIcon("plus", [["path", {
+	d: "M5 12h14",
+	key: "1ays0h"
+}], ["path", {
+	d: "M12 5v14",
+	key: "s699le"
+}]]);
+/**
+* @license lucide-react v1.27.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
 const Search = createLucideIcon("search", [["path", {
 	d: "m21 21-4.34-4.34",
 	key: "14j7rj"
@@ -99672,6 +99723,26 @@ function Switch({ className = "", label, ...props }) {
 		})]
 	});
 }
+/**
+* 一个 SDK 实例的主题作用域（0.6.0 FR-20.4）。
+*
+* 解决两件事：
+*   1. Radix 的 Portal 默认渲染到 `document.body`，会逃出主题子树 —— 这里在作用域**内部**
+*      提供一个 Portal 容器，浮层因此仍处在带主题类名的祖先链下；
+*   2. 原生 `<select>` 的下拉由浏览器按 `color-scheme` 绘制，类名管不到 —— 容器上的
+*      `data-webskill-theme` 属性在 base.css 里显式声明了 `color-scheme`。
+*
+* 宿主页面自身的类名不被改动：作用域只作用于自己的子树。
+*/
+const PortalContainerContext = createContext(void 0);
+/**
+* 当前实例的 Portal 容器；不在 `ThemeScope` 内时返回 `undefined`，
+* 调用方据此回落到 Radix 默认的 `document.body`。
+* @experimental
+*/
+function usePortalContainer() {
+	return useContext(PortalContainerContext);
+}
 const DropdownMenu = Root2;
 function DropdownMenuTrigger({ children, className = "", asChild, ...props }) {
 	const triggerClass = asChild ? className : `inline-flex h-9 items-center justify-center rounded-md border border-border bg-surface px-3 text-sm font-medium text-ink shadow-xs outline-none transition-colors hover:bg-subtle focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/20 ${className}`;
@@ -99683,12 +99754,15 @@ function DropdownMenuTrigger({ children, className = "", asChild, ...props }) {
 	});
 }
 function DropdownMenuContent({ children, className = "", sideOffset = 6, ...props }) {
-	return /* @__PURE__ */ jsx(Portal2, { children: /* @__PURE__ */ jsx(Content2, {
-		sideOffset,
-		className: `z-50 min-w-40 rounded-md border border-border bg-surface p-1 text-sm text-ink shadow-pop outline-none ${className}`,
-		...props,
-		children
-	}) });
+	return /* @__PURE__ */ jsx(Portal2, {
+		container: usePortalContainer(),
+		children: /* @__PURE__ */ jsx(Content2, {
+			sideOffset,
+			className: `z-50 min-w-40 rounded-md border border-border bg-surface p-1 text-sm text-ink shadow-pop outline-none ${className}`,
+			...props,
+			children
+		})
+	});
 }
 function DropdownMenuCheckboxItem({ children, className = "", ...props }) {
 	return /* @__PURE__ */ jsxs(CheckboxItem2, {
@@ -119889,29 +119963,11 @@ function resolveLanguage(raw) {
 	if (raw in languages) return raw;
 	return languageAliases[raw];
 }
-/** 探测 .dark 祖先（class 策略）：监听 documentElement/body 的 class 变化 */
-function useDarkClass() {
-	const [dark, setDark] = useState(() => typeof document !== "undefined" && document.querySelector(".dark") !== null);
-	useEffect(() => {
-		const update = () => setDark(document.querySelector(".dark") !== null);
-		const observer = new MutationObserver(update);
-		observer.observe(document.documentElement, {
-			attributes: true,
-			attributeFilter: ["class"]
-		});
-		if (document.body) observer.observe(document.body, {
-			attributes: true,
-			attributeFilter: ["class"]
-		});
-		update();
-		return () => observer.disconnect();
-	}, []);
-	return dark;
-}
 function CodeBlock({ node: _node, className, children, ...rest }) {
-	const dark = useDarkClass();
+	const [dark, themeRef] = useDarkAncestor();
 	const language = resolveLanguage(/language-(\w+)/.exec(className ?? "")?.[1]);
 	if (language) return /* @__PURE__ */ jsxs("div", {
+		ref: themeRef,
 		className: "my-3 overflow-hidden rounded-card border border-border",
 		children: [/* @__PURE__ */ jsx("div", {
 			className: "border-b border-border bg-subtle px-3 py-1.5 font-mono text-xs text-muted",
@@ -120084,9 +120140,27 @@ const MarkdownText = memo(function MarkdownText({ className }) {
 		defer: true
 	});
 });
+/**
+* provider 相关的默认值与切换规则（0.6.0 FR-13.1）。
+* chatbot 设置面板与 console 的 `connections.models` 共用这一份——
+* 0.5.x 时两处各自硬编码，改一处漏一处。
+*/
+/**
+* 各 provider 的官方默认端点。取值必须与客户端内部的 fallback 一致（T-03-2 断言）：
+* 客户端的 fallback 保证「用户没填也能跑」，这张表只服务 UI 预填，两者说的是同一件事。
+* `openai-compatible` 与 `chrome-builtin` 无默认——前者端点任意，后者根本不走 HTTP。
+* @experimental
+*/
+const PROVIDER_DEFAULT_BASE_URL = {
+	"openai-compatible": void 0,
+	anthropic: "https://api.anthropic.com",
+	google: "https://generativelanguage.googleapis.com",
+	"chrome-builtin": void 0
+};
+const KNOWN_DEFAULT_BASE_URLS = new Set(Object.values(PROVIDER_DEFAULT_BASE_URL).filter((url) => url !== void 0));
 
 //#endregion
-//#region ../ui-react/dist/catalogComponents-DV7cPpUm.js
+//#region ../ui-react/dist/catalogComponents-Dr5dFMAb.js
 /** echarts 挂载点：surface 图表与 catalog 声明树的 Chart 节点共用，实现在 `@webskill/ui`，与 A2UI 档同一份 */
 function EChart({ chart }) {
 	const containerRef = useRef(null);
@@ -120302,13 +120376,21 @@ function SurfaceField({ form, props, scope }) {
 			suggestion !== void 0 && isBlank(value) ? /* @__PURE__ */ jsxs("span", {
 				"data-webskill-suggestion": key,
 				className: "flex items-center gap-2 text-xs text-muted",
-				children: [/* @__PURE__ */ jsxs("span", { children: ["Last entered: ", String(suggestion.value)] }), /* @__PURE__ */ jsx("button", {
-					type: "button",
-					"data-webskill-suggestion-use": key,
-					onClick: () => form.setValue(key, suggestion.value),
-					className: "rounded-md border border-border px-2 py-0.5 text-ink transition-colors hover:bg-accent",
-					children: "Use"
-				})]
+				children: [
+					/* @__PURE__ */ jsxs("span", { children: ["Suggested: ", String(suggestion.value)] }),
+					suggestion.reason ? /* @__PURE__ */ jsxs("span", { children: [
+						"(",
+						suggestion.reason,
+						")"
+					] }) : null,
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						"data-webskill-suggestion-use": key,
+						onClick: () => form.setValue(key, suggestion.value),
+						className: "rounded-md border border-border px-2 py-0.5 text-ink transition-colors hover:bg-accent",
+						children: "Use"
+					})
+				]
 			}) : null,
 			props["description"] ? /* @__PURE__ */ jsx("span", {
 				className: "text-xs text-muted",
@@ -120328,20 +120410,20 @@ function SurfaceFormButtons({ form, props, scope }) {
 	const submitId = scope ? scope.submitActionId : form.resolveActionId("submit");
 	const cancelId = scope ? scope.cancelActionId : form.resolveActionId("cancel");
 	return /* @__PURE__ */ jsxs("div", {
-		className: "flex gap-2",
-		children: [/* @__PURE__ */ jsx(Button, {
-			type: "submit",
-			size: "sm",
-			"data-webskill-surface-action": submitId,
-			children: str(props, "submitLabel", "Submit")
-		}), props["cancelLabel"] ? /* @__PURE__ */ jsx(Button, {
+		className: "flex flex-wrap items-center justify-end gap-2",
+		children: [props["cancelLabel"] ? /* @__PURE__ */ jsx(Button, {
 			type: "button",
 			size: "sm",
 			variant: "secondary",
 			"data-webskill-surface-action": cancelId,
 			onClick: () => form.emit(cancelId, scope),
 			children: str(props, "cancelLabel")
-		}) : null]
+		}) : null, /* @__PURE__ */ jsx(Button, {
+			type: "submit",
+			size: "sm",
+			"data-webskill-surface-action": submitId,
+			children: str(props, "submitLabel", "Submit")
+		})]
 	});
 }
 /** catalog `Button` 的唯一实现：submit 走带值提交，其余走裸动作 */

package/dist/{dist-bewtXYlO.js → dist-DnYG2-eY.js}

@@ -992,6 +992,7 @@ function shapeInteractionValue(model, values) {
 		case "confirm": return values["confirmed"] === true;
 		case "select": return values["selected"];
 		case "authorize": return true;
+		case "file-pick": return values["file"];
 		case "form": return values;
 	}
 }
@@ -1005,7 +1006,8 @@ function interactionToFormModel(request) {
 				name: "answer",
 				label: request.message,
 				control: "text",
-				required: true
+				required: true,
+				...request.suggestion ? { suggestion: request.suggestion } : {}
 			}],
 			submitLabel: "Submit",
 			cancelLabel: "Cancel"
@@ -1046,7 +1048,8 @@ function interactionToFormModel(request) {
 				label: request.message,
 				control: "select",
 				required: true,
-				options: request.options
+				options: request.options,
+				...request.suggestion ? { suggestion: request.suggestion } : {}
 			}],
 			submitLabel: "Select",
 			cancelLabel: "Cancel"
@@ -1059,6 +1062,21 @@ function interactionToFormModel(request) {
 			submitLabel: "Allow",
 			cancelLabel: "Deny"
 		};
+		case "file-pick": return {
+			kind: "file-pick",
+			title: "File requested",
+			message: request.message,
+			controls: [{
+				name: "file",
+				label: request.field ?? "file",
+				control: "file",
+				required: true,
+				...request.accept ? { accept: request.accept } : {},
+				...request.multiple ? { multiple: true } : {}
+			}],
+			submitLabel: "Choose file",
+			cancelLabel: "Decline"
+		};
 	}
 }
 const isEmpty = (v) => v === void 0 || v === "";
@@ -1133,7 +1151,10 @@ function applySuggestion(control, container) {
 * 全部经 doc.createElementNS 构建（内容来自技能输出，不拼 innerHTML）。
 */
 const SVG_NS = "http://www.w3.org/2000/svg";
-/** 固定 8 色循环调色板 */
+/**
+* 固定 8 色循环调色板。这是**数据编码**（区分序列），不是主题色；
+* 图表的轴线与文字等“外壳”颜色走 currentColor，跟随宿主容器的主题。
+*/
 const CHART_PALETTE = [
 	"#4e79a7",
 	"#f28e2b",
@@ -1156,7 +1177,8 @@ function text(doc, x, y, content, attrs = {}) {
 		x: String(x),
 		y: String(y),
 		"font-size": "9",
-		fill: "#555",
+		fill: "currentColor",
+		"fill-opacity": "0.65",
 		...attrs
 	});
 	node.textContent = content;
@@ -1181,14 +1203,16 @@ function renderBar(chart, svg, doc) {
 		y1: String(plot.y0),
 		x2: String(plot.x0),
 		y2: String(plot.y1),
-		stroke: "#999"
+		stroke: "currentColor",
+		"stroke-opacity": "0.35"
 	}));
 	svg.appendChild(el(doc, "line", {
 		x1: String(plot.x0),
 		y1: String(plot.y1),
 		x2: String(plot.x1),
 		y2: String(plot.y1),
-		stroke: "#999"
+		stroke: "currentColor",
+		"stroke-opacity": "0.35"
 	}));
 	if (max <= 0 || chart.labels.length === 0 || chart.series.length === 0) return;
 	const groupWidth = (plot.x1 - plot.x0) / chart.labels.length;
@@ -1228,14 +1252,16 @@ function renderLine(chart, svg, doc) {
 		y1: String(plot.y0),
 		x2: String(plot.x0),
 		y2: String(plot.y1),
-		stroke: "#999"
+		stroke: "currentColor",
+		"stroke-opacity": "0.35"
 	}));
 	svg.appendChild(el(doc, "line", {
 		x1: String(plot.x0),
 		y1: String(plot.y1),
 		x2: String(plot.x1),
 		y2: String(plot.y1),
-		stroke: "#999"
+		stroke: "currentColor",
+		"stroke-opacity": "0.35"
 	}));
 	if (max <= 0 || chart.labels.length === 0 || chart.series.length === 0) return;
 	const step = chart.labels.length > 1 ? (plot.x1 - plot.x0) / (chart.labels.length - 1) : 0;
@@ -1315,7 +1341,8 @@ function renderMiniChart(chart, doc) {
 	if (chart.title) svg.appendChild(text(doc, WIDTH / 2, 14, chart.title, {
 		"text-anchor": "middle",
 		"font-size": "11",
-		fill: "#333"
+		fill: "currentColor",
+		"fill-opacity": "1"
 	}));
 	switch (chart.kind) {
 		case "bar":
@@ -1632,7 +1659,7 @@ var WebFormBridge = class {
 		wrapper.appendChild(error);
 		return wrapper;
 	}
-	/** 历史值以**建议**形态出现（FR-5.9）：控件初始值仍为空，点「使用」才写入 */
+	/** 建议值以**建议**形态出现（FR-19.4）：控件初始值仍为空，点「使用」才写入 */
 	#renderSuggestion(control, container) {
 		const doc = this.#doc;
 		const row = doc.createElement("div");
@@ -1640,8 +1667,15 @@ var WebFormBridge = class {
 		row.setAttribute("data-webskill-suggestion", control.name);
 		const preview = doc.createElement("span");
 		preview.className = "webskill-form__suggestion-value";
-		preview.textContent = `Last entered: ${String(control.suggestion?.value)}`;
+		preview.textContent = `Suggested: ${String(control.suggestion?.value)}`;
 		row.appendChild(preview);
+		const reason = control.suggestion?.reason;
+		if (reason !== void 0 && reason !== "") {
+			const why = doc.createElement("span");
+			why.className = "webskill-form__suggestion-reason";
+			why.textContent = `(${reason})`;
+			row.appendChild(why);
+		}
 		const use = doc.createElement("button");
 		use.type = "button";
 		use.className = "webskill-form__suggestion-use";
@@ -2016,7 +2050,8 @@ const FIELD_TYPE = {
 	number: "number",
 	boolean: "toggle",
 	select: "select",
-	textarea: "textarea"
+	textarea: "textarea",
+	file: "file"
 };
 function toOptions(options) {
 	return (options ?? []).map((option) => ({
@@ -2035,6 +2070,8 @@ function toField(control) {
 			...control.description ? { description: control.description } : {},
 			...control.defaultValue !== void 0 ? { defaultValue: control.defaultValue } : {},
 			...control.suggestion ? { suggestion: control.suggestion } : {},
+			...control.accept ? { accept: [...control.accept] } : {},
+			...control.multiple ? { multiple: true } : {},
 			...control.options ? { options: toOptions(control.options) } : {}
 		}
 	};
@@ -2087,6 +2124,8 @@ const INTENTS = /* @__PURE__ */ new Set([
 	"download",
 	"refresh"
 ]);
+/** 去重靠指纹兜底，但重复调用本身也浪费一轮，所以先在提示词里劝阻（FR-21.5） */
+const NO_DUPLICATE_RENDER = "If a skill has already rendered a surface for this request, do not call render_ui again with the same content.";
 function isIntent(value) {
 	return typeof value === "string" && INTENTS.has(value);
 }
@@ -2167,7 +2206,7 @@ function createUiCatalogToolSource(options = {}) {
 	});
 	return {
 		kind: "ui-catalog",
-		systemPrompt: () => Promise.resolve(catalog.toPrompt()),
+		systemPrompt: () => Promise.resolve(`${catalog.toPrompt()}\n\n${NO_DUPLICATE_RENDER}`),
 		listToolSpecs: () => Promise.resolve(presets.length > 0 ? [renderTool(), presetTool()] : [renderTool()]),
 		canHandle: (name) => name === "render_ui" || presets.length > 0 && name === "describe_ui_preset",
 		call: (name, args) => {
@@ -2452,7 +2491,7 @@ function fromA2uiSpecAction(event) {
 */
 async function loadWebSkillLitCatalog() {
 	try {
-		const { webskillLitCatalog } = await import("./webskillLitCatalog-_mugzRHx-DiuJpCuf.js");
+		const { webskillLitCatalog } = await import("./webskillLitCatalog-_mugzRHx-B_54vxum.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);