@webskill/sdk 0.21.0 → 0.23.0

package/dist/{toolSource-C9oNuKmr.js → geometry-CRhuySKV.js}

@@ -43,6 +43,13 @@ function toFrameScopes(scope) {
 		...scope.exclude ? { exclude: scope.exclude } : {}
 	}];
 }
+/** 四个方向的规范清单；工具层校验与文案生成都从这里取，不各写一份 */
+const SCROLL_DIRECTIONS = [
+	"up",
+	"down",
+	"left",
+	"right"
+];
 
 //#endregion
 //#region ../agent/src/pageAction/types.ts
@@ -60,10 +67,14 @@ function toActionFrameScopes(scope) {
 	}];
 }
 /**
-* 本版的操作集（FR-25.1 / 0.16.0 FR-13.6 / 0.18.0 FR-10.1）。拖拽仍不在内（D64）；
+* 本版的操作集（FR-25.1 / 0.16.0 FR-13.6 / 0.18.0 FR-10.1 / 0.22.0 FR-17.1）。
 * 导航只有 `back` 一个，且它**不接受地址**——可达面被浏览器历史封死（SC-1）。
 *
-* `select`/`set`/`attach`/`scroll` 与既有几个走**同一条** policy 路径，
+* `drag` 只表达**起点与终点**，没有中途轨迹（0.22.0 FR-17.6 裁定，D64 就此撤销）：
+* 轨迹是实现细节不是意图，能画任意路径等于架空 AC-23.2，而且滑块验证码要的正是轨迹——
+* 表达不了轨迹，这个动作就天然做不了人机验证绕过。
+*
+* 这些动作与既有几个走**同一条** policy 路径，
 * 范围白名单、逐次确认、审计三条硬约束因此天然覆盖到它们——
 * 前提是新动作不绕过 policy 直调执行器（AC-25.4 守这一点）。
 * @experimental
@@ -76,6 +87,8 @@ const PAGE_ACTION_KINDS = [
 	"set",
 	"attach",
 	"scroll",
+	"hover",
+	"drag",
 	"back"
 ];
 /**
@@ -139,8 +152,10 @@ function sniffDocumentFormat(bytes, name) {
 	const lower = (name ?? "").toLowerCase();
 	if (lower.endsWith(".docx")) return "docx";
 	if (lower.endsWith(".xlsx")) return "xlsx";
+	if (lower.endsWith(".pptx")) return "pptx";
 	if (containsEntry(bytes, "word/document.xml")) return "docx";
 	if (containsEntry(bytes, "xl/workbook.xml")) return "xlsx";
+	if (containsEntry(bytes, "ppt/presentation.xml")) return "pptx";
 }
 
 //#endregion
@@ -225,7 +240,7 @@ function asReadMode(raw) {
 const READ_DOCUMENT_TOOL = "read_document";
 /** 大图的门槛：低于它的是页眉 logo、印章、项目符号，投它们等于白烧一次多模态请求 @experimental */
 const PDF_LARGE_IMAGE_RATIO = .15;
-const DESCRIPTION = "Read a PDF, Word (.docx) or Excel (.xlsx) document the user attached or downloaded, one batch of units at a time. Pages that have no usable text layer (scans) are rendered as images, so their content is never lost. Pictures on pages whose text is readable are listed under \"deferred\" instead of being returned, because reading them costs an extra round trip; call again with mode=\"images\" to fetch those.";
+const DESCRIPTION = "Read a PDF, Word (.docx), Excel (.xlsx) or PowerPoint (.pptx) document the user attached or downloaded, one batch of units at a time. Pages that have no usable text layer (scans) are rendered as images, so their content is never lost. Pictures on pages whose text is readable are listed under \"deferred\" instead of being returned, because reading them costs an extra round trip; call again with mode=\"images\" to fetch those.";
 const INPUT_SCHEMA = {
 	type: "object",
 	properties: {
@@ -243,7 +258,7 @@ const INPUT_SCHEMA = {
 				},
 				block: {
 					type: "number",
-					description: "Word only: 0-based block index."
+					description: "Word and PowerPoint: 0-based block index."
 				},
 				sheet: {
 					type: "number",
@@ -252,6 +267,10 @@ const INPUT_SCHEMA = {
 				row: {
 					type: "number",
 					description: "Excel only: 0-based row index within the sheet."
+				},
+				slide: {
+					type: "number",
+					description: "PowerPoint only: 0-based slide index."
 				}
 			},
 			additionalProperties: false
@@ -269,7 +288,7 @@ const INPUT_SCHEMA = {
 	required: ["id"],
 	additionalProperties: false
 };
-const SYSTEM_PROMPT = "read_document reads an attached or downloaded PDF/Word/Excel document in batches. It returns a \"next\" cursor whenever the document is not finished: keep calling read_document with that cursor until the result has no \"next\", otherwise you have only seen part of the document. Read the text first and answer from it; a result that carries \"deferred\" means those units hold pictures that were not read yet. Fetch them with mode=\"images\" only when the answer depends on what they show, and tell the user the pictures have not been looked at when you answer without them. Never guess an id, and never claim you read a document you only read part of.";
+const SYSTEM_PROMPT = "read_document reads an attached or downloaded PDF/Word/Excel/PowerPoint document in batches. It returns a \"next\" cursor whenever the document is not finished: keep calling read_document with that cursor until the result has no \"next\", otherwise you have only seen part of the document. Read the text first and answer from it; a result that carries \"deferred\" means those units hold pictures that were not read yet. Fetch them with mode=\"images\" only when the answer depends on what they show, and tell the user the pictures have not been looked at when you answer without them. Never guess an id, and never claim you read a document you only read part of.";
 function toolError(e) {
 	return {
 		ok: false,
@@ -287,13 +306,13 @@ function aborted(signal) {
 /**
 * 逐单元读文档，读不出字的地方出图（0.21.0 分册 22）。
 *
-* 三个端口一个都没接时 `listToolSpecs()` 返回空——模型连这个工具的存在都看不到，
+* 四个端口一个都没接时 `listToolSpecs()` 返回空——模型连这个工具的存在都看不到，
 * 而不是看得到再被拒（AC-22.2）。
 * @experimental
 */
 function createDocumentToolSource(options) {
 	const { files } = options;
-	const available = () => options.pdf !== void 0 || options.docx !== void 0 || options.xlsx !== void 0;
+	const available = () => options.pdf !== void 0 || options.docx !== void 0 || options.xlsx !== void 0 || options.pptx !== void 0;
 	const budgetOf = () => options.budget?.() ?? DOCUMENT_READ_BUDGET;
 	return {
 		kind: "document-reader",
@@ -320,13 +339,13 @@ function createDocumentToolSource(options) {
 		const file = await files.read(id);
 		if (file === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `No readable document with id "${id}". It is either not an attachment of the current message, or a download id that has since expired — list the downloads again to get a fresh one.`);
 		const format = sniffDocumentFormat(file.bytes, file.name);
-		if (format === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `"${file.name}" is not a PDF, Word (.docx) or Excel (.xlsx) document, so read_document cannot read it.`);
+		if (format === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `"${file.name}" is not a PDF, Word (.docx), Excel (.xlsx) or PowerPoint (.pptx) document, so read_document cannot read it.`);
 		const reader = readerFor(format);
 		if (reader === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `This environment cannot read ${format.toUpperCase()} documents.`);
 		const from = asCursor(args["from"]);
 		const mode = asReadMode(args["mode"]);
 		const budget = budgetOf();
-		const batch = format === "pdf" ? await readPdf(reader, file.bytes, from, mode, budget, signal) : format === "docx" ? await readDocx(reader, file.bytes, from, mode, budget, signal) : await readXlsx(reader, file.bytes, from, mode, budget, signal);
+		const batch = format === "pdf" ? await readPdf(reader, file.bytes, from, mode, budget, signal) : format === "docx" ? await readDocx(reader, file.bytes, from, mode, budget, signal) : format === "pptx" ? await readPptx(reader, file.bytes, from, mode, budget, signal) : await readXlsx(reader, file.bytes, from, mode, budget, signal);
 		return {
 			ok: true,
 			content: describe(file.name, format, batch, aborted(signal))
@@ -335,6 +354,7 @@ function createDocumentToolSource(options) {
 	function readerFor(format) {
 		if (format === "pdf") return options.pdf;
 		if (format === "docx") return options.docx;
+		if (format === "pptx") return options.pptx;
 		return options.xlsx;
 	}
 }
@@ -345,7 +365,8 @@ function asCursor(raw) {
 		"page",
 		"block",
 		"sheet",
-		"row"
+		"row",
+		"slide"
 	]) {
 		const value = raw[key];
 		if (typeof value === "number" && Number.isInteger(value) && value >= 0) out[key] = value;
@@ -455,6 +476,43 @@ async function readXlsx(reader, bytes, from, mode, budget, signal) {
 		} } : {}
 	};
 }
+/**
+* pptx 摊平成「第几页第几块」的一条序列，与 xlsx 的表×行同构。
+* 幻灯片真有页，所以坐标保留页号——模型报「第 7 页那张图」时对得上用户看到的东西。
+*/
+async function readPptx(reader, bytes, from, mode, budget, signal) {
+	const { slides } = await reader.read(bytes);
+	const flat = [];
+	slides.forEach((slide, slideIndex) => {
+		slide.blocks.forEach((content, blockIndex) => {
+			flat.push({
+				slide: slideIndex,
+				block: blockIndex,
+				content
+			});
+		});
+	});
+	const startSlide = from["slide"] ?? 0;
+	const startBlock = from["block"] ?? 0;
+	const found = flat.findIndex((entry) => entry.slide > startSlide || entry.slide === startSlide && entry.block >= startBlock);
+	const start = found === -1 ? flat.length : found;
+	const taken = takeBlocks(flat.map((entry) => entry.content), start, mode, budget, signal, (index) => ({
+		slide: flat[index].slide,
+		block: flat[index].block
+	}));
+	const stop = flat[taken.stopped];
+	return {
+		units: taken.units,
+		total: flat.length,
+		done: taken.stopped,
+		skippedImages: taken.skippedImages,
+		deferred: taken.deferred,
+		...stop ? { next: {
+			slide: stop.slide,
+			block: stop.block
+		} } : {}
+	};
+}
 function takeBlocks(blocks, start, mode, budget, signal, locate) {
 	const units = [];
 	const deferred = [];
@@ -549,7 +607,7 @@ function describe(name, format, batch, cancelled) {
 	}, ...images];
 }
 function continuationNote(format, batch, remaining, cancelled) {
-	const noun = format === "pdf" ? "page" : format === "docx" ? "block" : "row";
+	const noun = format === "pdf" ? "page" : format === "xlsx" ? "row" : "block";
 	if (batch.next === void 0) return `Reached the end of the document; all ${batch.total} ${noun}s have been read.`;
 	const cursor = JSON.stringify(batch.next);
 	return `${cancelled ? "Stopped because the user cancelled the run" : `${remaining} ${noun}(s) still unread`}. Call read_document again with from = ${cursor} to continue.`;
@@ -562,4 +620,103 @@ function imageIdOf(unit) {
 }
 
 //#endregion
-export { frameSteps as _, defersImage as a, isPdfTextTrustworthy as c, DOCUMENT_READ_BUDGET as d, PAGE_ACTION_KINDS as f, frameLabel as g, toFrameScopes as h, asReadMode as i, measurePdfTextQuality as l, toActionFrameScopes as m, READ_DOCUMENT_TOOL as n, takesImage as o, PAGE_DOCUMENT_REF as p, createDocumentToolSource as r, PDF_GARBLED_RATIO as s, PDF_LARGE_IMAGE_RATIO as t, sniffDocumentFormat as u };
+//#region ../agent/src/template/geometry.ts
+/**
+* A1 地址与 OOXML 几何换算（0.22.0 分册 42 · 设计 43 §1.6）。
+*
+* 环境无关，`@webskill/agent` 里可直接单测——几何算错的后果是图溢出单元格，
+* 而那只有人肉打开文件才看得见，所以这一层的覆盖要密。
+*/
+/** 1 px 的 EMU 数（96 DPI） */
+const EMU_PER_PIXEL = 9525;
+/** 1 磅的 EMU 数 */
+const EMU_PER_POINT = 12700;
+/** 1 twip 的 EMU 数 */
+const EMU_PER_TWIP = 635;
+/** 默认字体的最大数字宽度，Excel 列宽换算基准 */
+const MAX_DIGIT_WIDTH = 7;
+const ADDRESS = /^([A-Z]+)([1-9][0-9]*)$/;
+/** @throws WebSkillError 语法不合法 */
+function parseCellAddress(address) {
+	const match = ADDRESS.exec(address.trim().toUpperCase());
+	if (match === null) throw new WebSkillError("TEMPLATE_ADDRESS_INVALID", `"${address}" is not a valid cell address. Use A1 notation such as B3.`);
+	let column = 0;
+	for (const letter of match[1] ?? "") column = column * 26 + (letter.charCodeAt(0) - 64);
+	return {
+		column: column - 1,
+		row: Number(match[2]) - 1
+	};
+}
+function formatCellAddress({ column, row }) {
+	let letters = "";
+	for (let rest = column + 1; rest > 0; rest = Math.floor((rest - 1) / 26)) letters = String.fromCharCode(65 + (rest - 1) % 26) + letters;
+	return `${letters}${row + 1}`;
+}
+/** @throws WebSkillError 语法不合法 */
+function parseCellRange(range) {
+	const [from = "", to] = range.split(":");
+	if (to === void 0) {
+		const single = parseCellAddress(from);
+		return {
+			start: single,
+			end: single
+		};
+	}
+	return {
+		start: parseCellAddress(from),
+		end: parseCellAddress(to)
+	};
+}
+function isRangeTopLeft(range, address) {
+	return range.start.column === address.column && range.start.row === address.row;
+}
+function rangeContains(range, address) {
+	return address.column >= range.start.column && address.column <= range.end.column && address.row >= range.start.row && address.row <= range.end.row;
+}
+/** Excel 的列宽单位是字符数，换算成像素（设计 43 §1.6 实测 MDW=7） */
+function columnWidthToPixels(width) {
+	return Math.round(width * 7 + 5);
+}
+/**
+* 等比缩放进框：宽高同时约束、**取两个比例里的小者**。
+*
+* FR-42.11 与 FR-42.19 是同一条口径——xlsx 的合并区和 docx 声明了 `trHeight` 的
+* 表格行都这么算。框的某一边为 0（未声明高度）时那一边不参与约束。
+*/
+function fitWithin(natural, box) {
+	const widthRatio = box.width > 0 ? box.width / natural.width : Number.POSITIVE_INFINITY;
+	const heightRatio = box.height > 0 ? box.height / natural.height : Number.POSITIVE_INFINITY;
+	const ratio = Math.min(widthRatio, heightRatio, 1);
+	if (!Number.isFinite(ratio)) return natural;
+	return {
+		width: Math.floor(natural.width * ratio),
+		height: Math.floor(natural.height * ratio)
+	};
+}
+/** PNG / JPEG 的像素尺寸。读文件头，不解码整张图。 */
+function readImageSize(bytes) {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	if (bytes.length > 24 && view.getUint32(0) === 2303741511) return {
+		width: view.getUint32(16),
+		height: view.getUint32(20)
+	};
+	if (bytes.length > 4 && view.getUint16(0) === 65496) return readJpegSize(view, bytes.length);
+}
+function readJpegSize(view, length) {
+	let offset = 2;
+	while (offset + 9 < length) {
+		if (view.getUint8(offset) !== 255) {
+			offset += 1;
+			continue;
+		}
+		const marker = view.getUint8(offset + 1);
+		if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) return {
+			width: view.getUint16(offset + 7),
+			height: view.getUint16(offset + 5)
+		};
+		offset += 2 + view.getUint16(offset + 2);
+	}
+}
+
+//#endregion
+export { frameSteps as A, DOCUMENT_READ_BUDGET as C, SCROLL_DIRECTIONS as D, toActionFrameScopes as E, toFrameScopes as O, sniffDocumentFormat as S, PAGE_DOCUMENT_REF as T, defersImage as _, columnWidthToPixels as a, isPdfTextTrustworthy as b, isRangeTopLeft as c, rangeContains as d, readImageSize as f, asReadMode as g, createDocumentToolSource as h, MAX_DIGIT_WIDTH as i, frameLabel as k, parseCellAddress as l, READ_DOCUMENT_TOOL as m, EMU_PER_POINT as n, fitWithin as o, PDF_LARGE_IMAGE_RATIO as p, EMU_PER_TWIP as r, formatCellAddress as s, EMU_PER_PIXEL as t, parseCellRange as u, takesImage as v, PAGE_ACTION_KINDS as w, measurePdfTextQuality as x, PDF_GARBLED_RATIO as y };

package/dist/gitGraph-4MIJSDKK-ChdVlrk7.js

@@ -0,0 +1,4 @@
+import "./chunk-FOHPRMQF-Dkbp819z.js";
+import { E as createGitGraphServices, T as GitGraphModule } from "./mermaid-parser.core-pYR5siSx.js";
+
+export { createGitGraphServices };