@webskill/sdk 0.14.0 → 0.15.0

package/dist/kind-DxgS8LM-.js

@@ -0,0 +1,77 @@
+//#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

@@ -0,0 +1,94 @@
+//#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 };