car-integrations 0.6.0

OS-native account-bound integrations (Calendar, Contacts, Mail) for CAR
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# car-integrations

Account-bound integrations for [Common Agent Runtime](https://github.com/Parslee-ai/car) — Calendar, Contacts, Mail.

## What it does

The logical capabilities are the same on every OS; the backends are not. v1 defines the **release contract** — stable return shapes that carry explicit `available` + `backend` fields so downstream apps branch cleanly while backends light up incrementally.

| OS | Calendar | Contacts | Mail |
|----|----------|----------|------|
| macOS | EventKit (`EKEventStore`) | Contacts.framework | IMAP/SMTP + AppleScript hint |
| Windows | MS Graph + Outlook MAPI | Windows.Contacts + Graph | MS Graph + MAPI |
| Linux | Evolution DS + CalDAV | Evolution DS + CardDAV | Evolution DS + IMAP/SMTP |

## Dependencies (and honest gaps)

Full operation requires:
- **`car-secrets`** — where credentials and tokens live
- **`car-accounts`** — to know which account a call is bound to
- **`car-permissions`** — to preflight OS consent before the side effect

These are wired as runtime deps but not yet composed inside any backend implementation. v1 wires the API only; backends return Unavailable-with-reason so the release surface is stable before any one adapter is complete.

## Where it fits

Surfaced via the WebSocket `calendar.*`, `contacts.*`, `mail.*` methods. See [`docs/websocket-protocol.md`](../../../docs/websocket-protocol.md).