@mcp-z/mcp-sheets 1.0.0

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

@@ -0,0 +1,378 @@
+"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");
+var _rangeoperations = require("../../spreadsheet/range-operations.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;
+var inputSchema = _zod.z.object({
+    id: _index.SpreadsheetIdSchema,
+    find: _zod.z.string().min(1).describe('Text or regex pattern to find'),
+    replacement: _zod.z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),
+    // Scope - defaults to all sheets if neither specified
+    gid: _index.SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),
+    range: _index.A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),
+    // Match options
+    matchCase: _zod.z.boolean().optional().describe('Case-sensitive matching'),
+    matchEntireCell: _zod.z.boolean().optional().describe('Only match entire cell content'),
+    searchByRegex: _zod.z.boolean().optional().describe('Treat find as RE2 regex'),
+    includeFormulas: _zod.z.boolean().optional().describe('Search within formula text')
+}).refine(function(data) {
+    return !(data.range && !data.gid);
+}, {
+    message: 'range requires gid'
+});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    id: _index.SpreadsheetIdOutput,
+    spreadsheetUrl: _zod.z.string().describe('URL of the spreadsheet'),
+    occurrencesChanged: _zod.z.number().int().nonnegative().describe('Total replacements made'),
+    valuesChanged: _zod.z.number().int().nonnegative().describe('Number of non-formula cells changed'),
+    formulasChanged: _zod.z.number().int().nonnegative().describe('Number of formula cells changed'),
+    rowsChanged: _zod.z.number().int().nonnegative().describe('Number of rows with replacements'),
+    sheetsChanged: _zod.z.number().int().nonnegative().describe('Number of sheets with replacements')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas, logger, _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6, _response_data_replies_, _response_data_replies, sheets, findReplaceRequest, _spreadsheetResponse_data_sheets, _sheet_properties, spreadsheetResponse, sheet, sheetId, rangeRef, response, findReplaceResponse, spreadsheetUrl, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, find = param.find, replacement = param.replacement, gid = param.gid, range = param.range, matchCase = param.matchCase, matchEntireCell = param.matchEntireCell, searchByRegex = param.searchByRegex, includeFormulas = param.includeFormulas;
+                    logger = extra.logger;
+                    logger.info('sheets.values-replace called', {
+                        id: id,
+                        find: find,
+                        replacement: replacement,
+                        gid: gid,
+                        range: range
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        6,
+                        ,
+                        7
+                    ]);
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    // Build FindReplaceRequest - only include defined options
+                    findReplaceRequest = _object_spread({
+                        find: find,
+                        replacement: replacement
+                    }, matchCase !== undefined && {
+                        matchCase: matchCase
+                    }, matchEntireCell !== undefined && {
+                        matchEntireCell: matchEntireCell
+                    }, searchByRegex !== undefined && {
+                        searchByRegex: searchByRegex
+                    }, includeFormulas !== undefined && {
+                        includeFormulas: includeFormulas
+                    });
+                    if (!!gid) return [
+                        3,
+                        2
+                    ];
+                    // No gid = search all sheets
+                    findReplaceRequest.allSheets = true;
+                    return [
+                        3,
+                        4
+                    ];
+                case 2:
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id,
+                            fields: 'sheets.properties.sheetId,sheets.properties.title'
+                        })
+                    ];
+                case 3:
+                    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) {
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                    }
+                    // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null
+                    sheetId = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.sheetId;
+                    if (sheetId === undefined || sheetId === null) {
+                        throw new _types.McpError(_types.ErrorCode.InternalError, 'Sheet properties not available');
+                    }
+                    if (!range) {
+                        // gid but no range = search specific sheet
+                        findReplaceRequest.sheetId = sheetId;
+                    } else {
+                        // gid + range = search specific range
+                        rangeRef = (0, _rangeoperations.parseA1Notation)(range);
+                        findReplaceRequest.range = (0, _rangeoperations.rangeReferenceToGridRange)(rangeRef, sheetId);
+                    }
+                    _state.label = 4;
+                case 4:
+                    return [
+                        4,
+                        sheets.spreadsheets.batchUpdate({
+                            spreadsheetId: id,
+                            requestBody: {
+                                requests: [
+                                    {
+                                        findReplace: findReplaceRequest
+                                    }
+                                ]
+                            }
+                        })
+                    ];
+                case 5:
+                    response = _state.sent();
+                    findReplaceResponse = (_response_data_replies = response.data.replies) === null || _response_data_replies === void 0 ? void 0 : (_response_data_replies_ = _response_data_replies[0]) === null || _response_data_replies_ === void 0 ? void 0 : _response_data_replies_.findReplace;
+                    spreadsheetUrl = "https://docs.google.com/spreadsheets/d/".concat(id, "/edit");
+                    logger.info('sheets.values-replace completed', {
+                        occurrencesChanged: (_ref = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.occurrencesChanged) !== null && _ref !== void 0 ? _ref : 0,
+                        sheetsChanged: (_ref1 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.sheetsChanged) !== null && _ref1 !== void 0 ? _ref1 : 0
+                    });
+                    result = {
+                        type: 'success',
+                        id: id,
+                        spreadsheetUrl: spreadsheetUrl,
+                        occurrencesChanged: (_ref2 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.occurrencesChanged) !== null && _ref2 !== void 0 ? _ref2 : 0,
+                        valuesChanged: (_ref3 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.valuesChanged) !== null && _ref3 !== void 0 ? _ref3 : 0,
+                        formulasChanged: (_ref4 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.formulasChanged) !== null && _ref4 !== void 0 ? _ref4 : 0,
+                        rowsChanged: (_ref5 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.rowsChanged) !== null && _ref5 !== void 0 ? _ref5 : 0,
+                        sheetsChanged: (_ref6 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.sheetsChanged) !== null && _ref6 !== void 0 ? _ref6 : 0
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 6:
+                    error = _state.sent();
+                    if (_instanceof(error, _types.McpError)) {
+                        throw error;
+                    }
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('Replace operation failed', {
+                        id: id,
+                        find: find,
+                        replacement: replacement,
+                        gid: gid,
+                        range: range,
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error replacing values: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 7:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'values-replace',
+        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-replace.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-replace.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\n      const spreadsheetResponse = await sheets.spreadsheets.get({\n        spreadsheetId: id,\n        fields: 'sheets.properties.sheetId,sheets.properties.title',\n      });\n\n      const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n      if (!sheet) {\n        throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new McpError(ErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof McpError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","McpError","ErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/values-search.d.cts

@@ -0,0 +1,74 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    select: z.ZodEnum<{
+        columns: "columns";
+        rows: "rows";
+        cells: "cells";
+    }>;
+    values: z.ZodOptional<z.ZodBoolean>;
+    a1s: z.ZodOptional<z.ZodBoolean>;
+    render: z.ZodOptional<z.ZodEnum<{
+        FORMATTED_VALUE: "FORMATTED_VALUE";
+        UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+        FORMULA: "FORMULA";
+    }>>;
+    matchCase: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    count: z.ZodNumber;
+    a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>]>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, query, select, values, a1s, render, matchCase }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+            select: z.ZodEnum<{
+                columns: "columns";
+                rows: "rows";
+                cells: "cells";
+            }>;
+            values: z.ZodOptional<z.ZodBoolean>;
+            a1s: z.ZodOptional<z.ZodBoolean>;
+            render: z.ZodOptional<z.ZodEnum<{
+                FORMATTED_VALUE: "FORMATTED_VALUE";
+                UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+                FORMULA: "FORMULA";
+            }>>;
+            matchCase: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                count: z.ZodNumber;
+                a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>]>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/values-search.d.ts

@@ -0,0 +1,74 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    select: z.ZodEnum<{
+        columns: "columns";
+        rows: "rows";
+        cells: "cells";
+    }>;
+    values: z.ZodOptional<z.ZodBoolean>;
+    a1s: z.ZodOptional<z.ZodBoolean>;
+    render: z.ZodOptional<z.ZodEnum<{
+        FORMATTED_VALUE: "FORMATTED_VALUE";
+        UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+        FORMULA: "FORMULA";
+    }>>;
+    matchCase: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    count: z.ZodNumber;
+    a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>]>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, query, select, values, a1s, render, matchCase }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+            select: z.ZodEnum<{
+                columns: "columns";
+                rows: "rows";
+                cells: "cells";
+            }>;
+            values: z.ZodOptional<z.ZodBoolean>;
+            a1s: z.ZodOptional<z.ZodBoolean>;
+            render: z.ZodOptional<z.ZodEnum<{
+                FORMATTED_VALUE: "FORMATTED_VALUE";
+                UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+                FORMULA: "FORMULA";
+            }>>;
+            matchCase: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                count: z.ZodNumber;
+                a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>]>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};