@webskill/sdk 0.14.0 → 0.15.0

package/dist/external-_ZRQe-V9.js

@@ -0,0 +1,53 @@
+//#region ../runtime/src/tools/normalizeContent.ts
+const MCP_CONTENT_RE = /^(text|json|image|resource|audio)$/;
+/**
+* 脚本返回值归一到 MCP content 格式：数组沿用（逐项归一），
+* 字符串包装为 text，其他值序列化包装。Node/浏览器执行器共享。
+* 产出只有文本型分片：脚本侧没有下发图像的通道（图像只来自页面取像）。
+*/
+function normalizeToolContent(value) {
+	if (Array.isArray(value)) return value.map((item) => {
+		if (typeof item === "object" && item !== null && typeof item.type === "string" && MCP_CONTENT_RE.test(item.type)) {
+			const { type, ...rest } = item;
+			if (type === "json") return {
+				type: "json",
+				data: rest["data"] ?? rest
+			};
+			return {
+				type: "text",
+				text: typeof rest["text"] === "string" ? rest["text"] : JSON.stringify(rest)
+			};
+		}
+		return {
+			type: "text",
+			text: typeof item === "string" ? item : JSON.stringify(item)
+		};
+	});
+	if (typeof value === "string") return [{
+		type: "text",
+		text: value
+	}];
+	if (value === void 0 || value === null) return [{
+		type: "text",
+		text: ""
+	}];
+	return [{
+		type: "text",
+		text: typeof value === "object" ? JSON.stringify(value) : String(value)
+	}];
+}
+
+//#endregion
+//#region ../runtime/src/engine/external.ts
+/**
+* Catalog 合并：同名本地优先；外部条目的 mcp:// 根 URI 保留，
+* 调用方可凭 URI 强制选择外部技能（绕过本地优先）。
+*/
+function mergeCatalogEntries(localEntries, providerEntries) {
+	const byName = new Map(localEntries.map((e) => [e.name, e]));
+	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));
+}
+
+//#endregion
+export { normalizeToolContent as n, mergeCatalogEntries as t };

package/dist/governance.d.ts

@@ -1,6 +1,6 @@
-import { S as UiBridge, U as FileSystemProvider, X as PageQuery, Y as Page, f as LlmMessage, ft as SkillDocument, gt as SkillManagerPort, l as LlmClient, ut as SkillCatalogEntry } from "./types-C3V6lAeO-BgeOvc1Y.js";
-import { $t as SkillIntegrityGuard, Ft as RuntimeRun, Rn as WebSkillRuntime, X as IntegrityVerdict, en as SkillOutcomeReporter, in as SkillStateGuard } from "./index-CWoKOFBP.js";
-import { _ as SkillState, a as AuditLog, b as SkillVersionStore, c as CandidateFile, d as CandidateSkill, f as CandidateSource, g as SKILL_VERSION_PAGE_SIZE, h as CompositeApprovalPolicy, i as AuditEvent, l as CandidatePage, m as CandidateStore, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateStatus, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidateRisk, v as SkillVersion, x as candidateToCatalogEntry, y as SkillVersionPage } from "./skillVersionStore-D-qHk9ZE-C0OFDTQY.js";
+import { S as UiBridge, U as FileSystemProvider, X as PageQuery, Y as Page, f as LlmMessage, ft as SkillDocument, gt as SkillManagerPort, l as LlmClient, ut as SkillCatalogEntry } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { $ as IntegrityVerdict, Wn as WebSkillRuntime, cn as SkillStateGuard, in as SkillOutcomeReporter, rn as SkillIntegrityGuard, zt as RuntimeRun } from "./index-Oc3H89TJ.js";
+import { _ as SkillState, a as AuditLog, b as SkillVersionStore, c as CandidateFile, d as CandidateSkill, f as CandidateSource, g as SKILL_VERSION_PAGE_SIZE, h as CompositeApprovalPolicy, i as AuditEvent, l as CandidatePage, m as CandidateStore, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateStatus, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidateRisk, v as SkillVersion, x as candidateToCatalogEntry, y as SkillVersionPage } from "./skillVersionStore-B24Jjjry-C4zomhMZ.js";
 //#region ../governance/dist/index.d.ts
 //#region src/candidate/candidateNormalizer.d.ts
 /** 剥 markdown fence 与 <think> 块、截取首尾 {}；非对象 → CANDIDATE_INVALID */
@@ -205,12 +205,24 @@ declare const AUDIT_EVENT_TYPES: {
   readonly candidateSubmitted: "candidate.submitted";
   readonly candidateApproved: "candidate.approved";
   readonly candidateRejected: "candidate.rejected";
+  /** 候选记录被从审批队列里删除（仅 draft / pending-review / rejected 可删） */
+  readonly candidateRemoved: "candidate.removed";
   readonly pagePerceived: "page.perceived";
   readonly pageAction: "page.action";
+  /**
+   * 一次页面操作引发了下载，但 `sandbox.downloadedFiles` 关着，模型因此一无所知
+   * （0.15.0 分册 15 · FR-15.7）。载荷只有计数与原因，不含文件名 / 大小 / 类型。
+   */
+  readonly pageDownloadUnreported: "page.download.unreported";
   readonly documentRead: "document.read";
   readonly documentSurfaceOpen: "document.surface.open";
   /** 脚本按宿主声明的数据源取数（分册 16）；被拒也记，否则反复试探看不见 */
   readonly dataFetched: "data.fetch";
+  /**
+   * 技能脚本读用户本轮上传的文件（0.15.0 分册 17 · FR-17.7）。
+   * 载荷记文件名 / 类型 / 字节数与是否被拒，**不含文件内容**。
+   */
+  readonly uploadFileRead: "upload.file.read";
 };
 type AuditEventType = (typeof AUDIT_EVENT_TYPES)[keyof typeof AUDIT_EVENT_TYPES];
 /** 稳定展示序：筛选下拉与文档表格都从这里取，不各自维护一份顺序 */

package/dist/governance.js

@@ -1,8 +1,10 @@
-import { B as messageOf, C as assertSafePathSegment, L as isValidSkillName, b as WebSkillError, w as atomicWriteText } from "./dist-D5YhlCdY.js";
-import { a as textParts, n as partsToText } from "./memoryArtifactStore-52Zn9npI-BxtUkrgV.js";
-import { n as AUDIT_EVENT_TYPE_LIST, t as AUDIT_EVENT_TYPES } from "./eventTypes-FllCrX-Z-DNDeHWoG.js";
+import { n as messageOf, t as WebSkillError } from "./errors-BDZNpC13.js";
+import { y as isValidSkillName } from "./skill-CAJMsLod.js";
+import { a as atomicWriteText, t as assertSafePathSegment } from "./pathSecurity-B1owvJAF.js";
+import { d as partsToText, p as textParts } from "./llm-B7lLH0ZI.js";
+import { n as AUDIT_EVENT_TYPE_LIST, t as AUDIT_EVENT_TYPES } from "./eventTypes-Y07N8IAC.js";
 
-//#region ../governance/dist/index.js
+//#region ../governance/src/candidate/candidateNormalizer.ts
 const invalid = (message, details) => {
 	throw new WebSkillError("CANDIDATE_INVALID", message, details);
 };
@@ -96,11 +98,17 @@ function normalizeCandidate(input) {
 		updatedAt: now
 	};
 }
+
+//#endregion
+//#region ../governance/src/candidate/candidateValidator.ts
 /** 候选校验：缺 SKILL.md / 非法扩展名 → CANDIDATE_INVALID */
 function validateCandidate(candidate) {
 	if (!candidate.files.some((f) => f.kind === "skill-md")) throw new WebSkillError("CANDIDATE_INVALID", `Candidate "${candidate.name}" is missing SKILL.md`);
 	for (const file of candidate.files) if (file.kind === "script" && !/\.(ts|js)$/.test(file.path)) throw new WebSkillError("CANDIDATE_INVALID", `Candidate "${candidate.name}" has an unsupported script file: ${file.path}`);
 }
+
+//#endregion
+//#region ../governance/src/pagination.ts
 /**
 * 治理侧各列表共用的游标切片，形状与会话消息（C1）完全一致：
 * 无游标给**最新**一页，`nextCursor` 指向更早的历史，页内按时间升序。
@@ -125,6 +133,9 @@ function takeTailPage(all, options, defaultLimit, what) {
 		...start > 0 ? { nextCursor: String(start) } : {}
 	};
 }
+
+//#endregion
+//#region ../governance/src/candidate/candidateStore.ts
 const dirOf$1 = (root) => `${root}/.webskill/candidates`;
 /** 候选列表的缺省页长。缺省属于实现，不属于调用方 */
 const CANDIDATE_PAGE_SIZE = 50;
@@ -132,9 +143,11 @@ const CANDIDATE_PAGE_SIZE = 50;
 var CandidateStore = class {
 	#root;
 	#fs;
+	#isSkillInstalled;
 	constructor(deps) {
 		this.#root = deps.root.replace(/\/+$/, "");
 		this.#fs = deps.fs;
+		this.#isSkillInstalled = deps.isSkillInstalled;
 	}
 	async save(candidate) {
 		validateCandidate(candidate);
@@ -175,6 +188,24 @@ var CandidateStore = class {
 		await this.save(candidate);
 		return candidate;
 	}
+	/**
+	* 把候选记录从队列里删掉。
+	*
+	* `approved` 恒拒删：它是「已批准但还没发布」，删掉等于让批准过的东西凭空消失；
+	* 要清理先 `reject`（留下理由）再删。
+	* `published` 是已安装技能的来源凭证，技能还装着时同样拒删；技能卸载后它只剩堆在队列里，
+	* 此时可删（0.15.0 分册 16 D-16-2）。未注入 `isSkillInstalled` 时判断不了装没装，
+	* 退化为「published 一律拒删」——宁可留着清不掉，也不能把还装着的技能的来源凭证删了。
+	*/
+	async remove(id) {
+		const candidate = await this.get(id);
+		if (candidate.status === "approved") throw new WebSkillError("GOVERNANCE_FAILED", `Candidate "${candidate.name}" cannot be removed from status "${candidate.status}"`);
+		if (candidate.status === "published" && await this.#skillStillInstalled(candidate.name)) throw new WebSkillError("GOVERNANCE_FAILED", `Candidate "${candidate.name}" is the provenance record of an installed skill and cannot be removed; uninstall the skill first`);
+		await this.#fs.remove(`${dirOf$1(this.#root)}/${id}.json`);
+	}
+	async #skillStillInstalled(name) {
+		return this.#isSkillInstalled === void 0 ? true : await this.#isSkillInstalled(name);
+	}
 };
 /** 硬门禁：仅 published 可转换为 Catalog 条目，否则 APPROVAL_REQUIRED */
 function candidateToCatalogEntry(candidate) {
@@ -189,6 +220,9 @@ function candidateToCatalogEntry(candidate) {
 		hasAssets: candidate.files.some((f) => f.kind === "asset")
 	};
 }
+
+//#endregion
+//#region ../governance/src/candidate/candidateSink.ts
 /**
 * 把 agent 生成的技能草稿接进既有的候选管线（设计 02 §5）。
 *
@@ -232,6 +266,9 @@ function createCandidateSink(options) {
 		return { id: candidate.id };
 	} };
 }
+
+//#endregion
+//#region ../governance/src/llmText.ts
 /**
 * 文本补全：优先走流式（慢速本地模型下非流式整响应缓冲会触发 fetch 头超时，
 * SSE 首包秒到不受此限）；无 stream 的客户端回退 complete。
@@ -246,6 +283,9 @@ async function completeText(llm, messages) {
 	}
 	return partsToText((await llm.complete({ messages })).content);
 }
+
+//#endregion
+//#region ../governance/src/candidate/llmCandidateGenerator.ts
 const GENERATION_PROMPT = (task, context) => [
 	"You generate a skill candidate as STRICT JSON only (no markdown, no explanation).",
 	"Schema: {\"name\": string, \"description\": string, \"risk\": \"low\"|\"medium\"|\"high\",",
@@ -293,6 +333,9 @@ var LlmCandidateGenerator = class {
 		return candidate;
 	}
 };
+
+//#endregion
+//#region ../governance/src/approval/policies.ts
 /** 默认策略：任何候选都必须人工审批 */
 var AlwaysHumanApprovalPolicy = class {
 	evaluate(candidate) {
@@ -318,6 +361,9 @@ var CompositeApprovalPolicy = class {
 		return this.#fallback.evaluate(candidate);
 	}
 };
+
+//#endregion
+//#region ../governance/src/audit/fsAuditLog.ts
 const fileOf$1 = (root) => `${root}/.webskill/audit.jsonl`;
 /** 审计查询的缺省页长。缺省属于实现，不属于调用方 */
 const AUDIT_PAGE_SIZE = 100;
@@ -572,6 +618,9 @@ var FsAuditLog = class {
 		};
 	}
 };
+
+//#endregion
+//#region ../governance/src/versioning/skillVersionStore.ts
 const dirOf = (root, skillName) => {
 	assertSafePathSegment(skillName, "skill name");
 	return `${root}/.webskill/versions/${skillName}`;
@@ -669,6 +718,9 @@ var SkillVersionStore = class {
 		});
 	}
 };
+
+//#endregion
+//#region ../governance/src/repair/failureAnalyzer.ts
 const ERROR_CAUSES = {
 	TOOL_NOT_FOUND: "The skill script or tool is missing",
 	TOOL_EXECUTION_FAILED: "The script failed at runtime",
@@ -720,6 +772,9 @@ var FailureAnalyzer = class {
 		};
 	}
 };
+
+//#endregion
+//#region ../governance/src/repair/repairPlanner.ts
 /**
 * 修订选项规划：patch（按诊断给具体文件变更）/ rollback（有旧版本时）/ quarantine。
 * 注意：任何 option 的 apply 都必须经 ApprovalWorkflow 审批后执行；rollback 选项（targetVersionId）经 ApprovalWorkflow.applyRollback 真实恢复文件。
@@ -748,6 +803,9 @@ var RepairPlanner = class {
 		return options;
 	}
 };
+
+//#endregion
+//#region ../governance/src/state/skillStatePolicy.ts
 const fileOf = (root) => `${root}/.webskill/states.json`;
 /**
 * 用户策略主动拒绝的错误码（FR-12.4）：这是配置生效的证据，不是技能有问题，不计入隔离阈值。
@@ -1013,6 +1071,9 @@ var SkillStatePolicy = class {
 		});
 	}
 };
+
+//#endregion
+//#region ../governance/src/evaluation/evaluationRunner.ts
 function matchExpected(expected, output, run) {
 	if (expected === void 0) return run.status === "completed";
 	if (typeof expected === "string") return output.includes(expected);
@@ -1067,6 +1128,9 @@ var EvaluationRunner = class {
 		};
 	}
 };
+
+//#endregion
+//#region ../governance/src/evaluation/testSuggestion.ts
 /** 失败 trace → 回归评估任务建议（prompt 复现 + expected 错误模式） */
 function suggestFromFailedRun(run) {
 	const errorPatterns = run.trace.filter((e) => e.type === "tool.failed" || e.type === "run.failed").map((e) => String(e.data?.["code"] ?? e.message ?? "")).filter(Boolean);
@@ -1084,6 +1148,9 @@ function suggestFromFailedRun(run) {
 		}
 	};
 }
+
+//#endregion
+//#region ../governance/src/scoring/skillScorer.ts
 const SCORING_WEIGHTS = {
 	success: .5,
 	usage: .2,
@@ -1116,6 +1183,9 @@ var SkillScorer = class {
 		};
 	}
 };
+
+//#endregion
+//#region ../governance/src/scoring/similarity.ts
 const tokenize = (text) => new Set(text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 1));
 function jaccardSimilarity(a, b) {
 	const sa = tokenize(a);
@@ -1136,6 +1206,9 @@ var SimilarityDetector = class {
 		for (const skill of existing) if (jaccardSimilarity(description, skill.description) >= this.#threshold) return skill.name;
 	}
 };
+
+//#endregion
+//#region ../governance/src/scoring/dependencyGraph.ts
 var DependencyGraph = class DependencyGraph {
 	#edges = /* @__PURE__ */ new Map();
 	addDependency(from, to) {
@@ -1163,6 +1236,9 @@ var DependencyGraph = class DependencyGraph {
 		return out.sort();
 	}
 };
+
+//#endregion
+//#region ../governance/src/documents/documentSource.ts
 /** 环境无关 sha256（WebCrypto；Node ≥17 与浏览器均有 globalThis.crypto.subtle） */
 async function sha256Hex(text) {
 	const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
@@ -1177,6 +1253,9 @@ async function readDocument(fs, path) {
 		hash: await sha256Hex(content)
 	};
 }
+
+//#endregion
+//#region ../governance/src/documents/documentSkillExtractor.ts
 const EXTRACT_PROMPT = (doc, nameHint) => [
 	"Extract an executable skill from the following document as STRICT JSON only.",
 	"Schema: {\"name\": string, \"description\": string, \"risk\": \"low\"|\"medium\"|\"high\",",
@@ -1245,6 +1324,9 @@ var DocumentSkillExtractor = class {
 		};
 	}
 };
+
+//#endregion
+//#region ../governance/src/missHook.ts
 /**
 * runtime-miss 现成适配（opt-in）：run 未激活技能时生成 draft 候选入库待审。
 * 返回的 hook 失败会向上抛（由 runtime 降级为 warning）。

package/dist/{index-DQwGvHAI.d.ts → index-CQYo4tcT.d.ts}

@@ -1,5 +1,5 @@
-import { I as ChatAttachmentKind, Mt as WebSkillErrorCode, S as UiBridge, Z as RemoteUrlPolicy, a as InteractionOrigin, c as InteractionResponse, s as InteractionRequest } from "./types-C3V6lAeO-BgeOvc1Y.js";
-import { A as DataSourceInfo, Bn as XlsxTextExtractor, I as ExternalToolSource, gn as ToolStepReader, j as DocxTextExtractor } from "./index-CWoKOFBP.js";
+import { I as ChatAttachmentKind, Nt as WebSkillErrorCode, S as UiBridge, Z as RemoteUrlPolicy, a as InteractionOrigin, c as InteractionResponse, s as InteractionRequest } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { Kn as XlsxTextExtractor, P as DocxTextExtractor, bn as ToolStepReader, j as DataSourceInfo, z as ExternalToolSource } from "./index-Oc3H89TJ.js";
 //#region ../agent/dist/index.d.ts
 //#region src/todo/types.d.ts
 /** 待办条目状态：未开始 / 进行中 / 已完成（FR-3.1） */
@@ -523,10 +523,12 @@ interface PerceptionRecord {
   /** 读到的顶层节点数；用于「它读的比我预期的多」这类判断 */
   nodeCount: number;
   /**
-   * 整份快照的节点总数（含各层）；**只在这次感知被切成了多段时存在**（分册 22 FR-22.7）。
+   * 整份快照的节点总数（含各层）；**每次感知都在**（0.15.0 分册 14 · D-14-2）。
+   * 早先它只在分段时出现，于是「没分段」的那些次感知无法回答「模型到底看到了多少」。
+   * 与 `segmentPerception()` 的 `nodesTotal` 同源同值（FR-14.2）。
    * `nodeCount` 的语义不动——改它会让所有既有断言与 console 展示静默变义。
    */
-  nodesTotal?: number;
+  nodesTotal: number;
   /** 切成了几段；只在分段发生时存在 */
   segments?: number;
   /** 本次直接回喂给模型的那一段承载了多少个节点；只在分段发生时存在 */
@@ -923,6 +925,61 @@ declare class DataSourceCandidatePolicy {
   restore(scope: string): Promise<void>;
 }
 //#endregion
+//#region src/pageAction/downloadSignal.d.ts
+/**
+ * 操作触发的下载：完成信号（0.15.0 分册 15）。
+ *
+ * 这一层不含任何浏览器概念。SDK 只定义「窗口什么时候开、什么时候关、结果长什么样」，
+ * 「怎么知道下载起来了」全在端口之后——与分册 20 的分工一致。
+ */
+/**
+ * 一次页面操作的下载观察窗口。**只在 `act()` 的一次调用里存在**：
+ * 返回之后这个对象就不可达，因此窗口之外没有任何代码路径能问到下载（FR-15.2）。
+ * @experimental
+ */
+interface ActionDownloadWindow {
+  /**
+   * 结算并**关闭**窗口，返回窗口内完成的下载次数（没有即 0）。
+   *
+   * 到预算上限就返回当时已经数到的次数，不丢弃、不抛错——
+   * 等待超时不是失败，操作本身的结果照常返回（FR-15.3）。
+   */
+  settle(budget: {
+    timeoutMs: number;
+  }): Promise<number>;
+}
+/**
+ * 下载观察窗口的宿主实现（FR-15.2）。**不注入即整条通路不存在**：
+ * 不开窗、不留痕，页面操作的结果与本版前逐字一致。
+ *
+ * 之所以是 `open` / `settle` 一对而不是一个 `waitForDownloads(ms)`：
+ * 后者只说了「等多久」，没说「从什么时候开始算」，宿主可以实现成
+ * 「返回最近 N 秒内的下载」——那就把用户在别处的下载也算了进来（D-15-4 否掉的 (a)）。
+ * 窗口的两端由 SDK 说了算，宿主实现里没有自己决定起点的余地。
+ * @experimental
+ */
+interface ActionDownloadWatcher {
+  /**
+   * 在页面操作**执行前**打开窗口。
+   * 下载可能在点击返回之前就已经落盘，先执行再开窗会漏掉最快的那一类。
+   */
+  open(context: {
+    runId?: string;
+  }): ActionDownloadWindow | Promise<ActionDownloadWindow>;
+}
+/** 宿主不注入等待上限时的缺省；够覆盖「点击 → 浏览器起下载」的常见延迟 */
+declare const DOWNLOAD_WAIT_DEFAULT_MS = 1500;
+/** 地板：注入 0 会把本能力静默变成永不触发，那是更坏的失败形态 */
+declare const DOWNLOAD_WAIT_MIN_MS = 250;
+/** 天花板：宿主写错一个 0 不该让一轮对话挂十分钟 */
+declare const DOWNLOAD_WAIT_MAX_MS = 10000;
+/**
+ * 把宿主注入的等待上限夹进地板与天花板（FR-15.3）。
+ * 不注入或注入了非有限数即取缺省——不信任宿主传进来的数是这里存在的全部理由。
+ * @experimental
+ */
+declare function clampDownloadWaitMs(ms: number | undefined): number;
+//#endregion
 //#region src/pageAction/types.d.ts
 /**
  * 页面操作的策略层类型（需求 23）。
@@ -1023,6 +1080,14 @@ interface PageActionOutcome {
   navigated?: boolean;
   /** 变更后的地址；仅 `navigated` 时带 */
   documentUrl?: string;
+  /**
+   * 本次操作引发的下载**完成**次数（0.15.0 分册 15 · FR-15.1）。
+   * 没有下载时**不带**该字段，与 `navigated` 同口径。
+   *
+   * 只有次数：文件名、大小、类型一律不在这里（D-15-3）——带上就等于开了一条
+   * 绕过 `list_downloaded_files` 确认卡的披露路径。要读内容仍得逐次点头。
+   */
+  downloadCount?: number;
   /** 失败原因（英文） */
   reason?: string;
 }
@@ -1118,6 +1183,18 @@ interface PageActionPolicyOptions {
    * 前者是宿主装配时写死的静态配置，后者是用户运行期一次一次攒出来的。
    */
   consent?: PageActionConsent;
+  /**
+   * 操作触发的下载观察窗口（0.15.0 分册 15）。**不注入即整条通路不存在**：
+   * 不开窗、不留痕，页面操作的结果与本版前逐字一致（AC-15.5 / AC-15.12）。
+   */
+  downloadWatcher?: ActionDownloadWatcher;
+  /**
+   * 下载信号的能力开关（`sandbox.downloadedFiles`，D-15-5）。缺省即**关闭**：
+   * `downloadCount` 永不出现。关着时窗口照开，结果只进留痕（D-15-6 / FR-15.7）。
+   */
+  downloadSignalEnabled?(): boolean;
+  /** 宿主注入的等待上限（毫秒）；SDK 夹在地板与天花板之间（FR-15.3）。模型无法影响它 */
+  downloadWaitMs?(): number | undefined;
   now?(): string;
 }
 /**
@@ -1149,7 +1226,9 @@ declare class PageActionPolicy {
    * 只留句柄等于留了一个换次运行就失效的引用；角色与可访问名才是可重放的那部分。
    */
   rememberedTarget(ref: string): PageActionTarget | undefined;
-  act(request: PageActionRequest): Promise<PageActionOutcome>;
+  act(request: PageActionRequest, context?: {
+    runId?: string;
+  }): Promise<PageActionOutcome>;
 }
 //#endregion
 //#region src/pageAction/toolSource.d.ts
@@ -1321,4 +1400,4 @@ interface DownloadedFileToolSourceOptions {
  */
 declare function createDownloadedFileToolSource(options: DownloadedFileToolSourceOptions): ExternalToolSource;
 //#endregion
-export { PageActionOutcome as $, frameSteps as $t, DownloadedFilePolicyOptions as A, SkillGenerationToolSourceOptions as At, ImageCaptureBudget as B, TodoList as Bt, DelegationResult as C, PerceptionScopeInput as Ct, DownloadedFileEntry as D, SkillGenerationMessages as Dt, DownloadedFileConsent as E, SkillCandidateSink as Et, FrameNote as F, SubAgentRunInput as Ft, PAGE_ACTION_SYSTEM_PROMPT as G, createDelegationToolSource as Gt, MANAGE_TODO_TOOL as H, TodoStatus as Ht, FrameScope as I, SubAgentRunner as It, PERCEPTION_PAGING_DEFAULTS as J, createPageActionToolSource as Jt, PAGE_ACTION_TOOL as K, createDownloadedFileToolSource as Kt, GENERATE_SKILL_TOOL as L, TODO_SYSTEM_PROMPT as Lt, DownloadedFileReader as M, SkillGeneratorOptions as Mt, DownloadedFileRecord as N, SkillTraceEvidence as Nt, DownloadedFileListing as O, SkillGenerationOutcome as Ot, DownloadedFileToolSourceOptions as P, SkillTraceEvidenceStep as Pt, PageActionKind as Q, frameLabel as Qt, GeneratedSkillDraft as R, TodoEvent as Rt, DelegationRequest as S, PerceptionScope as St, DownloadedFileAction as T, SKILL_GENERATION_SYSTEM_PROMPT as Tt, NestedFrameRef as U, TodoStore as Ut, LIST_DOWNLOADED_FILES_TOOL as V, TodoListener as Vt, PAGE_ACTION_KINDS as W, TodoToolSourceOptions as Wt, PageActionConsent as X, createSkillGenerationToolSource as Xt, PERCEPTION_SYSTEM_PROMPT as Y, createPagePerceptionToolSource as Yt, PageActionExecutor as Z, createTodoToolSource as Zt, DataSourceRecord as _, PerceptionAuditSink as _t, DataSourceAuditSink as a, PageActionScopeInput as at, DelegationOrchestrator as b, PerceptionRecord as bt, DataSourceCandidatePolicy as c, PageActionUi as ct, DataSourceCandidateStore as d, PagePerceptionPolicyOptions as dt, toActionFrameScopes as en, PageActionPolicy as et, DataSourceDef as f, PagePerceptionReader as ft, DataSourceProvenance as g, PerceivedNode as gt, DataSourcePolicyOptions as h, PerceivedImage as ht, DELEGATION_SYSTEM_PROMPT as i, PageActionScope as it, DownloadedFileReadResult as j, SkillGenerator as jt, DownloadedFilePolicy as k, SkillGenerationPolicy as kt, DataSourceCandidatePolicyOptions as l, PageAuditSink as lt, DataSourcePolicy as m, ParentBudget as mt, ConsentUi as n, withDelegationOrigin as nn, PageActionRecord as nt, DataSourceCandidate as o, PageActionTarget as ot, DataSourceKind as p, PagePerceptionToolSourceOptions as pt, PERCEIVE_PAGE_TOOL as q, createHttpDataSourceTransport as qt, DELEGATE_TASK_TOOL as r, PageActionRequest as rt, DataSourceCandidateAuditSink as s, PageActionToolSourceOptions as st, ActionFrameScope as t, toFrameScopes as tn, PageActionPolicyOptions as tt, DataSourceCandidateRecord as u, PagePerceptionPolicy as ut, DataSourceTransport as v, PerceptionCaptureOptions as vt, DelegationToolSourceOptions as w, READ_DOWNLOADED_FILE_TOOL as wt, DelegationOrchestratorOptions as x, PerceptionResult as xt, DelegationBudget as y, PerceptionPagingBudget as yt, HttpDataSourceOptions as z, TodoItem as zt };
+export { PERCEPTION_PAGING_DEFAULTS as $, createHttpDataSourceTransport as $t, DownloadedFileAction as A, SKILL_GENERATION_SYSTEM_PROMPT as At, FrameNote as B, SubAgentRunInput as Bt, DataSourceTransport as C, PerceptionCaptureOptions as Ct, DelegationRequest as D, PerceptionScope as Dt, DelegationOrchestratorOptions as E, PerceptionResult as Et, DownloadedFilePolicyOptions as F, SkillGenerationToolSourceOptions as Ft, ImageCaptureBudget as G, TodoList as Gt, GENERATE_SKILL_TOOL as H, TODO_SYSTEM_PROMPT as Ht, DownloadedFileReadResult as I, SkillGenerator as It, NestedFrameRef as J, TodoStore as Jt, LIST_DOWNLOADED_FILES_TOOL as K, TodoListener as Kt, DownloadedFileReader as L, SkillGeneratorOptions as Lt, DownloadedFileEntry as M, SkillGenerationMessages as Mt, DownloadedFileListing as N, SkillGenerationOutcome as Nt, DelegationResult as O, PerceptionScopeInput as Ot, DownloadedFilePolicy as P, SkillGenerationPolicy as Pt, PERCEIVE_PAGE_TOOL as Q, createDownloadedFileToolSource as Qt, DownloadedFileRecord as R, SkillTraceEvidence as Rt, DataSourceRecord as S, PerceptionAuditSink as St, DelegationOrchestrator as T, PerceptionRecord as Tt, GeneratedSkillDraft as U, TodoEvent as Ut, FrameScope as V, SubAgentRunner as Vt, HttpDataSourceOptions as W, TodoItem as Wt, PAGE_ACTION_SYSTEM_PROMPT as X, clampDownloadWaitMs as Xt, PAGE_ACTION_KINDS as Y, TodoToolSourceOptions as Yt, PAGE_ACTION_TOOL as Z, createDelegationToolSource as Zt, DataSourceDef as _, PagePerceptionReader as _t, DELEGATE_TASK_TOOL as a, frameSteps as an, PageActionPolicy as at, DataSourcePolicyOptions as b, PerceivedImage as bt, DOWNLOAD_WAIT_MAX_MS as c, withDelegationOrigin as cn, PageActionRequest as ct, DataSourceCandidate as d, PageActionTarget as dt, createPageActionToolSource as en, PERCEPTION_SYSTEM_PROMPT as et, DataSourceCandidateAuditSink as f, PageActionToolSourceOptions as ft, DataSourceCandidateStore as g, PagePerceptionPolicyOptions as gt, DataSourceCandidateRecord as h, PagePerceptionPolicy as ht, ConsentUi as i, frameLabel as in, PageActionOutcome as it, DownloadedFileConsent as j, SkillCandidateSink as jt, DelegationToolSourceOptions as k, READ_DOWNLOADED_FILE_TOOL as kt, DOWNLOAD_WAIT_MIN_MS as l, PageActionScope as lt, DataSourceCandidatePolicyOptions as m, PageAuditSink as mt, ActionDownloadWindow as n, createSkillGenerationToolSource as nn, PageActionExecutor as nt, DELEGATION_SYSTEM_PROMPT as o, toActionFrameScopes as on, PageActionPolicyOptions as ot, DataSourceCandidatePolicy as p, PageActionUi as pt, MANAGE_TODO_TOOL as q, TodoStatus as qt, ActionFrameScope as r, createTodoToolSource as rn, PageActionKind as rt, DOWNLOAD_WAIT_DEFAULT_MS as s, toFrameScopes as sn, PageActionRecord as st, ActionDownloadWatcher as t, createPagePerceptionToolSource as tn, PageActionConsent as tt, DataSourceAuditSink as u, PageActionScopeInput as ut, DataSourceKind as v, PagePerceptionToolSourceOptions as vt, DelegationBudget as w, PerceptionPagingBudget as wt, DataSourceProvenance as x, PerceivedNode as xt, DataSourcePolicy as y, ParentBudget as yt, DownloadedFileToolSourceOptions as z, SkillTraceEvidenceStep as zt };

package/dist/{index-sd-gVKey.d.ts → index-CU2md8R1.d.ts}

@@ -1,5 +1,5 @@
-import { C as UiSpecActionCapability, D as UiSpecSnapshot, Dt as UiSpecNode, K as JsonSchema, S as UiBridge, b as RenderResultRequest, c as InteractionResponse, r as ChartSpec, s as InteractionRequest, y as RenderBlock } from "./types-C3V6lAeO-BgeOvc1Y.js";
-import { I as ExternalToolSource } from "./index-CWoKOFBP.js";
+import { C as UiSpecActionCapability, D as UiSpecSnapshot, K as JsonSchema, Ot as UiSpecNode, S as UiBridge, b as RenderResultRequest, c as InteractionResponse, r as ChartSpec, s as InteractionRequest, y as RenderBlock } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { z as ExternalToolSource } from "./index-Oc3H89TJ.js";
 import { z } from "zod";
 import { ComponentType, ReactNode } from "react";
 //#region ../ui/dist/index.d.ts
@@ -80,6 +80,8 @@ interface SurfaceFormTexts {
   suggested: string;
   /** 采纳建议值的按钮 */
   useSuggestion: string;
+  /** `OpenDocument` 按钮的缺省文案（0.15.0 分册 13；技能的 `props.label` 优先） */
+  openDocument: string;
 }
 /** 可复用的部分取自 DEFAULT_INTERACTION_TEXTS，不另抄一份（AC-G10） */
 declare const DEFAULT_SURFACE_FORM_TEXTS: SurfaceFormTexts;
@@ -447,39 +449,45 @@ declare const UI_CATALOG_PROMPT_BUDGET_BYTES: number;
  * **超阈值的处置是砍组件或收窄枚举取值，不是抬高这里的数字。**
  */
 /**
- * 预算阶段。分册 12 是本版最后一处 catalog 增量（分册 11 只把 `date` 加进
- * 已有的 `Field.type`，分册 23 不碰 catalog），故在此切到 `'final'`：
+ * 预算阶段。0.11.0 分册 12 是那一版最后一处 catalog 增量，故切到 `'final'`：
  * 阈值收紧到实测终态 + 余量，且余量小于一个平均组件的成本
  * ——余量大于一个组件，等于默许下一版无声塞进一个。
+ * 0.15.0 分册 13 新增 `OpenDocument` 后仍是 `'final'`，只是实测基线换了一份。
  */
 declare const CATALOG_BUDGET_STAGE: 'entry' | 'final';
 /**
  * 阈值 = **已落地实测** + 余量，余量须小于一个平均组件的成本。
  *
- * 2026-08-14 实测终态（分册 12 落地后）：prompt 12 744 / schema 21 470，30 个组件。
- * 平均组件成本 prompt 425 / schema 716。
- * 当前余量 prompt 256 / schema 330，均小于一个平均组件——再加一个组件必红。
+ * 2026-08-26 实测终态（0.15.0 分册 13 落地后）：prompt 13 372 / schema 22 184，31 个组件。
+ * 平均组件成本 prompt 431 / schema 715。
+ * 当前余量 prompt 278 / schema 316，均小于一个平均组件——再加一个组件必红。
  *
- * ⚠️ **本版这两个数字被上调过两次**，两次都由需求方裁决并改写了需求文档
- * （分册 29 §2 范围订正 第 7 条与 §2.2），不是实现阶段自行放宽：
+ * ⚠️ **这两个数字被上调过三次**，三次都由需求方裁决并改写了需求文档，
+ * 不是实现阶段自行放宽：
  *
- * 1. 11 200 → 12 200 / 20 500 → 21 200：分册 13 组件描述由短改长。
+ * 1. 11 200 → 12 200 / 20 500 → 21 200（0.11.0 分册 29 §2 第 7 条）：分册 13 组件描述由短改长。
  *    `example` 是既有护栏的硬要求（`catalog.test.ts` 与 `catalogMatrix.test.tsx`
  *    逐个组件校验并四档渲染），靠省掉示例腾出的空间收不回来。
- * 2. 12 200 → 13 000 / 21 200 → 21 800：分册 12 的 `Split` 实测 490 + 694，
+ * 2. 12 200 → 13 000 / 21 200 → 21 800（0.11.0 分册 29 §2.2）：分册 12 的 `Split` 实测 490 + 694，
  *    超出计划增量（403 + 1 047）的 prompt 侧。需求方裁定
  *    「描述要长，可用性大于预算阈值」——收紧措辞可省回 158 字节，
  *    但砍的正是各组件「何时改用 X」的辨析句，即选型准确率本身。
+ * 3. 13 000 → 13 650 / 21 800 → 22 500（0.15.0 分册 13 §3，2026-08-26 裁决）：
+ *    新增内置组件 `OpenDocument`，实测 prompt +372 / schema +384。
+ *    该组件是本册消灭「站点技能在扩展里必然落到红框」的唯一手段，
+ *    砍它等于砍掉整册需求；改用「catalog 里有些组件不广告」则引入一个新概念，
+ *    模型看不见的组件与不存在的组件在它眼里没区别。需求方裁定取组件可用性、上调阈值，
+ *    幅度以落地后实测为准、不得预留宽裕。
  *
- * 两次上调合计把单请求成本从 21.7 KB 抬到约 34.2 KB。
- * **AC-G20 原文「超了砍组件、不抬阈值」已被推翻，但仅限本版；
- * 后续再撞顶仍须回到需求方，不得沿用本版作为先例。**
+ * 三次上调合计把单请求成本从 21.7 KB 抬到约 35.3 KB。
+ * **AC-G20 原文「超了砍组件、不抬阈值」在这三处被推翻，每次都限于当版；
+ * 后续再撞顶仍须回到需求方，本版同样不得成为第四次上调的先例。**
  */
-declare const CATALOG_PROMPT_MAX = 13000;
-declare const CATALOG_SCHEMA_MAX = 21800;
+declare const CATALOG_PROMPT_MAX = 13650;
+declare const CATALOG_SCHEMA_MAX = 22500;
 /**
- * **尚未落地**的计划增量。本版已无剩余 catalog 增量，故归零；
- * `CATALOG_BUDGET_STAGE` 同时切到 `'final'`，余量改由「小于一个平均组件」判定。
+ * **尚未落地**的计划增量。0.15.0 分册 13 已落地，故仍归零；
+ * `CATALOG_BUDGET_STAGE` 保持 `'final'`，余量改由「小于一个平均组件」判定。
  */
 declare const PLANNED_INCREMENT: {
   readonly prompt: 0;