gogcli-mcp-docs 2.0.11 → 2.0.12

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp-docs",
   "displayName": "gogcli (Docs)",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31292,7 +31292,7 @@ function registerDocsTools(server2) {
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.0.11" : "0.0.0";
+var VERSION = true ? "2.0.12" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31399,6 +31399,8 @@ function registerExtraDocsTools(server2) {
       noStrikethrough: external_exports.boolean().optional().describe("Clear strikethrough"),
       alignment: external_exports.enum(["left", "center", "right", "justify", "start", "end", "justified"]).optional().describe("Paragraph alignment"),
       lineSpacing: external_exports.number().optional().describe("Line spacing percentage (e.g. 100 for single, 150 for 1.5x, 200 for double)"),
+      headingLevel: external_exports.number().int().optional().describe("Set paragraph named style to HEADING_1..HEADING_6 (shortcut for namedStyle=HEADING_N)"),
+      namedStyle: external_exports.enum(["NORMAL_TEXT", "TITLE", "SUBTITLE", "HEADING_1", "HEADING_2", "HEADING_3", "HEADING_4", "HEADING_5", "HEADING_6"]).optional().describe("Set paragraph named style explicitly"),
       account: accountParam
     }
   }, async (args) => {
@@ -31422,6 +31424,8 @@ function registerExtraDocsTools(server2) {
     if (a.noStrikethrough) argv.push("--no-strikethrough");
     if (a.alignment) argv.push(`--alignment=${a.alignment}`);
     if (a.lineSpacing !== void 0) argv.push(`--line-spacing=${a.lineSpacing}`);
+    if (a.headingLevel !== void 0) argv.push(`--heading-level=${a.headingLevel}`);
+    if (a.namedStyle) argv.push(`--named-style=${a.namedStyle}`);
     return runOrDiagnose(argv, { account: a.account });
   });
   server2.registerTool("gog_docs_export", {
@@ -31604,6 +31608,68 @@ function registerExtraDocsTools(server2) {
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(["docs", "comments", "delete", docId, commentId], { account });
   });
+  server2.registerTool("gog_docs_comments_reopen", {
+    description: "Reopen a previously resolved comment (flip resolved \u2192 open).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      commentId: external_exports.string().describe("Comment ID to reopen"),
+      account: accountParam
+    }
+  }, async ({ docId, commentId, account }) => {
+    return runOrDiagnose(["docs", "comments", "reopen", docId, commentId], { account });
+  });
+  server2.registerTool("gog_docs_insert_page_break", {
+    description: "Insert a Google Docs page break via InsertPageBreakRequest \u2014 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: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      index: external_exports.number().int().optional().describe("Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc."),
+      atEnd: external_exports.boolean().optional().describe("Insert at end-of-doc/tab (mutually exclusive with index)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, index, atEnd, tab, account }) => {
+    const args = ["docs", "insert-page-break", docId];
+    if (index !== void 0) args.push(`--index=${index}`);
+    if (atEnd) args.push("--at-end");
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.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: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      layout: external_exports.enum(["pageless", "pages"]).optional().describe("Page layout (default: pageless)"),
+      account: accountParam
+    }
+  }, async ({ docId, layout, account }) => {
+    const args = ["docs", "page-layout", docId];
+    if (layout) args.push(`--layout=${layout}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.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: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      rows: external_exports.number().int().min(1).describe("Number of rows (>=1)"),
+      cols: external_exports.number().int().min(1).describe("Number of columns (>=1)"),
+      index: external_exports.number().int().optional().describe("Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc."),
+      atEnd: external_exports.boolean().optional().describe("Insert at end-of-doc/tab (mutually exclusive with index)"),
+      valuesJson: external_exports.string().optional().describe("Cell values as a JSON 2D string array; dimensions must match rows x cols when supplied"),
+      tab: external_exports.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 !== void 0) args.push(`--index=${index}`);
+    if (atEnd) args.push("--at-end");
+    if (valuesJson !== void 0) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
 }
 
 // src/index.ts

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-docs",
   "display_name": "gogcli (Docs)",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",
@@ -169,11 +169,27 @@
     },
     {
       "name": "gog_docs_format",
-      "description": "Apply text/paragraph formatting (bold, italic, font size, color, alignment, line spacing) — supports match, matchAll, matchCase"
+      "description": "Apply text/paragraph formatting (bold, italic, font size, color, alignment, line spacing, named style / heading level) — supports match, matchAll, matchCase"
     },
     {
       "name": "gog_docs_trash",
       "description": "Move an entire Google Doc to Drive trash (convenience wrapper around gog drive delete)"
+    },
+    {
+      "name": "gog_docs_comments_reopen",
+      "description": "Reopen a previously resolved comment."
+    },
+    {
+      "name": "gog_docs_insert_page_break",
+      "description": "Insert a Google Docs page break at a given index or at end-of-doc — the only path for multi-page deliverables."
+    },
+    {
+      "name": "gog_docs_page_layout",
+      "description": "Toggle page layout (pageless | pages) on an existing Google Doc."
+    },
+    {
+      "name": "gog_docs_insert_table",
+      "description": "Insert a native Google Docs table with given dimensions, optionally populated from a JSON 2D array."
     }
   ],
   "compatibility": {

package/package.json

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

package/server.json

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

package/src/tools/docs-extra.ts

@@ -105,6 +105,8 @@ export function registerExtraDocsTools(server: McpServer): void {
       noStrikethrough: z.boolean().optional().describe('Clear strikethrough'),
       alignment: z.enum(['left', 'center', 'right', 'justify', 'start', 'end', 'justified']).optional().describe('Paragraph alignment'),
       lineSpacing: z.number().optional().describe('Line spacing percentage (e.g. 100 for single, 150 for 1.5x, 200 for double)'),
+      headingLevel: z.number().int().optional().describe('Set paragraph named style to HEADING_1..HEADING_6 (shortcut for namedStyle=HEADING_N)'),
+      namedStyle: z.enum(['NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1', 'HEADING_2', 'HEADING_3', 'HEADING_4', 'HEADING_5', 'HEADING_6']).optional().describe('Set paragraph named style explicitly'),
       account: accountParam,
     },
   }, async (args) => {
@@ -124,6 +126,8 @@ export function registerExtraDocsTools(server: McpServer): void {
       strikethrough?: boolean; noStrikethrough?: boolean;
       alignment?: string;
       lineSpacing?: number;
+      headingLevel?: number;
+      namedStyle?: string;
       account?: string;
     };
     const argv = ['docs', 'format', a.docId];
@@ -145,6 +149,8 @@ export function registerExtraDocsTools(server: McpServer): void {
     if (a.noStrikethrough) argv.push('--no-strikethrough');
     if (a.alignment) argv.push(`--alignment=${a.alignment}`);
     if (a.lineSpacing !== undefined) argv.push(`--line-spacing=${a.lineSpacing}`);
+    if (a.headingLevel !== undefined) argv.push(`--heading-level=${a.headingLevel}`);
+    if (a.namedStyle) argv.push(`--named-style=${a.namedStyle}`);
     return runOrDiagnose(argv, { account: a.account });
   });
 
@@ -342,4 +348,70 @@ export function registerExtraDocsTools(server: McpServer): void {
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(['docs', 'comments', 'delete', docId, commentId], { account });
   });
+
+  server.registerTool('gog_docs_comments_reopen', {
+    description: 'Reopen a previously resolved comment (flip resolved → open).',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      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 });
+  });
+
+  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: {
+      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)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, index, atEnd, tab, account }) => {
+    const args = ['docs', 'insert-page-break', docId];
+    if (index !== undefined) args.push(`--index=${index}`);
+    if (atEnd) args.push('--at-end');
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  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: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      layout: z.enum(['pageless', 'pages']).optional().describe('Page layout (default: pageless)'),
+      account: accountParam,
+    },
+  }, async ({ docId, layout, account }) => {
+    const args = ['docs', 'page-layout', docId];
+    if (layout) args.push(`--layout=${layout}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  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: {
+      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)'),
+      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)'),
+      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}`);
+    if (atEnd) args.push('--at-end');
+    if (valuesJson !== undefined) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
 }

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

@@ -665,4 +665,137 @@ describe('gog_docs_format', () => {
     await handlers.get('gog_docs_format')!({ docId: 'd1' });
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'format', 'd1'], { account: undefined });
   });
+
+  // gog 0.18.0
+  it('passes --heading-level and --named-style when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_format')!({
+      docId: 'd1', match: 'Intro', headingLevel: 1, namedStyle: 'HEADING_1',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'format', 'd1', '--match=Intro', '--heading-level=1', '--named-style=HEADING_1'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --heading-level=0 when explicitly 0 (HEADING_0 reserved but argument should reach gog)', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_format')!({ docId: 'd1', headingLevel: 0 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'format', 'd1', '--heading-level=0'],
+      { account: undefined },
+    );
+  });
+});
+
+// --- gog 0.18.0 new tools ---
+
+describe('gog_docs_insert_page_break', () => {
+  it('inserts at index when --index provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', index: 42 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--index=42'],
+      { account: undefined },
+    );
+  });
+
+  it('uses --at-end when atEnd is true', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', atEnd: true, tab: 'Body' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--at-end', '--tab=Body'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --index=1 when explicitly 1', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', index: 1 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--index=1'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_page_layout', () => {
+  it('passes --layout when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_page_layout')!({ docId: 'd1', layout: 'pages' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'page-layout', 'd1', '--layout=pages'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --layout when not provided (defaults to pageless on gog side)', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_page_layout')!({ docId: 'd1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'page-layout', 'd1'], { account: undefined });
+  });
+});
+
+describe('gog_docs_insert_table', () => {
+  it('passes required --rows and --cols', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_table')!({ docId: 'd1', rows: 3, cols: 2 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=3', '--cols=2'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --values-json, --index, --tab when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    const vj = '[["a","b"],["c","d"]]';
+    await handlers.get('gog_docs_insert_table')!({
+      docId: 'd1', rows: 2, cols: 2, index: 10, valuesJson: vj, tab: 'Body',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=2', '--cols=2', '--index=10', `--values-json=${vj}`, '--tab=Body'],
+      { account: undefined },
+    );
+  });
+
+  it('uses --at-end when atEnd is true', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_table')!({ docId: 'd1', rows: 1, cols: 1, atEnd: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=1', '--cols=1', '--at-end'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_comments_reopen', () => {
+  it('calls runOrDiagnose with docId and commentId', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_comments_reopen')!({ docId: 'd1', commentId: 'c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'comments', 'reopen', 'd1', 'c1'],
+      { account: undefined },
+    );
+  });
+
+  it('forwards account', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_comments_reopen')!({ docId: 'd1', commentId: 'c1', account: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'comments', 'reopen', 'd1', 'c1'],
+      { account: 'a@b.com' },
+    );
+  });
 });