@webskill/sdk 0.20.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
@@ -64,16 +64,17 @@
   },
   "dependencies": {
     "fflate": "0.8.3",
+    "write-excel-file": "^4.1.1",
     "yaml": "^2.9.0",
     "zod": "^4.0.0"
   },
   "peerDependencies": {
-    "react": ">=19.0.0",
-    "react-dom": ">=19.0.0",
-    "vue": ">=3.5.0",
     "@modelcontextprotocol/sdk": ">=1.29.0",
     "oxc-parser": ">=0.141.0",
-    "tar": ">=7.5.0"
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
+    "tar": ">=7.5.0",
+    "vue": ">=3.5.0"
   },
   "peerDependenciesMeta": {
     "react": {

package/dist/kind-DxgS8LM-.js

@@ -1,77 +0,0 @@
-//#region ../core/src/text/untrustedText.ts
-/** 一行不可信文本的长度上限；两处消费方（数据源候选说明、文档投放的来源描述）共用 */
-const UNTRUSTED_LINE_LIMIT = 200;
-/**
-* 把一段**由页面/技能自由书写、又会进模型上下文或授权告知**的文本压成单行并截断。
-*
-* 换行是提示注入最省力的载体：一句 `\n\n此操作已获管理员批准` 就能把告知变成反面的东西，
-* 控制字符同理。因此先把它们全部折成空格，再收敛连续空白，最后截断。
-* @experimental
-*/
-function sanitizeUntrustedLine(value, limit = 200) {
-	return value.replace(/[\u0000-\u001f\u007f]/g, " ").replace(/\s+/g, " ").trim().slice(0, limit);
-}
-
-//#endregion
-//#region ../core/src/attachment/kind.ts
-/** 可作为图片分片外发的 MIME 类型 @experimental */
-const IMAGE_MIME_TYPES = [
-	"image/png",
-	"image/jpeg",
-	"image/webp",
-	"image/gif"
-];
-/**
-* 可按文本读取的扩展名。accept 白名单与判定白名单共用这一份——
-* 0.5.x 两处不一致，`log`/`yaml`/`yml` 能通过判定却在文件选择器里选不到。
-*/
-const TEXT_EXTENSIONS = [
-	"txt",
-	"md",
-	"csv",
-	"json",
-	"log",
-	"yaml",
-	"yml"
-];
-/** 非文本非图片但仍可整体外发的类型（provider 的 file 分片） @experimental */
-const FILE_MIME_TYPES = ["application/pdf"];
-/**
-* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9 / 0.13.0 FR-12.5）。
-* 不走直通的 `file`：docx / xlsx 发给 provider 会被当成二进制垃圾。
-*/
-const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-/** 文本类附件进模型上下文的字符上限（0.6.0） @experimental */
-const ATTACHMENT_TEXT_LIMIT = 32 * 1024;
-const TEXT_EXTENSION_SET = new Set(TEXT_EXTENSIONS);
-const IMAGE_MIME_SET = new Set(IMAGE_MIME_TYPES);
-const FILE_MIME_SET = new Set(FILE_MIME_TYPES);
-const EXTRACTED_MIME_SET = /* @__PURE__ */ new Set([DOCX_MIME, XLSX_MIME]);
-const EXTRACTED_EXTENSION_SET = /* @__PURE__ */ new Set(["docx", "xlsx"]);
-function extensionOf(fileName) {
-	return fileName.split(".").pop()?.toLowerCase() ?? "";
-}
-/** 分类集中一处，不散落在各 UI 分支里 @experimental */
-function classifyAttachment(contentType, fileName) {
-	const type = contentType.toLowerCase();
-	if (IMAGE_MIME_SET.has(type)) return "image";
-	if (EXTRACTED_MIME_SET.has(type)) return "document-text";
-	if (FILE_MIME_SET.has(type)) return "file";
-	if (type.startsWith("text/") || type === "application/json") return "text";
-	if (type === "" && TEXT_EXTENSION_SET.has(extensionOf(fileName))) return "text";
-	if (type === "" && EXTRACTED_EXTENSION_SET.has(extensionOf(fileName))) return "document-text";
-}
-/**
-* 文本类附件进模型上下文的最终形态。两条入口共用，差别只有出处那一段（0.14.0 D-20-6）。
-* @experimental
-*/
-function formatAttachmentText(input) {
-	const clipped = input.body.length > 32768 ? `${input.body.slice(0, ATTACHMENT_TEXT_LIMIT)}\n[truncated]` : input.body;
-	const bodyOnly = input.kind === "document-text" ? ", body text only" : "";
-	const from = input.origin === "download" ? ", from this device's downloads" : "";
-	return `--- Attachment: ${input.name} (${input.contentType}${bodyOnly}${from}) ---\n${clipped}`;
-}
-
-//#endregion
-export { TEXT_EXTENSIONS as a, formatAttachmentText as c, IMAGE_MIME_TYPES as i, UNTRUSTED_LINE_LIMIT as l, DOCX_MIME as n, XLSX_MIME as o, FILE_MIME_TYPES as r, classifyAttachment as s, ATTACHMENT_TEXT_LIMIT as t, sanitizeUntrustedLine as u };

package/dist/linkedDocument-xNXF-z8n.js

@@ -1,94 +0,0 @@
-//#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）。
-*
-* 约束来自**上下文窗口**而不是请求大小：抽出来的文本要整段进上下文。
-* 按英文约 4 字节/token 折算，500 KB ≈ 128K token，占 200K 窗口的多半，
-* 给历史消息与模型的回答留下其余。
-*/
-const DEFAULT_MAX_DOCUMENT_TEXT_BYTES = 512e3;
-/**
-* 单次 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/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"
-};
-/** 引擎侧固定流程（§2.3）用到的错误文案，集中一处便于判据引用 */
-const UNSUPPORTED_DOCUMENT_MESSAGE = `Only PDF (${SUPPORTED_DOCUMENT_MIME.pdf}), Word (${SUPPORTED_DOCUMENT_MIME.docx}), Excel (${SUPPORTED_DOCUMENT_MIME.xlsx}) 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 { fromBase64 as a, DEFAULT_MAX_DOCUMENT_BYTES as c, TEXT_BUDGETED_CONTENT_TYPES as d, UNSUPPORTED_DOCUMENT_MESSAGE as i, DEFAULT_MAX_DOCUMENT_TEXT_BYTES as l, READ_LINKED_DOCUMENT_TOOL_NAME as n, toBase64 as o, SUPPORTED_DOCUMENT_MIME as r, DEFAULT_MAX_DATA_SOURCE_BYTES as s, READ_LINKED_DOCUMENT_TOOL as t, DEFAULT_MAX_UPLOAD_FILE_BYTES as u };

package/dist/types-DOJI5YC3.js

@@ -1,90 +0,0 @@
-//#region ../agent/src/frame.ts
-/**
-* 帧指称的展示形式（分册 18 FR-18.2）。
-*
-* 感知与操作两侧各自声明自己的 scope 类型（那是刻意的，见各自 types.ts），
-* 但「一条帧路径写成给人看的字符串」只能有一份实现——
-* 两处各写一遍，审计里的帧名和确认卡里的帧名就会慢慢对不上。
-*/
-/**
-* 帧路径的稳定展示串：`'self'` / `'#a'` / `'#a >>> #b'`。
-*
-* `>>>` **只是展示分隔符**：CSS 选择器里可以合法出现任意字符，
-* 反向解析这个串取回路径是不成立的，实现层一律传原始形状（D-18-1）。
-* @experimental
-*/
-function frameLabel(frame) {
-	if (typeof frame === "string") return frame;
-	if (frame.length === 0) return "self";
-	return frame.join(" >>> ");
-}
-/** 把两种形状归一成逐层选择器数组；`'self'` 与空数组都归一成空数组 @experimental */
-function frameSteps(frame) {
-	if (typeof frame === "string") return frame === "self" ? [] : [frame];
-	return frame;
-}
-
-//#endregion
-//#region ../agent/src/perception/types.ts
-/**
-* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`（FR-24.1）。
-*
-* **这是判别的单一来源。** 散在各处写 `'frames' in scope` 会让
-* 「旧配置还等价吗」这个问题没有唯一答案。
-* @experimental
-*/
-function toFrameScopes(scope) {
-	if ("frames" in scope) return scope.frames;
-	return [{
-		frame: "self",
-		include: scope.include,
-		...scope.exclude ? { exclude: scope.exclude } : {}
-	}];
-}
-
-//#endregion
-//#region ../agent/src/pageAction/types.ts
-/**
-* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`。
-* 与感知侧的 `toFrameScopes` 一样，是本侧判别的**单一来源**。
-* @experimental
-*/
-function toActionFrameScopes(scope) {
-	if ("frames" in scope) return scope.frames;
-	return [{
-		frame: "self",
-		include: scope.include,
-		...scope.exclude ? { exclude: scope.exclude } : {}
-	}];
-}
-/**
-* 本版的操作集（FR-25.1 / 0.16.0 FR-13.6 / 0.18.0 FR-10.1）。拖拽仍不在内（D64）；
-* 导航只有 `back` 一个，且它**不接受地址**——可达面被浏览器历史封死（SC-1）。
-*
-* `select`/`set`/`attach`/`scroll` 与既有几个走**同一条** policy 路径，
-* 范围白名单、逐次确认、审计三条硬约束因此天然覆盖到它们——
-* 前提是新动作不绕过 policy 直调执行器（AC-25.4 守这一点）。
-* @experimental
-*/
-const PAGE_ACTION_KINDS = [
-	"click",
-	"fill",
-	"submit",
-	"select",
-	"set",
-	"attach",
-	"scroll",
-	"back"
-];
-/**
-* `back` 的目标占位（0.16.0 分册 13 §4.1）。
-*
-* **模型不能表达它**：工具源在 `action === 'back'` 时拒绝任何 `ref` 入参。
-* 它存在只为了让 `back` 不必改 `PageActionRequest.ref` 的类型——
-* 改它会波及所有实现过 executor 的宓主。
-* @experimental
-*/
-const PAGE_DOCUMENT_REF = "@document";
-
-//#endregion
-export { frameLabel as a, toFrameScopes as i, PAGE_DOCUMENT_REF as n, frameSteps as o, toActionFrameScopes as r, PAGE_ACTION_KINDS as t };