From 534de59f7c79d0e7af51f9be411530f916eff80e Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sun, 4 Jan 2026 02:10:22 +0100 Subject: [PATCH] docs: clarify menu bar sessionKey usage --- CHANGELOG.md | 1 + docs/mac/menu-bar.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4b699b44d..30000a003 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -69,6 +69,7 @@ - Onboarding/Config: add protocol notes for wizard + schema RPC. - Queue: clarify steer-backlog behavior with inline commands and update examples for streaming surfaces. - Sandbox: document per-session agent sandbox setup, browser image, and Docker build. +- macOS: clarify menu bar uses sessionKey from agent events. ## 2.0.0-beta5 — 2026-01-03 diff --git a/docs/mac/menu-bar.md b/docs/mac/menu-bar.md index bfe9a8c36..c2b330680 100644 --- a/docs/mac/menu-bar.md +++ b/docs/mac/menu-bar.md @@ -11,7 +11,7 @@ read_when: - The “Nodes” block in the menu lists **devices** only (gateway bridge nodes via `node.list`), not client/presence entries. ## State model -- Sessions: events arrive with `runId` (session key). The “main” session is the key `main`; if absent, we fall back to the most recently updated session. +- Sessions: events arrive with `runId` (per-run) plus `sessionKey` in the payload. The “main” session is the key `main`; if absent, we fall back to the most recently updated session. - Priority: main always wins. If main is active, its state is shown immediately. If main is idle, the most recently active non‑main session is shown. We do not flip‑flop mid‑activity; we only switch when the current session goes idle or main becomes active. - Activity kinds: - `job`: high‑level command execution (`state: started|streaming|done|error`).