Search across Drive and Gmail.

Writes results to mise/ and returns path + summary.
Read the deposited JSON file for full results.

Args:
    query: Search terms. Optional when type or folder_id is set.
    sources: ['drive', 'gmail'] — default: both (drive only in guest mode). Also: 'activity' (recent comments), 'calendar' (recent events with attachments)
    max_results: Maximum results per source
    base_path: Directory for deposits (pass your cwd so files land next to your project, not the MCP server's directory)
    folder_id: Optional Drive folder ID to scope results to immediate children only.
        Non-recursive — only files directly inside this folder are returned.
        When set, forces sources=['drive'] (Gmail has no folder concept).
    type: Optional Drive file type filter. Applies to Drive only.
        Values: folder, doc, spreadsheet, sheet, slides, presentation, pdf, image, video, form

Returns:
    path: Path to deposited search results JSON
    query: The search query
    sources: Sources searched
    drive_count: Number of Drive results
    gmail_count: Number of Gmail results
    activity_count: Number of Activity results
    calendar_count: Number of Calendar results
    cues: Scope notes and warnings

Fetch content to mise/ — auto-detects type (Drive file, Gmail thread, folder).

Pass base_path=cwd. Use attachment= for specific Gmail attachments (Office/PDF/image).
Use recursive=True on folders for full tree. Use tabs= to fetch specific spreadsheet tabs.