UAT: SessionsScreen not implemented — ctrl+s keybinding missing, no session management overlay #6348

New issue

Open

opened 2026-04-09 20:14:24 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 20:14:24 +00:00

Owner

Bug Report

Feature Area: TUI Implementation
Spec Reference: §TUI — Sessions Screen (v3.7.0 deliverable #14)
Milestone: v3.7.0

Summary

The SessionsScreen specified in §TUI — Sessions Screen is entirely absent from the codebase. The spec requires a modal overlay accessible via ctrl+s showing all active and saved sessions. The screens/ directory is empty and no SessionsScreen class exists anywhere.

Spec Requirements

Per §TUI — Sessions Screen:

SessionsScreen is a modal overlay opened by ctrl+s
Shows Active Sessions (top): currently open session tabs with state indicators, persona, actor, last prompt preview, highlighted with ❯ for current
Shows Saved Sessions (bottom): previously persisted sessions from SQLite with prompt count and last-used timestamp
Keyboard bindings: enter Switch, ctrl+r Resume saved, ctrl+n New, d Delete, r Rename, esc Back
Human-readable relative time formatting (just now, 2m ago, 1h ago, full date >24h)

Per the acceptance criteria (§TUI — Acceptance Criteria, deliverable #14):

"Session list shows all sessions; sessions can be created/deleted"

Per Global Hotkeys spec:

ctrl+s — Open Sessions screen

What Was Found

Code location: /app/src/cleveragents/tui/app.py

CleverAgentsTuiApp.BINDINGS (line ~79) does not include ctrl+s:

BINDINGS = [
    ("ctrl+q", "quit", "Quit"),
    ("f1", "help", "Help"),
    ("ctrl+t", "cycle_preset", "Cycle Preset"),
]

/app/src/cleveragents/tui/screens/ directory is empty (only __pycache__). No sessions_screen.py or any screen module exists.
No SessionsScreen widget, class, or module exists anywhere under src/cleveragents/tui/.
ctrl+n (new session tab), ctrl+w (close session), ctrl+[ / ctrl+] (switch tabs) are also absent from BINDINGS — all session management hotkeys are missing.
The SessionView dataclass in app.py (line ~56) is a stub with only session_id and transcript — no state, persona, actor, or prompt preview fields required by the Sessions Screen.

Expected Behaviour

ctrl+s opens the SessionsScreen modal overlay
Screen shows all active sessions with their state indicator (❯ awaiting input, ⌛ working, idle)
Screen shows saved sessions from SQLite with prompt count and relative timestamps
enter switches to the selected session; d deletes; ctrl+r resumes a saved session; ctrl+n creates new
esc closes the screen and returns to the main screen

Actual Behaviour

ctrl+s does nothing (not bound)
screens/ directory is empty — no SessionsScreen class exists
All session management keyboard shortcuts (ctrl+n, ctrl+w, ctrl+[, ctrl+]) are absent from BINDINGS
The TUI has a single hardcoded SessionView(session_id="default") with no session management capability

Steps to Reproduce

Launch agents tui
Press ctrl+s — nothing happens
Press ctrl+n — nothing happens
Press ctrl+[ or ctrl+] — nothing happens

Impact

This is a v3.7.0 deliverable #14. Session management from within the TUI is entirely non-functional. Users cannot view, create, switch, delete, rename, or resume sessions from inside the TUI. Note: this is distinct from the multi-session tabs issue (#5945) — this specifically tracks the missing modal SessionsScreen overlay.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area**: TUI Implementation **Spec Reference**: §TUI — Sessions Screen (v3.7.0 deliverable #14) **Milestone**: v3.7.0 ### Summary The `SessionsScreen` specified in §TUI — Sessions Screen is entirely absent from the codebase. The spec requires a modal overlay accessible via `ctrl+s` showing all active and saved sessions. The `screens/` directory is empty and no `SessionsScreen` class exists anywhere. ### Spec Requirements Per §TUI — Sessions Screen: - `SessionsScreen` is a modal overlay opened by `ctrl+s` - Shows **Active Sessions** (top): currently open session tabs with state indicators, persona, actor, last prompt preview, highlighted with `❯` for current - Shows **Saved Sessions** (bottom): previously persisted sessions from SQLite with prompt count and last-used timestamp - Keyboard bindings: `enter` Switch, `ctrl+r` Resume saved, `ctrl+n` New, `d` Delete, `r` Rename, `esc` Back - Human-readable relative time formatting (`just now`, `2m ago`, `1h ago`, full date >24h) Per the acceptance criteria (§TUI — Acceptance Criteria, deliverable #14): > "Session list shows all sessions; sessions can be created/deleted" Per Global Hotkeys spec: > `ctrl+s` — Open Sessions screen ### What Was Found **Code location**: `/app/src/cleveragents/tui/app.py` 1. `CleverAgentsTuiApp.BINDINGS` (line ~79) does not include `ctrl+s`: ```python BINDINGS = [ ("ctrl+q", "quit", "Quit"), ("f1", "help", "Help"), ("ctrl+t", "cycle_preset", "Cycle Preset"), ] ``` 2. `/app/src/cleveragents/tui/screens/` directory is **empty** (only `__pycache__`). No `sessions_screen.py` or any screen module exists. 3. No `SessionsScreen` widget, class, or module exists anywhere under `src/cleveragents/tui/`. 4. `ctrl+n` (new session tab), `ctrl+w` (close session), `ctrl+[` / `ctrl+]` (switch tabs) are also absent from `BINDINGS` — all session management hotkeys are missing. 5. The `SessionView` dataclass in `app.py` (line ~56) is a stub with only `session_id` and `transcript` — no state, persona, actor, or prompt preview fields required by the Sessions Screen. ### Expected Behaviour - `ctrl+s` opens the `SessionsScreen` modal overlay - Screen shows all active sessions with their state indicator (`❯ awaiting input`, `⌛ working`, `idle`) - Screen shows saved sessions from SQLite with prompt count and relative timestamps - `enter` switches to the selected session; `d` deletes; `ctrl+r` resumes a saved session; `ctrl+n` creates new - `esc` closes the screen and returns to the main screen ### Actual Behaviour - `ctrl+s` does nothing (not bound) - `screens/` directory is empty — no `SessionsScreen` class exists - All session management keyboard shortcuts (`ctrl+n`, `ctrl+w`, `ctrl+[`, `ctrl+]`) are absent from `BINDINGS` - The TUI has a single hardcoded `SessionView(session_id="default")` with no session management capability ### Steps to Reproduce 1. Launch `agents tui` 2. Press `ctrl+s` — nothing happens 3. Press `ctrl+n` — nothing happens 4. Press `ctrl+[` or `ctrl+]` — nothing happens ### Impact This is a **v3.7.0 deliverable #14**. Session management from within the TUI is entirely non-functional. Users cannot view, create, switch, delete, rename, or resume sessions from inside the TUI. Note: this is distinct from the multi-session tabs issue (#5945) — this specifically tracks the missing modal `SessionsScreen` overlay. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-09 20:18:09 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 3) #6294

HAL9000 referenced this issue

2026-04-09 21:00:24 +00:00

[AUTO-ARCH] Architecture Status (Cycle 9) #6396

HAL9000 added the