App Connectors
This legacy documentation folder is kept so older links still resolve. The canonical route group is now /app-connectors, the external platform connector layer f
This legacy documentation folder is kept so older links still resolve. The canonical route group is now /app-connectors, the external platform connector layer for import readiness, provider status, permission previews, disconnect controls, and staged source metadata.
These apps are not replacements for mature external products. They are lightweight OS surfaces for provider placeholders, permission review, mock summaries, and future connector contracts.
Relationship With /app-user
/app-user remains the folder for identity, profile, visitor, notifications, shortcuts, display, and user preferences. /app-connectors sits near /app-track on the desktop as the external import and permission boundary.
Catalog
| Batch | App | Route | Sensitivity | Notes |
|---|---|---|---|---|
| Wall | Connector Wall | /app-connectors/wall | Mixed | Provider status wall and future connector boundary map. |
| Batch 1 | Calendar | /app-connectors/calendar | Medium | Planning and meeting context. |
| Batch 1 | Chat | /app-connectors/chat | Medium | User conversation context, separate from ChatOS. |
| Batch 1 | /app-connectors/email | High | Email intelligence with raw body boundaries. | |
| Batch 1 | Weather | /app-connectors/weather | Medium | Planning context with location boundaries. |
| Batch 1 | Messages | /app-connectors/messages | Medium | OS-native approvals and agent result inbox. |
| Batch 1 | Contacts | /app-connectors/contacts | High | People graph and identity context. |
| Existing | Wallet | /app-connectors/wallet | High | Financial, billing, credits, and usage context. |
| Batch 4 | Game Connectors | /app-connectors/game | Medium | Unified game library connector hub, no real OAuth yet. |
| Batch 2 | Files | /app-connectors/files | Medium | Drive metadata and file context. |
| Batch 2 | Notes | /app-connectors/notes | Medium | Notes, docs, decisions, and research context. |
| Batch 2 | Tasks | /app-connectors/tasks | Medium | Planning, reminders, and task summaries. |
| Batch 2 | Bookmarks | /app-connectors/bookmarks | Medium | Reading and research connector. |
| Batch 2 | Photos | /app-connectors/photos | High | Private media library connector, separate from Moments. |
| Batch 2 | Projects | /app-connectors/projects | Medium | Personal project context hub. |
| Batch 3 | Secrets | /app-connectors/secrets | High | Model-blind secret metadata placeholder. |
| Batch 3 | Places | /app-connectors/places | High | Saved places and opt-in location context. |
| Batch 3 | Health | /app-connectors/health | High | Wellness placeholder, no medical advice. |
| Batch 3 | Project CRM | /app-connectors/project-crm | Medium | Project relationships and follow-ups. |
| Batch 3 | Knowledge Graph | /app-connectors/knowledge-graph | High | Personal OS graph visualization placeholder. |
| Batch 3 | Browser Activity | /app-connectors/browser-activity | High | Opt-in research activity, no history scraping. |
Common UI Model
Connector Wall uses a status wall, detail panel, integration roadmap, and security boundary note. Individual connector apps use:
- connector status and mock data badges
- provider or source cards
- domain-specific content panels
- Alma context panel
- permission boundary panel
- data boundary panel
- not-a-replacement notice
- future connector notes when useful
Common Permission Model
Phase 1 permissions are descriptive only. Metadata and mock summaries can appear in the UI. Raw provider data, external writes, sends, uploads, location history, health data, face recognition, browser history, and secrets are disabled or confirmation-required.
Future production connectors require OAuth scopes, provider adapters, token vault storage, permission policy, audit logs, user confirmation, MCP tool scoping, and redaction for sensitive domains.
Alma Relationship
Alma should consume structured summaries and tool outputs, not raw uncontrolled provider data. Each connector documents what Alma can read, summarize, suggest, and what requires confirmation.
Sensitive domains must stay stricter:
- Secrets must never expose raw values to model context.
- Health must not provide diagnosis or medical advice.
- Places must not read precise location or history by default.
- Photos must not run face recognition or upload media by default.
- Browser Activity must not read ambient browser history.
Photos And Moments
Photos is a private media library connector for albums, device/cloud photo metadata, AI organization drafts, and memory search. Moments remains a separate timeline, story, social, or sharing direction. The two apps may integrate later, but Photos is not a rename or replacement for Moments.
Backend Status
No backend connector work is implemented here. OAuth providers, MCP tools, token vault, provider adapters, sync jobs, webhook ingestion, audit logs, sensitive data redaction, and local-first cache strategy are future work.