@webskill/sdk 0.0.3 → 0.0.4

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { $t as VerifyResult, C as InteractionRequest, M as LlmResponse, Mt as FileStat, N as LlmStreamEvent, Nt as FileSystemProvider, S as InteractionPolicy, Tt as parseBridgeRequest, Wt as SkillInstallSource, X as RenderResultRequest, Zt as SkillsLockfile, 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, qt as SkillManifest, st as ToolDefinition, u as BridgeRequest, vt as bridgeError, w as InteractionResponse } from "./index-DnI0BTEp.js";
+import { A as LlmClient, C as InteractionPolicy, It as FileStat, Jt as SkillInstallSource, Lt as FileSystemProvider, N as LlmResponse, P as LlmStreamEvent, Q as RenderResultRequest, St as bridgeError, T as InteractionResponse, Zt as SkillManifest, ct as ScriptExecutionContext, d as BridgeResponse, dt as ToolDefinition, kt as parseBridgeRequest, l as BridgeCapabilities, lt as ScriptExecutor, m as ExternalToolSource, p as ExternalSkillProvider, pt as ToolResult, rn as VerifyResult, tn as SkillsLockfile, u as BridgeRequest, vt as UiBridge, w as InteractionRequest } from "./index-CqDIreSE.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -165,6 +165,13 @@ type WorkerRequest = {
   type: 'cancel';
   id: string;
   runId: string;
+} | {
+  type: 'list-interrupted';
+  id: string;
+} | {
+  type: 'resume';
+  id: string;
+  runId: string;
 } | {
   type: 'status';
   id: string;
@@ -260,6 +267,10 @@ declare class WorkerRuntimeClient {
   run(prompt: string, runId?: string): Promise<WorkerEvent>;
   status(runId: string): Promise<WorkerEvent>;
   cancel(runId: string): Promise<WorkerEvent>;
+  /** D3：列出可恢复的 interrupted run */
+  listInterrupted(): Promise<WorkerEvent>;
+  /** D3：恢复 interrupted run（新 Worker 重建后重新发起等待中的交互） */
+  resume(runId: string): Promise<WorkerEvent>;
   dispose(): void;
 }
 //#endregion

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { $ as validateSkills, B as WebSkillError, D as normalizeToolContent, E as mergeCatalogEntries, F as SKILL_MANIFEST_FILE, H as buildManifest, K as isValidSkillName, O as parseBridgeRequest, P as SKILLS_LOCKFILE, Q as resolveInsideRoot, R as SkillDiscovery, V as buildCatalog, Y as parseSkillMarkdown, et as verifyManifest, f as MockLlmClient, h as ProgressiveRouter, i as AgentLoop, m as OpenAiCompatibleClient, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError } from "./dist-hMMxARXK.js";
+import { A as parseBridgeRequest, B as SkillDiscovery, C as bridgeError, H as WebSkillError, I as SKILLS_LOCKFILE, J as isValidSkillName, L as SKILL_MANIFEST_FILE, O as mergeCatalogEntries, U as buildCatalog, W as buildManifest, Z as parseSkillMarkdown, b as RUN_SNAPSHOT_SCHEMA_VERSION, c as FsRunSnapshotStore, et as resolveInsideRoot, g as ProgressiveRouter, h as OpenAiCompatibleClient, i as AgentLoop, k as normalizeToolContent, nt as verifyManifest, o as FsArtifactStore, p as MockLlmClient, s as FsMemoryStore, tt as validateSkills } from "./dist-COsE72Ct.js";
 import { unzipSync } from "fflate";
 
 //#region ../browser/dist/index.js
@@ -744,11 +744,16 @@ function parseMainMessage(data) {
 			...isNonEmptyString(data["runId"]) ? { runId: data["runId"] } : {}
 		} : void 0;
 		case "cancel":
-		case "status": return isNonEmptyString(data["id"]) && isNonEmptyString(data["runId"]) ? {
+		case "status":
+		case "resume": return isNonEmptyString(data["id"]) && isNonEmptyString(data["runId"]) ? {
 			type: data["type"],
 			id: data["id"],
 			runId: data["runId"]
 		} : void 0;
+		case "list-interrupted": return isNonEmptyString(data["id"]) ? {
+			type: "list-interrupted",
+			id: data["id"]
+		} : void 0;
 		case "interaction-response": {
 			const response = data["response"];
 			return isNonEmptyString(data["workerMessageId"]) && isRecord(response) && isNonEmptyString(response["id"]) ? {
@@ -890,7 +895,11 @@ function startWorkerRuntimeHost(scope, overrides = {}) {
 				...config.typescript ? { typescript: config.typescript } : {}
 			}),
 			...config.interaction ? { interaction: config.interaction } : {},
-			roots: config.roots ?? ["/skills"]
+			roots: config.roots ?? ["/skills"],
+			snapshotStore: new FsRunSnapshotStore({
+				root: "snapshots",
+				fs
+			})
 		};
 		post({
 			type: "ready",
@@ -936,7 +945,8 @@ function startWorkerRuntimeHost(scope, overrides = {}) {
 				uiBridge,
 				...state.interaction ? { interaction: state.interaction } : {},
 				...overrides.externalTools ? { externalTools: overrides.externalTools } : {},
-				...overrides.skillProviders ? { skillProviders: overrides.skillProviders } : {}
+				...overrides.skillProviders ? { skillProviders: overrides.skillProviders } : {},
+				snapshotStore: state.snapshotStore
 			}).run({
 				sessionId: `session-${runId}`,
 				userPrompt: prompt,
@@ -977,6 +987,91 @@ function startWorkerRuntimeHost(scope, overrides = {}) {
 				} } });
 				return;
 			}
+			case "list-interrupted":
+				if (!state) {
+					result(message.id, { error: {
+						code: "RUN_FAILED",
+						message: "Host is not initialized"
+					} });
+					return;
+				}
+				state.snapshotStore.list().then((snapshots) => result(message.id, { result: { snapshots } }), (e) => result(message.id, { error: serializeError(e) }));
+				return;
+			case "resume":
+				if (!state) {
+					result(message.id, { error: {
+						code: "RUN_FAILED",
+						message: "Host is not initialized"
+					} });
+					return;
+				}
+				(async () => {
+					const snapshot = await state.snapshotStore.load(message.runId);
+					if (!snapshot) throw new WebSkillError("RUN_SNAPSHOT_NOT_FOUND", `No snapshot found for run "${message.runId}"`);
+					if (snapshot.schemaVersion !== 1) {
+						await state.snapshotStore.delete(message.runId);
+						throw new WebSkillError("RUN_SNAPSHOT_INCOMPATIBLE", `Snapshot for run "${message.runId}" has incompatible schemaVersion ${String(snapshot.schemaVersion)}`);
+					}
+					if (Date.now() > Date.parse(snapshot.interactionExpiresAt)) {
+						await state.snapshotStore.delete(message.runId);
+						const endedAt = (/* @__PURE__ */ new Date()).toISOString();
+						return {
+							output: "Interaction timed out before the run was resumed",
+							run: {
+								id: message.runId,
+								sessionId: snapshot.sessionId,
+								status: "failed",
+								phase: "fail",
+								userPrompt: snapshot.userPrompt,
+								startedAt: snapshot.startedAt,
+								endedAt,
+								terminationReason: "interaction-timeout",
+								activeSkillNames: snapshot.activeSkillNames,
+								artifacts: [],
+								trace: [{
+									id: `evt-expired-${message.runId}`,
+									runId: message.runId,
+									ts: endedAt,
+									type: "run.failed",
+									message: `Interaction timed out before the run was resumed (expired at ${snapshot.interactionExpiresAt})`,
+									data: {
+										reason: "interaction-timeout",
+										code: "RUN_INTERACTION_TIMEOUT"
+									}
+								}]
+							}
+						};
+					}
+					const resumeUiBridge = new WorkerUiBridge(scope);
+					activeUiBridge = resumeUiBridge;
+					try {
+						return await new AgentLoop({
+							llm: state.llm,
+							executor: state.executor,
+							artifactStore: new FsArtifactStore({
+								root: "artifacts",
+								fs: state.fs
+							}),
+							memory: new FsMemoryStore({
+								root: "memory",
+								fs: state.fs
+							}),
+							fs: state.fs,
+							skillIndex: /* @__PURE__ */ new Map(),
+							uiBridge: resumeUiBridge,
+							...state.interaction ? { interaction: state.interaction } : {},
+							...overrides.externalTools ? { externalTools: overrides.externalTools } : {},
+							...overrides.skillProviders ? { skillProviders: overrides.skillProviders } : {},
+							snapshotStore: state.snapshotStore
+						}).resume(snapshot);
+					} finally {
+						activeUiBridge = void 0;
+					}
+				})().then((runResult) => {
+					runs.set(message.runId, { status: runResult.run.status });
+					result(message.id, { result: runResult });
+				}, (e) => result(message.id, { error: serializeError(e) }));
+				return;
 			case "cancel":
 				if (!runs.get(message.runId)) {
 					result(message.id, { error: {
@@ -1042,6 +1137,21 @@ var WorkerRuntimeClient = class {
 			runId
 		});
 	}
+	/** D3：列出可恢复的 interrupted run */
+	listInterrupted() {
+		return this.#call({
+			type: "list-interrupted",
+			id: this.#nextId()
+		});
+	}
+	/** D3：恢复 interrupted run（新 Worker 重建后重新发起等待中的交互） */
+	resume(runId) {
+		return this.#call({
+			type: "resume",
+			id: this.#nextId(),
+			runId
+		});
+	}
 	dispose() {
 		for (const [id, pending] of this.#pending) {
 			clearTimeout(pending.timer);

package/dist/{dist-C1p26Ap9.js → dist-Bvhbxrrt.js}

@@ -1,4 +1,4 @@
-import { $ as validateSkills, B as WebSkillError, D as normalizeToolContent, F as SKILL_MANIFEST_FILE, H as buildManifest, K as isValidSkillName, O as parseBridgeRequest, P as SKILLS_LOCKFILE, Q as resolveInsideRoot, Y as parseSkillMarkdown, et as verifyManifest, o as FsArtifactStore, s as FsMemoryStore, x as bridgeError } from "./dist-hMMxARXK.js";
+import { A as parseBridgeRequest, C as bridgeError, H as WebSkillError, I as SKILLS_LOCKFILE, J as isValidSkillName, L as SKILL_MANIFEST_FILE, W as buildManifest, Z as parseSkillMarkdown, et as resolveInsideRoot, k as normalizeToolContent, nt as verifyManifest, o as FsArtifactStore, s as FsMemoryStore, tt as validateSkills } from "./dist-COsE72Ct.js";
 import { existsSync, promises, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";

package/dist/{dist-hMMxARXK.js → dist-COsE72Ct.js}

@@ -1384,34 +1384,35 @@ var AgentLoop = class {
 		};
 	}
 	async run(input) {
-		const llm = this.#deps.llm;
-		const artifactStore = this.#deps.artifactStore;
+		this.#deps.llm;
+		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);
 		const startedAt = now();
 		const startMs = Date.parse(startedAt);
-		const run = {
-			id: runId,
-			sessionId: input.sessionId,
-			status: "running",
-			phase: "route",
-			userPrompt: input.userPrompt,
-			startedAt,
-			activeSkillNames: [],
-			artifacts: [],
-			trace: []
-		};
 		const state = {
 			runId,
-			run,
+			run: {
+				id: runId,
+				sessionId: input.sessionId,
+				status: "running",
+				phase: "route",
+				userPrompt: input.userPrompt,
+				startedAt,
+				activeSkillNames: [],
+				artifacts: [],
+				trace: []
+			},
 			trace,
 			reader: new SkillReader(this.#deps.fs, this.#deps.skillIndex),
 			activated: /* @__PURE__ */ new Set(),
 			activatedTools: /* @__PURE__ */ new Map(),
 			toolTimeoutMs: this.#config.toolTimeoutMs,
 			now,
-			interactionSeq: 0
+			interactionSeq: 0,
+			messages: [],
+			turn: 0
 		};
 		if (this.#deps.hooks && !this.#deps.hooks.onWarning) this.#deps.hooks.onWarning = (message) => trace.record("run.warning", { message });
 		const route = this.#deps.catalogFilter ? {
@@ -1431,113 +1432,272 @@ var AgentLoop = class {
 				return [];
 			}
 		}))).flat();
-		const messages = [{
+		state.messages = [{
 			role: "system",
 			content: route.systemPrompt
 		}, {
 			role: "user",
 			content: input.userPrompt
 		}];
-		const finish = async (status, reason, output, errorCode) => {
-			run.status = status;
-			run.terminationReason = reason;
-			run.endedAt = now();
-			run.activeSkillNames = [...state.activated].sort();
-			run.artifacts = await artifactStore.listArtifacts(runId);
-			if (status === "completed") trace.record("run.completed", { data: { reason } });
-			else if (status === "cancelled") trace.record("run.cancelled", {
-				message: output,
-				data: { reason }
-			});
-			else trace.record("run.failed", {
-				message: output,
-				data: {
-					reason,
-					...errorCode ? { code: errorCode } : {}
-				}
-			});
-			const bridge = this.#deps.uiBridge;
-			if (status === "completed" && bridge?.renderResult && this.#config.renderResult !== "off") try {
-				const request = buildRenderResult(run, output);
-				await bridge.renderResult(request);
-				trace.record("ui.rendered", { data: { blockCount: request.blocks.length } });
-			} catch (e) {
-				trace.record("run.warning", { message: `renderResult failed: ${messageOf(e)}` });
-			}
+		try {
+			return await this.#turnLoop(state, startMs, 1, externalSpecs);
+		} catch (e) {
+			if (e instanceof WebSkillError && e.code === "RUN_FAILED") return this.#finish(state, "failed", "hook-error", messageOf(e), "RUN_FAILED");
+			throw e;
+		}
+	}
+	/** 主循环（run 从第 1 轮、resume 从快照轮次续跑；totalTimeout 以 startedAt 续算） */
+	async #turnLoop(state, startMs, startTurn, externalSpecs) {
+		const finish = (status, reason, output, errorCode) => this.#finish(state, status, reason, output, errorCode);
+		const { llm } = this.#deps;
+		const { trace, messages } = state;
+		for (let turn = startTurn;; turn++) {
+			state.turn = turn;
+			if (turn > this.#config.maxTurns) return finish("failed", "max-turns", `Agent loop exceeded the maximum of ${this.#config.maxTurns} turns`, "RUN_MAX_TURNS_EXCEEDED");
+			if (Date.parse(state.now()) - startMs > this.#config.totalTimeoutMs) return finish("failed", "timeout", `Agent loop exceeded the total timeout of ${this.#config.totalTimeoutMs}ms`, "RUN_TIMEOUT");
+			const toolSpecs = [
+				toLlmToolSpec(READ_SKILL_FILE_TOOL),
+				...this.#deps.uiBridge ? [toLlmToolSpec(ASK_USER_TOOL)] : [],
+				...[...state.activatedTools.values()].map(toLlmToolSpec),
+				...externalSpecs
+			];
+			trace.record("llm.request", { data: {
+				turn,
+				messageCount: messages.length,
+				toolCount: toolSpecs.length
+			} });
+			let response;
 			try {
-				await this.#lifecycle(status === "completed" ? "complete" : "fail", state, { reason });
+				response = llm.stream ? await this.#completeStreaming(llm, state, {
+					model: this.#deps.model,
+					messages,
+					tools: toolSpecs,
+					temperature: this.#config.temperature
+				}) : await llm.complete({
+					model: this.#deps.model,
+					messages,
+					tools: toolSpecs,
+					temperature: this.#config.temperature
+				});
 			} catch (e) {
-				trace.record("run.warning", { message: `Terminal lifecycle hook failed: ${messageOf(e)}` });
+				const code = e instanceof WebSkillError && (e.code === "LLM_UNAVAILABLE" || e.code === "LLM_REQUEST_FAILED") ? e.code : "LLM_REQUEST_FAILED";
+				return finish("failed", "llm-error", messageOf(e), code);
 			}
-			run.trace = trace.list();
-			return {
-				output,
-				run
-			};
-		};
-		try {
-			for (let turn = 1;; turn++) {
-				if (turn > this.#config.maxTurns) return await finish("failed", "max-turns", `Agent loop exceeded the maximum of ${this.#config.maxTurns} turns`, "RUN_MAX_TURNS_EXCEEDED");
-				if (Date.parse(now()) - startMs > this.#config.totalTimeoutMs) return await finish("failed", "timeout", `Agent loop exceeded the total timeout of ${this.#config.totalTimeoutMs}ms`, "RUN_TIMEOUT");
-				const toolSpecs = [
-					toLlmToolSpec(READ_SKILL_FILE_TOOL),
-					...this.#deps.uiBridge ? [toLlmToolSpec(ASK_USER_TOOL)] : [],
-					...[...state.activatedTools.values()].map(toLlmToolSpec),
-					...externalSpecs
-				];
-				trace.record("llm.request", { data: {
-					turn,
-					messageCount: messages.length,
-					toolCount: toolSpecs.length
-				} });
-				let response;
+			trace.record("llm.response", { data: {
+				turn,
+				hasToolCalls: Boolean(response.toolCalls?.length),
+				contentLength: response.content?.length ?? 0
+			} });
+			if (!response.toolCalls?.length) return finish("completed", "final-answer", response.content ?? "");
+			await this.#lifecycle("execute", state, { turn });
+			messages.push({
+				role: "assistant",
+				content: response.content ?? "",
+				toolCalls: response.toolCalls
+			});
+			for (const call of response.toolCalls) {
+				let result;
 				try {
-					response = llm.stream ? await this.#completeStreaming(llm, state, {
-						model: this.#deps.model,
-						messages,
-						tools: toolSpecs,
-						temperature: this.#config.temperature
-					}) : await llm.complete({
-						model: this.#deps.model,
-						messages,
-						tools: toolSpecs,
-						temperature: this.#config.temperature
-					});
+					result = await this.#executeCall(call, state);
 				} catch (e) {
-					const code = e instanceof WebSkillError && (e.code === "LLM_UNAVAILABLE" || e.code === "LLM_REQUEST_FAILED") ? e.code : "LLM_REQUEST_FAILED";
-					return await finish("failed", "llm-error", messageOf(e), code);
+					if (e instanceof RunTerminated) return finish(e.outcome.status, e.outcome.reason, e.outcome.message, e.outcome.code);
+					throw e;
 				}
-				trace.record("llm.response", { data: {
-					turn,
-					hasToolCalls: Boolean(response.toolCalls?.length),
-					contentLength: response.content?.length ?? 0
-				} });
-				if (!response.toolCalls?.length) return await finish("completed", "final-answer", response.content ?? "");
-				await this.#lifecycle("execute", state, { turn });
 				messages.push({
-					role: "assistant",
-					content: response.content ?? "",
-					toolCalls: response.toolCalls
+					role: "tool",
+					toolCallId: call.id,
+					content: JSON.stringify(result)
 				});
-				for (const call of response.toolCalls) {
-					let result;
-					try {
-						result = await this.#executeCall(call, state);
-					} catch (e) {
-						if (e instanceof RunTerminated) return await finish(e.outcome.status, e.outcome.reason, e.outcome.message, e.outcome.code);
-						throw e;
-					}
-					messages.push({
-						role: "tool",
-						toolCallId: call.id,
-						content: JSON.stringify(result)
-					});
-				}
 			}
+		}
+	}
+	/** 统一终态处理：completed/failed/cancelled；终态即删快照（快照是续命机制，审计归治理） */
+	async #finish(state, status, reason, output, errorCode) {
+		const { run, trace } = state;
+		run.status = status;
+		run.terminationReason = reason;
+		run.endedAt = state.now();
+		run.activeSkillNames = [...state.activated].sort();
+		run.artifacts = await this.#deps.artifactStore.listArtifacts(state.runId);
+		if (status === "completed") trace.record("run.completed", { data: { reason } });
+		else if (status === "cancelled") trace.record("run.cancelled", {
+			message: output,
+			data: { reason }
+		});
+		else trace.record("run.failed", {
+			message: output,
+			data: {
+				reason,
+				...errorCode ? { code: errorCode } : {}
+			}
+		});
+		const bridge = this.#deps.uiBridge;
+		if (status === "completed" && bridge?.renderResult && this.#config.renderResult !== "off") try {
+			const request = buildRenderResult(run, output);
+			await bridge.renderResult(request);
+			trace.record("ui.rendered", { data: { blockCount: request.blocks.length } });
+		} catch (e) {
+			trace.record("run.warning", { message: `renderResult failed: ${messageOf(e)}` });
+		}
+		if (this.#deps.snapshotStore) try {
+			await this.#deps.snapshotStore.delete(state.runId);
+		} catch (e) {
+			trace.record("run.warning", { message: `Failed to delete run snapshot: ${messageOf(e)}` });
+		}
+		try {
+			await this.#lifecycle(status === "completed" ? "complete" : "fail", state, { reason });
 		} catch (e) {
-			if (e instanceof WebSkillError && e.code === "RUN_FAILED") return await finish("failed", "hook-error", messageOf(e), "RUN_FAILED");
+			trace.record("run.warning", { message: `Terminal lifecycle hook failed: ${messageOf(e)}` });
+		}
+		run.trace = trace.list();
+		return {
+			output,
+			run
+		};
+	}
+	/** D3 快照写入（含 pendingInteraction 与过期时间；写失败降级 run.warning） */
+	async #saveSnapshot(state, request) {
+		const store = this.#deps.snapshotStore;
+		if (!store) return;
+		const snapshot = {
+			schemaVersion: 1,
+			runId: state.runId,
+			sessionId: state.run.sessionId,
+			userPrompt: state.run.userPrompt,
+			startedAt: state.run.startedAt,
+			messages: state.messages.map((m) => ({ ...m })),
+			turn: state.turn,
+			activeSkillNames: [...state.activated].sort(),
+			activatedTools: [...state.activatedTools.values()],
+			pendingInteraction: request,
+			interactionExpiresAt: state.run.interruptExpiresAt,
+			config: {
+				maxTurns: this.#config.maxTurns,
+				totalTimeoutMs: this.#config.totalTimeoutMs,
+				toolTimeoutMs: this.#config.toolTimeoutMs,
+				...this.#config.temperature !== void 0 ? { temperature: this.#config.temperature } : {}
+			},
+			snapshotAt: state.now()
+		};
+		try {
+			await store.save(snapshot);
+		} catch (e) {
+			state.trace.record("run.warning", { message: `Failed to save run snapshot: ${messageOf(e)}` });
+		}
+	}
+	/**
+	* D3 恢复：以快照重建 LoopState，重新发起等待中的交互（表单重新渲染），
+	* 应答后从快照轮次续跑主循环；totalTimeout 以快照 startedAt 续算。
+	*/
+	async resume(snapshot) {
+		const now = this.#deps.clock?.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+		const runId = snapshot.runId;
+		const trace = new TraceRecorder(runId, this.#deps.clock);
+		const startMs = Date.parse(snapshot.startedAt);
+		const state = {
+			runId,
+			run: {
+				id: runId,
+				sessionId: snapshot.sessionId,
+				status: "running",
+				phase: "execute",
+				userPrompt: snapshot.userPrompt,
+				startedAt: snapshot.startedAt,
+				activeSkillNames: snapshot.activeSkillNames,
+				artifacts: [],
+				trace: []
+			},
+			trace,
+			reader: new SkillReader(this.#deps.fs, this.#deps.skillIndex),
+			activated: new Set(snapshot.activeSkillNames),
+			activatedTools: new Map(snapshot.activatedTools.map((d) => [d.name, d])),
+			toolTimeoutMs: snapshot.config.toolTimeoutMs,
+			now,
+			interactionSeq: 0,
+			messages: snapshot.messages.map((m) => ({ ...m })),
+			turn: snapshot.turn
+		};
+		if (this.#deps.hooks && !this.#deps.hooks.onWarning) this.#deps.hooks.onWarning = (message) => trace.record("run.warning", { message });
+		trace.record("run.resumed", { data: {
+			snapshotAt: snapshot.snapshotAt,
+			turn: snapshot.turn,
+			interactionType: snapshot.pendingInteraction.type
+		} });
+		const pending = snapshot.pendingInteraction;
+		const pendingCall = this.#findPendingToolCall(state.messages);
+		try {
+			if ((pending.type === "form" || pending.type === "select") && pendingCall) {
+				const value = await this.#interact(state, pending, {
+					tool: pendingCall.name,
+					resumed: true
+				});
+				const args = {
+					...pendingCall.arguments,
+					...typeof value === "object" && value !== null ? value : {}
+				};
+				const result = await this.#executeCall({
+					...pendingCall,
+					arguments: args
+				}, state);
+				state.messages.push({
+					role: "tool",
+					toolCallId: pendingCall.id,
+					content: JSON.stringify(result)
+				});
+			} else if (pending.type === "ask" && pendingCall) {
+				const value = await this.#interact(state, pending, {
+					tool: pendingCall.name,
+					resumed: true
+				});
+				const result = {
+					ok: true,
+					content: [{
+						type: "text",
+						text: typeof value === "string" ? value : JSON.stringify(value ?? "")
+					}]
+				};
+				state.trace.record("tool.completed", { data: {
+					name: pendingCall.name,
+					callId: pendingCall.id
+				} });
+				state.messages.push({
+					role: "tool",
+					toolCallId: pendingCall.id,
+					content: JSON.stringify(result)
+				});
+			} else if (pendingCall) {
+				const result = await this.#executeCall(pendingCall, state);
+				state.messages.push({
+					role: "tool",
+					toolCallId: pendingCall.id,
+					content: JSON.stringify(result)
+				});
+			}
+		} catch (e) {
+			if (e instanceof RunTerminated) return this.#finish(state, e.outcome.status, e.outcome.reason, e.outcome.message, e.outcome.code);
 			throw e;
 		}
+		const externalSpecs = (await Promise.all((this.#deps.externalTools ?? []).map(async (source) => {
+			try {
+				return await source.listToolSpecs();
+			} catch (e) {
+				trace.record("run.warning", { message: `External tool source "${source.kind}" failed to list specs: ${messageOf(e)}` });
+				return [];
+			}
+		}))).flat();
+		try {
+			return await this.#turnLoop(state, startMs, snapshot.turn + 1, externalSpecs);
+		} catch (e) {
+			if (e instanceof WebSkillError && e.code === "RUN_FAILED") return this.#finish(state, "failed", "hook-error", messageOf(e), "RUN_FAILED");
+			throw e;
+		}
+	}
+	/** 最后一条 assistant 消息里第一个尚无 tool 响应的工具调用（即中断时正在处理的那个） */
+	#findPendingToolCall(messages) {
+		const lastAssistant = [...messages].reverse().find((m) => m.role === "assistant" && m.toolCalls?.length);
+		if (!lastAssistant?.toolCalls) return void 0;
+		const answered = new Set(messages.filter((m) => m.role === "tool").map((m) => m.toolCallId));
+		return lastAssistant.toolCalls.find((call) => !answered.has(call.id));
 	}
 	/**
 	* 流式 LLM 调用：text-delta 仅在 EventBus 有订阅者时发射 llm.delta 事件，
@@ -1598,6 +1758,7 @@ var AgentLoop = class {
 		const { run } = state;
 		run.status = "interrupted";
 		run.interruptExpiresAt = new Date(Date.parse(state.now()) + this.#policy.interactionTimeoutMs).toISOString();
+		await this.#saveSnapshot(state, request);
 		await this.#lifecycle("interact", state, {
 			interactionId: request.id,
 			type: request.type
@@ -1954,6 +2115,58 @@ function mergeCatalogEntries(localEntries, providerEntries) {
 	for (const entry of providerEntries) if (!byName.has(entry.name)) byName.set(entry.name, entry);
 	return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
 }
+const RUN_SNAPSHOT_SCHEMA_VERSION = 1;
+const SNAPSHOT_SUFFIX = ".snapshot.json";
+/**
+* FileSystemProvider 后端的快照存储：<root>/<runId>.snapshot.json。
+* 坏 JSON → RUN_SNAPSHOT_INCOMPATIBLE 并自动清理坏文件；runId 过路径安全校验。
+*/
+var FsRunSnapshotStore = class {
+	#root;
+	#fs;
+	constructor(deps) {
+		this.#root = deps.root.replace(/\/+$/, "");
+		this.#fs = deps.fs;
+	}
+	#path(runId) {
+		return resolveInsideRoot(this.#root, `${runId}${SNAPSHOT_SUFFIX}`);
+	}
+	async save(snapshot) {
+		await this.#fs.writeText(this.#path(snapshot.runId), JSON.stringify(snapshot, null, 2));
+	}
+	async load(runId) {
+		const path = this.#path(runId);
+		if (!await this.#fs.exists(path)) return void 0;
+		let parsed;
+		try {
+			parsed = JSON.parse(await this.#fs.readText(path));
+		} catch (e) {
+			await this.#fs.remove(path).catch(() => void 0);
+			throw new WebSkillError("RUN_SNAPSHOT_INCOMPATIBLE", `Snapshot for run "${runId}" is corrupted and was deleted: ${e instanceof Error ? e.message : String(e)}`, e);
+		}
+		const snapshot = parsed;
+		if (typeof snapshot !== "object" || snapshot === null || snapshot.runId !== runId) {
+			await this.#fs.remove(path).catch(() => void 0);
+			throw new WebSkillError("RUN_SNAPSHOT_INCOMPATIBLE", `Snapshot for run "${runId}" has an unexpected shape and was deleted`);
+		}
+		return snapshot;
+	}
+	async delete(runId) {
+		const path = this.#path(runId);
+		if (await this.#fs.exists(path)) await this.#fs.remove(path);
+	}
+	async list() {
+		if (!await this.#fs.exists(this.#root)) return [];
+		const out = [];
+		for (const entry of await this.#fs.list(this.#root)) {
+			if (entry.type !== "file" || !entry.path.endsWith(SNAPSHOT_SUFFIX)) continue;
+			try {
+				out.push(JSON.parse(await this.#fs.readText(entry.path)));
+			} catch {}
+		}
+		return out.sort((a, b) => a.snapshotAt.localeCompare(b.snapshotAt));
+	}
+};
 /** runtime 门面：组合 discovery / router / agent loop / lifecycle */
 var WebSkillRuntime = class {
 	#deps;
@@ -2017,7 +2230,8 @@ var WebSkillRuntime = class {
 			longTerm: this.#deps.longTerm,
 			externalTools: this.#deps.externalTools,
 			skillProviders: this.#deps.skillProviders,
-			catalogFilter: this.#deps.catalogFilter
+			catalogFilter: this.#deps.catalogFilter,
+			snapshotStore: this.#deps.snapshotStore
 		}, this.#deps.config).run({
 			sessionId: this.#session.id,
 			userPrompt,
@@ -2037,7 +2251,78 @@ var WebSkillRuntime = class {
 		});
 		return result;
 	}
+	/** D3：列出可恢复的 interrupted run（供 UI 展示"未完成任务"） */
+	async listInterruptedRuns() {
+		if (!this.#deps.snapshotStore) return [];
+		return this.#deps.snapshotStore.list();
+	}
+	/**
+	* D3 恢复 interrupted run：
+	* 不存在 → RUN_SNAPSHOT_NOT_FOUND；schemaVersion 不匹配 → 删除 + RUN_SNAPSHOT_INCOMPATIBLE；
+	* 已过期 → interaction-timeout 终态并删快照；否则重建 LoopState 重新发起交互续跑。
+	*/
+	async resumeRun(runId) {
+		const store = this.#deps.snapshotStore;
+		const snapshot = store ? await store.load(runId) : void 0;
+		if (!snapshot) throw new WebSkillError("RUN_SNAPSHOT_NOT_FOUND", `No snapshot found for run "${runId}"`);
+		if (snapshot.schemaVersion !== 1) {
+			await store.delete(runId);
+			throw new WebSkillError("RUN_SNAPSHOT_INCOMPATIBLE", `Snapshot for run "${runId}" has incompatible schemaVersion ${String(snapshot.schemaVersion)}`);
+		}
+		if (Date.now() > Date.parse(snapshot.interactionExpiresAt)) {
+			await store.delete(runId);
+			const endedAt = (/* @__PURE__ */ new Date()).toISOString();
+			return {
+				output: "Interaction timed out before the run was resumed",
+				run: {
+					id: runId,
+					sessionId: snapshot.sessionId,
+					status: "failed",
+					phase: "fail",
+					userPrompt: snapshot.userPrompt,
+					startedAt: snapshot.startedAt,
+					endedAt,
+					terminationReason: "interaction-timeout",
+					activeSkillNames: snapshot.activeSkillNames,
+					artifacts: [],
+					trace: [{
+						id: `evt-expired-${runId}`,
+						runId,
+						ts: endedAt,
+						type: "run.failed",
+						message: `Interaction timed out before the run was resumed (expired at ${snapshot.interactionExpiresAt})`,
+						data: {
+							reason: "interaction-timeout",
+							code: "RUN_INTERACTION_TIMEOUT"
+						}
+					}]
+				}
+			};
+		}
+		if (!this.#catalogCache) await this.discover();
+		const cache = this.#catalogCache;
+		if (!cache) throw new WebSkillError("RUN_FAILED", "discover() did not populate the catalog cache");
+		return 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,
+			model: this.#deps.model,
+			uiBridge: this.#deps.uiBridge,
+			interaction: this.#deps.interaction,
+			memory: this.#deps.memory,
+			hooks: this.#deps.hooks,
+			eventBus: this.#events,
+			longTerm: this.#deps.longTerm,
+			externalTools: this.#deps.externalTools,
+			skillProviders: this.#deps.skillProviders,
+			catalogFilter: this.#deps.catalogFilter,
+			snapshotStore: store
+		}, this.#deps.config).resume(snapshot);
+	}
 };
 
 //#endregion
-export { validateSkills as $, schemaToForm as A, WebSkillError as B, createScriptContext as C, normalizeToolContent as D, mergeCatalogEntries as E, SKILL_MANIFEST_FILE as F, escapeXml as G, buildManifest as H, SKILL_NAME_MAX_LENGTH as I, normalizePath as J, isValidSkillName as K, SKILL_NAME_PATTERN as L, toVercelToolSpecs as M, MemoryFS as N, parseBridgeRequest as O, SKILLS_LOCKFILE as P, resolveInsideRoot as Q, SkillDiscovery as R, buildRenderResult as S, fromVercelStreamPart as T, checkSkillRules as U, buildCatalog as V, computeDigest as W, renderAvailableSkillsXml as X, parseSkillMarkdown as Y, renderCatalogJson as Z, READ_SKILL_FILE_TOOL as _, EventBus as a, WebSkillRuntime as b, FullDisclosureRouter as c, MemoryArtifactStore as d, verifyManifest as et, MockLlmClient as f, READ_SKILL_FILE_INPUT_SCHEMA as g, ProgressiveRouter as h, AgentLoop as i, toLlmToolSpec as j, resolveToolName as k, HookRunner as l, OpenAiCompatibleClient as m, ASK_USER_TOOL as n, FsArtifactStore as o, MockUiBridge as p, jsonRenderer as q, ASK_USER_TOOL_NAME as r, FsMemoryStore as s, ASK_USER_INPUT_SCHEMA as t, xmlRenderer as tt, InMemoryStore as u, READ_SKILL_FILE_TOOL_NAME as v, fromVercelResult as w, bridgeError as x, TraceRecorder as y, SkillReader as z };
+export { renderCatalogJson as $, parseBridgeRequest as A, SkillDiscovery as B, bridgeError as C, fromVercelStreamPart as D, fromVercelResult as E, MemoryFS as F, checkSkillRules as G, WebSkillError as H, SKILLS_LOCKFILE as I, isValidSkillName as J, computeDigest as K, SKILL_MANIFEST_FILE as L, schemaToForm as M, toLlmToolSpec as N, mergeCatalogEntries as O, toVercelToolSpecs as P, renderAvailableSkillsXml as Q, SKILL_NAME_MAX_LENGTH as R, WebSkillRuntime as S, createScriptContext as T, buildCatalog as U, SkillReader as V, buildManifest as W, normalizePath as X, jsonRenderer as Y, parseSkillMarkdown as Z, READ_SKILL_FILE_INPUT_SCHEMA as _, EventBus as a, RUN_SNAPSHOT_SCHEMA_VERSION as b, FsRunSnapshotStore as c, InMemoryStore as d, resolveInsideRoot as et, MemoryArtifactStore as f, ProgressiveRouter as g, OpenAiCompatibleClient as h, AgentLoop as i, resolveToolName as j, normalizeToolContent as k, FullDisclosureRouter as l, MockUiBridge as m, ASK_USER_TOOL as n, verifyManifest as nt, FsArtifactStore as o, MockLlmClient as p, escapeXml as q, ASK_USER_TOOL_NAME as r, xmlRenderer as rt, FsMemoryStore as s, ASK_USER_INPUT_SCHEMA as t, validateSkills as tt, HookRunner as u, READ_SKILL_FILE_TOOL as v, buildRenderResult as w, TraceRecorder as x, READ_SKILL_FILE_TOOL_NAME as y, SKILL_NAME_PATTERN as z };

package/dist/governance.d.ts

@@ -1,5 +1,5 @@
-import { Nt as FileSystemProvider, Vt as SkillCatalogEntry, gt as WebSkillRuntime, j as LlmMessage, k as LlmClient, mt as UiBridge, qt as SkillManifest, tt as RuntimeRun } from "./index-DnI0BTEp.js";
-import { d as SkillManager } from "./index-D65Jk0ju.js";
+import { A as LlmClient, Gt as SkillCatalogEntry, Lt as FileSystemProvider, M as LlmMessage, Zt as SkillManifest, at as RuntimeRun, bt as WebSkillRuntime, vt as UiBridge } from "./index-CqDIreSE.js";
+import { d as SkillManager } from "./index-BsbfEiaC.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 { $ as validateSkills, B as WebSkillError, K as isValidSkillName, Q as resolveInsideRoot } from "./dist-hMMxARXK.js";
-import { i as NodeFS } from "./dist-C1p26Ap9.js";
+import { H as WebSkillError, J as isValidSkillName, et as resolveInsideRoot, tt as validateSkills } from "./dist-COsE72Ct.js";
+import { i as NodeFS } from "./dist-Bvhbxrrt.js";
 import path from "node:path";
 import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";

package/dist/{index-D65Jk0ju.d.ts → index-BsbfEiaC.d.ts}

@@ -1,4 +1,4 @@
-import { $t as VerifyResult, C as InteractionRequest, Mt as FileStat, Nt as FileSystemProvider, Pt as JsonSchema, Wt as SkillInstallSource, X as RenderResultRequest, Zt as SkillsLockfile, _ as FsMemoryStore, at as ScriptExecutor, g as FsArtifactStore, it as ScriptExecutionContext, l as BridgeCapabilities, lt as ToolResult, mt as UiBridge, qt as SkillManifest, rt as SchemaInferer, st as ToolDefinition, w as InteractionResponse } from "./index-DnI0BTEp.js";
+import { It as FileStat, Jt as SkillInstallSource, Lt as FileSystemProvider, Q as RenderResultRequest, Rt as JsonSchema, T as InteractionResponse, Zt as SkillManifest, _ as FsMemoryStore, ct as ScriptExecutionContext, dt as ToolDefinition, g as FsArtifactStore, l as BridgeCapabilities, lt as ScriptExecutor, pt as ToolResult, rn as VerifyResult, st as SchemaInferer, tn as SkillsLockfile, vt as UiBridge, w as InteractionRequest } from "./index-CqDIreSE.js";
 import { Readable, Writable } from "node:stream";
 //#region ../node/dist/index.d.ts
 //#region src/fs/nodeFs.d.ts

package/dist/{index-DnI0BTEp.d.ts → index-CqDIreSE.d.ts}

@@ -1,6 +1,6 @@
 //#region ../core/dist/index.d.ts
 //#region src/errors.d.ts
-type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FOUND' | 'SKILL_INVALID_METADATA' | 'SKILL_INVALID_NAME' | 'SKILL_DUPLICATE_NAME' | 'SKILL_UNSUPPORTED_SCRIPT' | 'VALIDATION_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_EXECUTION_FAILED' | 'TOOL_UNSUPPORTED' | 'TOOL_SCHEMA_UNAVAILABLE' | 'RUN_TIMEOUT' | 'RUN_MAX_TURNS_EXCEEDED' | 'RUN_FAILED' | 'RUN_CANCELLED' | 'RUN_INTERACTION_TIMEOUT' | 'UI_UNAVAILABLE' | 'LLM_UNAVAILABLE' | 'LLM_REQUEST_FAILED' | 'INSTALL_FAILED' | 'UNINSTALL_FAILED' | 'EXPORT_FAILED' | 'INTEGRITY_FAILED' | 'FS_PERMISSION_DENIED' | 'MCP_ENDPOINT_UNAVAILABLE' | 'MCP_TOOL_NOT_FOUND' | 'CANDIDATE_INVALID' | 'APPROVAL_REQUIRED' | 'SKILL_QUARANTINED' | 'SKILL_DISABLED' | 'GOVERNANCE_FAILED';
+type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FOUND' | 'SKILL_INVALID_METADATA' | 'SKILL_INVALID_NAME' | 'SKILL_DUPLICATE_NAME' | 'SKILL_UNSUPPORTED_SCRIPT' | 'VALIDATION_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_EXECUTION_FAILED' | 'TOOL_UNSUPPORTED' | 'TOOL_SCHEMA_UNAVAILABLE' | 'RUN_TIMEOUT' | 'RUN_MAX_TURNS_EXCEEDED' | 'RUN_FAILED' | 'RUN_CANCELLED' | 'RUN_INTERACTION_TIMEOUT' | 'UI_UNAVAILABLE' | 'LLM_UNAVAILABLE' | 'LLM_REQUEST_FAILED' | 'INSTALL_FAILED' | 'UNINSTALL_FAILED' | 'EXPORT_FAILED' | 'INTEGRITY_FAILED' | 'FS_PERMISSION_DENIED' | 'MCP_ENDPOINT_UNAVAILABLE' | 'MCP_TOOL_NOT_FOUND' | 'CANDIDATE_INVALID' | 'APPROVAL_REQUIRED' | 'SKILL_QUARANTINED' | 'SKILL_DISABLED' | 'GOVERNANCE_FAILED' | 'RUN_SNAPSHOT_NOT_FOUND' | 'RUN_SNAPSHOT_EXPIRED' | 'RUN_SNAPSHOT_INCOMPATIBLE';
 /** 所有公开 API 抛出的结构化错误，code 供上层可编程处理 */
 declare class WebSkillError extends Error {
   readonly code: WebSkillErrorCode;
@@ -657,7 +657,7 @@ type LifecycleHook = (ctx: LifecycleHookContext) => Promise<void | {
 }>;
 //#endregion
 //#region src/trace/types.d.ts
-type TraceEventType = 'skill.routed' | 'skill.activated' | 'llm.request' | 'llm.response' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'artifact.created' | 'ui.requested' | 'ui.resumed' | 'ui.rendered' | 'run.warning' | 'run.completed' | 'run.cancelled' | 'run.failed';
+type TraceEventType = 'skill.routed' | 'skill.activated' | 'llm.request' | 'llm.response' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'artifact.created' | 'ui.requested' | 'ui.resumed' | 'ui.rendered' | 'run.warning' | 'run.completed' | 'run.cancelled' | 'run.failed' | 'run.resumed';
 interface TraceEvent {
   id: string;
   runId: string;
@@ -940,6 +940,56 @@ interface ExternalSkillProvider {
  */
 declare function mergeCatalogEntries(localEntries: SkillCatalogEntry[], providerEntries: SkillCatalogEntry[]): SkillCatalogEntry[];
 //#endregion
+//#region src/engine/snapshot.d.ts
+declare const RUN_SNAPSHOT_SCHEMA_VERSION = 1;
+/** interrupted（等待用户）状态点的可恢复快照（D3 收窄版） */
+interface RunSnapshot {
+  schemaVersion: 1;
+  runId: string;
+  sessionId: string;
+  userPrompt: string;
+  startedAt: string;
+  /** 完整消息历史（含 system/user/assistant/tool） */
+  messages: LlmMessage[];
+  /** 当前轮次（护栏续算） */
+  turn: number;
+  activeSkillNames: string[];
+  /** 已注册脚本工具定义（恢复后免重新激活） */
+  activatedTools: ToolDefinition[];
+  /** 等待中的交互（恢复时重新发起，表单重新渲染） */
+  pendingInteraction: InteractionRequest;
+  /** 进入 interrupted 时计算的过期时间 */
+  interactionExpiresAt: string;
+  config: {
+    maxTurns: number;
+    totalTimeoutMs: number;
+    toolTimeoutMs: number;
+    temperature?: number;
+  };
+  snapshotAt: string;
+}
+interface RunSnapshotStore {
+  save(snapshot: RunSnapshot): Promise<void>;
+  load(runId: string): Promise<RunSnapshot | undefined>;
+  delete(runId: string): Promise<void>;
+  list(): Promise<RunSnapshot[]>;
+}
+/**
+ * FileSystemProvider 后端的快照存储：<root>/<runId>.snapshot.json。
+ * 坏 JSON → RUN_SNAPSHOT_INCOMPATIBLE 并自动清理坏文件；runId 过路径安全校验。
+ */
+declare class FsRunSnapshotStore implements RunSnapshotStore {
+  #private;
+  constructor(deps: {
+    root: string;
+    fs: FileSystemProvider;
+  });
+  save(snapshot: RunSnapshot): Promise<void>;
+  load(runId: string): Promise<RunSnapshot | undefined>;
+  delete(runId: string): Promise<void>;
+  list(): Promise<RunSnapshot[]>;
+}
+//#endregion
 //#region src/engine/agentLoop.d.ts
 interface AgentLoopDeps {
   llm: LlmClient;
@@ -971,6 +1021,8 @@ interface AgentLoopDeps {
   skillProviders?: ExternalSkillProvider[];
   /** Catalog 过滤钩子（治理状态拦截路由，如 quarantined/deprecated 过滤） */
   catalogFilter?: (entries: SkillCatalogEntry[]) => SkillCatalogEntry[] | Promise<SkillCatalogEntry[]>;
+  /** D3：interrupt 点快照存储（无配置则行为与现状完全一致） */
+  snapshotStore?: RunSnapshotStore;
 }
 /**
  * 多轮 Agent 循环。
@@ -986,6 +1038,11 @@ declare class AgentLoop {
     route: RouteResult;
     runId?: string;
   }): Promise<RunResult>;
+  /**
+   * D3 恢复：以快照重建 LoopState，重新发起等待中的交互（表单重新渲染），
+   * 应答后从快照轮次续跑主循环；totalTimeout 以快照 startedAt 续算。
+   */
+  resume(snapshot: RunSnapshot): Promise<RunResult>;
 }
 //#endregion
 //#region src/engine/runtime.d.ts
@@ -1022,8 +1079,10 @@ interface WebSkillRuntimeDeps {
   /** opt-in：run 完成且未激活任何技能时回调（默认关闭，fire-and-forget） */
   onSkillMiss?: (input: {
     prompt: string;
-    run: RunResult['run'];
+    run: RuntimeRun;
   }) => Promise<void>;
+  /** D3：interrupt 点快照存储（配置后 interrupted run 可 resumeRun 恢复） */
+  snapshotStore?: RunSnapshotStore;
 }
 /** runtime 门面：组合 discovery / router / agent loop / lifecycle */
 declare class WebSkillRuntime {
@@ -1034,6 +1093,14 @@ declare class WebSkillRuntime {
   get events(): EventBus;
   discover(): Promise<DiscoveryResult>;
   run(userPrompt: string): Promise<RunResult>;
+  /** D3：列出可恢复的 interrupted run（供 UI 展示"未完成任务"） */
+  listInterruptedRuns(): Promise<RunSnapshot[]>;
+  /**
+   * D3 恢复 interrupted run：
+   * 不存在 → RUN_SNAPSHOT_NOT_FOUND；schemaVersion 不匹配 → 删除 + RUN_SNAPSHOT_INCOMPATIBLE；
+   * 已过期 → interaction-timeout 终态并删快照；否则重建 LoopState 重新发起交互续跑。
+   */
+  resumeRun(runId: string): Promise<RunResult>;
 }
 //#endregion
-export { RunTerminationReason as $, VerifyResult as $t, LlmCompleteInput as A, CatalogRenderer as At, MockLlmQueueItem as B, SkillCatalog 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, SkillIssue as Gt, MockUiBridge as H, SkillDiscovery as Ht, MemoryArtifactStore as I, SKILLS_LOCKFILE as It, READ_SKILL_FILE_TOOL_NAME as J, SkillMetadata as Jt, READ_SKILL_FILE_INPUT_SCHEMA as K, SkillLocation as Kt, MemoryStore as L, SKILL_MANIFEST_FILE 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, ValidationReport as Qt, MockLlmClient as R, SKILL_NAME_MAX_LENGTH as Rt, InteractionPolicy as S, fromVercelStreamPart as St, LifecycleEvent as T, parseBridgeRequest as Tt, OpenAiCompatibleClient as U, SkillDocument as Ut, MockUiAnswer as V, SkillCatalogEntry as Vt, OpenAiCompatibleClientConfig as W, SkillInstallSource as Wt, RenderResultRequest as X, SkillSource as Xt, RenderBlock as Y, SkillReader as Yt, RouteResult as Z, SkillsLockfile as Zt, FsMemoryStore as _, WebSkillRuntimeDeps as _t, AgentLoopConfig as a, computeDigest as an, ScriptExecutor as at, HookRunnerOptions as b, createScriptContext as bt, ArtifactStore as c, jsonRenderer as cn, ToolResolution as ct, BridgeResponse as d, renderAvailableSkillsXml as dn, TraceEvent as dt, WebSkillError as en, RuntimePhase as et, EventBus as f, renderCatalogJson as fn, TraceEventType as ft, FsArtifactStore as g, xmlRenderer as gn, WebSkillRuntime as gt, FormField as h, verifyManifest as hn, VercelToolSpec as ht, AgentLoop as i, checkSkillRules as in, ScriptExecutionContext as it, LlmMessage as j, DiscoveryResult as jt, LlmClient as k, toVercelToolSpecs as kt, BridgeCapabilities as l, normalizePath as ln, ToolResult as lt, ExternalToolSource as m, validateSkills as mn, UiBridge as mt, ASK_USER_TOOL as n, buildCatalog as nn, RuntimeSession as nt, AgentLoopDeps as o, escapeXml as on, SkillRouter as ot, ExternalSkillProvider as p, resolveInsideRoot as pn, TraceRecorder as pt, READ_SKILL_FILE_TOOL as q, SkillManifest as qt, ASK_USER_TOOL_NAME as r, buildManifest as rn, SchemaInferer as rt, Artifact as s, isValidSkillName as sn, ToolDefinition as st, ASK_USER_INPUT_SCHEMA as t, WebSkillErrorCode as tn, RuntimeRun as tt, BridgeRequest as u, parseSkillMarkdown as un, 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, SKILL_NAME_PATTERN as zt };
+export { RouteResult as $, SkillReader as $t, LlmClient as A, resolveToolName as At, MockLlmHandler as B, SKILLS_LOCKFILE as Bt, InteractionPolicy as C, buildRenderResult as Ct, LifecycleHook as D, mergeCatalogEntries as Dt, LifecycleEvent as E, fromVercelStreamPart as Et, LlmToolCall as F, DiscoveryResult as Ft, OpenAiCompatibleClientConfig as G, SkillCatalogEntry as Gt, MockUiAnswer as H, SKILL_NAME_MAX_LENGTH as Ht, LlmToolSpec as I, FileStat as It, READ_SKILL_FILE_TOOL as J, SkillInstallSource as Jt, ProgressiveRouter as K, SkillDiscovery as Kt, MemoryArtifactStore as L, FileSystemProvider as Lt, LlmMessage as M, toLlmToolSpec as Mt, LlmResponse as N, toVercelToolSpecs as Nt, LifecycleHookContext as O, normalizeToolContent as Ot, LlmStreamEvent as P, CatalogRenderer as Pt, RenderResultRequest as Q, SkillMetadata as Qt, MemoryStore as R, JsonSchema as Rt, InMemoryStore as S, bridgeError as St, InteractionResponse as T, fromVercelResult as Tt, MockUiBridge as U, SKILL_NAME_PATTERN as Ut, MockLlmQueueItem as V, SKILL_MANIFEST_FILE as Vt, OpenAiCompatibleClient as W, SkillCatalog as Wt, RUN_SNAPSHOT_SCHEMA_VERSION as X, SkillLocation as Xt, READ_SKILL_FILE_TOOL_NAME as Y, SkillIssue as Yt, RenderBlock as Z, SkillManifest as Zt, FsMemoryStore as _, resolveInsideRoot as _n, TraceRecorder as _t, AgentLoopConfig as a, WebSkillErrorCode as an, RuntimeRun as at, HookRunner as b, xmlRenderer as bn, WebSkillRuntime as bt, ArtifactStore as c, checkSkillRules as cn, ScriptExecutionContext as ct, BridgeResponse as d, isValidSkillName as dn, ToolDefinition as dt, SkillSource as en, RunResult as et, EventBus as f, jsonRenderer as fn, ToolResolution as ft, FsArtifactStore as g, renderCatalogJson as gn, TraceEventType as gt, FormField as h, renderAvailableSkillsXml as hn, TraceEvent as ht, AgentLoop as i, WebSkillError as in, RuntimePhase as it, LlmCompleteInput as j, schemaToForm as jt, LifecycleListener as k, parseBridgeRequest as kt, BridgeCapabilities as l, computeDigest as ln, ScriptExecutor as lt, ExternalToolSource as m, parseSkillMarkdown as mn, TraceClock as mt, ASK_USER_TOOL as n, ValidationReport as nn, RunSnapshotStore as nt, AgentLoopDeps as o, buildCatalog as on, RuntimeSession as ot, ExternalSkillProvider as p, normalizePath as pn, ToolResult as pt, READ_SKILL_FILE_INPUT_SCHEMA as q, SkillDocument as qt, ASK_USER_TOOL_NAME as r, VerifyResult as rn, RunTerminationReason as rt, Artifact as s, buildManifest as sn, SchemaInferer as st, ASK_USER_INPUT_SCHEMA as t, SkillsLockfile as tn, RunSnapshot as tt, BridgeRequest as u, escapeXml as un, SkillRouter as ut, FsRunSnapshotStore as v, validateSkills as vn, UiBridge as vt, InteractionRequest as w, createScriptContext as wt, HookRunnerOptions as x, WebSkillRuntimeDeps as xt, FullDisclosureRouter as y, verifyManifest as yn, VercelToolSpec as yt, MockLlmClient as z, MemoryFS as zt };

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
-import { Ct as mergeCatalogEntries, F as LlmToolSpec, Pt as JsonSchema, Ut as SkillDocument, Vt as SkillCatalogEntry, lt as ToolResult, m as ExternalToolSource, p as ExternalSkillProvider } from "./index-DnI0BTEp.js";
+import { Dt as mergeCatalogEntries, Gt as SkillCatalogEntry, I as LlmToolSpec, Rt as JsonSchema, m as ExternalToolSource, p as ExternalSkillProvider, pt as ToolResult, qt as SkillDocument } from "./index-CqDIreSE.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 { B as WebSkillError, D as normalizeToolContent, E as mergeCatalogEntries } from "./dist-hMMxARXK.js";
+import { H as WebSkillError, O as mergeCatalogEntries, k as normalizeToolContent } from "./dist-COsE72Ct.js";
 import { fromJSONSchema } from "zod";
 
 //#region ../mcp/dist/index.js

package/dist/node.d.ts

@@ -1,3 +1,3 @@
-import { $t as VerifyResult, It as SKILLS_LOCKFILE, Lt as SKILL_MANIFEST_FILE, Wt as SkillInstallSource, Zt as SkillsLockfile, bt as createScriptContext, qt as SkillManifest } from "./index-DnI0BTEp.js";
-import { a as LlmEnvConfig, c as OxcSchemaInferer, d as SkillManager, f as loadLlmConfigFromEnv, i as LlmCapabilities, l as SandboxOptions, m as readArchiveManifest, n as FileArtifactStore, o as NodeFS, p as probeLlmCapabilities, r as FileMemoryStore, s as NodeScriptExecutor, t as CliUiBridge, u as SandboxedScriptExecutor } from "./index-D65Jk0ju.js";
+import { Bt as SKILLS_LOCKFILE, Jt as SkillInstallSource, Vt as SKILL_MANIFEST_FILE, Zt as SkillManifest, rn as VerifyResult, tn as SkillsLockfile, wt as createScriptContext } from "./index-CqDIreSE.js";
+import { a as LlmEnvConfig, c as OxcSchemaInferer, d as SkillManager, f as loadLlmConfigFromEnv, i as LlmCapabilities, l as SandboxOptions, m as readArchiveManifest, n as FileArtifactStore, o as NodeFS, p as probeLlmCapabilities, r as FileMemoryStore, s as NodeScriptExecutor, t as CliUiBridge, u as SandboxedScriptExecutor } from "./index-BsbfEiaC.js";
 export { CliUiBridge, FileArtifactStore, FileMemoryStore, type LlmCapabilities, type LlmEnvConfig, NodeFS, NodeScriptExecutor, OxcSchemaInferer, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, type SandboxOptions, SandboxedScriptExecutor, SkillManager, type SkillManifest, type SkillInstallSource as SkillSource, type SkillsLockfile, type VerifyResult, createScriptContext, loadLlmConfigFromEnv, probeLlmCapabilities, readArchiveManifest };

package/dist/node.js

@@ -1,4 +1,4 @@
-import { C as createScriptContext, F as SKILL_MANIFEST_FILE, P as SKILLS_LOCKFILE } from "./dist-hMMxARXK.js";
-import { a as NodeScriptExecutor, c as SkillManager, d as readArchiveManifest, i as NodeFS, l as loadLlmConfigFromEnv, n as FileArtifactStore, o as OxcSchemaInferer, r as FileMemoryStore, s as SandboxedScriptExecutor, t as CliUiBridge, u as probeLlmCapabilities } from "./dist-C1p26Ap9.js";
+import { I as SKILLS_LOCKFILE, L as SKILL_MANIFEST_FILE, T as createScriptContext } from "./dist-COsE72Ct.js";
+import { a as NodeScriptExecutor, c as SkillManager, d as readArchiveManifest, i as NodeFS, l as loadLlmConfigFromEnv, n as FileArtifactStore, o as OxcSchemaInferer, r as FileMemoryStore, s as SandboxedScriptExecutor, t as CliUiBridge, u as probeLlmCapabilities } from "./dist-Bvhbxrrt.js";
 
 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, mt as UiBridge, w as InteractionResponse } from "./index-DnI0BTEp.js";
+import { Q as RenderResultRequest, T as InteractionResponse, vt as UiBridge, w as InteractionRequest } from "./index-CqDIreSE.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, mt as UiBridge, w as InteractionResponse } from "./index-DnI0BTEp.js";
+import { Q as RenderResultRequest, T as InteractionResponse, vt as UiBridge, w as InteractionRequest } from "./index-CqDIreSE.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, mt as UiBridge, w as InteractionResponse, yt as buildRenderResult } from "./index-DnI0BTEp.js";
+import { Ct as buildRenderResult, Q as RenderResultRequest, T as InteractionResponse, Z as RenderBlock, vt as UiBridge, w as InteractionRequest } from "./index-CqDIreSE.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-hMMxARXK.js";
+import { w as buildRenderResult } from "./dist-COsE72Ct.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.3",
+  "version": "0.0.4",
   "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",