Calendar

Overview

Melian connects to Google Calendar via OAuth and syncs events to a local SQLite cache. She provides proactive reminders before upcoming events, detects scheduling conflicts, and can create or modify events through a draft-based approval workflow. Calendar data feeds the morning briefing and is available to the AI during conversations.

Interfaces

export interface CalendarEvent {
  id: string;
  google_id: string;
  summary: string;
  description: string | null;
  location: string | null;
  start_time: number;   // Unix timestamp
  end_time: number;     // Unix timestamp
  all_day: boolean;
  attendees: Attendee[];
  status: string;       // "confirmed" | "tentative" | "cancelled"
}

export interface CalendarDraft {
  id: string;
  summary: string;
  start_time: number;
  end_time: number;
  attendees: Attendee[];
  status: string;       // "pending" | "approved" | "rejected"
}

Draft Workflow

When Melian creates or modifies an event, it is written as a CalendarDraft with status: "pending" rather than committed to Google Calendar immediately. The dashboard surfaces pending drafts; approving one pushes the event to Google and updates the local cache. Rejecting discards it.

Create/modify request
  └── write CalendarDraft (status: pending)
        ├── approve → push to Google Calendar → sync local cache
        └── reject  → discard draft

Tools

API Endpoints