@webskill/sdk 0.1.5 → 0.2.0

package/dist/{types-CgNC-oQu-DEcIBJKG.d.ts → types-CKm5G_eQ-8W8FnP4u.d.ts}

@@ -127,6 +127,8 @@ interface FileSystemProvider {
   remove(path: string, options?: {
     recursive?: boolean;
   }): Promise<void>;
+  /** 原子重命名（lockfile 等先写临时文件再 rename 的场景；实现侧无原生 rename 时 copy+remove 兜底） */
+  rename(from: string, to: string): Promise<void>;
 }
 //#endregion
 //#region src/fs/memoryFs.d.ts
@@ -146,8 +148,13 @@ declare class MemoryFS implements FileSystemProvider {
   remove(path: string, options?: {
     recursive?: boolean;
   }): Promise<void>;
+  rename(from: string, to: string): Promise<void>;
 }
 //#endregion
+//#region src/fs/atomicWrite.d.ts
+/** 原子写文本：先写临时文件再 rename（进程崩溃不留下半写文件；lockfile 等账本场景） */
+declare function atomicWriteText(fs: FileSystemProvider, path: string, content: string): Promise<void>;
+//#endregion
 //#region src/fs/pathSecurity.d.ts
 /** 统一分隔符为 `/`，去除 `.` 段与重复分隔符（不解析 `..`） */
 declare function normalizePath(path: string): string;
@@ -365,7 +372,7 @@ declare function escapeXml(text: string): string;
 declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
 declare const xmlRenderer: CatalogRenderer;
 //#endregion
-//#region ../runtime/dist/types-CgNC-oQu.d.ts
+//#region ../runtime/dist/types-CKm5G_eQ.d.ts
 //#region src/llm/streamTypes.d.ts
 /** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
 type LlmStreamEvent = {
@@ -528,6 +535,8 @@ interface RenderResultRequest {
 /** @stable */
 interface UiBridge {
   request(input: InteractionRequest): Promise<InteractionResponse>;
+  /** 尽力取消等待中的 request（如交互超时后清理遗留表单/提示；可选实现） */
+  cancel?(id: string): void | Promise<void>;
   progress?(input: {
     runId: string;
     message: string;
@@ -570,6 +579,8 @@ interface MemoryStore {
     value: unknown;
   }>>;
   clear(scope?: string): Promise<void>;
+  /** 可选：scope 级原子段（read-modify-write 全段串行；fn 收到底层 store，禁止重入装饰器自身） */
+  transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { checkSkillRules as $, SKILL_NAME_PATTERN as A, SkillMetadata as B, FileStat as C, SKILLS_LOCKFILE as D, MemoryFS as E, SkillDocument as F, ValidationReport as G, SkillReader as H, SkillInstallSource as I, WebSkillErrorCode as J, VerifyResult as K, SkillIssue as L, SkillCatalog as M, SkillCatalogEntry as N, SKILL_MANIFEST_FILE as O, SkillDiscovery as P, checkDependencyCycles as Q, SkillLocation as R, DiscoveryResult as S, JsonSchema as T, SkillSource as U, SkillPackManifest as V, SkillsLockfile as W, buildCatalog as X, assertSafePathSegment as Y, buildManifest as Z, RenderResultRequest as _, InteractionPolicy as a, normalizePath as at, CatalogRenderer as b, LlmClient as c, readResponseWithLimit as ct, LlmResponse as d, resolveArchiveLimits as dt, computeDigest as et, LlmStreamEvent as f, resolveInsideRoot as ft, RenderBlock as g, xmlRenderer as gt, MemoryStore as h, verifyManifest as ht, FormField as i, jsonRenderer as it, SKILL_PACK_FILE as j, SKILL_NAME_MAX_LENGTH as k, LlmCompleteInput as l, renderAvailableSkillsXml as lt, LlmToolSpec as m, validateSkills as mt, ArtifactStore as n, exportSkills as nt, InteractionRequest as o, parseSkillMarkdown as ot, LlmToolCall as p, unzipWithLimits as pt, WebSkillError as q, ChartSpec as r, isValidSkillName as rt, InteractionResponse as s, parseSkillPackManifest as st, Artifact as t, escapeXml as tt, LlmMessage as u, renderCatalogJson as ut, UiBridge as v, FileSystemProvider as w, DEFAULT_ARCHIVE_LIMITS as x, ArchiveLimits as y, SkillManifest as z };
+export { checkDependencyCycles as $, SKILL_NAME_PATTERN as A, SkillMetadata as B, FileStat as C, SKILLS_LOCKFILE as D, MemoryFS as E, SkillDocument as F, ValidationReport as G, SkillReader as H, SkillInstallSource as I, WebSkillErrorCode as J, VerifyResult as K, SkillIssue as L, SkillCatalog as M, SkillCatalogEntry as N, SKILL_MANIFEST_FILE as O, SkillDiscovery as P, buildManifest as Q, SkillLocation as R, DiscoveryResult as S, JsonSchema as T, SkillSource as U, SkillPackManifest as V, SkillsLockfile as W, atomicWriteText as X, assertSafePathSegment as Y, buildCatalog as Z, RenderResultRequest as _, xmlRenderer as _t, InteractionPolicy as a, jsonRenderer as at, CatalogRenderer as b, LlmClient as c, parseSkillPackManifest as ct, LlmResponse as d, renderCatalogJson as dt, checkSkillRules as et, LlmStreamEvent as f, resolveArchiveLimits as ft, RenderBlock as g, verifyManifest as gt, MemoryStore as h, validateSkills as ht, FormField as i, isValidSkillName as it, SKILL_PACK_FILE as j, SKILL_NAME_MAX_LENGTH as k, LlmCompleteInput as l, readResponseWithLimit as lt, LlmToolSpec as m, unzipWithLimits as mt, ArtifactStore as n, escapeXml as nt, InteractionRequest as o, normalizePath as ot, LlmToolCall as p, resolveInsideRoot as pt, WebSkillError as q, ChartSpec as r, exportSkills as rt, InteractionResponse as s, parseSkillMarkdown as st, Artifact as t, computeDigest as tt, LlmMessage as u, renderAvailableSkillsXml as ut, UiBridge as v, FileSystemProvider as w, DEFAULT_ARCHIVE_LIMITS as x, ArchiveLimits as y, SkillManifest as z };

package/dist/ui-react.d.ts

@@ -1,4 +1,4 @@
-import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DEcIBJKG.js";
+import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CKm5G_eQ-8W8FnP4u.js";
 //#region ../ui-react/dist/index.d.ts
 //#region src/bridgeState.d.ts
 /**
@@ -9,6 +9,8 @@ declare class ReactBridgeState implements UiBridge {
   #private;
   pending: InteractionRequest | null;
   latestResult: RenderResultRequest | null;
+  /** 当前流式 runId（并发 run 隔离：新 runId 重置文本） */
+  streamingRunId: string | null;
   streamingText: string;
   /** React useSyncExternalStore 兼容订阅 */
   subscribe: (listener: () => void) => (() => void);
@@ -16,7 +18,7 @@ declare class ReactBridgeState implements UiBridge {
   /** 组件提交/取消回调 */
   resolve(response: InteractionResponse): void;
   renderResult(input: RenderResultRequest): Promise<void>;
-  onTextDelta(_runId: string, delta: string): Promise<void>;
+  onTextDelta(runId: string, delta: string): Promise<void>;
 }
 //#endregion
 //#region src/components/InteractionForm.d.ts

package/dist/ui-react.js

@@ -1,4 +1,4 @@
-import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-CfBOjJ4p.js";
+import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BJobG0i-.js";
 import { useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 
@@ -10,6 +10,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 var ReactBridgeState = class {
 	pending = null;
 	latestResult = null;
+	/** 当前流式 runId（并发 run 隔离：新 runId 重置文本） */
+	streamingRunId = null;
 	streamingText = "";
 	#listeners = /* @__PURE__ */ new Set();
 	#resolvers = /* @__PURE__ */ new Map();
@@ -41,14 +43,20 @@ var ReactBridgeState = class {
 		this.latestResult = input;
 		this.#emit();
 	}
-	async onTextDelta(_runId, delta) {
+	async onTextDelta(runId, delta) {
+		if (this.streamingRunId !== runId) {
+			this.streamingRunId = runId;
+			this.streamingText = "";
+		}
 		this.streamingText += delta;
 		this.#emit();
 	}
 };
-function Control({ control }) {
+function Control({ control, invalid }) {
+	const controlId = `webskill-field-${control.name}`;
 	const label = /* @__PURE__ */ jsxs("label", {
 		className: "webskill-form__label",
+		htmlFor: controlId,
 		children: [control.label, control.required ? " *" : ""]
 	});
 	const description = control.description ? /* @__PURE__ */ jsx("div", {
@@ -64,6 +72,8 @@ function Control({ control }) {
 				description,
 				/* @__PURE__ */ jsx("input", {
 					type: "checkbox",
+					id: controlId,
+					"aria-invalid": invalid || void 0,
 					className: "webskill-form__input",
 					"data-webskill-control": control.name,
 					defaultChecked: control.defaultValue === true
@@ -77,6 +87,8 @@ function Control({ control }) {
 				label,
 				description,
 				/* @__PURE__ */ jsx("select", {
+					id: controlId,
+					"aria-invalid": invalid || void 0,
 					className: "webskill-form__input",
 					"data-webskill-control": control.name,
 					children: (control.options ?? []).map((option, i) => /* @__PURE__ */ jsx("option", {
@@ -94,6 +106,8 @@ function Control({ control }) {
 				label,
 				description,
 				/* @__PURE__ */ jsx("textarea", {
+					id: controlId,
+					"aria-invalid": invalid || void 0,
 					className: "webskill-form__input",
 					"data-webskill-control": control.name,
 					defaultValue: control.defaultValue !== void 0 ? String(control.defaultValue) : ""
@@ -108,6 +122,8 @@ function Control({ control }) {
 				description,
 				/* @__PURE__ */ jsx("input", {
 					type: control.control === "number" ? "number" : "text",
+					id: controlId,
+					"aria-invalid": invalid || void 0,
 					className: "webskill-form__input",
 					"data-webskill-control": control.name,
 					defaultValue: control.defaultValue !== void 0 ? String(control.defaultValue) : ""
@@ -151,7 +167,12 @@ 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.includes(control.name) ? /* @__PURE__ */ jsx("div", {
+				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]

package/dist/ui-vue.d.ts

@@ -1,10 +1,11 @@
-import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DEcIBJKG.js";
+import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CKm5G_eQ-8W8FnP4u.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts
 interface VueBridgeSnapshot {
   pending: InteractionRequest | null;
   latestResult: RenderResultRequest | null;
+  streamingRunId: string | null;
   streamingText: string;
 }
 /**
@@ -18,7 +19,7 @@ declare class VueBridgeState implements UiBridge {
   /** 组件提交/取消回调 */
   resolve(response: InteractionResponse): void;
   renderResult(input: RenderResultRequest): Promise<void>;
-  onTextDelta(_runId: string, delta: string): Promise<void>;
+  onTextDelta(runId: string, delta: string): Promise<void>;
 }
 //#endregion
 //#region src/components/interactionForm.d.ts

package/dist/ui-vue.js

@@ -1,4 +1,4 @@
-import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-CfBOjJ4p.js";
+import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BJobG0i-.js";
 import { defineComponent, h, reactive, ref } from "vue";
 
 //#region ../ui-vue/dist/index.js
@@ -10,6 +10,7 @@ var VueBridgeState = class {
 	state = reactive({
 		pending: null,
 		latestResult: null,
+		streamingRunId: null,
 		streamingText: ""
 	});
 	#resolvers = /* @__PURE__ */ new Map();
@@ -30,18 +31,28 @@ var VueBridgeState = class {
 	async renderResult(input) {
 		this.state.latestResult = input;
 	}
-	async onTextDelta(_runId, delta) {
+	async onTextDelta(runId, delta) {
+		if (this.state.streamingRunId !== runId) {
+			this.state.streamingRunId = runId;
+			this.state.streamingText = "";
+		}
 		this.state.streamingText += delta;
 	}
 };
-function renderControl(control) {
-	const label = h("label", { class: "webskill-form__label" }, [control.label, ...control.required ? [" *"] : []]);
+function renderControl(control, invalid) {
+	const controlId = `webskill-field-${control.name}`;
+	const label = h("label", {
+		class: "webskill-form__label",
+		for: controlId
+	}, [control.label, ...control.required ? [" *"] : []]);
 	const description = control.description ? h("div", { class: "webskill-form__description" }, control.description) : null;
 	let input;
 	switch (control.control) {
 		case "boolean":
 			input = h("input", {
 				type: "checkbox",
+				id: controlId,
+				"aria-invalid": invalid || void 0,
 				class: "webskill-form__input",
 				"data-webskill-control": control.name,
 				checked: control.defaultValue === true
@@ -49,6 +60,8 @@ function renderControl(control) {
 			break;
 		case "select":
 			input = h("select", {
+				id: controlId,
+				"aria-invalid": invalid || void 0,
 				class: "webskill-form__input",
 				"data-webskill-control": control.name
 			}, (control.options ?? []).map((option) => h("option", {
@@ -58,6 +71,8 @@ function renderControl(control) {
 			break;
 		case "textarea":
 			input = h("textarea", {
+				id: controlId,
+				"aria-invalid": invalid || void 0,
 				class: "webskill-form__input",
 				"data-webskill-control": control.name,
 				value: control.defaultValue !== void 0 ? String(control.defaultValue) : ""
@@ -65,6 +80,8 @@ function renderControl(control) {
 			break;
 		default: input = h("input", {
 			type: control.control === "number" ? "number" : "text",
+			id: controlId,
+			"aria-invalid": invalid || void 0,
 			class: "webskill-form__input",
 			"data-webskill-control": control.name,
 			value: control.defaultValue !== void 0 ? String(control.defaultValue) : ""
@@ -113,7 +130,11 @@ 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) ? h("div", { 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)), 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"
@@ -132,20 +153,28 @@ const InteractionForm = defineComponent({
 });
 function renderBlock(block, key) {
 	switch (block.type) {
-		case "chart": return h("div", {
-			key,
-			onVnodeMounted: (vnode) => {
+		case "chart": {
+			const renderChart = (vnode) => {
 				const el = vnode.el;
 				if (el) el.replaceChildren(renderMiniChart(block.chart, el.ownerDocument));
-			}
-		});
-		case "markdown": return h("div", {
-			key,
-			onVnodeMounted: (vnode) => {
+			};
+			return h("div", {
+				key,
+				onVnodeMounted: renderChart,
+				onVnodeUpdated: renderChart
+			});
+		}
+		case "markdown": {
+			const renderMd = (vnode) => {
 				const el = vnode.el;
 				if (el) el.replaceChildren(renderMiniMarkdown(block.text, el.ownerDocument));
-			}
-		});
+			};
+			return h("div", {
+				key,
+				onVnodeMounted: renderMd,
+				onVnodeUpdated: renderMd
+			});
+		}
 		case "json": return h("pre", {
 			key,
 			class: "webskill-result__json"

package/dist/ui.d.ts

@@ -1,5 +1,5 @@
-import { _ as RenderResultRequest, g as RenderBlock, o as InteractionRequest, r as ChartSpec, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DEcIBJKG.js";
-import { ft as buildRenderResult } from "./index-COuOu6gw.js";
+import { _ as RenderResultRequest, g as RenderBlock, o as InteractionRequest, r as ChartSpec, s as InteractionResponse, v as UiBridge } from "./types-CKm5G_eQ-8W8FnP4u.js";
+import { mt as buildRenderResult } from "./index-CySxIvRz.js";
 //#region ../ui/dist/index.d.ts
 //#region src/model/formModel.d.ts
 interface FormModel {
@@ -50,7 +50,7 @@ declare function renderMiniMarkdown(text: string, doc: Document): HTMLElement;
 //#endregion
 //#region src/chart/miniChart.d.ts
 /** 固定 8 色循环调色板 */
-declare const CHART_PALETTE: readonly ['#4e79a7', '#f28e2b', '#e15759', '#76b7b2', '#59a14f', '#edc948', '#b07aa1', '#ff9da7'];
+declare const CHART_PALETTE: readonly ["#4e79a7", "#f28e2b", "#e15759", "#76b7b2", "#59a14f", "#edc948", "#b07aa1", "#ff9da7"];
 /**
  * ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）
  * @stable
@@ -77,6 +77,8 @@ declare class WebFormBridge implements UiBridge {
     styles?: boolean;
   });
   request(input: InteractionRequest): Promise<InteractionResponse>;
+  /** 尽力取消等待中的 request（超时后清理遗留表单） */
+  cancel(id: string): void;
   renderResult(input: RenderResultRequest): Promise<void>;
   progress(input: {
     runId: string;

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { C as buildRenderResult } from "./dist-DuGN5x0v.js";
-import { C as renderRenderResult, D as toVercelToolInvocation, E as toOpenUiLang, S as renderMiniMarkdown, T as toA2uiMessages, _ as fromOpenUiAction, a as CHART_PALETTE, b as renderBlocks, c as OPENUI_SUBMIT_ACTION, d as WEBSKILL_STYLES_CSS, f as WebFormBridge, g as fromA2uiAction, h as ensureStyles, i as A2UI_VERSION, l as VERCEL_INTERACTION_TOOL_NAME, m as collectValues, n as A2UI_CANCEL_ACTION, o as LitRendererBridge, p as chartToTable, r as A2UI_SUBMIT_ACTION, s as OPENUI_CANCEL_ACTION, t as A2UI_BASIC_CATALOG_ID, u as VercelUiBridge, v as fromVercelToolResult, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-CfBOjJ4p.js";
+import { w as buildRenderResult } from "./dist-BS5OpedX.js";
+import { C as renderRenderResult, D as toVercelToolInvocation, E as toOpenUiLang, S as renderMiniMarkdown, T as toA2uiMessages, _ as fromOpenUiAction, a as CHART_PALETTE, b as renderBlocks, c as OPENUI_SUBMIT_ACTION, d as WEBSKILL_STYLES_CSS, f as WebFormBridge, g as fromA2uiAction, h as ensureStyles, i as A2UI_VERSION, l as VERCEL_INTERACTION_TOOL_NAME, m as collectValues, n as A2UI_CANCEL_ACTION, o as LitRendererBridge, p as chartToTable, r as A2UI_SUBMIT_ACTION, s as OPENUI_CANCEL_ACTION, t as A2UI_BASIC_CATALOG_ID, u as VercelUiBridge, v as fromVercelToolResult, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BJobG0i-.js";
 
 export { A2UI_BASIC_CATALOG_ID, A2UI_CANCEL_ACTION, A2UI_SUBMIT_ACTION, A2UI_VERSION, CHART_PALETTE, LitRendererBridge, OPENUI_CANCEL_ACTION, OPENUI_SUBMIT_ACTION, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_STYLES_CSS, WebFormBridge, buildRenderResult, chartToTable, collectValues, ensureStyles, fromA2uiAction, fromOpenUiAction, fromVercelToolResult, interactionToFormModel, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiMessages, toOpenUiLang, toVercelToolInvocation };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.1.5",
-  "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
+  "version": "0.2.0",
+  "description": "WebSkill \u2014 browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -58,17 +58,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
     "fflate": "0.8.3",
-    "oxc-parser": "0.141.0",
-    "tar": "7.5.21",
-    "yaml": "^2.9.0",
-    "zod": "^4.4.3"
+    "yaml": "^2.9.0"
   },
   "peerDependencies": {
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
-    "vue": ">=3.5.0"
+    "vue": ">=3.5.0",
+    "@modelcontextprotocol/sdk": ">=1.29.0",
+    "oxc-parser": ">=0.141.0",
+    "tar": ">=7.5.0",
+    "zod": ">=4.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -79,6 +79,18 @@
     },
     "vue": {
       "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "oxc-parser": {
+      "optional": true
+    },
+    "tar": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -93,6 +105,6 @@
     "@webskill/ui-react": "workspace:*",
     "@webskill/ui-vue": "workspace:*",
     "tsdown": "0.22.13",
-    "typescript": "7.0.2"
+    "typescript": "6.0.3"
   }
 }