gogcli-mcp-docs 2.30.0 → 3.0.0

package/src/tools/docs-extra.ts

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@modelcontextprotocol/server';
 import { z } from 'zod';
 import { accountParam, runOrDiagnose, paginationParams, pushPaginationFlags, payloadArg } from '../../../gogcli-mcp/src/lib.js';
 import type { GogArg } from '../../../gogcli-mcp/src/lib.js';
@@ -6,12 +6,12 @@ import type { GogArg } from '../../../gogcli-mcp/src/lib.js';
 export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_copy', {
     description: 'Copy a Google Doc to a new document with the given title.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       title: z.string().describe('Title for the new copy'),
       parent: z.string().optional().describe('Parent folder ID to place the copy in'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, title, parent, account }) => {
     const args = ['docs', 'copy', docId, title];
     if (parent) args.push(`--parent=${parent}`);
@@ -21,7 +21,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_delete', {
     description: 'Delete content within a Google Doc by character index range. To remove the entire document (move to Drive trash), use gog_docs_trash.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       start: z.number().optional().describe('Start index (character position, 1-based). Required unless `at` is set.'),
       end: z.number().optional().describe('End index (character position, exclusive). Required unless `at` is set.'),
@@ -32,7 +32,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       segment: z.string().optional().describe('Target an exact header, footer, or footnote segment ID (header/footer IDs come from gog_docs_header_list / gog_docs_footer_list; footnote segment IDs appear in gog_docs_read json mode) instead of the document body.'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, start, end, at, occurrence, matchCase, tabId, segment, batch, account }) => {
     const args = ['docs', 'delete'];
     if (start !== undefined) args.push(`--start=${start}`);
@@ -50,10 +50,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_trash', {
     description: 'Move an entire Google Doc to Drive trash. Convenience wrapper around `gog drive delete` so docs-only users can clean up without installing gogcli-mcp-drive. The doc remains recoverable from Drive trash for ~30 days.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID to move to trash'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, account }) => {
     return runOrDiagnose(['drive', 'delete', docId, '--force'], { account }); // gog gates this op; without --force the runner's --no-input makes it refuse
   });
@@ -61,13 +61,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_edit', {
     description: 'Edit a Google Doc by finding and replacing text (stream-edit style).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       find: z.string().describe('Text to find'),
       replace: z.string().describe('Replacement text'),
       matchCase: z.boolean().optional().describe('Case-sensitive matching'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, find, replace, matchCase, account }) => {
     const args = ['docs', 'edit', docId, find, replace];
     if (matchCase) args.push('--match-case');
@@ -77,7 +77,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_read', {
     description: 'Read the content of a Google Doc. Default: plain text body. Use format="json" for the raw Google Docs API response (lossless, includes character indices needed for index-based gog_docs_insert / gog_docs_delete calls). For markdown output, use gog_docs_export with format="md" — it writes to a file. Use gog_docs_structure to see paragraph-by-paragraph layout with indices.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       format: z.enum(['text', 'json']).optional().describe('Output format (default: text)'),
       tab: z.string().optional().describe('Target tab title or ID. In json mode, returns that one tab in the legacy top-level Document shape.'),
@@ -85,7 +85,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       maxBytes: z.number().optional().describe('Max bytes to read in text mode (0 = unlimited; default 2000000)'),
       chips: z.boolean().optional().describe('Render Google Docs smart chips (people, dates, rich links) inline in text mode; ignored in json mode'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, format, tab, allTabs, maxBytes, chips, account }) => {
     if (format === 'json') {
       const args = ['docs', 'raw', docId, '--pretty'];
@@ -105,7 +105,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_format', {
     description: 'Apply text or paragraph formatting to a Google Doc. Use `match` to format a specific text occurrence, `matchAll` to format every occurrence, or omit both to format the whole doc. Boolean flags (bold/italic/etc.) set the attribute; negated flags (noBold/noItalic/etc.) clear it.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       match: z.string().optional().describe('Format only the first text match'),
       matchAll: z.boolean().optional().describe('Format all matches instead of only the first'),
@@ -145,7 +145,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       segment: z.string().optional().describe('Target an exact header, footer, or footnote segment ID (header/footer IDs come from gog_docs_header_list / gog_docs_footer_list; footnote segment IDs appear in gog_docs_read json mode) instead of the document body.'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async (args) => {
     const a = args as {
       docId: string;
@@ -219,11 +219,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_suggestions_list', {
     description: 'List pending suggestions (suggested text insertions and deletions) in a Google Doc, with exact UTF-16 ranges and segment context. Read-only; does not accept or reject suggestions.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().optional().describe('Tab title or ID (omit for the first tab)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'suggestions', 'list', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -233,13 +233,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_export', {
     description: 'Export a Google Doc as PDF, plain text, HTML, DOCX, or other format.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       format: z.string().optional().describe('Export format: pdf, txt, html, docx, rtf, odt, epub (default: pdf)'),
       out: z.string().optional().describe('Output file path'),
       overwrite: z.boolean().optional().describe('Overwrite the output file if it already exists (gog refuses otherwise)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, format, out, overwrite, account }) => {
     const args = ['docs', 'export', docId];
     if (format) args.push(`--format=${format}`);
@@ -251,7 +251,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert', {
     description: 'Insert text at a specific character index in a Google Doc. When `index` is omitted, gog defaults to 1 (the very beginning), NOT the end — sequential inserts without an explicit index produce reversed output. To append at the end of the doc, use gog_docs_append (which uses `gog docs write --append` and is the right tool for iterative document construction). To find a valid index for mid-document inserts, call gog_docs_structure or gog_docs_read first.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       content: z.string().optional().describe('Text content to insert'),
       index: z.number().optional().describe('Character index to insert at (1-based; default: 1 = start of doc). Prefer gog_docs_append when you want to add at the end.'),
@@ -263,7 +263,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       segment: z.string().optional().describe('Target an exact header, footer, or footnote segment ID (header/footer IDs come from gog_docs_header_list / gog_docs_footer_list; footnote segment IDs appear in gog_docs_read json mode) instead of the document body.'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, content, index, file, at, occurrence, matchCase, tabId, segment, batch, account }) => {
     const args = ['docs', 'insert', docId];
     if (content) args.push(content);
@@ -281,14 +281,14 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_append', {
     description: 'Append text to the end of a Google Doc. This is the right tool for iterative document construction — multiple sequential calls produce content in the order they were called. Use gog_docs_insert only when you need to insert at a specific character position. Known markdown=true limitations (tracked upstream): (a) 3+ tables in one call reorders the trailing punctuation of the paragraph before the 3rd table — split into multiple calls with ≤2 tables each (openclaw/gogcli#607); (b) inline **bold** / *italic* / `code` inside table cells renders as literal characters — pre-format cell text separately or apply formatting after the append via gog_docs_format (openclaw/gogcli#608); (c) tables with an empty header row leak the last data row as literal pipe text — always supply a non-empty header (openclaw/gogcli#609).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Text content to append'),
       file: z.string().optional().describe('Path to a text file to append, read on the gog server. gog also accepts "-" for stdin, but this server never writes to gog\'s stdin, so "-" would hang until the call times out.'),
       markdown: z.boolean().optional().describe('Convert markdown to Google Docs formatting (headings, bold, lists, etc.). See the tool description for known upstream limitations around tables.'),
       tab: z.string().optional().describe('Target tab title or ID (for multi-tab docs)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, file, markdown, tab, account }) => {
     const args = ['docs', 'write', docId, '--append'];
     if (text) args.push(`--text=${text}`);
@@ -301,10 +301,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_list_tabs', {
     description: 'List all tabs in a Google Doc.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, account }) => {
     return runOrDiagnose(['docs', 'list-tabs', docId], { account });
   });
@@ -312,14 +312,14 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_sed', {
     description: 'Stream-edit a Google Doc with sed-like regex expressions (s/find/replace/ syntax).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       expression: z.string().optional().describe('Single sed expression (e.g. "s/old/new/g")'),
       expressions: z.array(z.string()).optional().describe('Multiple sed expressions'),
       file: z.string().optional().describe('Path to a sed script file'),
       tab: z.string().optional().describe('Tab name to edit'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, expression, expressions, file, tab, account }) => {
     const args = ['docs', 'sed', docId];
     if (expression) args.push(expression);
@@ -336,7 +336,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_update', {
     description: 'Update a Google Doc — insert or replace text at a specific position.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Text content to write'),
       file: z.string().optional().describe('Path to a file whose content to use'),
@@ -351,7 +351,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       pageless: z.boolean().optional().describe('Set document to pageless format'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, file, index, replaceRange, markdown, at, occurrence, matchCase, tabId, segment, pageless, batch, account }) => {
     const args = ['docs', 'update', docId];
     if (text) args.push(`--text=${text}`);
@@ -379,7 +379,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       'matches[] always spans every tab, so a quote appearing in two tabs is visible as an ambiguity rather than silently resolved. ' +
       'tab keeps only comments with a match in that tab, which drops orphaned comments and comments that quote nothing.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       includeResolved: z.boolean().optional().describe('Include resolved comments (default: false, open only)'),
       since: z.string().optional().describe('Only return comments modified at or after this RFC3339 timestamp (e.g. 2026-06-01T00:00:00Z)'),
@@ -387,7 +387,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Only return comments whose quoted text resolves inside this tab (title or ID). Implies locate, and drops orphaned and unquoted comments.'),
       ...paginationParams,
       account: accountParam,
-    },
+    }),
   }, async ({ docId, includeResolved, since, locate, tab, max, page, all, account }) => {
     const args = ['docs', 'comments', 'list', docId];
     if (includeResolved) args.push('--include-resolved');
@@ -401,11 +401,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_get', {
     description: 'Get a single comment by ID, including its replies.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(['docs', 'comments', 'get', docId, commentId], { account });
   });
@@ -413,12 +413,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_add', {
     description:
       'Add a comment to a Google Doc. Optionally attach quoted text that appears as the highlighted passage in the Google Docs UI.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       content: z.string().describe('Comment text'),
       quoted: z.string().optional().describe('Quoted text to attach to the comment (shown in UIs when available)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, content, quoted, account }) => {
     const args = ['docs', 'comments', 'add', docId, content];
     if (quoted) args.push(`--quoted=${quoted}`);
@@ -427,12 +427,12 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_comments_reply', {
     description: 'Reply to an existing comment on a Google Doc.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID to reply to'),
       content: z.string().describe('Reply text'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, content, account }) => {
     return runOrDiagnose(['docs', 'comments', 'reply', docId, commentId, content], { account });
   });
@@ -440,12 +440,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_resolve', {
     description: 'Resolve a comment (mark as done). Optionally include a closing message.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID to resolve'),
       message: z.string().optional().describe('Optional message to include when resolving'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, message, account }) => {
     const args = ['docs', 'comments', 'resolve', docId, commentId];
     if (message) args.push(`--message=${message}`);
@@ -455,11 +455,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_delete', {
     description: 'Delete a comment from a Google Doc. This action is permanent.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID to delete'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, account }) => {
     // --force: gog refuses this delete under the runner's --no-input without it.
     return runOrDiagnose(['docs', 'comments', 'delete', docId, commentId, '--force'], { account });
@@ -468,11 +468,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_reopen', {
     description: 'Reopen a previously resolved comment (flip resolved → open).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID to reopen'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(['docs', 'comments', 'reopen', docId, commentId], { account });
   });
@@ -480,14 +480,14 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_comments_locate', {
     description: 'Locate a comment\'s anchor in a Google Doc — resolves the comment\'s quoted text to its current Docs API index range, or reports the comment as orphaned if the quote can no longer be found (e.g. the anchored text was edited away). Read-only; useful before an index-based edit near a comment.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       commentId: z.string().describe('Comment ID to locate'),
       matchCase: z.boolean().optional().describe('Case-sensitive matching of the comment quote'),
       normalizeWhitespace: z.boolean().optional().describe('Collapse whitespace while matching the comment quote'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, commentId, matchCase, normalizeWhitespace, tab, account }) => {
     const args = ['docs', 'comments', 'locate', docId, commentId];
     if (matchCase) args.push('--match-case');
@@ -499,7 +499,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_find_range', {
     description: 'Map literal text in a Google Doc to its Docs API UTF-16 index range(s). Read-only helper for computing the start/end indices that index-based tools (gog_docs_delete, gog_docs_update --replace-range) need. Returns the first match by default; use occurrence to pick a specific one or all to return every match.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().describe('Literal text to locate'),
       occurrence: z.number().int().optional().describe('Return the Nth occurrence (1-based; default: first)'),
@@ -510,7 +510,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       segment: z.string().optional().describe('Target an exact header, footer, or footnote segment ID (header/footer IDs come from gog_docs_header_list / gog_docs_footer_list; footnote segment IDs appear in gog_docs_read json mode) instead of the document body.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, occurrence, matchCase, normalizeWhitespace, all, failEmpty, tab, segment, account }) => {
     const args = ['docs', 'find-range', docId, text];
     if (occurrence !== undefined) args.push(`--occurrence=${occurrence}`);
@@ -528,11 +528,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   // end to submit them atomically against the locked revision.
   server.registerTool('gog_batch_begin', {
     description: 'Open a persisted, revision-locked request batch for a Google Doc. Subsequent docs mutation tools called with batch=<batchId> append their requests locally instead of applying them; gog_batch_end submits everything atomically. Returns the batchId.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Google Doc ID the batch is locked to'),
       name: z.string().optional().describe('Optional batch label'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, name, account }) => {
     const args = ['batch', 'begin', `--doc=${docId}`];
     if (name) args.push(`--name=${name}`);
@@ -542,12 +542,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_batch_end', {
     description: 'Submit a persisted batch: applies every composed request to the doc in one atomic batchUpdate against the locked revision. Atomic by default — set autoSplit to submit >500-request batches as ordered chunks (non-atomic), or continueOnError to retry individually after an atomic validation failure, retaining failures in the batch.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       batchId: z.string().describe('Batch ID (from gog_batch_begin)'),
       autoSplit: z.boolean().optional().describe('Submit batches over 500 requests as ordered chunks (non-atomic)'),
       continueOnError: z.boolean().optional().describe('After an atomic validation failure, submit requests individually and retain failures'),
       account: accountParam,
-    },
+    }),
   }, async ({ batchId, autoSplit, continueOnError, account }) => {
     const args = ['batch', 'end', batchId];
     if (autoSplit) args.push('--auto-split');
@@ -558,10 +558,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_batch_abort', {
     description: 'Discard a persisted batch and its composed requests without applying anything to the doc.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       batchId: z.string().describe('Batch ID to discard'),
       account: accountParam,
-    },
+    }),
   }, async ({ batchId, account }) => {
     return runOrDiagnose(['batch', 'abort', batchId], { account });
   });
@@ -569,9 +569,9 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_batch_list', {
     description: 'List persisted Docs request batches (id, doc, label, request count, status).',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       account: accountParam,
-    },
+    }),
   }, async ({ account }) => {
     return runOrDiagnose(['batch', 'list'], { account });
   });
@@ -579,10 +579,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_batch_show', {
     description: 'Show one persisted batch: its doc, locked revision, and the composed requests awaiting submission.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       batchId: z.string().describe('Batch ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ batchId, account }) => {
     return runOrDiagnose(['batch', 'show', batchId], { account });
   });
@@ -590,10 +590,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_batch_prune', {
     description: 'Delete stale persisted batches (not updated within olderThan).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       olderThan: z.string().optional().describe('Delete batches not updated within this duration (e.g. 72h, 7d)'),
       account: accountParam,
-    },
+    }),
   }, async ({ olderThan, account }) => {
     const args = ['batch', 'prune'];
     if (olderThan) args.push(`--older-than=${olderThan}`);
@@ -603,7 +603,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_column_width', {
     description: 'Set a fixed width (in points) for a table column, or reset columns to Docs-managed even distribution. Target the table by 1-based index in document order (negative counts from the end) and the column by 1-based number. Pass evenlyDistributed without col to reset every column in the table.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       col: z.number().int().optional().describe('1-based column number. Omit with evenlyDistributed to reset all columns.'),
       width: z.number().optional().describe('Fixed column width in points (minimum 5pt). Mutually exclusive with evenlyDistributed.'),
@@ -612,7 +612,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target tab title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, col, width, evenlyDistributed, tableIndex, tab, batch, account }) => {
     const args = ['docs', 'table-column-width', docId];
     if (col !== undefined) args.push(`--col=${col}`);
@@ -630,14 +630,14 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_table_row_insert', {
     description: 'Insert a row into a native Google Docs table, optionally populated from a JSON string array. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends — the default).',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       table: tableSelectorParam,
       at: z.string().optional().describe('Insert before this 1-based row, a negative index from the end, or "end" to append (default: end)'),
       valuesJson: z.string().optional().describe('JSON string array with the new row\'s cell values, e.g. ["Name","Qty"]'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, table, at, valuesJson, tab, account }) => {
     const args = ['docs', 'table-row', 'insert', docId];
     if (table) args.push(`--table=${table}`);
@@ -650,13 +650,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_row_delete', {
     description: 'Delete a row from a native Google Docs table by 1-based row number (negative counts from the end). The row\'s cell content is lost.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       row: z.number().int().describe('1-based row number; negative indexes count from the end'),
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, row, table, tab, account }) => {
     const args = ['docs', 'table-row', 'delete', docId, `--row=${row}`];
     if (table) args.push(`--table=${table}`);
@@ -666,13 +666,13 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_table_column_insert', {
     description: 'Insert a column into a native Google Docs table. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends — the default).',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       table: tableSelectorParam,
       at: z.string().optional().describe('Insert before this 1-based column, a negative index from the end, or "end" to append (default: end)'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, table, at, tab, account }) => {
     const args = ['docs', 'table-column', 'insert', docId];
     if (at) args.push(`--at=${at}`);
@@ -684,13 +684,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_column_delete', {
     description: 'Delete a column from a native Google Docs table by 1-based column number (negative counts from the end). The column\'s cell content is lost.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       col: z.number().int().describe('1-based column number; negative indexes count from the end'),
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, col, table, tab, account }) => {
     const args = ['docs', 'table-column', 'delete', docId, `--col=${col}`];
     if (table) args.push(`--table=${table}`);
@@ -701,13 +701,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_merge', {
     description: 'Merge a rectangular cell range in a native Google Docs table. Content of non-first cells in the range is absorbed/discarded by the merge — use gog_docs_table_unmerge to split back.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       range: z.string().describe('1-based cell range r1,c1:r2,c2 (e.g. "1,1:2,3")'),
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, range, table, tab, account }) => {
     const args = ['docs', 'table-merge', docId, `--range=${range}`];
     if (table) args.push(`--table=${table}`);
@@ -717,13 +717,13 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_table_unmerge', {
     description: 'Unmerge (split) the merged region containing a given cell in a native Google Docs table.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       cell: z.string().describe('1-based cell r,c inside the merged region (e.g. "1,1")'),
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, cell, table, tab, account }) => {
     const args = ['docs', 'table-unmerge', docId, `--cell=${cell}`];
     if (table) args.push(`--table=${table}`);
@@ -733,7 +733,7 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_named_range_create', {
     description: 'Create a named range — a durable, tab-aware anchor over a span of document text that survives subsequent edits (unlike raw indices). Anchor by literal text (`at`) or explicit UTF-16 start/end indices. Pair with gog_docs_named_range_replace for repeatable templated updates.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       name: z.string().describe('Unique named range name'),
       at: z.string().optional().describe('Create the range around this literal matched text, instead of start/end indices'),
@@ -743,7 +743,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       end: z.number().int().optional().describe('Range end UTF-16 index (exclusive). Required with start unless `at` is set.'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, name, at, occurrence, matchCase, start, end, tab, account }) => {
     const args = ['docs', 'named-range', 'create', docId, `--name=${name}`];
     if (at) args.push(`--at=${at}`);
@@ -758,12 +758,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_named_range_list', {
     description: 'List named ranges in a Google Doc, optionally filtered by name.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       name: z.string().optional().describe('Only return ranges with this name'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, name, tab, account }) => {
     const args = ['docs', 'named-range', 'list', docId];
     if (name) args.push(`--name=${name}`);
@@ -774,12 +774,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_named_range_delete', {
     description: 'Delete a named range (the anchor only — the underlying document text is untouched).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       nameOrId: z.string().describe('Named range name or ID'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, nameOrId, tab, account }) => {
     const args = ['docs', 'named-range', 'delete', docId, nameOrId];
     if (tab) args.push(`--tab=${tab}`);
@@ -789,14 +789,14 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_named_range_replace', {
     description: 'Replace the text inside a named range with new content (inline or from a file), keeping the anchor for future updates — the templated-update workhorse.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       nameOrId: z.string().describe('Named range name or ID'),
       text: z.string().optional().describe('Replacement text'),
       file: z.string().optional().describe('Path to a file with the replacement text'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, nameOrId, text, file, tab, account }) => {
     const args = ['docs', 'named-range', 'replace', docId, nameOrId];
     if (text !== undefined) args.push(`--text=${text}`);
@@ -808,11 +808,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_tables_list', {
     description: 'Enumerate the native tables in a Google Doc (dimensions, position) — the index/first-cell-text it reports feeds the `table` selector on the table-row/column/merge tools.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().optional().describe('Tab title or ID (omit for default)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'tables', 'list', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -822,11 +822,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_images_list', {
     description: 'Enumerate inline/positioned images in a Google Doc.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().optional().describe('Tab title or ID (omit for default)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'images', 'list', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -836,12 +836,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_headings_list', {
     description: 'Enumerate headings in a Google Doc (a lightweight outline view), optionally filtered to one heading level.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       level: z.number().int().optional().describe('Only return this heading level (1-6)'),
       tab: z.string().optional().describe('Tab title or ID (omit for default)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, level, tab, account }) => {
     const args = ['docs', 'headings', 'list', docId];
     if (level !== undefined) args.push(`--level=${level}`);
@@ -852,12 +852,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_paragraphs_list', {
     description: 'Enumerate paragraphs in a Google Doc with emptiness, text-run ranges, styles, and links — richer than gog_docs_structure when you need per-run detail. Optionally filter to one named style.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       style: z.string().optional().describe('Only return this named style (e.g. NORMAL_TEXT or HEADING_2)'),
       tab: z.string().optional().describe('Tab title or ID (omit for default)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, style, tab, account }) => {
     const args = ['docs', 'paragraphs', 'list', docId];
     if (style) args.push(`--style=${style}`);
@@ -868,7 +868,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_page_break', {
     description: 'Insert a Google Docs page break via InsertPageBreakRequest — the only path for multi-page deliverables (markdown has no page-break construct). Specify `index` for a precise character position, or `atEnd` for end-of-doc.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       index: z.number().int().optional().describe('Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc.'),
       atEnd: z.boolean().optional().describe('Insert at end-of-doc/tab (mutually exclusive with index)'),
@@ -878,7 +878,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, index, atEnd, at, occurrence, matchCase, tab, batch, account }) => {
     const args = ['docs', 'insert-page-break', docId];
     if (index !== undefined) args.push(`--index=${index}`);
@@ -894,7 +894,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_page_layout', {
     description: 'Toggle the page layout (pageless | pages) of an existing Google Doc. Sibling to the --pageless flag on docs create/write/update for docs that were already created (e.g. by Drive markdown conversion) without the desired layout.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       layout: z.enum(['pageless', 'pages']).optional().describe('Page layout (default: pageless)'),
       pageSize: z.enum(['A3', 'A4', 'A5', 'Letter', 'Legal', 'Tabloid']).optional().describe('Named page size preset (only applies in paged layout)'),
@@ -905,7 +905,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       marginLeft: z.string().optional().describe('Left page margin (points by default; supports pt, in, cm, mm)'),
       marginRight: z.string().optional().describe('Right page margin (points by default; supports pt, in, cm, mm)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, layout, pageSize, pageWidth, pageHeight, marginTop, marginBottom, marginLeft, marginRight, account }) => {
     const args = ['docs', 'page-layout', docId];
     if (layout) args.push(`--layout=${layout}`);
@@ -922,7 +922,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_table', {
     description: 'Insert a native Google Docs table via InsertTableRequest, bypassing the markdown writer. Use this instead of writing a markdown table when you need precise dimensions or to avoid the markdown writer\'s table limitations. `valuesJson` is a JSON 2D string array whose dimensions must match rows x cols.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       rows: z.number().int().min(1).describe('Number of rows (>=1)'),
       cols: z.number().int().min(1).describe('Number of columns (>=1)'),
@@ -931,7 +931,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       valuesJson: z.string().optional().describe('Cell values as a JSON 2D string array; dimensions must match rows x cols when supplied'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, rows, cols, index, atEnd, valuesJson, tab, account }) => {
     const args = ['docs', 'insert-table', docId, `--rows=${rows}`, `--cols=${cols}`];
     if (index !== undefined) args.push(`--index=${index}`);
@@ -944,7 +944,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_cell_update', {
     description: 'Replace (or append to) the content of a single table cell, addressed by table / row / column — non-destructive to the rest of the table, unlike index-based edits that shift on every change. Provide content inline or read it from contentFile. Note: row/col/tableIndex are 1-based here; the sibling gog_docs_cell_style uses 0-based addressing.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       row: z.number().int().describe('1-based row number'),
       col: z.number().int().describe('1-based column number'),
@@ -955,7 +955,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tableIndex: z.number().int().optional().describe('1-based table index in document order; negative counts from the end (default: 1)'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, row, col, content, contentFile, append, format, tableIndex, tab, account }) => {
     // gog HARD-ERRORS on both forms ("cannot use both --content and
     // --content-file"), so reject here with a clearer message before gog runs.
@@ -983,7 +983,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_cell_style', {
     description: 'Apply background color and/or inline text styling (bold, italic, underline, colors) to one or more table cells, addressed by 0-based row/column with optional spans. Sibling to gog_docs_cell_update, which changes cell content rather than styling. Note: row/col/tableIndex are 0-based here; gog_docs_cell_update uses 1-based addressing.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       row: z.number().int().describe('0-based row number'),
       col: z.number().int().describe('0-based column number'),
@@ -1009,7 +1009,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, row, col, rowSpan, colSpan, backgroundColor, textColor, bold, italic, underline, borderAll, borderTop, borderBottom, borderLeft, borderRight, paddingAll, paddingTop, paddingBottom, paddingLeft, paddingRight, contentAlign, tableIndex, tab, batch, account }) => {
     const args = ['docs', 'cell-style', docId, `--row=${row}`, `--col=${col}`];
     if (rowSpan !== undefined) args.push(`--row-span=${rowSpan}`);
@@ -1039,7 +1039,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_image', {
     description: 'Insert an image into a Google Doc from a local file or a public HTTPS URL. file: uploaded to Drive, temporarily shared so Docs can fetch it, inserted, then the public permission is revoked. url: inserted directly with no Drive upload or temporary sharing. Replaces placeholder text (at) or appends at end-of-doc.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       file: z.string().optional().describe('Local PNG, JPEG, or GIF image to upload and insert (exactly one of file or url)'),
       url: z.string().optional().describe('Public HTTPS image URL to insert directly — no Drive upload or temporary public sharing (exactly one of file or url)'),
@@ -1053,7 +1053,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       onRestricted: z.enum(['error', 'link']).optional().describe('If public sharing is blocked: error out, or fall back to a linked image (default: error)'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, file, url, at, before, after, width, height, name, parent, onRestricted, tab, account }) => {
     const args = ['docs', 'insert-image', docId];
     if (file) args.push(`--file=${file}`);
@@ -1074,7 +1074,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_person', {
     description: 'Insert a native Google Docs person smart chip (the interactive @-mention chip) for an email address, at a character index or end-of-doc.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       email: z.string().describe('Email address for the person chip'),
       index: z.number().int().optional().describe('Character index to insert at. Omit or use atEnd for end-of-doc.'),
@@ -1085,7 +1085,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, email, index, atEnd, at, occurrence, matchCase, tab, batch, account }) => {
     const args = ['docs', 'insert-person', docId, `--email=${email}`];
     if (index !== undefined) args.push(`--index=${index}`);
@@ -1101,7 +1101,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_date_chip', {
     description: 'Insert a native Google Docs date smart chip, at a character index or end-of-doc.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       date: z.string().optional().describe('Date to insert as YYYY-MM-DD (default: today)'),
       format: z.enum(['abbreviated', 'full', 'iso']).optional().describe('Date display format (default: abbreviated)'),
@@ -1110,7 +1110,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, date, format, index, atEnd, tab, batch, account }) => {
     const args = ['docs', 'insert-date-chip', docId];
     if (date) args.push(`--date=${date}`);
@@ -1124,14 +1124,14 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_add_tab', {
     description: 'Add a tab to a Google Doc. Tabs partition a doc into independently-addressable sections (multi-tab docs). Optionally set the title, zero-based position, parent tab (for nesting), and an emoji icon.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       title: z.string().optional().describe('User-visible tab title'),
       index: z.number().int().optional().describe('Zero-based tab position within the parent'),
       parentTab: z.string().optional().describe('Parent tab title or ID to nest this tab under'),
       iconEmoji: z.string().optional().describe('Emoji icon for the tab'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, title, index, parentTab, iconEmoji, account }) => {
     const args = ['docs', 'add-tab', docId];
     if (title) args.push(`--title=${title}`);
@@ -1143,12 +1143,12 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_rename_tab', {
     description: 'Rename a tab in a Google Doc. Identify the existing tab by title or ID and give it a new title.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().describe('Existing tab title or ID to rename'),
       title: z.string().describe('New user-visible tab title'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, title, account }) => {
     const args = ['docs', 'rename-tab', docId, `--tab=${tab}`, `--title=${title}`];
     return runOrDiagnose(args, { account });
@@ -1157,11 +1157,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_delete_tab', {
     description: 'Delete a tab (and its content) from a Google Doc. Identify the tab by title or ID. This permanently removes the tab and everything in it.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().describe('Existing tab title or ID to delete'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'delete-tab', docId, `--tab=${tab}`, '--force']; // gog gates this op; without --force the runner's --no-input makes it refuse
     return runOrDiagnose(args, { account });
@@ -1170,10 +1170,10 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_clear', {
     description: 'Clear all content from a Google Doc, leaving an empty document. The doc itself is preserved (same ID/URL); only its body content is removed. To delete the whole doc instead, use gog_docs_trash.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, account }) => {
     return runOrDiagnose(['docs', 'clear', docId], { account });
   });
@@ -1183,7 +1183,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_footnote', {
     description: 'Insert a footnote at a character index (or end-of-doc) and populate its text. The footnote reference mark is placed in the body; the footnote content goes in the new footnote segment.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Footnote text'),
       file: z.string().optional().describe('Read footnote text from a file on the gog server. gog also accepts "-" for stdin, but this server never writes to gog\'s stdin, so "-" would hang until the call times out.'),
@@ -1194,7 +1194,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       matchCase: z.boolean().optional().describe('Case-sensitive `at` matching'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, file, index, atEnd, at, occurrence, matchCase, tab, account }) => {
     const args = ['docs', 'insert-footnote', docId];
     if (text !== undefined) args.push(`--text=${text}`);
@@ -1211,7 +1211,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_section_break', {
     description: 'Insert a continuous or next-page section break at a character index (or end-of-doc). Section breaks enable per-section layout such as column counts (see gog_docs_section_columns).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       type: z.enum(['next-page', 'continuous']).optional().describe('Section break type (default: next-page)'),
       index: z.number().int().optional().describe('Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc.'),
@@ -1222,7 +1222,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, type, index, atEnd, at, occurrence, matchCase, tab, batch, account }) => {
     const args = ['docs', 'insert-section-break', docId];
     if (type) args.push(`--type=${type}`);
@@ -1239,7 +1239,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_insert_horizontal_rule', {
     description: 'Insert a horizontal rule (paragraph border) at a character index (or end-of-doc).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       index: z.number().int().optional().describe('Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc.'),
       atEnd: z.boolean().optional().describe('Target end-of-doc/tab (mutually exclusive with index and at)'),
@@ -1249,7 +1249,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, index, atEnd, at, occurrence, matchCase, tab, batch, account }) => {
     const args = ['docs', 'insert-horizontal-rule', docId];
     if (index !== undefined) args.push(`--index=${index}`);
@@ -1265,7 +1265,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_section_columns', {
     description: 'Set the column count (1-3) for the document section containing the target position. Use count=1 to reset to a single column. Anchor by index, end-of-doc, or literal text.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       count: z.number().int().min(1).max(3).describe('Number of columns (1-3; 1 resets to one column)'),
       separator: z.enum(['none', 'between']).optional().describe('Column separator line: none or between'),
@@ -1277,7 +1277,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       batch: z.string().optional().describe('Append this mutation to a persisted batch (from gog_batch_begin) instead of applying it — nothing changes in the doc until gog_batch_end submits the batch.'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, count, separator, index, atEnd, at, occurrence, matchCase, tab, batch, account }) => {
     const args = ['docs', 'section-columns', docId, `--count=${count}`];
     if (separator) args.push(`--separator=${separator}`);
@@ -1297,11 +1297,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_header_list', {
     description: 'List a Google Doc\'s headers and their segment IDs. Use a segment ID with the segment param on gog_docs_insert / gog_docs_update / gog_docs_delete / gog_docs_format / gog_docs_find_range to edit inside a header.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().optional().describe('Limit results to a tab title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'header', 'list', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -1310,7 +1310,7 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_header_create', {
     description: 'Create a header in a Google Doc and optionally populate its initial text. Returns the new header segment ID.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Initial header text'),
       file: z.string().optional().describe('Read initial header text from a file on the gog server. gog also accepts "-" for stdin, but this server never writes to gog\'s stdin, so "-" would hang until the call times out.'),
@@ -1321,7 +1321,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       matchCase: z.boolean().optional().describe('Case-sensitive `at` matching'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, file, index, atEnd, at, occurrence, matchCase, tab, account }) => {
     const args = ['docs', 'header', 'create', docId];
     if (text !== undefined) args.push(`--text=${text}`);
@@ -1338,12 +1338,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_header_delete', {
     description: 'Delete a header from a Google Doc by its segment ID (from gog_docs_header_list).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       headerId: z.string().describe('Header segment ID (from gog_docs_header_list)'),
       tab: z.string().optional().describe('Tab title or ID containing the header'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, headerId, tab, account }) => {
     const args = ['docs', 'header', 'delete', docId, headerId];
     if (tab) args.push(`--tab=${tab}`);
@@ -1354,11 +1354,11 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_footer_list', {
     description: 'List a Google Doc\'s footers and their segment IDs. Use a segment ID with the segment param on gog_docs_insert / gog_docs_update / gog_docs_delete / gog_docs_format / gog_docs_find_range to edit inside a footer.',
     annotations: { readOnlyHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       tab: z.string().optional().describe('Limit results to a tab title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, tab, account }) => {
     const args = ['docs', 'footer', 'list', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -1367,7 +1367,7 @@ export function registerExtraDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_footer_create', {
     description: 'Create a footer in a Google Doc and optionally populate its initial text. Returns the new footer segment ID.',
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Initial footer text'),
       file: z.string().optional().describe('Read initial footer text from a file on the gog server. gog also accepts "-" for stdin, but this server never writes to gog\'s stdin, so "-" would hang until the call times out.'),
@@ -1378,7 +1378,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       matchCase: z.boolean().optional().describe('Case-sensitive `at` matching'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, text, file, index, atEnd, at, occurrence, matchCase, tab, account }) => {
     const args = ['docs', 'footer', 'create', docId];
     if (text !== undefined) args.push(`--text=${text}`);
@@ -1395,12 +1395,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_footer_delete', {
     description: 'Delete a footer from a Google Doc by its segment ID (from gog_docs_footer_list).',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       footerId: z.string().describe('Footer segment ID (from gog_docs_footer_list)'),
       tab: z.string().optional().describe('Tab title or ID containing the footer'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, footerId, tab, account }) => {
     const args = ['docs', 'footer', 'delete', docId, footerId];
     if (tab) args.push(`--tab=${tab}`);
@@ -1413,7 +1413,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_replace_image', {
     description: 'Replace an existing image in a Google Doc in place — keeping its position and bounds — with a new image from a local file or public HTTPS URL. Target the image by exact object ID (from gog_docs_images_list), by alt-text substring, or leave both off to replace the only image in the doc/tab.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       file: z.string().optional().describe('Local PNG, JPEG, or GIF image to upload and use (exactly one of file or url)'),
       url: z.string().optional().describe('Public HTTPS image URL to use directly — no Drive upload (exactly one of file or url)'),
@@ -1423,7 +1423,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       parent: z.string().optional().describe('Drive folder ID for an uploaded local image (file mode)'),
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, file, url, objectId, matchAlt, name, parent, tab, account }) => {
     const args = ['docs', 'replace-image', docId];
     if (file) args.push(`--file=${file}`);
@@ -1440,13 +1440,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_row_pin_header', {
     description: 'Pin (or unpin) leading rows of a native Google Docs table as repeating header rows. rows=N pins the first N rows; rows=0 unpins all header rows.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       rows: z.number().int().min(0).describe('Number of leading rows to pin as headers; 0 unpins all header rows'),
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, rows, table, tab, account }) => {
     const args = ['docs', 'table-row', 'pin-header', docId, `--rows=${rows}`];
     if (table) args.push(`--table=${table}`);
@@ -1457,7 +1457,7 @@ export function registerExtraDocsTools(server: McpServer): void {
   server.registerTool('gog_docs_table_row_style', {
     description: 'Set native table row height and page-overflow behaviour. Target a 1-based row (negative counts from the end) or omit row to style every row in the table.',
     annotations: { destructiveHint: true },
-    inputSchema: {
+    inputSchema: z.object({
       docId: z.string().describe('Doc ID (from the URL)'),
       row: z.number().int().optional().describe('1-based row number; negative indexes count from the end; omit to style all rows'),
       minHeight: z.string().optional().describe('Minimum row height (points by default; supports pt, in, cm, mm)'),
@@ -1465,7 +1465,7 @@ export function registerExtraDocsTools(server: McpServer): void {
       table: tableSelectorParam,
       tab: z.string().optional().describe('Target a specific tab by title or ID'),
       account: accountParam,
-    },
+    }),
   }, async ({ docId, row, minHeight, preventOverflow, table, tab, account }) => {
     const args = ['docs', 'table-row', 'style', docId];
     if (row !== undefined) args.push(`--row=${row}`);