@webskill/sdk 0.0.1 → 0.0.2

package/README.md

@@ -47,15 +47,18 @@ const runtime = new WebSkillRuntime({
   llm: new OpenAiCompatibleClient({
     baseUrl: 'https://your-llm-endpoint/v1',
     apiKey: process.env.LLM_API_KEY!,
-    model: 'your-model',
+    model: 'your-model'
   }),
   executor: new NodeScriptExecutor(new NodeFS()),
-  artifactStore: new FileArtifactStore({ root: './.webskill/artifacts' }),
+  artifactStore: new FileArtifactStore({ root: './.webskill/artifacts' })
 });
 
 // Discover skills and render the catalog
 const { entries, issues } = await runtime.discover();
-console.log(entries.map((e) => e.name), issues);
+console.log(
+  entries.map((e) => e.name),
+  issues
+);
 
 // Run the agent loop
 const { output, run } = await runtime.run('Use the calculator skill to compute 2+3.');
@@ -64,16 +67,16 @@ console.log(output, run.status, run.trace.length);
 
 ## Subpath exports
 
-| Subpath | Contents |
-| --- | --- |
-| `@webskill/sdk` | Core protocol + runtime engine (discovery, agent loop, LLM clients, routing, interaction, memory, artifacts, trace) |
-| `@webskill/sdk/node` | Node host: NodeFS, script executors (in-process + sandboxed), file stores, skill manager, CLI UI bridge, env helpers |
-| `@webskill/sdk/browser` | Browser host: OPFS provider, Web Worker script sandbox, worker runtime host/client |
-| `@webskill/sdk/mcp` | MCP transports, endpoint registry, tool resolver, temporary skills, WebMCP adapter, runtime plugin |
-| `@webskill/sdk/ui` | Framework-agnostic forms, result rendering, mini markdown, Vercel/OpenUI/A2UI adapters, A2UI Lit runtime |
-| `@webskill/sdk/ui-react` | React bridge state + InteractionForm/ResultBlocks/StreamingText components |
-| `@webskill/sdk/ui-vue` | Vue bridge state + equivalent components |
-| `@webskill/sdk/governance` | Candidates, approval, audit, versioning, state policy, evaluation, scoring, documents |
+| Subpath                    | Contents                                                                                                             |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `@webskill/sdk`            | Core protocol + runtime engine (discovery, agent loop, LLM clients, routing, interaction, memory, artifacts, trace)  |
+| `@webskill/sdk/node`       | Node host: NodeFS, script executors (in-process + sandboxed), file stores, skill manager, CLI UI bridge, env helpers |
+| `@webskill/sdk/browser`    | Browser host: OPFS provider, Web Worker script sandbox, worker runtime host/client                                   |
+| `@webskill/sdk/mcp`        | MCP transports, endpoint registry, tool resolver, temporary skills, WebMCP adapter, runtime plugin                   |
+| `@webskill/sdk/ui`         | Framework-agnostic forms, result rendering, mini markdown, Vercel/OpenUI/A2UI adapters, A2UI Lit runtime             |
+| `@webskill/sdk/ui-react`   | React bridge state + InteractionForm/ResultBlocks/StreamingText components                                           |
+| `@webskill/sdk/ui-vue`     | Vue bridge state + equivalent components                                                                             |
+| `@webskill/sdk/governance` | Candidates, approval, audit, versioning, state policy, evaluation, scoring, documents                                |
 
 ## Requirements
 

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { C as InteractionRequest, M as LlmResponse, Mt as FileSystemProvider, N as LlmStreamEvent, S as InteractionPolicy, X as RenderResultRequest, _t as bridgeError, ct as ToolResult, d as BridgeResponse, it as ScriptExecutor, jt as FileStat, k as LlmClient, l as BridgeCapabilities, m as ExternalToolSource, ot as ToolDefinition, p as ExternalSkillProvider, pt as UiBridge, rt as ScriptExecutionContext, u as BridgeRequest, w as InteractionResponse, wt as parseBridgeRequest } from "./index-88KNOnbr.js";
+import { C as InteractionRequest, M as LlmResponse, Mt as FileStat, N as LlmStreamEvent, Nt as FileSystemProvider, S as InteractionPolicy, Tt as parseBridgeRequest, X as RenderResultRequest, at as ScriptExecutor, d as BridgeResponse, it as ScriptExecutionContext, k as LlmClient, l as BridgeCapabilities, lt as ToolResult, m as ExternalToolSource, mt as UiBridge, p as ExternalSkillProvider, st as ToolDefinition, u as BridgeRequest, vt as bridgeError, w as InteractionResponse } from "./index-j3Z3hbDk.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { D as normalizeToolContent, E as mergeCatalogEntries, I as SkillDiscovery, O as parseBridgeRequest, R as WebSkillError, f as MockLlmClient, h as ProgressiveRouter, i as AgentLoop, m as OpenAiCompatibleClient, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError, z as buildCatalog } from "./dist-B_ldNWwT.js";
+import { D as normalizeToolContent, E as mergeCatalogEntries, I as SkillDiscovery, O as parseBridgeRequest, R as WebSkillError, f as MockLlmClient, h as ProgressiveRouter, i as AgentLoop, m as OpenAiCompatibleClient, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError, z as buildCatalog } from "./dist-BbyIk4vG.js";
 
 //#region ../browser/dist/index.js
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */

package/dist/{dist-9fczg9Pa.js → dist-BMioPPri.js}

@@ -1,9 +1,10 @@
-import { D as normalizeToolContent, G as parseSkillMarkdown, H as isValidSkillName, J as resolveInsideRoot, O as parseBridgeRequest, R as WebSkillError, Y as validateSkills, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError } from "./dist-B_ldNWwT.js";
+import { D as normalizeToolContent, G as parseSkillMarkdown, H as isValidSkillName, J as resolveInsideRoot, O as parseBridgeRequest, R as WebSkillError, Y as validateSkills, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError } from "./dist-BbyIk4vG.js";
 import { existsSync, promises, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { format, promisify } from "node:util";
 import { Worker } from "node:worker_threads";
+import { parseSync } from "oxc-parser";
 import { createInterface } from "node:readline/promises";
 import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";
@@ -416,6 +417,178 @@ var SandboxedScriptExecutor = class {
 		}
 	}
 };
+const PLACEHOLDER_PREFIX = "Inferred placeholder (unsupported type: ";
+const placeholder = (text) => ({
+	type: "string",
+	description: `${PLACEHOLDER_PREFIX}${text})`,
+	"x-inferred": true
+});
+/** 主路径映射：基础类型/数组/嵌套对象/可选/字面量 union；其余降级 placeholder */
+var TypeMapper = class {
+	#decls = /* @__PURE__ */ new Map();
+	#source;
+	constructor(body, source) {
+		this.#source = source;
+		for (const node of body) {
+			if (node.type === "TSInterfaceDeclaration" || node.type === "TSTypeAliasDeclaration") this.#decls.set(node.id?.name, node);
+			if (node.type === "ExportNamedDeclaration" && (node.declaration?.type === "TSInterfaceDeclaration" || node.declaration?.type === "TSTypeAliasDeclaration")) this.#decls.set(node.declaration.id?.name, node.declaration);
+		}
+	}
+	objectSchema(t, seen) {
+		const mapped = this.map(t, seen);
+		return mapped?.type === "object" ? mapped : void 0;
+	}
+	map(t, seen) {
+		if (!t) return void 0;
+		switch (t.type) {
+			case "TSStringKeyword": return { type: "string" };
+			case "TSNumberKeyword": return { type: "number" };
+			case "TSBooleanKeyword": return { type: "boolean" };
+			case "TSAnyKeyword":
+			case "TSUnknownKeyword": return {};
+			case "TSArrayType": return {
+				type: "array",
+				items: this.map(t.elementType, seen) ?? {}
+			};
+			case "TSTypeLiteral": return this.#literalObject(t, seen);
+			case "TSLiteralType": return this.#literal(t);
+			case "TSUnionType": return this.#union(t, seen);
+			case "TSTypeReference": return this.#reference(t, seen);
+			case "TSParenthesizedType": return this.map(t.typeAnnotation, seen);
+			default: return placeholder(this.#text(t));
+		}
+	}
+	#literal(t) {
+		const value = t.literal?.value ?? t.value;
+		if (typeof value === "string") return {
+			type: "string",
+			enum: [value]
+		};
+		return placeholder(this.#text(t));
+	}
+	#union(t, seen) {
+		const values = [];
+		for (const member of t.types ?? []) {
+			const value = member.literal?.value ?? member.value;
+			if (member.type === "TSLiteralType" && typeof value === "string") values.push(value);
+			else return placeholder(this.#text(t));
+		}
+		return {
+			type: "string",
+			enum: values
+		};
+	}
+	#literalObject(t, seen) {
+		const properties = {};
+		const required = [];
+		for (const member of t.members ?? []) {
+			if (member.type !== "TSPropertySignature") continue;
+			const name = member.key?.name ?? member.key?.value;
+			if (typeof name !== "string") continue;
+			const annotation = member.typeAnnotation?.typeAnnotation;
+			properties[name] = annotation ? this.map(annotation, seen) ?? {} : { type: "string" };
+			if (!member.optional) required.push(name);
+		}
+		return {
+			type: "object",
+			properties,
+			...required.length ? { required } : {}
+		};
+	}
+	#reference(t, seen) {
+		const name = t.typeName?.name ?? t.typeName?.left?.name;
+		const params = t.typeArguments?.params ?? t.typeParameters?.params ?? [];
+		if (name === "Array" && params.length === 1) return {
+			type: "array",
+			items: this.map(params[0], seen) ?? {}
+		};
+		if (name === "string" || name === "number" || name === "boolean") return { type: name };
+		if (!name || params.length > 0) return placeholder(this.#text(t));
+		if (seen.has(name)) return placeholder(`recursive reference ${name}`);
+		const decl = this.#decls.get(name);
+		if (!decl) return placeholder(this.#text(t));
+		const nextSeen = new Set(seen).add(name);
+		if (decl.type === "TSInterfaceDeclaration") return this.#literalObject({ members: decl.body?.body ?? [] }, nextSeen);
+		return this.map(decl.typeAnnotation, nextSeen) ?? placeholder(this.#text(t));
+	}
+	#text(t) {
+		if (typeof t.start === "number" && typeof t.end === "number") return this.#source.slice(t.start, t.end);
+		return String(t.type);
+	}
+};
+const findRunFunction = (body) => {
+	for (const node of body) {
+		if (node.type !== "ExportNamedDeclaration") continue;
+		const decl = node.declaration;
+		if (!decl) continue;
+		if (decl.type === "FunctionDeclaration" && decl.id?.name === "run") return decl;
+		if (decl.type === "VariableDeclaration") {
+			for (const d of decl.declarations ?? []) if (d.id?.name === "run" && (d.init?.type === "ArrowFunctionExpression" || d.init?.type === "FunctionExpression")) return d.init;
+		}
+	}
+};
+/** JSDoc 辅路径：@param {type} input.name - desc（点形式）与 @param {{...}} input（对象形式） */
+function inferFromJsDoc(jsdoc, mapper, reparse) {
+	const properties = {};
+	const required = [];
+	const objectForm = /@param\s+\{\{([\s\S]+?)\}\}\s+input(?:\s+-\s+(.*))?/.exec(jsdoc);
+	if (objectForm) {
+		const alias = reparse(`{${objectForm[1]}}`);
+		if (!alias) return void 0;
+		const schema = mapper.map(alias, /* @__PURE__ */ new Set());
+		return schema?.type === "object" ? schema : void 0;
+	}
+	const dotForm = /@param\s+\{([^}]+)\}\s+input\.(\w+)(?:\s+-\s+([^\n*]+))?/g;
+	let matched = false;
+	for (const m of jsdoc.matchAll(dotForm)) {
+		const [, typeText, name, desc] = m;
+		if (!typeText || !name) continue;
+		matched = true;
+		const alias = reparse(typeText.trim());
+		const schema = alias ? mapper.map(alias, /* @__PURE__ */ new Set()) ?? {} : { type: "string" };
+		if (desc?.trim()) schema.description = desc.trim();
+		properties[name] = schema;
+		required.push(name);
+	}
+	if (!matched) return void 0;
+	return {
+		type: "object",
+		properties,
+		required
+	};
+}
+/**
+* D2 Schema 推导（OXC 静态文本分析，宿主侧执行，不进沙箱）。
+* TS 类型标注为主路径，JSDoc @param 为辅路径；不支持类型降级 string 并标 'x-inferred'。
+*/
+var OxcSchemaInferer = class {
+	inferSchemaFromSource(source, options) {
+		let program;
+		let comments;
+		try {
+			const result = parseSync(options?.fileName ?? "script.ts", source);
+			if (result.errors?.length > 0) return void 0;
+			program = result.program;
+			comments = result.comments ?? [];
+		} catch {
+			return;
+		}
+		const runFn = findRunFunction(program.body ?? []);
+		if (!runFn) return void 0;
+		const annotation = (runFn.params?.[0] ?? runFn.params?.items?.[0])?.typeAnnotation?.typeAnnotation;
+		const mapper = new TypeMapper(program.body ?? [], source);
+		if (annotation) return mapper.objectSchema(annotation, /* @__PURE__ */ new Set());
+		const runStart = runFn.start ?? Number.MAX_SAFE_INTEGER;
+		const jsdoc = comments.filter((c) => c.type === "Block" && typeof c.value === "string" && c.value.includes("@param") && typeof c.end === "number" && c.end <= runStart).sort((a, b) => b.end - a.end)[0];
+		if (!jsdoc) return void 0;
+		const reparse = (typeText) => {
+			const r = parseSync("__t.ts", `type __T = ${typeText};`);
+			if (r.errors?.length > 0) return void 0;
+			return r.program.body.find((n) => n.type === "TSTypeAliasDeclaration")?.typeAnnotation;
+		};
+		return inferFromJsDoc(jsdoc.value, mapper, reparse);
+	}
+};
 /**
 * FileArtifactStore：兼容别名，语义同阶段 2-4。
 * 实现已上移到 runtime 的 FsArtifactStore；node 侧保留 NodeFS 默认值。
@@ -920,10 +1093,13 @@ var SkillManager = class {
 	#managedRoot;
 	#fs;
 	#fetchImpl;
+	#schemaInference;
+	#schemaInferer = new OxcSchemaInferer();
 	constructor(deps) {
 		this.#managedRoot = deps.managedRoot.replace(/\/+$/, "");
 		this.#fs = deps.fs ?? new NodeFS();
 		this.#fetchImpl = deps.fetchImpl;
+		this.#schemaInference = deps.schemaInference ?? true;
 	}
 	async install(source, options) {
 		const fs = this.#fs;
@@ -971,6 +1147,7 @@ var SkillManager = class {
 			targetDir = `${this.#managedRoot}/${name}`;
 			if (await fs.exists(targetDir)) await fs.remove(targetDir, { recursive: true });
 			await copyDir(fs, finalDir, targetDir);
+			await this.#inferSkillSchemas(targetDir);
 			const manifest = await createManifest(fs, targetDir, {
 				name,
 				...version ? { version } : {},
@@ -990,6 +1167,28 @@ var SkillManager = class {
 			await removeDirQuiet(fs, stagingRoot);
 		}
 	}
+	/**
+	* D2 安装期预推导：scripts/ 下无显式 inputSchema 导出且无 sidecar 的脚本，
+	* 经 OXC 推导写 sidecar（计入 manifest.files；重装重新生成）
+	*/
+	async #inferSkillSchemas(skillRoot) {
+		if (!this.#schemaInference) return;
+		const fs = this.#fs;
+		const scriptsDir = `${skillRoot}/scripts`;
+		if (!await fs.exists(scriptsDir)) return;
+		for (const entry of await fs.list(scriptsDir)) {
+			if (entry.type !== "file") continue;
+			const match = /^(.*)\.(ts|js)$/.exec(entry.path.split("/").pop() ?? "");
+			if (!match?.[1]) continue;
+			const scriptName = match[1];
+			const sidecar = `${scriptsDir}/${scriptName}.schema.json`;
+			if (await fs.exists(sidecar)) continue;
+			const source = await fs.readText(entry.path);
+			if (/export\s+(?:const|let|var)\s+inputSchema/.test(source)) continue;
+			const inferred = this.#schemaInferer.inferSchemaFromSource(source, { fileName: `${scriptName}.${match[2]}` });
+			if (inferred) await fs.writeText(sidecar, JSON.stringify(inferred, null, 2));
+		}
+	}
 	async uninstall(name) {
 		if (!isValidSkillName(name)) throw new WebSkillError("UNINSTALL_FAILED", `Invalid skill name (path traversal rejected): ${JSON.stringify(name)}`);
 		const targetDir = `${this.#managedRoot}/${name}`;
@@ -1099,7 +1298,8 @@ async function doProbeLlmCapabilities(config) {
 			}),
 			signal: AbortSignal.timeout(15e3)
 		});
-		if (res.ok) return {
+		const contentType = res.headers.get("content-type") ?? "";
+		if (res.ok && !contentType.includes("text/event-stream")) return {
 			available: true,
 			nonStreaming: true
 		};
@@ -1119,4 +1319,4 @@ async function doProbeLlmCapabilities(config) {
 }
 
 //#endregion
-export { NodeScriptExecutor as a, SandboxedScriptExecutor as c, probeLlmCapabilities as d, readArchiveManifest as f, NodeFS as i, SkillManager as l, FileArtifactStore as n, SKILLS_LOCKFILE as o, FileMemoryStore as r, SKILL_MANIFEST_FILE as s, CliUiBridge as t, loadLlmConfigFromEnv as u };
+export { NodeScriptExecutor as a, SKILL_MANIFEST_FILE as c, loadLlmConfigFromEnv as d, probeLlmCapabilities as f, NodeFS as i, SandboxedScriptExecutor as l, FileArtifactStore as n, OxcSchemaInferer as o, readArchiveManifest as p, FileMemoryStore as r, SKILLS_LOCKFILE as s, CliUiBridge as t, SkillManager as u };

package/dist/{dist-B_ldNWwT.js → dist-BbyIk4vG.js}

@@ -182,6 +182,8 @@ function isValidSkillName(name) {
 	return name.length <= 64 && SKILL_NAME_PATTERN.test(name);
 }
 const SCRIPT_EXTENSION_RE = /\.(ts|js)$/;
+/** D2 schema sidecar（scripts/<name>.schema.json）属于协议内文件，不算非法脚本 */
+const SCHEMA_SIDECAR_RE = /\.schema\.json$/;
 /**
 * 技能合规规则的唯一实现。SkillDiscovery 与 validateSkills 都必须调用本函数，
 * 禁止各自重复实现规则（避免两套规则漂移）。
@@ -217,10 +219,10 @@ function checkSkillRules(input) {
 			message: `Duplicate skill name ${JSON.stringify(metadata.name)}`
 		});
 	}
-	for (const fileName of input.scriptFileNames ?? []) if (!SCRIPT_EXTENSION_RE.test(fileName)) issues.push({
+	for (const fileName of input.scriptFileNames ?? []) if (!SCRIPT_EXTENSION_RE.test(fileName) && !SCHEMA_SIDECAR_RE.test(fileName)) issues.push({
 		code: "SKILL_UNSUPPORTED_SCRIPT",
 		severity: "error",
-		message: `Unsupported script file in scripts/ of directory ${dirName}: ${fileName} (only .ts/.js allowed)`
+		message: `Unsupported script file in scripts/ of directory ${dirName}: ${fileName} (only .ts/.js and .schema.json sidecars allowed)`
 	});
 	return issues;
 }
@@ -1329,7 +1331,10 @@ var AgentLoop = class {
 	#config;
 	#policy;
 	constructor(deps, config = {}) {
-		this.#deps = deps;
+		this.#deps = {
+			...deps,
+			artifactStore: deps.artifactStore ?? new MemoryArtifactStore()
+		};
 		this.#config = {
 			maxTurns: config.maxTurns ?? 10,
 			totalTimeoutMs: config.totalTimeoutMs ?? 12e4,
@@ -1344,7 +1349,8 @@ var AgentLoop = class {
 		};
 	}
 	async run(input) {
-		const { llm, artifactStore } = this.#deps;
+		const llm = this.#deps.llm;
+		const artifactStore = this.#deps.artifactStore;
 		const now = this.#deps.clock?.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
 		const runId = input.runId ?? `run-${Math.random().toString(36).slice(2, 10)}`;
 		const trace = new TraceRecorder(runId, this.#deps.clock);
@@ -1734,6 +1740,8 @@ var AgentLoop = class {
 		await this.#writeActivationMemory(skillName, state);
 		const root = this.#deps.skillIndex.get(skillName);
 		if (!root) return "";
+		const executor = this.#deps.executor;
+		if (!executor) return "";
 		const loaded = [];
 		let scriptFiles = [];
 		try {
@@ -1745,13 +1753,36 @@ var AgentLoop = class {
 			const match = /^(.*)\.(ts|js)$/.exec(file);
 			if (!match?.[1]) continue;
 			try {
-				const def = await this.#deps.executor.loadDefinition(root, match[1]);
+				const def = await executor.loadDefinition(root, match[1]);
+				await this.#enrichDefinition(root, match[1], def, state);
 				state.activatedTools.set(def.name, def);
 				loaded.push(def.name);
 			} catch {}
 		}
 		return loaded.length ? `\n\nActivated tools: ${loaded.join(", ")}` : "";
 	}
+	/**
+	* D2 Schema 兜底链（同一 run 内激活时只算一次）：
+	* 显式 inputSchema > sidecar scripts/<name>.schema.json > schemaInferer 推导 > schemaUnavailable
+	*/
+	async #enrichDefinition(skillRoot, scriptName, def, state) {
+		if (def.inputSchema) return;
+		const sidecar = `${skillRoot}/scripts/${scriptName}.schema.json`;
+		if (await this.#deps.fs.exists(sidecar)) try {
+			def.inputSchema = JSON.parse(await this.#deps.fs.readText(sidecar));
+			return;
+		} catch (e) {
+			state.trace.record("run.warning", { message: `Failed to parse schema sidecar ${sidecar}: ${messageOf(e)}` });
+		}
+		if (!this.#deps.schemaInferer) return;
+		for (const ext of ["ts", "js"]) {
+			const scriptPath = `${skillRoot}/scripts/${scriptName}.${ext}`;
+			if (!await this.#deps.fs.exists(scriptPath)) continue;
+			const inferred = this.#deps.schemaInferer.inferSchemaFromSource(await this.#deps.fs.readText(scriptPath), { fileName: `${scriptName}.${ext}` });
+			if (inferred) def.inputSchema = inferred;
+			return;
+		}
+	}
 	async #handleScriptTool(call, skillName, scriptName, state) {
 		const root = this.#deps.skillIndex.get(skillName);
 		if (!root) return toolError("TOOL_NOT_FOUND", `Skill "${skillName}" is not in the catalog`);
@@ -1776,6 +1807,7 @@ var AgentLoop = class {
 			if (e instanceof BridgeRequestError) return toolError("UI_UNAVAILABLE", `Parameter form failed: ${e.message}`);
 			throw e;
 		}
+		if (!this.#deps.executor) return toolError("TOOL_UNSUPPORTED", `No script executor is configured; script tool "${call.name}" cannot run`);
 		const context = createScriptContext({
 			fs: this.#deps.fs,
 			artifactStore: this.#deps.artifactStore,
@@ -1937,6 +1969,7 @@ var WebSkillRuntime = class {
 		const result = await new AgentLoop({
 			llm: this.#deps.llm,
 			executor: this.#deps.executor,
+			schemaInferer: this.#deps.schemaInferer,
 			artifactStore: this.#deps.artifactStore,
 			fs: this.#deps.fs,
 			skillIndex: cache.index,

package/dist/governance.d.ts

@@ -1,5 +1,5 @@
-import { Mt as FileSystemProvider, Rt as SkillCatalogEntry, ht as WebSkillRuntime, j as LlmMessage, k as LlmClient, pt as UiBridge, tt as RuntimeRun } from "./index-88KNOnbr.js";
-import { f as SkillManager, p as SkillManifest } from "./index-Bq-bTWh3.js";
+import { Nt as FileSystemProvider, gt as WebSkillRuntime, j as LlmMessage, k as LlmClient, mt as UiBridge, tt as RuntimeRun, zt as SkillCatalogEntry } from "./index-j3Z3hbDk.js";
+import { m as SkillManifest, p as SkillManager } from "./index-DF5ea732.js";
 //#region ../governance/dist/index.d.ts
 //#region src/types.d.ts
 type CandidateStatus = 'draft' | 'pending-review' | 'approved' | 'published' | 'rejected';

package/dist/governance.js

@@ -1,5 +1,5 @@
-import { H as isValidSkillName, J as resolveInsideRoot, R as WebSkillError, Y as validateSkills } from "./dist-B_ldNWwT.js";
-import { i as NodeFS } from "./dist-9fczg9Pa.js";
+import { H as isValidSkillName, J as resolveInsideRoot, R as WebSkillError, Y as validateSkills } from "./dist-BbyIk4vG.js";
+import { i as NodeFS } from "./dist-BMioPPri.js";
 import path from "node:path";
 import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";

package/dist/{index-Bq-bTWh3.d.ts → index-DF5ea732.d.ts}

@@ -1,4 +1,4 @@
-import { C as InteractionRequest, Mt as FileSystemProvider, X as RenderResultRequest, _ as FsMemoryStore, ct as ToolResult, g as FsArtifactStore, it as ScriptExecutor, jt as FileStat, l as BridgeCapabilities, ot as ToolDefinition, pt as UiBridge, rt as ScriptExecutionContext, w as InteractionResponse } from "./index-88KNOnbr.js";
+import { C as InteractionRequest, Mt as FileStat, Nt as FileSystemProvider, Pt as JsonSchema, X as RenderResultRequest, _ as FsMemoryStore, at as ScriptExecutor, g as FsArtifactStore, it as ScriptExecutionContext, l as BridgeCapabilities, lt as ToolResult, mt as UiBridge, rt as SchemaInferer, st as ToolDefinition, w as InteractionResponse } from "./index-j3Z3hbDk.js";
 import { Readable, Writable } from "node:stream";
 //#region ../node/dist/index.d.ts
 //#region src/fs/nodeFs.d.ts
@@ -67,6 +67,17 @@ declare class SandboxedScriptExecutor implements ScriptExecutor {
   }): Promise<ToolResult>;
 }
 //#endregion
+//#region src/schema/oxcSchemaInferer.d.ts
+/**
+ * D2 Schema 推导（OXC 静态文本分析，宿主侧执行，不进沙箱）。
+ * TS 类型标注为主路径，JSDoc @param 为辅路径；不支持类型降级 string 并标 'x-inferred'。
+ */
+declare class OxcSchemaInferer implements SchemaInferer {
+  inferSchemaFromSource(source: string, options?: {
+    fileName?: string;
+  }): JsonSchema | undefined;
+}
+//#endregion
 //#region src/artifacts/fileArtifactStore.d.ts
 /**
  * FileArtifactStore：兼容别名，语义同阶段 2-4。
@@ -173,6 +184,8 @@ declare class SkillManager {
     managedRoot: string;
     fs?: FileSystemProvider;
     fetchImpl?: typeof fetch;
+    /** D2 安装期 schema 预推导（默认 true，可关） */
+    schemaInference?: boolean;
   });
   install(source: SkillSource, options?: {
     expectedSha256?: string;
@@ -216,4 +229,4 @@ interface LlmCapabilities {
  */
 declare function probeLlmCapabilities(config: LlmEnvConfig): Promise<LlmCapabilities>;
 //#endregion
-export { loadLlmConfigFromEnv as _, LlmEnvConfig as a, SKILLS_LOCKFILE as c, SandboxedScriptExecutor as d, SkillManager as f, VerifyResult as g, SkillsLockfile as h, LlmCapabilities as i, SKILL_MANIFEST_FILE as l, SkillSource as m, FileArtifactStore as n, NodeFS as o, SkillManifest as p, FileMemoryStore as r, NodeScriptExecutor as s, CliUiBridge as t, SandboxOptions as u, probeLlmCapabilities as v, readArchiveManifest as y };
+export { VerifyResult as _, LlmEnvConfig as a, readArchiveManifest as b, OxcSchemaInferer as c, SandboxOptions as d, SandboxedScriptExecutor as f, SkillsLockfile as g, SkillSource as h, LlmCapabilities as i, SKILLS_LOCKFILE as l, SkillManifest as m, FileArtifactStore as n, NodeFS as o, SkillManager as p, FileMemoryStore as r, NodeScriptExecutor as s, CliUiBridge as t, SKILL_MANIFEST_FILE as u, loadLlmConfigFromEnv as v, probeLlmCapabilities as y };

package/dist/{index-88KNOnbr.d.ts → index-j3Z3hbDk.d.ts}

@@ -403,6 +403,12 @@ interface ScriptExecutionContext {
   /** 脚本主动请求人在环确认；策略见 InteractionPolicy.confirmations */
   confirm?(message: string): Promise<boolean>;
 }
+/** Schema 推导 port：纯文本静态分析脚本源码 → JSON Schema（best-effort） */
+interface SchemaInferer {
+  inferSchemaFromSource(source: string, options?: {
+    fileName?: string;
+  }): JsonSchema | undefined;
+}
 interface ScriptExecutor {
   loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
   execute(input: {
@@ -867,8 +873,12 @@ declare function mergeCatalogEntries(localEntries: SkillCatalogEntry[], provider
 //#region src/engine/agentLoop.d.ts
 interface AgentLoopDeps {
   llm: LlmClient;
-  executor: ScriptExecutor;
-  artifactStore: ArtifactStore;
+  /** 可选：无 executor 时激活技能照常但不注册脚本工具（调用回喂 TOOL_UNSUPPORTED） */
+  executor?: ScriptExecutor;
+  /** D2 Schema 推导 port（inputSchema 为空且 sidecar 缺失时的兜底） */
+  schemaInferer?: SchemaInferer;
+  /** 缺省 MemoryArtifactStore */
+  artifactStore?: ArtifactStore;
   fs: FileSystemProvider;
   /** name → skillRoot（来自发现结果） */
   skillIndex: Map<string, string>;
@@ -915,8 +925,12 @@ interface WebSkillRuntimeDeps {
   llm: LlmClient;
   /** 缺省 ProgressiveRouter */
   router?: SkillRouter;
-  executor: ScriptExecutor;
-  artifactStore: ArtifactStore;
+  /** 可选：缺省无脚本执行能力（脚本调用回喂 TOOL_UNSUPPORTED） */
+  executor?: ScriptExecutor;
+  /** D2 Schema 推导 port（node 侧 OxcSchemaInferer；浏览器经 sidecar 获取） */
+  schemaInferer?: SchemaInferer;
+  /** 缺省 MemoryArtifactStore */
+  artifactStore?: ArtifactStore;
   config?: AgentLoopConfig;
   model?: string;
   uiBridge?: UiBridge;
@@ -952,4 +966,4 @@ declare class WebSkillRuntime {
   run(userPrompt: string): Promise<RunResult>;
 }
 //#endregion
-export { RunTerminationReason as $, jsonRenderer as $t, LlmCompleteInput as A, DiscoveryResult as At, MockLlmQueueItem as B, SkillDocument as Bt, InteractionRequest as C, normalizeToolContent as Ct, LifecycleHookContext as D, toLlmToolSpec as Dt, LifecycleHook as E, schemaToForm as Et, LlmToolSpec as F, SKILL_NAME_MAX_LENGTH as Ft, ProgressiveRouter as G, SkillSource as Gt, MockUiBridge as H, SkillLocation as Ht, MemoryArtifactStore as I, SKILL_NAME_PATTERN as It, READ_SKILL_FILE_TOOL_NAME as J, WebSkillErrorCode as Jt, READ_SKILL_FILE_INPUT_SCHEMA as K, ValidationReport as Kt, MemoryStore as L, SkillCatalog as Lt, LlmResponse as M, FileSystemProvider as Mt, LlmStreamEvent as N, JsonSchema as Nt, LifecycleListener as O, toVercelToolSpecs as Ot, LlmToolCall as P, MemoryFS as Pt, RunResult as Q, isValidSkillName as Qt, MockLlmClient as R, SkillCatalogEntry as Rt, InteractionPolicy as S, mergeCatalogEntries as St, LifecycleEvent as T, resolveToolName as Tt, OpenAiCompatibleClient as U, SkillMetadata as Ut, MockUiAnswer as V, SkillIssue as Vt, OpenAiCompatibleClientConfig as W, SkillReader as Wt, RenderResultRequest as X, checkSkillRules as Xt, RenderBlock as Y, buildCatalog as Yt, RouteResult as Z, escapeXml as Zt, FsMemoryStore as _, bridgeError as _t, AgentLoopConfig as a, validateSkills as an, SkillRouter as at, HookRunnerOptions as b, fromVercelResult as bt, ArtifactStore as c, ToolResult as ct, BridgeResponse as d, TraceEventType as dt, normalizePath as en, RuntimePhase as et, EventBus as f, TraceRecorder as ft, FsArtifactStore as g, WebSkillRuntimeDeps as gt, FormField as h, WebSkillRuntime as ht, AgentLoop as i, resolveInsideRoot as in, ScriptExecutor as it, LlmMessage as j, FileStat as jt, LlmClient as k, CatalogRenderer as kt, BridgeCapabilities as l, TraceClock as lt, ExternalToolSource as m, VercelToolSpec as mt, ASK_USER_TOOL as n, renderAvailableSkillsXml as nn, RuntimeSession as nt, AgentLoopDeps as o, xmlRenderer as on, ToolDefinition as ot, ExternalSkillProvider as p, UiBridge as pt, READ_SKILL_FILE_TOOL as q, WebSkillError as qt, ASK_USER_TOOL_NAME as r, renderCatalogJson as rn, ScriptExecutionContext as rt, Artifact as s, ToolResolution as st, ASK_USER_INPUT_SCHEMA as t, parseSkillMarkdown as tn, RuntimeRun as tt, BridgeRequest as u, TraceEvent as ut, FullDisclosureRouter as v, buildRenderResult as vt, InteractionResponse as w, parseBridgeRequest as wt, InMemoryStore as x, fromVercelStreamPart as xt, HookRunner as y, createScriptContext as yt, MockLlmHandler as z, SkillDiscovery as zt };
+export { RunTerminationReason as $, isValidSkillName as $t, LlmCompleteInput as A, CatalogRenderer as At, MockLlmQueueItem as B, SkillDiscovery as Bt, InteractionRequest as C, mergeCatalogEntries as Ct, LifecycleHookContext as D, schemaToForm as Dt, LifecycleHook as E, resolveToolName as Et, LlmToolSpec as F, MemoryFS as Ft, ProgressiveRouter as G, SkillReader as Gt, MockUiBridge as H, SkillIssue as Ht, MemoryArtifactStore as I, SKILL_NAME_MAX_LENGTH as It, READ_SKILL_FILE_TOOL_NAME as J, WebSkillError as Jt, READ_SKILL_FILE_INPUT_SCHEMA as K, SkillSource as Kt, MemoryStore as L, SKILL_NAME_PATTERN as Lt, LlmResponse as M, FileStat as Mt, LlmStreamEvent as N, FileSystemProvider as Nt, LifecycleListener as O, toLlmToolSpec as Ot, LlmToolCall as P, JsonSchema as Pt, RunResult as Q, escapeXml as Qt, MockLlmClient as R, SkillCatalog as Rt, InteractionPolicy as S, fromVercelStreamPart as St, LifecycleEvent as T, parseBridgeRequest as Tt, OpenAiCompatibleClient as U, SkillLocation as Ut, MockUiAnswer as V, SkillDocument as Vt, OpenAiCompatibleClientConfig as W, SkillMetadata as Wt, RenderResultRequest as X, buildCatalog as Xt, RenderBlock as Y, WebSkillErrorCode as Yt, RouteResult as Z, checkSkillRules as Zt, FsMemoryStore as _, WebSkillRuntimeDeps as _t, AgentLoopConfig as a, resolveInsideRoot as an, ScriptExecutor as at, HookRunnerOptions as b, createScriptContext as bt, ArtifactStore as c, ToolResolution as ct, BridgeResponse as d, TraceEvent as dt, jsonRenderer as en, RuntimePhase as et, EventBus as f, TraceEventType as ft, FsArtifactStore as g, WebSkillRuntime as gt, FormField as h, VercelToolSpec as ht, AgentLoop as i, renderCatalogJson as in, ScriptExecutionContext as it, LlmMessage as j, DiscoveryResult as jt, LlmClient as k, toVercelToolSpecs as kt, BridgeCapabilities as l, ToolResult as lt, ExternalToolSource as m, UiBridge as mt, ASK_USER_TOOL as n, parseSkillMarkdown as nn, RuntimeSession as nt, AgentLoopDeps as o, validateSkills as on, SkillRouter as ot, ExternalSkillProvider as p, TraceRecorder as pt, READ_SKILL_FILE_TOOL as q, ValidationReport as qt, ASK_USER_TOOL_NAME as r, renderAvailableSkillsXml as rn, SchemaInferer as rt, Artifact as s, xmlRenderer as sn, ToolDefinition as st, ASK_USER_INPUT_SCHEMA as t, normalizePath as tn, RuntimeRun as tt, BridgeRequest as u, TraceClock as ut, FullDisclosureRouter as v, bridgeError as vt, InteractionResponse as w, normalizeToolContent as wt, InMemoryStore as x, fromVercelResult as xt, HookRunner as y, buildRenderResult as yt, MockLlmHandler as z, SkillCatalogEntry as zt };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as RunTerminationReason, $t as jsonRenderer, A as LlmCompleteInput, At as DiscoveryResult, B as MockLlmQueueItem, Bt as SkillDocument, C as InteractionRequest, Ct as normalizeToolContent, D as LifecycleHookContext, Dt as toLlmToolSpec, E as LifecycleHook, Et as schemaToForm, F as LlmToolSpec, Ft as SKILL_NAME_MAX_LENGTH, G as ProgressiveRouter, Gt as SkillSource, H as MockUiBridge, Ht as SkillLocation, I as MemoryArtifactStore, It as SKILL_NAME_PATTERN, J as READ_SKILL_FILE_TOOL_NAME, Jt as WebSkillErrorCode, K as READ_SKILL_FILE_INPUT_SCHEMA, Kt as ValidationReport, L as MemoryStore, Lt as SkillCatalog, M as LlmResponse, Mt as FileSystemProvider, N as LlmStreamEvent, Nt as JsonSchema, O as LifecycleListener, Ot as toVercelToolSpecs, P as LlmToolCall, Pt as MemoryFS, Q as RunResult, Qt as isValidSkillName, R as MockLlmClient, Rt as SkillCatalogEntry, S as InteractionPolicy, St as mergeCatalogEntries, T as LifecycleEvent, Tt as resolveToolName, U as OpenAiCompatibleClient, Ut as SkillMetadata, V as MockUiAnswer, Vt as SkillIssue, W as OpenAiCompatibleClientConfig, Wt as SkillReader, X as RenderResultRequest, Xt as checkSkillRules, Y as RenderBlock, Yt as buildCatalog, Z as RouteResult, Zt as escapeXml, _ as FsMemoryStore, _t as bridgeError, a as AgentLoopConfig, an as validateSkills, at as SkillRouter, b as HookRunnerOptions, bt as fromVercelResult, c as ArtifactStore, ct as ToolResult, d as BridgeResponse, dt as TraceEventType, en as normalizePath, et as RuntimePhase, f as EventBus, ft as TraceRecorder, g as FsArtifactStore, gt as WebSkillRuntimeDeps, h as FormField, ht as WebSkillRuntime, i as AgentLoop, in as resolveInsideRoot, it as ScriptExecutor, j as LlmMessage, jt as FileStat, k as LlmClient, kt as CatalogRenderer, l as BridgeCapabilities, lt as TraceClock, m as ExternalToolSource, mt as VercelToolSpec, n as ASK_USER_TOOL, nn as renderAvailableSkillsXml, nt as RuntimeSession, o as AgentLoopDeps, on as xmlRenderer, ot as ToolDefinition, p as ExternalSkillProvider, pt as UiBridge, q as READ_SKILL_FILE_TOOL, qt as WebSkillError, r as ASK_USER_TOOL_NAME, rn as renderCatalogJson, rt as ScriptExecutionContext, s as Artifact, st as ToolResolution, t as ASK_USER_INPUT_SCHEMA, tn as parseSkillMarkdown, tt as RuntimeRun, u as BridgeRequest, ut as TraceEvent, v as FullDisclosureRouter, vt as buildRenderResult, w as InteractionResponse, wt as parseBridgeRequest, x as InMemoryStore, xt as fromVercelStreamPart, y as HookRunner, yt as createScriptContext, z as MockLlmHandler, zt as SkillDiscovery } from "./index-88KNOnbr.js";
-export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, type AgentLoopConfig, type AgentLoopDeps, type Artifact, type ArtifactStore, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type CatalogRenderer, type DiscoveryResult, EventBus, type ExternalSkillProvider, type ExternalToolSource, type FileStat, type FileSystemProvider, type FormField, FsArtifactStore, FsMemoryStore, FullDisclosureRouter, HookRunner, type HookRunnerOptions, InMemoryStore, type InteractionPolicy, type InteractionRequest, type InteractionResponse, type JsonSchema, type LifecycleEvent, type LifecycleHook, type LifecycleHookContext, type LifecycleListener, type LlmClient, type LlmCompleteInput, type LlmMessage, type LlmResponse, type LlmStreamEvent, type LlmToolCall, type LlmToolSpec, MemoryArtifactStore, MemoryFS, type MemoryStore, MockLlmClient, type MockLlmHandler, type MockLlmQueueItem, type MockUiAnswer, MockUiBridge, OpenAiCompatibleClient, type OpenAiCompatibleClientConfig, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, type RenderBlock, type RenderResultRequest, type RouteResult, type RunResult, type RunTerminationReason, type RuntimePhase, type RuntimeRun, type RuntimeSession, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, type ScriptExecutionContext, type ScriptExecutor, type SkillCatalog, type SkillCatalogEntry, SkillDiscovery, type SkillDocument, type SkillIssue, type SkillLocation, type SkillMetadata, SkillReader, type SkillRouter, type SkillSource, type ToolDefinition, type ToolResolution, type ToolResult, type TraceClock, type TraceEvent, type TraceEventType, TraceRecorder, type UiBridge, type ValidationReport, type VercelToolSpec, WebSkillError, type WebSkillErrorCode, WebSkillRuntime, type WebSkillRuntimeDeps, bridgeError, buildCatalog, buildRenderResult, checkSkillRules, createScriptContext, escapeXml, fromVercelResult, fromVercelStreamPart, isValidSkillName, jsonRenderer, mergeCatalogEntries, normalizePath, normalizeToolContent, parseBridgeRequest, parseSkillMarkdown, renderAvailableSkillsXml, renderCatalogJson, resolveInsideRoot, resolveToolName, schemaToForm, toLlmToolSpec, toVercelToolSpecs, validateSkills, xmlRenderer };
+import { $ as RunTerminationReason, $t as isValidSkillName, A as LlmCompleteInput, At as CatalogRenderer, B as MockLlmQueueItem, Bt as SkillDiscovery, C as InteractionRequest, Ct as mergeCatalogEntries, D as LifecycleHookContext, Dt as schemaToForm, E as LifecycleHook, Et as resolveToolName, F as LlmToolSpec, Ft as MemoryFS, G as ProgressiveRouter, Gt as SkillReader, H as MockUiBridge, Ht as SkillIssue, I as MemoryArtifactStore, It as SKILL_NAME_MAX_LENGTH, J as READ_SKILL_FILE_TOOL_NAME, Jt as WebSkillError, K as READ_SKILL_FILE_INPUT_SCHEMA, Kt as SkillSource, L as MemoryStore, Lt as SKILL_NAME_PATTERN, M as LlmResponse, Mt as FileStat, N as LlmStreamEvent, Nt as FileSystemProvider, O as LifecycleListener, Ot as toLlmToolSpec, P as LlmToolCall, Pt as JsonSchema, Q as RunResult, Qt as escapeXml, R as MockLlmClient, Rt as SkillCatalog, S as InteractionPolicy, St as fromVercelStreamPart, T as LifecycleEvent, Tt as parseBridgeRequest, U as OpenAiCompatibleClient, Ut as SkillLocation, V as MockUiAnswer, Vt as SkillDocument, W as OpenAiCompatibleClientConfig, Wt as SkillMetadata, X as RenderResultRequest, Xt as buildCatalog, Y as RenderBlock, Yt as WebSkillErrorCode, Z as RouteResult, Zt as checkSkillRules, _ as FsMemoryStore, _t as WebSkillRuntimeDeps, a as AgentLoopConfig, an as resolveInsideRoot, at as ScriptExecutor, b as HookRunnerOptions, bt as createScriptContext, c as ArtifactStore, ct as ToolResolution, d as BridgeResponse, dt as TraceEvent, en as jsonRenderer, et as RuntimePhase, f as EventBus, ft as TraceEventType, g as FsArtifactStore, gt as WebSkillRuntime, h as FormField, ht as VercelToolSpec, i as AgentLoop, in as renderCatalogJson, it as ScriptExecutionContext, j as LlmMessage, jt as DiscoveryResult, k as LlmClient, kt as toVercelToolSpecs, l as BridgeCapabilities, lt as ToolResult, m as ExternalToolSource, mt as UiBridge, n as ASK_USER_TOOL, nn as parseSkillMarkdown, nt as RuntimeSession, o as AgentLoopDeps, on as validateSkills, ot as SkillRouter, p as ExternalSkillProvider, pt as TraceRecorder, q as READ_SKILL_FILE_TOOL, qt as ValidationReport, r as ASK_USER_TOOL_NAME, rn as renderAvailableSkillsXml, rt as SchemaInferer, s as Artifact, sn as xmlRenderer, st as ToolDefinition, t as ASK_USER_INPUT_SCHEMA, tn as normalizePath, tt as RuntimeRun, u as BridgeRequest, ut as TraceClock, v as FullDisclosureRouter, vt as bridgeError, w as InteractionResponse, wt as normalizeToolContent, x as InMemoryStore, xt as fromVercelResult, y as HookRunner, yt as buildRenderResult, z as MockLlmHandler, zt as SkillCatalogEntry } from "./index-j3Z3hbDk.js";
+export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, type AgentLoopConfig, type AgentLoopDeps, type Artifact, type ArtifactStore, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type CatalogRenderer, type DiscoveryResult, EventBus, type ExternalSkillProvider, type ExternalToolSource, type FileStat, type FileSystemProvider, type FormField, FsArtifactStore, FsMemoryStore, FullDisclosureRouter, HookRunner, type HookRunnerOptions, InMemoryStore, type InteractionPolicy, type InteractionRequest, type InteractionResponse, type JsonSchema, type LifecycleEvent, type LifecycleHook, type LifecycleHookContext, type LifecycleListener, type LlmClient, type LlmCompleteInput, type LlmMessage, type LlmResponse, type LlmStreamEvent, type LlmToolCall, type LlmToolSpec, MemoryArtifactStore, MemoryFS, type MemoryStore, MockLlmClient, type MockLlmHandler, type MockLlmQueueItem, type MockUiAnswer, MockUiBridge, OpenAiCompatibleClient, type OpenAiCompatibleClientConfig, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, type RenderBlock, type RenderResultRequest, type RouteResult, type RunResult, type RunTerminationReason, type RuntimePhase, type RuntimeRun, type RuntimeSession, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, type SchemaInferer, type ScriptExecutionContext, type ScriptExecutor, type SkillCatalog, type SkillCatalogEntry, SkillDiscovery, type SkillDocument, type SkillIssue, type SkillLocation, type SkillMetadata, SkillReader, type SkillRouter, type SkillSource, type ToolDefinition, type ToolResolution, type ToolResult, type TraceClock, type TraceEvent, type TraceEventType, TraceRecorder, type UiBridge, type ValidationReport, type VercelToolSpec, WebSkillError, type WebSkillErrorCode, WebSkillRuntime, type WebSkillRuntimeDeps, bridgeError, buildCatalog, buildRenderResult, checkSkillRules, createScriptContext, escapeXml, fromVercelResult, fromVercelStreamPart, isValidSkillName, jsonRenderer, mergeCatalogEntries, normalizePath, normalizeToolContent, parseBridgeRequest, parseSkillMarkdown, renderAvailableSkillsXml, renderCatalogJson, resolveInsideRoot, resolveToolName, schemaToForm, toLlmToolSpec, toVercelToolSpecs, validateSkills, xmlRenderer };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { A as schemaToForm, B as checkSkillRules, C as createScriptContext, D as normalizeToolContent, E as mergeCatalogEntries, F as SKILL_NAME_PATTERN, G as parseSkillMarkdown, H as isValidSkillName, I as SkillDiscovery, J as resolveInsideRoot, K as renderAvailableSkillsXml, L as SkillReader, M as toVercelToolSpecs, N as MemoryFS, O as parseBridgeRequest, P as SKILL_NAME_MAX_LENGTH, R as WebSkillError, S as buildRenderResult, T as fromVercelStreamPart, U as jsonRenderer, V as escapeXml, W as normalizePath, X as xmlRenderer, Y as validateSkills, _ as READ_SKILL_FILE_TOOL, a as EventBus, b as WebSkillRuntime, c as FullDisclosureRouter, d as MemoryArtifactStore, f as MockLlmClient, g as READ_SKILL_FILE_INPUT_SCHEMA, h as ProgressiveRouter, i as AgentLoop, j as toLlmToolSpec, k as resolveToolName, l as HookRunner, m as OpenAiCompatibleClient, n as ASK_USER_TOOL, o as FsArtifactStore, p as MockUiBridge, q as renderCatalogJson, r as ASK_USER_TOOL_NAME, s as FsMemoryStore, t as ASK_USER_INPUT_SCHEMA, u as InMemoryStore, v as READ_SKILL_FILE_TOOL_NAME, w as fromVercelResult, x as bridgeError, y as TraceRecorder, z as buildCatalog } from "./dist-B_ldNWwT.js";
+import { A as schemaToForm, B as checkSkillRules, C as createScriptContext, D as normalizeToolContent, E as mergeCatalogEntries, F as SKILL_NAME_PATTERN, G as parseSkillMarkdown, H as isValidSkillName, I as SkillDiscovery, J as resolveInsideRoot, K as renderAvailableSkillsXml, L as SkillReader, M as toVercelToolSpecs, N as MemoryFS, O as parseBridgeRequest, P as SKILL_NAME_MAX_LENGTH, R as WebSkillError, S as buildRenderResult, T as fromVercelStreamPart, U as jsonRenderer, V as escapeXml, W as normalizePath, X as xmlRenderer, Y as validateSkills, _ as READ_SKILL_FILE_TOOL, a as EventBus, b as WebSkillRuntime, c as FullDisclosureRouter, d as MemoryArtifactStore, f as MockLlmClient, g as READ_SKILL_FILE_INPUT_SCHEMA, h as ProgressiveRouter, i as AgentLoop, j as toLlmToolSpec, k as resolveToolName, l as HookRunner, m as OpenAiCompatibleClient, n as ASK_USER_TOOL, o as FsArtifactStore, p as MockUiBridge, q as renderCatalogJson, r as ASK_USER_TOOL_NAME, s as FsMemoryStore, t as ASK_USER_INPUT_SCHEMA, u as InMemoryStore, v as READ_SKILL_FILE_TOOL_NAME, w as fromVercelResult, x as bridgeError, y as TraceRecorder, z as buildCatalog } from "./dist-BbyIk4vG.js";
 
 export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, EventBus, FsArtifactStore, FsMemoryStore, FullDisclosureRouter, HookRunner, InMemoryStore, MemoryArtifactStore, MemoryFS, MockLlmClient, MockUiBridge, OpenAiCompatibleClient, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, SkillDiscovery, SkillReader, TraceRecorder, WebSkillError, WebSkillRuntime, bridgeError, buildCatalog, buildRenderResult, checkSkillRules, createScriptContext, escapeXml, fromVercelResult, fromVercelStreamPart, isValidSkillName, jsonRenderer, mergeCatalogEntries, normalizePath, normalizeToolContent, parseBridgeRequest, parseSkillMarkdown, renderAvailableSkillsXml, renderCatalogJson, resolveInsideRoot, resolveToolName, schemaToForm, toLlmToolSpec, toVercelToolSpecs, validateSkills, xmlRenderer };

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
-import { Bt as SkillDocument, F as LlmToolSpec, Nt as JsonSchema, Rt as SkillCatalogEntry, St as mergeCatalogEntries, ct as ToolResult, m as ExternalToolSource, p as ExternalSkillProvider } from "./index-88KNOnbr.js";
+import { Ct as mergeCatalogEntries, F as LlmToolSpec, Pt as JsonSchema, Vt as SkillDocument, lt as ToolResult, m as ExternalToolSource, p as ExternalSkillProvider, zt as SkillCatalogEntry } from "./index-j3Z3hbDk.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/mcp.js

@@ -1,4 +1,4 @@
-import { D as normalizeToolContent, E as mergeCatalogEntries, R as WebSkillError } from "./dist-B_ldNWwT.js";
+import { D as normalizeToolContent, E as mergeCatalogEntries, R as WebSkillError } from "./dist-BbyIk4vG.js";
 import { fromJSONSchema } from "zod";
 
 //#region ../mcp/dist/index.js

package/dist/node.d.ts

@@ -1,3 +1,3 @@
-import { yt as createScriptContext } from "./index-88KNOnbr.js";
-import { _ as loadLlmConfigFromEnv, a as LlmEnvConfig, c as SKILLS_LOCKFILE, d as SandboxedScriptExecutor, f as SkillManager, g as VerifyResult, h as SkillsLockfile, i as LlmCapabilities, l as SKILL_MANIFEST_FILE, m as SkillSource, n as FileArtifactStore, o as NodeFS, p as SkillManifest, r as FileMemoryStore, s as NodeScriptExecutor, t as CliUiBridge, u as SandboxOptions, v as probeLlmCapabilities, y as readArchiveManifest } from "./index-Bq-bTWh3.js";
-export { CliUiBridge, FileArtifactStore, FileMemoryStore, type LlmCapabilities, type LlmEnvConfig, NodeFS, NodeScriptExecutor, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, type SandboxOptions, SandboxedScriptExecutor, SkillManager, type SkillManifest, type SkillSource, type SkillsLockfile, type VerifyResult, createScriptContext, loadLlmConfigFromEnv, probeLlmCapabilities, readArchiveManifest };
+import { bt as createScriptContext } from "./index-j3Z3hbDk.js";
+import { _ as VerifyResult, a as LlmEnvConfig, b as readArchiveManifest, c as OxcSchemaInferer, d as SandboxOptions, f as SandboxedScriptExecutor, g as SkillsLockfile, h as SkillSource, i as LlmCapabilities, l as SKILLS_LOCKFILE, m as SkillManifest, n as FileArtifactStore, o as NodeFS, p as SkillManager, r as FileMemoryStore, s as NodeScriptExecutor, t as CliUiBridge, u as SKILL_MANIFEST_FILE, v as loadLlmConfigFromEnv, y as probeLlmCapabilities } from "./index-DF5ea732.js";
+export { CliUiBridge, FileArtifactStore, FileMemoryStore, type LlmCapabilities, type LlmEnvConfig, NodeFS, NodeScriptExecutor, OxcSchemaInferer, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, type SandboxOptions, SandboxedScriptExecutor, SkillManager, type SkillManifest, type SkillSource, type SkillsLockfile, type VerifyResult, createScriptContext, loadLlmConfigFromEnv, probeLlmCapabilities, readArchiveManifest };

package/dist/node.js

@@ -1,4 +1,4 @@
-import { C as createScriptContext } from "./dist-B_ldNWwT.js";
-import { a as NodeScriptExecutor, c as SandboxedScriptExecutor, d as probeLlmCapabilities, f as readArchiveManifest, i as NodeFS, l as SkillManager, n as FileArtifactStore, o as SKILLS_LOCKFILE, r as FileMemoryStore, s as SKILL_MANIFEST_FILE, t as CliUiBridge, u as loadLlmConfigFromEnv } from "./dist-9fczg9Pa.js";
+import { C as createScriptContext } from "./dist-BbyIk4vG.js";
+import { a as NodeScriptExecutor, c as SKILL_MANIFEST_FILE, d as loadLlmConfigFromEnv, f as probeLlmCapabilities, i as NodeFS, l as SandboxedScriptExecutor, n as FileArtifactStore, o as OxcSchemaInferer, p as readArchiveManifest, r as FileMemoryStore, s as SKILLS_LOCKFILE, t as CliUiBridge, u as SkillManager } from "./dist-BMioPPri.js";
 
-export { CliUiBridge, FileArtifactStore, FileMemoryStore, NodeFS, NodeScriptExecutor, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, SandboxedScriptExecutor, SkillManager, createScriptContext, loadLlmConfigFromEnv, probeLlmCapabilities, readArchiveManifest };
+export { CliUiBridge, FileArtifactStore, FileMemoryStore, NodeFS, NodeScriptExecutor, OxcSchemaInferer, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, SandboxedScriptExecutor, SkillManager, createScriptContext, loadLlmConfigFromEnv, probeLlmCapabilities, readArchiveManifest };

package/dist/ui-react.d.ts

@@ -1,4 +1,4 @@
-import { C as InteractionRequest, X as RenderResultRequest, pt as UiBridge, w as InteractionResponse } from "./index-88KNOnbr.js";
+import { C as InteractionRequest, X as RenderResultRequest, mt as UiBridge, w as InteractionResponse } from "./index-j3Z3hbDk.js";
 //#region ../ui-react/dist/index.d.ts
 //#region src/bridgeState.d.ts
 /**

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { C as InteractionRequest, X as RenderResultRequest, pt as UiBridge, w as InteractionResponse } from "./index-88KNOnbr.js";
+import { C as InteractionRequest, X as RenderResultRequest, mt as UiBridge, w as InteractionResponse } from "./index-j3Z3hbDk.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 { C as InteractionRequest, X as RenderResultRequest, Y as RenderBlock, pt as UiBridge, vt as buildRenderResult, w as InteractionResponse } from "./index-88KNOnbr.js";
+import { C as InteractionRequest, X as RenderResultRequest, Y as RenderBlock, mt as UiBridge, w as InteractionResponse, yt as buildRenderResult } from "./index-j3Z3hbDk.js";
 //#region ../ui/dist/index.d.ts
 //#region src/model/formModel.d.ts
 interface FormModel {

package/dist/ui.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
@@ -42,7 +42,9 @@
     },
     "./package.json": "./package.json"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -54,6 +56,7 @@
   "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"