@mcp-z/mcp-sheets 2.3.2 → 2.4.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/README.md +32 -27
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/lib/create-store.js.map +1 -1
- package/dist/cjs/lib/google-auth.js.map +1 -1
- package/dist/cjs/mcp/index.js.map +1 -1
- package/dist/cjs/mcp/prompts/a1-notation.js.map +1 -1
- package/dist/cjs/mcp/prompts/index.js.map +1 -1
- package/dist/cjs/mcp/resources/index.js.map +1 -1
- package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-metadata-get.d.cts +95 -0
- package/dist/cjs/mcp/tools/cells-metadata-get.d.ts +95 -0
- package/dist/cjs/mcp/tools/cells-metadata-get.js +331 -0
- package/dist/cjs/mcp/tools/cells-metadata-get.js.map +1 -0
- package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
- package/dist/cjs/mcp/tools/csv-get-columns.js +44 -124
- package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
- package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
- package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
- package/dist/cjs/mcp/tools/index.d.cts +2 -0
- package/dist/cjs/mcp/tools/index.d.ts +2 -0
- package/dist/cjs/mcp/tools/index.js +8 -0
- package/dist/cjs/mcp/tools/index.js.map +1 -1
- package/dist/cjs/mcp/tools/lib/dimension-operations.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
- package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
- package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
- package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
- package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
- package/dist/cjs/mcp/tools/spreadsheet-metadata-get.d.cts +59 -0
- package/dist/cjs/mcp/tools/spreadsheet-metadata-get.d.ts +59 -0
- package/dist/cjs/mcp/tools/spreadsheet-metadata-get.js +259 -0
- package/dist/cjs/mcp/tools/spreadsheet-metadata-get.js.map +1 -0
- package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
- package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-markdown-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
- package/dist/cjs/mcp/tools/values-search.js.map +1 -1
- package/dist/cjs/schemas/index.js.map +1 -1
- package/dist/cjs/setup/config.js.map +1 -1
- package/dist/cjs/setup/http.d.cts +1 -1
- package/dist/cjs/setup/http.d.ts +1 -1
- package/dist/cjs/setup/http.js.map +1 -1
- package/dist/cjs/setup/index.js.map +1 -1
- package/dist/cjs/setup/oauth-google.js.map +1 -1
- package/dist/cjs/setup/runtime.js.map +1 -1
- package/dist/cjs/setup/stdio.js.map +1 -1
- package/dist/cjs/setup/version-help.js.map +1 -1
- package/dist/cjs/spreadsheet/column-utilities.js.map +1 -1
- package/dist/cjs/spreadsheet/csv-streaming.js.map +1 -1
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/deduplication-utils.js.map +1 -1
- package/dist/cjs/spreadsheet/markdown-runs.js.map +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +2 -1
- package/dist/cjs/spreadsheet/range-operations.d.ts +2 -1
- package/dist/cjs/spreadsheet/range-operations.js +12 -0
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/spreadsheet-management.js.map +1 -1
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/lib/create-store.js.map +1 -1
- package/dist/esm/lib/google-auth.js.map +1 -1
- package/dist/esm/mcp/index.js.map +1 -1
- package/dist/esm/mcp/prompts/a1-notation.js.map +1 -1
- package/dist/esm/mcp/prompts/index.js.map +1 -1
- package/dist/esm/mcp/resources/index.js.map +1 -1
- package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
- package/dist/esm/mcp/tools/cells-format.js.map +1 -1
- package/dist/esm/mcp/tools/cells-metadata-get.d.ts +95 -0
- package/dist/esm/mcp/tools/cells-metadata-get.js +155 -0
- package/dist/esm/mcp/tools/cells-metadata-get.js.map +1 -0
- package/dist/esm/mcp/tools/chart-create.js.map +1 -1
- package/dist/esm/mcp/tools/columns-get.js.map +1 -1
- package/dist/esm/mcp/tools/columns-update.js.map +1 -1
- package/dist/esm/mcp/tools/csv-get-columns.js +18 -11
- package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
- package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
- package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
- package/dist/esm/mcp/tools/index.d.ts +2 -0
- package/dist/esm/mcp/tools/index.js +2 -0
- package/dist/esm/mcp/tools/index.js.map +1 -1
- package/dist/esm/mcp/tools/lib/dimension-operations.js.map +1 -1
- package/dist/esm/mcp/tools/rows-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-get.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
- package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
- package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
- package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
- package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
- package/dist/esm/mcp/tools/spreadsheet-metadata-get.d.ts +59 -0
- package/dist/esm/mcp/tools/spreadsheet-metadata-get.js +89 -0
- package/dist/esm/mcp/tools/spreadsheet-metadata-get.js.map +1 -0
- package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
- package/dist/esm/mcp/tools/validation-set.js.map +1 -1
- package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-clear.js.map +1 -1
- package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-markdown-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-replace.js.map +1 -1
- package/dist/esm/mcp/tools/values-search.js.map +1 -1
- package/dist/esm/schemas/index.js.map +1 -1
- package/dist/esm/setup/config.js.map +1 -1
- package/dist/esm/setup/http.d.ts +1 -1
- package/dist/esm/setup/http.js.map +1 -1
- package/dist/esm/setup/index.js.map +1 -1
- package/dist/esm/setup/oauth-google.js.map +1 -1
- package/dist/esm/setup/runtime.js.map +1 -1
- package/dist/esm/setup/stdio.js.map +1 -1
- package/dist/esm/setup/version-help.js.map +1 -1
- package/dist/esm/spreadsheet/column-utilities.js.map +1 -1
- package/dist/esm/spreadsheet/csv-streaming.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/deduplication-utils.js.map +1 -1
- package/dist/esm/spreadsheet/markdown-runs.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +2 -1
- package/dist/esm/spreadsheet/range-operations.js +11 -2
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/spreadsheet/spreadsheet-management.js.map +1 -1
- package/dist/esm/types.js.map +1 -1
- package/package.json +10 -9
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { EnrichedExtra } from '@mcp-z/oauth-google';
|
|
2
|
+
import type { CallToolResult } from '@mcp-z/server';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
declare const inputSchema: z.ZodObject<{
|
|
5
|
+
id: z.ZodString;
|
|
6
|
+
gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
|
|
7
|
+
ranges: z.ZodArray<z.ZodString>;
|
|
8
|
+
}, z.core.$strict>;
|
|
9
|
+
declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
10
|
+
type: z.ZodLiteral<"success">;
|
|
11
|
+
id: z.ZodString;
|
|
12
|
+
gid: z.ZodString;
|
|
13
|
+
metadata: z.ZodObject<{
|
|
14
|
+
spreadsheetId: z.ZodString;
|
|
15
|
+
sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
16
|
+
properties: z.ZodOptional<z.ZodObject<{
|
|
17
|
+
sheetId: z.ZodOptional<z.ZodNumber>;
|
|
18
|
+
title: z.ZodOptional<z.ZodString>;
|
|
19
|
+
}, z.core.$loose>>;
|
|
20
|
+
data: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
21
|
+
startRow: z.ZodOptional<z.ZodNumber>;
|
|
22
|
+
startColumn: z.ZodOptional<z.ZodNumber>;
|
|
23
|
+
rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
24
|
+
values: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
25
|
+
note: z.ZodOptional<z.ZodString>;
|
|
26
|
+
dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
27
|
+
pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
28
|
+
dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
29
|
+
}, z.core.$loose>>>;
|
|
30
|
+
}, z.core.$loose>>>;
|
|
31
|
+
}, z.core.$loose>>>;
|
|
32
|
+
}, z.core.$loose>>>;
|
|
33
|
+
}, z.core.$loose>;
|
|
34
|
+
fieldMask: z.ZodString;
|
|
35
|
+
requestedRanges: z.ZodArray<z.ZodString>;
|
|
36
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
37
|
+
type: z.ZodLiteral<"auth_required">;
|
|
38
|
+
provider: z.ZodString;
|
|
39
|
+
message: z.ZodString;
|
|
40
|
+
url: z.ZodOptional<z.ZodString>;
|
|
41
|
+
}, z.core.$strip>], "type">;
|
|
42
|
+
export type Input = z.infer<typeof inputSchema>;
|
|
43
|
+
export type Output = z.infer<typeof outputSchema>;
|
|
44
|
+
declare function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult>;
|
|
45
|
+
export default function createTool(): {
|
|
46
|
+
name: string;
|
|
47
|
+
config: {
|
|
48
|
+
readonly description: "Read notes, data validation rules, pivot table and data-source table definitions in required finite ranges on one sheet. Preserves sparse row/column offsets. Excludes cell values, formulas and direct formatting. DATA_SOURCE and OBJECT sheets are unsupported.";
|
|
49
|
+
readonly annotations: {
|
|
50
|
+
readonly readOnlyHint: true;
|
|
51
|
+
};
|
|
52
|
+
readonly inputSchema: z.ZodObject<{
|
|
53
|
+
id: z.ZodString;
|
|
54
|
+
gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
|
|
55
|
+
ranges: z.ZodArray<z.ZodString>;
|
|
56
|
+
}, z.core.$strict>;
|
|
57
|
+
readonly outputSchema: z.ZodObject<{
|
|
58
|
+
result: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
59
|
+
type: z.ZodLiteral<"success">;
|
|
60
|
+
id: z.ZodString;
|
|
61
|
+
gid: z.ZodString;
|
|
62
|
+
metadata: z.ZodObject<{
|
|
63
|
+
spreadsheetId: z.ZodString;
|
|
64
|
+
sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
65
|
+
properties: z.ZodOptional<z.ZodObject<{
|
|
66
|
+
sheetId: z.ZodOptional<z.ZodNumber>;
|
|
67
|
+
title: z.ZodOptional<z.ZodString>;
|
|
68
|
+
}, z.core.$loose>>;
|
|
69
|
+
data: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
70
|
+
startRow: z.ZodOptional<z.ZodNumber>;
|
|
71
|
+
startColumn: z.ZodOptional<z.ZodNumber>;
|
|
72
|
+
rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
73
|
+
values: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
74
|
+
note: z.ZodOptional<z.ZodString>;
|
|
75
|
+
dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
76
|
+
pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
77
|
+
dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
|
|
78
|
+
}, z.core.$loose>>>;
|
|
79
|
+
}, z.core.$loose>>>;
|
|
80
|
+
}, z.core.$loose>>>;
|
|
81
|
+
}, z.core.$loose>>>;
|
|
82
|
+
}, z.core.$loose>;
|
|
83
|
+
fieldMask: z.ZodString;
|
|
84
|
+
requestedRanges: z.ZodArray<z.ZodString>;
|
|
85
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
86
|
+
type: z.ZodLiteral<"auth_required">;
|
|
87
|
+
provider: z.ZodString;
|
|
88
|
+
message: z.ZodString;
|
|
89
|
+
url: z.ZodOptional<z.ZodString>;
|
|
90
|
+
}, z.core.$strip>], "type">;
|
|
91
|
+
}, z.core.$strip>;
|
|
92
|
+
};
|
|
93
|
+
handler: typeof handler;
|
|
94
|
+
};
|
|
95
|
+
export {};
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { sheets as sheetsApi } from '@googleapis/sheets';
|
|
2
|
+
import { schemas } from '@mcp-z/oauth-google';
|
|
3
|
+
import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
|
|
4
|
+
import { z } from 'zod';
|
|
5
|
+
import { googleAuth } from '../../lib/google-auth.js';
|
|
6
|
+
import { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
|
|
7
|
+
import { calculateFiniteRangeCellCount } from '../../spreadsheet/range-operations.js';
|
|
8
|
+
const { AuthRequiredBranchSchema } = schemas;
|
|
9
|
+
const MAX_RANGES = 50;
|
|
10
|
+
const MAX_CELLS = 250000;
|
|
11
|
+
const FIELD_MASK = 'spreadsheetId,sheets(properties(sheetId,title),data(startRow,startColumn,rowData(values(note,dataValidation,pivotTable,dataSourceTable))))';
|
|
12
|
+
const rangesSchema = z.array(z.string().trim().min(1)).min(1).max(MAX_RANGES).superRefine((ranges, context)=>{
|
|
13
|
+
try {
|
|
14
|
+
const totalCells = ranges.reduce((sum, range)=>sum + calculateFiniteRangeCellCount(range), 0);
|
|
15
|
+
if (totalCells > MAX_CELLS) throw new Error(`Requested ranges exceed the ${MAX_CELLS.toLocaleString('en-US')} aggregate cell limit`);
|
|
16
|
+
} catch (error) {
|
|
17
|
+
context.addIssue({
|
|
18
|
+
code: 'custom',
|
|
19
|
+
message: error instanceof Error ? error.message : String(error)
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
});
|
|
23
|
+
const inputSchema = z.object({
|
|
24
|
+
id: SpreadsheetIdSchema,
|
|
25
|
+
gid: z.union([
|
|
26
|
+
z.string().min(1),
|
|
27
|
+
z.number()
|
|
28
|
+
]).transform(String).describe('Sheet ID (from URL gid={gid})'),
|
|
29
|
+
ranges: rangesSchema.describe(`Required finite sheet-local A1 ranges, such as A1 or B2:D10, for notes, dataValidation, pivotTable and dataSourceTable. Maximum ${MAX_RANGES} ranges and ${MAX_CELLS.toLocaleString('en-US')} aggregate cells, counting overlapping ranges separately.`)
|
|
30
|
+
}).strict();
|
|
31
|
+
const definitionSchema = z.object({}).passthrough();
|
|
32
|
+
const cellSchema = z.object({
|
|
33
|
+
note: z.string().optional(),
|
|
34
|
+
dataValidation: definitionSchema.optional(),
|
|
35
|
+
pivotTable: definitionSchema.optional(),
|
|
36
|
+
dataSourceTable: definitionSchema.optional()
|
|
37
|
+
}).passthrough();
|
|
38
|
+
const metadataSchema = z.object({
|
|
39
|
+
spreadsheetId: z.string(),
|
|
40
|
+
sheets: z.array(z.object({
|
|
41
|
+
properties: z.object({
|
|
42
|
+
sheetId: z.number().int().optional(),
|
|
43
|
+
title: z.string().optional()
|
|
44
|
+
}).passthrough().optional(),
|
|
45
|
+
data: z.array(z.object({
|
|
46
|
+
startRow: z.number().int().nonnegative().optional(),
|
|
47
|
+
startColumn: z.number().int().nonnegative().optional(),
|
|
48
|
+
rowData: z.array(z.object({
|
|
49
|
+
values: z.array(cellSchema).optional()
|
|
50
|
+
}).passthrough()).optional()
|
|
51
|
+
}).passthrough()).optional()
|
|
52
|
+
}).passthrough()).optional()
|
|
53
|
+
}).passthrough();
|
|
54
|
+
const outputSchema = z.discriminatedUnion('type', [
|
|
55
|
+
z.object({
|
|
56
|
+
type: z.literal('success'),
|
|
57
|
+
id: SpreadsheetIdOutput,
|
|
58
|
+
gid: SheetGidOutput,
|
|
59
|
+
metadata: metadataSchema.describe('Selected Google cell metadata with sheet identity and sparse GridData offsets. Omitted startRow/startColumn mean zero; empty rows and cells retain their positions. Values and direct formatting are excluded.'),
|
|
60
|
+
fieldMask: z.string(),
|
|
61
|
+
requestedRanges: z.array(z.string()).describe('Sheet-qualified A1 ranges sent to Google, in request order.')
|
|
62
|
+
}),
|
|
63
|
+
AuthRequiredBranchSchema
|
|
64
|
+
]);
|
|
65
|
+
const config = {
|
|
66
|
+
description: 'Read notes, data validation rules, pivot table and data-source table definitions in required finite ranges on one sheet. Preserves sparse row/column offsets. Excludes cell values, formulas and direct formatting. DATA_SOURCE and OBJECT sheets are unsupported.',
|
|
67
|
+
annotations: {
|
|
68
|
+
readOnlyHint: true
|
|
69
|
+
},
|
|
70
|
+
inputSchema,
|
|
71
|
+
outputSchema: z.object({
|
|
72
|
+
result: outputSchema
|
|
73
|
+
})
|
|
74
|
+
};
|
|
75
|
+
async function handler(input, extra) {
|
|
76
|
+
const parsed = inputSchema.safeParse(input);
|
|
77
|
+
if (!parsed.success) throw new ProtocolError(ProtocolErrorCode.InvalidParams, parsed.error.message);
|
|
78
|
+
const { id, gid, ranges } = parsed.data;
|
|
79
|
+
const logger = extra.logger;
|
|
80
|
+
logger.info('sheets.cells.metadata.get called', {
|
|
81
|
+
id,
|
|
82
|
+
gid,
|
|
83
|
+
rangeCount: ranges.length
|
|
84
|
+
});
|
|
85
|
+
try {
|
|
86
|
+
var _preflight_data_sheets_find, _preflight_data_sheets;
|
|
87
|
+
const sheets = sheetsApi({
|
|
88
|
+
version: 'v4',
|
|
89
|
+
auth: googleAuth(extra.authContext.auth)
|
|
90
|
+
});
|
|
91
|
+
// Resolve the title and type without fetching structures. DATA_SOURCE sheets cannot accept specific ranges.
|
|
92
|
+
const preflight = await sheets.spreadsheets.get({
|
|
93
|
+
spreadsheetId: id,
|
|
94
|
+
fields: 'sheets(properties(sheetId,title,sheetType))'
|
|
95
|
+
});
|
|
96
|
+
const properties = (_preflight_data_sheets = preflight.data.sheets) === null || _preflight_data_sheets === void 0 ? void 0 : (_preflight_data_sheets_find = _preflight_data_sheets.find((sheet)=>{
|
|
97
|
+
var _sheet_properties;
|
|
98
|
+
return String((_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.sheetId) === gid;
|
|
99
|
+
})) === null || _preflight_data_sheets_find === void 0 ? void 0 : _preflight_data_sheets_find.properties;
|
|
100
|
+
if (!properties) throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
|
|
101
|
+
if (properties.sheetType === 'DATA_SOURCE' || properties.sheetType === 'OBJECT') {
|
|
102
|
+
throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Cell metadata ranges are not supported on ${properties.sheetType} sheets: ${gid}`);
|
|
103
|
+
}
|
|
104
|
+
if (properties.title == null) throw new Error(`Sheet title not available for ${gid}`);
|
|
105
|
+
const title = `'${properties.title.replace(/'/g, "''")}'`;
|
|
106
|
+
const requestedRanges = ranges.map((range)=>`${title}!${range}`);
|
|
107
|
+
const response = await sheets.spreadsheets.get({
|
|
108
|
+
spreadsheetId: id,
|
|
109
|
+
fields: FIELD_MASK,
|
|
110
|
+
ranges: requestedRanges
|
|
111
|
+
});
|
|
112
|
+
const result = outputSchema.parse({
|
|
113
|
+
type: 'success',
|
|
114
|
+
id,
|
|
115
|
+
gid,
|
|
116
|
+
metadata: response.data,
|
|
117
|
+
fieldMask: FIELD_MASK,
|
|
118
|
+
requestedRanges
|
|
119
|
+
});
|
|
120
|
+
logger.info('sheets.cells.metadata.get success', {
|
|
121
|
+
id,
|
|
122
|
+
gid,
|
|
123
|
+
rangeCount: ranges.length
|
|
124
|
+
});
|
|
125
|
+
return {
|
|
126
|
+
content: [
|
|
127
|
+
{
|
|
128
|
+
type: 'text',
|
|
129
|
+
text: JSON.stringify(result)
|
|
130
|
+
}
|
|
131
|
+
],
|
|
132
|
+
structuredContent: {
|
|
133
|
+
result
|
|
134
|
+
}
|
|
135
|
+
};
|
|
136
|
+
} catch (error) {
|
|
137
|
+
if (error instanceof ProtocolError) throw error;
|
|
138
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
139
|
+
logger.error('sheets.cells.metadata.get error', {
|
|
140
|
+
id,
|
|
141
|
+
gid,
|
|
142
|
+
error: message
|
|
143
|
+
});
|
|
144
|
+
throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting cell metadata: ${message}`, {
|
|
145
|
+
stack: error instanceof Error ? error.stack : undefined
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
export default function createTool() {
|
|
150
|
+
return {
|
|
151
|
+
name: 'cells-metadata-get',
|
|
152
|
+
config,
|
|
153
|
+
handler
|
|
154
|
+
};
|
|
155
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-metadata-get.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\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, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { calculateFiniteRangeCellCount } from '../../spreadsheet/range-operations.ts';\n\nconst { AuthRequiredBranchSchema } = schemas;\nconst MAX_RANGES = 50;\nconst MAX_CELLS = 250_000;\nconst FIELD_MASK = 'spreadsheetId,sheets(properties(sheetId,title),data(startRow,startColumn,rowData(values(note,dataValidation,pivotTable,dataSourceTable))))';\n\nconst rangesSchema = z\n .array(z.string().trim().min(1))\n .min(1)\n .max(MAX_RANGES)\n .superRefine((ranges, context) => {\n try {\n const totalCells = ranges.reduce((sum, range) => sum + calculateFiniteRangeCellCount(range), 0);\n if (totalCells > MAX_CELLS) throw new Error(`Requested ranges exceed the ${MAX_CELLS.toLocaleString('en-US')} aggregate cell limit`);\n } catch (error) {\n context.addIssue({ code: 'custom', message: error instanceof Error ? error.message : String(error) });\n }\n });\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: z\n .union([z.string().min(1), z.number()])\n .transform(String)\n .describe('Sheet ID (from URL gid={gid})'),\n ranges: rangesSchema.describe(`Required finite sheet-local A1 ranges, such as A1 or B2:D10, for notes, dataValidation, pivotTable and dataSourceTable. Maximum ${MAX_RANGES} ranges and ${MAX_CELLS.toLocaleString('en-US')} aggregate cells, counting overlapping ranges separately.`),\n })\n .strict();\nconst definitionSchema = z.object({}).passthrough();\nconst cellSchema = z\n .object({\n note: z.string().optional(),\n dataValidation: definitionSchema.optional(),\n pivotTable: definitionSchema.optional(),\n dataSourceTable: definitionSchema.optional(),\n })\n .passthrough();\nconst metadataSchema = z\n .object({\n spreadsheetId: z.string(),\n sheets: z\n .array(\n z\n .object({\n properties: z.object({ sheetId: z.number().int().optional(), title: z.string().optional() }).passthrough().optional(),\n data: z\n .array(\n z\n .object({\n startRow: z.number().int().nonnegative().optional(),\n startColumn: z.number().int().nonnegative().optional(),\n rowData: z.array(z.object({ values: z.array(cellSchema).optional() }).passthrough()).optional(),\n })\n .passthrough()\n )\n .optional(),\n })\n .passthrough()\n )\n .optional(),\n })\n .passthrough();\nconst outputSchema = z.discriminatedUnion('type', [\n z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n metadata: metadataSchema.describe('Selected Google cell metadata with sheet identity and sparse GridData offsets. Omitted startRow/startColumn mean zero; empty rows and cells retain their positions. Values and direct formatting are excluded.'),\n fieldMask: z.string(),\n requestedRanges: z.array(z.string()).describe('Sheet-qualified A1 ranges sent to Google, in request order.'),\n }),\n AuthRequiredBranchSchema,\n]);\nconst config = {\n description: 'Read notes, data validation rules, pivot table and data-source table definitions in required finite ranges on one sheet. Preserves sparse row/column offsets. Excludes cell values, formulas and direct formatting. DATA_SOURCE and OBJECT sheets are unsupported.',\n annotations: { readOnlyHint: true },\n inputSchema,\n outputSchema: z.object({ result: outputSchema }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const parsed = inputSchema.safeParse(input);\n if (!parsed.success) throw new ProtocolError(ProtocolErrorCode.InvalidParams, parsed.error.message);\n const { id, gid, ranges } = parsed.data;\n const logger = extra.logger;\n logger.info('sheets.cells.metadata.get called', { id, gid, rangeCount: ranges.length });\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n // Resolve the title and type without fetching structures. DATA_SOURCE sheets cannot accept specific ranges.\n const preflight = await sheets.spreadsheets.get({ spreadsheetId: id, fields: 'sheets(properties(sheetId,title,sheetType))' });\n const properties = preflight.data.sheets?.find((sheet) => String(sheet.properties?.sheetId) === gid)?.properties;\n if (!properties) throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n if (properties.sheetType === 'DATA_SOURCE' || properties.sheetType === 'OBJECT') {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Cell metadata ranges are not supported on ${properties.sheetType} sheets: ${gid}`);\n }\n if (properties.title == null) throw new Error(`Sheet title not available for ${gid}`);\n const title = `'${properties.title.replace(/'/g, \"''\")}'`;\n const requestedRanges = ranges.map((range) => `${title}!${range}`);\n const response = await sheets.spreadsheets.get({ spreadsheetId: id, fields: FIELD_MASK, ranges: requestedRanges });\n const result: Output = outputSchema.parse({ type: 'success', id, gid, metadata: response.data, fieldMask: FIELD_MASK, requestedRanges });\n logger.info('sheets.cells.metadata.get success', { id, gid, rangeCount: ranges.length });\n return {\n content: [{ type: 'text', text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) throw error;\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.cells.metadata.get error', { id, gid, error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting cell metadata: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return { name: 'cells-metadata-get', config, handler } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetIdSchema","calculateFiniteRangeCellCount","AuthRequiredBranchSchema","MAX_RANGES","MAX_CELLS","FIELD_MASK","rangesSchema","array","string","trim","min","max","superRefine","ranges","context","totalCells","reduce","sum","range","Error","toLocaleString","error","addIssue","code","message","String","inputSchema","object","id","gid","union","number","transform","describe","strict","definitionSchema","passthrough","cellSchema","note","optional","dataValidation","pivotTable","dataSourceTable","metadataSchema","spreadsheetId","properties","sheetId","int","title","data","startRow","nonnegative","startColumn","rowData","values","outputSchema","discriminatedUnion","type","literal","metadata","fieldMask","requestedRanges","config","description","annotations","readOnlyHint","result","handler","input","extra","parsed","safeParse","success","InvalidParams","logger","info","rangeCount","length","preflight","version","auth","authContext","spreadsheets","get","fields","find","sheet","sheetType","replace","map","response","parse","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-create.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// Input schema for chart position\nconst ChartPositionSchema = z.object({\n anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n title: z.string().optional().describe('Chart title displayed at top'),\n position: ChartPositionSchema,\n legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\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\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n // Simple A1 notation parser for single cells\n const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n }\n\n const colLetters = match[1];\n const rowNumber = match[2];\n\n // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n let columnIndex = 0;\n for (let i = 0; i < colLetters.length; i++) {\n columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n }\n columnIndex--; // Convert to 0-based\n\n // Convert row number to index (1-based to 0-based)\n const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.chart.create called', {\n id,\n gid,\n chartType,\n dataRange,\n title,\n position,\n legend,\n is3D,\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 chart create', { id, gid, chartType });\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 // Validate 3D only for PIE charts\n // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n if (is3D && chartType !== 'PIE') {\n logger.info('3D mode not supported for this chart type', {\n chartType,\n is3D,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n }\n\n // Parse anchor cell to row/column indices\n let anchorRowIndex: number;\n let anchorColumnIndex: number;\n try {\n const anchorIndices = parseAnchorCell(position.anchorCell);\n anchorRowIndex = anchorIndices.rowIndex;\n anchorColumnIndex = anchorIndices.columnIndex;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse anchor cell', {\n anchorCell: position.anchorCell,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n }\n\n // Parse data range to grid range\n let dataGridRange: sheets_v4.Schema$GridRange;\n try {\n const rangeRef = parseA1Notation(dataRange);\n dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Validate that required properties are defined for chart creation\n if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse data range', {\n dataRange,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n }\n\n // Extract validated properties with defined types\n const dataStartRowIndex = dataGridRange.startRowIndex as number;\n const dataEndRowIndex = dataGridRange.endRowIndex as number;\n const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n // Build chart spec with properly split domain and series ranges\n let chartSpec: sheets_v4.Schema$ChartSpec;\n\n logger.info('Building chart spec', {\n chartType,\n dataGridRange,\n sheetId,\n });\n\n // Map legend position to API format (add _LEGEND suffix)\n const legendPositionMap: Record<string, string> = {\n BOTTOM: 'BOTTOM_LEGEND',\n RIGHT: 'RIGHT_LEGEND',\n TOP: 'TOP_LEGEND',\n LEFT: 'LEFT_LEGEND',\n NONE: 'NO_LEGEND',\n };\n const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n if (chartType === 'PIE') {\n // PIE charts use a separate pieChart property, not basicChart\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n };\n\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n endColumnIndex: dataStartColumnIndex + 2,\n };\n\n logger.info('PIE chart ranges', {\n dataGridRange,\n domainRange,\n seriesRange,\n apiLegendPosition,\n });\n\n chartSpec = {\n pieChart: {\n // Use pieChart for PIE charts\n legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n domain: {\n // Note: domain/series are direct objects, not arrays\n sourceRange: {\n sources: [domainRange],\n },\n },\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n threeDimensional: is3D, // 3D is directly on pieChart\n },\n };\n if (title) {\n chartSpec.title = title;\n }\n } else {\n // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only\n };\n\n // Calculate number of data columns (excluding the first domain column)\n const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n const series = [];\n\n // Create a series for each data column\n for (let i = 0; i < numDataColumns; i++) {\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1 + i,\n endColumnIndex: dataStartColumnIndex + 2 + i,\n };\n\n series.push({\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n });\n }\n\n // If no data columns were found, default to using the entire range as a fallback\n if (series.length === 0) {\n series.push({\n series: {\n sourceRange: {\n sources: [dataGridRange],\n },\n },\n });\n }\n\n const basicChart: sheets_v4.Schema$BasicChartSpec = {\n chartType, // BAR, COLUMN, LINE are valid for basicChart\n headerCount: 1, // First row is headers\n // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n // threeDimensional is only supported for pieChart\n domains: [\n {\n domain: {\n sourceRange: {\n sources: [domainRange],\n },\n },\n },\n ],\n series,\n };\n if (legend !== 'NONE') {\n basicChart.legendPosition = apiLegendPosition;\n }\n\n chartSpec = { basicChart };\n if (title) {\n chartSpec.title = title;\n }\n }\n\n // Build embedded object position\n const embeddedObjectPosition = {\n overlayPosition: {\n anchorCell: {\n sheetId,\n rowIndex: anchorRowIndex,\n columnIndex: anchorColumnIndex,\n },\n offsetXPixels: position.offsetX,\n offsetYPixels: position.offsetY,\n },\n };\n\n const requestBody = {\n requests: [\n {\n addChart: {\n chart: {\n spec: chartSpec,\n position: embeddedObjectPosition,\n },\n },\n },\n ],\n };\n\n logger.info('sheets.chart.create executing addChart request', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n dataRange,\n anchorCell: position.anchorCell,\n requestBody: JSON.stringify(requestBody),\n });\n\n // Execute the addChart request\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody,\n });\n\n // Extract chart ID from response\n const replies = response.data.replies || [];\n if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n logger.error('Chart creation failed - no chart ID returned', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n });\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n }\n\n const chartId = replies[0].addChart.chart.chartId;\n\n logger.info('sheets.chart.create completed successfully', {\n chartId,\n chartType,\n anchorCell: position.anchorCell,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n chartId,\n anchorCell: position.anchorCell,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (e) {\n const error = e as Error & { response?: { data?: unknown; status?: number } };\n const message = error.message || String(e);\n logger.error('Chart create operation failed', {\n id,\n gid,\n chartType,\n dataRange,\n error: message,\n response: error.response?.data,\n status: error.response?.status,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n stack: e instanceof Error ? e.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'chart-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-create.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// Input schema for chart position\nconst ChartPositionSchema = z.object({\n anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n title: z.string().optional().describe('Chart title displayed at top'),\n position: ChartPositionSchema,\n legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\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\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n // Simple A1 notation parser for single cells\n const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n }\n\n const colLetters = match[1];\n const rowNumber = match[2];\n\n // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n let columnIndex = 0;\n for (let i = 0; i < colLetters.length; i++) {\n columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n }\n columnIndex--; // Convert to 0-based\n\n // Convert row number to index (1-based to 0-based)\n const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.chart.create called', {\n id,\n gid,\n chartType,\n dataRange,\n title,\n position,\n legend,\n is3D,\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 chart create', { id, gid, chartType });\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 // Validate 3D only for PIE charts\n // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n if (is3D && chartType !== 'PIE') {\n logger.info('3D mode not supported for this chart type', {\n chartType,\n is3D,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n }\n\n // Parse anchor cell to row/column indices\n let anchorRowIndex: number;\n let anchorColumnIndex: number;\n try {\n const anchorIndices = parseAnchorCell(position.anchorCell);\n anchorRowIndex = anchorIndices.rowIndex;\n anchorColumnIndex = anchorIndices.columnIndex;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse anchor cell', {\n anchorCell: position.anchorCell,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n }\n\n // Parse data range to grid range\n let dataGridRange: sheets_v4.Schema$GridRange;\n try {\n const rangeRef = parseA1Notation(dataRange);\n dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Validate that required properties are defined for chart creation\n if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse data range', {\n dataRange,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n }\n\n // Extract validated properties with defined types\n const dataStartRowIndex = dataGridRange.startRowIndex as number;\n const dataEndRowIndex = dataGridRange.endRowIndex as number;\n const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n // Build chart spec with properly split domain and series ranges\n let chartSpec: sheets_v4.Schema$ChartSpec;\n\n logger.info('Building chart spec', {\n chartType,\n dataGridRange,\n sheetId,\n });\n\n // Map legend position to API format (add _LEGEND suffix)\n const legendPositionMap: Record<string, string> = {\n BOTTOM: 'BOTTOM_LEGEND',\n RIGHT: 'RIGHT_LEGEND',\n TOP: 'TOP_LEGEND',\n LEFT: 'LEFT_LEGEND',\n NONE: 'NO_LEGEND',\n };\n const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n if (chartType === 'PIE') {\n // PIE charts use a separate pieChart property, not basicChart\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n };\n\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n endColumnIndex: dataStartColumnIndex + 2,\n };\n\n logger.info('PIE chart ranges', {\n dataGridRange,\n domainRange,\n seriesRange,\n apiLegendPosition,\n });\n\n chartSpec = {\n pieChart: {\n // Use pieChart for PIE charts\n legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n domain: {\n // Note: domain/series are direct objects, not arrays\n sourceRange: {\n sources: [domainRange],\n },\n },\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n threeDimensional: is3D, // 3D is directly on pieChart\n },\n };\n if (title) {\n chartSpec.title = title;\n }\n } else {\n // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only\n };\n\n // Calculate number of data columns (excluding the first domain column)\n const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n const series = [];\n\n // Create a series for each data column\n for (let i = 0; i < numDataColumns; i++) {\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1 + i,\n endColumnIndex: dataStartColumnIndex + 2 + i,\n };\n\n series.push({\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n });\n }\n\n // If no data columns were found, default to using the entire range as a fallback\n if (series.length === 0) {\n series.push({\n series: {\n sourceRange: {\n sources: [dataGridRange],\n },\n },\n });\n }\n\n const basicChart: sheets_v4.Schema$BasicChartSpec = {\n chartType, // BAR, COLUMN, LINE are valid for basicChart\n headerCount: 1, // First row is headers\n // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n // threeDimensional is only supported for pieChart\n domains: [\n {\n domain: {\n sourceRange: {\n sources: [domainRange],\n },\n },\n },\n ],\n series,\n };\n if (legend !== 'NONE') {\n basicChart.legendPosition = apiLegendPosition;\n }\n\n chartSpec = { basicChart };\n if (title) {\n chartSpec.title = title;\n }\n }\n\n // Build embedded object position\n const embeddedObjectPosition = {\n overlayPosition: {\n anchorCell: {\n sheetId,\n rowIndex: anchorRowIndex,\n columnIndex: anchorColumnIndex,\n },\n offsetXPixels: position.offsetX,\n offsetYPixels: position.offsetY,\n },\n };\n\n const requestBody = {\n requests: [\n {\n addChart: {\n chart: {\n spec: chartSpec,\n position: embeddedObjectPosition,\n },\n },\n },\n ],\n };\n\n logger.info('sheets.chart.create executing addChart request', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n dataRange,\n anchorCell: position.anchorCell,\n requestBody: JSON.stringify(requestBody),\n });\n\n // Execute the addChart request\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody,\n });\n\n // Extract chart ID from response\n const replies = response.data.replies || [];\n if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n logger.error('Chart creation failed - no chart ID returned', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n });\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n }\n\n const chartId = replies[0].addChart.chart.chartId;\n\n logger.info('sheets.chart.create completed successfully', {\n chartId,\n chartType,\n anchorCell: position.anchorCell,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n chartId,\n anchorCell: position.anchorCell,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (e) {\n const error = e as Error & { response?: { data?: unknown; status?: number } };\n const message = error.message || String(e);\n logger.error('Chart create operation failed', {\n id,\n gid,\n chartType,\n dataRange,\n error: message,\n response: error.response?.data,\n status: error.response?.status,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n stack: e instanceof Error ? e.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'chart-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
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('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { 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 { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n 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.',\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\n// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { 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 { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n 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.',\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\n// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
const { AuthRequiredBranchSchema } = schemas;
|
|
3
3
|
import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
|
|
4
4
|
import { parse } from 'csv-parse';
|
|
5
|
+
import { pipeline } from 'stream/promises';
|
|
5
6
|
import { z } from 'zod';
|
|
6
7
|
import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
|
|
7
8
|
const inputSchema = z.object({
|
|
@@ -32,25 +33,31 @@ async function handler({ sourceUri }, extra) {
|
|
|
32
33
|
});
|
|
33
34
|
try {
|
|
34
35
|
var _logger_info;
|
|
35
|
-
|
|
36
|
-
const readStream = await getCsvReadStream(sourceUri);
|
|
37
|
-
// Create CSV parser without treating first row as column names
|
|
38
|
-
// We just want to read the raw first row
|
|
39
|
-
const parser = readStream.pipe(parse({
|
|
36
|
+
const parser = parse({
|
|
40
37
|
columns: false,
|
|
41
38
|
skip_empty_lines: true,
|
|
42
39
|
trim: true,
|
|
43
40
|
cast: true,
|
|
44
41
|
relax_column_count: true
|
|
45
|
-
})
|
|
46
|
-
|
|
42
|
+
});
|
|
43
|
+
const readStream = await getCsvReadStream(sourceUri);
|
|
44
|
+
const firstRowRead = new Error('First CSV row read');
|
|
45
|
+
const completed = pipeline(readStream, parser).then(()=>undefined, (error)=>error);
|
|
47
46
|
let firstRow = [];
|
|
48
47
|
let rowCount = 0;
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
48
|
+
try {
|
|
49
|
+
const record = await parser[Symbol.asyncIterator]().next();
|
|
50
|
+
if (!record.done) {
|
|
51
|
+
firstRow = record.value;
|
|
52
|
+
rowCount = 1;
|
|
53
|
+
parser.destroy(firstRowRead);
|
|
54
|
+
}
|
|
55
|
+
} catch (error) {
|
|
56
|
+
await completed;
|
|
57
|
+
throw error;
|
|
53
58
|
}
|
|
59
|
+
const pipelineError = await completed;
|
|
60
|
+
if (pipelineError !== undefined && pipelineError !== firstRowRead) throw pipelineError;
|
|
54
61
|
// Convert first row to strings (column names)
|
|
55
62
|
const columns = firstRow.map((value)=>String(value !== null && value !== void 0 ? value : ''));
|
|
56
63
|
const isEmpty = rowCount === 0;
|