@webskill/sdk 0.20.0 → 0.22.0

package/dist/linkedDocument-CIuh_Yp0.js

@@ -0,0 +1,416 @@
+import { t as WebSkillError } from "./errors-BDZNpC13.js";
+import writeXlsxFile from "write-excel-file/universal";
+
+//#region ../runtime/src/tools/types.ts
+/**
+* 参与 `toolResultMaxBytes` 截断的分片类型（FR-23.3）。**判据的单一来源。**
+*
+* 白名单而不是黑名单：黑名单式下新加的分片默认「参与截断」，
+* 漏改一处就会把一份 PDF 截成坏文件、把 docx 文本腰斩，而且没有任何报错。
+* 白名单式下新分片默认**不参与**，要受文本预算约束必须显式加进来。
+* @experimental
+*/
+const TEXT_BUDGETED_CONTENT_TYPES = /* @__PURE__ */ new Set(["text", "json"]);
+/**
+* `file` 分片的上限（FR-23.4），量的是**实际上线的 base64 长度**而不是解码后的字节——
+* provider 的限额算的是请求载荷。
+*
+* 2026-08-14 查证的三家上限：
+* | provider  | 上限                                    | 出处                    |
+* | --------- | --------------------------------------- | ----------------------- |
+* | Anthropic | **32 MB**（**整个请求载荷**）、600 页   | PDF support / 请求大小  |
+* | OpenAI    | 单文件 50 MB，全部文件合计 50 MB        | File inputs / 使用须知  |
+* | Gemini    | 50 MB 或 1000 页（内联与 Files API 同） | 文档理解 / 技术详情     |
+*
+* 取最小值 Anthropic 的 32 MB。它是**整个请求**的额度，不是文档单独的额度，
+* 所以再留出余量给系统提示词、catalog（约 34 KB）、历史消息与其余分片。
+* 25 000 KB base64 ≈ 18.75 MB 原始 PDF。取 1024 的整数倍：设置界面按 KB 展示，
+* 十进制的 24 000 000 会显示成 23437.5 这种读不出来的数。
+*/
+const DEFAULT_MAX_DOCUMENT_BYTES = 256e5;
+/**
+* `document-text` 分片的上限（FR-23.4；值由 0.22.0 分册 15 修订）。
+*
+* 它是一道**闸门**，不是配额：抽出来的文本整段进上下文，超了整份拒绝、绝不截断。
+* 抬高它不会让任何一份文档变大，只在「正文落在新旧值之间」时改变行为。
+*
+* 原值 500 KB 的依据是「按英文 4 字节/token 折算 ≈ 128K token，占 200K 窗口的多半」。
+* 那个依据有两处站不住：中文 UTF-8 约 4.5 字节/token，按英文口径设闸对中文偏紧；
+* 而窗口是宿主选的模型决定的，SDK 替宿主假定一个 2026 年初的典型值，
+* 代价由「模型明明装得下却被拒绝」的用户承担——他们从提示里看不出这一点（FR-15.1）。
+*
+* 新值之下，超窗口的失败由 provider 报出而不再由 SDK 提前拦截，这是分册 15 有意的取舍：
+* 误拒浪费的是一次**本可成功**的请求，provider 拒收浪费的是一次**必然失败**的请求。
+* SDK 不做请求体总量预检——那需要知道每个 provider 的窗口与分词口径，又回到「替宿主假定」。
+*
+* 取 1024 的整数倍：设置界面按 KB 展示（5 120 000 = 5000 KB）。
+*/
+const DEFAULT_MAX_DOCUMENT_TEXT_BYTES = 512e4;
+/**
+* 单次 fetchData 结果的字节上限（分册 16，FR-16.6）：1000 KB。
+* 结构化数据不是文档，量级差一个数量级；超出**只拒不截**——截断的 JSON 解不出来。
+*/
+const DEFAULT_MAX_DATA_SOURCE_BYTES = 1024e3;
+/**
+* 单个上传文件交给脚本的字节上限（0.15.0 分册 17，FR-17.5）：20 MB。
+* 取得比模型图片预算宽：字节不进模型上下文，只进脚本，护的是内存不是 token。
+*/
+const DEFAULT_MAX_UPLOAD_FILE_BYTES = 20 * 1024 * 1024;
+
+//#endregion
+//#region ../runtime/src/spreadsheet/types.ts
+/** 规模上限（FR-10.7）。越界一律 `VALIDATION_FAILED`，不静默截断 */
+const SPREADSHEET_LIMITS = {
+	sheets: 16,
+	rowsPerSheet: 1e4,
+	columnsPerSheet: 256,
+	/** Excel 对单个单元格文本的硬限制 */
+	charsPerCell: 32767,
+	bytes: 16 * 1024 * 1024,
+	/**
+	* 单张图片的字节上限（FR-20.6）。在解析后、编码前查，
+	* 好过让调用方等整包编码完才被告知超了 16 MB 的总顶。
+	*/
+	imageBytes: 2 * 1024 * 1024,
+	/** 单表图片张数上限；与行数上限同性质，防止一次编码退化成几千次解析 */
+	imagesPerSheet: 2e3
+};
+const SPREADSHEET_MIME_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+const SPREADSHEET_EXTENSION = ".xlsx";
+/**
+* 本版**不支持**的 xlsx 能力（FR-10.8，备案 D75）。
+*
+* 导出这张表是为了让上层能如实向用户/模型声明缺什么，而不是笼统写「基础支持」——
+* 与 `XLSX_UNEXTRACTED` 同一条口径。
+*
+* `'images'` 已于 0.22.0 分册 20 移出。`'column-widths'` **仍在**：
+* 那一册只让图片锚点所在的行列拿到够用的尺寸，没有开放通用的行高列宽 API（FR-20.5）。
+*/
+const XLSX_UNSUPPORTED = [
+	"cell-styles",
+	"fonts-and-colors",
+	"borders",
+	"formulas",
+	"merged-cells",
+	"charts",
+	"comments",
+	"date-and-time-cell-types",
+	"column-widths",
+	"frozen-panes",
+	"auto-filter",
+	"incremental-edit-of-existing-file"
+];
+
+//#endregion
+//#region ../runtime/src/spreadsheet/encodeSpreadsheet.ts
+/** Excel 不允许出现在工作表名里的字符 */
+const ILLEGAL_SHEET_NAME_CHARS = /[:\\/?*[\]]/;
+const MAX_SHEET_NAME_LENGTH = 31;
+/**
+* 图片按 96 dpi 嵌入：规格里的 `width`/`height` 是屏幕像素，
+* 96 让它们一比一落到 Excel 的默认显示比例上，也让下面两个换算用同一个基准。
+*/
+const IMAGE_DPI = 96;
+/** px → pt（1 pt = 1/72 inch，96 dpi 下即 ×0.75），再留一点余量免得图片贴着行线 */
+const PT_PER_PX = .75;
+const ROW_PADDING_PT = 4;
+/**
+* px → Excel 列宽（单位是默认字体的字符宽度）。
+* Excel 的换算是 `px = width × 7 + 5`，这里取它的逆再加一格余量。
+*/
+const COLUMN_CHAR_PX = 7;
+const COLUMN_PADDING_PX = 5;
+function invalid(message) {
+	return new WebSkillError("VALIDATION_FAILED", message);
+}
+/**
+* 把一个 `SpreadsheetCell` 映射成库的输入。
+*
+* **必须显式传 `type`**：裸值会让库自己推断类型，虽然实测 `'0123'` 恰好推断正确，
+* 但那是库的实现细节不是它的契约，而 FR-10.2a 要求「不做智能识别」。
+*
+* `''` 在这里归一成 `null`（DV-3）：xlsx 里「空文本」与「空单元格」产出的字节
+* 完全相同，归一让下游只有一条路径。
+*/
+function toCell(value) {
+	if (value === null || value === void 0 || value === "") return null;
+	if (typeof value === "string") return {
+		value,
+		type: String
+	};
+	if (typeof value === "number") return {
+		value,
+		type: Number
+	};
+	return {
+		value,
+		type: Boolean
+	};
+}
+function assertSheetName(name, index, seen) {
+	if (typeof name !== "string" || name === "") throw invalid(`Sheet ${index + 1}: "name" must be a non-empty string.`);
+	if (name.length > MAX_SHEET_NAME_LENGTH) throw invalid(`Sheet "${name}" has a name of ${name.length} characters (max ${MAX_SHEET_NAME_LENGTH}); Excel would refuse to open the file.`);
+	if (ILLEGAL_SHEET_NAME_CHARS.test(name)) throw invalid(`Sheet "${name}" has a name containing one of : \\ / ? * [ ], which Excel does not allow.`);
+	const key = name.toLowerCase();
+	const previous = seen.get(key);
+	if (previous !== void 0) throw invalid(`Sheet "${name}" duplicates the name of sheet ${previous + 1}; Excel requires unique sheet names.`);
+	seen.set(key, index);
+	return name;
+}
+function assertCell(value, sheetName, row, column) {
+	if (value === null || value === void 0) return;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw invalid(`Sheet "${sheetName}" row ${row} column ${column}: value must be a finite number.`);
+		return;
+	}
+	if (typeof value === "string") {
+		if (value.length > SPREADSHEET_LIMITS.charsPerCell) throw invalid(`Sheet "${sheetName}" row ${row} column ${column}: text is ${value.length} characters (max ${SPREADSHEET_LIMITS.charsPerCell}).`);
+		return;
+	}
+	if (typeof value === "boolean") return;
+	throw invalid(`Sheet "${sheetName}" row ${row} column ${column}: cell must be a string, number, boolean or null (got ${typeof value}).`);
+}
+function positiveInt(value) {
+	return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+/**
+* 图片的结构与定位校验（FR-20.4 / FR-20.9）。**只查规格，不碰字节**——
+* 字节要等解析出口给，而那是异步的，不能混进这个同步的一次查完里。
+*
+* 行号上界是「表头 + 数据」的总行数：超出去就没有那一行可以挂行高了。
+* 列号则**允许超出实际数据列**——把截图列排在数据右边是常见排布，那里本来就没有单元格。
+*/
+function assertImages(images, sheetName, totalRows) {
+	if (!Array.isArray(images)) throw invalid(`Sheet "${sheetName}": "images" must be an array when present.`);
+	if (images.length > SPREADSHEET_LIMITS.imagesPerSheet) throw invalid(`Sheet "${sheetName}" has ${images.length} images (max ${SPREADSHEET_LIMITS.imagesPerSheet}).`);
+	images.forEach((image, index) => {
+		const at = `Sheet "${sheetName}" image ${index + 1}`;
+		if (typeof image !== "object" || image === null) throw invalid(`${at}: must be an object.`);
+		const { ref, anchor, width, height, alt } = image;
+		if (typeof ref !== "string" || ref === "") throw invalid(`${at}: "ref" must be a non-empty string.`);
+		if (typeof anchor !== "object" || anchor === null) throw invalid(`${at} (ref "${ref}"): "anchor" must be an object with "row" and "column".`);
+		const { row, column } = anchor;
+		if (!positiveInt(row)) throw invalid(`${at} (ref "${ref}"): "anchor.row" must be a positive integer (rows start at 1).`);
+		if (!positiveInt(column)) throw invalid(`${at} (ref "${ref}"): "anchor.column" must be a positive integer (columns start at 1).`);
+		if (row > totalRows) throw invalid(`${at} (ref "${ref}"): "anchor.row" is ${row} but the sheet has ${totalRows} row(s), header included.`);
+		if (column > SPREADSHEET_LIMITS.columnsPerSheet) throw invalid(`${at} (ref "${ref}"): "anchor.column" is ${column} (max ${SPREADSHEET_LIMITS.columnsPerSheet}).`);
+		if (typeof width !== "number" || !Number.isFinite(width) || width <= 0) throw invalid(`${at} (ref "${ref}"): "width" must be a positive finite number of pixels.`);
+		if (typeof height !== "number" || !Number.isFinite(height) || height <= 0) throw invalid(`${at} (ref "${ref}"): "height" must be a positive finite number of pixels.`);
+		if (alt !== void 0 && typeof alt !== "string") throw invalid(`${at} (ref "${ref}"): "alt" must be a string when present.`);
+	});
+	return images;
+}
+/**
+* 全量校验（FR-10.7）。**在映射与编码之前一次查完**，抛第一个越界项的定位。
+*
+* 不做边查边编码：编码到一半才失败会留下一个已经开始的 Blob，
+* 而且用户看到的错误顺序取决于内部遍历顺序，不稳定。
+*/
+function assertSpec(spec) {
+	const sheets = spec?.sheets;
+	if (!Array.isArray(sheets) || sheets.length === 0) throw invalid("Spreadsheet must contain at least one sheet.");
+	if (sheets.length > SPREADSHEET_LIMITS.sheets) throw invalid(`Spreadsheet has ${sheets.length} sheets (max ${SPREADSHEET_LIMITS.sheets}).`);
+	const seen = /* @__PURE__ */ new Map();
+	sheets.forEach((sheet, index) => {
+		const name = assertSheetName(sheet?.name, index, seen);
+		const { columns, rows } = sheet;
+		if (columns !== void 0 && !Array.isArray(columns)) throw invalid(`Sheet "${name}": "columns" must be an array of header strings when present.`);
+		if (!Array.isArray(rows)) throw invalid(`Sheet "${name}": "rows" must be an array of rows.`);
+		if (rows.length > SPREADSHEET_LIMITS.rowsPerSheet) throw invalid(`Sheet "${name}" exceeds the row limit: ${rows.length} rows (max ${SPREADSHEET_LIMITS.rowsPerSheet}).`);
+		const widest = rows.reduce((max, row) => Math.max(max, Array.isArray(row) ? row.length : 0), columns?.length ?? 0);
+		if (widest > SPREADSHEET_LIMITS.columnsPerSheet) throw invalid(`Sheet "${name}" exceeds the column limit: ${widest} columns (max ${SPREADSHEET_LIMITS.columnsPerSheet}).`);
+		const headerOffset = columns === void 0 ? 0 : 1;
+		columns?.forEach((header, column) => assertCell(header, name, 1, column + 1));
+		rows.forEach((row, rowIndex) => {
+			if (!Array.isArray(row)) throw invalid(`Sheet "${name}" row ${rowIndex + 1 + headerOffset}: row must be an array of cells.`);
+			row.forEach((cell, column) => assertCell(cell, name, rowIndex + 1 + headerOffset, column + 1));
+		});
+		if (sheet.images !== void 0) assertImages(sheet.images, name, headerOffset + rows.length);
+	});
+	return sheets;
+}
+/**
+* 表头行。加粗写死在这里，**不向调用方暴露任何样式入参**——
+* D75 延后的是样式 API，不是「产出的文件里一个样式属性都不许有」：
+* 表头不加粗的表格在 Excel 里看不出哪行是表头。
+*/
+function headerRow(columns) {
+	return columns.map((header) => {
+		const cell = toCell(header);
+		return cell === null ? null : {
+			...cell,
+			fontWeight: "bold"
+		};
+	});
+}
+/**
+* 引用换字节（FR-20.3 / FR-20.6 / FR-20.9）。
+*
+* **顺序解析而非并行**：并行时先失败的是哪一张取决于各自的解析耗时，
+* 同一份坏规格两次跑出来的错误信息会不一样。与 `assertSpec` 那条
+* 「错误顺序必须稳定」是同一条理由。
+*/
+async function resolveImages(sheetName, images, resolve) {
+	const resolved = [];
+	for (const [index, image] of images.entries()) {
+		const at = `Sheet "${sheetName}" image ${index + 1} (ref "${image.ref}") at row ${image.anchor.row} column ${image.anchor.column}`;
+		const found = await resolve(image.ref);
+		if (found === void 0) throw invalid(`${at}: the reference could not be resolved to image bytes.`);
+		if (found.bytes.length === 0) throw invalid(`${at}: the reference resolved to zero bytes.`);
+		if (found.bytes.length > SPREADSHEET_LIMITS.imageBytes) throw invalid(`${at}: the image is ${found.bytes.length} bytes (max ${SPREADSHEET_LIMITS.imageBytes}).`);
+		const buffer = new ArrayBuffer(found.bytes.byteLength);
+		new Uint8Array(buffer).set(found.bytes);
+		resolved.push({
+			content: new Blob([buffer], { type: found.contentType }),
+			contentType: found.contentType,
+			width: image.width,
+			height: image.height,
+			dpi: IMAGE_DPI,
+			anchor: {
+				row: image.anchor.row,
+				column: image.anchor.column
+			},
+			...image.alt === void 0 ? {} : { description: image.alt }
+		});
+	}
+	return resolved;
+}
+/**
+* 撑开锚点所在的行与列（FR-20.5）。
+*
+* xlsx 里的图片是浮动对象，不受行高列宽约束：默认行高约 20 px 时，
+* 一张 120 px 的图会压住下面六七行数据。所以「支持图片」与「给锚点行列定尺寸」
+* 是同一件事的两半。
+*
+* 同一行/列被多张图锚定时取能容下所有图的那个尺寸。
+* 返回值是库的 `SheetOptions.columns`（列宽），行高则就地写进 `data`。
+*/
+function applyImageSizing(data, images) {
+	const rowPx = /* @__PURE__ */ new Map();
+	const columnPx = /* @__PURE__ */ new Map();
+	for (const { anchor, width, height } of images) {
+		rowPx.set(anchor.row, Math.max(rowPx.get(anchor.row) ?? 0, height));
+		columnPx.set(anchor.column, Math.max(columnPx.get(anchor.column) ?? 0, width));
+	}
+	for (const [row, px] of rowPx) {
+		const line = data[row - 1];
+		if (line === void 0) continue;
+		const height = Math.ceil(px * PT_PER_PX) + ROW_PADDING_PT;
+		const first = line[0];
+		line[0] = first === null || first === void 0 ? { height } : {
+			...first,
+			height
+		};
+	}
+	const widest = Math.max(...columnPx.keys());
+	return Array.from({ length: widest }, (_, index) => {
+		const px = columnPx.get(index + 1);
+		return px === void 0 ? {} : { width: Math.ceil((px + COLUMN_PADDING_PX) / COLUMN_CHAR_PX) + 1 };
+	});
+}
+/**
+* 把表格规格编码为 xlsx 字节。
+*
+* 纯函数——不认识产物、run 与工具，因此工具、脚本能力、测试三个消费面共用同一份
+* 实现，AC-10.8「双消费面逐字节相同」是结构性成立的。
+*
+* `resolveImage` 是图片引用的解析出口（0.22.0 分册 20 FR-20.3）。它同样不破坏纯函数性：
+* 给定相同的规格与相同的解析结果，输出逐字节相同。规格里有图片却没给它，是
+* `VALIDATION_FAILED` 而不是静默出一份缺图的文件（FR-20.9）。
+*/
+async function encodeSpreadsheet(spec, resolveImage) {
+	const sheets = assertSpec(spec);
+	const payload = [];
+	for (const sheet of sheets) {
+		const data = [...sheet.columns === void 0 ? [] : [headerRow(sheet.columns)], ...sheet.rows.map((row) => row.map(toCell))];
+		const images = sheet.images ?? [];
+		if (images.length === 0) {
+			payload.push({
+				sheet: sheet.name,
+				data
+			});
+			continue;
+		}
+		if (resolveImage === void 0) throw invalid(`Sheet "${sheet.name}" has ${images.length} image(s) but no image resolver was provided; pass one to encodeSpreadsheet() or remove the images from the spec.`);
+		payload.push({
+			sheet: sheet.name,
+			data,
+			images: await resolveImages(sheet.name, images, resolveImage),
+			columns: applyImageSizing(data, images)
+		});
+	}
+	const blob = await writeXlsxFile(payload).toBlob();
+	const bytes = new Uint8Array(await blob.arrayBuffer());
+	if (bytes.length > SPREADSHEET_LIMITS.bytes) throw invalid(`The encoded spreadsheet is ${bytes.length} bytes (max ${SPREADSHEET_LIMITS.bytes}); reduce the number of rows, sheets or images.`);
+	return bytes;
+}
+
+//#endregion
+//#region ../runtime/src/tools/linkedDocument.ts
+const READ_LINKED_DOCUMENT_TOOL_NAME = "read_linked_document";
+/**
+* 能直接给模型用的 MIME。其余一律拒绝并列出这份清单——
+* 「尽力而为地猜格式」会让模型收到乱码却以为读成功了。
+*/
+const SUPPORTED_DOCUMENT_MIME = {
+	pdf: "application/pdf",
+	docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+};
+/**
+* 读到就**只留字节**的类型（0.22.0 FR-19.9b）：不抽文本，也不作为 `file` 分片外发，
+* 模型只拿到取件号。DWG 是第一例——17 MB 图纸 base64 进请求体既烧穿预算又毫无意义，
+* 几何该交给解析器。服务端常把 `.dwg` 发成 `application/octet-stream`，所以按扩展名兜底。
+*/
+const BYTES_ONLY_DOCUMENT_MIME = [
+	"image/vnd.dwg",
+	"application/acad",
+	"application/x-acad",
+	"application/dwg",
+	"application/x-dwg",
+	"drawing/dwg"
+];
+const BYTES_ONLY_MIME_SET = new Set(BYTES_ONLY_DOCUMENT_MIME);
+/** 只按字节留存的判定。`url` 只在 MIME 说不清时用到 @experimental */
+function isBytesOnlyDocument(mime, url) {
+	if (BYTES_ONLY_MIME_SET.has(mime)) return true;
+	if (mime !== "" && mime !== "application/octet-stream") return false;
+	return ((url.split(/[?#]/)[0] ?? "").split(".").pop() ?? "").toLowerCase() === "dwg";
+}
+/** 引擎侧固定流程（§2.3）用到的错误文案，集中一处便于判据引用 */
+const UNSUPPORTED_DOCUMENT_MESSAGE = `Only PDF (${SUPPORTED_DOCUMENT_MIME.pdf}), Word (${SUPPORTED_DOCUMENT_MIME.docx}), Excel (${SUPPORTED_DOCUMENT_MIME.xlsx}), PowerPoint (${SUPPORTED_DOCUMENT_MIME.pptx}) and plain text documents can be read.`;
+const READ_LINKED_DOCUMENT_INPUT_SCHEMA = {
+	type: "object",
+	properties: { url: {
+		type: "string",
+		description: "The href of a link that appeared in a perceive_page result."
+	} },
+	required: ["url"]
+};
+/**
+* 内建工具：读页面链接指向的文档。
+*
+* **始终注册**（只要宿主装配了 reader）：docx / xlsx 与纯文本这条路对所有模型成立。
+* PDF 目标在模型不支持文档时**取数后拒绝**，而不是入口就拦 ——
+* 入口拦会误伤 docx，它抽成文本后根本不需要文档能力。
+*/
+const READ_LINKED_DOCUMENT_TOOL = {
+	name: READ_LINKED_DOCUMENT_TOOL_NAME,
+	description: "Read a document linked from the current page. Pass the exact \"href\" from a perceive_page result. Cross-origin documents need the user to confirm each time.",
+	inputSchema: READ_LINKED_DOCUMENT_INPUT_SCHEMA,
+	source: "builtin"
+};
+/** 二进制转 base64；`btoa` 只吃 latin1，必须逐字节喂而不是先 decode 成字符串 */
+function toBase64(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+/** `toBase64` 的逆；分片里的文档要交回抽取器时用（0.13.0 FR-22.3） */
+function fromBase64(data) {
+	return Uint8Array.from(atob(data), (char) => char.charCodeAt(0));
+}
+
+//#endregion
+export { DEFAULT_MAX_UPLOAD_FILE_BYTES as _, UNSUPPORTED_DOCUMENT_MESSAGE as a, toBase64 as c, SPREADSHEET_LIMITS as d, SPREADSHEET_MIME_TYPE as f, DEFAULT_MAX_DOCUMENT_TEXT_BYTES as g, DEFAULT_MAX_DOCUMENT_BYTES as h, SUPPORTED_DOCUMENT_MIME as i, encodeSpreadsheet as l, DEFAULT_MAX_DATA_SOURCE_BYTES as m, READ_LINKED_DOCUMENT_TOOL as n, fromBase64 as o, XLSX_UNSUPPORTED as p, READ_LINKED_DOCUMENT_TOOL_NAME as r, isBytesOnlyDocument as s, BYTES_ONLY_DOCUMENT_MIME as t, SPREADSHEET_EXTENSION as u, TEXT_BUDGETED_CONTENT_TYPES as v };

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
-import { K as JsonSchema, _ as LlmToolSpec, ft as SkillDocument, ut as SkillCatalogEntry } from "./types-Btpdd1y--BcxQ10Fa.js";
-import { R as ExternalSkillProvider, _n as ToolDisclosure, fr as mergeCatalogEntries, yn as ToolResult, z as ExternalToolSource } from "./index-BDyXe-a5.js";
+import { X as JsonSchema, _ as LlmToolSpec, _t as SkillDocument, ht as SkillCatalogEntry } from "./types-CpDRZ0rA-BM5FI9oN.js";
+import { B as ExternalToolSource, Hr as mergeCatalogEntries, Mn as ToolDisclosure, Pn as ToolResult, z as ExternalSkillProvider } from "./index-YPd8ZSEa.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/{memoryArtifactStore-D6dLeY55.js → memoryArtifactStore-Bs7glPqm.js}

@@ -1,9 +1,17 @@
+import { t as WebSkillError } from "./errors-BDZNpC13.js";
+
 //#region ../runtime/src/artifacts/memoryArtifactStore.ts
+function key(runId, path) {
+	return `${runId}\u0000${path}`;
+}
 /** 内存 ArtifactStore：测试与浏览器降级用；索引随进程生命周期存在 */
 var MemoryArtifactStore = class {
 	#byRun = /* @__PURE__ */ new Map();
+	/** 字节也得留着，否则 `readArtifact` 无从实现（FR-20.8）。key = runId + \0 + path */
+	#bytes = /* @__PURE__ */ new Map();
 	#seq = 0;
 	async createTextArtifact(input) {
+		this.#bytes.set(key(input.runId, input.path), new TextEncoder().encode(input.content));
 		return this.#record({
 			runId: input.runId,
 			path: input.path,
@@ -14,6 +22,7 @@ var MemoryArtifactStore = class {
 		});
 	}
 	async createBinaryArtifact(input) {
+		this.#bytes.set(key(input.runId, input.path), input.content.slice());
 		return this.#record({
 			runId: input.runId,
 			path: input.path,
@@ -26,6 +35,11 @@ var MemoryArtifactStore = class {
 	async listArtifacts(runId) {
 		return [...this.#byRun.get(runId) ?? []];
 	}
+	async readArtifact(runId, path) {
+		const found = this.#bytes.get(key(runId, path));
+		if (found === void 0) throw new WebSkillError("FS_NOT_FOUND", `Artifact "${path}" not found in run ${runId}`);
+		return found;
+	}
 	#record(input) {
 		const artifact = {
 			id: `art-${++this.#seq}`,