Summary

• downloadFile: Downloads any file from Google Drive to a local path. Auto-detects blob files vs Google Workspace files and handles each appropriately.
  • Blob files (PDFs, images, Excel, etc.): downloads raw bytes via files.get with alt: 'media'
  • Google Workspace files (Docs, Sheets, Slides): exports via files.export with text-friendly defaults (Docs -> markdown, Sheets -> CSV, Slides -> plain text)
  • Optional savePath: defaults to current working directory with appropriate filename/extension
  • Text extraction: returns up to 50KB of text content for text-based files alongside saving to disk
  • Stream safety: uses pipeline from node:stream/promises for proper error handling and partial file cleanup
  • Shared Drives: supportsAllDrives: true on all files.get calls

Files changed (3 files, 584 lines)

Test plan

• npm run build -- compiles cleanly
• npm test -- all 172 tests pass (32 new + 140 existing)
• npm run format -- Prettier applied
• Pure unit tests: WORKSPACE_EXPORT_DEFAULTS values, EXPORT_MIME_TO_EXTENSION map, isTextMimeType boundary cases
• Blob download: exact API params, supportsAllDrives, files.export NOT called
• Workspace export: default MIME selection, custom override, files.get NOT called with alt:media
• Text extraction: exact content, absent for binary, 50KB truncation, blob text files
• Optional savePath: cwd defaults, correct extensions for exports
• Error handling: partial file cleanup, unsupported Workspace types