@webskill/sdk 0.6.0 → 0.7.0

package/dist/{dist-DusANsrn.js → dist-D0qW6e40.js}

@@ -12,7 +12,7 @@ const DEFS_KEY = "$defs";
 const SELF_REF = "#";
 const NODE_NAME = "Node";
 const COMPONENT_PREFIX = "Component_";
-/** 值为「名称 → 子 schema」的映射。 */
+/** 值为「名称 → 子 schema」的映射。包内导出：vendorSchema 要用同一套下钻规则（两套会漂移）。 */
 const SCHEMA_MAP_KEYS = /* @__PURE__ */ new Set([
 	"properties",
 	"patternProperties",
@@ -41,11 +41,11 @@ const SCHEMA_KEYS = /* @__PURE__ */ new Set([
 	"then",
 	"else"
 ]);
-function isRecord$4(value) {
+function isRecord$6(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isSelfRef(value) {
-	return isRecord$4(value) && value["$ref"] === SELF_REF;
+	return isRecord$6(value) && value["$ref"] === SELF_REF;
 }
 /**
 * 按 JSON Schema 关键字下降到子 schema。
@@ -55,7 +55,7 @@ function isSelfRef(value) {
 function forEachSubSchema(node, visit) {
 	for (const [key, value] of Object.entries(node)) {
 		if (SCHEMA_MAP_KEYS.has(key)) {
-			if (isRecord$4(value)) for (const name of Object.keys(value)) visit(value[name], [key, name]);
+			if (isRecord$6(value)) for (const name of Object.keys(value)) visit(value[name], [key, name]);
 			continue;
 		}
 		if (SCHEMA_LIST_KEYS.has(key)) {
@@ -74,7 +74,7 @@ function pathKey(path) {
 * `#` 解析到最近的带 `$id` 的祖先；没有则是文档根。
 */
 function collectSelfRefRoots(node, path, resourceRoot, out) {
-	if (!isRecord$4(node)) return;
+	if (!isRecord$6(node)) return;
 	if (isSelfRef(node)) {
 		out.set(pathKey(resourceRoot), resourceRoot);
 		return;
@@ -87,7 +87,7 @@ function collectSelfRefRoots(node, path, resourceRoot, out) {
 function getAt(schema, path) {
 	let current = schema;
 	for (const segment of path) if (Array.isArray(current) && typeof segment === "number") current = current[segment];
-	else if (isRecord$4(current) && typeof segment === "string") current = current[segment];
+	else if (isRecord$6(current) && typeof segment === "string") current = current[segment];
 	else return void 0;
 	return current;
 }
@@ -113,7 +113,7 @@ function setAt(schema, path, replacement) {
 * 正是严格解析器无法解析 `#` 的直接原因。
 */
 function rewriteSelfRefs(node, target, depth) {
-	if (!isRecord$4(node)) return node;
+	if (!isRecord$6(node)) return node;
 	if (depth > 8) throw new WebSkillError("TOOL_SCHEMA_UNAVAILABLE", `Tool schema nesting exceeds 8 levels; cannot produce a portable form`);
 	if (isSelfRef(node)) {
 		const rest = {};
@@ -126,7 +126,7 @@ function rewriteSelfRefs(node, target, depth) {
 	const result = {};
 	for (const [key, value] of Object.entries(node)) {
 		if (key === "$id" || key === "$schema") continue;
-		if (SCHEMA_MAP_KEYS.has(key) && isRecord$4(value)) {
+		if (SCHEMA_MAP_KEYS.has(key) && isRecord$6(value)) {
 			const mapped = {};
 			for (const [name, child] of Object.entries(value)) mapped[name] = rewriteSelfRefs(child, target, depth + 1);
 			result[key] = mapped;
@@ -164,8 +164,8 @@ function toPortableToolSchema(schema) {
 	if (roots.size > 1) throw new WebSkillError("TOOL_SCHEMA_UNAVAILABLE", "Tool schema contains self references in more than one schema resource; cannot produce a portable form");
 	const rootPath = [...roots.values()][0] ?? [];
 	const resource = getAt(schema, rootPath);
-	if (!isRecord$4(resource)) return schema;
-	const existingDefs = isRecord$4(schema[DEFS_KEY]) ? schema[DEFS_KEY] : void 0;
+	if (!isRecord$6(resource)) return schema;
+	const existingDefs = isRecord$6(schema[DEFS_KEY]) ? schema[DEFS_KEY] : void 0;
 	const taken = new Set(Object.keys(existingDefs ?? {}));
 	const nodeName = uniqueName(NODE_NAME, taken);
 	taken.add(nodeName);
@@ -196,6 +196,136 @@ function toPortableToolSchema(schema) {
 		}
 	};
 }
+/** 各家都认的基础关键字。Google `FunctionDeclaration.parameters` 是其中最窄的一家。 */
+const BASE_KEYWORDS = /* @__PURE__ */ new Set([
+	"type",
+	"description",
+	"title",
+	"default",
+	"enum",
+	"const",
+	"properties",
+	"required",
+	"items",
+	"anyOf",
+	"oneOf",
+	"minimum",
+	"maximum",
+	"minItems",
+	"maxItems",
+	"nullable",
+	"format"
+]);
+/** 宽松侧：保留 0.6.0 的透传行为，本版不主动收紧（没有实证之前收紧只会制造新的破坏） */
+const PERMISSIVE_KEYWORDS = /* @__PURE__ */ new Set([
+	...BASE_KEYWORDS,
+	"additionalProperties",
+	"patternProperties",
+	"dependentSchemas",
+	"definitions",
+	"$defs",
+	"$ref",
+	"$schema",
+	"$id",
+	"allOf",
+	"not",
+	"if",
+	"then",
+	"else",
+	"prefixItems",
+	"additionalItems",
+	"unevaluatedItems",
+	"unevaluatedProperties",
+	"contains",
+	"propertyNames",
+	"exclusiveMinimum",
+	"exclusiveMaximum",
+	"multipleOf",
+	"minLength",
+	"maxLength",
+	"pattern",
+	"uniqueItems",
+	"examples",
+	"readOnly",
+	"writeOnly",
+	"deprecated"
+]);
+const OPENAI_SCHEMA_PROFILE = {
+	id: "openai-compatible",
+	allowedKeywords: PERMISSIVE_KEYWORDS,
+	supportsRefs: true
+};
+const ANTHROPIC_SCHEMA_PROFILE = {
+	id: "anthropic",
+	allowedKeywords: PERMISSIVE_KEYWORDS,
+	supportsRefs: true
+};
+/**
+* Google Gen AI 的 `FunctionDeclaration.parameters` 收到 `additionalProperties`
+* 直接回 400 `Unknown name "additionalProperties"`，且不解析 `$ref` / `$defs`。
+*/
+const GOOGLE_SCHEMA_PROFILE = {
+	id: "google",
+	allowedKeywords: BASE_KEYWORDS,
+	supportsRefs: false
+};
+function isRecord$5(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** 只在 schema 位置上找 `$ref`：enum / const / default 里的同名键是字面数据，不是引用 */
+function containsRef(node) {
+	if (Array.isArray(node)) return node.some(containsRef);
+	if (!isRecord$5(node)) return false;
+	if (typeof node["$ref"] === "string") return true;
+	for (const [key, value] of Object.entries(node)) {
+		if (SCHEMA_MAP_KEYS.has(key)) {
+			if (isRecord$5(value) && Object.values(value).some(containsRef)) return true;
+			continue;
+		}
+		if (SCHEMA_LIST_KEYS.has(key)) {
+			if (Array.isArray(value) && value.some(containsRef)) return true;
+			continue;
+		}
+		if (SCHEMA_KEYS.has(key) && containsRef(value)) return true;
+	}
+	return false;
+}
+function sanitizeNode(node, profile) {
+	if (Array.isArray(node)) return node.map((item) => sanitizeNode(item, profile));
+	if (!isRecord$5(node)) return node;
+	const out = {};
+	for (const [key, value] of Object.entries(node)) {
+		if (!profile.allowedKeywords.has(key)) continue;
+		if (SCHEMA_MAP_KEYS.has(key) && isRecord$5(value)) {
+			const mapped = {};
+			for (const [name, child] of Object.entries(value)) mapped[name] = sanitizeNode(child, profile);
+			out[key] = mapped;
+			continue;
+		}
+		if (SCHEMA_LIST_KEYS.has(key) && Array.isArray(value)) {
+			out[key] = value.map((child) => sanitizeNode(child, profile));
+			continue;
+		}
+		if (SCHEMA_KEYS.has(key)) {
+			out[key] = sanitizeNode(value, profile);
+			continue;
+		}
+		out[key] = value;
+	}
+	return out;
+}
+/**
+* 按供应商 profile 清洗出站 schema。产出新对象，不修改入参（工具源可能复用同一个实例）。
+*
+* 这是**传输层适配**，只应在出站请求体上调用；不要下沉到 AgentLoop，
+* 否则 trace / eventBus 观测到的 schema 会与技能作者写的不一致。
+*
+* @throws WebSkillError `TOOL_SCHEMA_UNAVAILABLE` — schema 依赖该供应商不支持的引用
+*/
+function sanitizeForVendor(schema, profile, toolName) {
+	if (!profile.supportsRefs && containsRef(schema)) throw new WebSkillError("TOOL_SCHEMA_UNAVAILABLE", `Tool "${toolName}" requires $ref support that provider "${profile.id}" does not accept`);
+	return sanitizeNode(schema, profile);
+}
 function createSseFrameReader() {
 	let buffer = "";
 	let data = [];
@@ -307,7 +437,7 @@ const toOpenAiTools = (tools) => tools.map((tool) => ({
 	function: {
 		name: tool.name,
 		...tool.description ? { description: tool.description } : {},
-		parameters: toPortableToolSchema(tool.inputSchema)
+		parameters: sanitizeForVendor(toPortableToolSchema(tool.inputSchema), OPENAI_SCHEMA_PROFILE, tool.name)
 	}
 }));
 const errorMessage$2 = (e) => e instanceof Error ? e.message : String(e);
@@ -564,7 +694,7 @@ function toAnthropicMessages(messages) {
 const toAnthropicTools = (tools) => tools.map((tool) => ({
 	name: tool.name,
 	...tool.description ? { description: tool.description } : {},
-	input_schema: toPortableToolSchema(tool.inputSchema)
+	input_schema: sanitizeForVendor(toPortableToolSchema(tool.inputSchema), ANTHROPIC_SCHEMA_PROFILE, tool.name)
 }));
 /** Anthropic Messages API 客户端（零依赖 fetch；Node/浏览器通用） */
 var AnthropicClient = class {
@@ -807,7 +937,7 @@ function toGenAiContents(messages) {
 const toGenAiTools = (tools) => [{ functionDeclarations: tools.map((tool) => ({
 	name: tool.name,
 	...tool.description ? { description: tool.description } : {},
-	parameters: toPortableToolSchema(tool.inputSchema)
+	parameters: sanitizeForVendor(toPortableToolSchema(tool.inputSchema), GOOGLE_SCHEMA_PROFILE, tool.name)
 })) }];
 /** Google GenAI（generateContent / streamGenerateContent）客户端（零依赖 fetch） */
 var GoogleGenAiClient = class {
@@ -1260,22 +1390,22 @@ function createScriptContext(deps) {
 		...onWarning ? { onWarning } : {}
 	};
 }
-const isRecord$3 = (v) => typeof v === "object" && v !== null;
+const isRecord$4 = (v) => typeof v === "object" && v !== null;
 /**
 * $chart 约定的形状校验：JSON content 的 data 含 $chart 键且形状合法 → ChartSpec；
 * 任何畸形（kind 非法 / labels 非字符串数组 / series 项缺数值 data）→ undefined（忽略不炸）。
 */
 function extractChartSpec(data) {
-	if (!isRecord$3(data)) return void 0;
+	if (!isRecord$4(data)) return void 0;
 	const raw = data["$chart"];
-	if (!isRecord$3(raw)) return void 0;
+	if (!isRecord$4(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$3(item) || !Array.isArray(item["data"]) || !item["data"].every((n) => typeof n === "number")) return;
+		if (!isRecord$4(item) || !Array.isArray(item["data"]) || !item["data"].every((n) => typeof n === "number")) return;
 		const name = item["name"];
 		validSeries.push({
 			...typeof name === "string" ? { name } : {},
@@ -1293,13 +1423,18 @@ function extractChartSpec(data) {
 /**
 * 默认的结果渲染构造：run 内收集的 renderBlocks（chart 等）在前，
 * LLM 最终输出 → markdown block，run.artifacts → file blocks 在后；summary 取 terminationReason。
+* 注入 output block 时一并记下它的下标（S7），供消费方按来源去重。
 */
 function buildRenderResult(run, output, renderBlocks = []) {
 	const blocks = [...renderBlocks];
-	if (output.trim() !== "") blocks.push({
-		type: "markdown",
-		text: output
-	});
+	let outputBlockIndex;
+	if (output.trim() !== "") {
+		outputBlockIndex = blocks.length;
+		blocks.push({
+			type: "markdown",
+			text: output
+		});
+	}
 	for (const artifact of run.artifacts) blocks.push({
 		type: "file",
 		path: artifact.path,
@@ -1310,7 +1445,8 @@ function buildRenderResult(run, output, renderBlocks = []) {
 		runId: run.id,
 		summary: run.terminationReason,
 		blocks,
-		artifacts: run.artifacts
+		artifacts: run.artifacts,
+		...outputBlockIndex === void 0 ? {} : { outputBlockIndex }
 	};
 }
 const MAX_SURFACE_BYTES = 256 * 1024;
@@ -1326,7 +1462,7 @@ const actionIntents = /* @__PURE__ */ new Set([
 	"download",
 	"refresh"
 ]);
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function reject(message) {
@@ -1343,7 +1479,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$2(value)) return false;
+	if (!isRecord$3(value)) return false;
 	return Object.keys(value).every((key) => key !== "__proto__" && key !== "constructor" && isJsonValue(value[key], depth + 1));
 }
 /**
@@ -1353,10 +1489,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$2(value)) reject(`${path} must be an object`);
+	if (!isRecord$3(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$2(value["props"]) || !isJsonValue(value["props"]))) reject(`${path}.props must be a JSON object`);
+	if (value["props"] !== void 0 && (!isRecord$3(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`);
@@ -1366,7 +1502,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$2(action)) reject("A surface action must be an object");
+		if (!isRecord$3(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");
@@ -1382,7 +1518,7 @@ function validateUiSpecNode(value) {
 	return structuredClone(value);
 }
 function assertPatch(value) {
-	if (!isRecord$2(value)) reject("A surface patch operation must be an object");
+	if (!isRecord$3(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");
@@ -1390,7 +1526,7 @@ function assertPatch(value) {
 }
 /** Validates an individual event in the framework-neutral surface stream. @experimental */
 function validateUiSpecEvent(value) {
-	if (!isRecord$2(value) || typeof value["type"] !== "string") reject("A UI surface event must have a type");
+	if (!isRecord$3(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":
@@ -1448,7 +1584,7 @@ function validateUiSpecEvent(value) {
 }
 /** Extracts validated surface stream events from structured tool output. @experimental */
 function extractUiSpecEvents(data) {
-	if (!isRecord$2(data) || data["$surface"] === void 0) return [];
+	if (!isRecord$3(data) || data["$surface"] === void 0) return [];
 	const raw = data["$surface"];
 	return (Array.isArray(raw) ? raw : [raw]).map((event) => validateUiSpecEvent(event));
 }
@@ -1767,7 +1903,7 @@ var TraceRecorder = class {
 		return [...this.#events];
 	}
 };
-const isRecord$1 = (v) => typeof v === "object" && v !== null;
+const isRecord$2 = (v) => typeof v === "object" && v !== null;
 /** 工具结果可经 `$todo` 标记记入 trace 的事件类型；其余类型不接受，防止工具源伪造 run.* */
 const TODO_TRACE_TYPES = /* @__PURE__ */ new Set([
 	"todo.created",
@@ -1782,12 +1918,12 @@ const TODO_TRACE_TYPES = /* @__PURE__ */ new Set([
 * @experimental
 */
 function extractTodoTraceEvents(data) {
-	if (!isRecord$1(data) || data["$todo"] === void 0) return [];
+	if (!isRecord$2(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;
+		if (!isRecord$2(entry)) continue;
 		const { type, ...rest } = entry;
 		if (typeof type !== "string" || !TODO_TRACE_TYPES.has(type)) continue;
 		events.push({
@@ -1797,6 +1933,38 @@ function extractTodoTraceEvents(data) {
 	}
 	return events;
 }
+const isRecord$1 = (v) => typeof v === "object" && v !== null;
+/**
+* `$skillCandidate` 约定的形状校验：JSON content 的 data 含合法 `$skillCandidate` 键 → 候选载荷。
+*
+* 与 `$chart` / `$todo` / `$surface` 同一条既有通道，是第四个。
+* 候选的生成与存储全部在 `@webskill/agent`，runtime 只认这个形状，畸形忽略不炸。
+* @experimental
+*/
+function extractSkillCandidate(data) {
+	if (!isRecord$1(data)) return void 0;
+	const raw = data["$skillCandidate"];
+	if (!isRecord$1(raw)) return void 0;
+	const { id, name } = raw;
+	if (typeof id !== "string" || id === "" || typeof name !== "string" || name === "") return void 0;
+	return {
+		id,
+		name
+	};
+}
+/**
+* Agent loop 的运行上限默认值。**全仓唯一来源**（S8）。
+*
+* 在 0.7.0 之前这三个数字在 `AgentLoop` 的构造与 ui-kit 的 `defaultRuntimeConfig()`
+* 里各写了一遍。两份值今天恰好相等，所以不出事；一旦其中一处被改，
+* 「恢复默认值」会恢复到 agent loop 根本不用的值——验收绿、行为错。
+* @stable
+*/
+const DEFAULT_LOOP_LIMITS = {
+	maxTurns: 10,
+	totalTimeoutMs: 12e4,
+	toolTimeoutMs: 3e4
+};
 const RUN_SNAPSHOT_SCHEMA_VERSION = 2;
 /** @experimental */
 function isUnsupportedRunSnapshot(entry) {
@@ -1975,6 +2143,20 @@ const redactFileValue = (value) => {
 	return rest;
 };
 /**
+* 触顶失败的结构化细节（FR-21.2）。由终止原因推出上限字段，而不是在每个终止点各写一遍——
+* 终止点有四个，写四遍就迟早有一处对不上。
+*/
+const limitDetails = (state, reason) => {
+	if (reason === "timeout") return {
+		limit: "totalTimeoutMs",
+		value: state.totalTimeoutMs
+	};
+	if (reason === "max-turns") return {
+		limit: "maxTurns",
+		value: state.maxTurns
+	};
+};
+/**
 * 多轮 Agent 循环。
 * 工具失败一律转为 ToolResult{ok:false} 回喂 LLM 继续循环；
 * 缺参/确认/提问经 UiBridge 行内 await 暂停恢复；取消/超时/LLM 异常/护栏超限才终止 run。
@@ -1993,9 +2175,9 @@ var AgentLoop = class {
 			artifactStore: deps.artifactStore ?? new MemoryArtifactStore()
 		};
 		this.#config = {
-			maxTurns: config.maxTurns ?? 10,
-			totalTimeoutMs: config.totalTimeoutMs ?? 12e4,
-			toolTimeoutMs: config.toolTimeoutMs ?? 3e4,
+			maxTurns: config.maxTurns ?? DEFAULT_LOOP_LIMITS.maxTurns,
+			totalTimeoutMs: config.totalTimeoutMs ?? DEFAULT_LOOP_LIMITS.totalTimeoutMs,
+			toolTimeoutMs: config.toolTimeoutMs ?? DEFAULT_LOOP_LIMITS.toolTimeoutMs,
 			toolResultMaxBytes: config.toolResultMaxBytes ?? 1e5,
 			paramHistoryLimit: config.paramHistoryLimit ?? 50,
 			toolCallingDisabled: config.toolCallingDisabled ?? false,
@@ -2210,6 +2392,7 @@ var AgentLoop = class {
 					return finish("failed", "llm-error", messageOf(e), code);
 				}
 				const responseText = partsToText(response.content);
+				if (!llm.stream && responseText !== "") await this.#deps.uiBridge?.onTextDelta?.(state.runId, responseText);
 				trace.record("llm.response", { data: {
 					turn,
 					hasToolCalls: Boolean(response.toolCalls?.length),
@@ -2279,7 +2462,8 @@ var AgentLoop = class {
 			message: output,
 			data: {
 				reason,
-				...errorCode ? { code: errorCode } : {}
+				...errorCode ? { code: errorCode } : {},
+				...limitDetails(state, reason) ?? {}
 			}
 		});
 		const bridge = this.#deps.uiBridge;
@@ -2721,6 +2905,12 @@ var AgentLoop = class {
 					chart
 				});
 				for (const todo of extractTodoTraceEvents(item.data)) state.trace.record(todo.type, { data: todo.data });
+				const candidate = extractSkillCandidate(item.data);
+				if (candidate) try {
+					await this.#deps.uiBridge?.onSkillCandidate?.(state.runId, candidate);
+				} catch (e) {
+					state.trace.record("run.warning", { message: `Skill candidate was not handed off to the UI: ${messageOf(e)}` });
+				}
 				try {
 					for (const event of extractUiSpecEvents(item.data)) await this.#renderSurface(state, event);
 				} catch (e) {
@@ -3332,7 +3522,8 @@ var AgentLoop = class {
 				if (fresh.length > 0) result.artifacts = [...result.artifacts ?? [], ...fresh];
 			}
 			await this.#bumpSkillStat(skillName, result.ok ? "successes" : "failures", state);
-			if (!result.ok) await this.#reportSkillFailure(skillName, state, {
+			if (result.ok) await this.#reportSkillSuccess(skillName, state);
+			else await this.#reportSkillFailure(skillName, state, {
 				code: result.error?.code ?? "TOOL_EXECUTION_FAILED",
 				message: result.error?.message ?? `Tool "${call.name}" returned a failure result`
 			});
@@ -3369,6 +3560,22 @@ var AgentLoop = class {
 			state.trace.record("run.warning", { message: `Skill failure report for "${skillName}" was not recorded: ${messageOf(e)}` });
 		}
 	}
+	/**
+	* D-5 技能成功上报：把失败计数从「累计」变成「连续」的那半边信号。
+	* 与失败上报同样是可选 port，未注入即整段跳过。
+	*/
+	async #reportSkillSuccess(skillName, state) {
+		const report = this.#deps.skillOutcomeReporter?.onSkillSucceeded;
+		if (report === void 0) return;
+		try {
+			await report.call(this.#deps.skillOutcomeReporter, {
+				skillName,
+				runId: state.runId
+			});
+		} catch (e) {
+			state.trace.record("run.warning", { message: `Skill success report for "${skillName}" was not recorded: ${messageOf(e)}` });
+		}
+	}
 	/** context.confirm 触发点：默认真实询问；auto-approve 直通；无 bridge 降级直通 + warning */
 	async #confirm(message, state) {
 		if (this.#policy.confirmations === "auto-approve") return true;
@@ -4972,4 +5179,4 @@ var FsSessionStore = class {
 };
 
 //#endregion
-export { listSkillScripts as $, TraceRecorder as A, buildRenderResult as B, READ_SKILL_FILE_INPUT_SCHEMA as C, validateUiSpecEvent as Ct, RUN_TRACE_SCHEMA_VERSION as D, RUN_SNAPSHOT_SCHEMA_VERSION as E, USER_PROFILE_REFINE_PROMPT as F, extractChartSpec as G, createWebSkillApi as H, WebSkillRuntime as I, formatSkillScriptManifest as J, extractTodoTraceEvents as K, appendBehaviorRecords as L, USER_PROFILE_KEY as M, USER_PROFILE_NO_INVENTION_RULE as N, SESSION_SCHEMA_VERSION as O, USER_PROFILE_PROMPT_HEADER as P, isUnsupportedRunSnapshot as Q, applyUserProfileImport as R, ProgressiveRouter as S, toVercelToolSpecs as St, READ_SKILL_FILE_TOOL_NAME as T, diffUserProfile as U, createScriptContext as V, exportUserProfile as W, fromVercelStreamPart as X, fromVercelResult as Y, isNetworkAllowed as Z, FsSessionStore as _, schemaToForm as _t, AgentLoop as a, normalizeToolContent as at, HookRunner as b, toLlmToolSpec as bt, CapabilityApproval as c, parseUserProfileExport as ct, EventBus as d, readUserProfile as dt, mergeCatalogEntries as et, FS_SESSION_PAGE_SIZE as f, refineUserProfile as ft, FsRunTraceStore as g, schemaSourceLabel as gt, FsRunSnapshotStore as h, sampleBehaviorRecords as ht, ASK_USER_TOOL_NAME as i, normalizeErrorCode as it, USER_PROFILE_EXPORT_VERSION as j, SerializingMemoryStore as k, DEFAULT_USER_PROFILE_LIMITS as l, readBehaviorRecords as lt, FsMemoryStore as m, resolveToolName as mt, ASK_USER_INPUT_SCHEMA as n, networkPolicyLibSource as nt, AnthropicClient as o, normalizeToolError as ot, FsArtifactStore as p, renderUserProfileContext as pt, extractUiSpecEvents as q, ASK_USER_TOOL as r, networkUrlHost as rt, BEHAVIOR_RECORDS_KEY as s, parseBridgeRequest as st, ALLOWED_TOOLS_EXCLUSION_REASON as t, mergeProfileEntries as tt, EMPTY_USER_PROFILE as u, readProfileEntries as ut, FullDisclosureRouter as v, scriptToolName as vt, READ_SKILL_FILE_TOOL as w, validateUiSpecNode as wt, OpenAiCompatibleClient as x, toRecordDigests as xt, GoogleGenAiClient as y, summarizeToolCalls as yt, bridgeError as z };
+export { isNetworkAllowed as $, SerializingMemoryStore as A, bridgeError as B, ProgressiveRouter as C, toRecordDigests as Ct, RUN_SNAPSHOT_SCHEMA_VERSION as D, READ_SKILL_FILE_TOOL_NAME as E, validateUiSpecNode as Et, USER_PROFILE_PROMPT_HEADER as F, exportUserProfile as G, createScriptContext as H, USER_PROFILE_REFINE_PROMPT as I, extractTodoTraceEvents as J, extractChartSpec as K, WebSkillRuntime as L, USER_PROFILE_EXPORT_VERSION as M, USER_PROFILE_KEY as N, RUN_TRACE_SCHEMA_VERSION as O, USER_PROFILE_NO_INVENTION_RULE as P, fromVercelStreamPart as Q, appendBehaviorRecords as R, OpenAiCompatibleClient as S, toLlmToolSpec as St, READ_SKILL_FILE_TOOL as T, validateUiSpecEvent as Tt, createWebSkillApi as U, buildRenderResult as V, diffUserProfile as W, formatSkillScriptManifest as X, extractUiSpecEvents as Y, fromVercelResult as Z, FsRunTraceStore as _, sampleBehaviorRecords as _t, AgentLoop as a, networkUrlHost as at, GoogleGenAiClient as b, scriptToolName as bt, CapabilityApproval as c, normalizeToolError as ct, EMPTY_USER_PROFILE as d, readBehaviorRecords as dt, isUnsupportedRunSnapshot as et, EventBus as f, readProfileEntries as ft, FsRunSnapshotStore as g, resolveToolName as gt, FsMemoryStore as h, renderUserProfileContext as ht, ASK_USER_TOOL_NAME as i, networkPolicyLibSource as it, TraceRecorder as j, SESSION_SCHEMA_VERSION as k, DEFAULT_LOOP_LIMITS as l, parseBridgeRequest as lt, FsArtifactStore as m, refineUserProfile as mt, ASK_USER_INPUT_SCHEMA as n, mergeCatalogEntries as nt, AnthropicClient as o, normalizeErrorCode as ot, FS_SESSION_PAGE_SIZE as p, readUserProfile as pt, extractSkillCandidate as q, ASK_USER_TOOL as r, mergeProfileEntries as rt, BEHAVIOR_RECORDS_KEY as s, normalizeToolContent as st, ALLOWED_TOOLS_EXCLUSION_REASON as t, listSkillScripts as tt, DEFAULT_USER_PROFILE_LIMITS as u, parseUserProfileExport as ut, FsSessionStore as v, schemaSourceLabel as vt, READ_SKILL_FILE_INPUT_SCHEMA as w, toVercelToolSpecs as wt, HookRunner as x, summarizeToolCalls as xt, FullDisclosureRouter as y, schemaToForm as yt, applyUserProfileImport as z };

package/dist/eventTypes-DjIQpt8Y-Bj3vghj4.js

@@ -0,0 +1,32 @@
+//#region ../governance/dist/eventTypes-DjIQpt8Y.js
+/**
+* 审计事件类型常量（FR-13.4）。
+*
+* 存在的理由是**消灭调用点的字面量**：写入点分散在 governance 与 console 的十来个文件里，
+* 字面量拼错不会有任何编译期反馈，只会在审计里留下一条永远查不到的记录。
+*
+* `AuditEvent.type` 刻意**保持 `string`**、不收窄为 `AuditEventType`——
+* 收窄会让外部写入方（插件、其它宿主）无法追加自定义类型，且会立刻产生快照差异。
+*/
+const AUDIT_EVENT_TYPES = {
+	skillEdited: "skill.edited",
+	skillRolledBack: "skill.rolled_back",
+	skillPublished: "skill.published",
+	skillRepairApplied: "skill.repair_applied",
+	skillQuarantined: "skill.quarantined",
+	skillPolicyDenied: "skill.policy_denied",
+	skillUninstalled: "skill.uninstalled",
+	skillInstalled: "skill.installed",
+	trustKeyAdded: "trust.key_added",
+	trustKeyRemoved: "trust.key_removed",
+	policyNetworkChanged: "policy.network_changed",
+	policyPrivacyChanged: "policy.privacy_changed",
+	mcpEndpointChanged: "mcp.endpoint_changed",
+	mcpPolicyRelaxed: "mcp.policy_relaxed",
+	providerChanged: "provider.changed"
+};
+/** 稳定展示序：筛选下拉与文档表格都从这里取，不各自维护一份顺序 */
+const AUDIT_EVENT_TYPE_LIST = Object.values(AUDIT_EVENT_TYPES);
+
+//#endregion
+export { AUDIT_EVENT_TYPE_LIST as n, AUDIT_EVENT_TYPES as t };