openclaw/docs
clay-datacurve 7b61ca1b06
Session management improvements and dashboard API (#50101)
* fix: make cleanup "keep" persist subagent sessions indefinitely

* feat: expose subagent session metadata in sessions list

* fix: include status and timing in sessions_list tool

* fix: hide injected timestamp prefixes in chat ui

* feat: push session list updates over websocket

* feat: expose child subagent sessions in subagents list

* feat: add admin http endpoint to kill sessions

* Emit session.message websocket events for transcript updates

* Estimate session costs in sessions list

* Add direct session history HTTP and SSE endpoints

* Harden dashboard session events and history APIs

* Add session lifecycle gateway methods

* Add dashboard session API improvements

* Add dashboard session model and parent linkage support

* fix: tighten dashboard session API metadata

* Fix dashboard session cost metadata

* Persist accumulated session cost

* fix: stop followup queue drain cfg crash

* Fix dashboard session create and model metadata

* fix: stop guessing session model costs

* Gateway: cache OpenRouter pricing for configured models

* Gateway: add timeout session status

* Fix subagent spawn test config loading

* Gateway: preserve operator scopes without device identity

* Emit user message transcript events and deduplicate plugin warnings

* feat: emit sessions.changed lifecycle event on subagent spawn

Adds a session-lifecycle-events module (similar to transcript-events)
that emits create events when subagents are spawned. The gateway
server.impl.ts listens for these events and broadcasts sessions.changed
with reason=create to SSE subscribers, so dashboards can pick up new
subagent sessions without polling.

* Gateway: allow persistent dashboard orchestrator sessions

* fix: preserve operator scopes for token-authenticated backend clients

Backend clients (like agent-dashboard) that authenticate with a valid gateway
token but don't present a device identity were getting their scopes stripped.
The scope-clearing logic ran before checking the device identity decision,
so even when evaluateMissingDeviceIdentity returned 'allow' (because
roleCanSkipDeviceIdentity passed for token-authed operators), scopes were
already cleared.

Fix: also check decision.kind before clearing scopes, so token-authenticated
operators keep their requested scopes.

* Gateway: allow operator-token session kills

* Fix stale active subagent status after follow-up runs

* Fix dashboard image attachments in sessions send

* Fix completed session follow-up status updates

* feat: stream session tool events to operator UIs

* Add sessions.steer gateway coverage

* Persist subagent timing in session store

* Fix subagent session transcript event keys

* Fix active subagent session status in gateway

* bump session label max to 512

* Fix gateway send session reactivation

* fix: publish terminal session lifecycle state

* feat: change default session reset to effectively never

- Change DEFAULT_RESET_MODE from "daily" to "idle"
- Change DEFAULT_IDLE_MINUTES from 60 to 0 (0 = disabled/never)
- Allow idleMinutes=0 through normalization (don't clamp to 1)
- Treat idleMinutes=0 as "no idle expiry" in evaluateSessionFreshness
- Default behavior: mode "idle" + idleMinutes 0 = sessions never auto-reset
- Update test assertion for new default mode

* fix: prep session management followups (#50101) (thanks @clay-datacurve)

---------

Co-authored-by: Tyler Yust <TYTYYUST@YAHOO.COM>
2026-03-19 12:12:30 +09:00
..
.generated fix(release): isolate bundled config docs loading 2026-03-18 16:01:43 -07:00
.i18n docs(plugins): add capability cookbook 2026-03-16 22:58:55 -07:00
assets Docs: switch README logo to SVG assets (#47049) 2026-03-15 08:58:45 +01:00
automation docs: merge duplicate OpenRouter entry, fix broken plugin anchor links 2026-03-18 16:00:46 -07:00
channels docs: add missing H1 headings and fix HEARTBEAT template 2026-03-18 12:27:07 -07:00
cli docs: merge duplicate OpenRouter entry, fix broken plugin anchor links 2026-03-18 16:00:46 -07:00
concepts Session management improvements and dashboard API (#50101) 2026-03-19 12:12:30 +09:00
debug
diagnostics
gateway docs: fix tools nav A-Z, split plugin page, consolidate sandbox docs, add OpenShell page (#50055) 2026-03-18 15:44:08 -07:00
help docs: merge duplicate OpenRouter entry, fix broken plugin anchor links 2026-03-18 16:00:46 -07:00
images docs(feishu): Feishu docs – add verificationToken and align zh-CN with EN (openclaw#31555) thanks @xbsheng 2026-03-02 21:33:41 -06:00
install docs: update development-channels with --tag, --dry-run, status, and main warning 2026-03-18 16:41:43 -07:00
ja-JP docs update web search config guidance 2026-03-18 00:00:17 -05:00
nodes docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
platforms docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
plugins refactor: unify plugin sdk primitives 2026-03-18 23:58:56 +00:00
providers docs: add missing provider pages (google, modelstudio, perplexity, volcengine) and nav entries 2026-03-18 12:26:01 -07:00
reference docs: restore original Credits heading, disambiguate H1 2026-03-18 12:38:46 -07:00
security docs: add missing frontmatter and title fields 2026-03-18 00:02:43 -07:00
start docs: add extensions section to docs hubs 2026-03-18 12:29:02 -07:00
tools refactor: move bundled channel deps to plugin packages 2026-03-19 00:24:44 +00:00
web docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
zh-CN docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
auth-credential-semantics.md docs: add missing frontmatter and title fields 2026-03-18 00:02:43 -07:00
brave-search.md docs update web search config guidance 2026-03-18 00:00:17 -05:00
ci.md build: remove land gate script 2026-03-16 06:08:41 +00:00
date-time.md
docs.json docs: fix tools nav A-Z, split plugin page, consolidate sandbox docs, add OpenShell page (#50055) 2026-03-18 15:44:08 -07:00
index.md docs: rename onboarding user-facing wizard copy 2026-03-16 19:50:31 -05:00
logging.md Feat/logger support log level validation0222 (#23436) 2026-02-22 11:15:13 +01:00
nav-tabs-underline.js docs(ui): add animated underline for nav tabs (#21912) 2026-02-20 09:33:46 -05:00
network.md
perplexity.md docs update web search config guidance 2026-03-18 00:00:17 -05:00
pi-dev.md docs: fix em-dash headings and broken links across docs 2026-03-17 23:55:46 -07:00
pi.md Docs: point message runtime docs and tests at plugin-owned code 2026-03-18 02:08:08 +00:00
prose.md
style.css fix(ios): force tls for non-loopback manual gateway hosts (#21969) 2026-02-20 16:28:47 +00:00
tts.md docs(plugins): document capability ownership model 2026-03-16 18:50:09 -07:00
vps.md Docs: remove MDX-breaking secret markers 2026-03-07 10:09:00 -08:00
whatsapp-openclaw-ai-zh.jpg
whatsapp-openclaw.jpg