How cel3brimbor/watagent works
Watagent is a web/native calendar application with Google sign-in, calendar and task management, Google Calendar integration, and an AI chat interface for calendar actions. The main workflow restores or establishes a session, then presents the calendar; users can manage calendar items or use chat and review pending AI changes. The graph shows only relationships visible in the supplied excerpts, SOURCE INDEX references, or explicit calls. Several substantial calendar capabilities are represented, but their internal wiring is not asserted where source was not sampled.
Main entry points: api-base.ts API transport · calendar-app.tsx Calendar workspace · page.tsx Home entry · session.ts Session router
Components 24
App and auth
- Home entry
src/app/page.tsx - Login screen
src/auth/login-screen.tsx - Session router
src/auth/session.ts - Web auth
src/auth/web-session.ts - Native auth
src/auth/native-session.ts - Native OAuth
src/auth/native-oauth.ts
Calendar management
- Calendar workspace
src/calendar/calendar-app.tsx - Calendar state
src/calendar/store.tsx - Calendar views
src/calendar/views - Calendar item API
src/calendar/client.ts - Google Calendar sync
src/calendar/google-calendar-client.ts - Calendar import
src/calendar/calendar-import-panel.tsx - Calendar preferences
src/calendar/calendar-preferences-doc.ts - AI approval panel
src/calendar/ai-approval-panel.tsx - Approval client
src/calendar/approval-client.ts
AI assistant
- Chat panel
src/agent/calendar-chat-panel.tsx - Chat snapshots
src/agent/snapshots-client.ts - Chat stream
src/agent/stream.ts
Shared platform
- Secure token store
src/security/secure-store.ts - API transport
src/shared/api-base.ts
Other components
- User
- Watagent API
- Google Calendar
- Supabase auth
Connections 29
- User → Home entry: opens
src/app/page.tsx - Home entry → Session router: restores session
src/app/page.tsx - Home entry → Login screen: shows signed out
src/app/page.tsx - Home entry → Calendar state: provides state
src/app/page.tsx - Home entry → Calendar workspace: renders
src/app/page.tsx - Login screen → Session router: signs in
src/auth/login-page.tsx - Session router → Web auth: selects web driver
src/auth/session.ts - Session router → Native auth: selects native driver
src/auth/session.ts - Native auth → Native OAuth: starts OAuth
src/auth/native-session.ts - Native auth → Secure token store: persists token
src/auth/native-session.ts - Web auth → Watagent API: refreshes session
src/auth/web-session.ts - Native auth → Supabase auth: authenticates
src/auth/native-session.ts - API transport → Session router: gets access token
src/shared/api-base.ts - API transport → Watagent API: sends API requests
src/shared/api-base.ts - Calendar item API → API transport: requests item data
src/calendar/client.ts - Google Calendar sync → API transport: requests sync
src/calendar/google-calendar-client.ts - Google Calendar sync → Calendar item API: parses returned items
src/calendar/google-calendar-client.ts - Approval client → API transport: requests approvals
src/calendar/approval-client.ts - Chat snapshots → API transport: loads and saves chats
src/agent/snapshots-client.ts - Chat panel → AI approval panel: renders
src/agent/calendar-chat-panel.tsx - Chat panel → API transport: uses presence behavior
src/agent/calendar-chat-panel.tsx - Google Calendar sync → Google Calendar: connects and syncs
src/calendar/google-calendar-client.ts - Calendar workspace → Calendar views
- Calendar workspace → Chat panel
- Calendar workspace → Google Calendar sync
- Calendar workspace → Calendar import
- Calendar workspace → Calendar preferences
- AI approval panel → Approval client
- Chat panel → Chat stream