From 128df570055d17b6914be8a2f1688836341d8e4d Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sun, 14 Dec 2025 00:50:12 +0000 Subject: [PATCH] docs: refer to session store --- docs/group-messages.md | 2 +- docs/refactor/webagent-session.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/group-messages.md b/docs/group-messages.md index 96e7f2237..0317d7f18 100644 --- a/docs/group-messages.md +++ b/docs/group-messages.md @@ -56,4 +56,4 @@ Notes: ## Known considerations - Heartbeats are intentionally skipped for groups to avoid noisy broadcasts. - Echo suppression uses the combined batch string; if you send identical text twice without mentions, only the first will get a response. -- Session store entries will appear as `group:` in `sessions.json`; a missing entry just means the group hasn’t triggered a run yet. +- Session store entries will appear as `group:` in the session store (`~/.clawdis/sessions/sessions.json` by default); a missing entry just means the group hasn’t triggered a run yet. diff --git a/docs/refactor/webagent-session.md b/docs/refactor/webagent-session.md index 0061a4401..13f0145d9 100644 --- a/docs/refactor/webagent-session.md +++ b/docs/refactor/webagent-session.md @@ -10,7 +10,7 @@ Context: web chat currently lives in a WKWebView that loads the pi-web bundle. S ## Target state - Gateway WS adds methods: - - `chat.history { sessionKey }` → `{ sessionKey, messages[], thinkingLevel }` (reads the existing JSONL + sessions.json). + - `chat.history { sessionKey }` → `{ sessionKey, messages[], thinkingLevel }` (reads the existing JSONL + session store). - `chat.send { sessionKey, message, attachments?, thinking?, deliver?, timeoutMs<=30000, idempotencyKey }` → `res { runId, status:"accepted" }` or `res ok:false` on validation/timeout. - Gateway WS emits `chat` events `{ runId, sessionKey, seq, state:"delta"|"final"|"error", message?, errorMessage?, usage?, stopReason? }`. Streaming is optional; minimum is a single `state:"final"` per send. - Client consumes only WS: bootstrap via `chat.history`, send via `chat.send`, live updates via `chat` events. No file watchers.