System diagram · Canvas calling

System overview

Guest-first calls with optional accounts and an outbound-only AI path.

Zoom 100%

Drag to pan · scroll to zoom · Enter selects

Keyboard: arrows pan · +/− zoom · 0 fit · Esc overview · Enter selects a node.

Text alternative

Same content as the diagram, as a list. Source paths are relative to the repository main branch.

Overview

Guest browser (public Canvas, no login) — saves finals to Local history; calls CloudFront (same origin). Sources: canvas-call-ui.js, canvas-live-context.js.

Local history (final transcripts, export/delete) — browser only. Sources: canvas-transcripts.js.

Accounts, optional (Cognito PKCE, tab session) — JWT Bearer to CloudFront; profile and summary to Accounts store. Drilldown: Auth. Sources: canvas-accounts.js.

CloudFront (same-origin routing) — API to Calling Lambda. Sources: lib/canvas-calling.ts, lib/canvas-accounts.ts.

Calling Lambda (ephemeral rooms and jobs) — sessions and caption JWT to Live media; SQS job to Mac worker. Drilldown: Call. Sources: infra/canvas-calling/handler.py, lib/canvas-calling.ts.

Live media + captions (Chime 2-person, Deepgram) — media and captions to guest. Drilldown: Captions. Sources: infra/canvas-calling/handler.py, canvas-call-ui.js.

Accounts store (compact summaries only) — no raw transcripts or audio. Drilldown: Storage. Sources: canvas-accounts/handler.py, lib/canvas-accounts.ts.

Mac worker (outbound long-poll, no inbound) — request and cited result with O5 Spark model. Drilldown: Delivery. Sources: tools/canvas-mac-worker/worker.py.

O5 Spark model (web-only tools, cited output) — result stored for Job results. Drilldown: AI. Sources: tools/canvas-mac-worker/worker.py, infra/canvas-calling/canvas_ai.py.

Job results (backend poll, citations shown) — browser polls, saves locally. Sources: canvas-call-ui.js, canvas-proposals.js, canvas-live-context.js.

Drilldowns

Auth — Browser PKCE, Managed login, Profile, Account config, Accounts Lambda, Private calls.

Storage — Room lookup, Canonical summary (ETag CAS), Cloud writer, Enroll, Profile copies, Cloud boundary (summaries only).

Call — Guest room, CloudFront, Chime media, Private room, Calling Lambda, AI expiry window.

Captions — Deepgram, Finals only, Cadence, Live captions, Local history, Caption review (uncertain flags only).

AI — Job kinds, Suggest API, Mac worker, Budgets, O5 Contributor, Job poll.

Delivery — SQS queue, Mac worker, O5 model, Summary merge, Browser poll, Backend jobs.