@mcp-z/mcp-drive 1.0.0

package/dist/esm/mcp/resources/file.js

@@ -0,0 +1,77 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { google } from 'googleapis';
+export default function createResource() {
+    const template = new ResourceTemplate('drive://files/{fileId}', {
+        list: undefined
+    });
+    const config = {
+        description: 'Drive file resource',
+        mimeType: 'application/json'
+    };
+    const handler = async (uri, variables, extra)=>{
+        // Extract fileId and handle both string and string[] cases
+        const fileId = Array.isArray(variables.fileId) ? variables.fileId[0] : variables.fileId;
+        try {
+            var _logger_debug;
+            // Validate fileId exists and is a string
+            if (!fileId || typeof fileId !== 'string') {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                error: 'Missing or invalid fileId in resource URI'
+                            })
+                        }
+                    ]
+                };
+            }
+            // Safe type guard to access middleware-enriched extra
+            const { logger, authContext } = extra;
+            const drive = google.drive({
+                version: 'v3',
+                auth: authContext.auth
+            });
+            const resp = await drive.files.get({
+                fileId,
+                fields: 'id,name,mimeType,size,modifiedTime,owners,webViewLink'
+            });
+            const data = resp.data;
+            (_logger_debug = logger.debug) === null || _logger_debug === void 0 ? void 0 : _logger_debug.call(logger, {
+                fileId,
+                fileName: data === null || data === void 0 ? void 0 : data.name
+            }, 'drive-file resource fetch success');
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data || {})
+                    }
+                ]
+            };
+        } catch (error) {
+            var _logger_debug1;
+            const { logger } = extra;
+            (_logger_debug1 = logger.debug) === null || _logger_debug1 === void 0 ? void 0 : _logger_debug1.call(logger, error, 'drive resource fetch failed');
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            error: error.message
+                        })
+                    }
+                ]
+            };
+        }
+    };
+    return {
+        name: 'file',
+        template,
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/resources/file.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/resources/file.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\n\nexport default function createResource() {\n  const template = new ResourceTemplate('drive://files/{fileId}', {\n    list: undefined,\n  });\n  const config: ResourceConfig = {\n    description: 'Drive file resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult> => {\n    // Extract fileId and handle both string and string[] cases\n    const fileId = Array.isArray(variables.fileId) ? variables.fileId[0] : variables.fileId;\n\n    try {\n      // Validate fileId exists and is a string\n      if (!fileId || typeof fileId !== 'string') {\n        return {\n          contents: [\n            {\n              uri: uri.href,\n              mimeType: 'application/json',\n              text: JSON.stringify({\n                error: 'Missing or invalid fileId in resource URI',\n              }),\n            },\n          ],\n        };\n      }\n\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const drive = google.drive({ version: 'v3', auth: authContext.auth });\n      const resp = await drive.files.get({\n        fileId,\n        fields: 'id,name,mimeType,size,modifiedTime,owners,webViewLink',\n      });\n      const data = resp.data;\n      logger.debug?.({ fileId, fileName: data?.name }, 'drive-file resource fetch success');\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify(data || {}),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.debug?.(error as Record<string, unknown>, 'drive resource fetch failed');\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: (error as Error).message }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'file',\n    template,\n    config,\n    handler,\n  } satisfies ResourceModule;\n}\n"],"names":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","fileId","Array","isArray","logger","contents","href","text","JSON","stringify","error","authContext","drive","version","auth","resp","files","get","fields","data","debug","fileName","name","message"],"mappings":"AAEA,SAASA,gBAAgB,QAAQ,0CAA0C;AAG3E,SAASC,MAAM,QAAQ,aAAa;AAEpC,eAAe,SAASC;IACtB,MAAMC,WAAW,IAAIH,iBAAiB,0BAA0B;QAC9DI,MAAMC;IACR;IACA,MAAMC,SAAyB;QAC7BC,aAAa;QACbC,UAAU;IACZ;IAEA,MAAMC,UAAU,OAAOC,KAAUC,WAA8CC;QAC7E,2DAA2D;QAC3D,MAAMC,SAASC,MAAMC,OAAO,CAACJ,UAAUE,MAAM,IAAIF,UAAUE,MAAM,CAAC,EAAE,GAAGF,UAAUE,MAAM;QAEvF,IAAI;gBAwBFG;YAvBA,yCAAyC;YACzC,IAAI,CAACH,UAAU,OAAOA,WAAW,UAAU;gBACzC,OAAO;oBACLI,UAAU;wBACR;4BACEP,KAAKA,IAAIQ,IAAI;4BACbV,UAAU;4BACVW,MAAMC,KAAKC,SAAS,CAAC;gCACnBC,OAAO;4BACT;wBACF;qBACD;gBACH;YACF;YAEA,sDAAsD;YACtD,MAAM,EAAEN,MAAM,EAAEO,WAAW,EAAE,GAAGX;YAChC,MAAMY,QAAQvB,OAAOuB,KAAK,CAAC;gBAAEC,SAAS;gBAAMC,MAAMH,YAAYG,IAAI;YAAC;YACnE,MAAMC,OAAO,MAAMH,MAAMI,KAAK,CAACC,GAAG,CAAC;gBACjChB;gBACAiB,QAAQ;YACV;YACA,MAAMC,OAAOJ,KAAKI,IAAI;aACtBf,gBAAAA,OAAOgB,KAAK,cAAZhB,oCAAAA,mBAAAA,QAAe;gBAAEH;gBAAQoB,QAAQ,EAAEF,iBAAAA,2BAAAA,KAAMG,IAAI;YAAC,GAAG;YACjD,OAAO;gBACLjB,UAAU;oBACR;wBACEP,KAAKA,IAAIQ,IAAI;wBACbV,UAAU;wBACVW,MAAMC,KAAKC,SAAS,CAACU,QAAQ,CAAC;oBAChC;iBACD;YACH;QACF,EAAE,OAAOT,OAAO;gBAEdN;YADA,MAAM,EAAEA,MAAM,EAAE,GAAGJ;aACnBI,iBAAAA,OAAOgB,KAAK,cAAZhB,qCAAAA,oBAAAA,QAAeM,OAAkC;YACjD,OAAO;gBACLL,UAAU;oBACR;wBACEP,KAAKA,IAAIQ,IAAI;wBACbV,UAAU;wBACVW,MAAMC,KAAKC,SAAS,CAAC;4BAAEC,OAAO,AAACA,MAAgBa,OAAO;wBAAC;oBACzD;iBACD;YACH;QACF;IACF;IAEA,OAAO;QACLD,MAAM;QACN/B;QACAG;QACAG;IACF;AACF"}

package/dist/esm/mcp/resources/index.d.ts

@@ -0,0 +1 @@
+export { default as file } from './file.js';

package/dist/esm/mcp/resources/index.js

@@ -0,0 +1 @@
+export { default as file } from './file.js';

package/dist/esm/mcp/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/resources/index.ts"],"sourcesContent":["export { default as file } from './file.js';\n"],"names":["default","file"],"mappings":"AAAA,SAASA,WAAWC,IAAI,QAAQ,YAAY"}

package/dist/esm/mcp/tools/file-move-to-trash.d.ts

@@ -0,0 +1,59 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    operationSummary: z.ZodString;
+    totalCount: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    recoverable: z.ZodBoolean;
+    recoverableDays: z.ZodNumber;
+    failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ ids }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: "file-move-to-trash";
+    config: {
+        readonly title: "Move Files to Trash";
+        readonly description: "Move files to trash (recoverable for 30 days).";
+        readonly inputSchema: z.ZodObject<{
+            ids: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                operationSummary: z.ZodString;
+                totalCount: z.ZodNumber;
+                successCount: z.ZodNumber;
+                failureCount: z.ZodNumber;
+                recoverable: z.ZodBoolean;
+                recoverableDays: z.ZodNumber;
+                failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/file-move-to-trash.js

@@ -0,0 +1,118 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+const MAX_BATCH_SIZE = 1000;
+const inputSchema = z.object({
+    ids: z.array(z.string().min(1)).min(1).max(MAX_BATCH_SIZE).describe('File IDs to soft delete (move to trash)')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Human-readable summary of the operation'),
+    totalCount: z.number().describe('Total number of files requested to trash'),
+    successCount: z.number().describe('Number of files successfully moved to trash'),
+    failureCount: z.number().describe('Number of files that failed to move'),
+    recoverable: z.boolean().describe('Whether trashed files can be restored'),
+    recoverableDays: z.number().describe('Days until permanent deletion'),
+    failures: z.array(z.object({
+        id: z.string().describe('ID of the file that failed'),
+        error: z.string().describe('Error message explaining the failure')
+    })).optional().describe('Details of any files that failed to trash')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    title: 'Move Files to Trash',
+    description: 'Move files to trash (recoverable for 30 days).',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ ids }, extra) {
+    const logger = extra.logger;
+    logger.info('drive.file.moveToTrash called', {
+        count: ids.length
+    });
+    try {
+        const drive = google.drive({
+            version: 'v3',
+            auth: extra.authContext.auth
+        });
+        const results = await Promise.allSettled(ids.map(async (id)=>{
+            await drive.files.update({
+                fileId: id,
+                requestBody: {
+                    trashed: true
+                }
+            });
+            return id;
+        }));
+        // Separate successes and failures
+        const failures = [];
+        results.forEach((result, index)=>{
+            const id = ids[index];
+            if (!id) return;
+            if (result.status === 'rejected') {
+                const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                failures.push({
+                    id,
+                    error: errorMessage
+                });
+            }
+        });
+        const successCount = ids.length - failures.length;
+        const failureCount = failures.length;
+        const totalCount = ids.length;
+        logger.info('drive.file.moveToTrash completed', {
+            totalCount,
+            successCount,
+            failureCount
+        });
+        const operationSummary = failureCount === 0 ? `Moved ${successCount} file${successCount === 1 ? '' : 's'} to trash (recoverable for 30 days)` : `Moved ${successCount} of ${totalCount} file${totalCount === 1 ? '' : 's'} to trash (${failureCount} failed, recoverable for 30 days)`;
+        const result = {
+            type: 'success',
+            operationSummary,
+            totalCount,
+            successCount,
+            failureCount,
+            recoverable: true,
+            recoverableDays: 30,
+            ...failures.length > 0 && {
+                failures
+            }
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('drive.file.moveToTrash error', {
+            error: message
+        });
+        // Throw McpError
+        throw new McpError(ErrorCode.InternalError, `Error moving files to trash: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'file-move-to-trash',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/file-move-to-trash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/file-move-to-trash.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\n\nconst MAX_BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  ids: z.array(z.string().min(1)).min(1).max(MAX_BATCH_SIZE).describe('File IDs to soft delete (move to trash)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Human-readable summary of the operation'),\n  totalCount: z.number().describe('Total number of files requested to trash'),\n  successCount: z.number().describe('Number of files successfully moved to trash'),\n  failureCount: z.number().describe('Number of files that failed to move'),\n  recoverable: z.boolean().describe('Whether trashed files can be restored'),\n  recoverableDays: z.number().describe('Days until permanent deletion'),\n  failures: z\n    .array(\n      z.object({\n        id: z.string().describe('ID of the file that failed'),\n        error: z.string().describe('Error message explaining the failure'),\n      })\n    )\n    .optional()\n    .describe('Details of any files that failed to trash'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  title: 'Move Files to Trash',\n  description: 'Move files to trash (recoverable for 30 days).',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ ids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('drive.file.moveToTrash called', { count: ids.length });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    const results = await Promise.allSettled(\n      ids.map(async (id) => {\n        await drive.files.update({\n          fileId: id,\n          requestBody: { trashed: true },\n        });\n        return id;\n      })\n    );\n\n    // Separate successes and failures\n    const failures: Array<{ id: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const id = ids[index];\n      if (!id) return;\n\n      if (result.status === 'rejected') {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ id, error: errorMessage });\n      }\n    });\n\n    const successCount = ids.length - failures.length;\n    const failureCount = failures.length;\n    const totalCount = ids.length;\n\n    logger.info('drive.file.moveToTrash completed', {\n      totalCount,\n      successCount,\n      failureCount,\n    });\n\n    const operationSummary = failureCount === 0 ? `Moved ${successCount} file${successCount === 1 ? '' : 's'} to trash (recoverable for 30 days)` : `Moved ${successCount} of ${totalCount} file${totalCount === 1 ? '' : 's'} to trash (${failureCount} failed, recoverable for 30 days)`;\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary,\n      totalCount,\n      successCount,\n      failureCount,\n      recoverable: true,\n      recoverableDays: 30,\n      ...(failures.length > 0 && { failures }),\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('drive.file.moveToTrash error', { error: message });\n\n    // Throw McpError\n    throw new McpError(ErrorCode.InternalError, `Error moving files to trash: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'file-move-to-trash' as const,\n    config,\n    handler,\n  };\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","MAX_BATCH_SIZE","inputSchema","object","ids","array","string","min","max","describe","successBranchSchema","type","literal","operationSummary","totalCount","number","successCount","failureCount","recoverable","boolean","recoverableDays","failures","id","error","optional","outputSchema","discriminatedUnion","config","title","description","result","handler","extra","logger","info","count","length","drive","version","auth","authContext","results","Promise","allSettled","map","files","update","fileId","requestBody","trashed","forEach","index","status","errorMessage","reason","Error","message","String","push","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/file-move.d.ts

@@ -0,0 +1,73 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    fileIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    destinationFolderId: z.ZodString;
+    returnOldParents: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    moved: z.ZodArray<z.ZodObject<{
+        fileId: z.ZodString;
+        fileName: z.ZodString;
+        oldParents: z.ZodArray<z.ZodString>;
+        newParent: z.ZodString;
+        webViewLink: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    failed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        fileId: z.ZodString;
+        error: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    totalRequested: z.ZodNumber;
+    totalMoved: z.ZodNumber;
+    totalFailed: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ fileIds, destinationFolderId, returnOldParents }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: "file-move";
+    config: {
+        readonly title: "Move Files";
+        readonly description: "Move files/folders to destination folder. Returns oldParents for undo. Use \"root\" for My Drive root.";
+        readonly inputSchema: z.ZodObject<{
+            fileIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            destinationFolderId: z.ZodString;
+            returnOldParents: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                moved: z.ZodArray<z.ZodObject<{
+                    fileId: z.ZodString;
+                    fileName: z.ZodString;
+                    oldParents: z.ZodArray<z.ZodString>;
+                    newParent: z.ZodString;
+                    webViewLink: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                failed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    fileId: z.ZodString;
+                    error: z.ZodString;
+                    code: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+                totalRequested: z.ZodNumber;
+                totalMoved: z.ZodNumber;
+                totalFailed: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/file-move.js

@@ -0,0 +1,274 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+function isDriveApiError(error) {
+    return typeof error === 'object' && error !== null && ('message' in error || 'code' in error);
+}
+const inputSchema = z.object({
+    fileIds: z.union([
+        z.string().min(1),
+        z.array(z.string().min(1)).min(1).max(100)
+    ]).describe('File or folder ID(s) to move. Single ID or array (max 100 for batch)'),
+    destinationFolderId: z.string().min(1).describe('Destination folder ID (use "root" for My Drive root)'),
+    returnOldParents: z.boolean().optional().describe('Include old parent IDs in response for manual undo (recommended: true)')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    moved: z.array(z.object({
+        fileId: z.string().describe('ID of the moved file'),
+        fileName: z.string().describe('Name of the moved file'),
+        oldParents: z.array(z.string()).describe('Previous parent folder IDs (for undo)'),
+        newParent: z.string().describe('New parent folder ID'),
+        webViewLink: z.string().optional().describe('URL to view the file')
+    })).describe('Successfully moved files'),
+    failed: z.array(z.object({
+        fileId: z.string().describe('ID of the file that failed to move'),
+        error: z.string().describe('Error message explaining the failure'),
+        code: z.string().optional().describe('API error code if available')
+    })).optional().describe('Files that failed to move'),
+    totalRequested: z.number().describe('Total number of files requested to move'),
+    totalMoved: z.number().describe('Number of files successfully moved'),
+    totalFailed: z.number().describe('Number of files that failed to move')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    title: 'Move Files',
+    description: 'Move files/folders to destination folder. Returns oldParents for undo. Use "root" for My Drive root.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+/**
+ * Move a single file to a new parent folder
+ */ async function moveSingleFile(drive, fileId, destinationFolderId, returnOldParents, logger) {
+    try {
+        // Get current file metadata to get old parents
+        const fileMetadata = await drive.files.get({
+            fileId: fileId,
+            fields: 'id,name,parents,webViewLink'
+        });
+        const oldParents = fileMetadata.data.parents || [];
+        const fileName = fileMetadata.data.name || fileId;
+        const webViewLink = fileMetadata.data.webViewLink;
+        // Move file using addParents and removeParents
+        await drive.files.update({
+            fileId: fileId,
+            addParents: destinationFolderId,
+            removeParents: oldParents.join(','),
+            fields: 'id,name,parents,webViewLink'
+        });
+        const result = {
+            fileId: fileId,
+            fileName: fileName,
+            oldParents: returnOldParents ? oldParents : [],
+            newParent: destinationFolderId,
+            ...webViewLink && {
+                webViewLink
+            }
+        };
+        return {
+            success: true,
+            result
+        };
+    } catch (e) {
+        const errorMessage = isDriveApiError(e) && e.message ? e.message : 'Unknown error';
+        const errorCode = isDriveApiError(e) && e.code ? String(e.code) : undefined;
+        logger.info('Failed to move file', {
+            fileId,
+            error: errorMessage
+        });
+        return {
+            success: false,
+            error: {
+                fileId: fileId,
+                error: errorMessage,
+                ...errorCode && {
+                    code: errorCode
+                }
+            }
+        };
+    }
+}
+/**
+ * Move multiple files using batch requests
+ */ async function moveBatchFiles(drive, fileIds, destinationFolderId, returnOldParents, _logger) {
+    const moved = [];
+    const failed = [];
+    // First, fetch metadata for all files in batch
+    const metadataResults = await Promise.allSettled(fileIds.map(async (fileId)=>{
+        try {
+            const response = await drive.files.get({
+                fileId: fileId,
+                fields: 'id,name,parents,webViewLink'
+            });
+            const webViewLink = response.data.webViewLink;
+            return {
+                fileId: fileId,
+                name: response.data.name || fileId,
+                parents: response.data.parents || [],
+                ...webViewLink && {
+                    webViewLink
+                }
+            };
+        } catch (e) {
+            const message = isDriveApiError(e) && e.message ? e.message : String(e);
+            throw new Error(`Failed to fetch metadata: ${message}`);
+        }
+    }));
+    // Process metadata results
+    const filesToMove = [];
+    for(let i = 0; i < metadataResults.length; i++){
+        const result = metadataResults[i];
+        if (result && result.status === 'fulfilled') {
+            filesToMove.push(result.value);
+        } else if (result && result.status === 'rejected') {
+            const fileId = fileIds[i];
+            if (fileId) {
+                var _result_reason, _result_reason1;
+                const errorCode = ((_result_reason = result.reason) === null || _result_reason === void 0 ? void 0 : _result_reason.code) ? String(result.reason.code) : undefined;
+                failed.push({
+                    fileId: fileId,
+                    error: ((_result_reason1 = result.reason) === null || _result_reason1 === void 0 ? void 0 : _result_reason1.message) || 'Failed to fetch file metadata',
+                    ...errorCode && {
+                        code: errorCode
+                    }
+                });
+            }
+        }
+    }
+    // Now move files in batch
+    const moveResults = await Promise.allSettled(filesToMove.map(async (file)=>{
+        try {
+            await drive.files.update({
+                fileId: file.fileId,
+                addParents: destinationFolderId,
+                removeParents: file.parents.join(','),
+                fields: 'id'
+            });
+            return {
+                fileId: file.fileId,
+                fileName: file.name,
+                oldParents: returnOldParents ? file.parents : [],
+                newParent: destinationFolderId,
+                ...file.webViewLink && {
+                    webViewLink: file.webViewLink
+                }
+            };
+        } catch (e) {
+            const message = isDriveApiError(e) && e.message ? e.message : String(e);
+            throw new Error(`Failed to move: ${message}`);
+        }
+    }));
+    // Process move results
+    for(let i = 0; i < moveResults.length; i++){
+        const result = moveResults[i];
+        if (result && result.status === 'fulfilled') {
+            moved.push(result.value);
+        } else if (result && result.status === 'rejected') {
+            const file = filesToMove[i];
+            if (file) {
+                var _result_reason2, _result_reason3;
+                const errorCode = ((_result_reason2 = result.reason) === null || _result_reason2 === void 0 ? void 0 : _result_reason2.code) ? String(result.reason.code) : undefined;
+                failed.push({
+                    fileId: file.fileId,
+                    error: ((_result_reason3 = result.reason) === null || _result_reason3 === void 0 ? void 0 : _result_reason3.message) || 'Failed to move file',
+                    ...errorCode && {
+                        code: errorCode
+                    }
+                });
+            }
+        }
+    }
+    return {
+        moved,
+        failed
+    };
+}
+async function handler({ fileIds, destinationFolderId, returnOldParents = true }, extra) {
+    const logger = extra.logger;
+    const isBatch = Array.isArray(fileIds);
+    const fileIdArray = Array.isArray(fileIds) ? fileIds : [
+        fileIds
+    ];
+    logger.info('drive.file.move called', {
+        fileCount: fileIdArray.length,
+        isBatch,
+        destinationFolderId,
+        returnOldParents
+    });
+    try {
+        const drive = google.drive({
+            version: 'v3',
+            auth: extra.authContext.auth
+        });
+        let moved = [];
+        let failed = [];
+        if (isBatch && fileIdArray.length > 1) {
+            // Use batch API for multiple files
+            const batchResult = await moveBatchFiles(drive, fileIdArray, destinationFolderId, returnOldParents, logger);
+            moved = batchResult.moved;
+            failed = batchResult.failed;
+        } else {
+            // Single file operation
+            const fileId = fileIdArray[0];
+            if (fileId) {
+                const singleResult = await moveSingleFile(drive, fileId, destinationFolderId, returnOldParents, logger);
+                if (singleResult.success && singleResult.result) {
+                    moved.push(singleResult.result);
+                } else if (singleResult.error) {
+                    failed.push(singleResult.error);
+                }
+            }
+        }
+        logger.info('drive.file.move returning', {
+            totalRequested: fileIdArray.length,
+            totalMoved: moved.length,
+            totalFailed: failed.length
+        });
+        const result = {
+            type: 'success',
+            moved,
+            ...failed.length > 0 && {
+                failed
+            },
+            totalRequested: fileIdArray.length,
+            totalMoved: moved.length,
+            totalFailed: failed.length
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('drive.file.move error', {
+            error: message
+        });
+        // Throw McpError
+        throw new McpError(ErrorCode.InternalError, `Error moving files: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'file-move',
+        config,
+        handler
+    };
+}