@webskill/sdk 0.4.0 → 0.5.0

package/dist/{dist-C-Sh0MDU.js → dist-6C03DShK.js}

@@ -991,22 +991,22 @@ function createScriptContext(deps) {
 		...onWarning ? { onWarning } : {}
 	};
 }
-const isRecord$2 = (v) => typeof v === "object" && v !== null;
+const isRecord$3 = (v) => typeof v === "object" && v !== null;
 /**
 * $chart 约定的形状校验：JSON content 的 data 含 $chart 键且形状合法 → ChartSpec；
 * 任何畸形（kind 非法 / labels 非字符串数组 / series 项缺数值 data）→ undefined（忽略不炸）。
 */
 function extractChartSpec(data) {
-	if (!isRecord$2(data)) return void 0;
+	if (!isRecord$3(data)) return void 0;
 	const raw = data["$chart"];
-	if (!isRecord$2(raw)) return void 0;
+	if (!isRecord$3(raw)) return void 0;
 	const { kind, labels, series } = raw;
 	if (kind !== "bar" && kind !== "line" && kind !== "pie") return void 0;
 	if (!Array.isArray(labels) || !labels.every((l) => typeof l === "string")) return void 0;
 	if (!Array.isArray(series)) return void 0;
 	const validSeries = [];
 	for (const item of series) {
-		if (!isRecord$2(item) || !Array.isArray(item["data"]) || !item["data"].every((n) => typeof n === "number")) return;
+		if (!isRecord$3(item) || !Array.isArray(item["data"]) || !item["data"].every((n) => typeof n === "number")) return;
 		const name = item["name"];
 		validSeries.push({
 			...typeof name === "string" ? { name } : {},
@@ -1057,7 +1057,7 @@ const actionIntents = /* @__PURE__ */ new Set([
 	"download",
 	"refresh"
 ]);
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function reject(message) {
@@ -1074,7 +1074,7 @@ function isJsonValue(value, depth = 0) {
 	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
 	if (typeof value === "number") return Number.isFinite(value);
 	if (Array.isArray(value)) return value.every((item) => isJsonValue(item, depth + 1));
-	if (!isRecord$1(value)) return false;
+	if (!isRecord$2(value)) return false;
 	return Object.keys(value).every((key) => key !== "__proto__" && key !== "constructor" && isJsonValue(value[key], depth + 1));
 }
 /**
@@ -1084,10 +1084,10 @@ function isJsonValue(value, depth = 0) {
 function assertNode(value, path, depth, counter) {
 	if (depth > MAX_NODE_DEPTH) reject(`A UI spec tree must not nest deeper than ${MAX_NODE_DEPTH} levels`);
 	if (++counter.nodes > MAX_NODES) reject(`A UI spec tree must contain at most ${MAX_NODES} nodes`);
-	if (!isRecord$1(value)) reject(`${path} must be an object`);
+	if (!isRecord$2(value)) reject(`${path} must be an object`);
 	requireString(value["component"], `${path}.component`);
 	if (value["id"] !== void 0) requireString(value["id"], `${path}.id`);
-	if (value["props"] !== void 0 && (!isRecord$1(value["props"]) || !isJsonValue(value["props"]))) reject(`${path}.props must be a JSON object`);
+	if (value["props"] !== void 0 && (!isRecord$2(value["props"]) || !isJsonValue(value["props"]))) reject(`${path}.props must be a JSON object`);
 	const children = value["children"];
 	if (children === void 0) return;
 	if (!Array.isArray(children)) reject(`${path}.children must be an array`);
@@ -1097,7 +1097,7 @@ function assertActions(value) {
 	if (value === void 0) return;
 	if (!Array.isArray(value) || value.length > MAX_ACTIONS) reject(`Surface actions must contain at most ${MAX_ACTIONS} items`);
 	for (const action of value) {
-		if (!isRecord$1(action)) reject("A surface action must be an object");
+		if (!isRecord$2(action)) reject("A surface action must be an object");
 		requireString(action["id"], "Surface action ID");
 		const intent = action["intent"];
 		if (typeof intent !== "string" || !actionIntents.has(intent)) reject("Surface action intent is invalid");
@@ -1113,7 +1113,7 @@ function validateUiSpecNode(value) {
 	return structuredClone(value);
 }
 function assertPatch(value) {
-	if (!isRecord$1(value)) reject("A surface patch operation must be an object");
+	if (!isRecord$2(value)) reject("A surface patch operation must be an object");
 	if (value["op"] !== "replace" && value["op"] !== "merge" && value["op"] !== "append") reject("Surface patch operation is invalid");
 	requireString(value["path"], "Surface patch path");
 	if (!value["path"].startsWith("/")) reject("Surface patch path must be a JSON pointer");
@@ -1121,7 +1121,7 @@ function assertPatch(value) {
 }
 /** Validates an individual event in the framework-neutral surface stream. @experimental */
 function validateUiSpecEvent(value) {
-	if (!isRecord$1(value) || typeof value["type"] !== "string") reject("A UI surface event must have a type");
+	if (!isRecord$2(value) || typeof value["type"] !== "string") reject("A UI surface event must have a type");
 	if (value["runId"] !== void 0) requireString(value["runId"], "Surface event run ID");
 	switch (value["type"]) {
 		case "open":
@@ -1179,16 +1179,74 @@ function validateUiSpecEvent(value) {
 }
 /** Extracts validated surface stream events from structured tool output. @experimental */
 function extractUiSpecEvents(data) {
-	if (!isRecord$1(data) || data["$surface"] === void 0) return [];
+	if (!isRecord$2(data) || data["$surface"] === void 0) return [];
 	const raw = data["$surface"];
 	return (Array.isArray(raw) ? raw : [raw]).map((event) => validateUiSpecEvent(event));
 }
+/** 跨会话表单填写值在 `user:{userId}` scope 下的 key（FR-5.7） @experimental */
+const FORM_VALUES_KEY = "formValues";
+/**
+* 跨会话稳定的字段标识（FR-5.6）。必须带技能名：
+* 只有字段名时，两个技能各自的 `email` 会互相串号。
+* @experimental
+*/
+function formFieldKey(skillName, fieldName) {
+	return `${skillName}#${fieldName}`;
+}
+/** memory 里的原始值形状不受控（宿主可能手改文件），逐条过滤而不是整体信任 @experimental */
+function readFormValues(raw) {
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return {};
+	const out = {};
+	for (const [key, entry] of Object.entries(raw)) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const record = entry;
+		if (typeof record.ts !== "number" || !("value" in record)) continue;
+		out[key] = {
+			value: record.value,
+			ts: record.ts
+		};
+	}
+	return out;
+}
+/** 合并本次提交并按上限裁剪最旧（FR-5.12） @experimental */
+function putFormValues(current, updates, limit) {
+	const merged = {
+		...current,
+		...updates
+	};
+	const keys = Object.keys(merged);
+	if (limit <= 0) return {};
+	if (keys.length <= limit) return merged;
+	const kept = keys.sort((a, b) => merged[a].ts - merged[b].ts).slice(keys.length - limit);
+	return Object.fromEntries(kept.map((key) => [key, merged[key]]));
+}
+/** 清除单个字段；不传 fieldKey 即全部清除（FR-5.11） @experimental */
+function clearFormValues(current, fieldKey) {
+	if (fieldKey === void 0) return {};
+	const { [fieldKey]: _removed, ...rest } = current;
+	return rest;
+}
+/**
+* 宿主侧的清除入口（FR-5.11）：设置面板的「清除填写历史」直接调它，
+* 不必自己知道 scope 与 key 的约定。
+* @experimental
+*/
+async function clearStoredFormValues(memory, userId, fieldKey) {
+	const scope = `user:${userId}`;
+	if (fieldKey === void 0) {
+		await memory.delete(scope, FORM_VALUES_KEY);
+		return;
+	}
+	const next = clearFormValues(readFormValues(await memory.get(scope, FORM_VALUES_KEY)), fieldKey);
+	await memory.set(scope, FORM_VALUES_KEY, next);
+}
 /**
 * JsonSchema → 表单模型：按 properties 生成字段，required 标记必填；
 * providedArgs 已有的值作为 defaultValue 预填（表单只为补齐缺失项服务）。
 * type 映射：string→text、number/integer→number、boolean→boolean、enum→select、其余→textarea。
+* 传入 skillName 时给每个字段带上跨会话稳定的 `fieldKey`（FR-5.6）。
 */
-function schemaToForm(schema, providedArgs) {
+function schemaToForm(schema, providedArgs, options) {
 	const required = new Set(Array.isArray(schema.required) ? schema.required : []);
 	const fields = [];
 	for (const [name, prop] of Object.entries(schema.properties ?? {})) {
@@ -1199,6 +1257,7 @@ function schemaToForm(schema, providedArgs) {
 			type: mapFieldType(prop),
 			...required.has(name) ? { required: true } : {},
 			...typeof prop.description === "string" ? { description: prop.description } : {},
+			...options?.skillName !== void 0 ? { fieldKey: formFieldKey(options.skillName, name) } : {},
 			...provided !== void 0 ? { defaultValue: provided } : prop.default !== void 0 ? { defaultValue: prop.default } : {}
 		};
 		if (Array.isArray(prop.enum)) field.options = prop.enum.map((v) => ({
@@ -1328,6 +1387,36 @@ var TraceRecorder = class {
 		return [...this.#events];
 	}
 };
+const isRecord$1 = (v) => typeof v === "object" && v !== null;
+/** 工具结果可经 `$todo` 标记记入 trace 的事件类型；其余类型不接受，防止工具源伪造 run.* */
+const TODO_TRACE_TYPES = /* @__PURE__ */ new Set([
+	"todo.created",
+	"todo.updated",
+	"todo.cleared"
+]);
+/**
+* `$todo` 约定的形状校验：JSON content 的 data 含 `$todo` 键（单条或数组）→ trace 事件。
+*
+* 与 `$chart` / `$surface` 同一条既有通道——待办清单的状态机全部在 `@webskill/agent`，
+* runtime 只认这三个事件类型名，不含任何计划态逻辑。畸形条目忽略不炸。
+* @experimental
+*/
+function extractTodoTraceEvents(data) {
+	if (!isRecord$1(data) || data["$todo"] === void 0) return [];
+	const raw = data["$todo"];
+	const entries = Array.isArray(raw) ? raw : [raw];
+	const events = [];
+	for (const entry of entries) {
+		if (!isRecord$1(entry)) continue;
+		const { type, ...rest } = entry;
+		if (typeof type !== "string" || !TODO_TRACE_TYPES.has(type)) continue;
+		events.push({
+			type,
+			data: rest
+		});
+	}
+	return events;
+}
 const RUN_SNAPSHOT_SCHEMA_VERSION = 2;
 /** @experimental */
 function isUnsupportedRunSnapshot(entry) {
@@ -1519,6 +1608,7 @@ var AgentLoop = class {
 			toolTimeoutMs: config.toolTimeoutMs ?? 3e4,
 			toolResultMaxBytes: config.toolResultMaxBytes ?? 1e5,
 			paramHistoryLimit: config.paramHistoryLimit ?? 50,
+			formValueLimit: config.formValueLimit ?? 100,
 			temperature: config.temperature,
 			renderResult: config.renderResult
 		};
@@ -2180,6 +2270,7 @@ var AgentLoop = class {
 					type: "chart",
 					chart
 				});
+				for (const todo of extractTodoTraceEvents(item.data)) state.trace.record(todo.type, { data: todo.data });
 				try {
 					for (const event of extractUiSpecEvents(item.data)) await this.#renderSurface(state, event);
 				} catch (e) {
@@ -2200,7 +2291,7 @@ var AgentLoop = class {
 					durationMs
 				}
 			});
-			this.#emitTool(state, "failed", call);
+			this.#emitTool(state, "failed", call, result.error?.code);
 		}
 		for (const artifact of result.artifacts ?? []) state.trace.record("artifact.created", { data: {
 			artifactId: artifact.id,
@@ -2375,7 +2466,7 @@ var AgentLoop = class {
 	* 集合挂在 LoopState 上、**不写进快照**：写进快照会让跨进程恢复的
 	* 消费者永远收不到它本来就没见过的事件。
 	*/
-	#emitTool(state, status, call) {
+	#emitTool(state, status, call, errorCode) {
 		const key = `${call.id}:${status}`;
 		if (state.emittedToolEvents.has(key)) return;
 		state.emittedToolEvents.add(key);
@@ -2389,7 +2480,8 @@ var AgentLoop = class {
 				status,
 				name: call.name,
 				callId: call.id,
-				args: summarizeArgs(call.arguments)
+				args: summarizeArgs(call.arguments),
+				...errorCode !== void 0 ? { errorCode } : {}
 			}
 		});
 	}
@@ -2661,11 +2753,13 @@ var AgentLoop = class {
 		let args = call.arguments;
 		const missing = (def.inputSchema?.required ?? []).filter((key) => args[key] === void 0);
 		if (missing.length > 0 && this.#deps.uiBridge && this.#policy.missingParams === "user" && def.inputSchema) try {
+			const fields = schemaToForm(def.inputSchema, args, { skillName });
+			await this.#attachFormSuggestions(fields, state);
 			const value = await this.#interact(state, {
 				type: "form",
 				id: this.#nextInteractionId(state),
 				title: `Missing parameters for ${call.name}`,
-				fields: schemaToForm(def.inputSchema, args)
+				fields
 			}, {
 				tool: call.name,
 				missing
@@ -2837,6 +2931,47 @@ var AgentLoop = class {
 			});
 			return history.slice(-limit);
 		});
+		await this.#rememberFormValues(state, request, value);
+	}
+	/**
+	* 跨会话字段值的写入（FR-5.6/5.12）。与 `paramHistory` 双写而不是合并：
+	* 那边是按时间的追加序列（运行观测），这边是按字段的最新值（召回），形态不同。
+	*/
+	async #rememberFormValues(state, request, value) {
+		const autofill = this.#deps.formAutofill;
+		if (!autofill || request.type !== "form") return;
+		if (typeof value !== "object" || value === null) return;
+		const submitted = value;
+		const ts = Date.parse(state.now());
+		const updates = {};
+		for (const field of request.fields) {
+			if (field.fieldKey === void 0) continue;
+			const next = submitted[field.name];
+			if (next === void 0 || next === "") continue;
+			updates[field.fieldKey] = {
+				value: next,
+				ts
+			};
+		}
+		if (Object.keys(updates).length === 0) return;
+		await this.#memoryMutate(`user:${autofill.userId}`, FORM_VALUES_KEY, state, (current) => putFormValues(readFormValues(current), updates, this.#config.formValueLimit));
+	}
+	/**
+	* 召回（FR-5.8）：命中的历史值挂在 `suggestion` 上，**绝不写进 `defaultValue`**——
+	* 后者会被渲染器直接填进控件，等于静默预填（AC-5.6 禁止）。
+	*/
+	async #attachFormSuggestions(fields, state) {
+		const autofill = this.#deps.formAutofill;
+		if (!autofill) return;
+		const stored = readFormValues(await this.#memoryGet(`user:${autofill.userId}`, FORM_VALUES_KEY, state));
+		for (const field of fields) {
+			if (field.fieldKey === void 0 || field.defaultValue !== void 0) continue;
+			const hit = stored[field.fieldKey];
+			if (hit !== void 0) field.suggestion = {
+				value: hit.value,
+				ts: hit.ts
+			};
+		}
 	}
 };
 /**
@@ -2977,6 +3112,7 @@ var WebSkillRuntime = class {
 			hooks: this.#deps.hooks,
 			eventBus: this.#events,
 			longTerm: this.#deps.longTerm,
+			formAutofill: this.#deps.formAutofill,
 			externalTools: this.#deps.externalTools,
 			skillProviders: this.#deps.skillProviders,
 			catalogFilter: this.#deps.catalogFilter,
@@ -3083,6 +3219,7 @@ var WebSkillRuntime = class {
 			hooks: this.#deps.hooks,
 			eventBus: this.#events,
 			longTerm: this.#deps.longTerm,
+			formAutofill: this.#deps.formAutofill,
 			externalTools: this.#deps.externalTools,
 			skillProviders: this.#deps.skillProviders,
 			catalogFilter: this.#deps.catalogFilter,
@@ -3839,12 +3976,15 @@ function summarizeToolCalls(run) {
 		if (typeof name !== "string" || typeof callId !== "string") continue;
 		const args = event.data?.["args"];
 		const durationMs = event.data?.["durationMs"];
+		const errorCode = event.data?.["code"];
 		calls.push({
 			callId,
 			name,
 			status: event.type === "tool.completed" ? "completed" : "failed",
 			...typeof args === "string" ? { args } : {},
-			...typeof durationMs === "number" ? { durationMs } : {}
+			...typeof durationMs === "number" ? { durationMs } : {},
+			...typeof errorCode === "string" ? { errorCode } : {},
+			...event.type === "tool.failed" && typeof event.message === "string" ? { errorMessage: event.message } : {}
 		});
 	}
 	return calls;
@@ -4036,4 +4176,4 @@ var FsSessionStore = class {
 };
 
 //#endregion
-export { createScriptContext as A, networkUrlHost as B, RUN_TRACE_SCHEMA_VERSION as C, WebSkillRuntime as D, TraceRecorder as E, fromVercelStreamPart as F, resolveToolName as G, normalizeToolContent as H, isNetworkAllowed as I, toLlmToolSpec as J, schemaToForm as K, isUnsupportedRunSnapshot as L, extractChartSpec as M, extractUiSpecEvents as N, bridgeError as O, fromVercelResult as P, mergeCatalogEntries as R, RUN_SNAPSHOT_SCHEMA_VERSION as S, SerializingMemoryStore as T, normalizeToolError as U, normalizeErrorCode as V, parseBridgeRequest as W, validateUiSpecEvent as X, toVercelToolSpecs as Y, validateUiSpecNode as Z, OpenAiCompatibleClient as _, AnthropicClient as a, READ_SKILL_FILE_TOOL as b, FS_SESSION_PAGE_SIZE as c, FsRunSnapshotStore as d, FsRunTraceStore as f, HookRunner as g, GoogleGenAiClient as h, AgentLoop as i, createWebSkillApi as j, buildRenderResult as k, FsArtifactStore as l, FullDisclosureRouter as m, ASK_USER_TOOL as n, CapabilityApproval as o, FsSessionStore as p, summarizeToolCalls as q, ASK_USER_TOOL_NAME as r, EventBus as s, ASK_USER_INPUT_SCHEMA as t, FsMemoryStore as u, ProgressiveRouter as v, SESSION_SCHEMA_VERSION as w, READ_SKILL_FILE_TOOL_NAME as x, READ_SKILL_FILE_INPUT_SCHEMA as y, networkPolicyLibSource as z };
+export { schemaToForm as $, buildRenderResult as A, fromVercelStreamPart as B, RUN_SNAPSHOT_SCHEMA_VERSION as C, TraceRecorder as D, SerializingMemoryStore as E, extractChartSpec as F, networkUrlHost as G, isUnsupportedRunSnapshot as H, extractTodoTraceEvents as I, normalizeToolError as J, normalizeErrorCode as K, extractUiSpecEvents as L, clearStoredFormValues as M, createScriptContext as N, WebSkillRuntime as O, createWebSkillApi as P, resolveToolName as Q, formFieldKey as R, READ_SKILL_FILE_TOOL_NAME as S, SESSION_SCHEMA_VERSION as T, mergeCatalogEntries as U, isNetworkAllowed as V, networkPolicyLibSource as W, putFormValues as X, parseBridgeRequest as Y, readFormValues as Z, HookRunner as _, AnthropicClient as a, READ_SKILL_FILE_INPUT_SCHEMA as b, FORM_VALUES_KEY as c, FsMemoryStore as d, summarizeToolCalls as et, FsRunSnapshotStore as f, GoogleGenAiClient as g, FullDisclosureRouter as h, AgentLoop as i, validateUiSpecNode as it, clearFormValues as j, bridgeError as k, FS_SESSION_PAGE_SIZE as l, FsSessionStore as m, ASK_USER_TOOL as n, toVercelToolSpecs as nt, CapabilityApproval as o, FsRunTraceStore as p, normalizeToolContent as q, ASK_USER_TOOL_NAME as r, validateUiSpecEvent as rt, EventBus as s, ASK_USER_INPUT_SCHEMA as t, toLlmToolSpec as tt, FsArtifactStore as u, OpenAiCompatibleClient as v, RUN_TRACE_SCHEMA_VERSION as w, READ_SKILL_FILE_TOOL as x, ProgressiveRouter as y, fromVercelResult as z };