gogcli-mcp-sheets 2.6.0 → 2.7.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
-    "version": "2.6.0"
+    "version": "2.7.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli (Sheets)",
       "source": "./",
       "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
-      "version": "2.6.0",
+      "version": "2.7.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp-sheets",
   "displayName": "gogcli (Sheets)",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31399,7 +31399,7 @@ function registerSheetsTools(server2) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.6.0" : "0.0.0";
+var VERSION = true ? "2.7.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31552,7 +31552,7 @@ function registerExtraSheetsTools(server2) {
       account: accountParam
     }
   }, async ({ spreadsheetId, sheet, dimension, start, count, after, inheritFromBefore, account }) => {
-    const effectiveStart = after ? start + 1 : start;
+    const effectiveStart = start + 1;
     const args = ["sheets", "insert", spreadsheetId, sheet, dimension, String(effectiveStart)];
     if (count !== void 0) args.push(`--count=${count}`);
     if (after) args.push("--after");
@@ -31815,6 +31815,71 @@ ${result.content[0].text}` }] };
     if (cellsJson) args.push(`--cells-json=${cellsJson}`);
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_sheets_validation_get", {
+    description: "Read the data-validation rules (dropdowns, checkboxes, number/date conditions, custom formulas) applied to a range.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to inspect (e.g. Sheet1!A1:A10)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, account }) => {
+    return runOrDiagnose(["sheets", "validation", "get", spreadsheetId, range], { account });
+  });
+  server2.registerTool("gog_sheets_validation_set", {
+    description: "Set a data-validation rule on a range \u2014 dropdowns (ONE_OF_LIST / ONE_OF_RANGE), checkboxes (BOOLEAN), number/date conditions, or custom formulas. Overwrites any existing rule on the range. Repeat values for list entries or between-bounds.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to apply the rule to (e.g. Sheet1!A1:A10)"),
+      type: external_exports.string().describe("Condition type, e.g. ONE_OF_LIST, ONE_OF_RANGE, NUMBER_BETWEEN, NUMBER_GREATER, DATE_AFTER, BOOLEAN, CUSTOM_FORMULA"),
+      values: external_exports.array(external_exports.string()).optional().describe("Condition values (repeatable): list entries for ONE_OF_LIST, two bounds for *_BETWEEN, a range for ONE_OF_RANGE, a formula for CUSTOM_FORMULA"),
+      strict: external_exports.boolean().optional().describe("Reject invalid input instead of showing a warning"),
+      inputMessage: external_exports.string().optional().describe("Message shown when the cell is selected"),
+      showCustomUi: external_exports.boolean().optional().describe("Show dropdown or checkbox UI where supported"),
+      filteredRowsIncluded: external_exports.boolean().optional().describe("Apply the rule to filtered rows too; required for table-managed dropdown columns"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, type, values, strict, inputMessage, showCustomUi, filteredRowsIncluded, account }) => {
+    const args = ["sheets", "validation", "set", spreadsheetId, range, `--type=${type}`];
+    if (values) for (const v of values) args.push(`--value=${v}`);
+    if (strict) args.push("--strict");
+    if (inputMessage) args.push(`--input-message=${inputMessage}`);
+    if (showCustomUi) args.push("--show-custom-ui");
+    if (filteredRowsIncluded) args.push("--filtered-rows-included");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_validation_clear", {
+    description: "Remove all data-validation rules from a range.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to clear (e.g. Sheet1!A1:A10)"),
+      filteredRowsIncluded: external_exports.boolean().optional().describe("Clear rules from filtered rows too; required for table-managed dropdown columns"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, filteredRowsIncluded, account }) => {
+    const args = ["sheets", "validation", "clear", spreadsheetId, range];
+    if (filteredRowsIncluded) args.push("--filtered-rows-included");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_delete_dimension", {
+    description: "Delete a span of rows or columns, table-aware: intersecting table objects are preserved (shrunk) along with their remaining data, instead of being corrupted as with a raw DeleteDimension batch update. Target by A1 range (e.g. Sheet1!5:7 or Sheet1!C:D) or by sheet name plus start/end.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      rangeOrSheet: external_exports.string().describe("A1 range covering the rows/columns to delete, or a sheet name (then start/end are required)"),
+      dimension: external_exports.enum(["ROWS", "COLUMNS"]).describe("Dimension to delete"),
+      start: external_exports.number().int().optional().describe("First row/column to delete (1-based, inclusive; required with a sheet-name target)"),
+      end: external_exports.number().int().optional().describe("Last row/column to delete (1-based, inclusive; required with a sheet-name target)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, rangeOrSheet, dimension, start, end, account }) => {
+    const args = ["sheets", "delete-dimension", spreadsheetId, rangeOrSheet, `--dimension=${dimension}`];
+    if (start !== void 0) args.push(`--start=${start}`);
+    if (end !== void 0) args.push(`--end=${end}`);
+    return runOrDiagnose(args, { account });
+  });
   server2.registerTool("gog_sheets_named_ranges_list", {
     description: "List all named ranges in a spreadsheet.",
     annotations: { readOnlyHint: true },
@@ -32037,7 +32102,7 @@ ${result.content[0].text}` }] };
     return runOrDiagnose(["sheets", "table", "clear", spreadsheetId, tableId], { account });
   });
   server2.registerTool("gog_sheets_table_delete", {
-    description: "Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range \u2014 not just the table styling/columns. By default this tool prevents that data loss by emulating the Sheets UI's \"Convert to range\": it reads the table's cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. Formatting, banding, and data-validation dropdowns are still lost (gog cannot round-trip those yet). Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.",
+    description: "Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range \u2014 not just the table styling/columns. By default this tool prevents that data loss by emulating the Sheets UI's \"Convert to range\": it reads the table's cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. Formatting and banding are still lost; data-validation dropdowns are also not restored automatically, but you can snapshot them first with gog_sheets_validation_get and re-apply with gog_sheets_validation_set. Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.",
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-sheets",
   "display_name": "gogcli (Sheets)",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",
@@ -184,6 +184,22 @@
       "name": "gog_sheets_links_set",
       "description": "Set native cell hyperlinks: single link, multi-link rich-text cell (runsJson), or batch (cellsJson)."
     },
+    {
+      "name": "gog_sheets_validation_get",
+      "description": "Read data-validation rules (dropdowns, checkboxes, conditions) on a range."
+    },
+    {
+      "name": "gog_sheets_validation_set",
+      "description": "Set a data-validation rule on a range: dropdowns, checkboxes, number/date conditions, or custom formulas."
+    },
+    {
+      "name": "gog_sheets_validation_clear",
+      "description": "Remove all data-validation rules from a range."
+    },
+    {
+      "name": "gog_sheets_delete_dimension",
+      "description": "Delete a row or column span, table-aware: intersecting tables are shrunk and their remaining data preserved."
+    },
     {
       "name": "gog_sheets_named_ranges_list",
       "description": "List all named ranges in a spreadsheet."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-sheets",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-sheets",
   "description": "Extended Google Sheets MCP server via gogcli — all base tools plus full Sheets support",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp-sheets"
   },
-  "version": "2.6.0",
+  "version": "2.7.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp-sheets",
-      "version": "2.6.0",
+      "version": "2.7.0",
       "transport": {
         "type": "stdio"
       },

package/src/tools/sheets-extra.ts

@@ -182,11 +182,12 @@ export function registerExtraSheetsTools(server: McpServer): void {
       account: accountParam,
     },
   }, async ({ spreadsheetId, sheet, dimension, start, count, after, inheritFromBefore, account }) => {
-    // The underlying `gog sheets insert` treats `start` as 1-based with `--after` shifting +1.
-    // To honor our 0-based `start` and make `after:true` actually shift the insertion to start+1
-    // (issue #42), we send `start+1` when `after:true`. With after:false the CLI's `start-1`
-    // conversion lands the insertion at our 0-based start.
-    const effectiveStart = after ? start + 1 : start;
+    // gog's positional `<start>` is 1-based, and it rejects 0 ("start must be >= 1").
+    // Without --after it inserts *before* the position, so API start_index = positional - 1;
+    // with --after it inserts *after*, so API start_index = positional. Our `start` is 0-based,
+    // and the contract is: after:false lands at start_index=start, after:true at start_index=start+1.
+    // Both cases reduce to sending positional = start + 1 (issue #42 + the off-by-one this fixes).
+    const effectiveStart = start + 1;
     const args = ['sheets', 'insert', spreadsheetId, sheet, dimension, String(effectiveStart)];
     if (count !== undefined) args.push(`--count=${count}`);
     if (after) args.push('--after');
@@ -465,6 +466,75 @@ export function registerExtraSheetsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_sheets_validation_get', {
+    description: 'Read the data-validation rules (dropdowns, checkboxes, number/date conditions, custom formulas) applied to a range.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to inspect (e.g. Sheet1!A1:A10)'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, account }) => {
+    return runOrDiagnose(['sheets', 'validation', 'get', spreadsheetId, range], { account });
+  });
+
+  server.registerTool('gog_sheets_validation_set', {
+    description: 'Set a data-validation rule on a range — dropdowns (ONE_OF_LIST / ONE_OF_RANGE), checkboxes (BOOLEAN), number/date conditions, or custom formulas. Overwrites any existing rule on the range. Repeat values for list entries or between-bounds.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to apply the rule to (e.g. Sheet1!A1:A10)'),
+      type: z.string().describe('Condition type, e.g. ONE_OF_LIST, ONE_OF_RANGE, NUMBER_BETWEEN, NUMBER_GREATER, DATE_AFTER, BOOLEAN, CUSTOM_FORMULA'),
+      values: z.array(z.string()).optional().describe('Condition values (repeatable): list entries for ONE_OF_LIST, two bounds for *_BETWEEN, a range for ONE_OF_RANGE, a formula for CUSTOM_FORMULA'),
+      strict: z.boolean().optional().describe('Reject invalid input instead of showing a warning'),
+      inputMessage: z.string().optional().describe('Message shown when the cell is selected'),
+      showCustomUi: z.boolean().optional().describe('Show dropdown or checkbox UI where supported'),
+      filteredRowsIncluded: z.boolean().optional().describe('Apply the rule to filtered rows too; required for table-managed dropdown columns'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, type, values, strict, inputMessage, showCustomUi, filteredRowsIncluded, account }) => {
+    const args = ['sheets', 'validation', 'set', spreadsheetId, range, `--type=${type}`];
+    if (values) for (const v of values) args.push(`--value=${v}`);
+    if (strict) args.push('--strict');
+    if (inputMessage) args.push(`--input-message=${inputMessage}`);
+    if (showCustomUi) args.push('--show-custom-ui');
+    if (filteredRowsIncluded) args.push('--filtered-rows-included');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_sheets_validation_clear', {
+    description: 'Remove all data-validation rules from a range.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to clear (e.g. Sheet1!A1:A10)'),
+      filteredRowsIncluded: z.boolean().optional().describe('Clear rules from filtered rows too; required for table-managed dropdown columns'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, filteredRowsIncluded, account }) => {
+    const args = ['sheets', 'validation', 'clear', spreadsheetId, range];
+    if (filteredRowsIncluded) args.push('--filtered-rows-included');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_sheets_delete_dimension', {
+    description: 'Delete a span of rows or columns, table-aware: intersecting table objects are preserved (shrunk) along with their remaining data, instead of being corrupted as with a raw DeleteDimension batch update. Target by A1 range (e.g. Sheet1!5:7 or Sheet1!C:D) or by sheet name plus start/end.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      rangeOrSheet: z.string().describe('A1 range covering the rows/columns to delete, or a sheet name (then start/end are required)'),
+      dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension to delete'),
+      start: z.number().int().optional().describe('First row/column to delete (1-based, inclusive; required with a sheet-name target)'),
+      end: z.number().int().optional().describe('Last row/column to delete (1-based, inclusive; required with a sheet-name target)'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, rangeOrSheet, dimension, start, end, account }) => {
+    const args = ['sheets', 'delete-dimension', spreadsheetId, rangeOrSheet, `--dimension=${dimension}`];
+    if (start !== undefined) args.push(`--start=${start}`);
+    if (end !== undefined) args.push(`--end=${end}`);
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_sheets_named_ranges_list', {
     description: 'List all named ranges in a spreadsheet.',
     annotations: { readOnlyHint: true },
@@ -711,7 +781,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
     description:
       'Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range — not just the table styling/columns. ' +
       'By default this tool prevents that data loss by emulating the Sheets UI\'s "Convert to range": it reads the table\'s cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. ' +
-      'Formatting, banding, and data-validation dropdowns are still lost (gog cannot round-trip those yet). ' +
+      'Formatting and banding are still lost; data-validation dropdowns are also not restored automatically, but you can snapshot them first with gog_sheets_validation_get and re-apply with gog_sheets_validation_set. ' +
       'Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.',
     annotations: { destructiveHint: true },
     inputSchema: {

package/tests/tools/sheets-extra.test.ts

@@ -114,11 +114,23 @@ describe('gog_sheets_freeze', () => {
 
 // 7. insert
 describe('gog_sheets_insert', () => {
-  it('calls runOrDiagnose with required args', async () => {
+  it('shifts our 0-based start by +1 so the new dimension lands AT start (after:false)', async () => {
+    // gog's positional <start> is 1-based and, without --after, it inserts *before* it,
+    // so API start_index = positional - 1. To land at our 0-based start we send start+1.
+    // start=5 → positional 6 → API start_index 5.
     vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
     const handlers = setupHandlers();
     await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'Sheet1', dimension: 'ROWS', start: 5 });
-    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'Sheet1', 'ROWS', '5'], { account: undefined });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'Sheet1', 'ROWS', '6'], { account: undefined });
+  });
+
+  it('bug: start=1, after:false inserts before 0-based index 1 (new row 2), not at the top', async () => {
+    // Regression for the reported "range.startIndex must be set" / wrong-placement bug.
+    // start=1 → positional 2 → gog API start_index 1 (insert before the 2nd row).
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 1, count: 1 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '2', '--count=1'], { account: undefined });
   });
 
   it('shifts start by +1 when after:true so the new dimension lands AFTER start', async () => {
@@ -142,14 +154,17 @@ describe('gog_sheets_insert', () => {
     vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
     const handlers = setupHandlers();
     await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 0, count: 0 });
-    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '0', '--count=0'], { account: undefined });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '1', '--count=0'], { account: undefined });
   });
 
-  it('omits --after and does not shift start when after:false', async () => {
+  it('omits --after and sends start+1 so start=0 inserts at the very top (after:false)', async () => {
+    // start=0 → positional 1 → gog API start_index 0. Sending positional 0 would make gog
+    // reject the call outright ("start must be >= 1"), so the +1 shift is what makes a
+    // top-of-sheet insert reachable at all.
     vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
     const handlers = setupHandlers();
     await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 0, after: false });
-    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '0'], { account: undefined });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '1'], { account: undefined });
   });
 
   it('passes --inherit-from-before=true when set', async () => {
@@ -1269,3 +1284,82 @@ describe('gog_sheets_snapshot', () => {
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['drive', 'copy', 'sid', 'Backup A', '--parent=folder1'], { account: 'a@b.com' });
   });
 });
+
+// gog 0.24.0
+describe('gog_sheets_validation_get', () => {
+  it('reads validation rules for a range', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_get')!({ spreadsheetId: 'sid', range: 'Sheet1!A1:A10' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'get', 'sid', 'Sheet1!A1:A10'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_validation_set', () => {
+  it('sets a dropdown rule with repeated values', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_set')!({
+      spreadsheetId: 'sid', range: 'A1:A10', type: 'ONE_OF_LIST', values: ['Red', 'Green'],
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'set', 'sid', 'A1:A10', '--type=ONE_OF_LIST', '--value=Red', '--value=Green'],
+      { account: undefined },
+    );
+  });
+
+  it('passes strict, input message, custom UI and filtered-rows flags', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_set')!({
+      spreadsheetId: 'sid', range: 'A1', type: 'NUMBER_BETWEEN', values: ['1', '10'],
+      strict: true, inputMessage: 'Pick 1-10', showCustomUi: true, filteredRowsIncluded: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'set', 'sid', 'A1', '--type=NUMBER_BETWEEN', '--value=1', '--value=10',
+        '--strict', '--input-message=Pick 1-10', '--show-custom-ui', '--filtered-rows-included'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_validation_clear', () => {
+  it('clears rules from a range', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_clear')!({ spreadsheetId: 'sid', range: 'A1:A10', filteredRowsIncluded: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'clear', 'sid', 'A1:A10', '--filtered-rows-included'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_delete_dimension', () => {
+  it('deletes a row span from a sheet target', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_delete_dimension')!({
+      spreadsheetId: 'sid', rangeOrSheet: 'Sheet1', dimension: 'ROWS', start: 5, end: 7,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'delete-dimension', 'sid', 'Sheet1', '--dimension=ROWS', '--start=5', '--end=7'],
+      { account: undefined },
+    );
+  });
+
+  it('deletes columns by A1 range without start/end', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_delete_dimension')!({
+      spreadsheetId: 'sid', rangeOrSheet: 'Sheet1!C:D', dimension: 'COLUMNS', account: 'a@b.com',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'delete-dimension', 'sid', 'Sheet1!C:D', '--dimension=COLUMNS'],
+      { account: 'a@b.com' },
+    );
+  });
+});