@webskill/sdk 0.27.1 → 0.28.1

package/dist/{approval-BSwffz8P.js → approval-5BmspsRi.js}

@@ -5,7 +5,7 @@ import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
 import { c as findUnpairedToolCalls, d as partsToText, f as promptText, l as interruptedToolResult, p as textParts, u as sealToolCallPairs } from "./llm-eIQNO9tr.js";
 import { a as UNSUPPORTED_DOCUMENT_MESSAGE, c as toBase64, f as SPREADSHEET_MIME_TYPE, g as DEFAULT_MAX_DOCUMENT_TEXT_BYTES, h as DEFAULT_MAX_DOCUMENT_BYTES, i as SUPPORTED_DOCUMENT_MIME, l as encodeSpreadsheet, n as READ_LINKED_DOCUMENT_TOOL, o as fromBase64, r as READ_LINKED_DOCUMENT_TOOL_NAME, s as isBytesOnlyDocument, v as TEXT_BUDGETED_CONTENT_TYPES } from "./linkedDocument-0iiVPd5t.js";
 import { t as mergeCatalogEntries } from "./external-_ZRQe-V9.js";
-import { i as isArtifactCardHidden, n as extractChartSpec, r as admitArtifactMetadata, t as buildRenderResult } from "./renderResult-D9Q-Vu2x.js";
+import { i as isArtifactCardHidden, n as extractChartSpec, r as admitArtifactMetadata, t as buildRenderResult } from "./renderResult-2v3WQzs_.js";
 import { t as extractUiSpecEvents } from "./surface-DVGiCmwq.js";
 import { t as MemoryArtifactStore } from "./memoryArtifactStore-Bs7glPqm.js";
 

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
-import { G as FileStat, It as VerifyResult, K as FileSystemProvider, Lt as WebSkillError, N as ArchiveLimits, Ot as SkillsLockfile, Pt as UnsignedPolicy, S as UiBridge, St as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as TrustedKeyStore, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, q as FileWriteStream, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore, vt as SkillInstallSource } from "./types-CpDRZ0rA-CFQ-vdKz.js";
-import { $ as ImageOmission, B as ExternalToolSource, C as BridgeResponse, N as DocumentSurfaceHost, Pn as ToolResult, S as BridgeRequest, Sr as bridgeError, Yr as parseBridgeRequest, b as BridgeCapabilities, ct as LinkedDocumentReader, en as ScriptExecutionContext, jn as ToolDefinition, m as ApprovalScope, mr as WebSkillApi, sr as ViewerImageFact, tn as ScriptExecutor, ut as NetworkPolicy, z as ExternalSkillProvider } from "./index-D6eSrEi5.js";
-import { $r as XlsxTableReader, In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, Xr as XlsxDocumentReader, Yr as XlsxDocumentContent, cn as PageActionRequest, dn as PageActionTarget, fr as SubtreeRejection, in as PageActionOutcome, jn as PerceptionCaptureOptions, kn as PerceivedNode, mn as PageAuditSink, nn as PageActionExecutor, q as DocxDocumentReader, u as ConsentUi, un as PageActionScopeInput, xn as PagePerceptionReader, yn as PagePerceptionPolicy } from "./index--GvzV6Lq.js";
+import { G as FileStat, It as VerifyResult, K as FileSystemProvider, Lt as WebSkillError, N as ArchiveLimits, Ot as SkillsLockfile, Pt as UnsignedPolicy, S as UiBridge, St as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as TrustedKeyStore, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, q as FileWriteStream, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore, vt as SkillInstallSource } from "./types-wKp3YBSM-167azx1H.js";
+import { $ as ImageOmission, B as ExternalToolSource, C as BridgeResponse, N as DocumentSurfaceHost, Pn as ToolResult, S as BridgeRequest, Sr as bridgeError, Yr as parseBridgeRequest, b as BridgeCapabilities, ct as LinkedDocumentReader, en as ScriptExecutionContext, jn as ToolDefinition, m as ApprovalScope, mr as WebSkillApi, sr as ViewerImageFact, tn as ScriptExecutor, ut as NetworkPolicy, z as ExternalSkillProvider } from "./index-DU8sKyQq.js";
+import { In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, cn as PageActionRequest, dn as PageActionTarget, ii as XlsxDocumentReader, in as PageActionOutcome, jn as PerceptionCaptureOptions, kn as PerceivedNode, mn as PageAuditSink, nn as PageActionExecutor, q as DocxDocumentReader, ri as XlsxDocumentContent, si as XlsxTableReader, u as ConsentUi, un as PageActionScopeInput, xn as PagePerceptionReader, yn as PagePerceptionPolicy, yr as SubtreeRejection } from "./index-CkauSvus.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -18,6 +18,7 @@ declare class OpfsProvider implements FileSystemProvider {
   writeText(p: string, content: string): Promise<void>;
   appendText(p: string, content: string): Promise<void>;
   readBinary(p: string): Promise<Uint8Array>;
+  createReadStream(p: string): Promise<AsyncIterable<Uint8Array>>;
   writeBinary(p: string, content: Uint8Array): Promise<void>;
   /**
    * 分块写入（FR-18.2c）。`createWritable()` 本身就是写 swap 文件、`close()` 才提交，
@@ -1650,11 +1651,10 @@ declare function readXlsxBlocks(bytes: Uint8Array): Promise<XlsxDocumentContent>
 //#endregion
 //#region src/document/xlsxTable.d.ts
 /**
- * xlsx → 单元格网格（0.26.0 分册 10 · FR-10.20）。
+ * xlsx → 单元格网格或可重复扫描的行流。
  *
- * 与 `extractXlsxText` 共用 `readXlsxWorkbook` 的同一份解析（单元格取值、日期换算、空格补位），
- * 所以画像与查询看到的格，和模型从文本里读到的格是同一批。
- * 错误语义同 `extractXlsxText`：旧版 `.xls`、归档损坏、缺 `xl/workbook.xml` 都抛 `WebSkillError`。
+ * `read` 保留既有网格契约；`readStreaming` 用 SAX 逐行解析工作表，不受整包解压的 64 MiB 条目上限约束。
+ * 两条路径使用同一套单元格取值、日期换算与空格补位规则，错误均带 `WebSkillError`。
  * @experimental
  */
 declare function createXlsxTableReader(): XlsxTableReader;

package/dist/browser.js

@@ -3,13 +3,14 @@ import { A as SKILL_MANIFEST_FILE, D as verifySkillSignature, M as buildManifest
 import { o as atomicWriteText, r as resolveInsideRoot, s as isAtomicTempPath } from "./pathSecurity-CirkQwWP.js";
 import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
 import { t as ATTACHMENT_TEXT_LIMIT } from "./kind-Dc8x0HWz.js";
-import { _ as FsRunSnapshotStore, a as networkPolicyLibSource, c as bridgeError, ct as ProgressiveRouter, d as FsMemoryStore, l as parseBridgeRequest, m as AgentLoop, r as normalizeToolError, s as UPLOAD_FILES_UNAVAILABLE, t as CapabilityApproval, u as FsArtifactStore } from "./approval-BSwffz8P.js";
+import { _ as FsRunSnapshotStore, a as networkPolicyLibSource, c as bridgeError, ct as ProgressiveRouter, d as FsMemoryStore, l as parseBridgeRequest, m as AgentLoop, r as normalizeToolError, s as UPLOAD_FILES_UNAVAILABLE, t as CapabilityApproval, u as FsArtifactStore } from "./approval-5BmspsRi.js";
 import { a as GoogleGenAiClient, o as AnthropicClient, s as OpenAiCompatibleClient, t as MockLlmClient } from "./llm-eIQNO9tr.js";
 import { c as toBase64$1, f as SPREADSHEET_MIME_TYPE } from "./linkedDocument-0iiVPd5t.js";
 import { n as normalizeToolContent, t as mergeCatalogEntries } from "./external-_ZRQe-V9.js";
-import { t as createWebSkillApi } from "./webSkillApi-C_7CTwtB.js";
+import { t as createWebSkillApi } from "./webSkillApi-rX2e3SVB.js";
 import { A as frameSteps, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, k as frameLabel, l as parseCellAddress, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP$1, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage } from "./geometry-BXMPNuM6.js";
-import { zipSync } from "fflate";
+import { Unzip, UnzipInflate, zipSync } from "fflate";
+import { SaxesParser } from "saxes";
 
 //#region ../browser/src/fs/featureDetection.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -98,6 +99,21 @@ var OpfsProvider = class {
 			return new Uint8Array(await (await handle.getFile()).arrayBuffer());
 		});
 	}
+	async createReadStream(p) {
+		const stream = (await this.#wrap(p, async () => (await this.#walkFile(p)).getFile())).stream();
+		return (async function* () {
+			const reader = stream.getReader();
+			try {
+				for (;;) {
+					const { done, value } = await reader.read();
+					if (done) return;
+					if (value !== void 0) yield value;
+				}
+			} finally {
+				reader.releaseLock();
+			}
+		})();
+	}
 	async writeBinary(p, content) {
 		await this.#wrap(p, async () => {
 			const segments = this.#segments(p);
@@ -6437,12 +6453,12 @@ const XLSX_UNEXTRACTED = [
 	"hidden row and column marking",
 	"formula expressions (only cached values are read)"
 ];
-const WORKBOOK = "xl/workbook.xml";
-const WORKBOOK_RELS = "xl/_rels/workbook.xml.rels";
-const SHARED_STRINGS = "xl/sharedStrings.xml";
-const STYLES = "xl/styles.xml";
+const WORKBOOK$1 = "xl/workbook.xml";
+const WORKBOOK_RELS$1 = "xl/_rels/workbook.xml.rels";
+const SHARED_STRINGS$1 = "xl/sharedStrings.xml";
+const STYLES$1 = "xl/styles.xml";
 /** OLE2 复合文档签名：旧版 .xls 的开头，它不是 zip，走不到解压那一步 */
-const OLE2_SIGNATURE = [
+const OLE2_SIGNATURE$1 = [
 	208,
 	207,
 	17,
@@ -6467,14 +6483,14 @@ const BUILTIN_DATE_FORMATS = /* @__PURE__ */ new Set([
 	46,
 	47
 ]);
-function fail(message) {
+function fail$1(message) {
 	throw new WebSkillError("TOOL_EXECUTION_FAILED", message);
 }
 /** 按 localName 取子孙元素，忽略命名空间前缀：不同生成器的前缀写法并不统一 */
-const byTag$3 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
-function parseXml$3(bytes, what) {
+const byTag$4 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+function parseXml$4(bytes, what) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
-	if (doc.getElementsByTagName("parsererror").length > 0) fail(`The workbook ${what} could not be parsed as XML.`);
+	if (doc.getElementsByTagName("parsererror").length > 0) fail$1(`The workbook ${what} could not be parsed as XML.`);
 	return doc;
 }
 /** `B` → 1、`AA` → 26；拿不到列号时返回 undefined，由调用方顺位补上 */
@@ -6519,14 +6535,14 @@ function isDateFormatCode(code) {
 /** 单元格样式索引 → 是否日期格式 */
 function readDateStyles(bytes) {
 	if (bytes === void 0) return [];
-	const doc = parseXml$3(bytes, "styles");
+	const doc = parseXml$4(bytes, "styles");
 	const custom = /* @__PURE__ */ new Map();
-	for (const fmt of byTag$3(doc, "numFmt")) {
+	for (const fmt of byTag$4(doc, "numFmt")) {
 		const id = Number(fmt.getAttribute("numFmtId"));
 		const code = fmt.getAttribute("formatCode");
 		if (Number.isFinite(id) && code !== null) custom.set(id, code);
 	}
-	const cellXfs = byTag$3(doc, "cellXfs")[0];
+	const cellXfs = byTag$4(doc, "cellXfs")[0];
 	if (cellXfs === void 0) return [];
 	return [...cellXfs.children].filter((xf) => xf.localName === "xf").map((xf) => {
 		const id = Number(xf.getAttribute("numFmtId") ?? "0");
@@ -6591,7 +6607,7 @@ function cellText$1(cell, shared, dateStyles, date1904) {
 function sheetRows(doc, shared, dateStyles, date1904) {
 	const rows = [];
 	let previousRow = 0;
-	for (const row of byTag$3(doc, "row")) {
+	for (const row of byTag$4(doc, "row")) {
 		const declared = Number(row.getAttribute("r"));
 		const rowNumber = Number.isInteger(declared) && declared > 0 ? declared : previousRow + 1;
 		for (let gap = previousRow + 1; gap < rowNumber; gap++) rows.push([]);
@@ -6614,9 +6630,9 @@ function sheetRows(doc, shared, dateStyles, date1904) {
 }
 /** 一行的文本：单元格用制表符分隔（与 docx 的表格同口径），行尾制表符不留 */
 const rowLine = (cells) => cells.join("	").replace(/\t+$/, "");
-const looksLikeOle2 = (bytes) => bytes.length >= OLE2_SIGNATURE.length && OLE2_SIGNATURE.every((byte, i) => bytes[i] === byte);
+const looksLikeOle2 = (bytes) => bytes.length >= OLE2_SIGNATURE$1.length && OLE2_SIGNATURE$1.every((byte, i) => bytes[i] === byte);
 /** rels 里的 Target 可能是相对 `xl/` 的，也可能是包根绝对路径 */
-function resolveSheetPath(target) {
+function resolveSheetPath$1(target) {
 	const clean = target.replace(/^\.\//, "");
 	return clean.startsWith("/") ? clean.slice(1) : `xl/${clean}`;
 }
@@ -6626,37 +6642,37 @@ function resolveSheetPath(target) {
 * @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 */
 async function readXlsxWorkbook(bytes) {
-	if (looksLikeOle2(bytes)) fail("This is a legacy .xls workbook, which is not supported. Save it as .xlsx and try again.");
+	if (looksLikeOle2(bytes)) fail$1("This is a legacy .xls workbook, which is not supported. Save it as .xlsx and try again.");
 	let entries;
 	try {
 		entries = await unzipWithLimits(bytes);
 	} catch {
-		fail("This file could not be read as an Excel workbook: the archive is damaged or not a .xlsx file.");
+		fail$1("This file could not be read as an Excel workbook: the archive is damaged or not a .xlsx file.");
 	}
 	const parts = new Map(entries);
-	const workbookBytes = parts.get(WORKBOOK);
-	if (workbookBytes === void 0) fail(`This file is not an Excel workbook: it has no ${WORKBOOK} entry.`);
-	const workbook = parseXml$3(workbookBytes, "index");
-	const workbookPr = byTag$3(workbook, "workbookPr")[0];
+	const workbookBytes = parts.get(WORKBOOK$1);
+	if (workbookBytes === void 0) fail$1(`This file is not an Excel workbook: it has no ${WORKBOOK$1} entry.`);
+	const workbook = parseXml$4(workbookBytes, "index");
+	const workbookPr = byTag$4(workbook, "workbookPr")[0];
 	const date1904 = workbookPr?.getAttribute("date1904") === "1" || workbookPr?.getAttribute("date1904") === "true";
-	const relsBytes = parts.get(WORKBOOK_RELS);
+	const relsBytes = parts.get(WORKBOOK_RELS$1);
 	const targets = /* @__PURE__ */ new Map();
-	if (relsBytes !== void 0) for (const rel of byTag$3(parseXml$3(relsBytes, "relationships"), "Relationship")) {
+	if (relsBytes !== void 0) for (const rel of byTag$4(parseXml$4(relsBytes, "relationships"), "Relationship")) {
 		const id = rel.getAttribute("Id");
 		const target = rel.getAttribute("Target");
-		if (id !== null && target !== null) targets.set(id, resolveSheetPath(target));
+		if (id !== null && target !== null) targets.set(id, resolveSheetPath$1(target));
 	}
-	const sharedBytes = parts.get(SHARED_STRINGS);
-	const shared = sharedBytes === void 0 ? [] : byTag$3(parseXml$3(sharedBytes, "shared strings"), "si").map(sharedStringText);
-	const dateStyles = readDateStyles(parts.get(STYLES));
+	const sharedBytes = parts.get(SHARED_STRINGS$1);
+	const shared = sharedBytes === void 0 ? [] : byTag$4(parseXml$4(sharedBytes, "shared strings"), "si").map(sharedStringText);
+	const dateStyles = readDateStyles(parts.get(STYLES$1));
 	const sheets = [];
-	for (const [ordinal, sheet] of byTag$3(workbook, "sheet").entries()) {
+	for (const [ordinal, sheet] of byTag$4(workbook, "sheet").entries()) {
 		const name = sheet.getAttribute("name") ?? `Sheet${ordinal + 1}`;
 		const relId = sheet.getAttributeNS("http://schemas.openxmlformats.org/officeDocument/2006/relationships", "id") ?? sheet.getAttribute("r:id");
 		const path = relId !== null ? targets.get(relId) : void 0;
 		const sheetBytes = path !== void 0 ? parts.get(path) : void 0;
-		if (path === void 0 || sheetBytes === void 0) fail(`The worksheet "${name}" could not be located inside the workbook.`);
-		const rows = sheetRows(parseXml$3(sheetBytes, `worksheet "${name}"`), shared, dateStyles, date1904);
+		if (path === void 0 || sheetBytes === void 0) fail$1(`The worksheet "${name}" could not be located inside the workbook.`);
+		const rows = sheetRows(parseXml$4(sheetBytes, `worksheet "${name}"`), shared, dateStyles, date1904);
 		const lines = rows.map(rowLine);
 		while (lines.length > 0 && lines[lines.length - 1] === "") {
 			lines.pop();
@@ -6738,7 +6754,7 @@ const DEFAULT_BODY_TWIPS = 9360;
 function attr(node, name) {
 	for (const item of node.attributes) if (item.name === name || item.localName === name) return item.value;
 }
-function parseXml$2(bytes, what) {
+function parseXml$3(bytes, what) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
 	if (doc.getElementsByTagName("parsererror").length > 0) throw new WebSkillError("TOOL_EXECUTION_FAILED", `The Word document's ${what} could not be parsed as XML.`);
 	return doc;
@@ -6801,10 +6817,10 @@ async function readDocxBlocks(bytes) {
 	const files = new Map(entries);
 	const main = files.get(DOCUMENT$1);
 	if (main === void 0) throw new WebSkillError("TOOL_EXECUTION_FAILED", `This file is not a Word document: it has no ${DOCUMENT$1} entry.`);
-	const doc = parseXml$2(main, "body");
+	const doc = parseXml$3(main, "body");
 	const targets = /* @__PURE__ */ new Map();
 	const rels = files.get(RELS);
-	if (rels !== void 0) for (const rel of parseXml$2(rels, "relationships").getElementsByTagName("Relationship")) {
+	if (rels !== void 0) for (const rel of parseXml$3(rels, "relationships").getElementsByTagName("Relationship")) {
 		const id = attr(rel, "Id");
 		const target = attr(rel, "Target");
 		if (id !== void 0 && target !== void 0) targets.set(id, `word/${target.replace(/^\.?\//, "")}`);
@@ -6853,8 +6869,8 @@ const ANCHOR_TAGS = /* @__PURE__ */ new Set([
 /** 绝对锚点没有行号；放在表尾，保证图片不丢。 */
 const AFTER_LAST_ROW = Number.MAX_SAFE_INTEGER;
 const RELATIONSHIPS_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-const byTag$2 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
-function parseXml$1(bytes) {
+const byTag$3 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+function parseXml$2(bytes) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
 	return doc.getElementsByTagName("parsererror").length > 0 ? void 0 : doc;
 }
@@ -6875,9 +6891,9 @@ const relsOf = (path) => `${dirOf(path)}_rels/${path.slice(path.lastIndexOf("/")
 function readRels(parts, path) {
 	const out = /* @__PURE__ */ new Map();
 	const bytes = parts.get(relsOf(path));
-	const doc = bytes === void 0 ? void 0 : parseXml$1(bytes);
+	const doc = bytes === void 0 ? void 0 : parseXml$2(bytes);
 	if (doc === void 0) return out;
-	for (const rel of byTag$2(doc, "Relationship")) {
+	for (const rel of byTag$3(doc, "Relationship")) {
 		const id = rel.getAttribute("Id");
 		const target = rel.getAttribute("Target");
 		if (id !== null && target !== null) out.set(id, resolveRelative$1(dirOf(path), target));
@@ -6885,7 +6901,7 @@ function readRels(parts, path) {
 	return out;
 }
 const anchorNumber = (anchor, name) => {
-	const node = anchor === void 0 ? void 0 : byTag$2(anchor, name)[0];
+	const node = anchor === void 0 ? void 0 : byTag$3(anchor, name)[0];
 	const value = Number(node?.textContent ?? NaN);
 	return Number.isInteger(value) && value >= 0 ? value : 0;
 };
@@ -6902,14 +6918,14 @@ function imagesOf(parts, sheetPath) {
 	for (const [, target] of sheetRels) {
 		if (!target.includes("/drawings/")) continue;
 		const drawingBytes = parts.get(target);
-		const drawing = drawingBytes === void 0 ? void 0 : parseXml$1(drawingBytes);
+		const drawing = drawingBytes === void 0 ? void 0 : parseXml$2(drawingBytes);
 		if (drawing === void 0) continue;
 		const drawingRels = readRels(parts, target);
 		const anchors = [...drawing.documentElement?.children ?? []].filter((element) => ANCHOR_TAGS.has(element.localName));
 		for (const anchor of anchors) {
-			const from = byTag$2(anchor, "from")[0];
+			const from = byTag$3(anchor, "from")[0];
 			const row = anchor.localName === "absoluteAnchor" || from === void 0 ? AFTER_LAST_ROW : anchorNumber(from, "row");
-			const blip = byTag$2(anchor, "blip")[0];
+			const blip = byTag$3(anchor, "blip")[0];
 			const relId = blip?.getAttributeNS(RELATIONSHIPS_NS, "embed") ?? blip?.getAttribute("r:embed");
 			const path = relId === null || relId === void 0 ? void 0 : drawingRels.get(relId);
 			const data = path === void 0 ? void 0 : parts.get(path);
@@ -6951,18 +6967,368 @@ async function readXlsxBlocks(bytes) {
 	return { sheets: out };
 }
 
+//#endregion
+//#region ../browser/src/document/xlsxStreaming.ts
+const WORKBOOK = "xl/workbook.xml";
+const WORKBOOK_RELS = "xl/_rels/workbook.xml.rels";
+const SHARED_STRINGS = "xl/sharedStrings.xml";
+const STYLES = "xl/styles.xml";
+const OLE2_SIGNATURE = [
+	208,
+	207,
+	17,
+	224,
+	161,
+	177,
+	26,
+	225
+];
+function fail(message) {
+	throw new WebSkillError("TOOL_EXECUTION_FAILED", message);
+}
+async function sourceChunks(source) {
+	if (typeof source !== "function") return (async function* () {
+		yield source;
+	})();
+	return await source();
+}
+async function* entryChunks(source, path, state) {
+	const output = [];
+	let failure;
+	const unzip = new Unzip();
+	unzip.register(UnzipInflate);
+	unzip.onfile = (file) => {
+		if (file.name !== path) return;
+		state.found = true;
+		file.ondata = (error, chunk) => {
+			if (error !== null) failure = error;
+			else if (failure === void 0) output.push(chunk);
+		};
+		file.start();
+	};
+	try {
+		const chunks = await sourceChunks(source);
+		for await (const chunk of chunks) {
+			unzip.push(chunk, false);
+			yield* output.splice(0);
+			await Promise.resolve();
+			yield* output.splice(0);
+		}
+		unzip.push(/* @__PURE__ */ new Uint8Array(), true);
+		await Promise.resolve();
+		yield* output.splice(0);
+	} catch (e) {
+		failure ??= e;
+	}
+	if (failure !== void 0) {
+		if (failure instanceof WebSkillError) throw failure;
+		throw new WebSkillError("TOOL_EXECUTION_FAILED", `The workbook entry "${path}" could not be read: ${failure instanceof Error ? failure.message : String(failure)}`, failure);
+	}
+}
+async function entryBytes(source, path) {
+	const chunks = [];
+	let total = 0;
+	const state = { found: false };
+	for await (const chunk of entryChunks(source, path, state)) {
+		chunks.push(chunk);
+		total += chunk.byteLength;
+	}
+	if (!state.found) return void 0;
+	const out = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return out;
+}
+function parseXml$1(bytes, what) {
+	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
+	if (doc.getElementsByTagName("parsererror").length > 0) fail(`The workbook ${what} could not be parsed as XML.`);
+	return doc;
+}
+const byTag$2 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+const localName = (value) => {
+	const name = typeof value === "string" ? value : value.name;
+	return name.slice(name.lastIndexOf(":") + 1);
+};
+function attribute(tag, name) {
+	const direct = tag.attributes[name];
+	if (direct !== void 0) return direct;
+	const key = Object.keys(tag.attributes).find((candidate) => candidate.endsWith(`:${name}`));
+	return key === void 0 ? null : tag.attributes[key] ?? null;
+}
+function newParser(onError) {
+	const parser = new SaxesParser();
+	parser.on("error", onError);
+	return parser;
+}
+async function readSharedStrings(source) {
+	const shared = [];
+	let inside = false;
+	let textDepth = 0;
+	let phoneticDepth = 0;
+	let text = "";
+	let parseError;
+	const parser = newParser((error) => {
+		parseError = error;
+	});
+	parser.on("opentag", (tag) => {
+		const name = localName(tag.name);
+		if (name === "si") {
+			inside = true;
+			text = "";
+		} else if (inside && name === "rPh") phoneticDepth += 1;
+		else if (inside && name === "t" && phoneticDepth === 0) textDepth += 1;
+	});
+	parser.on("text", (value) => {
+		if (inside && textDepth > 0 && phoneticDepth === 0) text += value;
+	});
+	parser.on("cdata", (value) => {
+		if (inside && textDepth > 0 && phoneticDepth === 0) text += value;
+	});
+	parser.on("closetag", (nameValue) => {
+		const name = localName(nameValue);
+		if (name === "t" && textDepth > 0) textDepth -= 1;
+		else if (name === "rPh" && phoneticDepth > 0) phoneticDepth -= 1;
+		else if (name === "si" && inside) {
+			shared.push(text);
+			inside = false;
+			text = "";
+		}
+	});
+	const state = { found: false };
+	const decoder = new TextDecoder();
+	for await (const chunk of entryChunks(source, SHARED_STRINGS, state)) parser.write(decoder.decode(chunk, { stream: true }));
+	if (!state.found) return [];
+	parser.write(decoder.decode());
+	parser.close();
+	if (parseError !== void 0) fail(`The workbook shared strings could not be parsed as XML: ${parseError.message}`);
+	return shared;
+}
+function scanWorksheet(source, path, shared, dateStyles, date1904) {
+	return (async function* () {
+		const queue = [];
+		let previousRow = 0;
+		let lastYielded = 0;
+		let rowNumber = 0;
+		let cells = [];
+		let nextColumn = 0;
+		let cell;
+		let parseError;
+		const parser = newParser((error) => {
+			parseError = error;
+		});
+		const drain = async function* () {
+			for (const entry of queue.splice(0)) {
+				for (let gap = lastYielded + 1; gap < entry.row; gap += 1) yield {
+					row: gap,
+					cells: []
+				};
+				lastYielded = entry.row;
+				yield entry;
+			}
+		};
+		parser.on("opentag", (tag) => {
+			const name = localName(tag.name);
+			if (name === "row") {
+				const declared = Number(attribute(tag, "r"));
+				rowNumber = Number.isInteger(declared) && declared > 0 ? declared : previousRow + 1;
+				previousRow = rowNumber;
+				cells = [];
+				nextColumn = 0;
+				return;
+			}
+			if (name === "c") {
+				const column = columnIndex(attribute(tag, "r")) ?? nextColumn;
+				cell = {
+					type: attribute(tag, "t"),
+					style: Number(attribute(tag, "s") ?? "0"),
+					column,
+					raw: "",
+					inline: "",
+					valueDepth: 0,
+					inlineDepth: 0,
+					textDepth: 0,
+					phoneticDepth: 0
+				};
+				nextColumn = column + 1;
+			} else if (cell !== void 0 && name === "v") cell.valueDepth += 1;
+			else if (cell !== void 0 && name === "is") cell.inlineDepth += 1;
+			else if (cell !== void 0 && name === "rPh" && cell.inlineDepth > 0) cell.phoneticDepth += 1;
+			else if (cell !== void 0 && name === "t" && cell.inlineDepth > 0 && cell.phoneticDepth === 0) cell.textDepth += 1;
+		});
+		parser.on("text", (value) => {
+			if (cell === void 0) return;
+			if (cell.valueDepth > 0) cell.raw += value;
+			if (cell.textDepth > 0 && cell.phoneticDepth === 0) cell.inline += value;
+		});
+		parser.on("cdata", (value) => {
+			if (cell === void 0) return;
+			if (cell.valueDepth > 0) cell.raw += value;
+			if (cell.textDepth > 0 && cell.phoneticDepth === 0) cell.inline += value;
+		});
+		parser.on("closetag", (nameValue) => {
+			const name = localName(nameValue);
+			if (cell !== void 0 && name === "t" && cell.textDepth > 0) cell.textDepth -= 1;
+			else if (cell !== void 0 && name === "rPh" && cell.phoneticDepth > 0) cell.phoneticDepth -= 1;
+			else if (cell !== void 0 && name === "is" && cell.inlineDepth > 0) cell.inlineDepth -= 1;
+			else if (cell !== void 0 && name === "v" && cell.valueDepth > 0) cell.valueDepth -= 1;
+			else if (name === "c" && cell !== void 0) {
+				let text = cell.raw;
+				if (cell.type === "inlineStr") text = cell.inline;
+				else if (cell.type === "s") {
+					const index = Number(cell.raw);
+					text = Number.isInteger(index) ? shared[index] ?? "" : "";
+				} else if (cell.type === "b") text = cell.raw === "1" ? "TRUE" : "FALSE";
+				else if (cell.type !== "str" && cell.type !== "e" && cell.raw !== "") {
+					const numeric = Number(cell.raw);
+					if (Number.isFinite(numeric) && Number.isInteger(cell.style) && dateStyles[cell.style] === true) text = serialToIso(numeric, date1904);
+				}
+				for (let gap = cells.length; gap < cell.column; gap += 1) cells.push("");
+				if (cells.length > cell.column) cells[cell.column] = text;
+				else cells.push(text);
+				cell = void 0;
+			} else if (name === "row") {
+				while (cells.length > 0 && cells[cells.length - 1] === "") cells.pop();
+				if (cells.length > 0) queue.push({
+					row: rowNumber,
+					cells
+				});
+				cells = [];
+			}
+		});
+		const state = { found: false };
+		const decoder = new TextDecoder();
+		for await (const chunk of entryChunks(source, path, state)) {
+			parser.write(decoder.decode(chunk, { stream: true }));
+			yield* drain();
+		}
+		if (!state.found) fail(`The worksheet entry "${path}" could not be located inside the workbook.`);
+		parser.write(decoder.decode());
+		parser.close();
+		if (parseError !== void 0) fail(`The worksheet "${path}" could not be parsed as XML: ${parseError.message}`);
+		yield* drain();
+	})();
+}
+function blank(cells) {
+	return cells.every((value) => value.trim() === "");
+}
+function wide(code) {
+	return code >= 19968 && code <= 40959 || code >= 13312 && code <= 19903 || code >= 12288 && code <= 12543 || code >= 44032 && code <= 55215 || code >= 63744 && code <= 64255 || code >= 65280 && code <= 65519;
+}
+const MAX_CACHED_ROWS = 5e4;
+const MAX_CACHED_CELLS = 5e5;
+async function measure(sheet) {
+	let rowCount = 0;
+	let columnCount = 0;
+	let firstNonEmptyRow = 0;
+	let firstRow = [];
+	let dataRows = 0;
+	let wideChars = 0;
+	let otherChars = sheet.name.length + 8;
+	let cellCount = 0;
+	const rows = [];
+	for await (const entry of sheet.scan()) {
+		rowCount += 1;
+		cellCount += entry.cells.length;
+		if (rowCount <= MAX_CACHED_ROWS && cellCount <= MAX_CACHED_CELLS) rows.push(entry);
+		columnCount = Math.max(columnCount, entry.cells.length);
+		otherChars += Math.max(entry.cells.length - 1, 0) + 1;
+		for (const value of entry.cells) for (let index = 0; index < value.length; index += 1) if (wide(value.charCodeAt(index))) wideChars += 1;
+		else otherChars += 1;
+		if (blank(entry.cells)) continue;
+		if (firstNonEmptyRow === 0) {
+			firstNonEmptyRow = entry.row;
+			firstRow = entry.cells;
+		} else dataRows += 1;
+	}
+	return {
+		meta: {
+			rowCount,
+			columnCount,
+			firstNonEmptyRow,
+			firstRow,
+			dataRows,
+			estimatedTokens: wideChars + Math.ceil(otherChars / 4),
+			textChars: wideChars + otherChars
+		},
+		...rowCount <= MAX_CACHED_ROWS && cellCount <= MAX_CACHED_CELLS ? { rows } : {}
+	};
+}
+function resolveSheetPath(target) {
+	const clean = target.replace(/^\.\//, "");
+	return clean.startsWith("/") ? clean.slice(1) : `xl/${clean}`;
+}
+async function readStreamingXlsxWorkbook(source) {
+	if (typeof source !== "function" && OLE2_SIGNATURE.every((byte, index) => source[index] === byte)) fail("This is a legacy .xls workbook, which is not supported. Save it as .xlsx and try again.");
+	const workbookBytes = await entryBytes(source, WORKBOOK);
+	if (workbookBytes === void 0) fail(`This file is not an Excel workbook: it has no ${WORKBOOK} entry.`);
+	const workbook = parseXml$1(workbookBytes, "index");
+	const workbookPr = byTag$2(workbook, "workbookPr")[0];
+	const date1904 = workbookPr?.getAttribute("date1904") === "1" || workbookPr?.getAttribute("date1904") === "true";
+	const relsBytes = await entryBytes(source, WORKBOOK_RELS);
+	const targets = /* @__PURE__ */ new Map();
+	if (relsBytes !== void 0) for (const rel of byTag$2(parseXml$1(relsBytes, "relationships"), "Relationship")) {
+		const id = rel.getAttribute("Id");
+		const target = rel.getAttribute("Target");
+		if (id !== null && target !== null) targets.set(id, resolveSheetPath(target));
+	}
+	const [shared, dateStyles] = await Promise.all([readSharedStrings(source), entryBytes(source, STYLES).then((bytes) => readDateStyles(bytes))]);
+	const sheets = [];
+	for (const [ordinal, sheet] of byTag$2(workbook, "sheet").entries()) {
+		const name = sheet.getAttribute("name") ?? `Sheet${ordinal + 1}`;
+		const relId = sheet.getAttributeNS("http://schemas.openxmlformats.org/officeDocument/2006/relationships", "id") ?? sheet.getAttribute("r:id");
+		const path = relId !== null ? targets.get(relId) : void 0;
+		if (path === void 0) fail(`The worksheet "${name}" could not be located inside the workbook.`);
+		let metadata;
+		let cachedRows;
+		const scan = () => {
+			const rows = cachedRows;
+			if (rows !== void 0) return (async function* () {
+				yield* rows;
+			})();
+			return scanWorksheet(source, path, shared, dateStyles, date1904);
+		};
+		const entry = {
+			name,
+			scan,
+			meta: () => {
+				metadata ??= measure({
+					name,
+					scan
+				}).then((result) => {
+					cachedRows = result.rows;
+					return result.meta;
+				}).catch((error) => {
+					metadata = void 0;
+					throw error;
+				});
+				return metadata;
+			}
+		};
+		sheets.push(entry);
+	}
+	return {
+		kind: "streaming",
+		sheets
+	};
+}
+
 //#endregion
 //#region ../browser/src/document/xlsxTable.ts
 /**
-* xlsx → 单元格网格（0.26.0 分册 10 · FR-10.20）。
+* xlsx → 单元格网格或可重复扫描的行流。
 *
-* 与 `extractXlsxText` 共用 `readXlsxWorkbook` 的同一份解析（单元格取值、日期换算、空格补位），
-* 所以画像与查询看到的格，和模型从文本里读到的格是同一批。
-* 错误语义同 `extractXlsxText`：旧版 `.xls`、归档损坏、缺 `xl/workbook.xml` 都抛 `WebSkillError`。
+* `read` 保留既有网格契约；`readStreaming` 用 SAX 逐行解析工作表，不受整包解压的 64 MiB 条目上限约束。
+* 两条路径使用同一套单元格取值、日期换算与空格补位规则，错误均带 `WebSkillError`。
 * @experimental
 */
 function createXlsxTableReader() {
-	return { read: readXlsxTable };
+	return {
+		read: readXlsxTable,
+		readStreaming: readStreamingXlsxWorkbook
+	};
 }
 async function readXlsxTable(bytes) {
 	const { sheets } = await readXlsxWorkbook(bytes);