@mcp-z/mcp-drive 1.0.7 → 1.0.8

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema, DriveQuerySchema } from '../../schemas/index.ts';\nimport type { Logger } from '../../types.ts';\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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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema, DriveQueryParameterSchema, parseDriveQueryParameter } from '../../schemas/index.ts';\nimport type { Logger } from '../../types.ts';\n\nconst inputSchema = z.object({\n  query: DriveQueryParameterSchema.optional().describe('Structured Drive query object or JSON string. Use rawDriveQuery for raw Drive syntax.'),\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  try {\n    const parsedQuery = parseDriveQueryParameter(query);\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: parsedQuery,\n      resolvePaths,\n      pageSize: validPageSize,\n      pageToken: pageToken ? '[provided]' : undefined,\n      fields: fields || 'all',\n    });\n\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 (parsedQuery && 'rawDriveQuery' in parsedQuery && parsedQuery.rawDriveQuery) {\n      // Object with rawDriveQuery field - use it directly\n      qStr = parsedQuery.rawDriveQuery;\n    } else if (parsedQuery) {\n      // Structured query object - convert to Drive query string\n      const { q } = toDriveQuery(parsedQuery);\n      qStr = q || '';\n    } else {\n      qStr = '';\n    }\n\n    qStr = qStr ? `(${qStr}) and mimeType='${folderMimeType}'` : `mimeType='${folderMimeType}'`;\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: parsedQuery,\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    // Throw McpError for all errors so callers can see Drive validation details\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","DriveQueryParameterSchema","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","parsedQuery","requestedFields","validPageSize","folderMimeType","qStr","q","listOptions","res","folders","parentIds","f","parentId","parentNameMap","parentFetches","filteredItems","message","parseDriveQueryParameter","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","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}

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

@@ -9,6 +9,30 @@ export declare const FieldOperatorSchema: z.ZodObject<{
     $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+/**
+ * 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.
+ */
+export declare const DriveQuerySchema: z.ZodType<DriveQueryObject>;
 export type DriveQueryObject = {
     $and?: DriveQueryObject[];
     $or?: DriveQueryObject[];
@@ -27,13 +51,15 @@ export type DriveQueryObject = {
     owner?: string | FieldOperator;
     rawDriveQuery?: string;
 };
+export type DriveQuery = DriveQueryObject;
 /**
- * Drive query schema that accepts either:
- * - A structured DriveQueryObject with typed fields
- * - A raw Drive query string for advanced use cases
+ * Drive query parameter schema that accepts either:
+ * - A structured DriveQuery object with typed fields
+ * - A JSON string representing that object
  *
  * This provides type safety for common queries while allowing
- * direct Google Drive query syntax when needed.
+ * JSON string input from MCP clients 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 declare const DriveQueryParameterSchema: z.ZodType<DriveQuery | string>;
+export type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;
+export declare function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined;

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

@@ -9,6 +9,30 @@ export declare const FieldOperatorSchema: z.ZodObject<{
     $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+/**
+ * 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.
+ */
+export declare const DriveQuerySchema: z.ZodType<DriveQueryObject>;
 export type DriveQueryObject = {
     $and?: DriveQueryObject[];
     $or?: DriveQueryObject[];
@@ -27,13 +51,15 @@ export type DriveQueryObject = {
     owner?: string | FieldOperator;
     rawDriveQuery?: string;
 };
+export type DriveQuery = DriveQueryObject;
 /**
- * Drive query schema that accepts either:
- * - A structured DriveQueryObject with typed fields
- * - A raw Drive query string for advanced use cases
+ * Drive query parameter schema that accepts either:
+ * - A structured DriveQuery object with typed fields
+ * - A JSON string representing that object
  *
  * This provides type safety for common queries while allowing
- * direct Google Drive query syntax when needed.
+ * JSON string input from MCP clients 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 declare const DriveQueryParameterSchema: z.ZodType<DriveQuery | string>;
+export type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;
+export declare function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined;

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

@@ -9,47 +9,38 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get DriveQueryParameterSchema () {
+        return DriveQueryParameterSchema;
+    },
     get DriveQuerySchema () {
         return DriveQuerySchema;
     },
     get FieldOperatorSchema () {
         return FieldOperatorSchema;
+    },
+    get parseDriveQueryParameter () {
+        return parseDriveQueryParameter;
     }
 });
 var _zod = require("zod");
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 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() {
+var DriveQuerySchema = _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'),
+        $and: _zod.z.array(DriveQuerySchema).optional().describe('Array of conditions that must ALL match'),
+        $or: _zod.z.array(DriveQuerySchema).optional().describe('Array of conditions where ANY must match'),
+        $not: DriveQuerySchema.optional().describe('Nested condition that must NOT match'),
         // File/folder name search
         name: _zod.z.union([
             _zod.z.string().min(1),
@@ -73,7 +64,7 @@ var FieldOperatorSchema = _zod.z.object({
         // 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.'),
+        trashed: _zod.z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash).'),
         // 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)'),
@@ -88,8 +79,25 @@ var FieldOperatorSchema = _zod.z.object({
         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
+var DriveQueryParameterSchema = _zod.z.union([
+    DriveQuerySchema,
+    _zod.z.string().min(1)
 ]);
+function parseDriveQueryParameter(input) {
+    if (input === undefined) return undefined;
+    var raw = typeof input === 'string' ? safeJsonParse(input, 'rawDriveQuery') : input;
+    var validated = DriveQuerySchema.safeParse(raw);
+    if (!validated.success) {
+        throw new Error("Invalid query JSON: ".concat(validated.error.message, '. Use {"rawDriveQuery":"<query>"} for Drive syntax.'));
+    }
+    return validated.data;
+}
+function safeJsonParse(value, rawField) {
+    try {
+        return JSON.parse(value);
+    } catch (error) {
+        var message = _instanceof(error, Error) ? error.message : 'Invalid JSON';
+        throw new Error("Query must be valid JSON. ".concat(message, '. Wrap Drive syntax in {"').concat(rawField, '":"<query>"} if needed.'));
+    }
+}
 /* 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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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 */\nexport const 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":";;;;;;;;;;;QAoIaA;eAAAA;;QA9HAC;eAAAA;;;mBANK;AAMX,IAAMA,sBAAsBC,MAAC,CACjCC,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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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 */\nexport const 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 */\nexport const DriveQuerySchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(DriveQuerySchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(DriveQuerySchema).optional().describe('Array of conditions where ANY must match'),\n      $not: DriveQuerySchema.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).'),\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\nexport type DriveQuery = DriveQueryObject;\n\n/**\n * Drive query parameter schema that accepts either:\n * - A structured DriveQuery object with typed fields\n * - A JSON string representing that object\n *\n * This provides type safety for common queries while allowing\n * JSON string input from MCP clients when needed.\n */\nexport const DriveQueryParameterSchema = z.union([DriveQuerySchema, z.string().min(1)]) as z.ZodType<DriveQuery | string>;\nexport type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;\n\nexport function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined {\n  if (input === undefined) return undefined;\n  const raw = typeof input === 'string' ? safeJsonParse(input, 'rawDriveQuery') : input;\n  const validated = DriveQuerySchema.safeParse(raw);\n  if (!validated.success) {\n    throw new Error(`Invalid query JSON: ${validated.error.message}. Use {\"rawDriveQuery\":\"<query>\"} for Drive syntax.`);\n  }\n  return validated.data;\n}\n\nfunction safeJsonParse(value: string, rawField: 'rawDriveQuery'): unknown {\n  try {\n    return JSON.parse(value);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Invalid JSON';\n    throw new Error(`Query must be valid JSON. ${message}. Wrap Drive syntax in {\"${rawField}\":\"<query>\"} if needed.`);\n  }\n}\n"],"names":["DriveQueryParameterSchema","DriveQuerySchema","FieldOperatorSchema","parseDriveQueryParameter","z","object","$any","array","string","optional","describe","$all","$none","strict","lazy","$and","$or","$not","name","union","min","mimeType","fullText","parentId","starred","boolean","sharedWithMe","trashed","modifiedTime","$gte","regex","$lt","owner","rawDriveQuery","input","undefined","raw","safeJsonParse","validated","safeParse","success","Error","error","message","data","value","rawField","JSON","parse"],"mappings":";;;;;;;;;;;QAsIaA;eAAAA;;QA/FAC;eAAAA;;QAjCAC;eAAAA;;QAmIGC;eAAAA;;;mBAzIE;;;;;;;;AAMX,IAAMD,sBAAsBE,MAAC,CACjCC,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;AA2BF,IAAMZ,mBAAmBG,MAAC,CAACU,IAAI,CAAC;WACrCV,MAAC,CACEC,MAAM,CAAC;QACN,yDAAyD;QACzDU,MAAMX,MAAC,CAACG,KAAK,CAACN,kBAAkBQ,QAAQ,GAAGC,QAAQ,CAAC;QACpDM,KAAKZ,MAAC,CAACG,KAAK,CAACN,kBAAkBQ,QAAQ,GAAGC,QAAQ,CAAC;QACnDO,MAAMhB,iBAAiBQ,QAAQ,GAAGC,QAAQ,CAAC;QAE3C,0BAA0B;QAC1BQ,MAAMd,MAAC,CACJe,KAAK,CAAC;YAACf,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;YAAIlB;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,sBAAsB;QACtBW,UAAUjB,MAAC,CACRe,KAAK,CAAC;YAACf,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;YAAIlB;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,+CAA+C;QAC/CY,UAAUlB,MAAC,CACRe,KAAK,CAAC;YAACf,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;YAAIlB;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,0BAA0B;QAC1Ba,UAAUnB,MAAC,CACRe,KAAK,CAAC;YAACf,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;YAAIlB;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,gBAAgB;QAChBc,SAASpB,MAAC,CAACqB,OAAO,GAAGhB,QAAQ,GAAGC,QAAQ,CAAC;QACzCgB,cAActB,MAAC,CAACqB,OAAO,GAAGhB,QAAQ,GAAGC,QAAQ,CAAC;QAC9CiB,SAASvB,MAAC,CAACqB,OAAO,GAAGhB,QAAQ,GAAGC,QAAQ,CAAC;QAEzC,uBAAuB;QACvBkB,cAAcxB,MAAC,CACZC,MAAM,CAAC;YACNwB,MAAMzB,MAAC,CACJI,MAAM,GACNsB,KAAK,CAAC,uDACNrB,QAAQ,GACRC,QAAQ,CAAC;YACZqB,KAAK3B,MAAC,CACHI,MAAM,GACNsB,KAAK,CAAC,uDACNrB,QAAQ,GACRC,QAAQ,CAAC;QACd,GACCD,QAAQ,GACRC,QAAQ,CAAC;QAEZ,kBAAkB;QAClBsB,OAAO5B,MAAC,CACLe,KAAK,CAAC;YAACf,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;YAAIlB;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,4DAA4D;QAC5DuB,eAAe7B,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC,GAAGX,QAAQ,GAAGC,QAAQ,CAAC;IACvD,GACCG,MAAM;;AAgCJ,IAAMb,4BAA4BI,MAAC,CAACe,KAAK,CAAC;IAAClB;IAAkBG,MAAC,CAACI,MAAM,GAAGY,GAAG,CAAC;CAAG;AAG/E,SAASjB,yBAAyB+B,KAAsC;IAC7E,IAAIA,UAAUC,WAAW,OAAOA;IAChC,IAAMC,MAAM,OAAOF,UAAU,WAAWG,cAAcH,OAAO,mBAAmBA;IAChF,IAAMI,YAAYrC,iBAAiBsC,SAAS,CAACH;IAC7C,IAAI,CAACE,UAAUE,OAAO,EAAE;QACtB,MAAM,IAAIC,MAAM,AAAC,uBAA8C,OAAxBH,UAAUI,KAAK,CAACC,OAAO,EAAC;IACjE;IACA,OAAOL,UAAUM,IAAI;AACvB;AAEA,SAASP,cAAcQ,KAAa,EAAEC,QAAyB;IAC7D,IAAI;QACF,OAAOC,KAAKC,KAAK,CAACH;IACpB,EAAE,OAAOH,OAAO;QACd,IAAMC,UAAUD,AAAK,YAALA,OAAiBD,SAAQC,MAAMC,OAAO,GAAG;QACzD,MAAM,IAAIF,MAAM,AAAC,6BAA+DK,OAAnCH,SAAQ,6BAAoC,OAATG,UAAS;IAC3F;AACF"}

package/dist/esm/lib/query-builder.d.ts

@@ -36,9 +36,9 @@ interface FiltersObject {
  * - sharedWithMe = true - Filter by shared status
  * - modifiedTime >= 'date' - Date filtering
  * - 'email' in owners - Filter by owner
- * - trashed = false - Exclude trashed files (always added)
+ * - trashed = true/false - Filter by trash status
  */
-export declare function toDriveQuery(query: DriveQuery): {
+export declare function toDriveQuery(query: DriveQuery | string): {
     q: string;
     filters: FiltersObject;
 };

package/dist/esm/lib/query-builder.js

@@ -14,7 +14,7 @@
  * - sharedWithMe = true - Filter by shared status
  * - modifiedTime >= 'date' - Date filtering
  * - 'email' in owners - Filter by owner
- * - trashed = false - Exclude trashed files (always added)
+ * - trashed = true/false - Filter by trash status
  */ export function toDriveQuery(query) {
     // Handle string queries - return as raw query with empty filters
     if (typeof query === 'string') {

package/dist/esm/lib/query-builder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/lib/query-builder.ts"],"sourcesContent":["import type { DriveQuery, DriveQueryObject } from '../schemas/drive-query-schema.ts';\n\n/**\n * Field operator interface for query filters\n */\nexport interface FieldOperator {\n  $any?: string[];\n  $all?: string[];\n  $none?: string[];\n}\n\n/**\n * Filters object returned by toDriveQuery for debugging/logging\n */\ninterface FiltersObject {\n  nameIncludes?: string[];\n  mimeTypeIncludes?: string[];\n  fullTextIncludes?: string[];\n  parentIdIncludes?: string[];\n  ownerIncludes?: string[];\n  starred?: boolean;\n  sharedWithMe?: boolean;\n  trashed?: boolean;\n}\n\n/**\n * Convert structured DriveQuery to Google Drive query string\n *\n * Accepts either:\n * - A raw Drive query string (returned as-is)\n * - A structured DriveQueryObject (converted to Drive query syntax)\n *\n * Drive query syntax reference:\n * - name contains 'text' - Search by filename\n * - mimeType = 'type' - Filter by MIME type\n * - fullText contains 'text' - Search content and metadata\n * - 'parent_id' in parents - Search in folder\n * - starred = true/false - Filter by starred status\n * - sharedWithMe = true - Filter by shared status\n * - modifiedTime >= 'date' - Date filtering\n * - 'email' in owners - Filter by owner\n * - trashed = false - Exclude trashed files (always added)\n */\nexport function toDriveQuery(query: DriveQuery): {\n  q: string;\n  filters: FiltersObject;\n} {\n  // Handle string queries - return as raw query with empty filters\n  if (typeof query === 'string') {\n    return { q: query, filters: {} };\n  }\n  const nameIncludes: string[] = [];\n  const mimeTypeIncludes: string[] = [];\n  const fullTextIncludes: string[] = [];\n  const parentIdIncludes: string[] = [];\n  const ownerIncludes: string[] = [];\n\n  let starredFlag: boolean | undefined;\n  let sharedWithMeFlag: boolean | undefined;\n  let trashedFlag: boolean | undefined;\n\n  function p(s: unknown) {\n    return `(${String(s ?? '')})`;\n  }\n\n  function quote(s?: unknown) {\n    const str = String(s ?? '');\n    // Escape single quotes for Drive query syntax\n    return `'${str.replace(/'/g, \"\\\\'\")}'`;\n  }\n\n  function fv(field: string, raw?: unknown) {\n    const rawVal = String(raw ?? '');\n    const v = quote(rawVal);\n\n    if (field === 'name') {\n      nameIncludes.push(rawVal);\n      return `name contains ${v}`;\n    }\n    if (field === 'mimeType') {\n      mimeTypeIncludes.push(rawVal);\n      return `mimeType = ${v}`;\n    }\n    if (field === 'fullText') {\n      fullTextIncludes.push(rawVal);\n      return `fullText contains ${v}`;\n    }\n    if (field === 'parentId') {\n      parentIdIncludes.push(rawVal);\n      return `${v} in parents`;\n    }\n    if (field === 'owner') {\n      ownerIncludes.push(rawVal);\n      return `${v} in owners`;\n    }\n\n    return '';\n  }\n\n  function chain(op: 'and' | 'or', arr: string[]) {\n    const filtered = arr.filter((s) => s && s.trim() !== '');\n    if (filtered.length === 0) return '';\n    if (filtered.length === 1) {\n      const first = filtered[0];\n      return first ?? '';\n    }\n    return p(filtered.join(` ${op} `));\n  }\n\n  function fieldExpr(field: string, op: FieldOperator) {\n    if (op.$any) {\n      const nonEmpty = op.$any.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? chain('or', results) : '';\n    }\n    if (op.$all) {\n      const nonEmpty = op.$all.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? chain('and', results) : '';\n    }\n    if (op.$none) {\n      const nonEmpty = op.$none.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? `not ${p(chain('or', results))}` : '';\n    }\n    throw new Error(`Unknown field operator ${JSON.stringify(op)}`);\n  }\n\n  function dateExpr(d: { $gte?: string; $lt?: string }) {\n    const parts: string[] = [];\n    if (d.$gte) parts.push(`modifiedTime >= '${d.$gte}'`);\n    if (d.$lt) parts.push(`modifiedTime < '${d.$lt}'`);\n    return parts.length > 1 ? p(parts.join(' and ')) : (parts[0] ?? '');\n  }\n\n  function fieldKeys() {\n    return ['name', 'mimeType', 'fullText', 'parentId', 'owner'];\n  }\n\n  function emit(n: DriveQueryObject): string {\n    if (n.$and) return p(n.$and.map(emit).join(' and '));\n    if (n.$or) return p(n.$or.map(emit).join(' or '));\n    if (n.$not) return `not ${emit(n.$not)}`;\n\n    const expressions: string[] = [];\n\n    if (typeof n.starred === 'boolean') {\n      starredFlag = n.starred;\n      expressions.push(`starred = ${n.starred}`);\n    }\n    if (typeof n.sharedWithMe === 'boolean') {\n      sharedWithMeFlag = n.sharedWithMe;\n      expressions.push(`sharedWithMe = ${n.sharedWithMe}`);\n    }\n    if (typeof n.trashed === 'boolean') {\n      trashedFlag = n.trashed;\n      expressions.push(`trashed = ${n.trashed}`);\n    }\n    if (n.modifiedTime) {\n      expressions.push(dateExpr(n.modifiedTime));\n    }\n\n    for (const k of fieldKeys()) {\n      if (typeof n === 'object' && n !== null && k in n) {\n        const op = (n as Record<string, string | FieldOperator>)[k];\n        const normalizedOp: FieldOperator = typeof op === 'string' ? { $any: [op] } : (op ?? {});\n        const result = fieldExpr(k, normalizedOp);\n        if (result.trim() !== '') {\n          expressions.push(result);\n        }\n      }\n    }\n\n    // Handle empty objects\n    if (expressions.length === 0 && typeof n === 'object' && n !== null && Object.keys(n).length === 0) {\n      return '';\n    }\n\n    // Combine multiple expressions with AND\n    if (expressions.length > 1) {\n      return chain('and', expressions);\n    }\n    if (expressions.length === 1) {\n      return expressions[0] ?? '';\n    }\n\n    throw new Error(`Unknown node: ${JSON.stringify(n)}`);\n  }\n\n  function emitTop(n: DriveQueryObject): string {\n    if (!n) return '';\n\n    // Handle empty objects\n    if (typeof n === 'object' && n !== null && Object.keys(n).length === 0) return '';\n\n    if (n.$and) return n.$and.map(emit).join(' and ');\n    if (n.$or) return n.$or.map(emit).join(' or ');\n    if (n.$not) return `not ${emit(n.$not)}`;\n\n    const result = emit(n);\n    return result.trim() === '' ? '' : result;\n  }\n\n  const q = emitTop(query);\n  const cleanedQuery = q.replace(/\\s+and\\s+$|\\s+or\\s+$|^\\s+and\\s+|^\\s+or\\s+/gi, '').trim();\n\n  const filters: FiltersObject = {};\n  if (nameIncludes.length) filters.nameIncludes = nameIncludes;\n  if (mimeTypeIncludes.length) filters.mimeTypeIncludes = mimeTypeIncludes;\n  if (fullTextIncludes.length) filters.fullTextIncludes = fullTextIncludes;\n  if (parentIdIncludes.length) filters.parentIdIncludes = parentIdIncludes;\n  if (ownerIncludes.length) filters.ownerIncludes = ownerIncludes;\n  // Use tracked flags from emit() to capture nested boolean conditions\n  if (typeof starredFlag === 'boolean') filters.starred = starredFlag;\n  if (typeof sharedWithMeFlag === 'boolean') filters.sharedWithMe = sharedWithMeFlag;\n  if (typeof trashedFlag === 'boolean') filters.trashed = trashedFlag;\n\n  return { q: cleanedQuery ?? '', filters };\n}\n"],"names":["toDriveQuery","query","q","filters","nameIncludes","mimeTypeIncludes","fullTextIncludes","parentIdIncludes","ownerIncludes","starredFlag","sharedWithMeFlag","trashedFlag","p","s","String","quote","str","replace","fv","field","raw","rawVal","v","push","chain","op","arr","filtered","filter","trim","length","first","join","fieldExpr","$any","nonEmpty","results","map","result","$all","$none","Error","JSON","stringify","dateExpr","d","parts","$gte","$lt","fieldKeys","emit","n","$and","$or","$not","expressions","starred","sharedWithMe","trashed","modifiedTime","k","normalizedOp","Object","keys","emitTop","cleanedQuery"],"mappings":"AAyBA;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASA,aAAaC,KAAiB;IAI5C,iEAAiE;IACjE,IAAI,OAAOA,UAAU,UAAU;QAC7B,OAAO;YAAEC,GAAGD;YAAOE,SAAS,CAAC;QAAE;IACjC;IACA,MAAMC,eAAyB,EAAE;IACjC,MAAMC,mBAA6B,EAAE;IACrC,MAAMC,mBAA6B,EAAE;IACrC,MAAMC,mBAA6B,EAAE;IACrC,MAAMC,gBAA0B,EAAE;IAElC,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAEJ,SAASC,EAAEC,CAAU;QACnB,OAAO,CAAC,CAAC,EAAEC,OAAOD,cAAAA,eAAAA,IAAK,IAAI,CAAC,CAAC;IAC/B;IAEA,SAASE,MAAMF,CAAW;QACxB,MAAMG,MAAMF,OAAOD,cAAAA,eAAAA,IAAK;QACxB,8CAA8C;QAC9C,OAAO,CAAC,CAAC,EAAEG,IAAIC,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC;IACxC;IAEA,SAASC,GAAGC,KAAa,EAAEC,GAAa;QACtC,MAAMC,SAASP,OAAOM,gBAAAA,iBAAAA,MAAO;QAC7B,MAAME,IAAIP,MAAMM;QAEhB,IAAIF,UAAU,QAAQ;YACpBf,aAAamB,IAAI,CAACF;YAClB,OAAO,CAAC,cAAc,EAAEC,GAAG;QAC7B;QACA,IAAIH,UAAU,YAAY;YACxBd,iBAAiBkB,IAAI,CAACF;YACtB,OAAO,CAAC,WAAW,EAAEC,GAAG;QAC1B;QACA,IAAIH,UAAU,YAAY;YACxBb,iBAAiBiB,IAAI,CAACF;YACtB,OAAO,CAAC,kBAAkB,EAAEC,GAAG;QACjC;QACA,IAAIH,UAAU,YAAY;YACxBZ,iBAAiBgB,IAAI,CAACF;YACtB,OAAO,GAAGC,EAAE,WAAW,CAAC;QAC1B;QACA,IAAIH,UAAU,SAAS;YACrBX,cAAce,IAAI,CAACF;YACnB,OAAO,GAAGC,EAAE,UAAU,CAAC;QACzB;QAEA,OAAO;IACT;IAEA,SAASE,MAAMC,EAAgB,EAAEC,GAAa;QAC5C,MAAMC,WAAWD,IAAIE,MAAM,CAAC,CAACf,IAAMA,KAAKA,EAAEgB,IAAI,OAAO;QACrD,IAAIF,SAASG,MAAM,KAAK,GAAG,OAAO;QAClC,IAAIH,SAASG,MAAM,KAAK,GAAG;YACzB,MAAMC,QAAQJ,QAAQ,CAAC,EAAE;YACzB,OAAOI,kBAAAA,mBAAAA,QAAS;QAClB;QACA,OAAOnB,EAAEe,SAASK,IAAI,CAAC,CAAC,CAAC,EAAEP,GAAG,CAAC,CAAC;IAClC;IAEA,SAASQ,UAAUd,KAAa,EAAEM,EAAiB;QACjD,IAAIA,GAAGS,IAAI,EAAE;YACX,MAAMC,WAAWV,GAAGS,IAAI,CAACN,MAAM,CAAC,CAACN,IAAcR,OAAOQ,cAAAA,eAAAA,IAAK,IAAIO,IAAI,OAAO;YAC1E,MAAMO,UAAUD,SAASE,GAAG,CAAC,CAACf,IAAcJ,GAAGC,OAAOL,OAAOQ,cAAAA,eAAAA,IAAK,MAAMM,MAAM,CAAC,CAACU,SAAmBA,OAAOT,IAAI,OAAO;YACrH,OAAOO,QAAQN,MAAM,GAAG,IAAIN,MAAM,MAAMY,WAAW;QACrD;QACA,IAAIX,GAAGc,IAAI,EAAE;YACX,MAAMJ,WAAWV,GAAGc,IAAI,CAACX,MAAM,CAAC,CAACN,IAAcR,OAAOQ,cAAAA,eAAAA,IAAK,IAAIO,IAAI,OAAO;YAC1E,MAAMO,UAAUD,SAASE,GAAG,CAAC,CAACf,IAAcJ,GAAGC,OAAOL,OAAOQ,cAAAA,eAAAA,IAAK,MAAMM,MAAM,CAAC,CAACU,SAAmBA,OAAOT,IAAI,OAAO;YACrH,OAAOO,QAAQN,MAAM,GAAG,IAAIN,MAAM,OAAOY,WAAW;QACtD;QACA,IAAIX,GAAGe,KAAK,EAAE;YACZ,MAAML,WAAWV,GAAGe,KAAK,CAACZ,MAAM,CAAC,CAACN,IAAcR,OAAOQ,cAAAA,eAAAA,IAAK,IAAIO,IAAI,OAAO;YAC3E,MAAMO,UAAUD,SAASE,GAAG,CAAC,CAACf,IAAcJ,GAAGC,OAAOL,OAAOQ,cAAAA,eAAAA,IAAK,MAAMM,MAAM,CAAC,CAACU,SAAmBA,OAAOT,IAAI,OAAO;YACrH,OAAOO,QAAQN,MAAM,GAAG,IAAI,CAAC,IAAI,EAAElB,EAAEY,MAAM,MAAMY,WAAW,GAAG;QACjE;QACA,MAAM,IAAIK,MAAM,CAAC,uBAAuB,EAAEC,KAAKC,SAAS,CAAClB,KAAK;IAChE;IAEA,SAASmB,SAASC,CAAkC;YAIEC;QAHpD,MAAMA,QAAkB,EAAE;QAC1B,IAAID,EAAEE,IAAI,EAAED,MAAMvB,IAAI,CAAC,CAAC,iBAAiB,EAAEsB,EAAEE,IAAI,CAAC,CAAC,CAAC;QACpD,IAAIF,EAAEG,GAAG,EAAEF,MAAMvB,IAAI,CAAC,CAAC,gBAAgB,EAAEsB,EAAEG,GAAG,CAAC,CAAC,CAAC;QACjD,OAAOF,MAAMhB,MAAM,GAAG,IAAIlB,EAAEkC,MAAMd,IAAI,CAAC,aAAac,UAAAA,KAAK,CAAC,EAAE,cAARA,qBAAAA,UAAY;IAClE;IAEA,SAASG;QACP,OAAO;YAAC;YAAQ;YAAY;YAAY;YAAY;SAAQ;IAC9D;IAEA,SAASC,KAAKC,CAAmB;QAC/B,IAAIA,EAAEC,IAAI,EAAE,OAAOxC,EAAEuC,EAAEC,IAAI,CAACf,GAAG,CAACa,MAAMlB,IAAI,CAAC;QAC3C,IAAImB,EAAEE,GAAG,EAAE,OAAOzC,EAAEuC,EAAEE,GAAG,CAAChB,GAAG,CAACa,MAAMlB,IAAI,CAAC;QACzC,IAAImB,EAAEG,IAAI,EAAE,OAAO,CAAC,IAAI,EAAEJ,KAAKC,EAAEG,IAAI,GAAG;QAExC,MAAMC,cAAwB,EAAE;QAEhC,IAAI,OAAOJ,EAAEK,OAAO,KAAK,WAAW;YAClC/C,cAAc0C,EAAEK,OAAO;YACvBD,YAAYhC,IAAI,CAAC,CAAC,UAAU,EAAE4B,EAAEK,OAAO,EAAE;QAC3C;QACA,IAAI,OAAOL,EAAEM,YAAY,KAAK,WAAW;YACvC/C,mBAAmByC,EAAEM,YAAY;YACjCF,YAAYhC,IAAI,CAAC,CAAC,eAAe,EAAE4B,EAAEM,YAAY,EAAE;QACrD;QACA,IAAI,OAAON,EAAEO,OAAO,KAAK,WAAW;YAClC/C,cAAcwC,EAAEO,OAAO;YACvBH,YAAYhC,IAAI,CAAC,CAAC,UAAU,EAAE4B,EAAEO,OAAO,EAAE;QAC3C;QACA,IAAIP,EAAEQ,YAAY,EAAE;YAClBJ,YAAYhC,IAAI,CAACqB,SAASO,EAAEQ,YAAY;QAC1C;QAEA,KAAK,MAAMC,KAAKX,YAAa;YAC3B,IAAI,OAAOE,MAAM,YAAYA,MAAM,QAAQS,KAAKT,GAAG;gBACjD,MAAM1B,KAAK,AAAC0B,CAA4C,CAACS,EAAE;gBAC3D,MAAMC,eAA8B,OAAOpC,OAAO,WAAW;oBAAES,MAAM;wBAACT;qBAAG;gBAAC,IAAKA,eAAAA,gBAAAA,KAAM,CAAC;gBACtF,MAAMa,SAASL,UAAU2B,GAAGC;gBAC5B,IAAIvB,OAAOT,IAAI,OAAO,IAAI;oBACxB0B,YAAYhC,IAAI,CAACe;gBACnB;YACF;QACF;QAEA,uBAAuB;QACvB,IAAIiB,YAAYzB,MAAM,KAAK,KAAK,OAAOqB,MAAM,YAAYA,MAAM,QAAQW,OAAOC,IAAI,CAACZ,GAAGrB,MAAM,KAAK,GAAG;YAClG,OAAO;QACT;QAEA,wCAAwC;QACxC,IAAIyB,YAAYzB,MAAM,GAAG,GAAG;YAC1B,OAAON,MAAM,OAAO+B;QACtB;QACA,IAAIA,YAAYzB,MAAM,KAAK,GAAG;gBACrByB;YAAP,QAAOA,gBAAAA,WAAW,CAAC,EAAE,cAAdA,2BAAAA,gBAAkB;QAC3B;QAEA,MAAM,IAAId,MAAM,CAAC,cAAc,EAAEC,KAAKC,SAAS,CAACQ,IAAI;IACtD;IAEA,SAASa,QAAQb,CAAmB;QAClC,IAAI,CAACA,GAAG,OAAO;QAEf,uBAAuB;QACvB,IAAI,OAAOA,MAAM,YAAYA,MAAM,QAAQW,OAAOC,IAAI,CAACZ,GAAGrB,MAAM,KAAK,GAAG,OAAO;QAE/E,IAAIqB,EAAEC,IAAI,EAAE,OAAOD,EAAEC,IAAI,CAACf,GAAG,CAACa,MAAMlB,IAAI,CAAC;QACzC,IAAImB,EAAEE,GAAG,EAAE,OAAOF,EAAEE,GAAG,CAAChB,GAAG,CAACa,MAAMlB,IAAI,CAAC;QACvC,IAAImB,EAAEG,IAAI,EAAE,OAAO,CAAC,IAAI,EAAEJ,KAAKC,EAAEG,IAAI,GAAG;QAExC,MAAMhB,SAASY,KAAKC;QACpB,OAAOb,OAAOT,IAAI,OAAO,KAAK,KAAKS;IACrC;IAEA,MAAMpC,IAAI8D,QAAQ/D;IAClB,MAAMgE,eAAe/D,EAAEe,OAAO,CAAC,+CAA+C,IAAIY,IAAI;IAEtF,MAAM1B,UAAyB,CAAC;IAChC,IAAIC,aAAa0B,MAAM,EAAE3B,QAAQC,YAAY,GAAGA;IAChD,IAAIC,iBAAiByB,MAAM,EAAE3B,QAAQE,gBAAgB,GAAGA;IACxD,IAAIC,iBAAiBwB,MAAM,EAAE3B,QAAQG,gBAAgB,GAAGA;IACxD,IAAIC,iBAAiBuB,MAAM,EAAE3B,QAAQI,gBAAgB,GAAGA;IACxD,IAAIC,cAAcsB,MAAM,EAAE3B,QAAQK,aAAa,GAAGA;IAClD,qEAAqE;IACrE,IAAI,OAAOC,gBAAgB,WAAWN,QAAQqD,OAAO,GAAG/C;IACxD,IAAI,OAAOC,qBAAqB,WAAWP,QAAQsD,YAAY,GAAG/C;IAClE,IAAI,OAAOC,gBAAgB,WAAWR,QAAQuD,OAAO,GAAG/C;IAExD,OAAO;QAAET,CAAC,EAAE+D,yBAAAA,0BAAAA,eAAgB;QAAI9D;IAAQ;AAC1C"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/lib/query-builder.ts"],"sourcesContent":["import type { DriveQuery, DriveQueryObject } from '../schemas/drive-query-schema.ts';\n\n/**\n * Field operator interface for query filters\n */\nexport interface FieldOperator {\n  $any?: string[];\n  $all?: string[];\n  $none?: string[];\n}\n\n/**\n * Filters object returned by toDriveQuery for debugging/logging\n */\ninterface FiltersObject {\n  nameIncludes?: string[];\n  mimeTypeIncludes?: string[];\n  fullTextIncludes?: string[];\n  parentIdIncludes?: string[];\n  ownerIncludes?: string[];\n  starred?: boolean;\n  sharedWithMe?: boolean;\n  trashed?: boolean;\n}\n\n/**\n * Convert structured DriveQuery to Google Drive query string\n *\n * Accepts either:\n * - A raw Drive query string (returned as-is)\n * - A structured DriveQueryObject (converted to Drive query syntax)\n *\n * Drive query syntax reference:\n * - name contains 'text' - Search by filename\n * - mimeType = 'type' - Filter by MIME type\n * - fullText contains 'text' - Search content and metadata\n * - 'parent_id' in parents - Search in folder\n * - starred = true/false - Filter by starred status\n * - sharedWithMe = true - Filter by shared status\n * - modifiedTime >= 'date' - Date filtering\n * - 'email' in owners - Filter by owner\n * - trashed = true/false - Filter by trash status\n */\nexport function toDriveQuery(query: DriveQuery | string): {\n  q: string;\n  filters: FiltersObject;\n} {\n  // Handle string queries - return as raw query with empty filters\n  if (typeof query === 'string') {\n    return { q: query, filters: {} };\n  }\n  const nameIncludes: string[] = [];\n  const mimeTypeIncludes: string[] = [];\n  const fullTextIncludes: string[] = [];\n  const parentIdIncludes: string[] = [];\n  const ownerIncludes: string[] = [];\n\n  let starredFlag: boolean | undefined;\n  let sharedWithMeFlag: boolean | undefined;\n  let trashedFlag: boolean | undefined;\n\n  function p(s: unknown) {\n    return `(${String(s ?? '')})`;\n  }\n\n  function quote(s?: unknown) {\n    const str = String(s ?? '');\n    // Escape single quotes for Drive query syntax\n    return `'${str.replace(/'/g, \"\\\\'\")}'`;\n  }\n\n  function fv(field: string, raw?: unknown) {\n    const rawVal = String(raw ?? '');\n    const v = quote(rawVal);\n\n    if (field === 'name') {\n      nameIncludes.push(rawVal);\n      return `name contains ${v}`;\n    }\n    if (field === 'mimeType') {\n      mimeTypeIncludes.push(rawVal);\n      return `mimeType = ${v}`;\n    }\n    if (field === 'fullText') {\n      fullTextIncludes.push(rawVal);\n      return `fullText contains ${v}`;\n    }\n    if (field === 'parentId') {\n      parentIdIncludes.push(rawVal);\n      return `${v} in parents`;\n    }\n    if (field === 'owner') {\n      ownerIncludes.push(rawVal);\n      return `${v} in owners`;\n    }\n\n    return '';\n  }\n\n  function chain(op: 'and' | 'or', arr: string[]) {\n    const filtered = arr.filter((s) => s && s.trim() !== '');\n    if (filtered.length === 0) return '';\n    if (filtered.length === 1) {\n      const first = filtered[0];\n      return first ?? '';\n    }\n    return p(filtered.join(` ${op} `));\n  }\n\n  function fieldExpr(field: string, op: FieldOperator) {\n    if (op.$any) {\n      const nonEmpty = op.$any.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? chain('or', results) : '';\n    }\n    if (op.$all) {\n      const nonEmpty = op.$all.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? chain('and', results) : '';\n    }\n    if (op.$none) {\n      const nonEmpty = op.$none.filter((v: string) => String(v ?? '').trim() !== '');\n      const results = nonEmpty.map((v: string) => fv(field, String(v ?? ''))).filter((result: string) => result.trim() !== '');\n      return results.length > 0 ? `not ${p(chain('or', results))}` : '';\n    }\n    throw new Error(`Unknown field operator ${JSON.stringify(op)}`);\n  }\n\n  function dateExpr(d: { $gte?: string; $lt?: string }) {\n    const parts: string[] = [];\n    if (d.$gte) parts.push(`modifiedTime >= '${d.$gte}'`);\n    if (d.$lt) parts.push(`modifiedTime < '${d.$lt}'`);\n    return parts.length > 1 ? p(parts.join(' and ')) : (parts[0] ?? '');\n  }\n\n  function fieldKeys() {\n    return ['name', 'mimeType', 'fullText', 'parentId', 'owner'];\n  }\n\n  function emit(n: DriveQueryObject): string {\n    if (n.$and) return p(n.$and.map(emit).join(' and '));\n    if (n.$or) return p(n.$or.map(emit).join(' or '));\n    if (n.$not) return `not ${emit(n.$not)}`;\n\n    const expressions: string[] = [];\n\n    if (typeof n.starred === 'boolean') {\n      starredFlag = n.starred;\n      expressions.push(`starred = ${n.starred}`);\n    }\n    if (typeof n.sharedWithMe === 'boolean') {\n      sharedWithMeFlag = n.sharedWithMe;\n      expressions.push(`sharedWithMe = ${n.sharedWithMe}`);\n    }\n    if (typeof n.trashed === 'boolean') {\n      trashedFlag = n.trashed;\n      expressions.push(`trashed = ${n.trashed}`);\n    }\n    if (n.modifiedTime) {\n      expressions.push(dateExpr(n.modifiedTime));\n    }\n\n    for (const k of fieldKeys()) {\n      if (typeof n === 'object' && n !== null && k in n) {\n        const op = (n as Record<string, string | FieldOperator>)[k];\n        const normalizedOp: FieldOperator = typeof op === 'string' ? { $any: [op] } : (op ?? {});\n        const result = fieldExpr(k, normalizedOp);\n        if (result.trim() !== '') {\n          expressions.push(result);\n        }\n      }\n    }\n\n    // Handle empty objects\n    if (expressions.length === 0 && typeof n === 'object' && n !== null && Object.keys(n).length === 0) {\n      return '';\n    }\n\n    // Combine multiple expressions with AND\n    if (expressions.length > 1) {\n      return chain('and', expressions);\n    }\n    if (expressions.length === 1) {\n      return expressions[0] ?? '';\n    }\n\n    throw new Error(`Unknown node: ${JSON.stringify(n)}`);\n  }\n\n  function emitTop(n: DriveQueryObject): string {\n    if (!n) return '';\n\n    // Handle empty objects\n    if (typeof n === 'object' && n !== null && Object.keys(n).length === 0) return '';\n\n    if (n.$and) return n.$and.map(emit).join(' and ');\n    if (n.$or) return n.$or.map(emit).join(' or ');\n    if (n.$not) return `not ${emit(n.$not)}`;\n\n    const result = emit(n);\n    return result.trim() === '' ? '' : result;\n  }\n\n  const q = emitTop(query);\n  const cleanedQuery = q.replace(/\\s+and\\s+$|\\s+or\\s+$|^\\s+and\\s+|^\\s+or\\s+/gi, '').trim();\n\n  const filters: FiltersObject = {};\n  if (nameIncludes.length) filters.nameIncludes = nameIncludes;\n  if (mimeTypeIncludes.length) filters.mimeTypeIncludes = mimeTypeIncludes;\n  if (fullTextIncludes.length) filters.fullTextIncludes = fullTextIncludes;\n  if (parentIdIncludes.length) filters.parentIdIncludes = parentIdIncludes;\n  if (ownerIncludes.length) filters.ownerIncludes = ownerIncludes;\n  // Use tracked flags from emit() to capture nested boolean conditions\n  if (typeof starredFlag === 'boolean') filters.starred = starredFlag;\n  if (typeof sharedWithMeFlag === 'boolean') filters.sharedWithMe = sharedWithMeFlag;\n  if (typeof trashedFlag === 'boolean') filters.trashed = trashedFlag;\n\n  return { q: cleanedQuery ?? '', filters };\n}\n"],"names":["toDriveQuery","query","q","filters","nameIncludes","mimeTypeIncludes","fullTextIncludes","parentIdIncludes","ownerIncludes","starredFlag","sharedWithMeFlag","trashedFlag","p","s","String","quote","str","replace","fv","field","raw","rawVal","v","push","chain","op","arr","filtered","filter","trim","length","first","join","fieldExpr","$any","nonEmpty","results","map","result","$all","$none","Error","JSON","stringify","dateExpr","d","parts","$gte","$lt","fieldKeys","emit","n","$and","$or","$not","expressions","starred","sharedWithMe","trashed","modifiedTime","k","normalizedOp","Object","keys","emitTop","cleanedQuery"],"mappings":"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"}

package/dist/esm/mcp/prompts/query-syntax.js

@@ -26,7 +26,7 @@ export default function createPrompt() {
 ## Boolean Flags
 - \`starred\`: true/false
 - \`sharedWithMe\`: true/false
-- \`trashed\`: true/false (tools auto-filter trashed by default)
+- \`trashed\`: true/false
 
 ## Date Range
 \`\`\`json

package/dist/esm/mcp/prompts/query-syntax.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/mcp/prompts/query-syntax.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Drive query syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Drive Query Syntax Reference\n\n## Logical Operators\n- \\`$and\\`: Array of conditions that ALL must match\n- \\`$or\\`: Array of conditions where ANY must match\n- \\`$not\\`: Condition that must NOT match\n\n## File/Folder Fields\n- \\`name\\`: Search by name (partial match, case-insensitive)\n- \\`mimeType\\`: Filter by MIME type\n- \\`fullText\\`: Search file content and metadata\n- \\`parentId\\`: Search within folder (use \"root\" for My Drive)\n- \\`owner\\`: Filter by owner email\n\n## Boolean Flags\n- \\`starred\\`: true/false\n- \\`sharedWithMe\\`: true/false\n- \\`trashed\\`: true/false (tools auto-filter trashed by default)\n\n## Date Range\n\\`\\`\\`json\n{ \"modifiedTime\": { \"$gte\": \"2024-01-01\", \"$lt\": \"2024-12-31\" } }\n\\`\\`\\`\n\n## Common MIME Types\n- \\`application/vnd.google-apps.folder\\`: Folders\n- \\`application/vnd.google-apps.document\\`: Google Docs\n- \\`application/vnd.google-apps.spreadsheet\\`: Google Sheets\n- \\`application/vnd.google-apps.presentation\\`: Google Slides\n- \\`application/pdf\\`: PDF files\n- \\`image/jpeg\\`, \\`image/png\\`: Images\n\n## Field Operators (for multi-value fields)\n- \\`$any\\`: OR - matches if ANY value matches\n- \\`$all\\`: AND - matches if ALL values match\n- \\`$none\\`: NOT - matches if NONE match\n\n## Escape Hatch\n- \\`rawDriveQuery\\`: Raw Google Drive query syntax\n\n## Example Queries\n\\`\\`\\`json\n// PDFs modified this year\n{ \"mimeType\": \"application/pdf\", \"modifiedTime\": { \"$gte\": \"2024-01-01\" } }\n\n// Starred spreadsheets\n{ \"mimeType\": \"application/vnd.google-apps.spreadsheet\", \"starred\": true }\n\n// Files in specific folder\n{ \"parentId\": \"1abc123xyz\" }\n\n// Search by name\n{ \"name\": \"budget\" }\n\n// Complex: shared PDFs or Docs\n{ \"$or\": [\n  { \"mimeType\": \"application/pdf\", \"sharedWithMe\": true },\n  { \"mimeType\": \"application/vnd.google-apps.document\", \"sharedWithMe\": true }\n]}\n\\`\\`\\``,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'query-syntax',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA2Db,CAAC;oBACG;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/mcp/prompts/query-syntax.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Drive query syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Drive Query Syntax Reference\n\n## Logical Operators\n- \\`$and\\`: Array of conditions that ALL must match\n- \\`$or\\`: Array of conditions where ANY must match\n- \\`$not\\`: Condition that must NOT match\n\n## File/Folder Fields\n- \\`name\\`: Search by name (partial match, case-insensitive)\n- \\`mimeType\\`: Filter by MIME type\n- \\`fullText\\`: Search file content and metadata\n- \\`parentId\\`: Search within folder (use \"root\" for My Drive)\n- \\`owner\\`: Filter by owner email\n\n## Boolean Flags\n- \\`starred\\`: true/false\n- \\`sharedWithMe\\`: true/false\n- \\`trashed\\`: true/false\n\n## Date Range\n\\`\\`\\`json\n{ \"modifiedTime\": { \"$gte\": \"2024-01-01\", \"$lt\": \"2024-12-31\" } }\n\\`\\`\\`\n\n## Common MIME Types\n- \\`application/vnd.google-apps.folder\\`: Folders\n- \\`application/vnd.google-apps.document\\`: Google Docs\n- \\`application/vnd.google-apps.spreadsheet\\`: Google Sheets\n- \\`application/vnd.google-apps.presentation\\`: Google Slides\n- \\`application/pdf\\`: PDF files\n- \\`image/jpeg\\`, \\`image/png\\`: Images\n\n## Field Operators (for multi-value fields)\n- \\`$any\\`: OR - matches if ANY value matches\n- \\`$all\\`: AND - matches if ALL values match\n- \\`$none\\`: NOT - matches if NONE match\n\n## Escape Hatch\n- \\`rawDriveQuery\\`: Raw Google Drive query syntax\n\n## Example Queries\n\\`\\`\\`json\n// PDFs modified this year\n{ \"mimeType\": \"application/pdf\", \"modifiedTime\": { \"$gte\": \"2024-01-01\" } }\n\n// Starred spreadsheets\n{ \"mimeType\": \"application/vnd.google-apps.spreadsheet\", \"starred\": true }\n\n// Files in specific folder\n{ \"parentId\": \"1abc123xyz\" }\n\n// Search by name\n{ \"name\": \"budget\" }\n\n// Complex: shared PDFs or Docs\n{ \"$or\": [\n  { \"mimeType\": \"application/pdf\", \"sharedWithMe\": true },\n  { \"mimeType\": \"application/vnd.google-apps.document\", \"sharedWithMe\": true }\n]}\n\\`\\`\\``,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'query-syntax',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA2Db,CAAC;oBACG;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}

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

@@ -8,7 +8,7 @@ declare const inputSchema: z.ZodObject<{
     }>>>;
     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>>]>;
+    query: z.ZodType<string | import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown, z.core.$ZodTypeInternals<string | import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown>>;
     fields: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const outputSchema: z.ZodUnion<readonly [z.ZodObject<{
@@ -75,7 +75,7 @@ export default function createTool(): {
             }>>>;
             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>>]>;
+            query: z.ZodType<string | import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown, z.core.$ZodTypeInternals<string | import("../../schemas/drive-query-schema.js").DriveQueryObject, unknown>>;
             fields: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         readonly outputSchema: z.ZodObject<{