@mcp-z/mcp-drive 1.0.0

package/dist/cjs/mcp/tools/folder-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/folder-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 } from 'googleapis';\nimport { 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';\nimport type { Logger } from '../../types.js';\n\nconst inputSchema = z.object({\n  query: DriveQuerySchema.optional().describe('Drive query object with structured search fields. See DriveQuerySchema for detailed query syntax and examples.'),\n  fields: createFieldsSchema({\n    availableFields: [...DRIVE_FILE_FIELDS, 'path'] as const,\n    fieldDescriptions: {\n      ...DRIVE_FILE_FIELD_DESCRIPTIONS,\n      path: 'Full folder path like /Work/Projects (requires resolvePaths=true)',\n    },\n    commonPatterns: DRIVE_FILE_COMMON_PATTERNS,\n    resourceName: 'Drive folder',\n  }),\n  resolvePaths: z.boolean().optional().describe('Resolve full folder paths like /Work/Projects/2024 (requires additional API calls per result)'),\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.extend({ path: z.string().optional().describe('Full folder path (if resolvePaths=true)') })).describe('Matching Drive folders'),\n  count: z.number().describe('Number of folders 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 folders 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 Folders',\n  description: 'Search Google Drive folders with flexible field selection and optional path resolution.',\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 DriveFolder = {\n  id?: string;\n  name?: string;\n  mimeType?: string;\n  webViewLink?: string;\n  modifiedTime?: string;\n  parents?: string[];\n  shared?: boolean;\n  starred?: boolean;\n  owners?: Array<{\n    displayName?: string;\n    emailAddress?: string;\n    kind?: string;\n    me?: boolean;\n    permissionId?: string;\n    photoLink?: string;\n  }>;\n};\n\ntype DriveFolderResponse = {\n  files?: DriveFolder[];\n  nextPageToken?: string;\n};\n\n/**\n * Resolves the full path for a folder by walking up the parent chain\n * Caches folder names to reduce redundant API calls\n */\nasync function resolveFolderPath(drive: drive_v3.Drive, folderId: string, folderCache: Map<string, string>, logger: Logger): Promise<string> {\n  if (folderId === 'root') return '/';\n\n  const pathParts: string[] = [];\n  let currentId = folderId;\n  const visited = new Set<string>();\n\n  while (currentId && currentId !== 'root') {\n    // Prevent infinite loops\n    if (visited.has(currentId)) {\n      logger.info('Circular folder reference detected', {\n        folderId: currentId,\n      });\n      break;\n    }\n    visited.add(currentId);\n\n    // Check cache first\n    if (folderCache.has(currentId)) {\n      const cachedName = folderCache.get(currentId);\n      if (cachedName) {\n        pathParts.unshift(cachedName);\n      }\n\n      // Get parent of cached folder\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'parents',\n        });\n        const parents = response.data.parents as string[] | undefined;\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (_e) {\n        logger.info('Failed to get parent for cached folder', {\n          folderId: currentId,\n        });\n        break;\n      }\n    } else {\n      // Fetch folder metadata\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'name,parents',\n        });\n        const folderName = response.data.name as string | undefined;\n        const parents = response.data.parents as string[] | undefined;\n\n        if (folderName) {\n          folderCache.set(currentId, folderName);\n          pathParts.unshift(folderName);\n        }\n\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (e) {\n        logger.info('Failed to resolve folder path', {\n          folderId: currentId,\n          error: e,\n        });\n        break;\n      }\n    }\n  }\n\n  return `/${pathParts.join('/')}`;\n}\n\nasync function handler({ query, resolvePaths = false, 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, 'path'] as const);\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.folder.search called', {\n    query,\n    resolvePaths,\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    const folderMimeType = 'application/vnd.google-apps.folder';\n    let qStr: string;\n\n    if (typeof query === 'string') {\n      // String query - treat as raw Drive query\n      qStr = `(${query}) and mimeType='${folderMimeType}' 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 mimeType='${folderMimeType}' and trashed = false`;\n    } else if (query) {\n      // Structured query object - convert to Drive query string\n      const { q } = toDriveQuery(query);\n      qStr = q ? `(${q}) and mimeType='${folderMimeType}' and trashed = false` : `mimeType='${folderMimeType}' and trashed = false`;\n    } else {\n      // No query - return all folders\n      qStr = `mimeType='${folderMimeType}' and 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\n    const res = response.data as DriveFolderResponse;\n    const folders = Array.isArray(res?.files) ? res.files : [];\n\n    const parentIds = new Set<string>();\n    for (const f of folders) {\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    // Cache for folder names to reduce API calls during path resolution\n    const folderCache = new Map<string, string>();\n\n    const items: (DriveFile & { path?: string })[] = await Promise.all(\n      folders.map(async (f: DriveFolder) => {\n        const id = f?.id ? String(f.id) : 'unknown';\n        const name = f?.name || id;\n        const result: DriveFile & { path?: string } = { 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        // Build parent objects with names\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 !== undefined) result.shared = f.shared;\n        if (f?.starred !== undefined) 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 !== undefined) 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        // Resolve path if requested\n        if (resolvePaths && id !== 'unknown') {\n          result.path = await resolveFolderPath(drive, id, folderCache, logger);\n        }\n\n        return result;\n      })\n    );\n\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('drive.folder.search returning', {\n      query,\n      pageSize,\n      resultCount: filteredItems.length,\n      resolvePaths,\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, 'path'] as const),\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.folder.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 folders: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'folder-search' as const,\n    config,\n    handler,\n  };\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","query","DriveQuerySchema","optional","describe","fields","createFieldsSchema","availableFields","DRIVE_FILE_FIELDS","fieldDescriptions","DRIVE_FILE_FIELD_DESCRIPTIONS","path","commonPatterns","DRIVE_FILE_COMMON_PATTERNS","resourceName","resolvePaths","boolean","createPaginationSchema","defaultPageSize","maxPageSize","provider","shape","createShapeSchema","successObjectsBranchSchema","type","literal","items","array","DriveFileSchema","extend","string","count","number","nextPageToken","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","title","description","result","resolveFolderPath","drive","folderId","folderCache","logger","pathParts","currentId","visited","cachedName","response","parents","_e","folderName","e","Set","has","info","add","get","unshift","files","fileId","data","length","name","set","error","join","handler","extra","pageSize","pageToken","requestedFields","validPageSize","folderMimeType","qStr","q","listOptions","res","folders","parentIds","f","parentId","parentNameMap","parentFetches","filteredItems","message","isDriveValidationError","parseFields","Math","max","min","floor","undefined","google","version","auth","authContext","rawDriveQuery","toDriveQuery","orderBy","trim","list","Array","isArray","Map","size","from","map","parentRes","parentName","Promise","all","id","String","mimeType","webViewLink","modifiedTime","shared","starred","owners","o","owner","displayName","emailAddress","kind","me","permissionId","photoLink","item","filterFields","resultCount","toColumnarFormat","content","text","JSON","stringify","structuredContent","Error","includes","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}

package/dist/cjs/mcp/tools/index.d.cts

@@ -0,0 +1,7 @@
+export { default as fileMove } from './file-move.js';
+export { default as fileMoveToTrash } from './file-move-to-trash.js';
+export { default as filesSearch } from './files-search.js';
+export { default as folderContents } from './folder-contents.js';
+export { default as folderCreate } from './folder-create.js';
+export { default as folderPath } from './folder-path.js';
+export { default as folderSearch } from './folder-search.js';

package/dist/cjs/mcp/tools/index.d.ts

@@ -0,0 +1,7 @@
+export { default as fileMove } from './file-move.js';
+export { default as fileMoveToTrash } from './file-move-to-trash.js';
+export { default as filesSearch } from './files-search.js';
+export { default as folderContents } from './folder-contents.js';
+export { default as folderCreate } from './folder-create.js';
+export { default as folderPath } from './folder-path.js';
+export { default as folderSearch } from './folder-search.js';

package/dist/cjs/mcp/tools/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get fileMove () {
+        return _filemove.default;
+    },
+    get fileMoveToTrash () {
+        return _filemovetotrash.default;
+    },
+    get filesSearch () {
+        return _filessearch.default;
+    },
+    get folderContents () {
+        return _foldercontents.default;
+    },
+    get folderCreate () {
+        return _foldercreate.default;
+    },
+    get folderPath () {
+        return _folderpath.default;
+    },
+    get folderSearch () {
+        return _foldersearch.default;
+    }
+});
+var _filemove = /*#__PURE__*/ _interop_require_default(require("./file-move.js"));
+var _filemovetotrash = /*#__PURE__*/ _interop_require_default(require("./file-move-to-trash.js"));
+var _filessearch = /*#__PURE__*/ _interop_require_default(require("./files-search.js"));
+var _foldercontents = /*#__PURE__*/ _interop_require_default(require("./folder-contents.js"));
+var _foldercreate = /*#__PURE__*/ _interop_require_default(require("./folder-create.js"));
+var _folderpath = /*#__PURE__*/ _interop_require_default(require("./folder-path.js"));
+var _foldersearch = /*#__PURE__*/ _interop_require_default(require("./folder-search.js"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/index.ts"],"sourcesContent":["export { default as fileMove } from './file-move.js';\nexport { default as fileMoveToTrash } from './file-move-to-trash.js';\nexport { default as filesSearch } from './files-search.js';\nexport { default as folderContents } from './folder-contents.js';\nexport { default as folderCreate } from './folder-create.js';\nexport { default as folderPath } from './folder-path.js';\nexport { default as folderSearch } from './folder-search.js';\n"],"names":["fileMove","fileMoveToTrash","filesSearch","folderContents","folderCreate","folderPath","folderSearch"],"mappings":";;;;;;;;;;;QAAoBA;eAAAA,iBAAQ;;QACRC;eAAAA,wBAAe;;QACfC;eAAAA,oBAAW;;QACXC;eAAAA,uBAAc;;QACdC;eAAAA,qBAAY;;QACZC;eAAAA,mBAAU;;QACVC;eAAAA,qBAAY;;;+DANI;sEACO;kEACJ;qEACG;mEACF;iEACF;mEACE"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/dist/cjs/schemas/drive-query-schema.d.cts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Field operator schema for Drive query fields that support multiple values
+ * Supports OR ($any), AND ($all), and NOT ($none) operations
+ */
+declare const FieldOperatorSchema: z.ZodObject<{
+    $any: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    $all: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+export type DriveQueryObject = {
+    $and?: DriveQueryObject[];
+    $or?: DriveQueryObject[];
+    $not?: DriveQueryObject;
+    name?: string | FieldOperator;
+    mimeType?: string | FieldOperator;
+    fullText?: string | FieldOperator;
+    parentId?: string | FieldOperator;
+    starred?: boolean;
+    sharedWithMe?: boolean;
+    trashed?: boolean;
+    modifiedTime?: {
+        $gte?: string;
+        $lt?: string;
+    };
+    owner?: string | FieldOperator;
+    rawDriveQuery?: string;
+};
+/**
+ * Drive query schema that accepts either:
+ * - A structured DriveQueryObject with typed fields
+ * - A raw Drive query string for advanced use cases
+ *
+ * This provides type safety for common queries while allowing
+ * direct Google Drive query syntax when needed.
+ */
+export declare const DriveQuerySchema: z.ZodUnion<readonly [z.ZodString, z.ZodType<DriveQueryObject, unknown, z.core.$ZodTypeInternals<DriveQueryObject, unknown>>]>;
+export type DriveQuery = string | DriveQueryObject;
+export {};

package/dist/cjs/schemas/drive-query-schema.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Field operator schema for Drive query fields that support multiple values
+ * Supports OR ($any), AND ($all), and NOT ($none) operations
+ */
+declare const FieldOperatorSchema: z.ZodObject<{
+    $any: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    $all: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+export type DriveQueryObject = {
+    $and?: DriveQueryObject[];
+    $or?: DriveQueryObject[];
+    $not?: DriveQueryObject;
+    name?: string | FieldOperator;
+    mimeType?: string | FieldOperator;
+    fullText?: string | FieldOperator;
+    parentId?: string | FieldOperator;
+    starred?: boolean;
+    sharedWithMe?: boolean;
+    trashed?: boolean;
+    modifiedTime?: {
+        $gte?: string;
+        $lt?: string;
+    };
+    owner?: string | FieldOperator;
+    rawDriveQuery?: string;
+};
+/**
+ * Drive query schema that accepts either:
+ * - A structured DriveQueryObject with typed fields
+ * - A raw Drive query string for advanced use cases
+ *
+ * This provides type safety for common queries while allowing
+ * direct Google Drive query syntax when needed.
+ */
+export declare const DriveQuerySchema: z.ZodUnion<readonly [z.ZodString, z.ZodType<DriveQueryObject, unknown, z.core.$ZodTypeInternals<DriveQueryObject, unknown>>]>;
+export type DriveQuery = string | DriveQueryObject;
+export {};

package/dist/cjs/schemas/drive-query-schema.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DriveQuerySchema", {
+    enumerable: true,
+    get: function() {
+        return DriveQuerySchema;
+    }
+});
+var _zod = require("zod");
+/**
+ * Field operator schema for Drive query fields that support multiple values
+ * Supports OR ($any), AND ($all), and NOT ($none) operations
+ */ var FieldOperatorSchema = _zod.z.object({
+    $any: _zod.z.array(_zod.z.string()).optional().describe('OR within field - matches if ANY value matches'),
+    $all: _zod.z.array(_zod.z.string()).optional().describe('AND within field - matches if ALL values match'),
+    $none: _zod.z.array(_zod.z.string()).optional().describe('NOT within field - matches if NONE match')
+}).strict();
+/**
+ * Drive query object schema with recursive operators and Drive features.
+ *
+ * Includes Drive-specific features:
+ * - name: Search by file/folder name (supports string or field operators)
+ * - mimeType: Filter by MIME type (e.g., "application/pdf", "application/vnd.google-apps.folder")
+ * - fullText: Search file content and metadata
+ * - parentId: Search within specific folder (supports string or field operators)
+ * - starred: Filter by starred status
+ * - shared: Filter by shared status
+ * - modifiedTime: Date range filtering with $gte and $lt
+ * - owner: Filter by owner email (supports string or field operators)
+ * - rawDriveQuery: Escape hatch for advanced Drive query syntax
+ *
+ * Logical operators:
+ * - $and: Array of conditions that must ALL match (recursive)
+ * - $or: Array of conditions where ANY must match (recursive)
+ * - $not: Nested condition that must NOT match (recursive)
+ *
+ * Note: Cast through unknown to work around Zod's lazy schema type inference issue
+ * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
+ * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.
+ */ var DriveQueryObjectSchema = _zod.z.lazy(function() {
+    return _zod.z.object({
+        // Logical operators for combining conditions (recursive)
+        $and: _zod.z.array(DriveQueryObjectSchema).optional().describe('Array of conditions that must ALL match'),
+        $or: _zod.z.array(DriveQueryObjectSchema).optional().describe('Array of conditions where ANY must match'),
+        $not: DriveQueryObjectSchema.optional().describe('Nested condition that must NOT match'),
+        // File/folder name search
+        name: _zod.z.union([
+            _zod.z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Search by file or folder name (partial match, case-insensitive)'),
+        // MIME type filtering
+        mimeType: _zod.z.union([
+            _zod.z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Filter by MIME type (e.g., "application/pdf", "application/vnd.google-apps.folder", "image/jpeg")'),
+        // Full-text search across content and metadata
+        fullText: _zod.z.union([
+            _zod.z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Search file content and metadata (full-text search)'),
+        // Parent folder filtering
+        parentId: _zod.z.union([
+            _zod.z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Search within specific folder by folder ID (use "root" for My Drive root)'),
+        // Boolean flags
+        starred: _zod.z.boolean().optional().describe('Filter by starred status (true = starred, false = not starred)'),
+        sharedWithMe: _zod.z.boolean().optional().describe('Filter by "shared with me" collection (true = in shared collection, false = not shared)'),
+        trashed: _zod.z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash). Note: Drive tools automatically filter out trashed files unless explicitly requested.'),
+        // Date range filtering
+        modifiedTime: _zod.z.object({
+            $gte: _zod.z.string().regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z)?$/).optional().describe('Files modified on or after this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),
+            $lt: _zod.z.string().regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z)?$/).optional().describe('Files modified before this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)')
+        }).optional().describe('Filter by modification date range'),
+        // Owner filtering
+        owner: _zod.z.union([
+            _zod.z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Filter by owner email address (partial match)'),
+        // Raw Drive query string - escape hatch for advanced syntax
+        rawDriveQuery: _zod.z.string().min(1).optional().describe("Raw Google Drive query syntax for advanced use cases. Bypasses schema validation - use sparingly. Example: \"name contains 'budget' and mimeType = 'application/pdf'\"")
+    }).strict();
+});
+var DriveQuerySchema = _zod.z.union([
+    _zod.z.string().min(1),
+    DriveQueryObjectSchema
+]);
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/schemas/drive-query-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/schemas/drive-query-schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Field operator schema for Drive query fields that support multiple values\n * Supports OR ($any), AND ($all), and NOT ($none) operations\n */\nconst FieldOperatorSchema = z\n  .object({\n    $any: z.array(z.string()).optional().describe('OR within field - matches if ANY value matches'),\n    $all: z.array(z.string()).optional().describe('AND within field - matches if ALL values match'),\n    $none: z.array(z.string()).optional().describe('NOT within field - matches if NONE match'),\n  })\n  .strict();\n\nexport type FieldOperator = z.infer<typeof FieldOperatorSchema>;\n\n/**\n * Drive query object schema with recursive operators and Drive features.\n *\n * Includes Drive-specific features:\n * - name: Search by file/folder name (supports string or field operators)\n * - mimeType: Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\")\n * - fullText: Search file content and metadata\n * - parentId: Search within specific folder (supports string or field operators)\n * - starred: Filter by starred status\n * - shared: Filter by shared status\n * - modifiedTime: Date range filtering with $gte and $lt\n * - owner: Filter by owner email (supports string or field operators)\n * - rawDriveQuery: Escape hatch for advanced Drive query syntax\n *\n * Logical operators:\n * - $and: Array of conditions that must ALL match (recursive)\n * - $or: Array of conditions where ANY must match (recursive)\n * - $not: Nested condition that must NOT match (recursive)\n *\n * Note: Cast through unknown to work around Zod's lazy schema type inference issue\n * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures\n * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.\n */\nconst DriveQueryObjectSchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(DriveQueryObjectSchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(DriveQueryObjectSchema).optional().describe('Array of conditions where ANY must match'),\n      $not: DriveQueryObjectSchema.optional().describe('Nested condition that must NOT match'),\n\n      // File/folder name search\n      name: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search by file or folder name (partial match, case-insensitive)'),\n\n      // MIME type filtering\n      mimeType: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\", \"image/jpeg\")'),\n\n      // Full-text search across content and metadata\n      fullText: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search file content and metadata (full-text search)'),\n\n      // Parent folder filtering\n      parentId: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search within specific folder by folder ID (use \"root\" for My Drive root)'),\n\n      // Boolean flags\n      starred: z.boolean().optional().describe('Filter by starred status (true = starred, false = not starred)'),\n      sharedWithMe: z.boolean().optional().describe('Filter by \"shared with me\" collection (true = in shared collection, false = not shared)'),\n      trashed: z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash). Note: Drive tools automatically filter out trashed files unless explicitly requested.'),\n\n      // Date range filtering\n      modifiedTime: z\n        .object({\n          $gte: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified on or after this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n          $lt: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified before this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n        })\n        .optional()\n        .describe('Filter by modification date range'),\n\n      // Owner filtering\n      owner: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by owner email address (partial match)'),\n\n      // Raw Drive query string - escape hatch for advanced syntax\n      rawDriveQuery: z.string().min(1).optional().describe(\"Raw Google Drive query syntax for advanced use cases. Bypasses schema validation - use sparingly. Example: \\\"name contains 'budget' and mimeType = 'application/pdf'\\\"\"),\n    })\n    .strict()\n) as unknown as z.ZodType<DriveQueryObject>;\n\nexport type DriveQueryObject = {\n  $and?: DriveQueryObject[];\n  $or?: DriveQueryObject[];\n  $not?: DriveQueryObject;\n  name?: string | FieldOperator;\n  mimeType?: string | FieldOperator;\n  fullText?: string | FieldOperator;\n  parentId?: string | FieldOperator;\n  starred?: boolean;\n  sharedWithMe?: boolean;\n  trashed?: boolean;\n  modifiedTime?: {\n    $gte?: string;\n    $lt?: string;\n  };\n  owner?: string | FieldOperator;\n  rawDriveQuery?: string;\n};\n\n/**\n * Drive query schema that accepts either:\n * - A structured DriveQueryObject with typed fields\n * - A raw Drive query string for advanced use cases\n *\n * This provides type safety for common queries while allowing\n * direct Google Drive query syntax when needed.\n */\nexport const DriveQuerySchema = z.union([z.string().min(1), DriveQueryObjectSchema]);\n\nexport type DriveQuery = string | DriveQueryObject;\n"],"names":["DriveQuerySchema","FieldOperatorSchema","z","object","$any","array","string","optional","describe","$all","$none","strict","DriveQueryObjectSchema","lazy","$and","$or","$not","name","union","min","mimeType","fullText","parentId","starred","boolean","sharedWithMe","trashed","modifiedTime","$gte","regex","$lt","owner","rawDriveQuery"],"mappings":";;;;+BAoIaA;;;eAAAA;;;mBApIK;AAElB;;;CAGC,GACD,IAAMC,sBAAsBC,MAAC,CAC1BC,MAAM,CAAC;IACNC,MAAMF,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;IAC9CC,MAAMP,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;IAC9CE,OAAOR,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;AACjD,GACCG,MAAM;AAIT;;;;;;;;;;;;;;;;;;;;;;CAsBC,GACD,IAAMC,yBAAyBV,MAAC,CAACW,IAAI,CAAC;WACpCX,MAAC,CACEC,MAAM,CAAC;QACN,yDAAyD;QACzDW,MAAMZ,MAAC,CAACG,KAAK,CAACO,wBAAwBL,QAAQ,GAAGC,QAAQ,CAAC;QAC1DO,KAAKb,MAAC,CAACG,KAAK,CAACO,wBAAwBL,QAAQ,GAAGC,QAAQ,CAAC;QACzDQ,MAAMJ,uBAAuBL,QAAQ,GAAGC,QAAQ,CAAC;QAEjD,0BAA0B;QAC1BS,MAAMf,MAAC,CACJgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,sBAAsB;QACtBY,UAAUlB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,+CAA+C;QAC/Ca,UAAUnB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,0BAA0B;QAC1Bc,UAAUpB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,gBAAgB;QAChBe,SAASrB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QACzCiB,cAAcvB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QAC9CkB,SAASxB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QAEzC,uBAAuB;QACvBmB,cAAczB,MAAC,CACZC,MAAM,CAAC;YACNyB,MAAM1B,MAAC,CACJI,MAAM,GACNuB,KAAK,CAAC,uDACNtB,QAAQ,GACRC,QAAQ,CAAC;YACZsB,KAAK5B,MAAC,CACHI,MAAM,GACNuB,KAAK,CAAC,uDACNtB,QAAQ,GACRC,QAAQ,CAAC;QACd,GACCD,QAAQ,GACRC,QAAQ,CAAC;QAEZ,kBAAkB;QAClBuB,OAAO7B,MAAC,CACLgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,4DAA4D;QAC5DwB,eAAe9B,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC,GAAGZ,QAAQ,GAAGC,QAAQ,CAAC;IACvD,GACCG,MAAM;;AA8BJ,IAAMX,mBAAmBE,MAAC,CAACgB,KAAK,CAAC;IAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;IAAIP;CAAuB"}

package/dist/cjs/schemas/drive-validation.d.cts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export declare const DriveFileSchema: 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>;
+export type DriveFile = z.infer<typeof DriveFileSchema>;
+export declare const DRIVE_FILE_FIELDS: readonly ["id", "name", "mimeType", "webViewLink", "modifiedTime", "parents", "shared", "starred", "owners"];
+export declare const DRIVE_FILE_FIELD_DESCRIPTIONS: Record<(typeof DRIVE_FILE_FIELDS)[number], string>;
+export declare const DRIVE_FILE_COMMON_PATTERNS: readonly [{
+    readonly name: "Bulk operations (delete/move)";
+    readonly fields: "id,name";
+    readonly tokens: "~20 tokens/file";
+}, {
+    readonly name: "Browsing/filtering";
+    readonly fields: "id,name,mimeType,modifiedTime";
+    readonly tokens: "~40 tokens/file";
+}, {
+    readonly name: "Full metadata";
+    readonly fields: "id,name,mimeType,webViewLink,modifiedTime,owners";
+    readonly tokens: "~80 tokens/file";
+}];

package/dist/cjs/schemas/drive-validation.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export declare const DriveFileSchema: 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>;
+export type DriveFile = z.infer<typeof DriveFileSchema>;
+export declare const DRIVE_FILE_FIELDS: readonly ["id", "name", "mimeType", "webViewLink", "modifiedTime", "parents", "shared", "starred", "owners"];
+export declare const DRIVE_FILE_FIELD_DESCRIPTIONS: Record<(typeof DRIVE_FILE_FIELDS)[number], string>;
+export declare const DRIVE_FILE_COMMON_PATTERNS: readonly [{
+    readonly name: "Bulk operations (delete/move)";
+    readonly fields: "id,name";
+    readonly tokens: "~20 tokens/file";
+}, {
+    readonly name: "Browsing/filtering";
+    readonly fields: "id,name,mimeType,modifiedTime";
+    readonly tokens: "~40 tokens/file";
+}, {
+    readonly name: "Full metadata";
+    readonly fields: "id,name,mimeType,webViewLink,modifiedTime,owners";
+    readonly tokens: "~80 tokens/file";
+}];

package/dist/cjs/schemas/drive-validation.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DRIVE_FILE_COMMON_PATTERNS () {
+        return DRIVE_FILE_COMMON_PATTERNS;
+    },
+    get DRIVE_FILE_FIELDS () {
+        return DRIVE_FILE_FIELDS;
+    },
+    get DRIVE_FILE_FIELD_DESCRIPTIONS () {
+        return DRIVE_FILE_FIELD_DESCRIPTIONS;
+    },
+    get DriveFileSchema () {
+        return DriveFileSchema;
+    }
+});
+var _zod = require("zod");
+var DriveFileSchema = _zod.z.object({
+    id: _zod.z.string().optional(),
+    name: _zod.z.string().optional(),
+    mimeType: _zod.z.string().optional().describe('MIME type of the file (e.g., application/pdf, image/png)'),
+    webViewLink: _zod.z.string().optional().describe('URL to view the file in Google Drive'),
+    webContentLink: _zod.z.string().optional().describe('Direct download link for the file'),
+    modifiedTime: _zod.z.string().optional().describe('ISO datetime when file was last modified'),
+    createdTime: _zod.z.string().optional().describe('ISO datetime when file was created'),
+    size: _zod.z.string().optional().describe('File size in bytes as string'),
+    version: _zod.z.string().optional().describe('Version number of the file'),
+    shared: _zod.z.boolean().optional().describe('Whether the file is shared with others'),
+    starred: _zod.z.boolean().optional().describe('Whether the file is starred by the user'),
+    trashed: _zod.z.boolean().optional().describe('Whether the file is in trash'),
+    parents: _zod.z.array(_zod.z.object({
+        id: _zod.z.string().describe('Parent folder ID'),
+        name: _zod.z.string().describe('Parent folder name')
+    })).optional().describe('Parent folders with ID and name'),
+    owners: _zod.z.array(_zod.z.object({
+        displayName: _zod.z.string().optional(),
+        emailAddress: _zod.z.string().optional(),
+        kind: _zod.z.string().optional().describe('Resource type identifier (e.g., "drive#user")'),
+        me: _zod.z.boolean().optional().describe('Whether this owner is the current user'),
+        permissionId: _zod.z.string().optional().describe('Permission ID for this user'),
+        photoLink: _zod.z.string().optional().describe('URL to user profile photo')
+    })).optional(),
+    permissions: _zod.z.object({
+        canEdit: _zod.z.boolean().optional(),
+        canComment: _zod.z.boolean().optional(),
+        canShare: _zod.z.boolean().optional()
+    }).optional().describe("Current user's permissions on this file")
+});
+var DRIVE_FILE_FIELDS = [
+    'id',
+    'name',
+    'mimeType',
+    'webViewLink',
+    'modifiedTime',
+    'parents',
+    'shared',
+    'starred',
+    'owners'
+];
+var DRIVE_FILE_FIELD_DESCRIPTIONS = {
+    id: 'Unique file/folder identifier',
+    name: 'File or folder name',
+    mimeType: 'MIME type (e.g., application/pdf, application/vnd.google-apps.folder)',
+    webViewLink: 'URL to view the file in Google Drive',
+    modifiedTime: 'Last modification timestamp',
+    parents: 'Parent folder IDs',
+    shared: 'Whether the file is shared',
+    starred: 'Whether the file is starred',
+    owners: 'File owner information (displayName, emailAddress, etc.)'
+};
+var DRIVE_FILE_COMMON_PATTERNS = [
+    {
+        name: 'Bulk operations (delete/move)',
+        fields: 'id,name',
+        tokens: '~20 tokens/file'
+    },
+    {
+        name: 'Browsing/filtering',
+        fields: 'id,name,mimeType,modifiedTime',
+        tokens: '~40 tokens/file'
+    },
+    {
+        name: 'Full metadata',
+        fields: 'id,name,mimeType,webViewLink,modifiedTime,owners',
+        tokens: '~80 tokens/file'
+    }
+];
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/schemas/drive-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/schemas/drive-validation.ts"],"sourcesContent":["import { z } from 'zod';\n\n// Drive file schema\nexport const DriveFileSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().optional(),\n  mimeType: z.string().optional().describe('MIME type of the file (e.g., application/pdf, image/png)'),\n  webViewLink: z.string().optional().describe('URL to view the file in Google Drive'),\n  webContentLink: z.string().optional().describe('Direct download link for the file'),\n  modifiedTime: z.string().optional().describe('ISO datetime when file was last modified'),\n  createdTime: z.string().optional().describe('ISO datetime when file was created'),\n  size: z.string().optional().describe('File size in bytes as string'),\n  version: z.string().optional().describe('Version number of the file'),\n  shared: z.boolean().optional().describe('Whether the file is shared with others'),\n  starred: z.boolean().optional().describe('Whether the file is starred by the user'),\n  trashed: z.boolean().optional().describe('Whether the file is in trash'),\n  parents: z\n    .array(\n      z.object({\n        id: z.string().describe('Parent folder ID'),\n        name: z.string().describe('Parent folder name'),\n      })\n    )\n    .optional()\n    .describe('Parent folders with ID and name'),\n  owners: z\n    .array(\n      z.object({\n        displayName: z.string().optional(),\n        emailAddress: z.string().optional(),\n        kind: z.string().optional().describe('Resource type identifier (e.g., \"drive#user\")'),\n        me: z.boolean().optional().describe('Whether this owner is the current user'),\n        permissionId: z.string().optional().describe('Permission ID for this user'),\n        photoLink: z.string().optional().describe('URL to user profile photo'),\n      })\n    )\n    .optional(),\n  permissions: z\n    .object({\n      canEdit: z.boolean().optional(),\n      canComment: z.boolean().optional(),\n      canShare: z.boolean().optional(),\n    })\n    .optional()\n    .describe(\"Current user's permissions on this file\"),\n});\n\nexport type DriveFile = z.infer<typeof DriveFileSchema>;\n\n// Drive file field definitions for field selection\nexport const DRIVE_FILE_FIELDS = ['id', 'name', 'mimeType', 'webViewLink', 'modifiedTime', 'parents', 'shared', 'starred', 'owners'] as const;\n\nexport const DRIVE_FILE_FIELD_DESCRIPTIONS: Record<(typeof DRIVE_FILE_FIELDS)[number], string> = {\n  id: 'Unique file/folder identifier',\n  name: 'File or folder name',\n  mimeType: 'MIME type (e.g., application/pdf, application/vnd.google-apps.folder)',\n  webViewLink: 'URL to view the file in Google Drive',\n  modifiedTime: 'Last modification timestamp',\n  parents: 'Parent folder IDs',\n  shared: 'Whether the file is shared',\n  starred: 'Whether the file is starred',\n  owners: 'File owner information (displayName, emailAddress, etc.)',\n};\n\nexport const DRIVE_FILE_COMMON_PATTERNS = [\n  {\n    name: 'Bulk operations (delete/move)',\n    fields: 'id,name',\n    tokens: '~20 tokens/file',\n  },\n  {\n    name: 'Browsing/filtering',\n    fields: 'id,name,mimeType,modifiedTime',\n    tokens: '~40 tokens/file',\n  },\n  {\n    name: 'Full metadata',\n    fields: 'id,name,mimeType,webViewLink,modifiedTime,owners',\n    tokens: '~80 tokens/file',\n  },\n] as const;\n"],"names":["DRIVE_FILE_COMMON_PATTERNS","DRIVE_FILE_FIELDS","DRIVE_FILE_FIELD_DESCRIPTIONS","DriveFileSchema","z","object","id","string","optional","name","mimeType","describe","webViewLink","webContentLink","modifiedTime","createdTime","size","version","shared","boolean","starred","trashed","parents","array","owners","displayName","emailAddress","kind","me","permissionId","photoLink","permissions","canEdit","canComment","canShare","fields","tokens"],"mappings":";;;;;;;;;;;QAgEaA;eAAAA;;QAdAC;eAAAA;;QAEAC;eAAAA;;QAjDAC;eAAAA;;;mBAHK;AAGX,IAAMA,kBAAkBC,MAAC,CAACC,MAAM,CAAC;IACtCC,IAAIF,MAAC,CAACG,MAAM,GAAGC,QAAQ;IACvBC,MAAML,MAAC,CAACG,MAAM,GAAGC,QAAQ;IACzBE,UAAUN,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IACzCC,aAAaR,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IAC5CE,gBAAgBT,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IAC/CG,cAAcV,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IAC7CI,aAAaX,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IAC5CK,MAAMZ,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IACrCM,SAASb,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IACxCO,QAAQd,MAAC,CAACe,OAAO,GAAGX,QAAQ,GAAGG,QAAQ,CAAC;IACxCS,SAAShB,MAAC,CAACe,OAAO,GAAGX,QAAQ,GAAGG,QAAQ,CAAC;IACzCU,SAASjB,MAAC,CAACe,OAAO,GAAGX,QAAQ,GAAGG,QAAQ,CAAC;IACzCW,SAASlB,MAAC,CACPmB,KAAK,CACJnB,MAAC,CAACC,MAAM,CAAC;QACPC,IAAIF,MAAC,CAACG,MAAM,GAAGI,QAAQ,CAAC;QACxBF,MAAML,MAAC,CAACG,MAAM,GAAGI,QAAQ,CAAC;IAC5B,IAEDH,QAAQ,GACRG,QAAQ,CAAC;IACZa,QAAQpB,MAAC,CACNmB,KAAK,CACJnB,MAAC,CAACC,MAAM,CAAC;QACPoB,aAAarB,MAAC,CAACG,MAAM,GAAGC,QAAQ;QAChCkB,cAActB,MAAC,CAACG,MAAM,GAAGC,QAAQ;QACjCmB,MAAMvB,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;QACrCiB,IAAIxB,MAAC,CAACe,OAAO,GAAGX,QAAQ,GAAGG,QAAQ,CAAC;QACpCkB,cAAczB,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;QAC7CmB,WAAW1B,MAAC,CAACG,MAAM,GAAGC,QAAQ,GAAGG,QAAQ,CAAC;IAC5C,IAEDH,QAAQ;IACXuB,aAAa3B,MAAC,CACXC,MAAM,CAAC;QACN2B,SAAS5B,MAAC,CAACe,OAAO,GAAGX,QAAQ;QAC7ByB,YAAY7B,MAAC,CAACe,OAAO,GAAGX,QAAQ;QAChC0B,UAAU9B,MAAC,CAACe,OAAO,GAAGX,QAAQ;IAChC,GACCA,QAAQ,GACRG,QAAQ,CAAC;AACd;AAKO,IAAMV,oBAAoB;IAAC;IAAM;IAAQ;IAAY;IAAe;IAAgB;IAAW;IAAU;IAAW;CAAS;AAE7H,IAAMC,gCAAoF;IAC/FI,IAAI;IACJG,MAAM;IACNC,UAAU;IACVE,aAAa;IACbE,cAAc;IACdQ,SAAS;IACTJ,QAAQ;IACRE,SAAS;IACTI,QAAQ;AACV;AAEO,IAAMxB,6BAA6B;IACxC;QACES,MAAM;QACN0B,QAAQ;QACRC,QAAQ;IACV;IACA;QACE3B,MAAM;QACN0B,QAAQ;QACRC,QAAQ;IACV;IACA;QACE3B,MAAM;QACN0B,QAAQ;QACRC,QAAQ;IACV;CACD"}

package/dist/cjs/schemas/index.d.cts

@@ -0,0 +1,2 @@
+export * from './drive-query-schema.js';
+export * from './drive-validation.js';

package/dist/cjs/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from './drive-query-schema.js';
+export * from './drive-validation.js';

package/dist/cjs/schemas/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./drive-query-schema.js"), exports);
+_export_star(require("./drive-validation.js"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/schemas/index.ts"],"sourcesContent":["export * from './drive-query-schema.js';\nexport * from './drive-validation.js';\n"],"names":[],"mappings":";;;;qBAAc;qBACA"}

package/dist/cjs/setup/config.d.cts

@@ -0,0 +1,44 @@
+import type { ServerConfig } from '../types.js';
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */
+export declare function handleVersionHelp(args: string[]): {
+    handled: boolean;
+    output?: string;
+};
+/**
+ * Parse Drive server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/drive
+ */
+export declare function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig;
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */
+export declare function createConfig(): ServerConfig;