Files Connector

Route: /app-connectors/files

Purpose

Files Connector is a drive and file context surface for provider metadata, storage summaries, recent files, and future AI file search.

Boundary

It is not a Google Drive, Dropbox, iCloud Drive, OneDrive, R2, or local file manager replacement.

Current MVP UI

• Provider cards for Google Drive, Dropbox, iCloud Drive, OneDrive, Local Files direction, and R2 Archive direction.
• Recent file cards, file type slices, storage summary metrics, AI context, permission boundary, and data retention notes.

Mock Data Model

The UI uses mock file metadata, file types, source labels, storage usage, and duplicate or archive suggestions.

Future Connectors

Future work may add OAuth drive adapters, local bridge file summaries, R2 archive metadata, and Data Vault indexing.

Alma Capabilities

Alma can later summarize authorized file metadata, search approved file summaries, suggest cleanup, and connect files to artifacts.

Permission Boundaries

Metadata reads, file content reads, uploads, deletes, and external writes are separate scopes. Raw file content requires explicit confirmation.

Backend Status

No filesystem read, browser file handle, Drive API, upload, backend route, or database schema exists.

Security And Privacy

File contents can contain secrets and personal records. Future connectors should prefer summaries, source labels, and scoped retrieval.