agentp 2.1.0 → 2.1.2

package/README.md

@@ -348,15 +348,54 @@ the project found upward from `<directory>` (default: `$PWD`):
   it, and `Backspace` on an already-empty search also exits it. The same `/`
   search works in the model/agent pickers and the project switcher.
 - `Enter` switches (menu stays open). `Space` over a different session enters
-  **broadcast mode**: Space selects/deselects sessions; `Enter` keeps the list
-  and switches normally; `ESC`/`q` cancels back to the session list and returns
-  the TUI to the stored session; deselecting down to a single session selects
-  that remaining session. New selections open in the TUI for inspection.
-  Broadcast mode also has `h` help, `d` delete, and `m` to change the model for
-  every selected session.
+  **broadcast mode**: Space selects/deselects sessions; `Enter` switches to the
+  cursor session and ends broadcast; `ESC`/`q` cancels back to the session list
+  and returns the TUI to the stored session; deselecting down to a single
+  session selects that remaining session. Ending broadcast (`Enter`/`ESC`/`q`,
+  or any later session switch) clears the stored selection. Reopening `ocmux`
+  while a valid selection is stored starts directly in broadcast mode; a stale
+  or invalid stored list (fewer than two sessions, or ids that no longer exist)
+  is cleared first, so the picker always shows the real state. New selections
+  open in the TUI for inspection.
+  Broadcast mode also has `h` help, `d` delete, `D` (Shift+d) to delete every
+  selected session at once (confirmation in the status bar), and `m` to change
+  the model for every selected session. The `Broadcast to sessions: …` line
+  caps itself to one row — up to 480 characters of names (or the terminal
+  width, whichever is smaller); past that the selection is truncated from the
+  beginning with a leading `...`, so the footer never wraps.
 - `n` create (name input) · `r` rename (edit in place) · `R` set a reminder ·
   `d` delete (confirm) · `a` switch agent · `m` switch model · `p` project
-  switcher (inspect-only by default) · `h` help · `q` quit
+  switcher (inspect-only by default) · `h` help · `q` quit. The `n`/`r`/`R`
+  prompts and the `d` confirmation take over the **status bar**, with their
+  essential keys on the right (`Enter: create/rename/save · Esc: cancel`,
+  `y: delete · n/Esc: cancel`). While a question is active the bar flips from
+  brown to the same **light yellow as the list pointer**, so the change of
+  state is obvious at a glance. Deleting the current session adopts the session
+  under the cursor as the new current (recorded, refreshed in the TUI, and
+  highlighted)
+- **pending-answer awareness**: while the picker is open, ocmux re-checks the
+  project every 2 seconds and marks sessions that are waiting on the agent.
+  Two independent marker columns: ❓ = pending agent **question** (a form),
+  🔒 = pending **permission** request (each always reserves its slot so rows
+  stay aligned). A 🔔 leads the **status bar** when any listed session is
+  waiting, and the cursor session's marker columns are pinned to the **top-right
+  corner of the info panel**. The same markers appear in the project switcher,
+  per session and — when folded — aggregated over the project.
+- `A` answers the pending **question(s)** of the selected session (only when it
+  shows a ❓ marker). Answer mode
+  lists the form's fields and options: `Space`/`Enter` selects (`(•)`), extra
+  rows toggle on multi-select fields, and "Type your own answer" / free-text
+  rows open the status-bar input. Fields gated by `when` conditions appear and
+  disappear live as you answer their gate. The final **Submit answers** row
+  sends the whole form in one request; the server's message shows in the status
+  bar on rejection (400), an already-answered form (409) reports and returns to
+  the list, and multi-form sessions advance form to form. `h` toggles the
+  answer-mode help, `q`/`ESC` cancels without answering.
+- `P` answers the pending **permission request(s)** of the selected session
+  (only when it shows a 🔒 marker). Each request is shown with its action,
+  resources and optional message; `o`/`1` allow **once**, `a` allow **always**
+  (remembered), `r` **reject** — each posts the decision and advances to the
+  next pending request (`h` help, `q`/`ESC` leaves them pending).
 - `m` opens the model list **sorted by provider** with the cursor already on the
   session's **current model** — also in broadcast mode, where it starts from the
   cursor session's model, so a bulk change begins where you are
@@ -366,7 +405,14 @@ the project found upward from `<directory>` (default: `$PWD`):
 - switching updates `.ocmux.json` and refreshes the project's dedicated TUI, or
   the shared TUI when no live dedicated one exists; silent on success. The file
   updated is always the one of the project being listed — your own project
-  unless ocmux was started with `--all-projects`
+  unless ocmux was started with `--all-projects`. Opening the picker in a
+  project also routes that project's TUI to its stored session (a TUI already
+  showing it is left untouched), so running `ocmux` from anywhere switches the
+  display even without picking a row
+- when `.ocmux.json`'s server is unreachable but the default server
+  (`$OCMUX_SERVER` or `http://localhost:4096`) answers, `ocmux` offers (on a TTY)
+  to repoint the project to the default and rewrites `server` in `.ocmux.json`
+  if you confirm
 - new sessions inherit the model of the previously selected session (v2
   sessions created via the API have no model and won't run a prompt until set)
 
@@ -376,7 +422,12 @@ prepends a session's reminder to every prompt sent to it.
 Broadcast selections are stored in `.ocmux.json` as `broadcast`. `agentp`
 sends a prompt to all selected sessions (waiting for busy sessions to go idle),
 and prints a labeled answer section for each. Errors/incomplete targets are
-reported individually with session name, id, error, and timestamp.
+reported individually with session name, id, error, and timestamp. Leaving
+broadcast mode (`Enter`/`ESC`/`q`) or picking a session in the normal switcher
+removes the stored `broadcast`, so a stale selection never keeps broadcasting.
+Opening `ocmux` reads it back: a valid list opens the picker directly in
+broadcast mode, while a stale or invalid list is cleared and the picker shows
+the (real) normal state.
 
 Subcommands:
 
@@ -387,8 +438,10 @@ Subcommands:
 - **`tui [--shared] [--server <url>] [dir]`** — register the current tmux pane and run OpenCode
   in it. Without `--shared`, the pane follows only that project. With
   `--shared`, it becomes the one fallback TUI for all projects and can reconnect
-  across server URLs as selections change. Re-registering a slot stops its old
-  wrapper without destroying the old pane. Closing the TUI unregisters it.
+  across server URLs as selections change; `--shared` also starts without a
+  `.ocmux.json`, defaulting to the default server. Re-registering a slot stops
+  its old wrapper without destroying the old pane. Closing the TUI unregisters
+  it.
   `tui --list` lists live registrations; `tui [--shared] --status` inspects a
   dedicated/shared slot; `tui [--shared] --detach` unregisters that slot without
   closing the pane or its current TUI.