granola-toolkit 0.22.0 → 0.24.0

package/README.md

@@ -193,12 +193,18 @@ The machine-readable `export` command includes:
 The initial server API includes:
 
 - `GET /health`
+- `GET /auth/status`
 - `GET /state`
 - `GET /events` for server-sent state updates
 - `GET /meetings`
+- `GET /meetings?refresh=true` to bypass the local meeting index and force a live refresh
 - `GET /meetings/resolve?q=<query>`
 - `GET /meetings/:id`
 - `GET /exports/jobs`
+- `POST /auth/login`
+- `POST /auth/logout`
+- `POST /auth/mode`
+- `POST /auth/refresh`
 - `POST /exports/notes`
 - `POST /exports/jobs/:id/rerun`
 - `POST /exports/transcripts`
@@ -212,15 +218,29 @@ This is the foundation for the future `granola web` client and any attachable TU
 The initial browser client includes:
 
 - a searchable meeting list
+- a fast local-index warm start for meeting browsing before live documents finish loading
 - sort and updated-date filters
 - quick open by meeting id or title
 - a focused meeting workspace with notes, transcript, metadata, and raw tabs
 - keyboard-first workspace switching with `1`-`4`, `[` and `]`
 - app-state status from the shared core
+- an auth session panel for login, refresh, source switching, and sign-out
 - note and transcript export actions backed by the same local API
 - a recent export-jobs panel with rerun actions
 - stronger empty and error states for list/detail failures
 
+### Local Meeting Index
+
+Interactive meeting browsing now keeps a local index of meeting summaries and metadata.
+
+That index is used to:
+
+- make the web meeting list available quickly on startup
+- keep search, sort, and date filtering useful before every live document payload is fetched again
+- refresh itself after successful live loads so the next run starts warm
+
+The web client uses the index as a fast path and upgrades to live data automatically when the background refresh completes. The manual Refresh button bypasses the index and forces a live meeting fetch immediately.
+
 ### Export Jobs
 
 Exports are now tracked as jobs with:
@@ -239,9 +259,22 @@ If you do not want to keep passing `--supabase`, import the desktop app session
 ```bash
 granola auth login
 granola auth status
+granola auth refresh
+granola auth use stored
+granola auth use supabase
 ```
 
-That stores a reusable Granola session locally and lets `granola notes` use it directly. `granola auth logout` deletes the stored session.
+That stores a reusable Granola session locally and lets `granola notes` use it directly.
+
+`granola auth` now supports:
+
+- `login` to import the desktop app session into the toolkit store
+- `status` to inspect the active source, stored-session availability, refresh support, and any last auth error
+- `refresh` to refresh the stored session explicitly
+- `use stored` or `use supabase` to switch the active auth source
+- `logout` to delete the stored session
+
+The same auth actions are also available from the web workspace.
 
 ### Incremental Writes