mcp-google-multi 6.0.0-beta.1 → 6.0.0-beta.3

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.
Files changed (182) hide show
  1. package/README.md +5 -3
  2. package/dist/accounts.d.ts +22 -1
  3. package/dist/accounts.js +64 -16
  4. package/dist/api-probe.d.ts +5 -0
  5. package/dist/api-probe.js +23 -15
  6. package/dist/arg-normalize.d.ts +61 -4
  7. package/dist/arg-normalize.js +229 -4
  8. package/dist/arg-strict.d.ts +61 -0
  9. package/dist/arg-strict.js +193 -0
  10. package/dist/auth.d.ts +4 -3
  11. package/dist/auth.js +26 -85
  12. package/dist/boot-gates.d.ts +26 -0
  13. package/dist/boot-gates.js +38 -0
  14. package/dist/cimd-cache.d.ts +38 -0
  15. package/dist/cimd-cache.js +117 -0
  16. package/dist/client.d.ts +32 -2
  17. package/dist/client.js +0 -0
  18. package/dist/compose.d.ts +11 -0
  19. package/dist/compose.js +109 -0
  20. package/dist/config-file.d.ts +14 -0
  21. package/dist/config-file.js +41 -1
  22. package/dist/discover.js +38 -15
  23. package/dist/discovery-client.d.ts +11 -1
  24. package/dist/discovery-client.js +120 -18
  25. package/dist/doctor.d.ts +15 -3
  26. package/dist/doctor.js +151 -27
  27. package/dist/env-load.d.ts +11 -0
  28. package/dist/env-load.js +23 -1
  29. package/dist/executor.d.ts +3 -0
  30. package/dist/executor.js +16 -3
  31. package/dist/fanout.d.ts +9 -1
  32. package/dist/fanout.js +83 -14
  33. package/dist/fs-atomic.d.ts +11 -0
  34. package/dist/fs-atomic.js +219 -28
  35. package/dist/hint-provider.d.ts +129 -0
  36. package/dist/hint-provider.js +64 -0
  37. package/dist/http-transport.d.ts +73 -6
  38. package/dist/http-transport.js +350 -26
  39. package/dist/identity.d.ts +4 -1
  40. package/dist/identity.js +25 -6
  41. package/dist/index.js +142 -114
  42. package/dist/master-key.js +13 -5
  43. package/dist/mcp-token.d.ts +136 -19
  44. package/dist/mcp-token.js +569 -72
  45. package/dist/metrics-cli.d.ts +21 -0
  46. package/dist/metrics-cli.js +206 -0
  47. package/dist/metrics-tap.d.ts +12 -0
  48. package/dist/metrics-tap.js +95 -0
  49. package/dist/migrate-config.js +2 -2
  50. package/dist/oauth-as.d.ts +103 -3
  51. package/dist/oauth-as.js +374 -79
  52. package/dist/oauth-consent.d.ts +35 -10
  53. package/dist/oauth-consent.js +101 -39
  54. package/dist/outbound-allowlist.d.ts +34 -0
  55. package/dist/outbound-allowlist.js +111 -0
  56. package/dist/reauth-hint.d.ts +1 -1
  57. package/dist/reauth-hint.js +12 -8
  58. package/dist/registry-transfer.d.ts +5 -0
  59. package/dist/registry-transfer.js +65 -5
  60. package/dist/registry.d.ts +66 -2
  61. package/dist/registry.js +214 -18
  62. package/dist/scope-catalog.d.ts +11 -0
  63. package/dist/scope-catalog.js +39 -6
  64. package/dist/scope-observability.d.ts +8 -6
  65. package/dist/scope-observability.js +29 -13
  66. package/dist/services.d.ts +17 -4
  67. package/dist/services.js +77 -6
  68. package/dist/setup-prompt.d.ts +1 -1
  69. package/dist/setup-prompt.js +1 -1
  70. package/dist/ssrf-guard.d.ts +23 -9
  71. package/dist/ssrf-guard.js +101 -62
  72. package/dist/tenant-purge.d.ts +26 -0
  73. package/dist/tenant-purge.js +67 -0
  74. package/dist/token-store.d.ts +20 -2
  75. package/dist/token-store.js +0 -0
  76. package/dist/tools/_coerce.d.ts +5 -0
  77. package/dist/tools/_coerce.js +11 -0
  78. package/dist/tools/_errors.d.ts +34 -3
  79. package/dist/tools/_errors.js +346 -53
  80. package/dist/tools/_local-files.d.ts +9 -0
  81. package/dist/tools/_local-files.js +25 -2
  82. package/dist/tools/account-wizard.d.ts +34 -2
  83. package/dist/tools/account-wizard.js +223 -65
  84. package/dist/tools/accounts-tool.d.ts +7 -0
  85. package/dist/tools/accounts-tool.js +34 -18
  86. package/dist/tools/admin.d.ts +10 -1
  87. package/dist/tools/admin.js +21 -16
  88. package/dist/tools/analytics.d.ts +27 -0
  89. package/dist/tools/analytics.js +289 -0
  90. package/dist/tools/calendar.d.ts +9 -1
  91. package/dist/tools/calendar.js +93 -29
  92. package/dist/tools/chat.d.ts +10 -1
  93. package/dist/tools/chat.js +20 -12
  94. package/dist/tools/contacts.d.ts +2 -1
  95. package/dist/tools/contacts.js +74 -43
  96. package/dist/tools/docs.d.ts +2 -1
  97. package/dist/tools/docs.js +90 -84
  98. package/dist/tools/drive.d.ts +2 -1
  99. package/dist/tools/drive.js +197 -120
  100. package/dist/tools/forms.d.ts +10 -1
  101. package/dist/tools/forms.js +26 -19
  102. package/dist/tools/generated/_shared.d.ts +8 -1
  103. package/dist/tools/generated/_shared.js +18 -4
  104. package/dist/tools/generated/admin.d.ts +2 -1
  105. package/dist/tools/generated/admin.js +610 -479
  106. package/dist/tools/generated/analytics.d.ts +3 -0
  107. package/dist/tools/generated/analytics.js +981 -0
  108. package/dist/tools/generated/appsmarket.d.ts +2 -1
  109. package/dist/tools/generated/appsmarket.js +9 -9
  110. package/dist/tools/generated/calendar.d.ts +2 -1
  111. package/dist/tools/generated/calendar.js +83 -83
  112. package/dist/tools/generated/chat.d.ts +2 -1
  113. package/dist/tools/generated/chat.js +178 -151
  114. package/dist/tools/generated/classroom.d.ts +2 -1
  115. package/dist/tools/generated/classroom.js +467 -425
  116. package/dist/tools/generated/cloudidentity.d.ts +2 -1
  117. package/dist/tools/generated/cloudidentity.js +209 -201
  118. package/dist/tools/generated/cloudsearch.d.ts +2 -1
  119. package/dist/tools/generated/cloudsearch.js +139 -138
  120. package/dist/tools/generated/contacts.d.ts +2 -1
  121. package/dist/tools/generated/contacts.js +49 -40
  122. package/dist/tools/generated/drive.d.ts +2 -1
  123. package/dist/tools/generated/drive.js +133 -124
  124. package/dist/tools/generated/driveactivity.d.ts +2 -1
  125. package/dist/tools/generated/driveactivity.js +3 -3
  126. package/dist/tools/generated/drivelabels.d.ts +2 -1
  127. package/dist/tools/generated/drivelabels.js +113 -85
  128. package/dist/tools/generated/forms.d.ts +2 -1
  129. package/dist/tools/generated/forms.js +14 -14
  130. package/dist/tools/generated/gmail.d.ts +2 -1
  131. package/dist/tools/generated/gmail.js +253 -226
  132. package/dist/tools/generated/groupsmigration.d.ts +2 -1
  133. package/dist/tools/generated/groupsmigration.js +4 -4
  134. package/dist/tools/generated/groupssettings.d.ts +2 -1
  135. package/dist/tools/generated/groupssettings.js +10 -10
  136. package/dist/tools/generated/index.d.ts +2 -1
  137. package/dist/tools/generated/index.js +2 -0
  138. package/dist/tools/generated/keep.d.ts +2 -1
  139. package/dist/tools/generated/keep.js +23 -22
  140. package/dist/tools/generated/licensing.d.ts +2 -1
  141. package/dist/tools/generated/licensing.js +54 -38
  142. package/dist/tools/generated/meet.d.ts +2 -1
  143. package/dist/tools/generated/meet.js +41 -41
  144. package/dist/tools/generated/method-map.d.ts +2 -0
  145. package/dist/tools/generated/method-map.js +894 -0
  146. package/dist/tools/generated/postmaster.d.ts +2 -1
  147. package/dist/tools/generated/postmaster.js +12 -12
  148. package/dist/tools/generated/reseller.d.ts +2 -1
  149. package/dist/tools/generated/reseller.js +69 -63
  150. package/dist/tools/generated/script.d.ts +2 -1
  151. package/dist/tools/generated/script.js +62 -52
  152. package/dist/tools/generated/searchconsole.d.ts +2 -1
  153. package/dist/tools/generated/searchconsole.js +8 -6
  154. package/dist/tools/generated/sheets.d.ts +2 -1
  155. package/dist/tools/generated/sheets.js +25 -24
  156. package/dist/tools/generated/tasks.d.ts +2 -1
  157. package/dist/tools/generated/tasks.js +15 -9
  158. package/dist/tools/generated/vault.d.ts +2 -1
  159. package/dist/tools/generated/vault.js +132 -123
  160. package/dist/tools/generated/workspaceevents.d.ts +2 -1
  161. package/dist/tools/generated/workspaceevents.js +48 -47
  162. package/dist/tools/gmail.d.ts +12 -2
  163. package/dist/tools/gmail.js +95 -51
  164. package/dist/tools/google-api.d.ts +2 -3
  165. package/dist/tools/google-api.js +76 -33
  166. package/dist/tools/meet.d.ts +10 -1
  167. package/dist/tools/meet.js +18 -11
  168. package/dist/tools/searchconsole.d.ts +2 -1
  169. package/dist/tools/searchconsole.js +27 -23
  170. package/dist/tools/sheets.d.ts +2 -1
  171. package/dist/tools/sheets.js +72 -80
  172. package/dist/tools/slides.d.ts +10 -1
  173. package/dist/tools/slides.js +23 -16
  174. package/dist/tools/tasks.d.ts +2 -1
  175. package/dist/tools/tasks.js +35 -31
  176. package/dist/trim.d.ts +26 -0
  177. package/dist/trim.js +67 -0
  178. package/dist/usage-metrics.d.ts +178 -0
  179. package/dist/usage-metrics.js +621 -0
  180. package/dist/write-control.d.ts +27 -1
  181. package/dist/write-control.js +99 -12
  182. package/package.json +34 -3
@@ -1,11 +1,15 @@
1
1
  import { z } from 'zod';
2
2
  import { coerceArray, coerceBoolean, coerceJson } from './_coerce.js';
3
3
  import { sheets as sheetsClient } from '@googleapis/sheets';
4
- import { accountAliasSchema } from '../accounts.js';
4
+ import { accountArgLive } from '../accounts.js';
5
5
  import { getClient } from '../client.js';
6
- import { handleGoogleApiError } from './_errors.js';
7
- const accountEnum = accountAliasSchema.optional();
8
- export function registerSheetsTools(server) {
6
+ import { handleGoogleApiError, invalidParams } from './_errors.js';
7
+ export function registerSheetsTools(server, deps = {}) {
8
+ // Per-registry, LIVE account enum + injectable client (S1.10): the
9
+ // schema follows the registry's account view at parse time, and the
10
+ // custody path is the context's, not the process global.
11
+ const accountEnum = accountArgLive(() => server.accountAliases()).optional();
12
+ const getClientFn = deps.getClientFn ?? getClient;
9
13
  server.registerTool('sheets_create', {
10
14
  description: 'Create a new Google Sheets spreadsheet',
11
15
  inputSchema: {
@@ -16,7 +20,7 @@ export function registerSheetsTools(server) {
16
20
  },
17
21
  }, async ({ account, title, sheetTitles }) => {
18
22
  try {
19
- const auth = await getClient(account);
23
+ const auth = await getClientFn(account);
20
24
  const sheets = sheetsClient({ version: 'v4', auth });
21
25
  const requestBody = {
22
26
  properties: { title },
@@ -44,11 +48,11 @@ export function registerSheetsTools(server) {
44
48
  description: 'Get spreadsheet metadata (title, sheets/tabs, named ranges)',
45
49
  inputSchema: {
46
50
  account: accountEnum.describe('Google account alias'),
47
- spreadsheetId: z.string().describe('Spreadsheet ID'),
51
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
48
52
  },
49
53
  }, async ({ account, spreadsheetId }) => {
50
54
  try {
51
- const auth = await getClient(account);
55
+ const auth = await getClientFn(account);
52
56
  const sheets = sheetsClient({ version: 'v4', auth });
53
57
  const res = await sheets.spreadsheets.get({
54
58
  spreadsheetId,
@@ -77,7 +81,7 @@ export function registerSheetsTools(server) {
77
81
  description: 'Read cell values from a spreadsheet range (A1 notation, e.g. "Sheet1!A1:D10")',
78
82
  inputSchema: {
79
83
  account: accountEnum.describe('Google account alias'),
80
- spreadsheetId: z.string().describe('Spreadsheet ID'),
84
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
81
85
  range: z.string().describe('A1 notation range, e.g. "Sheet1!A1:D10" or "A1:B5"'),
82
86
  valueRenderOption: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA'])
83
87
  .default('FORMATTED_VALUE').optional()
@@ -85,7 +89,7 @@ export function registerSheetsTools(server) {
85
89
  },
86
90
  }, async ({ account, spreadsheetId, range, valueRenderOption }) => {
87
91
  try {
88
- const auth = await getClient(account);
92
+ const auth = await getClientFn(account);
89
93
  const sheets = sheetsClient({ version: 'v4', auth });
90
94
  const res = await sheets.spreadsheets.values.get({
91
95
  spreadsheetId,
@@ -107,7 +111,7 @@ export function registerSheetsTools(server) {
107
111
  description: 'Write values to a spreadsheet range',
108
112
  inputSchema: {
109
113
  account: accountEnum.describe('Google account alias'),
110
- spreadsheetId: z.string().describe('Spreadsheet ID'),
114
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
111
115
  range: z.string().describe('A1 notation target range, e.g. "Sheet1!A1:C3"'),
112
116
  values: coerceJson(z.array(z.array(z.any()))).describe('2D array of values (rows x columns)'),
113
117
  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').optional()
@@ -115,7 +119,7 @@ export function registerSheetsTools(server) {
115
119
  },
116
120
  }, async ({ account, spreadsheetId, range, values, valueInputOption }) => {
117
121
  try {
118
- const auth = await getClient(account);
122
+ const auth = await getClientFn(account);
119
123
  const sheets = sheetsClient({ version: 'v4', auth });
120
124
  const res = await sheets.spreadsheets.values.update({
121
125
  spreadsheetId,
@@ -140,7 +144,7 @@ export function registerSheetsTools(server) {
140
144
  description: 'Append rows after the last row of existing data in a spreadsheet',
141
145
  inputSchema: {
142
146
  account: accountEnum.describe('Google account alias'),
143
- spreadsheetId: z.string().describe('Spreadsheet ID'),
147
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
144
148
  range: z.string().describe('A1 notation range to search for the table (e.g. "Sheet1")'),
145
149
  values: coerceJson(z.array(z.array(z.any()))).describe('2D array of rows to append'),
146
150
  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').optional()
@@ -148,7 +152,7 @@ export function registerSheetsTools(server) {
148
152
  },
149
153
  }, async ({ account, spreadsheetId, range, values, valueInputOption }) => {
150
154
  try {
151
- const auth = await getClient(account);
155
+ const auth = await getClientFn(account);
152
156
  const sheets = sheetsClient({ version: 'v4', auth });
153
157
  const res = await sheets.spreadsheets.values.append({
154
158
  spreadsheetId,
@@ -174,12 +178,12 @@ export function registerSheetsTools(server) {
174
178
  description: 'Clear values from a range (keeps formatting intact)',
175
179
  inputSchema: {
176
180
  account: accountEnum.describe('Google account alias'),
177
- spreadsheetId: z.string().describe('Spreadsheet ID'),
181
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
178
182
  range: z.string().describe('A1 notation range to clear, e.g. "Sheet1!A1:D10"'),
179
183
  },
180
184
  }, async ({ account, spreadsheetId, range }) => {
181
185
  try {
182
- const auth = await getClient(account);
186
+ const auth = await getClientFn(account);
183
187
  const sheets = sheetsClient({ version: 'v4', auth });
184
188
  const res = await sheets.spreadsheets.values.clear({
185
189
  spreadsheetId,
@@ -200,7 +204,7 @@ export function registerSheetsTools(server) {
200
204
  description: 'Read multiple ranges from a spreadsheet in one request',
201
205
  inputSchema: {
202
206
  account: accountEnum.describe('Google account alias'),
203
- spreadsheetId: z.string().describe('Spreadsheet ID'),
207
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
204
208
  ranges: coerceArray(z.string()).describe('Array of A1 notation ranges'),
205
209
  valueRenderOption: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA'])
206
210
  .default('FORMATTED_VALUE').optional()
@@ -208,7 +212,7 @@ export function registerSheetsTools(server) {
208
212
  },
209
213
  }, async ({ account, spreadsheetId, ranges, valueRenderOption }) => {
210
214
  try {
211
- const auth = await getClient(account);
215
+ const auth = await getClientFn(account);
212
216
  const sheets = sheetsClient({ version: 'v4', auth });
213
217
  const res = await sheets.spreadsheets.values.batchGet({
214
218
  spreadsheetId,
@@ -231,7 +235,7 @@ export function registerSheetsTools(server) {
231
235
  description: 'Write to multiple ranges in a spreadsheet in one request',
232
236
  inputSchema: {
233
237
  account: accountEnum.describe('Google account alias'),
234
- spreadsheetId: z.string().describe('Spreadsheet ID'),
238
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
235
239
  data: coerceJson(z.array(z.object({
236
240
  range: z.string().describe('A1 notation range'),
237
241
  values: coerceJson(z.array(z.array(z.any()))).describe('2D array of values'),
@@ -241,7 +245,7 @@ export function registerSheetsTools(server) {
241
245
  },
242
246
  }, async ({ account, spreadsheetId, data, valueInputOption }) => {
243
247
  try {
244
- const auth = await getClient(account);
248
+ const auth = await getClientFn(account);
245
249
  const sheets = sheetsClient({ version: 'v4', auth });
246
250
  const res = await sheets.spreadsheets.values.batchUpdate({
247
251
  spreadsheetId,
@@ -268,7 +272,7 @@ export function registerSheetsTools(server) {
268
272
  description: 'Add a new tab/sheet to an existing spreadsheet',
269
273
  inputSchema: {
270
274
  account: accountEnum.describe('Google account alias'),
271
- spreadsheetId: z.string().describe('Spreadsheet ID'),
275
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
272
276
  title: z.string().describe('Name for the new sheet/tab'),
273
277
  rowCount: z.number().min(1).default(1000).optional()
274
278
  .describe('Number of rows (default: 1000)'),
@@ -277,7 +281,7 @@ export function registerSheetsTools(server) {
277
281
  },
278
282
  }, async ({ account, spreadsheetId, title, rowCount, columnCount }) => {
279
283
  try {
280
- const auth = await getClient(account);
284
+ const auth = await getClientFn(account);
281
285
  const sheets = sheetsClient({ version: 'v4', auth });
282
286
  const res = await sheets.spreadsheets.batchUpdate({
283
287
  spreadsheetId,
@@ -313,12 +317,12 @@ export function registerSheetsTools(server) {
313
317
  description: 'Delete a tab/sheet from a spreadsheet by sheetId',
314
318
  inputSchema: {
315
319
  account: accountEnum.describe('Google account alias'),
316
- spreadsheetId: z.string().describe('Spreadsheet ID'),
320
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
317
321
  sheetId: z.number().describe('Sheet ID (integer, from sheets_get)'),
318
322
  },
319
323
  }, async ({ account, spreadsheetId, sheetId }) => {
320
324
  try {
321
- const auth = await getClient(account);
325
+ const auth = await getClientFn(account);
322
326
  const sheets = sheetsClient({ version: 'v4', auth });
323
327
  await sheets.spreadsheets.batchUpdate({
324
328
  spreadsheetId,
@@ -336,14 +340,14 @@ export function registerSheetsTools(server) {
336
340
  description: 'Duplicate a tab within the same spreadsheet',
337
341
  inputSchema: {
338
342
  account: accountEnum.describe('Google account alias'),
339
- spreadsheetId: z.string().describe('Spreadsheet ID'),
343
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
340
344
  sourceSheetId: z.number().describe('Source sheet ID'),
341
345
  newSheetName: z.string().optional().describe('Name for the duplicate (default: "Copy of <source>")'),
342
346
  insertSheetIndex: z.number().optional().describe('Where to insert the duplicate (0-based)'),
343
347
  },
344
348
  }, async ({ account, spreadsheetId, sourceSheetId, newSheetName, insertSheetIndex }) => {
345
349
  try {
346
- const auth = await getClient(account);
350
+ const auth = await getClientFn(account);
347
351
  const sheets = sheetsClient({ version: 'v4', auth });
348
352
  const res = await sheets.spreadsheets.batchUpdate({
349
353
  spreadsheetId,
@@ -370,7 +374,7 @@ export function registerSheetsTools(server) {
370
374
  description: 'Rename a tab, change tab color, freeze rows/columns, hide/show, or change grid dimensions',
371
375
  inputSchema: {
372
376
  account: accountEnum.describe('Google account alias'),
373
- spreadsheetId: z.string().describe('Spreadsheet ID'),
377
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
374
378
  sheetId: z.number().describe('Sheet ID'),
375
379
  title: z.string().optional().describe('New tab title'),
376
380
  index: z.number().optional().describe('New position among tabs'),
@@ -383,7 +387,7 @@ export function registerSheetsTools(server) {
383
387
  },
384
388
  }, async ({ account, spreadsheetId, sheetId, title, index, hidden, tabColor, frozenRowCount, frozenColumnCount, rowCount, columnCount }) => {
385
389
  try {
386
- const auth = await getClient(account);
390
+ const auth = await getClientFn(account);
387
391
  const sheets = sheetsClient({ version: 'v4', auth });
388
392
  const properties = { sheetId };
389
393
  const fields = [];
@@ -427,10 +431,7 @@ export function registerSheetsTools(server) {
427
431
  fields.push(`gridProperties.${f}`);
428
432
  }
429
433
  if (fields.length === 0) {
430
- return {
431
- content: [{ type: 'text', text: JSON.stringify({ error: 'No properties supplied' }, null, 2) }],
432
- isError: true,
433
- };
434
+ return invalidParams(account, 'No properties to update: every optional property was omitted, so the request would have been a no-op.', 'Pass at least one of: title, index, hidden, tabColor, frozenRowCount, frozenColumnCount, rowCount, columnCount.');
434
435
  }
435
436
  await sheets.spreadsheets.batchUpdate({
436
437
  spreadsheetId,
@@ -456,7 +457,7 @@ export function registerSheetsTools(server) {
456
457
  description: 'Apply uniform formatting (colors, fonts, alignment, number format) to every cell in a range. Uses RepeatCell with a computed fields mask. For borders use sheets_update_borders.',
457
458
  inputSchema: {
458
459
  account: accountEnum.describe('Google account alias'),
459
- spreadsheetId: z.string().describe('Spreadsheet ID'),
460
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
460
461
  range: gridRangeSchema.describe('Target range (GridRange, half-open indexes)'),
461
462
  backgroundColor: rgbColorSchema.optional().describe('Cell background (RGB 0..1)'),
462
463
  textFormat: z.object({
@@ -478,14 +479,11 @@ export function registerSheetsTools(server) {
478
479
  },
479
480
  }, async ({ account, spreadsheetId, range, ...format }) => {
480
481
  try {
481
- const auth = await getClient(account);
482
+ const auth = await getClientFn(account);
482
483
  const sheets = sheetsClient({ version: 'v4', auth });
483
484
  const built = buildCellFormat(format);
484
485
  if (built.fields.length === 0) {
485
- return {
486
- content: [{ type: 'text', text: JSON.stringify({ error: 'No format properties supplied' }, null, 2) }],
487
- isError: true,
488
- };
486
+ return invalidParams(account, 'No formatting to apply: every optional format property was omitted.', 'Pass at least one of: backgroundColor, textFormat, horizontalAlignment, verticalAlignment, wrapStrategy, numberFormat.');
489
487
  }
490
488
  await sheets.spreadsheets.batchUpdate({
491
489
  spreadsheetId,
@@ -511,7 +509,7 @@ export function registerSheetsTools(server) {
511
509
  description: 'Set borders on a range. Each border specifies style and optional color.',
512
510
  inputSchema: {
513
511
  account: accountEnum.describe('Google account alias'),
514
- spreadsheetId: z.string().describe('Spreadsheet ID'),
512
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
515
513
  range: gridRangeSchema,
516
514
  top: borderSchema.optional(),
517
515
  bottom: borderSchema.optional(),
@@ -522,7 +520,7 @@ export function registerSheetsTools(server) {
522
520
  },
523
521
  }, async ({ account, spreadsheetId, range, top, bottom, left, right, innerHorizontal, innerVertical }) => {
524
522
  try {
525
- const auth = await getClient(account);
523
+ const auth = await getClientFn(account);
526
524
  const sheets = sheetsClient({ version: 'v4', auth });
527
525
  const borders = { range };
528
526
  if (top)
@@ -538,10 +536,7 @@ export function registerSheetsTools(server) {
538
536
  if (innerVertical)
539
537
  borders.innerVertical = toBorder(innerVertical);
540
538
  if (Object.keys(borders).length === 1) {
541
- return {
542
- content: [{ type: 'text', text: JSON.stringify({ error: 'At least one border edge must be supplied' }, null, 2) }],
543
- isError: true,
544
- };
539
+ return invalidParams(account, 'No border edge was supplied, so there is nothing to draw.', 'Pass at least one of: top, bottom, left, right, innerHorizontal, innerVertical.');
545
540
  }
546
541
  await sheets.spreadsheets.batchUpdate({
547
542
  spreadsheetId,
@@ -559,13 +554,13 @@ export function registerSheetsTools(server) {
559
554
  description: 'Merge a range of cells. MERGE_ALL collapses the range to one cell; MERGE_COLUMNS merges each column; MERGE_ROWS merges each row.',
560
555
  inputSchema: {
561
556
  account: accountEnum.describe('Google account alias'),
562
- spreadsheetId: z.string().describe('Spreadsheet ID'),
557
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
563
558
  range: gridRangeSchema,
564
559
  mergeType: z.enum(['MERGE_ALL', 'MERGE_COLUMNS', 'MERGE_ROWS']).default('MERGE_ALL').optional(),
565
560
  },
566
561
  }, async ({ account, spreadsheetId, range, mergeType }) => {
567
562
  try {
568
- const auth = await getClient(account);
563
+ const auth = await getClientFn(account);
569
564
  const sheets = sheetsClient({ version: 'v4', auth });
570
565
  await sheets.spreadsheets.batchUpdate({
571
566
  spreadsheetId,
@@ -585,12 +580,12 @@ export function registerSheetsTools(server) {
585
580
  description: 'Unmerge any merged cells overlapping the given range',
586
581
  inputSchema: {
587
582
  account: accountEnum.describe('Google account alias'),
588
- spreadsheetId: z.string().describe('Spreadsheet ID'),
583
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
589
584
  range: gridRangeSchema,
590
585
  },
591
586
  }, async ({ account, spreadsheetId, range }) => {
592
587
  try {
593
- const auth = await getClient(account);
588
+ const auth = await getClientFn(account);
594
589
  const sheets = sheetsClient({ version: 'v4', auth });
595
590
  await sheets.spreadsheets.batchUpdate({
596
591
  spreadsheetId,
@@ -609,7 +604,7 @@ export function registerSheetsTools(server) {
609
604
  description: 'Add a conditional format rule. Specify either booleanRule (single trigger condition + format) or gradientRule (min/mid/max color stops).',
610
605
  inputSchema: {
611
606
  account: accountEnum.describe('Google account alias'),
612
- spreadsheetId: z.string().describe('Spreadsheet ID'),
607
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
613
608
  ranges: coerceJson(z.array(gridRangeSchema)).describe('Ranges the rule applies to'),
614
609
  index: z.number().min(0).optional().describe('Where in the rule order to insert (0 = highest priority)'),
615
610
  booleanRule: z.object({
@@ -635,12 +630,9 @@ export function registerSheetsTools(server) {
635
630
  }, async ({ account, spreadsheetId, ranges, index, booleanRule, gradientRule }) => {
636
631
  try {
637
632
  if (!booleanRule && !gradientRule) {
638
- return {
639
- content: [{ type: 'text', text: JSON.stringify({ error: 'Either booleanRule or gradientRule must be supplied' }, null, 2) }],
640
- isError: true,
641
- };
633
+ return invalidParams(account, 'A conditional format rule needs a rule body: neither booleanRule nor gradientRule was supplied.', 'Pass booleanRule for a condition-based rule, or gradientRule for a color scale.');
642
634
  }
643
- const auth = await getClient(account);
635
+ const auth = await getClientFn(account);
644
636
  const sheets = sheetsClient({ version: 'v4', auth });
645
637
  const rule = { ranges };
646
638
  if (booleanRule) {
@@ -698,13 +690,13 @@ export function registerSheetsTools(server) {
698
690
  description: 'Sort a range by one or more columns',
699
691
  inputSchema: {
700
692
  account: accountEnum.describe('Google account alias'),
701
- spreadsheetId: z.string().describe('Spreadsheet ID'),
693
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
702
694
  range: gridRangeSchema,
703
695
  sortSpecs: coerceJson(z.array(sortSpecSchema)).describe('One spec per sort column (in priority order)'),
704
696
  },
705
697
  }, async ({ account, spreadsheetId, range, sortSpecs }) => {
706
698
  try {
707
- const auth = await getClient(account);
699
+ const auth = await getClientFn(account);
708
700
  const sheets = sheetsClient({ version: 'v4', auth });
709
701
  await sheets.spreadsheets.batchUpdate({
710
702
  spreadsheetId,
@@ -724,7 +716,7 @@ export function registerSheetsTools(server) {
724
716
  description: 'Apply a basic filter to a range. Optionally supply sortSpecs to set the default sort, and filterSpecs to hide rows based on per-column criteria.',
725
717
  inputSchema: {
726
718
  account: accountEnum.describe('Google account alias'),
727
- spreadsheetId: z.string().describe('Spreadsheet ID'),
719
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
728
720
  range: gridRangeSchema,
729
721
  sortSpecs: coerceJson(z.array(sortSpecSchema)).optional(),
730
722
  filterSpecs: coerceJson(z.array(z.object({
@@ -736,7 +728,7 @@ export function registerSheetsTools(server) {
736
728
  },
737
729
  }, async ({ account, spreadsheetId, range, sortSpecs, filterSpecs }) => {
738
730
  try {
739
- const auth = await getClient(account);
731
+ const auth = await getClientFn(account);
740
732
  const sheets = sheetsClient({ version: 'v4', auth });
741
733
  const filter = { range };
742
734
  if (sortSpecs)
@@ -773,12 +765,12 @@ export function registerSheetsTools(server) {
773
765
  description: 'Remove the basic filter from a sheet',
774
766
  inputSchema: {
775
767
  account: accountEnum.describe('Google account alias'),
776
- spreadsheetId: z.string().describe('Spreadsheet ID'),
768
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
777
769
  sheetId: z.number().describe('Sheet ID'),
778
770
  },
779
771
  }, async ({ account, spreadsheetId, sheetId }) => {
780
772
  try {
781
- const auth = await getClient(account);
773
+ const auth = await getClientFn(account);
782
774
  const sheets = sheetsClient({ version: 'v4', auth });
783
775
  await sheets.spreadsheets.batchUpdate({
784
776
  spreadsheetId,
@@ -798,7 +790,7 @@ export function registerSheetsTools(server) {
798
790
  description: 'Find and replace text across a range, a sheet, or all sheets. Supports case sensitivity, full-cell match, regex, and formula scope.',
799
791
  inputSchema: {
800
792
  account: accountEnum.describe('Google account alias'),
801
- spreadsheetId: z.string().describe('Spreadsheet ID'),
793
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
802
794
  find: z.string().describe('Text to find'),
803
795
  replacement: z.string().describe('Replacement text'),
804
796
  scope: z.enum(['allSheets', 'sheet', 'range']).describe('Search scope'),
@@ -811,7 +803,7 @@ export function registerSheetsTools(server) {
811
803
  },
812
804
  }, async ({ account, spreadsheetId, find, replacement, scope, sheetId, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }) => {
813
805
  try {
814
- const auth = await getClient(account);
806
+ const auth = await getClientFn(account);
815
807
  const sheets = sheetsClient({ version: 'v4', auth });
816
808
  const findReplace = {
817
809
  find,
@@ -825,13 +817,13 @@ export function registerSheetsTools(server) {
825
817
  findReplace.allSheets = true;
826
818
  else if (scope === 'sheet') {
827
819
  if (sheetId === undefined) {
828
- return { content: [{ type: 'text', text: JSON.stringify({ error: 'sheetId required when scope=sheet' }) }], isError: true };
820
+ return invalidParams(account, 'scope is "sheet" but sheetId was not supplied, so no tab is addressed.', 'Pass sheetId, or use scope="allSheets" to search the whole spreadsheet.');
829
821
  }
830
822
  findReplace.sheetId = sheetId;
831
823
  }
832
824
  else {
833
825
  if (!range) {
834
- return { content: [{ type: 'text', text: JSON.stringify({ error: 'range required when scope=range' }) }], isError: true };
826
+ return invalidParams(account, 'scope is "range" but range was not supplied, so no range is addressed.', 'Pass range as a GridRange, or use scope="allSheets" to search the whole spreadsheet.');
835
827
  }
836
828
  findReplace.range = range;
837
829
  }
@@ -859,7 +851,7 @@ export function registerSheetsTools(server) {
859
851
  description: 'Auto-resize rows or columns to fit content',
860
852
  inputSchema: {
861
853
  account: accountEnum.describe('Google account alias'),
862
- spreadsheetId: z.string().describe('Spreadsheet ID'),
854
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
863
855
  sheetId: z.number().describe('Sheet ID'),
864
856
  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Which dimension to resize'),
865
857
  startIndex: z.number().min(0).optional(),
@@ -867,7 +859,7 @@ export function registerSheetsTools(server) {
867
859
  },
868
860
  }, async ({ account, spreadsheetId, sheetId, dimension, startIndex, endIndex }) => {
869
861
  try {
870
- const auth = await getClient(account);
862
+ const auth = await getClientFn(account);
871
863
  const sheets = sheetsClient({ version: 'v4', auth });
872
864
  const dimensions = { sheetId, dimension };
873
865
  if (startIndex !== undefined)
@@ -890,7 +882,7 @@ export function registerSheetsTools(server) {
890
882
  description: 'Insert rows or columns at a position. inheritFromBefore=true copies properties from the row/column before the insertion point.',
891
883
  inputSchema: {
892
884
  account: accountEnum.describe('Google account alias'),
893
- spreadsheetId: z.string().describe('Spreadsheet ID'),
885
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
894
886
  sheetId: z.number().describe('Sheet ID'),
895
887
  dimension: z.enum(['ROWS', 'COLUMNS']),
896
888
  startIndex: z.number().min(0).describe('0-based, inclusive'),
@@ -899,7 +891,7 @@ export function registerSheetsTools(server) {
899
891
  },
900
892
  }, async ({ account, spreadsheetId, sheetId, dimension, startIndex, endIndex, inheritFromBefore }) => {
901
893
  try {
902
- const auth = await getClient(account);
894
+ const auth = await getClientFn(account);
903
895
  const sheets = sheetsClient({ version: 'v4', auth });
904
896
  await sheets.spreadsheets.batchUpdate({
905
897
  spreadsheetId,
@@ -924,7 +916,7 @@ export function registerSheetsTools(server) {
924
916
  description: 'Delete rows or columns from a sheet',
925
917
  inputSchema: {
926
918
  account: accountEnum.describe('Google account alias'),
927
- spreadsheetId: z.string().describe('Spreadsheet ID'),
919
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
928
920
  sheetId: z.number().describe('Sheet ID'),
929
921
  dimension: z.enum(['ROWS', 'COLUMNS']),
930
922
  startIndex: z.number().min(0),
@@ -932,7 +924,7 @@ export function registerSheetsTools(server) {
932
924
  },
933
925
  }, async ({ account, spreadsheetId, sheetId, dimension, startIndex, endIndex }) => {
934
926
  try {
935
- const auth = await getClient(account);
927
+ const auth = await getClientFn(account);
936
928
  const sheets = sheetsClient({ version: 'v4', auth });
937
929
  await sheets.spreadsheets.batchUpdate({
938
930
  spreadsheetId,
@@ -957,7 +949,7 @@ export function registerSheetsTools(server) {
957
949
  description: 'Apply a data validation rule (dropdown, checkbox, numeric range, etc.) to a range. Pass conditionType=null to clear validation.',
958
950
  inputSchema: {
959
951
  account: accountEnum.describe('Google account alias'),
960
- spreadsheetId: z.string().describe('Spreadsheet ID'),
952
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
961
953
  range: gridRangeSchema,
962
954
  conditionType: z.string().describe(BOOLEAN_CONDITION_TYPE_DESC),
963
955
  conditionValues: coerceArray(z.string()).optional().describe('Values per condition type (list items for ONE_OF_LIST, range A1 for ONE_OF_RANGE, etc.)'),
@@ -967,7 +959,7 @@ export function registerSheetsTools(server) {
967
959
  },
968
960
  }, async ({ account, spreadsheetId, range, conditionType, conditionValues, inputMessage, strict, showCustomUi }) => {
969
961
  try {
970
- const auth = await getClient(account);
962
+ const auth = await getClientFn(account);
971
963
  const sheets = sheetsClient({ version: 'v4', auth });
972
964
  const rule = {
973
965
  condition: {
@@ -999,13 +991,13 @@ export function registerSheetsTools(server) {
999
991
  description: 'Define a named range so formulas can reference it by name',
1000
992
  inputSchema: {
1001
993
  account: accountEnum.describe('Google account alias'),
1002
- spreadsheetId: z.string().describe('Spreadsheet ID'),
994
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
1003
995
  name: z.string().describe('Named range identifier (no spaces)'),
1004
996
  range: gridRangeSchema,
1005
997
  },
1006
998
  }, async ({ account, spreadsheetId, name, range }) => {
1007
999
  try {
1008
- const auth = await getClient(account);
1000
+ const auth = await getClientFn(account);
1009
1001
  const sheets = sheetsClient({ version: 'v4', auth });
1010
1002
  const res = await sheets.spreadsheets.batchUpdate({
1011
1003
  spreadsheetId,
@@ -1026,12 +1018,12 @@ export function registerSheetsTools(server) {
1026
1018
  description: 'Delete a named range by its ID',
1027
1019
  inputSchema: {
1028
1020
  account: accountEnum.describe('Google account alias'),
1029
- spreadsheetId: z.string().describe('Spreadsheet ID'),
1030
- namedRangeId: z.string().describe('Named range ID (from sheets_get response)'),
1021
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
1022
+ namedRangeId: z.string().min(1).describe('Named range ID (from sheets_get response)'),
1031
1023
  },
1032
1024
  }, async ({ account, spreadsheetId, namedRangeId }) => {
1033
1025
  try {
1034
- const auth = await getClient(account);
1026
+ const auth = await getClientFn(account);
1035
1027
  const sheets = sheetsClient({ version: 'v4', auth });
1036
1028
  await sheets.spreadsheets.batchUpdate({
1037
1029
  spreadsheetId,
@@ -1050,12 +1042,12 @@ export function registerSheetsTools(server) {
1050
1042
  description: 'Clear values from multiple ranges in one request',
1051
1043
  inputSchema: {
1052
1044
  account: accountEnum.describe('Google account alias'),
1053
- spreadsheetId: z.string().describe('Spreadsheet ID'),
1045
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
1054
1046
  ranges: coerceArray(z.string()).describe('Array of A1 notation ranges'),
1055
1047
  },
1056
1048
  }, async ({ account, spreadsheetId, ranges }) => {
1057
1049
  try {
1058
- const auth = await getClient(account);
1050
+ const auth = await getClientFn(account);
1059
1051
  const sheets = sheetsClient({ version: 'v4', auth });
1060
1052
  const res = await sheets.spreadsheets.values.batchClear({
1061
1053
  spreadsheetId,
@@ -1077,7 +1069,7 @@ export function registerSheetsTools(server) {
1077
1069
  description: 'Generic spreadsheets.batchUpdate pass-through. Accepts the full Request union (~70 types). Use this for advanced operations not covered by a dedicated tool. See https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request',
1078
1070
  inputSchema: {
1079
1071
  account: accountEnum.describe('Google account alias'),
1080
- spreadsheetId: z.string().describe('Spreadsheet ID'),
1072
+ spreadsheetId: z.string().min(1).describe('Spreadsheet ID'),
1081
1073
  requests: coerceJson(z.array(z.record(z.string(), z.any()))).describe('Array of Request objects. Each object has exactly one key (the request type) like {repeatCell: {...}}, {addChart: {...}}, {updateBanding: {...}}, etc.'),
1082
1074
  includeSpreadsheetInResponse: coerceBoolean.optional(),
1083
1075
  responseRanges: coerceArray(z.string()).optional(),
@@ -1085,7 +1077,7 @@ export function registerSheetsTools(server) {
1085
1077
  },
1086
1078
  }, async ({ account, spreadsheetId, requests, includeSpreadsheetInResponse, responseRanges, responseIncludeGridData }) => {
1087
1079
  try {
1088
- const auth = await getClient(account);
1080
+ const auth = await getClientFn(account);
1089
1081
  const sheets = sheetsClient({ version: 'v4', auth });
1090
1082
  const res = await sheets.spreadsheets.batchUpdate({
1091
1083
  spreadsheetId,
@@ -1,4 +1,13 @@
1
1
  import type { ToolRegistry } from '../registry.js';
2
- export declare function registerSlidesTools(server: ToolRegistry): void;
2
+ import type { Account } from '../accounts.js';
3
+ import { type CuratedToolDeps } from '../client.js';
4
+ export declare function registerSlidesTools(server: ToolRegistry, deps?: CuratedToolDeps): void;
3
5
  export declare function extractPageText(elements: Array<Record<string, any>> | undefined): string;
4
6
  export declare function summarizePresentation(p: Record<string, any>): Record<string, unknown>;
7
+ export declare function handleSlidesError(error: any, account: Account): {
8
+ content: {
9
+ type: "text";
10
+ text: string;
11
+ }[];
12
+ isError: true;
13
+ };