openclaw - ✅(Solved) Fix [Feature Request] Control UI: Add session kind filter to session dropdown [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#73222Fetched 2026-04-29 06:22:05
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Participants
Timeline (top)
cross-referenced ×1referenced ×1
  • The sessions.list gateway API already supports a kinds parameter
  • The sessions_list tool in agent prompts documents kinds as a valid filter parameter
  • However, the Control UI's session dropdown does not use this parameter when calling sessions.list, resulting in all session types being displayed

Root Cause

  • The sessions.list gateway API already supports a kinds parameter
  • The sessions_list tool in agent prompts documents kinds as a valid filter parameter
  • However, the Control UI's session dropdown does not use this parameter when calling sessions.list, resulting in all session types being displayed

Fix Action

Workaround

Currently, users must manually clean up ended subagent/dreaming sessions to reduce noise, or rely on the /sessions command with kinds filter.


Filed via OpenClaw agent on behalf of user.

PR fix notes

PR #73311: Add Control UI session kind filter

Description (problem / solution / changelog)

Summary

  • Adds a Control UI chat-header session kind filter for main/direct, group, subagent, dreaming, cron, and other sessions.
  • Keeps filtering UI-local so sessions.list params and gateway protocol stay unchanged.
  • Preserves the selected session in the dropdown even when its kind is hidden, and exposes the same filter on desktop and mobile.
  • Documents the new chat-header filtering surface.

Fixes #73222

Testing

  • corepack pnpm test ui/src/ui/app-render.helpers.node.test.ts ui/src/ui/app-render.helpers.browser.test.ts ui/src/ui/controllers/sessions.test.ts --typecheck
  • corepack pnpm exec oxfmt --check --threads=1 <changed files>
  • corepack pnpm exec oxlint ui/src/ui/session-kind-filter.ts
  • git diff --check origin/main...HEAD
  • Ralph architect verification pass

Not Tested

  • Blacksmith Testbox pnpm check:changed could not run because local Blacksmith auth timed out before warmup.
  • ui/src/ui/views/chat.test.ts is currently excluded by the repo's UI Vitest shard; the fixture update is covered indirectly by the session select render/type path above.

Changed files

  • docs/web/control-ui.md (modified, +1/-1)
  • ui/src/styles/chat/layout.css (modified, +54/-0)
  • ui/src/styles/layout.mobile.css (modified, +13/-0)
  • ui/src/ui/app-render.helpers.browser.test.ts (modified, +22/-9)
  • ui/src/ui/app-render.helpers.node.test.ts (modified, +91/-1)
  • ui/src/ui/app-render.helpers.ts (modified, +101/-34)
  • ui/src/ui/app-view-state.ts (modified, +2/-1)
  • ui/src/ui/app.ts (modified, +5/-1)
  • ui/src/ui/chat/session-controls.ts (modified, +8/-20)
  • ui/src/ui/session-kind-filter.ts (added, +117/-0)
  • ui/src/ui/views/chat.test.ts (modified, +2/-1)
RAW_BUFFERClick to expand / collapse

Problem

The session dropdown in the Control UI header shows all sessions including subagent sessions and dreaming sessions, making the list very long and noisy.

Expected Behavior

Control UI should allow filtering sessions by kind (e.g., subagent, dreaming, cron) in the session dropdown, similar to how the sessions_list tool already supports a kinds parameter.

Context

  • The sessions.list gateway API already supports a kinds parameter
  • The sessions_list tool in agent prompts documents kinds as a valid filter parameter
  • However, the Control UI's session dropdown does not use this parameter when calling sessions.list, resulting in all session types being displayed

Suggested Implementation

Add a filter control (e.g., a dropdown, checkbox group, or pills) in the Control UI session dropdown area that allows users to toggle visibility of:

  • Main sessions
  • Subagent sessions
  • Dreaming sessions
  • Cron sessions
  • Isolated sessions

This could be implemented by passing the kinds parameter to the sessions.list API call.

Workaround

Currently, users must manually clean up ended subagent/dreaming sessions to reduce noise, or rely on the /sessions command with kinds filter.


Filed via OpenClaw agent on behalf of user.

extent analysis

TL;DR

Implement a filter control in the Control UI session dropdown to pass the kinds parameter to the sessions.list API call, allowing users to toggle visibility of different session types.

Guidance

  • Add a filter control (e.g., dropdown, checkbox group, or pills) in the Control UI session dropdown area to allow users to select visible session kinds.
  • Modify the sessions.list API call in the Control UI to include the kinds parameter based on the user's filter selection.
  • Use the existing kinds parameter support in the sessions.list gateway API to filter sessions.
  • Test the implementation with different filter combinations to ensure correct session visibility.

Example

No code snippet is provided as the issue does not include specific implementation details.

Notes

The suggested implementation requires modifying the Control UI code to add a filter control and update the sessions.list API call. This may involve additional design and testing efforts to ensure a user-friendly and functional filter interface.

Recommendation

Apply workaround: Implement the suggested filter control in the Control UI session dropdown to improve user experience and reduce noise in the session list. This will allow users to toggle visibility of different session types, making it easier to manage and monitor sessions.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix [Feature Request] Control UI: Add session kind filter to session dropdown [1 pull requests, 1 participants]