@webskill/sdk 0.0.2 → 0.0.4

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

@@ -12,6 +12,41 @@ var WebSkillError = class extends Error {
 		this.details = details;
 	}
 };
+/** 技能目录内的安装清单文件名（不参与 files 列表与 digest） */
+const SKILL_MANIFEST_FILE = "webskill.skill-manifest.json";
+/** managed root 下的锁定文件名（不参与 files 列表与 digest） */
+const SKILLS_LOCKFILE = "skills.lock.json";
+/** 整体 digest：逐文件 "<path>:<sha256>\n" 拼接串（文件按 path 排序）的 sha256（hash 由调用方提供，可为 WebCrypto 异步实现） */
+async function computeDigest(files, sha256) {
+	return sha256([...files].sort((a, b) => a.path.localeCompare(b.path)).map((f) => `${f.path}:${f.sha256}\n`).join(""));
+}
+/** 由逐文件清单构建 manifest（digest 由 computeDigest 计算） */
+async function buildManifest(input) {
+	return {
+		schemaVersion: 1,
+		name: input.name,
+		...input.version !== void 0 ? { version: input.version } : {},
+		source: input.source,
+		installedAt: input.installedAt,
+		integrity: {
+			algorithm: "sha256",
+			digest: await computeDigest(input.files, input.sha256)
+		},
+		files: input.files
+	};
+}
+/** 按 manifest.files 比对实际 hash（调用方负责计算 actualHashes） */
+function verifyManifest(manifest, actualHashes) {
+	const mismatches = [];
+	for (const file of manifest.files) {
+		const actual = actualHashes.get(file.path);
+		if (actual === void 0 || actual !== file.sha256) mismatches.push(file.path);
+	}
+	return {
+		ok: mismatches.length === 0,
+		mismatches
+	};
+}
 const ROOT = "/";
 /** 内存文件系统：路径一律规范化为 `/` 分隔，写入自动创建父目录 */
 var MemoryFS = class {
@@ -1349,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 ? {
@@ -1396,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)
+				});
+			}
+		}
+	}
+	/** 统一终态处理：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) {
+			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)
 				});
-				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)
-					});
-				}
 			}
 		} catch (e) {
-			if (e instanceof WebSkillError && e.code === "RUN_FAILED") return await finish("failed", "hook-error", messageOf(e), "RUN_FAILED");
+			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 事件，
@@ -1563,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
@@ -1919,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;
@@ -1982,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,
@@ -2002,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 { schemaToForm as A, checkSkillRules as B, createScriptContext as C, normalizeToolContent as D, mergeCatalogEntries as E, SKILL_NAME_PATTERN as F, parseSkillMarkdown as G, isValidSkillName as H, SkillDiscovery as I, resolveInsideRoot as J, renderAvailableSkillsXml as K, SkillReader as L, toVercelToolSpecs as M, MemoryFS as N, parseBridgeRequest as O, SKILL_NAME_MAX_LENGTH as P, WebSkillError as R, buildRenderResult as S, fromVercelStreamPart as T, jsonRenderer as U, escapeXml as V, normalizePath as W, xmlRenderer as X, validateSkills as Y, READ_SKILL_FILE_TOOL as _, EventBus as a, WebSkillRuntime as b, FullDisclosureRouter as c, MemoryArtifactStore as d, 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, renderCatalogJson as q, ASK_USER_TOOL_NAME as r, FsMemoryStore as s, ASK_USER_INPUT_SCHEMA as t, InMemoryStore as u, READ_SKILL_FILE_TOOL_NAME as v, fromVercelResult as w, bridgeError as x, TraceRecorder as y, buildCatalog 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, 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";
+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 { 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 { 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";