@webskill/sdk 0.28.1 → 0.30.0-next.1

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

@@ -2,8 +2,8 @@ import { n as messageOf, t as WebSkillError } from "./errors-BDZNpC13.js";
 import { b as parseSkillMarkdown, i as buildCatalog, n as SkillDiscovery, r as SkillReader } from "./skill-WSUDp6A1.js";
 import { o as atomicWriteText, r as resolveInsideRoot, t as assertSafePathSegment } from "./pathSecurity-CirkQwWP.js";
 import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
+import { O as XLS_MIME, 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-GE-VV_Gj.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-2v3WQzs_.js";
 import { t as extractUiSpecEvents } from "./surface-DVGiCmwq.js";
@@ -2704,6 +2704,11 @@ var AgentLoop = class {
 				label: "Excel workbooks",
 				...this.#deps.xlsxExtractor ? { extractor: this.#deps.xlsxExtractor } : {}
 			},
+			[XLS_MIME]: {
+				kind: "xls",
+				label: "Legacy Excel workbooks",
+				...this.#deps.xlsxExtractor ? { extractor: this.#deps.xlsxExtractor } : {}
+			},
 			[SUPPORTED_DOCUMENT_MIME.pptx]: {
 				kind: "pptx",
 				label: "PowerPoint presentations",

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-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";
+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-CSeFUL9R.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-UbNuzd2a.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-Cj2HedfL.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -1599,9 +1599,9 @@ declare function extractDocxText(bytes: Uint8Array): Promise<string>;
 /**
  * xlsx 文本抽取（0.13.0 分册 12）。
  *
- * **零新增依赖**：xlsx 和 docx 是同一种容器（OPC = zip + XML），
- * 所以沿用 docx 那条路 —— zip 走仓内既有的 `unzipWithLimits`（fflate，
- * 自带解压体积上限，顺带挡住 zip 炸弹），XML 走浏览器原生 `DOMParser`。
+ * xlsx 和 docx 是同一种容器（OPC = zip + XML），所以沿用 docx 那条路 ——
+ * zip 走仓内既有的 `unzipWithLimits`（fflate，自带解压体积上限，顺带挡住 zip 炸弹），
+ * XML 走浏览器原生 `DOMParser`。旧版 xls 先由 `xlsConversion` 在内存中转成 xlsx。
  *
  * ⚠️ `DOMParser` 是浏览器 API，Node 没有 —— 所以这个模块只在 `@webskill/browser`。
  * Node 宿主没有 xlsx 能力，与 docx 同一条**显式声明**的限制，不是静默降级（备案 D55）。
@@ -1615,7 +1615,7 @@ declare const XLSX_UNEXTRACTED: readonly ["styles", "conditional formatting", "m
 /**
  * 从 xlsx 字节里抽出文本，每个工作表一段、段首是表名。
  *
- * @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+ * @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
  */
 declare function extractXlsxText(bytes: Uint8Array): Promise<string>;
 //#endregion
@@ -1644,14 +1644,14 @@ declare const XLSX_IMAGE_MIN_ROWS = 3;
 /** @experimental */
 declare function createXlsxBlockReader(): XlsxDocumentReader;
 /**
- * @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+ * @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
  * @experimental
  */
 declare function readXlsxBlocks(bytes: Uint8Array): Promise<XlsxDocumentContent>;
 //#endregion
 //#region src/document/xlsxTable.d.ts
 /**
- * xlsx → 单元格网格或可重复扫描的行流。
+ * xls(x) → 单元格网格或可重复扫描的行流；旧版 xls 先在内存中转换成 xlsx。
  *
  * `read` 保留既有网格契约；`readStreaming` 用 SAX 逐行解析工作表，不受整包解压的 64 MiB 条目上限约束。
  * 两条路径使用同一套单元格取值、日期换算与空格补位规则，错误均带 `WebSkillError`。

package/dist/browser.js

@@ -2,13 +2,13 @@ import { n as messageOf$1, t as WebSkillError } from "./errors-BDZNpC13.js";
 import { A as SKILL_MANIFEST_FILE, D as verifySkillSignature, M as buildManifest, O as MANIFEST_EXCLUDED_FILES, P as verifyManifest, b as parseSkillMarkdown, c as unzipWithLimits, f as SKILL_PACK_FILE, i as buildCatalog, k as SKILLS_LOCKFILE, m as parseSkillPackManifest, n as SkillDiscovery, o as readResponseWithLimit, p as exportSkills, t as validateSkills, u as detectSkillArchiveShapeFromFs, w as readSkillSignature, y as isValidSkillName } from "./skill-WSUDp6A1.js";
 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-5BmspsRi.js";
+import { c as toBase64$1, f as SPREADSHEET_MIME_TYPE, y as ATTACHMENT_TEXT_LIMIT } from "./linkedDocument-GE-VV_Gj.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-DnUytrkq.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-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 { t as createWebSkillApi } from "./webSkillApi-TeWPPFDn.js";
+import { T as frameSteps, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, 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, w as frameLabel } from "./geometry-1xQbK4hB.js";
+import { a as toFrameScopes, i as SCROLL_DIRECTIONS, r as toActionFrameScopes } from "./types-BXRIoabj.js";
 import { Unzip, UnzipInflate, zipSync } from "fflate";
 import { SaxesParser } from "saxes";
 
@@ -6424,14 +6424,129 @@ async function extractDocxText(bytes) {
 	return blocks.join("\n").replace(/\n{3,}/g, "\n\n").trim();
 }
 
+//#endregion
+//#region ../browser/src/document/xlsConversion.ts
+const OLE2_SIGNATURE = [
+	208,
+	207,
+	17,
+	224,
+	161,
+	177,
+	26,
+	225
+];
+function isLegacyXls(bytes) {
+	return OLE2_SIGNATURE.every((byte, index) => bytes[index] === byte);
+}
+/** 旧 BIFF/OLE2 工作簿只在内存中转换；原件与上传落盘内容都不改写。 */
+async function convertXlsToXlsx(bytes) {
+	if (!isLegacyXls(bytes)) throw new WebSkillError("TOOL_EXECUTION_FAILED", "The file is not a legacy OLE2 .xls workbook.");
+	try {
+		const [XLSX, codepage] = await Promise.all([import("@e965/xlsx"), import("@e965/xlsx/dist/cpexcel.full.mjs")]);
+		const { cptable } = codepage;
+		const { utils } = codepage;
+		XLSX.set_cptable({
+			...cptable,
+			utils
+		});
+		const workbook = XLSX.read(bytes, {
+			type: "array",
+			cellDates: false,
+			cellNF: true
+		});
+		const output = XLSX.write(workbook, {
+			type: "array",
+			bookType: "xlsx",
+			compression: true
+		});
+		if (output instanceof Uint8Array) return output;
+		if (output instanceof ArrayBuffer) return new Uint8Array(output);
+		throw new Error("The converter returned an unsupported binary output.");
+	} catch (error) {
+		throw new WebSkillError("TOOL_EXECUTION_FAILED", `The legacy .xls workbook could not be converted to .xlsx: ${error instanceof Error ? error.message : String(error)}`, error);
+	}
+}
+async function normalizeExcelBytes(bytes) {
+	return isLegacyXls(bytes) ? convertXlsToXlsx(bytes) : bytes;
+}
+async function collect(chunks) {
+	const parts = [];
+	let length = 0;
+	for await (const chunk of chunks) {
+		parts.push(chunk);
+		length += chunk.byteLength;
+	}
+	const bytes = new Uint8Array(length);
+	let offset = 0;
+	for (const part of parts) {
+		bytes.set(part, offset);
+		offset += part.byteLength;
+	}
+	return bytes;
+}
+/**
+* 流式读取先复用首段判断魔数。普通 xlsx 的首段会原样接回流，不整份缓存；
+* 只有必须整体转换的 xls 才收集全部字节。
+*/
+async function normalizeExcelSource(source) {
+	if (typeof source !== "function") return normalizeExcelBytes(source);
+	const iterator = (await source())[Symbol.asyncIterator]();
+	const prefix = [];
+	let prefixLength = 0;
+	let done = false;
+	while (prefixLength < OLE2_SIGNATURE.length && !done) {
+		const next = await iterator.next();
+		if (next.done === true) done = true;
+		else {
+			prefix.push(next.value);
+			prefixLength += next.value.byteLength;
+		}
+	}
+	const replay = async function* () {
+		yield* prefix;
+		try {
+			while (!done) {
+				const next = await iterator.next();
+				if (next.done === true) {
+					done = true;
+					break;
+				}
+				yield next.value;
+			}
+		} finally {
+			if (!done) await iterator.return?.();
+		}
+	};
+	const head = new Uint8Array(Math.min(prefixLength, OLE2_SIGNATURE.length));
+	let offset = 0;
+	for (const chunk of prefix) {
+		head.set(chunk.subarray(0, head.byteLength - offset), offset);
+		offset = Math.min(head.byteLength, offset + chunk.byteLength);
+		if (offset === head.byteLength) break;
+	}
+	if (!isLegacyXls(head)) {
+		let pending = replay();
+		return async () => {
+			if (pending !== void 0) {
+				const first = pending;
+				pending = void 0;
+				return first;
+			}
+			return await source();
+		};
+	}
+	return convertXlsToXlsx(await collect(replay()));
+}
+
 //#endregion
 //#region ../browser/src/document/xlsx.ts
 /**
 * xlsx 文本抽取（0.13.0 分册 12）。
 *
-* **零新增依赖**：xlsx 和 docx 是同一种容器（OPC = zip + XML），
-* 所以沿用 docx 那条路 —— zip 走仓内既有的 `unzipWithLimits`（fflate，
-* 自带解压体积上限，顺带挡住 zip 炸弹），XML 走浏览器原生 `DOMParser`。
+* xlsx 和 docx 是同一种容器（OPC = zip + XML），所以沿用 docx 那条路 ——
+* zip 走仓内既有的 `unzipWithLimits`（fflate，自带解压体积上限，顺带挡住 zip 炸弹），
+* XML 走浏览器原生 `DOMParser`。旧版 xls 先由 `xlsConversion` 在内存中转成 xlsx。
 *
 * ⚠️ `DOMParser` 是浏览器 API，Node 没有 —— 所以这个模块只在 `@webskill/browser`。
 * Node 宿主没有 xlsx 能力，与 docx 同一条**显式声明**的限制，不是静默降级（备案 D55）。
@@ -6457,17 +6572,6 @@ 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$1 = [
-	208,
-	207,
-	17,
-	224,
-	161,
-	177,
-	26,
-	225
-];
 /** 内建的日期/时间数字格式 id（ECMA-376 §18.8.30） */
 const BUILTIN_DATE_FORMATS = /* @__PURE__ */ new Set([
 	14,
@@ -6630,7 +6734,6 @@ function sheetRows(doc, shared, dateStyles, date1904) {
 }
 /** 一行的文本：单元格用制表符分隔（与 docx 的表格同口径），行尾制表符不留 */
 const rowLine = (cells) => cells.join("	").replace(/\t+$/, "");
-const looksLikeOle2 = (bytes) => bytes.length >= OLE2_SIGNATURE$1.length && OLE2_SIGNATURE$1.every((byte, i) => bytes[i] === byte);
 /** rels 里的 Target 可能是相对 `xl/` 的，也可能是包根绝对路径 */
 function resolveSheetPath$1(target) {
 	const clean = target.replace(/^\.\//, "");
@@ -6639,13 +6742,13 @@ function resolveSheetPath$1(target) {
 /**
 * 把 xlsx 拆成「每张表的每一行文本」。
 *
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 */
 async function readXlsxWorkbook(bytes) {
-	if (looksLikeOle2(bytes)) fail$1("This is a legacy .xls workbook, which is not supported. Save it as .xlsx and try again.");
+	const normalized = await normalizeExcelBytes(bytes);
 	let entries;
 	try {
-		entries = await unzipWithLimits(bytes);
+		entries = await unzipWithLimits(normalized);
 	} catch {
 		fail$1("This file could not be read as an Excel workbook: the archive is damaged or not a .xlsx file.");
 	}
@@ -6693,7 +6796,7 @@ async function readXlsxWorkbook(bytes) {
 /**
 * 从 xlsx 字节里抽出文本，每个工作表一段、段首是表名。
 *
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 */
 async function extractXlsxText(bytes) {
 	const { sheets } = await readXlsxWorkbook(bytes);
@@ -6942,7 +7045,7 @@ function createXlsxBlockReader() {
 	return { read: readXlsxBlocks };
 }
 /**
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 * @experimental
 */
 async function readXlsxBlocks(bytes) {
@@ -6973,16 +7076,6 @@ 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);
 }
@@ -7260,8 +7353,8 @@ 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.");
+async function readStreamingXlsxWorkbook(input) {
+	const source = await normalizeExcelSource(input);
 	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");
@@ -7318,7 +7411,7 @@ async function readStreamingXlsxWorkbook(source) {
 //#endregion
 //#region ../browser/src/document/xlsxTable.ts
 /**
-* xlsx → 单元格网格或可重复扫描的行流。
+* xls(x) → 单元格网格或可重复扫描的行流；旧版 xls 先在内存中转换成 xlsx。
 *
 * `read` 保留既有网格契约；`readStreaming` 用 SAX 逐行解析工作表，不受整包解压的 64 MiB 条目上限约束。
 * 两条路径使用同一套单元格取值、日期换算与空格补位规则，错误均带 `WebSkillError`。

package/dist/controller.d.ts

@@ -0,0 +1,88 @@
+import { Bt as LIST_PAGE_TABS_TOOL, Jt as PAGE_ACTION_TOOL, Qt as PERCEIVE_PAGE_TOOL, jt as FOCUS_PAGE_TAB_TOOL, s as CLOSE_PAGE_TAB_TOOL } from "./index-Cj2HedfL.js";
+import { A as PairConfirmResult, B as WebSocketLike, C as InvocationMeta, D as OriginsParams, E as Origin, F as PingResult, I as Principal, L as ProtocolVersion, M as PairStartParams, N as PairStartResult, O as PairApprovedParams, P as PingParams, R as ReadyParams, S as HumanControlParams, T as JsonRpcRequest, _ as ControllerPairingCode, a as AuthRenewParams, b as HelloParams, c as Base64Url, d as ControllerAuditEvent, f as ControllerDevice, g as ControllerPairingApproval, h as ControllerDeviceStore, i as AuthPresentResult, j as PairRejectedParams, k as PairConfirmParams, l as BoundedString, m as ControllerDeviceState, n as AuthChallengeResult, o as AuthRenewResult, p as ControllerDeviceOptions, r as AuthPresentParams, s as AuthRevokedParams, t as AuthChallengeParams, u as ByeParams, v as ControllerPairingRecord, w as IsoDateTime, x as HelloResult, y as ControllerWriteState, z as WebSocketConstructor } from "./types-DmcXN3qR-Dy7ZDstc.js";
+//#region ../controller/dist/index.d.ts
+//#region src/constants.d.ts
+/** @stable */
+declare const CONTROLLER_PROTOCOL_VERSION: "0.1";
+/** @experimental */
+type ControllerToolName = 'browser_status' | typeof PERCEIVE_PAGE_TOOL | typeof PAGE_ACTION_TOOL | typeof LIST_PAGE_TABS_TOOL | typeof FOCUS_PAGE_TAB_TOOL | typeof CLOSE_PAGE_TAB_TOOL;
+/** @experimental */
+declare const CONTROLLER_TOOL_NAMES: readonly ControllerToolName[];
+interface ControllerProtocolLimits {
+  readonly maxMessageBytes: number;
+  readonly oversizeWindowMs: number;
+  readonly oversizeThreshold: number;
+  readonly invocationContextMaxBytes: number;
+  readonly pairingCodeTtlMaxMs: number;
+  readonly pairingAttemptsMax: number;
+  readonly deviceConfirmTimeoutMs: number;
+  readonly grantTtlMaxMs: number;
+  readonly heartbeatIntervalMs: number;
+  readonly heartbeatTimeoutMs: number;
+  readonly reconnectMaxDelayMs: number;
+  readonly localAuthorizationTimeoutMs: number;
+  readonly idempotencyCacheEntries: number;
+  readonly idempotencyCacheTtlMs: number;
+}
+/** @experimental */
+declare const CONTROLLER_PROTOCOL_LIMITS: ControllerProtocolLimits;
+//#endregion
+//#region src/validate.d.ts
+/** @experimental */
+interface ControllerValidation {
+  readonly valid: boolean;
+  readonly errors: readonly string[];
+}
+/** @experimental */
+declare const CONTROLLER_PROTOCOL_SCHEMA: Readonly<Record<string, unknown>>;
+/** @experimental */
+declare function validateControllerMessage(method: string, kind: 'params' | 'result', value: unknown): ControllerValidation;
+//#endregion
+//#region src/transport.d.ts
+/** @experimental */
+type ControllerRequestHandler = (method: string, params: unknown) => Promise<unknown> | unknown;
+/** @experimental */
+type ControllerNotificationHandler = (method: string, params: unknown) => void | Promise<void>;
+/** @experimental */
+type McpMessageHandler = (message: JsonRpcRequest) => void;
+/** @experimental */
+interface ControllerTransportOptions {
+  readonly url: string;
+  readonly socket?: WebSocketLike;
+  readonly WebSocket?: WebSocketConstructor;
+  readonly isAuthorized?: () => boolean;
+  readonly maxMessageBytes?: number;
+  readonly requestTimeoutMs?: number;
+  onControlRequest?: ControllerRequestHandler;
+  onControlNotification?: ControllerNotificationHandler;
+  onmessage?: McpMessageHandler;
+  onerror?: (error: Error) => void;
+  onclose?: () => void;
+}
+/** @experimental */
+interface ControllerTransport {
+  readonly connected: boolean;
+  onControlRequest?: ControllerRequestHandler;
+  onControlNotification?: ControllerNotificationHandler;
+  onmessage?: McpMessageHandler;
+  onerror?: (error: Error) => void;
+  onclose?: () => void;
+  connect(): Promise<void>;
+  start(): Promise<void>;
+  request<T = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<T>;
+  notify(method: string, params?: unknown): Promise<void>;
+  send(message: JsonRpcRequest): Promise<void>;
+  close(code?: number, reason?: string): Promise<void>;
+}
+/** @experimental */
+declare function createWebSocketControllerTransport(options: ControllerTransportOptions): ControllerTransport;
+//#endregion
+//#region src/device/crypto.d.ts
+/** @experimental */
+declare function instanceFingerprint(instanceId: string): Promise<string>;
+//#endregion
+//#region src/device/index.d.ts
+/** @experimental */
+declare function createControllerDevice(options: ControllerDeviceOptions): ControllerDevice;
+//#endregion
+export { type AuthChallengeParams, type AuthChallengeResult, type AuthPresentParams, type AuthPresentResult, type AuthRenewParams, type AuthRenewResult, type AuthRevokedParams, type Base64Url, type BoundedString, type ByeParams, CONTROLLER_PROTOCOL_LIMITS, CONTROLLER_PROTOCOL_SCHEMA, CONTROLLER_PROTOCOL_VERSION, CONTROLLER_TOOL_NAMES, type ControllerAuditEvent, type ControllerDevice, type ControllerDeviceOptions, type ControllerDeviceState, type ControllerDeviceStore, ControllerNotificationHandler, type ControllerPairingApproval, type ControllerPairingCode, type ControllerPairingRecord, type ControllerProtocolLimits, ControllerRequestHandler, type ControllerToolName, ControllerTransport, ControllerTransportOptions, ControllerValidation, type ControllerWriteState, type HelloParams, type HelloResult, type HumanControlParams, type InvocationMeta, type IsoDateTime, McpMessageHandler, type Origin, type OriginsParams, type PairApprovedParams, type PairConfirmParams, type PairConfirmResult, type PairRejectedParams, type PairStartParams, type PairStartResult, type PingParams, type PingResult, type Principal, type ProtocolVersion, type ReadyParams, createControllerDevice, createWebSocketControllerTransport, instanceFingerprint, validateControllerMessage };

package/dist/controller.js

@@ -0,0 +1,3 @@
+import { a as createWebSocketControllerTransport, d as CONTROLLER_PROTOCOL_VERSION, f as CONTROLLER_TOOL_NAMES, o as CONTROLLER_PROTOCOL_SCHEMA, r as instanceFingerprint, s as validateControllerMessage, t as createControllerDevice, u as CONTROLLER_PROTOCOL_LIMITS } from "./device-DMUgqNzr.js";
+
+export { CONTROLLER_PROTOCOL_LIMITS, CONTROLLER_PROTOCOL_SCHEMA, CONTROLLER_PROTOCOL_VERSION, CONTROLLER_TOOL_NAMES, createControllerDevice, createWebSocketControllerTransport, instanceFingerprint, validateControllerMessage };