@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/mcp/tools/values-search.js

@@ -0,0 +1,470 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _index = require("../../schemas/index.js");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+// Helper to convert column index to letter (0 = A, 1 = B, etc.)
+function columnIndexToLetter(index) {
+    var letter = '';
+    var num = index + 1;
+    while(num > 0){
+        var remainder = (num - 1) % 26;
+        letter = String.fromCharCode(65 + remainder) + letter;
+        num = Math.floor((num - 1) / 26);
+    }
+    return letter;
+}
+var inputSchema = _zod.z.object({
+    id: _index.SpreadsheetIdSchema,
+    gid: _index.SheetGidSchema,
+    query: _zod.z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),
+    select: _zod.z.enum([
+        'cells',
+        'rows',
+        'columns'
+    ]).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),
+    values: _zod.z.boolean().optional().describe('Include cell values in response'),
+    a1s: _zod.z.boolean().optional().describe('Include A1 notation references in response'),
+    render: _zod.z.enum([
+        'FORMATTED_VALUE',
+        'UNFORMATTED_VALUE',
+        'FORMULA'
+    ]).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),
+    matchCase: _zod.z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).')
+});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    count: _zod.z.number().int().nonnegative().describe('Number of matches found'),
+    a1s: _zod.z.array(_zod.z.string()).optional().describe('A1 notation references for matches (e.g., "B5", "A5:D5", "B:B")'),
+    values: _zod.z.array(_zod.z.union([
+        _zod.z.array(_index.SheetCellSchema),
+        _index.SheetCellSchema
+    ])).optional().describe('Cell values for matches (arrays for rows/columns, single values for cells)')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, gid, query, select, _param_values, values, _param_a1s, a1s, render, _param_matchCase, matchCase, logger, _ref, _ref1, _ref2, _spreadsheetResponse_data_sheets, _sheet_properties, _sheet_properties_gridProperties, _sheet_properties1, _sheet_properties_gridProperties1, _sheet_properties2, _logger_debug, sheets, spreadsheetResponse, sheet, sheetTitle, rowCount, columnCount, endColumn, fullRange, response, res, allRows, searchQuery, count, a1Array, valuesArray, cellMatches, rowIdx, row, colIdx, cell, colLetter, rowNum, matchingRows, rowIdx1, row1, matches, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, rowIdx2, row2, rowNum1, colEnd, headerRow, matchingCols, colIdx1, header, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _loop, _iterator1, _step1, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, gid = param.gid, query = param.query, select = param.select, _param_values = param.values, values = _param_values === void 0 ? false : _param_values, _param_a1s = param.a1s, a1s = _param_a1s === void 0 ? false : _param_a1s, render = param.render, _param_matchCase = param.matchCase, matchCase = _param_matchCase === void 0 ? false : _param_matchCase;
+                    logger = extra.logger;
+                    logger.info('sheets.values-search called', {
+                        id: id,
+                        gid: gid,
+                        query: query,
+                        select: select,
+                        values: values,
+                        a1s: a1s,
+                        render: render,
+                        matchCase: matchCase
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        4,
+                        ,
+                        5
+                    ]);
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id,
+                            fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties'
+                        })
+                    ];
+                case 2:
+                    spreadsheetResponse = _state.sent();
+                    sheet = (_spreadsheetResponse_data_sheets = spreadsheetResponse.data.sheets) === null || _spreadsheetResponse_data_sheets === void 0 ? void 0 : _spreadsheetResponse_data_sheets.find(function(s) {
+                        var _s_properties;
+                        return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
+                    });
+                    if (!sheet) {
+                        logger.info('sheets.values-search sheet not found', {
+                            id: id,
+                            gid: gid,
+                            query: query
+                        });
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Sheet not found');
+                    }
+                    sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
+                    // Use actual sheet dimensions from gridProperties, with sensible defaults
+                    // Google Sheets default for new sheets is 1000 rows x 26 columns
+                    rowCount = (_ref1 = (_sheet_properties1 = sheet.properties) === null || _sheet_properties1 === void 0 ? void 0 : (_sheet_properties_gridProperties = _sheet_properties1.gridProperties) === null || _sheet_properties_gridProperties === void 0 ? void 0 : _sheet_properties_gridProperties.rowCount) !== null && _ref1 !== void 0 ? _ref1 : 1000;
+                    columnCount = (_ref2 = (_sheet_properties2 = sheet.properties) === null || _sheet_properties2 === void 0 ? void 0 : (_sheet_properties_gridProperties1 = _sheet_properties2.gridProperties) === null || _sheet_properties_gridProperties1 === void 0 ? void 0 : _sheet_properties_gridProperties1.columnCount) !== null && _ref2 !== void 0 ? _ref2 : 26;
+                    endColumn = columnIndexToLetter(columnCount - 1);
+                    fullRange = "".concat(sheetTitle, "!A1:").concat(endColumn).concat(rowCount);
+                    (_logger_debug = logger.debug) === null || _logger_debug === void 0 ? void 0 : _logger_debug.call(logger, 'sheets.values-search fetching range', {
+                        fullRange: fullRange,
+                        rowCount: rowCount,
+                        columnCount: columnCount
+                    });
+                    return [
+                        4,
+                        sheets.spreadsheets.values.get({
+                            spreadsheetId: id,
+                            range: fullRange,
+                            valueRenderOption: render || 'FORMATTED_VALUE'
+                        })
+                    ];
+                case 3:
+                    response = _state.sent();
+                    res = response.data;
+                    allRows = Array.isArray(res.values) ? res.values : [];
+                    // Prepare query for matching (case-insensitive by default)
+                    searchQuery = query ? matchCase ? query : query.toLowerCase() : null;
+                    count = 0;
+                    a1Array = [];
+                    valuesArray = [];
+                    // Helper to check if a cell matches the query
+                    cellMatches = function(cell) {
+                        if (!searchQuery) return true; // If no query, match all
+                        if (typeof cell !== 'string') return false;
+                        var cellValue = matchCase ? cell : cell.toLowerCase();
+                        return cellValue.includes(searchQuery);
+                    };
+                    if (select === 'cells') {
+                        for(rowIdx = 0; rowIdx < allRows.length; rowIdx++){
+                            row = allRows[rowIdx];
+                            if (!row) continue;
+                            for(colIdx = 0; colIdx < row.length; colIdx++){
+                                cell = row[colIdx];
+                                if (cellMatches(cell)) {
+                                    count++;
+                                    if (a1s) {
+                                        colLetter = columnIndexToLetter(colIdx);
+                                        rowNum = rowIdx + 1;
+                                        a1Array.push("".concat(colLetter).concat(rowNum));
+                                    }
+                                    if (values) {
+                                        valuesArray.push(cell !== null && cell !== void 0 ? cell : null);
+                                    }
+                                }
+                            }
+                        }
+                    } else if (select === 'rows') {
+                        matchingRows = [];
+                        for(rowIdx1 = 0; rowIdx1 < allRows.length; rowIdx1++){
+                            row1 = allRows[rowIdx1];
+                            if (!row1) continue;
+                            matches = row1.some(function(cell) {
+                                return cellMatches(cell);
+                            });
+                            if (matches) {
+                                matchingRows.push(rowIdx1);
+                            }
+                        }
+                        count = matchingRows.length;
+                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        try {
+                            for(_iterator = matchingRows[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                rowIdx2 = _step.value;
+                                row2 = allRows[rowIdx2];
+                                if (!row2) continue; // Skip if row is undefined
+                                rowNum1 = rowIdx2 + 1;
+                                if (a1s) {
+                                    colEnd = columnIndexToLetter(Math.max(0, row2.length - 1));
+                                    a1Array.push("A".concat(rowNum1, ":").concat(colEnd).concat(rowNum1));
+                                }
+                                if (values) {
+                                    valuesArray.push(row2);
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError = true;
+                            _iteratorError = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                    } else if (select === 'columns') {
+                        headerRow = allRows[0] || [];
+                        matchingCols = [];
+                        for(colIdx1 = 0; colIdx1 < headerRow.length; colIdx1++){
+                            header = headerRow[colIdx1];
+                            if (cellMatches(header)) {
+                                matchingCols.push(colIdx1);
+                            }
+                        }
+                        count = matchingCols.length;
+                        _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                        try {
+                            _loop = function() {
+                                var colIdx = _step1.value;
+                                var colLetter = columnIndexToLetter(colIdx);
+                                if (a1s) {
+                                    a1Array.push("".concat(colLetter, ":").concat(colLetter));
+                                }
+                                if (values) {
+                                    var columnValues = allRows.map(function(row) {
+                                        return row && row[colIdx] !== undefined ? row[colIdx] : null;
+                                    });
+                                    valuesArray.push(columnValues);
+                                }
+                            };
+                            for(_iterator1 = matchingCols[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true)_loop();
+                        } catch (err) {
+                            _didIteratorError1 = true;
+                            _iteratorError1 = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                    _iterator1.return();
+                                }
+                            } finally{
+                                if (_didIteratorError1) {
+                                    throw _iteratorError1;
+                                }
+                            }
+                        }
+                    }
+                    logger.info('sheets.values-search results', {
+                        count: count,
+                        select: select,
+                        hasA1s: a1s,
+                        hasValues: values
+                    });
+                    result = _object_spread({
+                        type: 'success',
+                        count: count
+                    }, a1s && a1Array.length > 0 && {
+                        a1s: a1Array
+                    }, values && valuesArray.length > 0 && {
+                        values: valuesArray
+                    });
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 4:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('sheets.values-search error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error searching spreadsheet: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 5:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'values-search',
+        config: config,
+        handler: handler
+    };
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/mcp/tools/values-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n  let letter = '';\n  let num = index + 1;\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor((num - 1) / 26);\n  }\n  return letter;\n}\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n  select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n  values: z.boolean().optional().describe('Include cell values in response'),\n  a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n  matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  count: z.number().int().nonnegative().describe('Number of matches found'),\n  a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n  values: z\n    .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n    .optional()\n    .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details including grid dimensions\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.values-search sheet not found', { id, gid, query });\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Use actual sheet dimensions from gridProperties, with sensible defaults\n    // Google Sheets default for new sheets is 1000 rows x 26 columns\n    const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n    const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n    const endColumn = columnIndexToLetter(columnCount - 1);\n    const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n    logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n    const res = response.data;\n    const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    // Prepare query for matching (case-insensitive by default)\n    const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n    let count = 0;\n    const a1Array: string[] = [];\n    const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n    // Helper to check if a cell matches the query\n    const cellMatches = (cell: string | number | boolean | null): boolean => {\n      if (!searchQuery) return true; // If no query, match all\n      if (typeof cell !== 'string') return false;\n      const cellValue = matchCase ? cell : cell.toLowerCase();\n      return cellValue.includes(searchQuery);\n    };\n\n    if (select === 'cells') {\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        for (let colIdx = 0; colIdx < row.length; colIdx++) {\n          const cell = row[colIdx];\n          if (cellMatches(cell)) {\n            count++;\n            if (a1s) {\n              const colLetter = columnIndexToLetter(colIdx);\n              const rowNum = rowIdx + 1;\n              a1Array.push(`${colLetter}${rowNum}`);\n            }\n            if (values) {\n              valuesArray.push(cell ?? null);\n            }\n          }\n        }\n      }\n    } else if (select === 'rows') {\n      const matchingRows: number[] = [];\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        const matches = row.some((cell) => cellMatches(cell));\n        if (matches) {\n          matchingRows.push(rowIdx);\n        }\n      }\n\n      count = matchingRows.length;\n      for (const rowIdx of matchingRows) {\n        const row = allRows[rowIdx];\n        if (!row) continue; // Skip if row is undefined\n        const rowNum = rowIdx + 1;\n\n        if (a1s) {\n          const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n          a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n        }\n        if (values) {\n          valuesArray.push(row);\n        }\n      }\n    } else if (select === 'columns') {\n      const headerRow = allRows[0] || [];\n      const matchingCols: number[] = [];\n\n      for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n        const header = headerRow[colIdx];\n        if (cellMatches(header)) {\n          matchingCols.push(colIdx);\n        }\n      }\n\n      count = matchingCols.length;\n      for (const colIdx of matchingCols) {\n        const colLetter = columnIndexToLetter(colIdx);\n\n        if (a1s) {\n          a1Array.push(`${colLetter}:${colLetter}`);\n        }\n        if (values) {\n          const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n          valuesArray.push(columnValues);\n        }\n      }\n    }\n\n    logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n    const result: Output = {\n      type: 'success' as const,\n      count,\n      ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n      ...(values && valuesArray.length > 0 && { values: valuesArray }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.values-search error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","McpError","ErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/dist/cjs/schemas/index.d.cts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const SpreadsheetRefSchema: z.ZodString;
+export declare const SheetRefSchema: z.ZodString;
+export declare const SpreadsheetIdSchema: z.ZodString;
+export declare const SheetGidSchema: z.ZodCoercedString<unknown>;
+export declare const SpreadsheetIdOutput: z.ZodString;
+export declare const SheetGidOutput: z.ZodString;
+export declare const SheetCellSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>;
+export declare const SheetRowSchema: z.ZodObject<{
+    rowIndex: z.ZodNumber;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+    range: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const A1NotationSchema: z.ZodString;

package/dist/cjs/schemas/index.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const SpreadsheetRefSchema: z.ZodString;
+export declare const SheetRefSchema: z.ZodString;
+export declare const SpreadsheetIdSchema: z.ZodString;
+export declare const SheetGidSchema: z.ZodCoercedString<unknown>;
+export declare const SpreadsheetIdOutput: z.ZodString;
+export declare const SheetGidOutput: z.ZodString;
+export declare const SheetCellSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>;
+export declare const SheetRowSchema: z.ZodObject<{
+    rowIndex: z.ZodNumber;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+    range: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const A1NotationSchema: z.ZodString;

package/dist/cjs/schemas/index.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get A1NotationSchema () {
+        return A1NotationSchema;
+    },
+    get SheetCellSchema () {
+        return SheetCellSchema;
+    },
+    get SheetGidOutput () {
+        return SheetGidOutput;
+    },
+    get SheetGidSchema () {
+        return SheetGidSchema;
+    },
+    get SheetRefSchema () {
+        return SheetRefSchema;
+    },
+    get SheetRowSchema () {
+        return SheetRowSchema;
+    },
+    get SpreadsheetIdOutput () {
+        return SpreadsheetIdOutput;
+    },
+    get SpreadsheetIdSchema () {
+        return SpreadsheetIdSchema;
+    },
+    get SpreadsheetRefSchema () {
+        return SpreadsheetRefSchema;
+    }
+});
+var _zod = require("zod");
+var SpreadsheetRefSchema = _zod.z.string().min(1).describe('Spreadsheet reference: full URL, exact name, or partial name (not ID - use spreadsheet-find to get ID)');
+var SheetRefSchema = _zod.z.string().min(1).describe('Sheet reference: exact title or partial name match (not ID - use sheet-find to get ID)');
+// Shared descriptions for consistency
+var SPREADSHEET_ID_DESC = 'Spreadsheet ID (from URL d/{id})';
+var SHEET_ID_DESC = 'Sheet ID (from URL gid={gid})';
+var SpreadsheetIdSchema = _zod.z.string().min(1).describe(SPREADSHEET_ID_DESC);
+var SheetGidSchema = _zod.z.coerce.string().min(1).describe(SHEET_ID_DESC);
+var SpreadsheetIdOutput = _zod.z.string().describe(SPREADSHEET_ID_DESC);
+var SheetGidOutput = _zod.z.string().describe(SHEET_ID_DESC);
+var SheetCellSchema = _zod.z.union([
+    _zod.z.string(),
+    _zod.z.number(),
+    _zod.z.literal(Infinity),
+    _zod.z.literal(-Infinity),
+    _zod.z.boolean(),
+    _zod.z.null()
+]);
+var SheetRowSchema = _zod.z.object({
+    rowIndex: _zod.z.number().int().positive().describe('1-based row number in the sheet'),
+    values: _zod.z.array(SheetCellSchema).optional().describe('Cell values for this row (included when includeData=true)'),
+    range: _zod.z.string().optional().describe('A1 notation range for this row (e.g., A5:D5)')
+});
+var A1NotationSchema = _zod.z.string().min(1).describe('A1 notation for cell range (e.g., A1, A1:B2, A:B, 1:2)');
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/schemas/index.ts"],"sourcesContent":["import { z } from 'zod';\n\n// Spreadsheet and sheet reference schemas\nexport const SpreadsheetRefSchema = z.string().min(1).describe('Spreadsheet reference: full URL, exact name, or partial name (not ID - use spreadsheet-find to get ID)');\n\nexport const SheetRefSchema = z.string().min(1).describe('Sheet reference: exact title or partial name match (not ID - use sheet-find to get ID)');\n\n// Shared descriptions for consistency\nconst SPREADSHEET_ID_DESC = 'Spreadsheet ID (from URL d/{id})';\nconst SHEET_ID_DESC = 'Sheet ID (from URL gid={gid})';\n\n// Input schemas (with validation)\n// Note: z.coerce.string() converts numbers to strings, handling cases where MCP clients\n// pass gid: 0 (number) instead of gid: \"0\" (string). This is critical for gid=0 which\n// is the default sheet ID in new spreadsheets.\nexport const SpreadsheetIdSchema = z.string().min(1).describe(SPREADSHEET_ID_DESC);\nexport const SheetGidSchema = z.coerce.string().min(1).describe(SHEET_ID_DESC);\n\n// Output schemas (for use in output/response schemas)\nexport const SpreadsheetIdOutput = z.string().describe(SPREADSHEET_ID_DESC);\nexport const SheetGidOutput = z.string().describe(SHEET_ID_DESC);\n\n// Schema for individual sheet cells (can be string, number, boolean, or null)\n// null represents empty cells - JSON cannot represent undefined, and Google API uses null for empty cells\n// Infinity values are allowed as Google Sheets can contain them, but NaN is still rejected\nexport const SheetCellSchema = z.union([z.string(), z.number(), z.literal(Infinity), z.literal(-Infinity), z.boolean(), z.null()]);\n\n// Schema for a row in a sheet search result\nexport const SheetRowSchema = z.object({\n  rowIndex: z.number().int().positive().describe('1-based row number in the sheet'),\n  values: z.array(SheetCellSchema).optional().describe('Cell values for this row (included when includeData=true)'),\n  range: z.string().optional().describe('A1 notation range for this row (e.g., A5:D5)'),\n});\n\n// A1 notation validation - simplified for zod compatibility\nexport const A1NotationSchema = z.string().min(1).describe('A1 notation for cell range (e.g., A1, A1:B2, A:B, 1:2)');\n"],"names":["A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SheetRefSchema","SheetRowSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","SpreadsheetRefSchema","z","string","min","describe","SPREADSHEET_ID_DESC","SHEET_ID_DESC","coerce","union","number","literal","Infinity","boolean","null","object","rowIndex","int","positive","values","array","optional","range"],"mappings":";;;;;;;;;;;QAmCaA;eAAAA;;QAVAC;eAAAA;;QALAC;eAAAA;;QAJAC;eAAAA;;QAXAC;eAAAA;;QAuBAC;eAAAA;;QATAC;eAAAA;;QAJAC;eAAAA;;QAZAC;eAAAA;;;mBAHK;AAGX,IAAMA,uBAAuBC,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAExD,IAAMR,iBAAiBK,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAEzD,sCAAsC;AACtC,IAAMC,sBAAsB;AAC5B,IAAMC,gBAAgB;AAMf,IAAMP,sBAAsBE,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACC;AACvD,IAAMV,iBAAiBM,MAAC,CAACM,MAAM,CAACL,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACE;AAGzD,IAAMR,sBAAsBG,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACC;AAChD,IAAMX,iBAAiBO,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACE;AAK3C,IAAMb,kBAAkBQ,MAAC,CAACO,KAAK,CAAC;IAACP,MAAC,CAACC,MAAM;IAAID,MAAC,CAACQ,MAAM;IAAIR,MAAC,CAACS,OAAO,CAACC;IAAWV,MAAC,CAACS,OAAO,CAAC,CAACC;IAAWV,MAAC,CAACW,OAAO;IAAIX,MAAC,CAACY,IAAI;CAAG;AAG1H,IAAMhB,iBAAiBI,MAAC,CAACa,MAAM,CAAC;IACrCC,UAAUd,MAAC,CAACQ,MAAM,GAAGO,GAAG,GAAGC,QAAQ,GAAGb,QAAQ,CAAC;IAC/Cc,QAAQjB,MAAC,CAACkB,KAAK,CAAC1B,iBAAiB2B,QAAQ,GAAGhB,QAAQ,CAAC;IACrDiB,OAAOpB,MAAC,CAACC,MAAM,GAAGkB,QAAQ,GAAGhB,QAAQ,CAAC;AACxC;AAGO,IAAMZ,mBAAmBS,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC"}

package/dist/cjs/setup/config.d.cts

@@ -0,0 +1,44 @@
+import type { ServerConfig } from '../types.js';
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */
+export declare function handleVersionHelp(args: string[]): {
+    handled: boolean;
+    output?: string;
+};
+/**
+ * Parse Sheets server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive
+ */
+export declare function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig;
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */
+export declare function createConfig(): ServerConfig;