google-tools-mcp 1.2.12 → 2.0.0

package/dist/tools/drive/uploadFile.js

@@ -1,111 +1,111 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-
-// Common MIME type mappings for file extensions
-const MIME_TYPES = {
-    '.pdf': 'application/pdf',
-    '.doc': 'application/msword',
-    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    '.xls': 'application/vnd.ms-excel',
-    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    '.ppt': 'application/vnd.ms-powerpoint',
-    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
-    '.txt': 'text/plain',
-    '.csv': 'text/csv',
-    '.json': 'application/json',
-    '.xml': 'application/xml',
-    '.html': 'text/html',
-    '.htm': 'text/html',
-    '.md': 'text/markdown',
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.gif': 'image/gif',
-    '.svg': 'image/svg+xml',
-    '.webp': 'image/webp',
-    '.mp3': 'audio/mpeg',
-    '.mp4': 'video/mp4',
-    '.zip': 'application/zip',
-    '.gz': 'application/gzip',
-    '.tar': 'application/x-tar',
-};
-
-export function register(server) {
-    server.addTool({
-        name: 'uploadFile',
-        description:
-            'Uploads a local file from the filesystem to Google Drive. ' +
-            'Auto-detects MIME type from file extension. ' +
-            'Returns the uploaded file\'s Drive ID and URL.',
-        parameters: z.object({
-            localPath: z.string().describe('Absolute path to the local file to upload.'),
-            name: z
-                .string()
-                .optional()
-                .describe('Custom name for the file in Drive. If not provided, uses the local filename.'),
-            parentFolderId: z
-                .string()
-                .optional()
-                .describe('ID of the Drive folder to upload into. If not provided, uploads to the root of My Drive.'),
-            mimeType: z
-                .string()
-                .optional()
-                .describe('MIME type override. If not provided, auto-detected from file extension.'),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-
-            // Validate file exists
-            if (!fs.existsSync(args.localPath)) {
-                throw new UserError(`File not found: ${args.localPath}`);
-            }
-
-            const stats = fs.statSync(args.localPath);
-            if (!stats.isFile()) {
-                throw new UserError(`Path is not a file: ${args.localPath}`);
-            }
-
-            const fileName = args.name || path.basename(args.localPath);
-            const ext = path.extname(args.localPath).toLowerCase();
-            const mimeType = args.mimeType || MIME_TYPES[ext] || 'application/octet-stream';
-
-            log.info(`Uploading "${args.localPath}" as "${fileName}" (${mimeType}, ${stats.size} bytes)`);
-
-            try {
-                const fileMetadata = { name: fileName };
-                if (args.parentFolderId) {
-                    fileMetadata.parents = [args.parentFolderId];
-                }
-
-                const response = await drive.files.create({
-                    requestBody: fileMetadata,
-                    media: {
-                        mimeType,
-                        body: fs.createReadStream(args.localPath),
-                    },
-                    fields: 'id,name,webViewLink,mimeType,size',
-                    supportsAllDrives: true,
-                });
-
-                const file = response.data;
-                return JSON.stringify({
-                    id: file.id,
-                    name: file.name,
-                    url: file.webViewLink,
-                    mimeType: file.mimeType,
-                    size: file.size,
-                }, null, 2);
-            } catch (error) {
-                log.error(`Error uploading file: ${error.message || error}`);
-                if (error.code === 404)
-                    throw new UserError('Destination folder not found. Check the parentFolderId.');
-                if (error.code === 403)
-                    throw new UserError('Permission denied. Make sure you have write access to the destination folder.');
-                throw new UserError(`Failed to upload file: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import * as fs from 'fs';
+import * as path from 'path';
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+
+// Common MIME type mappings for file extensions
+const MIME_TYPES = {
+    '.pdf': 'application/pdf',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.txt': 'text/plain',
+    '.csv': 'text/csv',
+    '.json': 'application/json',
+    '.xml': 'application/xml',
+    '.html': 'text/html',
+    '.htm': 'text/html',
+    '.md': 'text/markdown',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.zip': 'application/zip',
+    '.gz': 'application/gzip',
+    '.tar': 'application/x-tar',
+};
+
+export function register(server) {
+    server.addTool({
+        name: 'uploadFile',
+        description:
+            'Uploads a local file from the filesystem to Google Drive. ' +
+            'Auto-detects MIME type from file extension. ' +
+            'Returns the uploaded file\'s Drive ID and URL.',
+        parameters: z.object({
+            localPath: z.string().describe('Absolute path to the local file to upload.'),
+            name: z
+                .string()
+                .optional()
+                .describe('Custom name for the file in Drive. If not provided, uses the local filename.'),
+            parentFolderId: z
+                .string()
+                .optional()
+                .describe('ID of the Drive folder to upload into. If not provided, uploads to the root of My Drive.'),
+            mimeType: z
+                .string()
+                .optional()
+                .describe('MIME type override. If not provided, auto-detected from file extension.'),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+
+            // Validate file exists
+            if (!fs.existsSync(args.localPath)) {
+                throw new UserError(`File not found: ${args.localPath}`);
+            }
+
+            const stats = fs.statSync(args.localPath);
+            if (!stats.isFile()) {
+                throw new UserError(`Path is not a file: ${args.localPath}`);
+            }
+
+            const fileName = args.name || path.basename(args.localPath);
+            const ext = path.extname(args.localPath).toLowerCase();
+            const mimeType = args.mimeType || MIME_TYPES[ext] || 'application/octet-stream';
+
+            log.info(`Uploading "${args.localPath}" as "${fileName}" (${mimeType}, ${stats.size} bytes)`);
+
+            try {
+                const fileMetadata = { name: fileName };
+                if (args.parentFolderId) {
+                    fileMetadata.parents = [args.parentFolderId];
+                }
+
+                const response = await drive.files.create({
+                    requestBody: fileMetadata,
+                    media: {
+                        mimeType,
+                        body: fs.createReadStream(args.localPath),
+                    },
+                    fields: 'id,name,webViewLink,mimeType,size',
+                    supportsAllDrives: true,
+                });
+
+                const file = response.data;
+                return JSON.stringify({
+                    id: file.id,
+                    name: file.name,
+                    url: file.webViewLink,
+                    mimeType: file.mimeType,
+                    size: file.size,
+                }, null, 2);
+            } catch (error) {
+                log.error(`Error uploading file: ${error.message || error}`);
+                if (error.code === 404)
+                    throw new UserError('Destination folder not found. Check the parentFolderId.');
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Make sure you have write access to the destination folder.');
+                throw new UserError(`Failed to upload file: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}

package/dist/tools/extras/index.js

@@ -1,9 +1,9 @@
-import { register as readFile } from './readFile.js';
-import { register as searchFileContents } from './searchFileContents.js';
-import { register as readDriveFile } from './readDriveFile.js';
-
-export function registerExtrasTools(server) {
-    readFile(server);
-    searchFileContents(server);
-    readDriveFile(server);
-}
+import { register as readFile } from './readFile.js';
+import { register as searchFileContents } from './searchFileContents.js';
+import { register as readDriveFile } from './readDriveFile.js';
+
+export function registerExtrasTools(server) {
+    readFile(server);
+    searchFileContents(server);
+    readDriveFile(server);
+}

package/dist/tools/extras/readDriveFile.js

@@ -1,54 +1,54 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient, getDocsClient, getSheetsClient } from '../../clients.js';
-import { docsJsonToMarkdown } from '../../markdown-transformer/index.js';
-import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
-import { extractText, downloadBuffer } from './readFile.js';
-import { trackRead } from '../../readTracker.js';
-
-// Google-native MIME types
-const GOOGLE_DOC = 'application/vnd.google-apps.document';
-const GOOGLE_SHEET = 'application/vnd.google-apps.spreadsheet';
-const GOOGLE_SLIDES = 'application/vnd.google-apps.presentation';
-
-// Capabilities by file type category
-const CAPABILITIES = {
-    googleDoc: {
-        fileType: 'Google Doc',
-        capabilities: ['read', 'readDocument', 'modifyText', 'replaceDocumentWithMarkdown', 'appendMarkdown', 'appendText', 'findAndReplace', 'deleteRange'],
-    },
-    googleSheet: {
-        fileType: 'Google Sheet',
-        capabilities: ['read', 'readSpreadsheet', 'writeSpreadsheet', 'appendRows', 'formatCells'],
-    },
-    docx: {
-        fileType: 'Word Document (.docx)',
-        capabilities: ['read'],
-        note: 'This is a Word document. Editing tools (modifyText, appendMarkdown, etc.) are not available unless converted to a Google Doc via copyFile or Drive UI.',
-    },
-    pdf: {
-        fileType: 'PDF',
-        capabilities: ['read'],
-        note: 'This is a PDF file. Editing tools are not available. Convert to a Google Doc first if editing is needed.',
-    },
-    other: {
-        fileType: 'Unknown',
-        capabilities: ['download'],
-        note: 'This file type cannot be read as text. Use downloadFile to download it.',
-    },
-};
-
-export function register(server) {
-    server.addTool({
-        name: 'readDriveFile',
-        description:
-            'Unified read tool: accepts any Google Drive file ID, auto-detects the file type (Google Doc, Sheet, Word .docx, PDF), ' +
-            'and routes to the appropriate reader. Returns content along with metadata about available capabilities. ' +
-            'Use this when you have a file ID but don\'t know the file type, or when readDocument fails with a 400 error.',
-        parameters: z.object({
-            fileId: z
-                .string()
-                .describe('The Google Drive file ID (the long string between /d/ and /edit in a Drive URL).'),
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient, getDocsClient, getSheetsClient } from '../../clients.js';
+import { docsJsonToMarkdown } from '../../markdown-transformer/index.js';
+import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
+import { extractText, downloadBuffer } from './readFile.js';
+import { trackRead } from '../../readTracker.js';
+
+// Google-native MIME types
+const GOOGLE_DOC = 'application/vnd.google-apps.document';
+const GOOGLE_SHEET = 'application/vnd.google-apps.spreadsheet';
+const GOOGLE_SLIDES = 'application/vnd.google-apps.presentation';
+
+// Capabilities by file type category
+const CAPABILITIES = {
+    googleDoc: {
+        fileType: 'Google Doc',
+        capabilities: ['read', 'readDocument', 'modifyText', 'replaceDocumentWithMarkdown', 'appendMarkdown', 'appendText', 'findAndReplace', 'deleteRange'],
+    },
+    googleSheet: {
+        fileType: 'Google Sheet',
+        capabilities: ['read', 'readSpreadsheet', 'writeSpreadsheet', 'appendRows', 'formatCells'],
+    },
+    docx: {
+        fileType: 'Word Document (.docx)',
+        capabilities: ['read'],
+        note: 'This is a Word document. Editing tools (modifyText, appendMarkdown, etc.) are not available unless converted to a Google Doc via copyFile or Drive UI.',
+    },
+    pdf: {
+        fileType: 'PDF',
+        capabilities: ['read'],
+        note: 'This is a PDF file. Editing tools are not available. Convert to a Google Doc first if editing is needed.',
+    },
+    other: {
+        fileType: 'Unknown',
+        capabilities: ['download'],
+        note: 'This file type cannot be read as text. Use downloadFile to download it.',
+    },
+};
+
+export function register(server) {
+    server.addTool({
+        name: 'readDriveFile',
+        description:
+            'Unified read tool: accepts any Google Drive file ID, auto-detects the file type (Google Doc, Sheet, Word .docx, PDF), ' +
+            'and routes to the appropriate reader. Returns content along with metadata about available capabilities. ' +
+            'Use this when you have a file ID but don\'t know the file type, or when readDocument fails with a 400 error.',
+        parameters: z.object({
+            fileId: z
+                .string()
+                .describe('The Google Drive file ID (the long string between /d/ and /edit in a Drive URL).'),
             format: z
                 .enum(['text', 'json', 'markdown'])
                 .optional()
@@ -62,150 +62,151 @@ export function register(server) {
             range: z
                 .string()
                 .optional()
-                .describe("A1 notation range for Google Sheets (e.g., 'Sheet1!A1:C10'). Required for spreadsheets."),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-
-            // 1. Get file metadata to determine type
-            let fileMeta;
-            try {
-                const res = await drive.files.get({
-                    fileId: args.fileId,
-                    fields: 'id,name,mimeType,modifiedTime,size',
-                    supportsAllDrives: true,
-                });
-                fileMeta = res.data;
-            } catch (error) {
-                if (error.code === 404) throw new UserError(`File not found: ${args.fileId}`);
-                if (error.code === 403) throw new UserError('Permission denied. Check that the file is shared with this account.');
-                throw new UserError(`Failed to get file info: ${error.message}`);
-            }
-
-            log.info(`File "${fileMeta.name}" is ${fileMeta.mimeType}`);
-            trackRead(args.fileId, fileMeta.modifiedTime);
-
-            // 2. Route based on MIME type
-            if (fileMeta.mimeType === GOOGLE_DOC) {
-                return await readGoogleDoc(args, fileMeta, log);
-            }
-
-            if (fileMeta.mimeType === GOOGLE_SHEET) {
-                return await readGoogleSheet(args, fileMeta, log);
-            }
-
-            // Try reading as docx/pdf
-            const text = await tryReadBinaryFile(drive, args.fileId, fileMeta, log);
-            if (text !== null) {
-                return text;
-            }
-
-            // Unsupported type
-            const capInfo = CAPABILITIES.other;
-            capInfo.fileType = fileMeta.mimeType;
-            return JSON.stringify({
-                file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
-                ...capInfo,
-                content: null,
-            }, null, 2);
-        },
-    });
-}
-
-async function readGoogleDoc(args, fileMeta, log) {
-    const docs = await getDocsClient();
-    const res = await docs.documents.get({
-        documentId: args.fileId,
-        fields: args.format === 'text' ? 'body(content(paragraph(elements(textRun(content)))))' : '*',
-    });
-
-    let content;
-    if (args.format === 'json') {
-        content = JSON.stringify(res.data, null, 2);
+                .describe("A1 notation range for Google Sheets (e.g., 'Sheet1!A1:C10'). Required for spreadsheets."),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+
+            // 1. Get file metadata to determine type
+            let fileMeta;
+            try {
+                const res = await drive.files.get({
+                    fileId: args.fileId,
+                    fields: 'id,name,mimeType,modifiedTime,size',
+                    supportsAllDrives: true,
+                });
+                fileMeta = res.data;
+            } catch (error) {
+                if (error.code === 404) throw new UserError(`File not found: ${args.fileId}`);
+                if (error.code === 403) throw new UserError('Permission denied. Check that the file is shared with this account.');
+                throw new UserError(`Failed to get file info: ${error.message}`);
+            }
+
+            log.info(`File "${fileMeta.name}" is ${fileMeta.mimeType}`);
+            trackRead(args.fileId, fileMeta.modifiedTime);
+
+            // 2. Route based on MIME type
+            if (fileMeta.mimeType === GOOGLE_DOC) {
+                return await readGoogleDoc(args, fileMeta, log);
+            }
+
+            if (fileMeta.mimeType === GOOGLE_SHEET) {
+                return await readGoogleSheet(args, fileMeta, log);
+            }
+
+            // Try reading as docx/pdf
+            const text = await tryReadBinaryFile(drive, args.fileId, fileMeta, log);
+            if (text !== null) {
+                return text;
+            }
+
+            // Unsupported type
+            const capInfo = CAPABILITIES.other;
+            capInfo.fileType = fileMeta.mimeType;
+            return JSON.stringify({
+                file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
+                ...capInfo,
+                content: null,
+            }, null, 2);
+        },
+    });
+}
+
+async function readGoogleDoc(args, fileMeta, log) {
+    const docs = await getDocsClient();
+    const res = await docs.documents.get({
+        documentId: args.fileId,
+        fields: args.format === 'text' ? 'revisionId,body(content(paragraph(elements(textRun(content)))))' : '*',
+    });
+
+    let content;
+    if (args.format === 'json') {
+        content = JSON.stringify(res.data, null, 2);
     } else if (args.format === 'markdown') {
         content = docsJsonToMarkdown(res.data, { plainMarkdown: args.plainMarkdown });
-    } else {
-        // text
-        let textContent = '';
-        res.data.body?.content?.forEach((element) => {
-            if (element.paragraph?.elements) {
-                element.paragraph.elements.forEach((pe) => {
-                    if (pe.textRun?.content) textContent += pe.textRun.content;
-                });
-            }
-            if (element.table?.tableRows) {
-                element.table.tableRows.forEach((row) => {
-                    row.tableCells?.forEach((cell) => {
-                        cell.content?.forEach((cellElement) => {
-                            cellElement.paragraph?.elements?.forEach((pe) => {
-                                if (pe.textRun?.content) textContent += pe.textRun.content;
-                            });
-                        });
-                    });
-                });
-            }
-        });
-        content = textContent || '(empty document)';
-    }
-
-    return JSON.stringify({
-        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
-        ...CAPABILITIES.googleDoc,
-        content,
-    }, null, 2);
-}
-
-async function readGoogleSheet(args, fileMeta, log) {
-    if (!args.range) {
-        // Return sheet info without data
-        const sheets = await getSheetsClient();
-        const info = await sheets.spreadsheets.get({
-            spreadsheetId: args.fileId,
-            fields: 'sheets(properties(sheetId,title,gridProperties))',
-        });
-        const sheetList = info.data.sheets?.map(s => ({
-            title: s.properties.title,
-            sheetId: s.properties.sheetId,
-            rows: s.properties.gridProperties?.rowCount,
-            cols: s.properties.gridProperties?.columnCount,
-        }));
-        return JSON.stringify({
-            file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
-            ...CAPABILITIES.googleSheet,
-            note: 'Provide a range parameter (e.g., "Sheet1!A1:C10") to read data. Available sheets listed below.',
-            sheets: sheetList,
-        }, null, 2);
-    }
-
-    const sheets = await getSheetsClient();
-    const response = await sheets.spreadsheets.values.get({
-        spreadsheetId: args.fileId,
-        range: args.range,
-    });
-    return JSON.stringify({
-        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
-        ...CAPABILITIES.googleSheet,
-        range: args.range,
-        values: response.data.values || [],
-    }, null, 2);
-}
-
-async function tryReadBinaryFile(drive, fileId, fileMeta, log) {
-    const { mimeType, name } = fileMeta;
-    const isDocxFile = mimeType === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' || name?.endsWith('.docx');
-    const isPdfFile = mimeType === 'application/pdf' || name?.endsWith('.pdf');
-
-    if (!isDocxFile && !isPdfFile) return null;
-
-    const buffer = await downloadBuffer(drive, fileId);
-    const text = await extractText(buffer, mimeType, name);
-
-    if (text === null) return null;
-
-    const capInfo = isDocxFile ? CAPABILITIES.docx : CAPABILITIES.pdf;
-    return JSON.stringify({
-        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
-        ...capInfo,
-        content: text,
-    }, null, 2);
-}
+    } else {
+        // text
+        let textContent = '';
+        res.data.body?.content?.forEach((element) => {
+            if (element.paragraph?.elements) {
+                element.paragraph.elements.forEach((pe) => {
+                    if (pe.textRun?.content) textContent += pe.textRun.content;
+                });
+            }
+            if (element.table?.tableRows) {
+                element.table.tableRows.forEach((row) => {
+                    row.tableCells?.forEach((cell) => {
+                        cell.content?.forEach((cellElement) => {
+                            cellElement.paragraph?.elements?.forEach((pe) => {
+                                if (pe.textRun?.content) textContent += pe.textRun.content;
+                            });
+                        });
+                    });
+                });
+            }
+        });
+        content = textContent || '(empty document)';
+    }
+
+    trackRead(args.fileId, fileMeta.modifiedTime, args.format === 'markdown' ? content : undefined, res.data.revisionId);
+    return JSON.stringify({
+        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
+        ...CAPABILITIES.googleDoc,
+        content,
+    }, null, 2);
+}
+
+async function readGoogleSheet(args, fileMeta, log) {
+    if (!args.range) {
+        // Return sheet info without data
+        const sheets = await getSheetsClient();
+        const info = await sheets.spreadsheets.get({
+            spreadsheetId: args.fileId,
+            fields: 'sheets(properties(sheetId,title,gridProperties))',
+        });
+        const sheetList = info.data.sheets?.map(s => ({
+            title: s.properties.title,
+            sheetId: s.properties.sheetId,
+            rows: s.properties.gridProperties?.rowCount,
+            cols: s.properties.gridProperties?.columnCount,
+        }));
+        return JSON.stringify({
+            file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
+            ...CAPABILITIES.googleSheet,
+            note: 'Provide a range parameter (e.g., "Sheet1!A1:C10") to read data. Available sheets listed below.',
+            sheets: sheetList,
+        }, null, 2);
+    }
+
+    const sheets = await getSheetsClient();
+    const response = await sheets.spreadsheets.values.get({
+        spreadsheetId: args.fileId,
+        range: args.range,
+    });
+    return JSON.stringify({
+        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
+        ...CAPABILITIES.googleSheet,
+        range: args.range,
+        values: response.data.values || [],
+    }, null, 2);
+}
+
+async function tryReadBinaryFile(drive, fileId, fileMeta, log) {
+    const { mimeType, name } = fileMeta;
+    const isDocxFile = mimeType === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' || name?.endsWith('.docx');
+    const isPdfFile = mimeType === 'application/pdf' || name?.endsWith('.pdf');
+
+    if (!isDocxFile && !isPdfFile) return null;
+
+    const buffer = await downloadBuffer(drive, fileId);
+    const text = await extractText(buffer, mimeType, name);
+
+    if (text === null) return null;
+
+    const capInfo = isDocxFile ? CAPABILITIES.docx : CAPABILITIES.pdf;
+    return JSON.stringify({
+        file: { id: fileMeta.id, name: fileMeta.name, mimeType: fileMeta.mimeType },
+        ...capInfo,
+        content: text,
+    }, null, 2);
+}