@webskill/sdk 0.13.0 → 0.15.0

package/dist/miniChart-owdCdaw-.js

@@ -0,0 +1,533 @@
+//#region ../ui/src/model/formModel.ts
+const DEFAULT_INTERACTION_TEXTS = {
+	submit: "Submit",
+	cancel: "Cancel",
+	confirm: "Confirm",
+	select: "Select",
+	allow: "Allow",
+	deny: "Deny",
+	chooseFile: "Choose file",
+	decline: "Decline",
+	required: "This field is required",
+	suggested: "Suggested:",
+	useSuggestion: "Use"
+};
+function resolveInteractionTexts(texts) {
+	return texts ? {
+		...DEFAULT_INTERACTION_TEXTS,
+		...texts
+	} : DEFAULT_INTERACTION_TEXTS;
+}
+/** 可复用的部分取自 DEFAULT_INTERACTION_TEXTS，不另抄一份（AC-G10） */
+const DEFAULT_SURFACE_FORM_TEXTS = {
+	required: DEFAULT_INTERACTION_TEXTS.required,
+	submit: DEFAULT_INTERACTION_TEXTS.submit,
+	cancel: DEFAULT_INTERACTION_TEXTS.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: DEFAULT_INTERACTION_TEXTS.suggested,
+	useSuggestion: DEFAULT_INTERACTION_TEXTS.useSuggestion,
+	openDocument: "Open document"
+};
+function resolveSurfaceFormTexts(texts) {
+	return texts ? {
+		...DEFAULT_SURFACE_FORM_TEXTS,
+		...texts
+	} : DEFAULT_SURFACE_FORM_TEXTS;
+}
+const DEFAULT_SURFACE_HOST_CONTROL_TEXTS = {
+	previousPage: "Previous page",
+	previous: "Previous",
+	nextPage: "Next page",
+	next: "Next",
+	carousel: "Carousel"
+};
+function resolveSurfaceHostControlTexts(texts) {
+	return texts ? {
+		...DEFAULT_SURFACE_HOST_CONTROL_TEXTS,
+		...texts
+	} : DEFAULT_SURFACE_HOST_CONTROL_TEXTS;
+}
+/** 提交值按请求类型归形（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 "file-pick": return values["file"];
+		case "form": return values;
+	}
+}
+/** 五类 InteractionRequest → 统一中间模型（框架无关） */
+function interactionToFormModel(request, texts) {
+	const t = resolveInteractionTexts(texts);
+	switch (request.type) {
+		case "ask": return {
+			kind: "ask",
+			message: request.message,
+			controls: [{
+				name: "answer",
+				label: request.message,
+				control: "text",
+				required: true,
+				...request.suggestion ? { suggestion: request.suggestion } : {}
+			}],
+			submitLabel: t.submit,
+			cancelLabel: t.cancel
+		};
+		case "confirm": return {
+			kind: "confirm",
+			message: request.message,
+			controls: [{
+				name: "confirmed",
+				label: request.message,
+				control: "boolean",
+				defaultValue: request.defaultValue ?? true
+			}],
+			submitLabel: t.confirm,
+			cancelLabel: t.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.suggestion ? { suggestion: f.suggestion } : {},
+				...f.options ? { options: f.options } : {}
+			})),
+			submitLabel: t.submit,
+			cancelLabel: t.cancel
+		};
+		case "select": return {
+			kind: "select",
+			message: request.message,
+			controls: [{
+				name: "selected",
+				label: request.message,
+				control: "select",
+				required: true,
+				options: request.options,
+				...request.suggestion ? { suggestion: request.suggestion } : {}
+			}],
+			submitLabel: t.select,
+			cancelLabel: t.cancel
+		};
+		case "authorize": return {
+			kind: "authorize",
+			title: "Authorization required",
+			message: request.message,
+			controls: [],
+			submitLabel: t.allow,
+			cancelLabel: t.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: t.chooseFile,
+			cancelLabel: t.decline
+		};
+	}
+}
+
+//#endregion
+//#region ../ui/src/model/collectValues.ts
+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
+	};
+}
+/**
+* 采纳建议值（FR-5.9）：把 `control.suggestion` 写进已渲染的控件。
+* 与 `collectValues` 共用同一套选择器与编码约定——两边分开实现的话，
+* select 的 JSON 编码值迟早会对不上。
+* @experimental
+*/
+function applySuggestion(control, container) {
+	if (control.suggestion === void 0) return;
+	const el = container.querySelector(controlSelector(control.name));
+	if (el === null) return;
+	const { value } = control.suggestion;
+	if (control.control === "boolean") {
+		el.checked = value === true;
+		return;
+	}
+	if (control.control === "select") {
+		el.value = JSON.stringify(value);
+		return;
+	}
+	el.value = value === void 0 || value === null ? "" : String(value);
+}
+
+//#endregion
+//#region ../ui/src/markdown/miniMarkdown.ts
+/**
+* 最小子集 markdown → DOM：标题（#..###）、无序列表、代码块（```）、加粗、链接。
+* 全部内容经 textContent 写入，用户内容天然转义防 HTML 注入。
+*/
+const INLINE_RE = /\*\*([^*]+)\*\*|\[([^\]]+)\]\(([^)\s]+)\)/g;
+function appendInline(container, text, doc) {
+	let last = 0;
+	for (const match of text.matchAll(INLINE_RE)) {
+		const index = match.index ?? 0;
+		if (index > last) container.appendChild(doc.createTextNode(text.slice(last, index)));
+		if (match[1] !== void 0) {
+			const strong = doc.createElement("strong");
+			strong.textContent = match[1];
+			container.appendChild(strong);
+		} else {
+			const label = match[2] ?? "";
+			const url = match[3] ?? "";
+			if (/^https?:\/\//.test(url)) {
+				const a = doc.createElement("a");
+				a.href = url;
+				a.textContent = label;
+				a.rel = "noopener noreferrer";
+				container.appendChild(a);
+			} else container.appendChild(doc.createTextNode(match[0]));
+		}
+		last = index + match[0].length;
+	}
+	if (last < text.length) container.appendChild(doc.createTextNode(text.slice(last)));
+}
+function renderMiniMarkdown(text, doc) {
+	const root = doc.createElement("div");
+	root.className = "webskill-md";
+	const lines = text.split(/\r?\n/);
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i] ?? "";
+		if (line.trimStart().startsWith("```")) {
+			const codeLines = [];
+			i++;
+			while (i < lines.length && !(lines[i] ?? "").trimStart().startsWith("```")) {
+				codeLines.push(lines[i] ?? "");
+				i++;
+			}
+			i++;
+			const pre = doc.createElement("pre");
+			const code = doc.createElement("code");
+			code.textContent = codeLines.join("\n");
+			pre.appendChild(code);
+			root.appendChild(pre);
+			continue;
+		}
+		const heading = /^(#{1,3})\s+(.*)$/.exec(line);
+		if (heading) {
+			const level = heading[1].length;
+			const h = doc.createElement(`h${level}`);
+			appendInline(h, heading[2] ?? "", doc);
+			root.appendChild(h);
+			i++;
+			continue;
+		}
+		if (/^\s*[-*]\s+/.test(line)) {
+			const ul = doc.createElement("ul");
+			while (i < lines.length && /^\s*[-*]\s+/.test(lines[i] ?? "")) {
+				const li = doc.createElement("li");
+				appendInline(li, (lines[i] ?? "").replace(/^\s*[-*]\s+/, ""), doc);
+				ul.appendChild(li);
+				i++;
+			}
+			root.appendChild(ul);
+			continue;
+		}
+		if (line.trim() === "") {
+			i++;
+			continue;
+		}
+		const p = doc.createElement("p");
+		appendInline(p, line, doc);
+		root.appendChild(p);
+		i++;
+	}
+	return root;
+}
+
+//#endregion
+//#region ../ui/src/chart/miniChart.ts
+/**
+* 轻量 SVG 图表自绘（bar/line/pie，零依赖，三端复用单一来源）。
+* 全部经 doc.createElementNS 构建（内容来自技能输出，不拼 innerHTML）。
+*/
+const SVG_NS = "http://www.w3.org/2000/svg";
+/**
+* 固定 8 色循环调色板。这是**数据编码**（区分序列），不是主题色；
+* 图表的轴线与文字等“外壳”颜色走 currentColor，跟随宿主容器的主题。
+*/
+const CHART_PALETTE = [
+	"#4e79a7",
+	"#f28e2b",
+	"#e15759",
+	"#76b7b2",
+	"#59a14f",
+	"#edc948",
+	"#b07aa1",
+	"#ff9da7"
+];
+const WIDTH = 320;
+const HEIGHT = 200;
+function el(doc, name, attrs) {
+	const node = doc.createElementNS(SVG_NS, name);
+	for (const [key, value] of Object.entries(attrs)) node.setAttribute(key, value);
+	return node;
+}
+function text(doc, x, y, content, attrs = {}) {
+	const node = el(doc, "text", {
+		x: String(x),
+		y: String(y),
+		"font-size": "9",
+		fill: "currentColor",
+		"fill-opacity": "0.65",
+		...attrs
+	});
+	node.textContent = content;
+	return node;
+}
+const fmt = (n) => Number.isInteger(n) ? String(n) : n.toFixed(1);
+function maxValue(chart) {
+	let max = 0;
+	for (const s of chart.series) for (const v of s.data) if (v > max) max = v;
+	return max;
+}
+function renderBar(chart, svg, doc) {
+	const plot = {
+		x0: 30,
+		y0: 24,
+		x1: 312,
+		y1: 164
+	};
+	const max = maxValue(chart);
+	svg.appendChild(el(doc, "line", {
+		x1: String(plot.x0),
+		y1: String(plot.y0),
+		x2: String(plot.x0),
+		y2: String(plot.y1),
+		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: "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;
+	const barWidth = Math.max(1, groupWidth / chart.series.length * .7);
+	chart.series.forEach((series, si) => {
+		const color = CHART_PALETTE[si % CHART_PALETTE.length];
+		series.data.forEach((value, li) => {
+			if (li >= chart.labels.length) return;
+			const height = (plot.y1 - plot.y0) * value / max;
+			const x = plot.x0 + li * groupWidth + (groupWidth - barWidth * chart.series.length) / 2 + si * barWidth;
+			const y = plot.y1 - height;
+			svg.appendChild(el(doc, "rect", {
+				x: String(x),
+				y: String(y),
+				width: String(barWidth),
+				height: String(height),
+				fill: color,
+				"data-series": series.name ?? String(si)
+			}));
+			if (chart.series.length === 1) svg.appendChild(text(doc, x + barWidth / 2, y - 2, fmt(value), { "text-anchor": "middle" }));
+		});
+	});
+	chart.labels.forEach((label, li) => {
+		svg.appendChild(text(doc, plot.x0 + li * groupWidth + groupWidth / 2, plot.y1 + 12, label, { "text-anchor": "middle" }));
+	});
+}
+function renderLine(chart, svg, doc) {
+	const plot = {
+		x0: 30,
+		y0: 24,
+		x1: 312,
+		y1: 164
+	};
+	const max = maxValue(chart);
+	svg.appendChild(el(doc, "line", {
+		x1: String(plot.x0),
+		y1: String(plot.y0),
+		x2: String(plot.x0),
+		y2: String(plot.y1),
+		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: "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;
+	const px = (li) => chart.labels.length > 1 ? plot.x0 + li * step : (plot.x0 + plot.x1) / 2;
+	const py = (v) => plot.y1 - (plot.y1 - plot.y0) * v / max;
+	chart.series.forEach((series, si) => {
+		const color = CHART_PALETTE[si % CHART_PALETTE.length];
+		const points = series.data.slice(0, chart.labels.length).map((v, li) => `${px(li)},${py(v)}`).join(" ");
+		if (points !== "") svg.appendChild(el(doc, "polyline", {
+			points,
+			fill: "none",
+			stroke: color,
+			"stroke-width": "1.5"
+		}));
+		series.data.slice(0, chart.labels.length).forEach((v, li) => {
+			svg.appendChild(el(doc, "circle", {
+				cx: String(px(li)),
+				cy: String(py(v)),
+				r: "2",
+				fill: color
+			}));
+		});
+	});
+	chart.labels.forEach((label, li) => {
+		svg.appendChild(text(doc, px(li), plot.y1 + 12, label, { "text-anchor": "middle" }));
+	});
+}
+function renderPie(chart, svg, doc) {
+	const data = (chart.series[0]?.data ?? []).slice(0, chart.labels.length);
+	const total = data.reduce((sum, v) => sum + (v > 0 ? v : 0), 0);
+	const cx = 90;
+	const cy = 104;
+	const r = 72;
+	if (total <= 0) {
+		svg.appendChild(text(doc, cx, cy, "No data", { "text-anchor": "middle" }));
+		return;
+	}
+	let angle = -Math.PI / 2;
+	data.forEach((value, i) => {
+		const label = chart.labels[i] ?? String(i);
+		const color = CHART_PALETTE[i % CHART_PALETTE.length];
+		const slice = Math.max(value, 0) / total * Math.PI * 2;
+		const x0 = cx + r * Math.cos(angle);
+		const y0 = cy + r * Math.sin(angle);
+		const x1 = cx + r * Math.cos(angle + slice);
+		const y1 = cy + r * Math.sin(angle + slice);
+		const path = el(doc, "path", {
+			d: `M ${cx} ${cy} L ${x0} ${y0} A ${r} ${r} 0 ${slice > Math.PI ? "1" : "0"} 1 ${x1} ${y1} Z`,
+			fill: color,
+			"data-label": label
+		});
+		svg.appendChild(path);
+		angle += slice;
+		const ly = 40 + i * 14;
+		svg.appendChild(el(doc, "rect", {
+			x: "190",
+			y: String(ly - 7),
+			width: "8",
+			height: "8",
+			fill: color
+		}));
+		svg.appendChild(text(doc, 202, ly, `${label} (${fmt(value)})`));
+	});
+}
+/**
+* ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）。
+* mini 档只有这三种画法，其余类型走最接近的一种并在图内注明是近似呈现。
+* @stable
+*/
+function renderMiniChart(chart, doc) {
+	const svg = el(doc, "svg", {
+		viewBox: `0 0 ${WIDTH} ${HEIGHT}`,
+		width: String(WIDTH),
+		height: String(HEIGHT),
+		class: `webskill-chart webskill-chart--${chart.kind}`,
+		role: "img"
+	});
+	if (chart.title) svg.appendChild(text(doc, WIDTH / 2, 14, chart.title, {
+		"text-anchor": "middle",
+		"font-size": "11",
+		fill: "currentColor",
+		"fill-opacity": "1"
+	}));
+	switch (chart.kind) {
+		case "bar":
+		case "stacked-bar":
+			renderBar(chart, svg, doc);
+			break;
+		case "line":
+			renderLine(chart, svg, doc);
+			break;
+		case "pie":
+			renderPie(chart, svg, doc);
+			break;
+		default:
+			renderLine(chart, svg, doc);
+			break;
+	}
+	if (chart.kind !== "bar" && chart.kind !== "line" && chart.kind !== "pie") svg.appendChild(text(doc, WIDTH / 2, HEIGHT - 4, `Approximate rendering of "${chart.kind}"`, { "text-anchor": "middle" }));
+	return svg;
+}
+/** A2UI/OpenUI 降级：chart → table（labels 为首列，series 各为一列） */
+function chartToTable(chart) {
+	return {
+		type: "table",
+		columns: ["label", ...chart.series.map((s, i) => s.name ?? `series ${i + 1}`)],
+		rows: chart.labels.map((label, li) => [label, ...chart.series.map((s) => s.data[li] ?? null)])
+	};
+}
+
+//#endregion
+export { applySuggestion as a, DEFAULT_SURFACE_FORM_TEXTS as c, resolveInteractionTexts as d, resolveSurfaceFormTexts as f, renderMiniMarkdown as i, DEFAULT_SURFACE_HOST_CONTROL_TEXTS as l, shapeInteractionValue as m, chartToTable as n, collectValues as o, resolveSurfaceHostControlTexts as p, renderMiniChart as r, DEFAULT_INTERACTION_TEXTS as s, CHART_PALETTE as t, interactionToFormModel as u };

package/dist/node.d.ts

@@ -1,6 +1,6 @@
-import { $ as SignatureAuditSink, B as JsonSchema, Ct as VerifyResult, J as SKILL_MANIFEST_FILE, L as FileStat, M as ArchiveLimits, R as FileSystemProvider, S as UiBridge, _t as SkillsLockfile, b as RenderResultRequest, c as InteractionResponse, dt as SkillManifest, q as SKILLS_LOCKFILE, s as InteractionRequest, st as SkillInstallSource, ut as SkillManagerPort, xt as UnsignedPolicy, yt as TrustedKeyStore } from "./types-DLctJep_-B5G4uk2u.js";
-import { Bt as SchemaInferer, Ht as ScriptExecutor, In as WebSkillRuntime, L as FsArtifactStore, Ln as WebSkillRuntimeDeps, R as FsMemoryStore, Un as createScriptContext, Vt as ScriptExecutionContext, it as NetworkPolicy, m as ApprovalScope, pn as ToolResult, un as ToolDefinition, y as BridgeCapabilities } from "./index-DkvBhJQy.js";
-import { a as AuditLog, b as SkillVersionStore, d as CandidateSkill, m as CandidateStore, r as ApprovalPolicy } from "./skillVersionStore-D-qHk9ZE-DheTIwAB.js";
+import { $ as SKILLS_LOCKFILE, Ct as SkillsLockfile, Et as TrustedKeyStore, H as FileStat, K as JsonSchema, N as ArchiveLimits, S as UiBridge, U as FileSystemProvider, _t as SkillManifest, at as SignatureAuditSink, b as RenderResultRequest, c as InteractionResponse, et as SKILL_MANIFEST_FILE, gt as SkillManagerPort, jt as VerifyResult, kt as UnsignedPolicy, pt as SkillInstallSource, s as InteractionRequest } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { Gn as WebSkillRuntimeDeps, Gt as SchemaInferer, H as FsMemoryStore, Kt as ScriptExecutionContext, V as FsArtifactStore, Wn as WebSkillRuntime, Zn as createScriptContext, ct as NetworkPolicy, gn as ToolDefinition, m as ApprovalScope, qt as ScriptExecutor, y as BridgeCapabilities, yn as ToolResult } from "./index-Oc3H89TJ.js";
+import { a as AuditLog, b as SkillVersionStore, d as CandidateSkill, m as CandidateStore, r as ApprovalPolicy } from "./skillVersionStore-B24Jjjry-C4zomhMZ.js";
 import { n as LlmEnvConfig, s as probeLlmCapabilities, t as LlmCapabilities } from "./env-AK3cSMEA-Dli6QU5E.js";
 import { Readable, Writable } from "node:stream";
 //#region ../node/dist/index.d.ts