@mcp-z/mcp-drive 1.0.0

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

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

package/dist/esm/mcp/tools/files-search.d.ts

@@ -0,0 +1,135 @@
+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<{
+    shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        objects: "objects";
+        arrays: "arrays";
+    }>>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    query: z.ZodUnion<readonly [z.ZodString, z.ZodType<import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown, z.core.$ZodTypeInternals<import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown>>]>;
+    fields: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"objects">;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        webViewLink: z.ZodOptional<z.ZodString>;
+        webContentLink: z.ZodOptional<z.ZodString>;
+        modifiedTime: z.ZodOptional<z.ZodString>;
+        createdTime: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        shared: z.ZodOptional<z.ZodBoolean>;
+        starred: z.ZodOptional<z.ZodBoolean>;
+        trashed: z.ZodOptional<z.ZodBoolean>;
+        parents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        owners: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            emailAddress: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            me: z.ZodOptional<z.ZodBoolean>;
+            permissionId: z.ZodOptional<z.ZodString>;
+            photoLink: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        permissions: z.ZodOptional<z.ZodObject<{
+            canEdit: z.ZodOptional<z.ZodBoolean>;
+            canComment: z.ZodOptional<z.ZodBoolean>;
+            canShare: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"arrays">;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+    count: z.ZodNumber;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ query, pageSize, pageToken, fields, shape }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: "files-search";
+    config: {
+        readonly title: "Search Drive Files";
+        readonly description: "Search Google Drive files with flexible field selection for optimal performance.";
+        readonly inputSchema: z.ZodObject<{
+            shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                objects: "objects";
+                arrays: "arrays";
+            }>>>;
+            pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            pageToken: z.ZodOptional<z.ZodString>;
+            query: z.ZodUnion<readonly [z.ZodString, z.ZodType<import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown, z.core.$ZodTypeInternals<import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown>>]>;
+            fields: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"objects">;
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    webViewLink: z.ZodOptional<z.ZodString>;
+                    webContentLink: z.ZodOptional<z.ZodString>;
+                    modifiedTime: z.ZodOptional<z.ZodString>;
+                    createdTime: z.ZodOptional<z.ZodString>;
+                    size: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodString>;
+                    shared: z.ZodOptional<z.ZodBoolean>;
+                    starred: z.ZodOptional<z.ZodBoolean>;
+                    trashed: z.ZodOptional<z.ZodBoolean>;
+                    parents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>>>;
+                    owners: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        displayName: z.ZodOptional<z.ZodString>;
+                        emailAddress: z.ZodOptional<z.ZodString>;
+                        kind: z.ZodOptional<z.ZodString>;
+                        me: z.ZodOptional<z.ZodBoolean>;
+                        permissionId: z.ZodOptional<z.ZodString>;
+                        photoLink: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    permissions: z.ZodOptional<z.ZodObject<{
+                        canEdit: z.ZodOptional<z.ZodBoolean>;
+                        canComment: z.ZodOptional<z.ZodBoolean>;
+                        canShare: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                count: z.ZodNumber;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"arrays">;
+                columns: z.ZodArray<z.ZodString>;
+                rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+                count: z.ZodNumber;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/files-search.js

@@ -0,0 +1,254 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { toDriveQuery } from '../../lib/query-builder.js';
+import { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, DriveFileSchema, DriveQuerySchema } from '../../schemas/index.js';
+const inputSchema = z.object({
+    query: DriveQuerySchema.describe('Drive query object with structured search fields. See DriveQuerySchema for detailed query syntax and examples.'),
+    fields: createFieldsSchema({
+        availableFields: DRIVE_FILE_FIELDS,
+        fieldDescriptions: DRIVE_FILE_FIELD_DESCRIPTIONS,
+        commonPatterns: DRIVE_FILE_COMMON_PATTERNS,
+        resourceName: 'Drive file'
+    }),
+    ...createPaginationSchema({
+        defaultPageSize: 50,
+        maxPageSize: 1000,
+        provider: 'drive'
+    }).shape,
+    shape: createShapeSchema()
+});
+// Success branch schemas for different shapes
+const successObjectsBranchSchema = z.object({
+    type: z.literal('success'),
+    shape: z.literal('objects'),
+    items: z.array(DriveFileSchema).describe('Matching Drive files'),
+    count: z.number().describe('Number of files in this page'),
+    nextPageToken: z.string().optional().describe('Token for fetching next page of results')
+});
+const successArraysBranchSchema = z.object({
+    type: z.literal('success'),
+    shape: z.literal('arrays'),
+    columns: z.array(z.string()).describe('Column names in canonical order'),
+    rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),
+    count: z.number().describe('Number of files in this page'),
+    nextPageToken: z.string().optional().describe('Token for fetching next page of results')
+});
+// Output schema with auth_required support
+// Using z.union instead of discriminatedUnion since we have two success branches with different shapes
+const outputSchema = z.union([
+    successObjectsBranchSchema,
+    successArraysBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    title: 'Search Drive Files',
+    description: 'Search Google Drive files with flexible field selection for optimal performance.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ query, pageSize = 50, pageToken, fields, shape = 'arrays' }, extra) {
+    const logger = extra.logger;
+    const requestedFields = parseFields(fields, DRIVE_FILE_FIELDS);
+    // Validate and clamp pageSize to Google Drive API limits (1-1000)
+    const validPageSize = Math.max(1, Math.min(1000, Math.floor(pageSize || 50)));
+    logger.info('drive.files-search called', {
+        query,
+        pageSize: validPageSize,
+        pageToken: pageToken ? '[provided]' : undefined,
+        fields: fields || 'all'
+    });
+    try {
+        const drive = google.drive({
+            version: 'v3',
+            auth: extra.authContext.auth
+        });
+        // Handle query parameter
+        let qStr;
+        if (typeof query === 'string') {
+            // String query - treat as raw Drive query
+            qStr = `(${query}) and trashed = false`;
+        } else if (query && typeof query === 'object' && 'rawDriveQuery' in query && query.rawDriveQuery) {
+            // Object with rawDriveQuery field - use it directly
+            qStr = `(${query.rawDriveQuery}) and trashed = false`;
+        } else {
+            // Structured query object - convert to Drive query string
+            const { q } = toDriveQuery(query);
+            qStr = q ? `(${q}) and trashed = false` : 'trashed = false';
+        }
+        const listOptions = {
+            q: qStr,
+            pageSize: validPageSize,
+            fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',
+            orderBy: 'modifiedTime desc'
+        };
+        if (pageToken && pageToken.trim().length > 0) {
+            listOptions.pageToken = pageToken;
+        }
+        const response = await drive.files.list(listOptions);
+        const res = response.data;
+        const files = Array.isArray(res === null || res === void 0 ? void 0 : res.files) ? res.files : [];
+        const parentIds = new Set();
+        for (const f of files){
+            if ((f === null || f === void 0 ? void 0 : f.parents) && f.parents.length > 0) {
+                for (const parentId of f.parents){
+                    if (parentId && parentId !== 'root') {
+                        parentIds.add(parentId);
+                    }
+                }
+            }
+        }
+        const parentNameMap = new Map();
+        if (parentIds.size > 0) {
+            logger.info('Fetching parent names', {
+                count: parentIds.size
+            });
+            const parentFetches = Array.from(parentIds).map(async (parentId)=>{
+                try {
+                    const parentRes = await drive.files.get({
+                        fileId: parentId,
+                        fields: 'id,name'
+                    });
+                    const parentName = parentRes.data.name || parentId;
+                    parentNameMap.set(parentId, parentName);
+                } catch (e) {
+                    logger.info('Failed to fetch parent name', {
+                        parentId,
+                        error: e
+                    });
+                    parentNameMap.set(parentId, parentId); // Fallback to ID
+                }
+            });
+            await Promise.all(parentFetches);
+        }
+        const items = files.map((f)=>{
+            const id = (f === null || f === void 0 ? void 0 : f.id) ? String(f.id) : 'unknown';
+            const name = (f === null || f === void 0 ? void 0 : f.name) || id;
+            const result = {
+                id,
+                name
+            };
+            // Only include properties that have actual values
+            if (f === null || f === void 0 ? void 0 : f.mimeType) result.mimeType = f.mimeType;
+            if (f === null || f === void 0 ? void 0 : f.webViewLink) result.webViewLink = f.webViewLink;
+            if (f === null || f === void 0 ? void 0 : f.modifiedTime) result.modifiedTime = f.modifiedTime;
+            if ((f === null || f === void 0 ? void 0 : f.parents) && f.parents.length > 0) {
+                result.parents = f.parents.map((parentId)=>{
+                    if (parentId === 'root') {
+                        return {
+                            id: 'root',
+                            name: 'My Drive'
+                        };
+                    }
+                    const parentName = parentNameMap.get(parentId) || parentId;
+                    return {
+                        id: parentId,
+                        name: parentName
+                    };
+                });
+            }
+            if ((f === null || f === void 0 ? void 0 : f.shared) != null) result.shared = f.shared;
+            if ((f === null || f === void 0 ? void 0 : f.starred) != null) result.starred = f.starred;
+            if ((f === null || f === void 0 ? void 0 : f.owners) && f.owners.length > 0) {
+                result.owners = f.owners.map((o)=>{
+                    const owner = {};
+                    if (o === null || o === void 0 ? void 0 : o.displayName) owner.displayName = o.displayName;
+                    if (o === null || o === void 0 ? void 0 : o.emailAddress) owner.emailAddress = o.emailAddress;
+                    if (o === null || o === void 0 ? void 0 : o.kind) owner.kind = o.kind;
+                    if ((o === null || o === void 0 ? void 0 : o.me) != null) owner.me = o.me;
+                    if (o === null || o === void 0 ? void 0 : o.permissionId) owner.permissionId = o.permissionId;
+                    if (o === null || o === void 0 ? void 0 : o.photoLink) owner.photoLink = o.photoLink;
+                    return owner;
+                });
+            }
+            return result;
+        });
+        const filteredItems = items.map((item)=>filterFields(item, requestedFields));
+        logger.info('drive.files-search returning', {
+            query,
+            pageSize,
+            resultCount: filteredItems.length,
+            fields: fields || 'all'
+        });
+        const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;
+        // Build result based on shape
+        const result = shape === 'arrays' ? {
+            type: 'success',
+            shape: 'arrays',
+            ...toColumnarFormat(filteredItems, requestedFields, DRIVE_FILE_FIELDS),
+            count: filteredItems.length,
+            ...nextPageToken && {
+                nextPageToken
+            }
+        } : {
+            type: 'success',
+            shape: 'objects',
+            items: filteredItems,
+            count: filteredItems.length,
+            ...nextPageToken && {
+                nextPageToken
+            }
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('drive.files-search error', {
+            error: message
+        });
+        // Check if this is a Drive API validation error (invalid query, invalid pageToken, etc.)
+        // These should return empty results rather than throw
+        const isDriveValidationError = message.includes('Invalid Value') || message.includes('Invalid value') || message.includes('File not found') || message.includes('Bad Request');
+        if (isDriveValidationError) {
+            // Return empty result set for validation errors
+            const result = shape === 'arrays' ? {
+                type: 'success',
+                shape: 'arrays',
+                columns: [],
+                rows: [],
+                count: 0
+            } : {
+                type: 'success',
+                shape: 'objects',
+                items: [],
+                count: 0
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result)
+                    }
+                ],
+                structuredContent: {
+                    result
+                }
+            };
+        }
+        // Throw McpError for other errors
+        throw new McpError(ErrorCode.InternalError, `Error searching files: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'files-search',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/files-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/files-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { type drive_v3, google } from 'googleapis';\nimport { z } from 'zod';\nimport { toDriveQuery } from '../../lib/query-builder.js';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema, DriveQuerySchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n  query: DriveQuerySchema.describe('Drive query object with structured search fields. See DriveQuerySchema for detailed query syntax and examples.'),\n  fields: createFieldsSchema({\n    availableFields: DRIVE_FILE_FIELDS,\n    fieldDescriptions: DRIVE_FILE_FIELD_DESCRIPTIONS,\n    commonPatterns: DRIVE_FILE_COMMON_PATTERNS,\n    resourceName: 'Drive file',\n  }),\n  ...createPaginationSchema({\n    defaultPageSize: 50,\n    maxPageSize: 1000,\n    provider: 'drive',\n  }).shape,\n  shape: createShapeSchema(),\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('objects'),\n  items: z.array(DriveFileSchema).describe('Matching Drive files'),\n  count: z.number().describe('Number of files in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('arrays'),\n  columns: z.array(z.string()).describe('Column names in canonical order'),\n  rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n  count: z.number().describe('Number of files in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  title: 'Search Drive Files',\n  description: 'Search Google Drive files with flexible field selection for optimal performance.',\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\n// Type for the raw Google Drive API response\ntype driveFile = drive_v3.Schema$File;\n\ntype driveResponse = drive_v3.Schema$FileList;\n\nasync function handler({ query, pageSize = 50, pageToken, fields, shape = 'arrays' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, DRIVE_FILE_FIELDS);\n\n  // Validate and clamp pageSize to Google Drive API limits (1-1000)\n  const validPageSize = Math.max(1, Math.min(1000, Math.floor(pageSize || 50)));\n\n  logger.info('drive.files-search called', {\n    query,\n    pageSize: validPageSize,\n    pageToken: pageToken ? '[provided]' : undefined,\n    fields: fields || 'all',\n  });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    // Handle query parameter\n    let qStr: string;\n    if (typeof query === 'string') {\n      // String query - treat as raw Drive query\n      qStr = `(${query}) and trashed = false`;\n    } else if (query && typeof query === 'object' && 'rawDriveQuery' in query && query.rawDriveQuery) {\n      // Object with rawDriveQuery field - use it directly\n      qStr = `(${query.rawDriveQuery}) and trashed = false`;\n    } else {\n      // Structured query object - convert to Drive query string\n      const { q } = toDriveQuery(query);\n      qStr = q ? `(${q}) and trashed = false` : 'trashed = false';\n    }\n\n    const listOptions: {\n      q: string;\n      pageSize: number;\n      fields: string;\n      orderBy: string;\n      pageToken?: string;\n    } = {\n      q: qStr,\n      pageSize: validPageSize,\n      fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',\n      orderBy: 'modifiedTime desc',\n    };\n    if (pageToken && pageToken.trim().length > 0) {\n      listOptions.pageToken = pageToken;\n    }\n\n    const response = await drive.files.list(listOptions);\n    const res = response.data as driveResponse;\n    const files = Array.isArray(res?.files) ? res.files : [];\n\n    const parentIds = new Set<string>();\n    for (const f of files) {\n      if (f?.parents && f.parents.length > 0) {\n        for (const parentId of f.parents) {\n          if (parentId && parentId !== 'root') {\n            parentIds.add(parentId);\n          }\n        }\n      }\n    }\n\n    const parentNameMap = new Map<string, string>();\n    if (parentIds.size > 0) {\n      logger.info('Fetching parent names', { count: parentIds.size });\n      const parentFetches = Array.from(parentIds).map(async (parentId) => {\n        try {\n          const parentRes = await drive.files.get({\n            fileId: parentId,\n            fields: 'id,name',\n          });\n          const parentName = (parentRes.data.name as string | undefined) || parentId;\n          parentNameMap.set(parentId, parentName);\n        } catch (e) {\n          logger.info('Failed to fetch parent name', { parentId, error: e });\n          parentNameMap.set(parentId, parentId); // Fallback to ID\n        }\n      });\n      await Promise.all(parentFetches);\n    }\n\n    const items: DriveFile[] = files.map((f: driveFile) => {\n      const id = f?.id ? String(f.id) : 'unknown';\n      const name = f?.name || id;\n      const result: DriveFile = { id, name };\n\n      // Only include properties that have actual values\n      if (f?.mimeType) result.mimeType = f.mimeType;\n      if (f?.webViewLink) result.webViewLink = f.webViewLink;\n      if (f?.modifiedTime) result.modifiedTime = f.modifiedTime;\n\n      if (f?.parents && f.parents.length > 0) {\n        result.parents = f.parents.map((parentId) => {\n          if (parentId === 'root') {\n            return { id: 'root', name: 'My Drive' };\n          }\n          const parentName = parentNameMap.get(parentId) || parentId;\n          return { id: parentId, name: parentName };\n        });\n      }\n\n      if (f?.shared != null) result.shared = f.shared;\n      if (f?.starred != null) result.starred = f.starred;\n\n      if (f?.owners && f.owners.length > 0) {\n        result.owners = f.owners.map((o) => {\n          const owner: NonNullable<DriveFile['owners']>[number] = {};\n          if (o?.displayName) owner.displayName = o.displayName;\n          if (o?.emailAddress) owner.emailAddress = o.emailAddress;\n          if (o?.kind) owner.kind = o.kind;\n          if (o?.me != null) owner.me = o.me;\n          if (o?.permissionId) owner.permissionId = o.permissionId;\n          if (o?.photoLink) owner.photoLink = o.photoLink;\n          return owner;\n        });\n      }\n\n      return result;\n    });\n\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('drive.files-search returning', {\n      query,\n      pageSize,\n      resultCount: filteredItems.length,\n      fields: fields || 'all',\n    });\n\n    const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;\n\n    // Build result based on shape\n    const result: Output =\n      shape === 'arrays'\n        ? {\n            type: 'success' as const,\n            shape: 'arrays' as const,\n            ...toColumnarFormat(filteredItems, requestedFields, DRIVE_FILE_FIELDS),\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\n          }\n        : {\n            type: 'success' as const,\n            shape: 'objects' as const,\n            items: filteredItems,\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\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.files-search error', { error: message });\n\n    // Check if this is a Drive API validation error (invalid query, invalid pageToken, etc.)\n    // These should return empty results rather than throw\n    const isDriveValidationError = message.includes('Invalid Value') || message.includes('Invalid value') || message.includes('File not found') || message.includes('Bad Request');\n\n    if (isDriveValidationError) {\n      // Return empty result set for validation errors\n      const result: Output =\n        shape === 'arrays'\n          ? {\n              type: 'success' as const,\n              shape: 'arrays' as const,\n              columns: [],\n              rows: [],\n              count: 0,\n            }\n          : {\n              type: 'success' as const,\n              shape: 'objects' as const,\n              items: [],\n              count: 0,\n            };\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify(result),\n          },\n        ],\n        structuredContent: { result },\n      };\n    }\n\n    // Throw McpError for other errors\n    throw new McpError(ErrorCode.InternalError, `Error searching files: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'files-search' as const,\n    config,\n    handler,\n  };\n}\n"],"names":["schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","ErrorCode","McpError","google","z","toDriveQuery","DRIVE_FILE_COMMON_PATTERNS","DRIVE_FILE_FIELD_DESCRIPTIONS","DRIVE_FILE_FIELDS","DriveFileSchema","DriveQuerySchema","inputSchema","object","query","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","successObjectsBranchSchema","type","literal","items","array","count","number","nextPageToken","string","optional","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","title","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","validPageSize","Math","max","min","floor","info","undefined","drive","version","auth","authContext","qStr","rawDriveQuery","q","listOptions","orderBy","trim","length","response","files","list","res","data","Array","isArray","parentIds","Set","f","parents","parentId","add","parentNameMap","Map","size","parentFetches","from","map","parentRes","get","fileId","parentName","name","set","e","error","Promise","all","id","String","mimeType","webViewLink","modifiedTime","shared","starred","owners","o","owner","displayName","emailAddress","kind","me","permissionId","photoLink","filteredItems","item","resultCount","content","text","JSON","stringify","structuredContent","message","Error","isDriveValidationError","includes","InternalError","stack","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/folder-contents.d.ts

@@ -0,0 +1,139 @@
+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<{
+    shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        objects: "objects";
+        arrays: "arrays";
+    }>>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    folderId: z.ZodString;
+    fields: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"objects">;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        webViewLink: z.ZodOptional<z.ZodString>;
+        webContentLink: z.ZodOptional<z.ZodString>;
+        modifiedTime: z.ZodOptional<z.ZodString>;
+        createdTime: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        shared: z.ZodOptional<z.ZodBoolean>;
+        starred: z.ZodOptional<z.ZodBoolean>;
+        trashed: z.ZodOptional<z.ZodBoolean>;
+        parents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        owners: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            emailAddress: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            me: z.ZodOptional<z.ZodBoolean>;
+            permissionId: z.ZodOptional<z.ZodString>;
+            photoLink: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        permissions: z.ZodOptional<z.ZodObject<{
+            canEdit: z.ZodOptional<z.ZodBoolean>;
+            canComment: z.ZodOptional<z.ZodBoolean>;
+            canShare: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+    folderId: z.ZodString;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"arrays">;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+    count: z.ZodNumber;
+    folderId: z.ZodString;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ folderId, pageSize, pageToken, fields, shape }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: "folder-contents";
+    config: {
+        readonly title: "List Folder Contents";
+        readonly description: "List files and folders in a specific folder with field selection.";
+        readonly inputSchema: z.ZodObject<{
+            shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                objects: "objects";
+                arrays: "arrays";
+            }>>>;
+            pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            pageToken: z.ZodOptional<z.ZodString>;
+            folderId: z.ZodString;
+            fields: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"objects">;
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    webViewLink: z.ZodOptional<z.ZodString>;
+                    webContentLink: z.ZodOptional<z.ZodString>;
+                    modifiedTime: z.ZodOptional<z.ZodString>;
+                    createdTime: z.ZodOptional<z.ZodString>;
+                    size: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodString>;
+                    shared: z.ZodOptional<z.ZodBoolean>;
+                    starred: z.ZodOptional<z.ZodBoolean>;
+                    trashed: z.ZodOptional<z.ZodBoolean>;
+                    parents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>>>;
+                    owners: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        displayName: z.ZodOptional<z.ZodString>;
+                        emailAddress: z.ZodOptional<z.ZodString>;
+                        kind: z.ZodOptional<z.ZodString>;
+                        me: z.ZodOptional<z.ZodBoolean>;
+                        permissionId: z.ZodOptional<z.ZodString>;
+                        photoLink: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    permissions: z.ZodOptional<z.ZodObject<{
+                        canEdit: z.ZodOptional<z.ZodBoolean>;
+                        canComment: z.ZodOptional<z.ZodBoolean>;
+                        canShare: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                count: z.ZodNumber;
+                folderId: z.ZodString;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"arrays">;
+                columns: z.ZodArray<z.ZodString>;
+                rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+                count: z.ZodNumber;
+                folderId: z.ZodString;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};