@sheetxl/mcp 0.8.0-beta.19 → 0.8.0-beta.20

package/index.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 /**
-* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.19
+* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.20
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: SheetXL EULA — https://www.sheetxl.com/eula
 */
-import { H as e, K as t, lt as n, z as o } from "./assets/B7vRFm79CUJ1VvFw.js";
-import { o as r } from "./assets/BPctZbHQFoqJNYzC.js";
-import { Dt as s, F as a, G as i, ht as l, k as c, lt as u, p as d } from "./assets/Cgf5GQVN-D8SlQ7A.js";
-import { f as h, i as g, p as m, u as p } from "./assets/bJ-XKvDf7IkAafUI.js";
-import { Ar as f, B as w, Gi as $, Gr as y, L as b, R as k, Ur as S, Vn as x, Xi as v, Xt as C, ka as E, kn as R, o as j } from "./assets/BkhdNc3LdmcyAjwk.js";
-import { t as I } from "./assets/D005GbIBowRGfwed.js";
-import { D as T, _ as N, g as A, l as M, y as F } from "./assets/zkoJXSxpRzqfbG8k.js";
-import { t as _ } from "./assets/EkavVNuGWG95UggH.js";
+import { H as e, K as t, lt as n, z as o } from "./assets/CyOyY32LLW-Pj_L7.js";
+import { o as r } from "./assets/C7oUg84aGjYrJUc6.js";
+import { Dt as s, F as a, G as i, ht as l, k as c, lt as u, p as d } from "./assets/C9aV1SF8uCWIB4zU.js";
+import { f as h, i as g, p as m, u as p } from "./assets/CrRJqUPbvvhnp4p4.js";
+import { At as f, Ka as w, Nr as $, Oa as y, R as b, Wi as k, Xr as S, _a as x, bn as v, do as C, ft as E, mi as R, o as j } from "./assets/DTXRsv2Ww7WbIwCb.js";
+import { t as I } from "./assets/Ti7kMsQ-Eo3lkfIh.js";
+import { A as T, D as N, P as A, f as M, k as F } from "./assets/DsSlUklPSAsh9DhW.js";
+import { t as _ } from "./assets/B5UmlawoCVwHHM_e.js";
 import { createRequire as O } from "node:module";
 import { StdioServerTransport as L } from "@modelcontextprotocol/sdk/server/stdio.js";
 import * as P from "node:os";
@@ -38,7 +38,7 @@ var ye = Object.defineProperty, be = (((e) => {
 	MAX_WORKBOOK_NAME_SIZE: () => 96,
 	isReservedFileNameChar: () => Se,
 	isValidFileName: () => xe
-}), /^(con|prn|aux|nul|com\d|lpt\d)$/i), ke = /[<>:"/\\|?*\u0000-\u001F]/, Se = (e) => ke.test(e), xe = (e) => !(!e || e.length > 255 || ke.test(e) || be.test(e) || "." === e || ".." === e), ve = t("io:sxlReader", () => import("./assets/DtD0J-7IetHv5o6E.js")), Ce = t("io:sxlWriter", () => import("./assets/DxKZjKyewqvj46S2.js")), Ee = async (e, t) => (await ve.load()).readSXL(e, t), Re = (e) => async (t, n) => (await Ce.load()).writeSXL(t, {
+}), /^(con|prn|aux|nul|com\d|lpt\d)$/i), ke = /[<>:"/\\|?*\u0000-\u001F]/, Se = (e) => ke.test(e), xe = (e) => !(!e || e.length > 255 || ke.test(e) || be.test(e) || "." === e || ".." === e), ve = t("io:sxlReader", () => import("./assets/q57cDvIPcIvWlh5T.js")), Ce = t("io:sxlWriter", () => import("./assets/Cm2WENwEZ0KMyF--.js")), Ee = async (e, t) => (await ve.load()).readSXL(e, t), Re = (e) => async (t, n) => (await Ce.load()).writeSXL(t, {
 	...n,
 	compress: n?.compress ?? e.compress,
 	whiteSpace: n?.whiteSpace ?? e.whiteSpace
@@ -75,13 +75,13 @@ var ye = Object.defineProperty, be = (((e) => {
 	})
 }, Ae = {
 	name: "SXLPlugin",
-	version: "0.8.0-beta.19",
+	version: "0.8.0-beta.20",
 	description: "Import and export SXL format",
 	author: "SheetXL",
 	async register(e) {
 		await e.registerReadFormat(je), await e.registerReadFormat(Ie), await e.registerWriteFormat(Te), await e.registerWriteFormat(Ne);
 	}
-}, Me = t("io:csvReader", () => import("./assets/vb-L2Q2jyjjgDvJy.js")), Fe = t("io:csvWriter", () => import("./assets/DOg_zvSkhsKmw4q1.js")), _e = {
+}, Me = t("io:csvReader", () => import("./assets/Cirpx81bWi4G2foA.js")), Fe = t("io:csvWriter", () => import("./assets/ltqqdJxoPnLCjhBV.js")), _e = {
 	key: "CSV",
 	description: "Comma Separated Values",
 	mimeType: "text/csv",
@@ -95,7 +95,7 @@ var ye = Object.defineProperty, be = (((e) => {
 	handler: async (e, t) => (await Fe.load()).writeCSV(e, t)
 }, Le = {
 	name: "CSVPlugin",
-	version: "0.8.0-beta.19",
+	version: "0.8.0-beta.20",
 	description: "Import and export CSV format",
 	author: "SheetXL",
 	async register(e) {
@@ -103,7 +103,7 @@ var ye = Object.defineProperty, be = (((e) => {
 	}
 }, Pe = {
 	name: "@sheetxl/io",
-	version: "0.8.0-beta.19",
+	version: "0.8.0-beta.20",
 	description: "Built-in I/O formats for SheetXL",
 	author: "SheetXL",
 	async register(e) {
@@ -785,7 +785,7 @@ function Bt(e) {
 	Value: "value",
 	Formula: "formula"
 };
-var Ht = (e) => "object" == typeof e && null !== e && !p.isError(e) && "function" == typeof e.getKind && e.getKind().getName() === C.Type, Ut = (e) => {
+var Ht = (e) => "object" == typeof e && null !== e && !p.isError(e) && "function" == typeof e.getKind && e.getKind().getName() === f.Type, Ut = (e) => {
 	const t = e.getAltText();
 	return t ? `[image: ${e.getSource()} "${t}"]` : `[image: ${e.getSource()}]`;
 }, qt = [
@@ -795,7 +795,7 @@ var Ht = (e) => "object" == typeof e && null !== e && !p.isError(e) && "function
 	"shape",
 	"chart",
 	"name"
-], zt = (e, t) => e <= t + 3 ? e : t, Jt = E.ErrorCheck, Xt = /* @__PURE__ */ new Map([
+], zt = (e, t) => e <= t + 3 ? e : t, Jt = $.ErrorCheck, Xt = /* @__PURE__ */ new Map([
 	[Jt.InconsistentFormula, "inconsistent formula"],
 	[Jt.OmittedCells, "omits adjacent cells"],
 	[Jt.NumberAsText, "number stored as text"],
@@ -909,7 +909,7 @@ function nn(e, t) {
 		return null === r || null === s ? e : s + r;
 	});
 }
-var on = (e) => String(e + 1), rn = (e) => (R.cellToString({
+var on = (e) => String(e + 1), rn = (e) => (C.cellToString({
 	rowIndex: 0,
 	colIndex: e
 }) ?? "").replace(/\d+$/, ""), sn = /(?<![A-Za-z0-9_.$])R(\[-?\d+\]|\d+)?C(\[-?\d+\]|\d+)?(?![A-Za-z0-9_(])/g;
@@ -990,7 +990,7 @@ var ln = (e) => {
 	return s !== ln(o.getColor()) && r.push(s ?? "no color"), r.length > 0 ? r.join(" · ") : null;
 };
 function fn(e, t, n) {
-	const o = j(e, t, n);
+	const o = S(e, t, n);
 	return o ? {
 		text: o.text,
 		address: o.address
@@ -1100,7 +1100,7 @@ function xn(e, t = []) {
 	const r = Math.max(10, ...n.map(([e]) => e.length + 2));
 	return n.map(([e, t]) => `${e.padEnd(r)}${t}`);
 }
-var vn = y.Feature;
+var vn = k.Feature;
 function Cn(e, t) {
 	const n = t?.maxSeries ?? 24, o = t?.maxProfileCells ?? 2e4, r = t?.maxCategories ?? 3, s = e.getRowCount(), a = e.getColumnCount();
 	if (1 === s && 1 === a) return {
@@ -1350,7 +1350,7 @@ function Wn(e, t, n) {
 	const s = Array.from(o.getValueCounts()).slice(0, t);
 	return `${r} unique (${s.map(([e, t]) => `${e} ${t}`).join(" · ")}${r > s.length ? " · …" : ""})`;
 }
-var Vn = y.Feature, Bn = (e) => (e.rowEnd - e.rowStart + 1) * (e.colEnd - e.colStart + 1), Hn = (e, t) => {
+var Vn = k.Feature, Bn = (e) => (e.rowEnd - e.rowStart + 1) * (e.colEnd - e.colStart + 1), Hn = (e, t) => {
 	const n = Math.min(e.rowEnd, t.rowEnd) - Math.max(e.rowStart, t.rowStart) + 1;
 	if (n <= 0) return 0;
 	const o = Math.min(e.colEnd, t.colEnd) - Math.max(e.colStart, t.colStart) + 1;
@@ -1360,7 +1360,7 @@ var Vn = y.Feature, Bn = (e) => (e.rowEnd - e.rowStart + 1) * (e.colEnd - e.colS
 	return "times" === t || e.styled === e.content ? n : `${n} (+${Un(e.styled - e.content)} blank)`;
 }, zn = (e) => {
 	if (0 === e.length) return "";
-	const t = R.rangeToString(e[0]);
+	const t = C.rangeToString(e[0]);
 	if (1 === e.length) return t;
 	const n = e.length - 1;
 	return `${t}, +${n} block${1 === n ? "" : "s"}`;
@@ -1706,8 +1706,8 @@ function po(e, t, n, o, r) {
 		const s = n.map((e) => {
 			const t = e.getCoords();
 			o += r ? t.colEnd - t.colStart + 1 : t.rowEnd - t.rowStart + 1;
-			const n = r ? R.runToString(t.colStart, t.colEnd, !0) : R.runToString(t.rowStart, t.rowEnd, !1), s = r ? t.rowStart : t.colStart;
-			return 0 === s ? n : `${n} (from ${r ? `row ${s + 1}` : `column ${R.runToString(s, s, !0).split(":")[0]}`})`;
+			const n = r ? C.runToString(t.colStart, t.colEnd, !0) : C.runToString(t.rowStart, t.rowEnd, !1), s = r ? t.rowStart : t.colStart;
+			return 0 === s ? n : `${n} (from ${r ? `row ${s + 1}` : `column ${C.runToString(s, s, !0).split(":")[0]}`})`;
 		});
 		2 * o > a ? i.push(`${"sheet".padEnd(10)}${t || "default"}`) : i.push(`${e.padEnd(10)}${s.join(", ")}  ${t || "default"}`);
 	}
@@ -1771,7 +1771,7 @@ var fo = (e, t) => e.length > t ? `${e.slice(0, t - 1)}…` : e, wo = (e) => {
 	return o > 0 ? `${n.join(" | ")} | +${o} more` : n.join(" | ");
 }, Co = (e, t) => {
 	if (e.isInvalid()) return "#REF!";
-	const n = e.getWorksheet(), o = R.rangeToString(e.getCoords(), n.getEntireCoords()) ?? "#REF!";
+	const n = e.getWorksheet(), o = C.rangeToString(e.getCoords(), n.getEntireCoords()) ?? "#REF!";
 	return n === t ? o : `${Bo(n.getName())}!${o}`;
 }, Eo = (e) => {
 	const t = [];
@@ -1795,7 +1795,7 @@ var fo = (e, t) => e.length > t ? `${e.slice(0, t - 1)}…` : e, wo = (e) => {
 	]]) "group" === n ? t.push(`same ${r}`) : "custom" === n && t.push(`${r} ${o ?? 0}`);
 	const n = e.displayEmptyCellsAs ?? "zero";
 	return "gap" !== n && t.push(`empty as ${n}`), e.displayHidden && t.push("hidden shown"), e.rightToLeft && t.push("right to left"), e.dateAxis && e.dateRange && t.push(`dates ${e.dateRange}`), t;
-}, Ro = y.Feature, jo = (e) => e.getRange().getStyle(), Io = (e) => Vt(e.getCell(), Lt.Mode.Display)?.display ?? null;
+}, Ro = k.Feature, jo = (e) => e.getRange().getStyle(), Io = (e) => Vt(e.getCell(), Lt.Mode.Display)?.display ?? null;
 function To(e, t) {
 	switch (e) {
 		case Ro.Formula: return (e) => e.getCell().getFormulaText();
@@ -1933,7 +1933,7 @@ var _o = (e) => {
 	const t = e.getCell().getAnomalies();
 	return t.length > 0 ? JSON.stringify(t.map((e) => [e.check, e.evidence])) : null;
 };
-var Oo = y.Feature, Lo = [
+var Oo = k.Feature, Lo = [
 	Oo.Error,
 	Oo.CalcError,
 	Oo.Anomalies,
@@ -1957,7 +1957,7 @@ var Oo = y.Feature, Lo = [
 	Oo.Conditionals,
 	Oo.DataValidations
 ]), Do = new Map(Object.entries(Oo).map(([e, t]) => [t, e])), Wo = (e) => Do.get(e) ?? e;
-var Vo = (e) => `${e.toString()}, ${e.getRowCount()}×${e.getColumnCount()}`, Bo = (e) => R.sheetNameToString(e) ?? "Untitled", Ho = (e) => `wb.getWorksheet(${JSON.stringify(e.getWorksheet().getName())})`, Uo = (e) => ((e) => {
+var Vo = (e) => `${e.toString()}, ${e.getRowCount()}×${e.getColumnCount()}`, Bo = (e) => C.sheetNameToString(e) ?? "Untitled", Ho = (e) => `wb.getWorksheet(${JSON.stringify(e.getWorksheet().getName())})`, Uo = (e) => ((e) => {
 	if (!e.includes("$")) return e;
 	let t = "", n = !1;
 	for (const o of e) {
@@ -1980,19 +1980,19 @@ function Jo(e, t) {
 	0 === n.length && e.fact("None"), e.blank();
 }
 var Xo = [
-	E.Role.Label,
-	E.Role.Input,
-	E.Role.Link,
-	E.Role.Reference,
-	E.Role.Computed,
-	E.Role.Output
+	$.Role.Label,
+	$.Role.Input,
+	$.Role.Link,
+	$.Role.Reference,
+	$.Role.Computed,
+	$.Role.Output
 ];
 var Ko = 30, Go = 4;
 function Zo(e, t, n) {
 	const o = /* @__PURE__ */ new Map();
 	let r = 0;
 	for (const e of n) for (const t of e.getCell().getAnomalies()) {
-		if (t.check !== E.ErrorCheck.ConstantFrequency) continue;
+		if (t.check !== $.ErrorCheck.ConstantFrequency) continue;
 		const n = `${t.evidence.kind}:${t.evidence.value}`;
 		let s = o.get(n);
 		s || o.set(n, s = {
@@ -2268,7 +2268,7 @@ async function pr(e, t) {
 var fr = "#REF!", wr = (e) => {
 	const t = e.getContent();
 	return "chart" === t.getType() && "function" == typeof t.getSeries ? t : null;
-}, $r = (e, t) => `${Bo(e.getName())}!${R.rangeToString(t) ?? ""}`, yr = (e, t) => e ? $r(e.getWorksheet(), e.getCoords()) : t, br = (e) => e.replace(/\s*[\r\n]+\s*/g, " ⏎ ").trim(), kr = (e, t) => ({
+}, $r = (e, t) => `${Bo(e.getName())}!${C.rangeToString(t) ?? ""}`, yr = (e, t) => e ? $r(e.getWorksheet(), e.getCoords()) : t, br = (e) => e.replace(/\s*[\r\n]+\s*/g, " ⏎ ").trim(), kr = (e, t) => ({
 	colStart: Math.min(e.colStart, t.colStart),
 	rowStart: Math.min(e.rowStart, t.rowStart),
 	colEnd: Math.max(e.colEnd, t.colEnd),
@@ -2374,7 +2374,7 @@ var jr = (e) => Cr(e) ?? "", Ir = {
 };
 var Ar = (e, t) => e.colStart <= t.colEnd && t.colStart <= e.colEnd && e.rowStart <= t.rowEnd && t.rowStart <= e.rowEnd;
 function Mr(e, t) {
-	const n = e.getWorksheet(), o = n.getWorkbook()?.getWorksheets().getItems({ visibility: f.Visibility.VeryHidden }) ?? [n], r = /* @__PURE__ */ new Map();
+	const n = e.getWorksheet(), o = n.getWorkbook()?.getWorksheets().getItems({ visibility: j.Visibility.VeryHidden }) ?? [n], r = /* @__PURE__ */ new Map();
 	for (let e = 0; e < (t?.length ?? 0); e++) {
 		const n = t.at(e);
 		if (n.isINamedRange) continue;
@@ -2526,7 +2526,7 @@ var Ur = (e) => {
 };
 var Jr = (e, t) => e.length > t ? `${e.slice(0, t - 1)}…` : e, Xr = (e) => e.replace(/[\r\n]+/g, " ").trim(), Kr = (e) => {
 	const t = e.getRange();
-	return R.rangeToString(t.getCoords()) ?? t.toString();
+	return C.rangeToString(t.getCoords()) ?? t.toString();
 }, Gr = ({ movable: e, text: t }) => _r(t, 300, ((e) => `${Ho(e.getRange())}.getRange(${JSON.stringify(Kr(e))}).getMovables()`)(e)), Zr = (e) => {
 	const t = e.getContent();
 	return "function" == typeof t.getTextFrame ? t.getTextFrame()?.getText() ?? "" : null;
@@ -2680,8 +2680,8 @@ function ls(e, t) {
 	const d = e.getContent().getDescription();
 	d && n.fact(`Alt Text: ${Xr(d)}`), n.fact(`Anchor: ${Vo(o)}, ${((e) => {
 		switch (e) {
-			case x.Type.Absolute: return "absolute — stays put when rows or columns move";
-			case x.Type.OneCell: return "oneCell — moves with the cells, keeps its size";
+			case E.Type.Absolute: return "absolute — stays put when rows or columns move";
+			case E.Type.OneCell: return "oneCell — moves with the cells, keeps its size";
 			default: return "twoCell — moves and resizes with the cells";
 		}
 	})(e.getAnchorType?.())}`), n.fact(`Bounds: ${((e) => {
@@ -2721,7 +2721,7 @@ var cs = (e) => "visible" === e.getVisibility(), us = (e, t) => {
 		}
 		default: return null;
 	}
-}, ds = /* @__PURE__ */ new Map([["hyperlink", y.Feature.Hyperlink], ["numberFormat", y.Feature.NumberFormat]]), hs = (e, t) => t && "" !== t.trim() ? [{
+}, ds = /* @__PURE__ */ new Map([["hyperlink", k.Feature.Hyperlink], ["numberFormat", k.Feature.NumberFormat]]), hs = (e, t) => t && "" !== t.trim() ? [{
 	field: e,
 	text: {
 		match: t,
@@ -3016,7 +3016,7 @@ var Cs = {
 					rowIndex: t.rowStart,
 					colIndex: t.colStart
 				});
-				S("cell", r, R.rangeToString(t) ?? e.getRange().toString(), n, o) && m++;
+				S("cell", r, C.rangeToString(t) ?? e.getRange().toString(), n, o) && m++;
 			}
 			for (const e of d) {
 				if (b || !s) break;
@@ -3047,7 +3047,7 @@ var Cs = {
 				for (const { movable: e, at: o } of t) {
 					const t = k(ms(e, n));
 					if (t) {
-						if (!S("object", r, R.rangeToString(o) ?? e.getRange().toString(), t)) break;
+						if (!S("object", r, C.rangeToString(o) ?? e.getRange().toString(), t)) break;
 						w++;
 					}
 				}
@@ -3384,7 +3384,7 @@ async function qs(e) {
 		}(e, r > 0 ? n.slice(r + 1) : n);
 	}(await M(), e);
 	if ("member" === t.kind) try {
-		const e = (await N()).split(/\r?\n/);
+		const e = (await F()).split(/\r?\n/);
 		t.sources = t.members.map((t) => function(e, t, n) {
 			const o = e.slice(t - 1, n), r = Math.min(...o.filter((e) => e.trim()).map((e) => e.length - e.trimStart().length));
 			return o.map((e) => e.slice(Number.isFinite(r) ? r : 0)).join("\n");
@@ -3471,7 +3471,7 @@ var zs = {
 			}(e, n);
 		}
 	}
-}, Js = y.Feature;
+}, Js = k.Feature;
 async function Xs(e, t, n, o) {
 	await Ks(e, t, "precedents", n, o), await Ks(e, t, "dependents", n, o);
 }
@@ -3805,7 +3805,7 @@ function ga(e, t) {
 function ma(e) {
 	return e.map((e) => `cites ${e.scope}: ${e.reason}`).join("; ");
 }
-var pa = y.Feature, fa = [
+var pa = k.Feature, fa = [
 	["formatCells", "format cells"],
 	["formatColumns", "format columns"],
 	["formatRows", "format rows"],
@@ -3850,7 +3850,7 @@ var pa = y.Feature, fa = [
 			colEnd: Math.max(t.colEnd, e.colEnd)
 		} : { ...e };
 	}
-	return t ? R.rangeToString(t) ?? "" : "";
+	return t ? C.rangeToString(t) ?? "" : "";
 }, va = (e, t) => `${e} ${t}${1 !== e ? "s" : ""}`;
 function Ca(e) {
 	const t = new yn(), n = e.getRanges();
@@ -3858,7 +3858,7 @@ function Ca(e) {
 	const o = n.getWorksheet().getProtection().isLocked();
 	return t.fact("In force: " + (o ? "true — the sheet is protected" : "false — the sheet is not protected, so every cell is editable")), e.getSecurityDescriptor() && t.fact("Security Descriptor: present · not evaluated"), t.toLines().join("\n").trimEnd();
 }
-var Ea = y.Feature;
+var Ea = k.Feature;
 async function Ra(e, t) {
 	const n = e.getWorksheet().getRange(e.getCoords());
 	e = n.getCell();
@@ -4017,7 +4017,7 @@ async function Ra(e, t) {
 		}
 		e.blank();
 	}(o, e, a), function(e, t) {
-		const n = t.getAnomalies().filter((e) => e.check !== E.ErrorCheck.ConstantFrequency);
+		const n = t.getAnomalies().filter((e) => e.check !== $.ErrorCheck.ConstantFrequency);
 		if (0 !== n.length) {
 			e.h2(`Anomalies (${n.length})`);
 			for (const o of n) e.text(`  ${Kt(o, t)}`);
@@ -4153,7 +4153,7 @@ async function Aa(e, t) {
 	}(n, e, t);
 	return function(e, t, n) {
 		const o = [];
-		for (const e of t.getRegions(y.Feature.Formula)) {
+		for (const e of t.getRegions(k.Feature.Formula)) {
 			const t = e.getCell(), r = t.getFormulaText();
 			if (r && (o.push({
 				address: e.getAddress(),
@@ -4218,7 +4218,7 @@ function Oa(e) {
 	const o = e.getCondition();
 	t.fact(`Rule: ${o?.toString() || "none — anything is accepted here"}`);
 	const r = ((e) => {
-		if (e?.getOperator()?.getName() !== v.BuiltInOperatorNames.InSet) return null;
+		if (e?.getOperator()?.getName() !== x.BuiltInOperatorNames.InSet) return null;
 		const t = e.getParam();
 		if (!t) return null;
 		const n = [], o = t.source;
@@ -4232,7 +4232,7 @@ function Oa(e) {
 	})(o);
 	r && t.fact(`Allowed: ${r}`), t.fact("Blanks: " + (e.isIncludeBlanks() ? "allowed" : "rejected"));
 	const s = e.getAlertStyle();
-	if (t.fact(`Alert: ${s}${s === $.AlertStyle.Stop ? " — the entry is refused" : " — the entry is accepted anyway"}`), e.isShowAlertMessage()) {
+	if (t.fact(`Alert: ${s}${s === y.AlertStyle.Stop ? " — the entry is refused" : " — the entry is accepted anyway"}`), e.isShowAlertMessage()) {
 		const n = La(e.getAlertTitle(), e.getAlertMessage());
 		n && t.fact(`Alert Message: ${n}`);
 	}
@@ -4404,16 +4404,16 @@ var Ka = [
 }, ni = (e) => Ga.every(([, t], n) => Qa(t(e)) === Ka[n]), oi = (e, t) => {
 	if (!e) return null;
 	const n = e.getCoords();
-	return t ? R.runToString(n.colStart, n.colEnd, !0) : R.runToString(n.rowStart, n.rowEnd, !1);
+	return t ? C.runToString(n.colStart, n.colEnd, !0) : C.runToString(n.rowStart, n.rowEnd, !1);
 }, ri = (e, t) => {
 	if (0 === e.length) return null;
 	const n = e.slice(0, 20).map((e) => {
 		const n = t ? e.getColumnIndex() : e.getRowIndex();
-		return R.runToString(n, n, t).split(":")[0];
+		return C.runToString(n, n, t).split(":")[0];
 	}), o = e.length > 20 ? `, …and ${e.length - 20} more` : "";
 	return `before ${t ? "columns" : "rows"} ${n.join(", ")}${o}`;
 }, si = (e) => {
-	const t = e.getHeadersFooters(), n = t.getState(), o = w.HeaderFooterState, r = n === o.FirstAndDefault || n === o.FirstOddAndEven, s = n === o.OddAndEven || n === o.FirstOddAndEven, a = [];
+	const t = e.getHeadersFooters(), n = t.getState(), o = v.HeaderFooterState, r = n === o.FirstAndDefault || n === o.FirstOddAndEven, s = n === o.OddAndEven || n === o.FirstOddAndEven, a = [];
 	return r && a.push(["first page", t.getFirstPage()]), s ? (a.push(["odd pages", t.getOddPages()]), a.push(["even pages", t.getEvenPages()])) : a.push([r ? "other pages" : "every page", t.getDefaultForAllPages()]), a;
 }, ai = (e, t, n) => {
 	const o = [];
@@ -4487,7 +4487,7 @@ var gi = (e) => {
 }, mi = /^\s*=\s*TABLE\s*\(([^()]*)\)\s*$/i;
 function pi(e) {
 	const t = [];
-	for (const n of e.getEntireRange().getRegions(y.Feature.Formula)) {
+	for (const n of e.getEntireRange().getRegions(k.Feature.Formula)) {
 		if (!mi.test(n.getCell().getFormulaText() ?? "")) continue;
 		const o = n.getCoords();
 		for (let n = o.rowStart; n <= o.rowEnd; n++) for (let r = o.colStart; r <= o.colEnd; r++) {
@@ -4540,13 +4540,13 @@ async function yi(e, t) {
 		let n = "";
 		t && t.getSelectedWorksheet()?.getId() === e.getId() && (n += " (selected)");
 		const o = e.getVisibility();
-		return o === f.Visibility.Hidden ? n += " (hidden)" : o === f.Visibility.VeryHidden && (n += " (very hidden)"), e.getProtection().isLocked() && (n += " (protected)"), n;
+		return o === j.Visibility.Hidden ? n += " (hidden)" : o === j.Visibility.VeryHidden && (n += " (very hidden)"), e.getProtection().isLocked() && (n += " (protected)"), n;
 	}(e)}`), n.text(`Used: ${r ? Vo(r) : "empty"}`), n.text(`Selection: ${Vo(o)}`);
 	const s = hr(e);
 	s && n.text(`Outline: ${s}`);
 	const a = function(e) {
 		const t = e.getPageLayout(), n = [];
-		t.getOrientation() !== w.Orientation.Portrait && n.push(t.getOrientation());
+		t.getOrientation() !== v.Orientation.Portrait && n.push(t.getOrientation());
 		const o = ti(t);
 		o && n.push(o);
 		const r = ei(t);
@@ -4700,7 +4700,7 @@ var xi = (e) => !!e && "object" == typeof e && !0 === e.isIRange, vi = (e) => {
 		text: t,
 		alignment: "right"
 	} : { text: t };
-}, Ci = y.Feature, Ei = [
+}, Ci = k.Feature, Ei = [
 	[Ci.Font, "fonts"],
 	[Ci.NumberFormat, "formats"],
 	[Ci.Fill, "fills"],
@@ -4711,7 +4711,7 @@ async function Ri(e, t) {
 	const n = new yn();
 	n.h1(`Workbook — ${e.getName() ?? "Untitled"}`), n.text(`Locale: ${e.getRuntime().getLocale()}`);
 	const o = e.getCalculation();
-	o.getStatus() === k.Status.Off ? n.text("Calculation: off — formulas have not been evaluated; values are as loaded. wb.getCalculation().calculate() evaluates them") : o.getStatus() === k.Status.Error ? n.text("Calculation: error — the engine failed to start; values are as loaded. wb.getCalculation().start() tries again") : o.getCalculationMode() === k.CalculationMode.Manual && n.text("Calculation: manual — values are as of the last calculation. wb.getCalculation().calculate() refreshes them");
+	o.getStatus() === w.Status.Off ? n.text("Calculation: off — formulas have not been evaluated; values are as loaded. wb.getCalculation().calculate() evaluates them") : o.getStatus() === w.Status.Error ? n.text("Calculation: error — the engine failed to start; values are as loaded. wb.getCalculation().start() tries again") : o.getCalculationMode() === w.CalculationMode.Manual && n.text("Calculation: manual — values are as of the last calculation. wb.getCalculation().calculate() refreshes them");
 	const r = ((e) => {
 		const t = $a(e);
 		if (!t) return null;
@@ -4719,7 +4719,7 @@ async function Ri(e, t) {
 		return n ? `${n} ${t}` : t;
 	})(e.getProtection());
 	r && n.text(`Protection: ${r}`), n.blank();
-	const s = e.getWorksheets().getItems({ visibility: f.Visibility.VeryHidden }), a = e.getSelectedSheet(), i = e.getStyles().getNormal(), l = [];
+	const s = e.getWorksheets().getItems({ visibility: j.Visibility.VeryHidden }), a = e.getSelectedSheet(), i = e.getStyles().getNormal(), l = [];
 	for (const e of s) {
 		const t = ji(e, i);
 		l.push({
@@ -4761,7 +4761,7 @@ async function Ri(e, t) {
 		n.blank();
 	}
 	u.length < l.length && (n.text(`…and ${l.length - u.length} more sheets · wb.getWorksheets().getItems() lists all`), n.blank());
-	const m = e.getSheets({ visibility: f.Visibility.VeryHidden }).filter((e) => e.getKind() !== f.Kind.Worksheet);
+	const m = e.getSheets({ visibility: j.Visibility.VeryHidden }).filter((e) => e.getKind() !== j.Kind.Worksheet);
 	if (m.length > 0) {
 		n.h2(`Other sheets (${m.length})`), n.blank();
 		for (const e of m) n.text(`  ${Oi(e, e.getId() === a.getId())}`);
@@ -4862,7 +4862,7 @@ function ji(e, t) {
 		for (const n of l) {
 			const o = n.getRowCount() * n.getColumnCount();
 			t += o;
-			for (const t of n.getCell().getAnomalies()) t.check !== E.ErrorCheck.ConstantFrequency && e.set(t.check, (e.get(t.check) ?? 0) + o);
+			for (const t of n.getCell().getAnomalies()) t.check !== $.ErrorCheck.ConstantFrequency && e.set(t.check, (e.get(t.check) ?? 0) + o);
 		}
 		r.push({
 			label: "anomalies",
@@ -4981,18 +4981,18 @@ function Mi(e) {
 			colEnd: Math.max(t.colEnd, e.colEnd)
 		} : e;
 	}
-	return t ? R.rangeToString(t) ?? "" : "";
+	return t ? C.rangeToString(t) ?? "" : "";
 }
 var Fi = (e, t) => `${e} ${t}${1 !== e ? "s" : ""}`;
 function _i(e, t) {
 	const n = e.getVisibility();
 	let o = "";
-	return t && (o += " (selected)"), n === f.Visibility.Hidden ? o += " (hidden)" : n === f.Visibility.VeryHidden && (o += " (very hidden)"), e.getProtection().isLocked() && (o += " (protected)"), `${Bo(e.getName())}${o}`;
+	return t && (o += " (selected)"), n === j.Visibility.Hidden ? o += " (hidden)" : n === j.Visibility.VeryHidden && (o += " (very hidden)"), e.getProtection().isLocked() && (o += " (protected)"), `${Bo(e.getName())}${o}`;
 }
 function Oi(e, t) {
-	const n = e.getKind(), o = n === f.Kind.Chart ? "chart sheet" : n === f.Kind.Macro ? "Excel 4.0 macro sheet" : "dialog sheet", r = e.getVisibility();
+	const n = e.getKind(), o = n === j.Kind.Chart ? "chart sheet" : n === j.Kind.Macro ? "Excel 4.0 macro sheet" : "dialog sheet", r = e.getVisibility();
 	let s = ` (${o})`;
-	return t && (s += " (selected)"), r === f.Visibility.Hidden ? s += " (hidden)" : r === f.Visibility.VeryHidden && (s += " (very hidden)"), `${Bo(e.getName())}${s}`;
+	return t && (s += " (selected)"), r === j.Visibility.Hidden ? s += " (hidden)" : r === j.Visibility.VeryHidden && (s += " (very hidden)"), `${Bo(e.getName())}${s}`;
 }
 var Li = 6;
 function Pi(e, t, n, o, r) {
@@ -5064,7 +5064,7 @@ function Pi(e, t, n, o, r) {
 	for (const { movable: e, detail: t } of m) {
 		const n = e.getRange();
 		l.push({
-			address: `${Bo(n.getWorksheet().getName())}!${R.rangeToString(n.getCoords()) ?? ""}`,
+			address: `${Bo(n.getWorksheet().getName())}!${C.rangeToString(n.getCoords()) ?? ""}`,
 			size: "chart",
 			payload: `${e.getContent().getName?.() || "(unnamed)"} · ${t}`
 		});
@@ -5359,7 +5359,7 @@ var Hi = 20, Ui = [
 			const t = new yn();
 			t.h1("Page Layout"), t.blank();
 			const n = e.getOrientation();
-			t.fact(`Orientation: ${n}${n === w.Orientation.Portrait ? " (default)" : ""}`), t.fact(`Paper: ${ti(e) ?? "letter (default)"}`), t.fact(`Zoom: ${ei(e) ?? "100% (default)"}`);
+			t.fact(`Orientation: ${n}${n === v.Orientation.Portrait ? " (default)" : ""}`), t.fact(`Paper: ${ti(e) ?? "letter (default)"}`), t.fact(`Zoom: ${ei(e) ?? "100% (default)"}`);
 			const o = Ga.map(([t, n]) => `${t} ${Qa(n(e))}`).join(" · ");
 			t.fact(`Margins (inches): ${o}${ni(e) ? " (default)" : ""}`);
 			const r = e.getPrintArea();
@@ -5371,7 +5371,7 @@ var Hi = 20, Ui = [
 			const l = Za.filter(([, t]) => t(e)).map(([e]) => e);
 			l.length > 0 && t.fact(`Also prints: ${l.join(", ")}`);
 			const c = e.getFirstPageNumber();
-			"" !== c && t.fact(`First page number: ${c}`), e.getPrintOrder() !== w.PrintOrder.DownThenOver && t.fact(`Page order: ${e.getPrintOrder()}`), e.getPrintComments() !== w.PrintComments.NoComments && t.fact(`Notes: ${e.getPrintComments()}`), e.getPrintErrors() !== w.PrintErrorType.AsDisplayed && t.fact(`Errors print as: ${e.getPrintErrors()}`);
+			"" !== c && t.fact(`First page number: ${c}`), e.getPrintOrder() !== v.PrintOrder.DownThenOver && t.fact(`Page order: ${e.getPrintOrder()}`), e.getPrintComments() !== v.PrintComments.NoComments && t.fact(`Notes: ${e.getPrintComments()}`), e.getPrintErrors() !== v.PrintErrorType.AsDisplayed && t.fact(`Errors print as: ${e.getPrintErrors()}`);
 			const u = si(e).flatMap(([e, t]) => {
 				const n = [], o = ai(t.getLeftHeader(), t.getCenterHeader(), t.getRightHeader());
 				o && n.push(`${e} header: ${o}`);
@@ -5385,7 +5385,7 @@ var Hi = 20, Ui = [
 		kind: "stats",
 		is: (e) => Wi(e, "isIRangeStats"),
 		render: (e) => function(e) {
-			const t = new yn(), n = e.getCoords(), o = n ? R.rangeToString(n) : null;
+			const t = new yn(), n = e.getCoords(), o = n ? C.rangeToString(n) : null;
 			t.h1(o ? `Stats — ${o}` : "Stats");
 			const r = e.getTypedCounts();
 			t.fact(`Cells: ${e.getSize()}`), t.fact(`Values: ${e.getCount()}`);
@@ -5453,9 +5453,9 @@ var Hi = 20, Ui = [
 		kind: "regions",
 		is: (e) => Wi(e, "isICellRegions"),
 		render: (e, t) => function(e, t) {
-			const n = [...e], o = e.getFeatures(), r = o.join(", "), s = 1 === o.length && o[0] === y.Feature.Contentful, a = e.getRange().getWorksheet().getWorkbook()?.getStyles().getNormal() ?? null, i = new yn();
+			const n = [...e], o = e.getFeatures(), r = o.join(", "), s = 1 === o.length && o[0] === k.Feature.Contentful, a = e.getRange().getWorksheet().getWorkbook()?.getStyles().getNormal() ?? null, i = new yn();
 			i.h1(`Regions — ${r} (${n.length})`);
-			const l = 1 === o.length && o[0] === y.Feature.Anomalies;
+			const l = 1 === o.length && o[0] === k.Feature.Anomalies;
 			return Ao(i, n, {
 				...t,
 				profile: s,
@@ -5547,7 +5547,7 @@ async function Xi(e, t, n) {
 	return a;
 }
 var Ki = 2;
-var Gi = y.Feature;
+var Gi = k.Feature;
 function Zi(e, t, n, o, r, s) {
 	const a = o?.getRanges() ?? null, i = {
 		sheet: Bo(e.getName()),
@@ -6083,7 +6083,7 @@ async function _l(e, t) {
 	try {
 		const n = "snippet" === await El(e) ? await Tl(e) : null;
 		if ("undefined" === t && !n?.expectsValue) return [];
-		const [{ ScriptCompiler: o }, { getScriptingDeclarations: r }] = await Promise.all([import("./assets/BgUHR-HVjZDY4SaH.js"), import("./assets/gCkru9Vv-Ban4DCD.js")]), { diagnostics: s } = await o.compile({
+		const [{ ScriptCompiler: o }, { getScriptingDeclarations: r }] = await Promise.all([import("./assets/mYZ9Z5AKCn7zltHw.js"), import("./assets/CCl8x9s8Bujsew7W.js")]), { diagnostics: s } = await o.compile({
 			source: n?.source ?? e,
 			ambientTypes: await r(),
 			lenient: !0,
@@ -6113,7 +6113,7 @@ var Ol = (e, t) => {
 			if (!o.path) throw new Error("origin 'file' requires a 'path'.");
 			let r;
 			try {
-				r = await A.read({ source: o.path });
+				r = await T.read({ source: o.path });
 			} catch (e) {
 				throw new Error(`Unable to read workbook from '${o.path}' — ${e?.message ?? String(e)}`, { cause: e });
 			}
@@ -6123,9 +6123,9 @@ var Ol = (e, t) => {
 		if ("fork" === n) {
 			if (!o.json) throw new Error("origin 'fork' requires source workbook json.");
 			const r = o.name ?? (o.sourceName ? `${o.sourceName} (fork)` : "Fork");
-			return new t(e, r, n, new F({ json: o.json }), { source: o.source });
+			return new t(e, r, n, new A({ json: o.json }), { source: o.source });
 		}
-		return new t(e, o.name ?? "Untitled", n, new F());
+		return new t(e, o.name ?? "Untitled", n, new A());
 	}
 	snapshot() {
 		return this.workbook.toJSON();
@@ -6144,7 +6144,7 @@ var Ol = (e, t) => {
 			return n(e) === n(t);
 		})(o, n);
 		s || Ol(o, t.overwrite);
-		const a = (s ? await A.write(this.workbook, r) : await A.writeAs(this.workbook, o, r))?.getPath();
+		const a = (s ? await T.write(this.workbook, r) : await T.writeAs(this.workbook, o, r))?.getPath();
 		if (!a) throw new Error(`Unable to save to '${o}'.`);
 		return this.lineage.path = a, a;
 	}
@@ -6336,9 +6336,9 @@ var Ol = (e, t) => {
 	async save(e, t = {}) {
 		if (!e) throw new Error("An attended session saves to a `path`; the user saves its own file from the grid.");
 		Ol(e, t.overwrite);
-		const n = new F({ json: await this.snapshot() });
+		const n = new A({ json: await this.snapshot() });
 		try {
-			await A.write(n, e, { progress: { onWarning: t.onWarning } });
+			await T.write(n, e, { progress: { onWarning: t.onWarning } });
 		} finally {
 			n.close();
 		}
@@ -6793,9 +6793,9 @@ var Ql = class e {
 			const e = {
 				origin: "http://screenshot.sheetxl.invalid",
 				key: null
-			}, t = await S.getDetails();
+			}, t = await R.getDetails();
 			if (t.isEval() || !t.getRuntimes().includes("browser")) return e;
-			const n = await S.getLicenseKey();
+			const n = await R.getLicenseKey();
 			if (!n) return e;
 			for (const e of t.getDomains()) if (!e.includes("*")) try {
 				const t = new URL(e);
@@ -6823,9 +6823,9 @@ var Ql = class e {
 	async capture(e, t) {
 		if (!ec(e)) {
 			const n = e.getCalculation();
-			n.getStatus() === k.Status.Running && await n.whenPendingDone({ timeout: t?.answerTimeout ?? 1e4 });
+			n.getStatus() === w.Status.Running && await n.whenPendingDone({ timeout: t?.answerTimeout ?? 1e4 });
 		}
-		const n = new Uint8Array(ec(e) ? e : await A.writeArrayBuffer(e, { format: "sxl" })), o = t?.maxEdge ?? 1600, r = t?.scale ?? 1, s = {
+		const n = new Uint8Array(ec(e) ? e : await T.writeArrayBuffer(e, { format: "sxl" })), o = t?.maxEdge ?? 1600, r = t?.scale ?? 1, s = {
 			range: t?.range,
 			headers: t?.headers ?? !0,
 			gridlines: t?.gridlines ?? !0
@@ -7087,7 +7087,7 @@ async function cc(e, t = function(e = process.env.SHEETXL_RUN_TIMEOUT) {
 	const t = Number(e);
 	return !Number.isFinite(t) || t < 0 ? lc : 0 === t ? null : Math.round(1e3 * t);
 }()) {
-	const { ScriptCompiler: n, DiagnosticCode: o } = await import("./assets/BgUHR-HVjZDY4SaH.js"), r = await T(), s = null !== t ? {
+	const { ScriptCompiler: n, DiagnosticCode: o } = await import("./assets/mYZ9Z5AKCn7zltHw.js"), r = await N(), s = null !== t ? {
 		key: me(),
 		timeoutMs: t
 	} : void 0, a = async (e) => {
@@ -7129,7 +7129,7 @@ var uc = class {
 	}
 	async capture(e, t) {
 		this._active++, this._clearIdle();
-		const n = new F({ json: e });
+		const n = new A({ json: e });
 		try {
 			return await (await this._acquire()).capture(n, t);
 		} finally {
@@ -7266,7 +7266,7 @@ function xc(e) {
 	const n = void 0 !== e.defaultValue ? ` (default: ${JSON.stringify(e.defaultValue)})` : "";
 	return t = t.describe(`${e.description}${n}`), e.required ? t : t.optional();
 }
-await A.install(Pe);
+await T.install(Pe);
 var vc = function(e) {
 	const t = function() {
 		const e = process.env.SHEETXL_TOOL_LOG;
@@ -7325,7 +7325,7 @@ var Ec = process.env.SHEETXL_WORKSPACE ?? process.cwd(), Rc = function(e, t, n,
 }(Vl, Ec, /* @__PURE__ */ new Date(), vc), jc = function(e, t) {
 	const n = new tc(), o = /* @__PURE__ */ new Map(), r = new uc(), s = new fe({
 		name: "sheetxl-mcp",
-		version: "0.8.0-beta.19"
+		version: "0.8.0-beta.20"
 	}, {
 		instructions: `${$c}\n\n${yc}`,
 		capabilities: { tasks: {
@@ -7390,10 +7390,10 @@ var Ec = process.env.SHEETXL_WORKSPACE ?? process.cwd(), Rc = function(e, t, n,
 				}, ...t.content ?? []]);
 			}
 			const a = await (async () => {
-				const e = await S.getEvalState().catch(() => null);
+				const e = await R.getEvalState().catch(() => null);
 				if (!e || e === c) return null;
 				if (c = e, "grace" !== e && "stopped" !== e) return null;
-				const t = (await S.getDetails()).getEvalStopDate()?.toISOString().slice(0, 10);
+				const t = (await R.getDetails()).getEvalStopDate()?.toISOString().slice(0, 10);
 				return `⚠ This SheetXL build is past its evaluation period: ${"grace" === e ? `exports (xlsx, csv — every format but .sxl) are refused, and on ${t} it stops calculating and running scripts` : "it no longer calculates, runs scripts or exports"}. Saving as .sxl always works. Tell the user before you edit anything they will need to export. Fix: update — restart this server on the latest release (\`npx -y @sheetxl/mcp@latest\`, or update the SheetXL VS Code extension) — or set a license key (\`SHEETXL_LICENSE_KEY\`).`;
 			})();
 			return a && (t.content = [{
@@ -7644,7 +7644,7 @@ var Ec = process.env.SHEETXL_WORKSPACE ?? process.cwd(), Rc = function(e, t, n,
 				};
 			}({
 				surface: "mcp",
-				license: () => S.getDetails(),
+				license: () => R.getDetails(),
 				serverCount: t ? Ft(t.workspace).filter(_t).length + 1 : void 0,
 				sessions: async () => (await e.list()).map((e) => ({
 					id: e.id,

package/lib.js

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.19
+* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.20
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: SheetXL EULA — https://www.sheetxl.com/eula