apple-numbers-mcp 0.5.0

package/build/services/numbersManager.d.ts

@@ -0,0 +1,175 @@
+import { type SetFormulaResult, type SetFormulasBatchResult, type CellStyle, type CellStyleResult, type BatchStyleEntry, type SetCellsStyleBatchResult, type SetDimensionResult, type MergeResult } from "../utils/applescript.js";
+import type { NumbersFileInfo, TableData, SearchResult, ExportResult, CellValue, CreateResult, SetCellResult, SetCellsBatchResult, AddRowsResult, DeleteRowsResult, AddSheetResult, AddTableResult, ImportResult, UpdateRowsResult, RenameResult } from "../types.js";
+export declare class NumbersManager {
+    private validatePath;
+    /**
+     * Resolve and validate an output path for new files.
+     * Expands ~ and checks .numbers extension, but does NOT require the file to exist.
+     */
+    private validateOutputPath;
+    /**
+     * Resolve a generic path (expand ~ and resolve).
+     */
+    private resolvePath;
+    /**
+     * Get file structure: sheets, tables, dimensions, headers.
+     */
+    getFileInfo(filePath: string): NumbersFileInfo;
+    /**
+     * Read data from a table with optional range filtering.
+     */
+    readTable(filePath: string, sheet?: string, table?: string, options?: {
+        startRow?: number;
+        endRow?: number;
+        columns?: (string | number)[];
+    }): TableData;
+    /**
+     * Search for a string value across all cells in the file.
+     */
+    search(filePath: string, query: string, sheet?: string): {
+        results: SearchResult[];
+        count: number;
+    };
+    /**
+     * Export a table to CSV, TSV, or JSON file.
+     */
+    exportTable(filePath: string, format: "csv" | "json" | "tsv", outputPath: string, sheet?: string, table?: string): ExportResult;
+    /**
+     * Read a single cell value by row/col index. Set verbose for formula/metadata.
+     */
+    getCell(filePath: string, sheet: string, table: string, row: number, col: number, verbose?: boolean): CellValue;
+    /**
+     * Create a new .numbers file with headers and optional data rows.
+     */
+    createSpreadsheet(filePath: string, headers: string[], options?: {
+        sheetName?: string;
+        tableName?: string;
+        rows?: unknown[][];
+    }): CreateResult;
+    /**
+     * Write a single cell value in an existing file.
+     */
+    setCell(filePath: string, row: number, col: number, value: unknown, options?: {
+        sheet?: string;
+        table?: string;
+        type?: string;
+    }): SetCellResult;
+    /**
+     * Write multiple cell values in one operation.
+     */
+    setCellsBatch(filePath: string, updates: {
+        row: number;
+        col: number;
+        value: unknown;
+        type?: string;
+    }[], options?: {
+        sheet?: string;
+        table?: string;
+    }): SetCellsBatchResult;
+    /**
+     * Append rows of data to an existing table.
+     */
+    addRows(filePath: string, rows: unknown[][], options?: {
+        sheet?: string;
+        table?: string;
+    }): AddRowsResult;
+    /**
+     * Delete rows from a table by index range (inclusive).
+     */
+    deleteRows(filePath: string, startRow: number, endRow: number, options?: {
+        sheet?: string;
+        table?: string;
+    }): DeleteRowsResult;
+    /**
+     * Add a new sheet to an existing file.
+     */
+    addSheet(filePath: string, sheetName: string, options?: {
+        tableName?: string;
+        headers?: string[];
+        numRows?: number;
+        numCols?: number;
+    }): AddSheetResult;
+    /**
+     * Add a new table to an existing sheet.
+     */
+    addTable(filePath: string, options?: {
+        sheet?: string;
+        tableName?: string;
+        headers?: string[];
+        numRows?: number;
+        numCols?: number;
+    }): AddTableResult;
+    /**
+     * Import a CSV/TSV/JSON file into a new .numbers file.
+     */
+    importFile(inputPath: string, outputPath: string, options?: {
+        format?: "auto" | "csv" | "tsv" | "json";
+        sheetName?: string;
+        tableName?: string;
+    }): ImportResult;
+    /**
+     * Write full rows by index.
+     */
+    updateRows(filePath: string, updates: {
+        row: number;
+        values: unknown[];
+    }[], options?: {
+        sheet?: string;
+        table?: string;
+    }): UpdateRowsResult;
+    /**
+     * Rename a sheet.
+     */
+    renameSheet(filePath: string, newName: string, sheet?: string): RenameResult;
+    /**
+     * Rename a table.
+     */
+    renameTable(filePath: string, newName: string, options?: {
+        sheet?: string;
+        table?: string;
+    }): RenameResult;
+    /**
+     * Set a formula on a cell via AppleScript. Requires Numbers.app to be running.
+     */
+    setCellFormula(filePath: string, sheet: string, table: string, row: number, col: number, formula: string): SetFormulaResult;
+    /**
+     * Set formulas on multiple cells via AppleScript. Requires Numbers.app to be running.
+     */
+    setCellFormulasBatch(filePath: string, sheet: string, table: string, formulas: {
+        row: number;
+        col: number;
+        formula: string;
+    }[]): SetFormulasBatchResult;
+    /**
+     * Set cell style via AppleScript. Requires Numbers.app.
+     */
+    setCellStyle(filePath: string, sheet: string, table: string, row: number, col: number, style: CellStyle): CellStyleResult;
+    /**
+     * Set styles on multiple cells via AppleScript. Requires Numbers.app.
+     */
+    setCellsStyleBatch(filePath: string, sheet: string, table: string, entries: BatchStyleEntry[]): SetCellsStyleBatchResult;
+    /**
+     * Set column width via AppleScript. Requires Numbers.app.
+     */
+    setColumnWidth(filePath: string, sheet: string, table: string, col: number, width: number): SetDimensionResult;
+    /**
+     * Set row height via AppleScript. Requires Numbers.app.
+     */
+    setRowHeight(filePath: string, sheet: string, table: string, row: number, height: number): SetDimensionResult;
+    /**
+     * Merge a range of cells via AppleScript. Requires Numbers.app.
+     */
+    mergeCells(filePath: string, sheet: string, table: string, startRow: number, startCol: number, endRow: number, endCol: number): MergeResult;
+    /**
+     * Unmerge a range of cells via AppleScript. Requires Numbers.app.
+     */
+    unmergeCells(filePath: string, sheet: string, table: string, startRow: number, startCol: number, endRow: number, endCol: number): MergeResult;
+    /**
+     * Check that Python and numbers-parser are available.
+     */
+    healthCheck(): {
+        ok: boolean;
+        message: string;
+    };
+}
+//# sourceMappingURL=numbersManager.d.ts.map

package/build/services/numbersManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbersManager.d.ts","sourceRoot":"","sources":["../../src/services/numbersManager.ts"],"names":[],"mappings":"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"}

package/build/services/numbersManager.js

@@ -0,0 +1,357 @@
+import { runNumbersReader, checkDependencies } from "../utils/python.js";
+import { setFormula, setFormulasBatch, setCellStyle, setCellsStyleBatch, setColumnWidth, setRowHeight, mergeCells, unmergeCells, } from "../utils/applescript.js";
+import { existsSync } from "node:fs";
+import { resolve, extname } from "node:path";
+import { homedir } from "node:os";
+export class NumbersManager {
+    validatePath(filePath) {
+        // Expand ~ to home directory
+        const expanded = filePath.startsWith("~") ? filePath.replace(/^~/, homedir()) : filePath;
+        const resolved = resolve(expanded);
+        if (!existsSync(resolved)) {
+            throw new Error(`File not found: ${resolved}`);
+        }
+        if (extname(resolved).toLowerCase() !== ".numbers") {
+            throw new Error(`Not a Numbers file: ${resolved}. Expected .numbers extension.`);
+        }
+        return resolved;
+    }
+    /**
+     * Resolve and validate an output path for new files.
+     * Expands ~ and checks .numbers extension, but does NOT require the file to exist.
+     */
+    validateOutputPath(filePath) {
+        const expanded = filePath.startsWith("~") ? filePath.replace(/^~/, homedir()) : filePath;
+        const resolved = resolve(expanded);
+        if (extname(resolved).toLowerCase() !== ".numbers") {
+            throw new Error(`Not a Numbers file path: ${resolved}. Expected .numbers extension.`);
+        }
+        return resolved;
+    }
+    /**
+     * Resolve a generic path (expand ~ and resolve).
+     */
+    resolvePath(filePath) {
+        const expanded = filePath.startsWith("~") ? filePath.replace(/^~/, homedir()) : filePath;
+        return resolve(expanded);
+    }
+    /**
+     * Get file structure: sheets, tables, dimensions, headers.
+     */
+    getFileInfo(filePath) {
+        const resolved = this.validatePath(filePath);
+        const result = runNumbersReader("info", [resolved]);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Read data from a table with optional range filtering.
+     */
+    readTable(filePath, sheet, table, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved];
+        if (sheet)
+            args.push("--sheet", sheet);
+        if (table)
+            args.push("--table", table);
+        if (options?.startRow !== undefined)
+            args.push("--start-row", String(options.startRow));
+        if (options?.endRow !== undefined)
+            args.push("--end-row", String(options.endRow));
+        if (options?.columns)
+            args.push("--columns", JSON.stringify(options.columns));
+        const result = runNumbersReader("read", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Search for a string value across all cells in the file.
+     */
+    search(filePath, query, sheet) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, query];
+        if (sheet)
+            args.push("--sheet", sheet);
+        const result = runNumbersReader("search", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Export a table to CSV, TSV, or JSON file.
+     */
+    exportTable(filePath, format, outputPath, sheet, table) {
+        const resolved = this.validatePath(filePath);
+        const outputResolved = this.resolvePath(outputPath);
+        const args = [resolved, format, outputResolved];
+        if (sheet)
+            args.push("--sheet", sheet);
+        if (table)
+            args.push("--table", table);
+        const result = runNumbersReader("export", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Read a single cell value by row/col index. Set verbose for formula/metadata.
+     */
+    getCell(filePath, sheet, table, row, col, verbose) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, sheet, table, String(row), String(col)];
+        if (verbose)
+            args.push("--verbose");
+        const result = runNumbersReader("cell", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Create a new .numbers file with headers and optional data rows.
+     */
+    createSpreadsheet(filePath, headers, options) {
+        const resolved = this.validateOutputPath(filePath);
+        const args = [resolved, JSON.stringify(headers)];
+        if (options?.sheetName)
+            args.push("--sheet-name", options.sheetName);
+        if (options?.tableName)
+            args.push("--table-name", options.tableName);
+        if (options?.rows)
+            args.push("--rows", JSON.stringify(options.rows));
+        const result = runNumbersReader("create", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Write a single cell value in an existing file.
+     */
+    setCell(filePath, row, col, value, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, String(row), String(col), JSON.stringify(value)];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        if (options?.type)
+            args.push("--type", options.type);
+        const result = runNumbersReader("set-cell", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Write multiple cell values in one operation.
+     */
+    setCellsBatch(filePath, updates, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, JSON.stringify(updates)];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        const result = runNumbersReader("set-cells", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Append rows of data to an existing table.
+     */
+    addRows(filePath, rows, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, JSON.stringify(rows)];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        const result = runNumbersReader("add-rows", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Delete rows from a table by index range (inclusive).
+     */
+    deleteRows(filePath, startRow, endRow, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, String(startRow), String(endRow)];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        const result = runNumbersReader("delete-rows", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Add a new sheet to an existing file.
+     */
+    addSheet(filePath, sheetName, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, sheetName];
+        if (options?.tableName)
+            args.push("--table-name", options.tableName);
+        if (options?.headers)
+            args.push("--headers", JSON.stringify(options.headers));
+        if (options?.numRows !== undefined)
+            args.push("--num-rows", String(options.numRows));
+        if (options?.numCols !== undefined)
+            args.push("--num-cols", String(options.numCols));
+        const result = runNumbersReader("add-sheet", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Add a new table to an existing sheet.
+     */
+    addTable(filePath, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.tableName)
+            args.push("--table-name", options.tableName);
+        if (options?.headers)
+            args.push("--headers", JSON.stringify(options.headers));
+        if (options?.numRows !== undefined)
+            args.push("--num-rows", String(options.numRows));
+        if (options?.numCols !== undefined)
+            args.push("--num-cols", String(options.numCols));
+        const result = runNumbersReader("add-table", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Import a CSV/TSV/JSON file into a new .numbers file.
+     */
+    importFile(inputPath, outputPath, options) {
+        const inputResolved = this.resolvePath(inputPath);
+        if (!existsSync(inputResolved)) {
+            throw new Error(`Input file not found: ${inputResolved}`);
+        }
+        const outputResolved = this.validateOutputPath(outputPath);
+        const args = [inputResolved, outputResolved];
+        if (options?.format && options.format !== "auto")
+            args.push("--format", options.format);
+        if (options?.sheetName)
+            args.push("--sheet-name", options.sheetName);
+        if (options?.tableName)
+            args.push("--table-name", options.tableName);
+        const result = runNumbersReader("import", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Write full rows by index.
+     */
+    updateRows(filePath, updates, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, JSON.stringify(updates)];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        const result = runNumbersReader("update-rows", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Rename a sheet.
+     */
+    renameSheet(filePath, newName, sheet) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, newName];
+        if (sheet)
+            args.push("--sheet", sheet);
+        const result = runNumbersReader("rename-sheet", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Rename a table.
+     */
+    renameTable(filePath, newName, options) {
+        const resolved = this.validatePath(filePath);
+        const args = [resolved, newName];
+        if (options?.sheet)
+            args.push("--sheet", options.sheet);
+        if (options?.table)
+            args.push("--table", options.table);
+        const result = runNumbersReader("rename-table", args);
+        if (result.error)
+            throw new Error(result.error);
+        return result.data;
+    }
+    /**
+     * Set a formula on a cell via AppleScript. Requires Numbers.app to be running.
+     */
+    setCellFormula(filePath, sheet, table, row, col, formula) {
+        const resolved = this.validatePath(filePath);
+        return setFormula(resolved, sheet, table, row, col, formula);
+    }
+    /**
+     * Set formulas on multiple cells via AppleScript. Requires Numbers.app to be running.
+     */
+    setCellFormulasBatch(filePath, sheet, table, formulas) {
+        const resolved = this.validatePath(filePath);
+        return setFormulasBatch(resolved, sheet, table, formulas);
+    }
+    /**
+     * Set cell style via AppleScript. Requires Numbers.app.
+     */
+    setCellStyle(filePath, sheet, table, row, col, style) {
+        const resolved = this.validatePath(filePath);
+        return setCellStyle(resolved, sheet, table, row, col, style);
+    }
+    /**
+     * Set styles on multiple cells via AppleScript. Requires Numbers.app.
+     */
+    setCellsStyleBatch(filePath, sheet, table, entries) {
+        const resolved = this.validatePath(filePath);
+        return setCellsStyleBatch(resolved, sheet, table, entries);
+    }
+    /**
+     * Set column width via AppleScript. Requires Numbers.app.
+     */
+    setColumnWidth(filePath, sheet, table, col, width) {
+        const resolved = this.validatePath(filePath);
+        return setColumnWidth(resolved, sheet, table, col, width);
+    }
+    /**
+     * Set row height via AppleScript. Requires Numbers.app.
+     */
+    setRowHeight(filePath, sheet, table, row, height) {
+        const resolved = this.validatePath(filePath);
+        return setRowHeight(resolved, sheet, table, row, height);
+    }
+    /**
+     * Merge a range of cells via AppleScript. Requires Numbers.app.
+     */
+    mergeCells(filePath, sheet, table, startRow, startCol, endRow, endCol) {
+        const resolved = this.validatePath(filePath);
+        return mergeCells(resolved, sheet, table, startRow, startCol, endRow, endCol);
+    }
+    /**
+     * Unmerge a range of cells via AppleScript. Requires Numbers.app.
+     */
+    unmergeCells(filePath, sheet, table, startRow, startCol, endRow, endCol) {
+        const resolved = this.validatePath(filePath);
+        return unmergeCells(resolved, sheet, table, startRow, startCol, endRow, endCol);
+    }
+    /**
+     * Check that Python and numbers-parser are available.
+     */
+    healthCheck() {
+        return checkDependencies();
+    }
+}
+//# sourceMappingURL=numbersManager.js.map

package/build/services/numbersManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbersManager.js","sourceRoot":"","sources":["../../src/services/numbersManager.ts"],"names":[],"mappings":"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"}

package/build/tools/doctor.d.ts

@@ -0,0 +1,22 @@
+import type { NumbersManager } from "../services/numbersManager.js";
+export type CheckStatus = "ok" | "warn" | "fail";
+export interface DoctorCheck {
+    name: string;
+    status: CheckStatus;
+    detail: string;
+}
+export interface DoctorReport {
+    healthy: boolean;
+    checks: DoctorCheck[];
+}
+/**
+ * Run all diagnostic checks. This function NEVER throws — every probe is wrapped
+ * in try/catch and converted to a fail/warn/ok check.
+ *
+ * The `manager` parameter is accepted for symmetry with the other tools and to
+ * leave room for future manager-backed probes; the current checks don't need it.
+ */
+export declare function runDoctor(_manager: NumbersManager): DoctorReport;
+/** Render a DoctorReport as readable text. */
+export declare function formatDoctorReport(r: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/build/tools/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/tools/doctor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AACjD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAKD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,CAqEhE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAK1D"}