@mcp-z/mcp-sheets 2.5.0 → 2.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/constants.d.cts +24 -0
- package/dist/cjs/constants.d.ts +24 -0
- package/dist/cjs/constants.js +56 -0
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-format.d.cts +3 -3
- package/dist/cjs/mcp/tools/cells-format.d.ts +3 -3
- package/dist/cjs/mcp/tools/cells-format.js +3 -2
- package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-get.d.cts +2 -2
- package/dist/cjs/mcp/tools/columns-get.d.ts +2 -2
- package/dist/cjs/mcp/tools/columns-get.js +2 -1
- package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/columns-update.js +3 -2
- package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
- package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
- package/dist/cjs/mcp/tools/rows-append.js +2 -1
- package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-get.d.cts +2 -2
- package/dist/cjs/mcp/tools/rows-get.d.ts +2 -2
- package/dist/cjs/mcp/tools/rows-get.js +2 -1
- package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.js +3 -2
- package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.js +3 -2
- package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-search.d.cts +2 -2
- package/dist/cjs/mcp/tools/values-search.d.ts +2 -2
- package/dist/cjs/mcp/tools/values-search.js +2 -1
- package/dist/cjs/mcp/tools/values-search.js.map +1 -1
- package/dist/cjs/spreadsheet/data-operations.js +1 -17
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +1 -5
- package/dist/cjs/spreadsheet/range-operations.d.ts +1 -5
- package/dist/cjs/spreadsheet/range-operations.js +0 -28
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.js +24 -74
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/constants.d.ts +24 -0
- package/dist/esm/constants.js +41 -0
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/mcp/tools/cells-format.d.ts +3 -3
- package/dist/esm/mcp/tools/cells-format.js +3 -2
- package/dist/esm/mcp/tools/cells-format.js.map +1 -1
- package/dist/esm/mcp/tools/columns-get.d.ts +2 -2
- package/dist/esm/mcp/tools/columns-get.js +2 -1
- package/dist/esm/mcp/tools/columns-get.js.map +1 -1
- package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
- package/dist/esm/mcp/tools/columns-update.js +3 -2
- package/dist/esm/mcp/tools/columns-update.js.map +1 -1
- package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
- package/dist/esm/mcp/tools/rows-append.js +2 -1
- package/dist/esm/mcp/tools/rows-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
- package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-get.d.ts +2 -2
- package/dist/esm/mcp/tools/rows-get.js +2 -1
- package/dist/esm/mcp/tools/rows-get.js.map +1 -1
- package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
- package/dist/esm/mcp/tools/values-batch-update.js +3 -2
- package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
- package/dist/esm/mcp/tools/values-csv-update.js +3 -2
- package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-search.d.ts +2 -2
- package/dist/esm/mcp/tools/values-search.js +2 -1
- package/dist/esm/mcp/tools/values-search.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.js +7 -11
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +1 -5
- package/dist/esm/spreadsheet/range-operations.js +0 -27
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.js +19 -36
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/package.json +1 -1
package/dist/cjs/constants.d.cts
CHANGED
|
@@ -7,3 +7,27 @@
|
|
|
7
7
|
export declare const GOOGLE_SCOPE = "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";
|
|
8
8
|
export declare const PASTE_TYPES: readonly ["PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA", "PASTE_DATA_VALIDATION", "PASTE_CONDITIONAL_FORMATTING"];
|
|
9
9
|
export declare const PASTE_ORIENTATIONS: readonly ["NORMAL", "TRANSPOSE"];
|
|
10
|
+
export declare const NATIVE_DATE_POINTER = "Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
11
|
+
export declare const RENDER_DESCRIPTION = "How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.";
|
|
12
|
+
export declare const NATIVE_DATE_EXAMPLE_WRITE: {
|
|
13
|
+
readonly requests: readonly [{
|
|
14
|
+
readonly range: "B2";
|
|
15
|
+
readonly majorDimension: "ROWS";
|
|
16
|
+
readonly values: readonly [readonly [46334.5]];
|
|
17
|
+
}];
|
|
18
|
+
readonly valueInputOption: "RAW";
|
|
19
|
+
};
|
|
20
|
+
export declare const NATIVE_DATE_EXAMPLE_FORMAT: {
|
|
21
|
+
readonly requests: readonly [{
|
|
22
|
+
readonly range: "B2";
|
|
23
|
+
readonly numberFormat: {
|
|
24
|
+
readonly type: "DATE";
|
|
25
|
+
readonly pattern: "yyyy-mm-dd hh:mm";
|
|
26
|
+
};
|
|
27
|
+
}];
|
|
28
|
+
};
|
|
29
|
+
export declare const NATIVE_DATE_EXAMPLE_READ: {
|
|
30
|
+
readonly range: "B2";
|
|
31
|
+
readonly render: "UNFORMATTED_VALUE";
|
|
32
|
+
};
|
|
33
|
+
export declare const NATIVE_DATE_GUIDANCE: string;
|
package/dist/cjs/constants.d.ts
CHANGED
|
@@ -7,3 +7,27 @@
|
|
|
7
7
|
export declare const GOOGLE_SCOPE = "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";
|
|
8
8
|
export declare const PASTE_TYPES: readonly ["PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA", "PASTE_DATA_VALIDATION", "PASTE_CONDITIONAL_FORMATTING"];
|
|
9
9
|
export declare const PASTE_ORIENTATIONS: readonly ["NORMAL", "TRANSPOSE"];
|
|
10
|
+
export declare const NATIVE_DATE_POINTER = "Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
11
|
+
export declare const RENDER_DESCRIPTION = "How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.";
|
|
12
|
+
export declare const NATIVE_DATE_EXAMPLE_WRITE: {
|
|
13
|
+
readonly requests: readonly [{
|
|
14
|
+
readonly range: "B2";
|
|
15
|
+
readonly majorDimension: "ROWS";
|
|
16
|
+
readonly values: readonly [readonly [46334.5]];
|
|
17
|
+
}];
|
|
18
|
+
readonly valueInputOption: "RAW";
|
|
19
|
+
};
|
|
20
|
+
export declare const NATIVE_DATE_EXAMPLE_FORMAT: {
|
|
21
|
+
readonly requests: readonly [{
|
|
22
|
+
readonly range: "B2";
|
|
23
|
+
readonly numberFormat: {
|
|
24
|
+
readonly type: "DATE";
|
|
25
|
+
readonly pattern: "yyyy-mm-dd hh:mm";
|
|
26
|
+
};
|
|
27
|
+
}];
|
|
28
|
+
};
|
|
29
|
+
export declare const NATIVE_DATE_EXAMPLE_READ: {
|
|
30
|
+
readonly range: "B2";
|
|
31
|
+
readonly render: "UNFORMATTED_VALUE";
|
|
32
|
+
};
|
|
33
|
+
export declare const NATIVE_DATE_GUIDANCE: string;
|
package/dist/cjs/constants.js
CHANGED
|
@@ -18,11 +18,29 @@ _export(exports, {
|
|
|
18
18
|
get GOOGLE_SCOPE () {
|
|
19
19
|
return GOOGLE_SCOPE;
|
|
20
20
|
},
|
|
21
|
+
get NATIVE_DATE_EXAMPLE_FORMAT () {
|
|
22
|
+
return NATIVE_DATE_EXAMPLE_FORMAT;
|
|
23
|
+
},
|
|
24
|
+
get NATIVE_DATE_EXAMPLE_READ () {
|
|
25
|
+
return NATIVE_DATE_EXAMPLE_READ;
|
|
26
|
+
},
|
|
27
|
+
get NATIVE_DATE_EXAMPLE_WRITE () {
|
|
28
|
+
return NATIVE_DATE_EXAMPLE_WRITE;
|
|
29
|
+
},
|
|
30
|
+
get NATIVE_DATE_GUIDANCE () {
|
|
31
|
+
return NATIVE_DATE_GUIDANCE;
|
|
32
|
+
},
|
|
33
|
+
get NATIVE_DATE_POINTER () {
|
|
34
|
+
return NATIVE_DATE_POINTER;
|
|
35
|
+
},
|
|
21
36
|
get PASTE_ORIENTATIONS () {
|
|
22
37
|
return PASTE_ORIENTATIONS;
|
|
23
38
|
},
|
|
24
39
|
get PASTE_TYPES () {
|
|
25
40
|
return PASTE_TYPES;
|
|
41
|
+
},
|
|
42
|
+
get RENDER_DESCRIPTION () {
|
|
43
|
+
return RENDER_DESCRIPTION;
|
|
26
44
|
}
|
|
27
45
|
});
|
|
28
46
|
var GOOGLE_SCOPE = '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';
|
|
@@ -39,4 +57,42 @@ var PASTE_ORIENTATIONS = [
|
|
|
39
57
|
'NORMAL',
|
|
40
58
|
'TRANSPOSE'
|
|
41
59
|
];
|
|
60
|
+
var NATIVE_DATE_POINTER = 'Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.';
|
|
61
|
+
var RENDER_DESCRIPTION = 'How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.';
|
|
62
|
+
var NATIVE_DATE_EXAMPLE_WRITE = {
|
|
63
|
+
requests: [
|
|
64
|
+
{
|
|
65
|
+
range: 'B2',
|
|
66
|
+
majorDimension: 'ROWS',
|
|
67
|
+
values: [
|
|
68
|
+
[
|
|
69
|
+
46334.5
|
|
70
|
+
]
|
|
71
|
+
]
|
|
72
|
+
}
|
|
73
|
+
],
|
|
74
|
+
valueInputOption: 'RAW'
|
|
75
|
+
};
|
|
76
|
+
var NATIVE_DATE_EXAMPLE_FORMAT = {
|
|
77
|
+
requests: [
|
|
78
|
+
{
|
|
79
|
+
range: 'B2',
|
|
80
|
+
numberFormat: {
|
|
81
|
+
type: 'DATE',
|
|
82
|
+
pattern: 'yyyy-mm-dd hh:mm'
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
]
|
|
86
|
+
};
|
|
87
|
+
var NATIVE_DATE_EXAMPLE_READ = {
|
|
88
|
+
range: 'B2',
|
|
89
|
+
render: 'UNFORMATTED_VALUE'
|
|
90
|
+
};
|
|
91
|
+
var NATIVE_DATE_GUIDANCE = [
|
|
92
|
+
"NATIVE DATES: a native Sheets date/time is a serial number plus a date number format. The integer counts days from 1899-12-30; the fraction is the time of day (46334.5 = 2026-11-08 12:00, with a matching format). A serial carries no timezone of its own and is read in the spreadsheet's timezone.",
|
|
93
|
+
'RAW stores values as supplied, so a date-looking string stays text; a numeric serial plus a date format is an explicit native-date write. USER_ENTERED may parse date strings the way the Sheets UI does, using the workbook locale.',
|
|
94
|
+
'Keep the intended wall time/timezone and recorded precision: a date-only record is not an exact midnight event time, and existing timestamps are not reinterpreted.',
|
|
95
|
+
"Example: (1) values-batch-update ".concat(JSON.stringify(NATIVE_DATE_EXAMPLE_WRITE), "; (2) cells-format ").concat(JSON.stringify(NATIVE_DATE_EXAMPLE_FORMAT), "; (3) rows-get (or columns-get / values-search) ").concat(JSON.stringify(NATIVE_DATE_EXAMPLE_READ), ' returns 46334.5 (numeric, so it is not text), while render FORMATTED_VALUE returns "2026-11-08 12:00"; then check dependent chronological formulas.'),
|
|
96
|
+
'Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and https://developers.google.com/workspace/sheets/api/reference/rest/v4/ValueInputOption'
|
|
97
|
+
].join(' ');
|
|
42
98
|
/* 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; }
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = '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';\n\n// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)\nexport const PASTE_TYPES = ['PASTE_NORMAL', 'PASTE_VALUES', 'PASTE_FORMAT', 'PASTE_NO_BORDERS', 'PASTE_FORMULA', 'PASTE_DATA_VALIDATION', 'PASTE_CONDITIONAL_FORMATTING'] as const;\nexport const PASTE_ORIENTATIONS = ['NORMAL', 'TRANSPOSE'] as const;\n"],"names":["GOOGLE_SCOPE","PASTE_ORIENTATIONS","PASTE_TYPES"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;;;;;;;;;;;;QAClDA;eAAAA;;QAIAC;eAAAA;;QADAC;eAAAA;;;
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = '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';\n\n// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)\nexport const PASTE_TYPES = ['PASTE_NORMAL', 'PASTE_VALUES', 'PASTE_FORMAT', 'PASTE_NO_BORDERS', 'PASTE_FORMULA', 'PASTE_DATA_VALIDATION', 'PASTE_CONDITIONAL_FORMATTING'] as const;\nexport const PASTE_ORIENTATIONS = ['NORMAL', 'TRANSPOSE'] as const;\n\n// Native-date guidance shared by the write, format and read tool descriptions; the example arguments are checked against the tool schemas in test/unit/constants.test.ts.\n// Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and .../ValueInputOption\nexport const NATIVE_DATE_POINTER = 'Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.';\n\nexport const RENDER_DESCRIPTION =\n 'How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.';\n\n// Example call arguments (id/gid/includeData omitted), step 1 to 3 of the native-date write, format and read-back.\nexport const NATIVE_DATE_EXAMPLE_WRITE = { requests: [{ range: 'B2', majorDimension: 'ROWS', values: [[46334.5]] }], valueInputOption: 'RAW' } as const;\nexport const NATIVE_DATE_EXAMPLE_FORMAT = { requests: [{ range: 'B2', numberFormat: { type: 'DATE', pattern: 'yyyy-mm-dd hh:mm' } }] } as const;\nexport const NATIVE_DATE_EXAMPLE_READ = { range: 'B2', render: 'UNFORMATTED_VALUE' } as const;\n\nexport const NATIVE_DATE_GUIDANCE = [\n \"NATIVE DATES: a native Sheets date/time is a serial number plus a date number format. The integer counts days from 1899-12-30; the fraction is the time of day (46334.5 = 2026-11-08 12:00, with a matching format). A serial carries no timezone of its own and is read in the spreadsheet's timezone.\",\n 'RAW stores values as supplied, so a date-looking string stays text; a numeric serial plus a date format is an explicit native-date write. USER_ENTERED may parse date strings the way the Sheets UI does, using the workbook locale.',\n 'Keep the intended wall time/timezone and recorded precision: a date-only record is not an exact midnight event time, and existing timestamps are not reinterpreted.',\n `Example: (1) values-batch-update ${JSON.stringify(NATIVE_DATE_EXAMPLE_WRITE)}; (2) cells-format ${JSON.stringify(NATIVE_DATE_EXAMPLE_FORMAT)}; (3) rows-get (or columns-get / values-search) ${JSON.stringify(NATIVE_DATE_EXAMPLE_READ)} returns 46334.5 (numeric, so it is not text), while render FORMATTED_VALUE returns \"2026-11-08 12:00\"; then check dependent chronological formulas.`,\n 'Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and https://developers.google.com/workspace/sheets/api/reference/rest/v4/ValueInputOption',\n].join(' ');\n"],"names":["GOOGLE_SCOPE","NATIVE_DATE_EXAMPLE_FORMAT","NATIVE_DATE_EXAMPLE_READ","NATIVE_DATE_EXAMPLE_WRITE","NATIVE_DATE_GUIDANCE","NATIVE_DATE_POINTER","PASTE_ORIENTATIONS","PASTE_TYPES","RENDER_DESCRIPTION","requests","range","majorDimension","values","valueInputOption","numberFormat","type","pattern","render","JSON","stringify","join"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;;;;;;;;;;;;QAClDA;eAAAA;;QAeAC;eAAAA;;QACAC;eAAAA;;QAFAC;eAAAA;;QAIAC;eAAAA;;QAVAC;eAAAA;;QAJAC;eAAAA;;QADAC;eAAAA;;QAOAC;eAAAA;;;AAVN,IAAMR,eAAe;AAGrB,IAAMO,cAAc;IAAC;IAAgB;IAAgB;IAAgB;IAAoB;IAAiB;IAAyB;CAA+B;AAClK,IAAMD,qBAAqB;IAAC;IAAU;CAAY;AAIlD,IAAMD,sBAAsB;AAE5B,IAAMG,qBACX;AAGK,IAAML,4BAA4B;IAAEM,UAAU;QAAC;YAAEC,OAAO;YAAMC,gBAAgB;YAAQC,QAAQ;gBAAC;oBAAC;iBAAQ;aAAC;QAAC;KAAE;IAAEC,kBAAkB;AAAM;AACtI,IAAMZ,6BAA6B;IAAEQ,UAAU;QAAC;YAAEC,OAAO;YAAMI,cAAc;gBAAEC,MAAM;gBAAQC,SAAS;YAAmB;QAAE;KAAE;AAAC;AAC9H,IAAMd,2BAA2B;IAAEQ,OAAO;IAAMO,QAAQ;AAAoB;AAE5E,IAAMb,uBAAuB;IAClC;IACA;IACA;IACC,oCAAkGc,OAA/DA,KAAKC,SAAS,CAAChB,4BAA2B,uBAAkHe,OAA7FA,KAAKC,SAAS,CAAClB,6BAA4B,oDAA2F,OAAzCiB,KAAKC,SAAS,CAACjB,2BAA0B;IACzO;CACD,CAACkB,IAAI,CAAC"}
|
|
@@ -25,11 +25,11 @@ declare const inputSchema: z.ZodObject<{
|
|
|
25
25
|
}>>;
|
|
26
26
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
27
27
|
type: z.ZodEnum<{
|
|
28
|
+
DATE: "DATE";
|
|
28
29
|
TEXT: "TEXT";
|
|
29
30
|
NUMBER: "NUMBER";
|
|
30
31
|
PERCENT: "PERCENT";
|
|
31
32
|
CURRENCY: "CURRENCY";
|
|
32
|
-
DATE: "DATE";
|
|
33
33
|
TIME: "TIME";
|
|
34
34
|
}>;
|
|
35
35
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -71,7 +71,7 @@ declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Pr
|
|
|
71
71
|
export default function createTool(): {
|
|
72
72
|
name: string;
|
|
73
73
|
config: {
|
|
74
|
-
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.";
|
|
74
|
+
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
75
75
|
readonly inputSchema: z.ZodObject<{
|
|
76
76
|
id: z.ZodString;
|
|
77
77
|
gid: z.ZodCoercedString<unknown>;
|
|
@@ -96,11 +96,11 @@ export default function createTool(): {
|
|
|
96
96
|
}>>;
|
|
97
97
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
98
98
|
type: z.ZodEnum<{
|
|
99
|
+
DATE: "DATE";
|
|
99
100
|
TEXT: "TEXT";
|
|
100
101
|
NUMBER: "NUMBER";
|
|
101
102
|
PERCENT: "PERCENT";
|
|
102
103
|
CURRENCY: "CURRENCY";
|
|
103
|
-
DATE: "DATE";
|
|
104
104
|
TIME: "TIME";
|
|
105
105
|
}>;
|
|
106
106
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -25,11 +25,11 @@ declare const inputSchema: z.ZodObject<{
|
|
|
25
25
|
}>>;
|
|
26
26
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
27
27
|
type: z.ZodEnum<{
|
|
28
|
+
DATE: "DATE";
|
|
28
29
|
TEXT: "TEXT";
|
|
29
30
|
NUMBER: "NUMBER";
|
|
30
31
|
PERCENT: "PERCENT";
|
|
31
32
|
CURRENCY: "CURRENCY";
|
|
32
|
-
DATE: "DATE";
|
|
33
33
|
TIME: "TIME";
|
|
34
34
|
}>;
|
|
35
35
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -71,7 +71,7 @@ declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Pr
|
|
|
71
71
|
export default function createTool(): {
|
|
72
72
|
name: string;
|
|
73
73
|
config: {
|
|
74
|
-
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.";
|
|
74
|
+
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
75
75
|
readonly inputSchema: z.ZodObject<{
|
|
76
76
|
id: z.ZodString;
|
|
77
77
|
gid: z.ZodCoercedString<unknown>;
|
|
@@ -96,11 +96,11 @@ export default function createTool(): {
|
|
|
96
96
|
}>>;
|
|
97
97
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
98
98
|
type: z.ZodEnum<{
|
|
99
|
+
DATE: "DATE";
|
|
99
100
|
TEXT: "TEXT";
|
|
100
101
|
NUMBER: "NUMBER";
|
|
101
102
|
PERCENT: "PERCENT";
|
|
102
103
|
CURRENCY: "CURRENCY";
|
|
103
|
-
DATE: "DATE";
|
|
104
104
|
TIME: "TIME";
|
|
105
105
|
}>;
|
|
106
106
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -12,6 +12,7 @@ var _sheets = require("@googleapis/sheets");
|
|
|
12
12
|
var _oauthgoogle = require("@mcp-z/oauth-google");
|
|
13
13
|
var _server = require("@mcp-z/server");
|
|
14
14
|
var _zod = require("zod");
|
|
15
|
+
var _constantsts = require("../../constants.js");
|
|
15
16
|
var _googleauthts = require("../../lib/google-auth.js");
|
|
16
17
|
var _indexts = require("../../schemas/index.js");
|
|
17
18
|
var _rangeoperationsts = require("../../spreadsheet/range-operations.js");
|
|
@@ -163,7 +164,7 @@ var NumberFormatSchema = _zod.z.object({
|
|
|
163
164
|
'DATE',
|
|
164
165
|
'TIME'
|
|
165
166
|
]).describe('Number format type'),
|
|
166
|
-
pattern: _zod.z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency)')
|
|
167
|
+
pattern: _zod.z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency, "yyyy-mm-dd hh:mm" for a date/time serial)')
|
|
167
168
|
});
|
|
168
169
|
// Border schema
|
|
169
170
|
var BorderSchema = _zod.z.object({
|
|
@@ -211,7 +212,7 @@ var outputSchema = _zod.z.discriminatedUnion('type', [
|
|
|
211
212
|
AuthRequiredBranchSchema
|
|
212
213
|
]);
|
|
213
214
|
var config = {
|
|
214
|
-
description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',
|
|
215
|
+
description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:"DATE", pattern:"yyyy-mm-dd hh:mm"} only displays a numeric serial as a date; it does not convert text. '.concat(_constantsts.NATIVE_DATE_POINTER),
|
|
215
216
|
inputSchema: inputSchema,
|
|
216
217
|
outputSchema: _zod.z.object({
|
|
217
218
|
result: outputSchema
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\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, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ColorSchema","z","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","successBranchSchema","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","cellFormat","fields","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","rangeReferenceToGridRange","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency, \"yyyy-mm-dd hh:mm\" for a date/time serial)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. ${NATIVE_DATE_POINTER}`,\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, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ColorSchema","z","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","successBranchSchema","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","NATIVE_DATE_POINTER","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","cellFormat","fields","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","rangeReferenceToGridRange","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":";;;;+BAiSA;;;eAAwBA;;;sBAjS4B;2BAE5B;sBAKyB;mBAC/B;2BACkB;4BACT;uBAC8D;iCAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAR3D,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAUR,qDAAqD;AACrD,IAAME,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,KAAKF,MAAC,CAACG,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IACvCC,OAAOP,MAAC,CAACG,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IACzCE,MAAMR,MAAC,CAACG,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAC1C;AAEA,uBAAuB;AACvB,IAAMG,qBAAqBT,MAAC,CAACC,MAAM,CAAC;IAClCS,MAAMV,MAAC,CAACW,IAAI,CAAC;QAAC;QAAQ;QAAU;QAAW;QAAY;QAAQ;KAAO,EAAEL,QAAQ,CAAC;IACjFM,SAASZ,MAAC,CAACa,MAAM,GAAGC,QAAQ,GAAGR,QAAQ,CAAC;AAC1C;AAEA,gBAAgB;AAChB,IAAMS,eAAef,MAAC,CAACC,MAAM,CAAC;IAC5Be,OAAOhB,MAAC,CAACW,IAAI,CAAC;QAAC;QAAS;QAAU;KAAS,EAAEL,QAAQ,CAAC;IACtDW,OAAOlB,YAAYO,QAAQ,CAAC;AAC9B;AAEA,mCAAmC;AACnC,IAAMY,sBAAsBlB,MAAC,CAACC,MAAM,CAAC;IACnCkB,OAAOnB,MAAC,CAACa,MAAM,GAAGT,GAAG,CAAC,GAAGE,QAAQ,CAAC;IAClCc,iBAAiBrB,YAAYe,QAAQ,GAAGR,QAAQ,CAAC;IACjDe,WAAWtB,YAAYe,QAAQ,GAAGR,QAAQ,CAAC;IAC3CgB,MAAMtB,MAAC,CAACuB,OAAO,GAAGT,QAAQ,GAAGR,QAAQ,CAAC;IACtCkB,UAAUxB,MAAC,CAACG,MAAM,GAAGsB,GAAG,GAAGrB,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIS,QAAQ,GAAGR,QAAQ,CAAC;IAC9DoB,qBAAqB1B,MAAC,CAACW,IAAI,CAAC;QAAC;QAAQ;QAAU;KAAQ,EAAEG,QAAQ,GAAGR,QAAQ,CAAC;IAC7EqB,cAAclB,mBAAmBK,QAAQ,GAAGR,QAAQ,CAAC;IACrDsB,SAASb,aAAaD,QAAQ,GAAGR,QAAQ,CAAC;AAC5C;AAEA,IAAMuB,cAAc7B,MAAC,CAACC,MAAM,CAAC;IAC3B6B,IAAIC,4BAAmB;IACvBC,KAAKC,uBAAc;IACnBC,UAAUlC,MAAC,CAACmC,KAAK,CAACjB,qBAAqBd,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIC,QAAQ,CAAC;AACjE;AAEA,IAAM8B,sBAAsBpC,MAAC,CAACC,MAAM,CAAC;IACnCS,MAAMV,MAAC,CAACqC,OAAO,CAAC;IAChBP,IAAIQ,4BAAmB;IACvBN,KAAKO,uBAAc;IACnBC,YAAYxC,MAAC,CAACa,MAAM,GAAGP,QAAQ,CAAC;IAChCmC,UAAUzC,MAAC,CAACa,MAAM,GAAGP,QAAQ,CAAC;IAC9BoC,cAAc1C,MAAC,CAACG,MAAM,GAAGsB,GAAG,GAAGkB,WAAW,GAAGrC,QAAQ,CAAC;IACtDsC,cAAc5C,MAAC,CACZmC,KAAK,CACJnC,MAAC,CAACC,MAAM,CAAC;QACPkB,OAAOnB,MAAC,CAACa,MAAM,GAAGP,QAAQ,CAAC;QAC3BuC,OAAO7C,MAAC,CAACa,MAAM,GAAGP,QAAQ,CAAC;IAC7B,IAEDQ,QAAQ,GACRR,QAAQ,CAAC;AACd;AAEA,IAAMwC,eAAe9C,MAAC,CAAC+C,kBAAkB,CAAC,QAAQ;IAACX;IAAqBvC;CAAyB;AAEjG,IAAMmD,SAAS;IACbC,aAAa,AAAC,iYAAoZ,OAApBC,gCAAmB;IACjarB,aAAAA;IACAiB,cAAc9C,MAAC,CAACC,MAAM,CAAC;QACrBkD,QAAQL;IACV;AACF;AAKA,SAAeM;wCAAQ,KAA4B,EAAEC,KAAoB;YAAhDvB,IAAIE,KAAKE,UAC1BoB,QAuBeC,yBAEHA,2BARFC,kCATRC,QAGAD,qBAMAD,OAMAf,YAEAkB,SACAjB,UAGAkB,eACAf,cAED,2BAAA,mBAAA,gBAAA,WAAA,OAAMgB,SAGDC,UAGAC,WAGAC,YAMAC,QAiCErC,cAgDFsC,SAcFd,QAmCFA,SAcCN,OACDoB;;;;oBAjMenC,KAAF,MAAEA,IAAIE,MAAN,MAAMA,KAAKE,WAAX,MAAWA;oBAC1BoB,SAASD,MAAMC,MAAM;oBAC3BA,OAAOY,IAAI,CAAC,8BAA8B;wBACxCpC,IAAAA;wBACAE,KAAAA;wBACAmC,cAAcjC,SAASkC,MAAM;oBAC/B;;;;;;;;;oBAGQX,SAASY,IAAAA,cAAS,EAAC;wBAAEC,SAAS;wBAAMC,MAAMC,IAAAA,wBAAU,EAACnB,MAAMoB,WAAW,CAACF,IAAI;oBAAE;oBAGvD;;wBAAMd,OAAOiB,YAAY,CAACC,GAAG,CAAC;4BACxDC,eAAe9C;4BACfkC,QAAQ;wBACV;;;oBAHMR,sBAAsB;oBAK5B,oBAAoB;oBACdD,SAAQC,mCAAAA,oBAAoBqB,IAAI,CAACpB,MAAM,cAA/BD,uDAAAA,iCAAiCsB,IAAI,CAAC,SAACC;4BAAaA;+BAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcrB,OAAO,MAAM1B;;oBAC7F,IAAI,EAACuB,kBAAAA,4BAAAA,MAAO0B,UAAU,GAAE;wBACtB3B,OAAOY,IAAI,CAAC,oCAAoC;4BAAEpC,IAAAA;4BAAIE,KAAAA;4BAAKmC,cAAcjC,SAASkC,MAAM;wBAAC;wBACzF,MAAM,IAAIc,qBAAa,CAACC,yBAAiB,CAACC,aAAa,EAAE,AAAC,oBAAuB,OAAJpD;oBAC/E;oBAEMQ,cAAae,0BAAAA,MAAM0B,UAAU,CAACI,KAAK,cAAtB9B,qCAAAA,0BAA0BvB;oBAC7C,2JAA2J;oBACrJ0B,WAAUH,4BAAAA,MAAM0B,UAAU,CAACvB,OAAO,cAAxBH,uCAAAA,4BAA4B;oBACtCd,WAAW,AAAC,0CAAwDiB,OAAf5B,IAAG,cAAoB,OAAR4B;oBAE1E,8BAA8B;oBACxBC;oBACAf;oBAED,kCAAA,2BAAA;;wBAAL,IAAK,YAAiBV,+BAAjB,6BAAA,QAAA,yBAAA,iCAA2B;4BAArB0B,UAAN;4BACH,IAAI;gCACF,uCAAuC;gCACjCC,WAAWyB,IAAAA,kCAAe,EAAC1B,QAAQzC,KAAK;gCAE9C,8DAA8D;gCACxD2C,YAAYyB,IAAAA,4CAAyB,EAAC1B,UAAUH;gCAEtD,2BAA2B;gCACrBK,aAKF,CAAC;gCACCC;gCAEN,mBAAmB;gCACnB,IAAIJ,QAAQxC,eAAe,EAAE;oCAC3B2C,WAAW3C,eAAe,GAAGwC,QAAQxC,eAAe;oCACpD4C,OAAOwB,IAAI,CAAC;gCACd;gCAEA,cAAc;gCACd,IAAI5B,QAAQvC,SAAS,IAAIuC,QAAQtC,IAAI,KAAKmE,aAAa7B,QAAQpC,QAAQ,KAAKiE,WAAW;oCACrF1B,WAAW2B,UAAU,GAAG,CAAC;oCACzB,IAAI9B,QAAQvC,SAAS,EAAE;wCACrB0C,WAAW2B,UAAU,CAACC,eAAe,GAAG/B,QAAQvC,SAAS;wCACzD2C,OAAOwB,IAAI,CAAC;oCACd;oCACA,IAAI5B,QAAQtC,IAAI,KAAKmE,WAAW;wCAC9B1B,WAAW2B,UAAU,CAACpE,IAAI,GAAGsC,QAAQtC,IAAI;wCACzC0C,OAAOwB,IAAI,CAAC;oCACd;oCACA,IAAI5B,QAAQpC,QAAQ,KAAKiE,WAAW;wCAClC1B,WAAW2B,UAAU,CAAClE,QAAQ,GAAGoC,QAAQpC,QAAQ;wCACjDwC,OAAOwB,IAAI,CAAC;oCACd;gCACF;gCAEA,uBAAuB;gCACvB,IAAI5B,QAAQlC,mBAAmB,EAAE;oCAC/BqC,WAAWrC,mBAAmB,GAAGkC,QAAQlC,mBAAmB;oCAC5DsC,OAAOwB,IAAI,CAAC;gCACd;gCAEA,gBAAgB;gCAChB,IAAI5B,QAAQjC,YAAY,EAAE;oCAClBA,eAA8C;wCAClDjB,MAAMkD,QAAQjC,YAAY,CAACjB,IAAI;oCACjC;oCACA,IAAIkD,QAAQjC,YAAY,CAACf,OAAO,KAAK6E,WAAW;wCAC9C9D,aAAaf,OAAO,GAAGgD,QAAQjC,YAAY,CAACf,OAAO;oCACrD;oCACAmD,WAAWpC,YAAY,GAAGA;oCAC1BqC,OAAOwB,IAAI,CAAC;gCACd;gCAEA,wCAAwC;gCACxC,IAAIxB,OAAOI,MAAM,GAAG,GAAG;oCACrBT,cAAc6B,IAAI,CAAC;wCACjBI,YAAY;4CACVzE,OAAO2C;4CACP+B,MAAM;gDACJC,mBAAmB/B;4CACrB;4CACAC,QAAQ,AAAC,qBAAqC,OAAjBA,OAAO+B,IAAI,CAAC,MAAK;wCAChD;oCACF;gCACF;gCAEA,qCAAqC;gCACrC,IAAInC,QAAQhC,OAAO,EAAE;oCACnB+B,cAAc6B,IAAI,CAAC;wCACjBQ,eAAe;4CACb7E,OAAO2C;4CACPmC,KAAK;gDACHjF,OAAO4C,QAAQhC,OAAO,CAACZ,KAAK;gDAC5BC,OAAO2C,QAAQhC,OAAO,CAACX,KAAK;4CAC9B;4CACAiF,QAAQ;gDACNlF,OAAO4C,QAAQhC,OAAO,CAACZ,KAAK;gDAC5BC,OAAO2C,QAAQhC,OAAO,CAACX,KAAK;4CAC9B;4CACAkF,MAAM;gDACJnF,OAAO4C,QAAQhC,OAAO,CAACZ,KAAK;gDAC5BC,OAAO2C,QAAQhC,OAAO,CAACX,KAAK;4CAC9B;4CACAmF,OAAO;gDACLpF,OAAO4C,QAAQhC,OAAO,CAACZ,KAAK;gDAC5BC,OAAO2C,QAAQhC,OAAO,CAACX,KAAK;4CAC9B;wCACF;oCACF;gCACF;4BACF,EAAE,OAAO4B,OAAO;gCACRoB,UAAUpB,AAAK,YAALA,OAAiBwD,SAAQxD,MAAMoB,OAAO,GAAGe,OAAOnC;gCAChES,OAAOY,IAAI,CAAC,wCAAwC;oCAClD/C,OAAOyC,QAAQzC,KAAK;oCACpB0B,OAAOoB;gCACT;gCACArB,aAAa4C,IAAI,CAAC;oCAChBrE,OAAOyC,QAAQzC,KAAK;oCACpB0B,OAAO,AAAC,0BAAiC,OAARoB;gCACnC;4BACF;wBACF;;wBA1GK;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBA4GL,oCAAoC;oBACpC,IAAIN,cAAcS,MAAM,KAAK,GAAG;wBACxBjB,SAAiB;4BACrBzC,MAAM;4BACNoB,IAAAA;4BACAE,KAAKgD,OAAOtB;4BACZlB,YAAAA;4BACAC,UAAAA;4BACAC,cAAc;4BACdE,cAAcA,aAAawB,MAAM,GAAG,IAAIxB,eAAe6C;wBACzD;wBAEA;;4BAAO;gCACLa,OAAO;oCAAG;wCAAE5F,MAAM;wCAAiB6F,MAAMC,KAAKC,SAAS,CAACtD;oCAAQ;;gCAChEuD,mBAAmB;oCAAEvD,QAAAA;gCAAO;4BAC9B;;oBACF;oBAEAG,OAAOY,IAAI,CAAC,+CAA+C;wBACzDU,eAAe9C;wBACfU,YAAAA;wBACAmE,oBAAoBhD,cAAcS,MAAM;oBAC1C;oBAEA,2BAA2B;oBAC3B;;wBAAMX,OAAOiB,YAAY,CAACkC,WAAW,CAAC;4BACpChC,eAAe9C;4BACf+E,aAAa;gCACX3E,UAAUyB;4BACZ;wBACF;;;oBALA;oBAOAL,OAAOY,IAAI,CAAC,8CAA8C;wBACxDxB,cAAcR,SAASkC,MAAM,GAAGxB,aAAawB,MAAM;wBACnD0C,aAAalE,aAAawB,MAAM;oBAClC;oBAEMjB,UAAiB;wBACrBzC,MAAM;wBACNoB,IAAAA;wBACAE,KAAKgD,OAAOtB;wBACZlB,YAAAA;wBACAC,UAAAA;wBACAC,cAAcR,SAASkC,MAAM,GAAGxB,aAAawB,MAAM;wBACnDxB,cAAcA,aAAawB,MAAM,GAAG,IAAIxB,eAAe6C;oBACzD;oBAEA;;wBAAO;4BACLa,OAAO;gCAAG;oCAAE5F,MAAM;oCAAiB6F,MAAMC,KAAKC,SAAS,CAACtD;gCAAQ;;4BAChEuD,mBAAmB;gCAAEvD,QAAAA;4BAAO;wBAC9B;;;oBACON;oBACDoB,WAAUpB,AAAK,YAALA,OAAiBwD,SAAQxD,MAAMoB,OAAO,GAAGe,OAAOnC;oBAChES,OAAOT,KAAK,CAAC,iCAAiC;wBAC5Cf,IAAAA;wBACAE,KAAAA;wBACAmC,cAAcjC,SAASkC,MAAM;wBAC7BvB,OAAOoB;oBACT;oBAEA,MAAM,IAAIiB,qBAAa,CAACC,yBAAiB,CAAC4B,aAAa,EAAE,AAAC,2BAAkC,OAAR9C,WAAW;wBAC7F+C,OAAOnE,AAAK,YAALA,OAAiBwD,SAAQxD,MAAMmE,KAAK,GAAGvB;oBAChD;;;;;;;IAEJ;;AAEe,SAAS7F;IACtB,OAAO;QACLqH,MAAM;QACNjE,QAAAA;QACAI,SAAAA;IACF;AACF"}
|
|
@@ -6,8 +6,8 @@ declare const inputSchema: z.ZodObject<{
|
|
|
6
6
|
id: z.ZodString;
|
|
7
7
|
gid: z.ZodCoercedString<unknown>;
|
|
8
8
|
render: z.ZodOptional<z.ZodEnum<{
|
|
9
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
10
9
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
10
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
11
11
|
FORMULA: "FORMULA";
|
|
12
12
|
}>>;
|
|
13
13
|
}, z.core.$strip>;
|
|
@@ -32,8 +32,8 @@ export default function createTool(): {
|
|
|
32
32
|
id: z.ZodString;
|
|
33
33
|
gid: z.ZodCoercedString<unknown>;
|
|
34
34
|
render: z.ZodOptional<z.ZodEnum<{
|
|
35
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
36
35
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
36
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
37
37
|
FORMULA: "FORMULA";
|
|
38
38
|
}>>;
|
|
39
39
|
}, z.core.$strip>;
|
|
@@ -6,8 +6,8 @@ declare const inputSchema: z.ZodObject<{
|
|
|
6
6
|
id: z.ZodString;
|
|
7
7
|
gid: z.ZodCoercedString<unknown>;
|
|
8
8
|
render: z.ZodOptional<z.ZodEnum<{
|
|
9
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
10
9
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
10
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
11
11
|
FORMULA: "FORMULA";
|
|
12
12
|
}>>;
|
|
13
13
|
}, z.core.$strip>;
|
|
@@ -32,8 +32,8 @@ export default function createTool(): {
|
|
|
32
32
|
id: z.ZodString;
|
|
33
33
|
gid: z.ZodCoercedString<unknown>;
|
|
34
34
|
render: z.ZodOptional<z.ZodEnum<{
|
|
35
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
36
35
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
36
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
37
37
|
FORMULA: "FORMULA";
|
|
38
38
|
}>>;
|
|
39
39
|
}, z.core.$strip>;
|
|
@@ -12,6 +12,7 @@ var _sheets = require("@googleapis/sheets");
|
|
|
12
12
|
var _oauthgoogle = require("@mcp-z/oauth-google");
|
|
13
13
|
var _server = require("@mcp-z/server");
|
|
14
14
|
var _zod = require("zod");
|
|
15
|
+
var _constantsts = require("../../constants.js");
|
|
15
16
|
var _googleauthts = require("../../lib/google-auth.js");
|
|
16
17
|
var _indexts = require("../../schemas/index.js");
|
|
17
18
|
function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
|
|
@@ -153,7 +154,7 @@ var inputSchema = _zod.z.object({
|
|
|
153
154
|
'FORMATTED_VALUE',
|
|
154
155
|
'UNFORMATTED_VALUE',
|
|
155
156
|
'FORMULA'
|
|
156
|
-
]).optional().describe(
|
|
157
|
+
]).optional().describe(_constantsts.RENDER_DESCRIPTION)
|
|
157
158
|
});
|
|
158
159
|
// Success branch schema - uses columns: for consistency with standard vocabulary
|
|
159
160
|
var successBranchSchema = _zod.z.object({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe(
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { RENDER_DESCRIPTION } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe(RENDER_DESCRIPTION),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\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, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? '';\n\n // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n const range = `'${sheetTitle}'!A1:ZZZ1`;\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n\n const rows = response.data.values || [];\n const isEmpty = rows.length === 0;\n\n // Extract first row and convert to strings (column names)\n const firstRow = rows[0] || [];\n const columns = firstRow.map((value) => String(value ?? ''));\n\n const result: Output = {\n type: 'success' as const,\n columns,\n isEmpty,\n };\n\n logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\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.columns.get error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-get',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","render","enum","optional","describe","RENDER_DESCRIPTION","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetTitle","range","response","rows","firstRow","error","message","debug","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","values","valueRenderOption","length","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
|
|
@@ -42,7 +42,7 @@ declare function handler({ id, gid, rows, headers, updateBy, behavior, valueInpu
|
|
|
42
42
|
export default function createTool(): {
|
|
43
43
|
name: string;
|
|
44
44
|
config: {
|
|
45
|
-
readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.";
|
|
45
|
+
readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
46
46
|
readonly inputSchema: z.ZodObject<{
|
|
47
47
|
id: z.ZodString;
|
|
48
48
|
gid: z.ZodCoercedString<unknown>;
|
|
@@ -42,7 +42,7 @@ declare function handler({ id, gid, rows, headers, updateBy, behavior, valueInpu
|
|
|
42
42
|
export default function createTool(): {
|
|
43
43
|
name: string;
|
|
44
44
|
config: {
|
|
45
|
-
readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.";
|
|
45
|
+
readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
46
46
|
readonly inputSchema: z.ZodObject<{
|
|
47
47
|
id: z.ZodString;
|
|
48
48
|
gid: z.ZodCoercedString<unknown>;
|
|
@@ -12,6 +12,7 @@ var _sheets = require("@googleapis/sheets");
|
|
|
12
12
|
var _oauthgoogle = require("@mcp-z/oauth-google");
|
|
13
13
|
var _server = require("@mcp-z/server");
|
|
14
14
|
var _zod = require("zod");
|
|
15
|
+
var _constantsts = require("../../constants.js");
|
|
15
16
|
var _googleauthts = require("../../lib/google-auth.js");
|
|
16
17
|
var _indexts = require("../../schemas/index.js");
|
|
17
18
|
var _dataoperationsts = require("../../spreadsheet/data-operations.js");
|
|
@@ -162,7 +163,7 @@ var inputSchema = _zod.z.object({
|
|
|
162
163
|
valueInputOption: _zod.z.enum([
|
|
163
164
|
'RAW',
|
|
164
165
|
'USER_ENTERED'
|
|
165
|
-
]).default('USER_ENTERED').describe('How input data should be interpreted (
|
|
166
|
+
]).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)')
|
|
166
167
|
}).refine(function(data) {
|
|
167
168
|
// Validate that all updateBy columns exist in headers
|
|
168
169
|
var missingColumns = data.updateBy.filter(function(col) {
|
|
@@ -215,7 +216,7 @@ var outputSchema = _zod.z.discriminatedUnion('type', [
|
|
|
215
216
|
AuthRequiredBranchSchema
|
|
216
217
|
]);
|
|
217
218
|
var config = {
|
|
218
|
-
description:
|
|
219
|
+
description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ".concat(_constantsts.NATIVE_DATE_POINTER),
|
|
219
220
|
inputSchema: inputSchema,
|
|
220
221
|
outputSchema: _zod.z.object({
|
|
221
222
|
result: outputSchema
|