agentp 2.0.0 → 2.0.1

package/docs/specification_v2.md

@@ -80,6 +80,7 @@ Placed at the **project root** (found by upward search, git-like).
 | `session` | yes (written) | OpenCode session ID to target. May be absent until first `ocmux serve`/`agentp` run. |
 | `server` | no | Cached shared-server URL. **Not authoritative** — the global server state wins. Kept for self-containment/offline diagnostics. |
 | `annotations` | no | Map `sessionID → reminder text` (the picker's `R` key). Prepended by `agentp` to every prompt for that session. |
+| `broadcast` | no | Multi-session target (the picker's `Space` key): array of session IDs. When ≥2, `agentp` sends the prompt to all of them (waiting for idle). |
 
 **Legacy tolerance (read):** old files `{url, logfile, window_index}` must still
 parse. On read:
@@ -165,10 +166,48 @@ Retained flags: `--git`, `--GIT`, `-l`, `--print-logs`, `--version`, `-h`.
    - `Enter`/`Space` switches to the row but **stays open**; `n` creates (name
      input, blank = auto-title); `r` renames; `R` (Shift+r) sets a reminder;
      `d` deletes (y/N); `a` switches agent; `m` switches model; `p` opens the
-     project switcher; `h` toggles help; `q`/`Ctrl+C` quits
+     project switcher; `h` toggles help; `q` quits (only here — see below)
+    - **Menu exit rule**: `q`/`ESC` only *close the current menu and return to the
+      previous one* in every menu except the session picker itself; **`Ctrl+C`
+      fully exits `ocmux` from any menu** (help, input/confirm prompts, pickers,
+      broadcast).
+   - **`/` incremental search** (session picker, model/agent pickers and project
+     switcher): typing filters the list live (case-insensitive; whitespace
+     tokens are ANDed), the inverted bottom line shows `Search: <pattern>▏`, and
+     its right end shows `Enter: confirm · Esc: cancel`. `Enter` keeps the filter
+     and returns to normal navigation, `ESC` clears it, `/` resumes editing it,
+     arrows still move through the filtered view, and `Backspace` on an
+     already-empty search also exits it.
+   - **Broadcast (`Space`)**: only `Enter` switches. `Space` over a *different*
+     session enters broadcast mode: `Space` toggles each session (selection
+     persists to `.ocmux.json` `broadcast`), `Enter` keeps the selection and
+     switches to the cursor session, `ESC`/`q` cancels and returns to the
+     session list with the TUI back on the stored session. **Each newly selected
+     session is opened in the TUI window** (so you can inspect what is going on
+     in it before deciding); deselecting does not switch back — except
+     **deselecting down to a single session ends broadcast mode by selecting
+     that remaining session**.
+     `h` opens broadcast-specific help, `d` deletes the cursor session with
+     confirmation, and `m` applies a selected model to **all** broadcast
+     sessions. The footer shows only `Broadcast to sessions: <names>`
+     while selecting. `agentp` then sends the prompt to **all** selected
+     sessions,
+     waiting for each to become idle first; if the broadcast is cancelled before
+     every session answers, the received responses are printed plus a
+     detailed "not completed" list (session name/id, error, timestamp).
+     Deferred broadcast tickets carry `sessionIds` (not a misleading single
+     `sessionId`) and preserve the target list for the detached child even if
+     `.ocmux.json` changes later.
    - an **inverted footer** with the key hints, plus info lines about the
      selected session (title, location, and a responsive grid of model, agent,
      status + time in status, tokens, cost, context limit, outcome).
+   - only **main** sessions are listed — child/subagent sessions (`parentID`
+     set, e.g. old `@explore`/`@general` runs) are hidden: OpenCode's TUI
+     defaults those to a "Subagents" tab, so they are not offered as targets
+     (`ocmux session <id>` / `agentp --session` can still reach one explicitly).
+   - **new sessions inherit the model of the previously selected session**
+     (falling back to the server default) — API-created v2 sessions have no
+     model and won't run a prompt until one is set.
 5. If **not** a TTY: focus the window and print the selected session ID on
    stdout (non-interactive).
 
@@ -180,7 +219,9 @@ URL). `agentp` does not depend on this.
 - Lists every tmux window in the `Opencode` session that has a `.ocmux.json`
   (project windows), plus their selected session.
 - Highlights the tmux-active window (live `activeWindowIndex()`).
-- `Enter`/`Space` focuses a window and keeps the menu open; `q` quits.
+- `Enter`/`Space` focuses a window and keeps the menu open; `/` searches
+  (same incremental filter as §4.2); `h` toggles help; `q` closes the switcher
+  and returns to the session picker; `Ctrl+C` fully exits.
 - **Must never write `.ocmux.json`.** The dead-TUI restart path may *read* the
   state file, but only to know which session to relaunch with.
 

package/lib/project-state.js

@@ -60,6 +60,9 @@ function normalizeState(raw, statefile) {
   const annotations = state.annotations && typeof state.annotations === 'object' && !Array.isArray(state.annotations)
     ? state.annotations
     : {};
+  const broadcast = Array.isArray(state.broadcast)
+    ? state.broadcast.filter(x => typeof x === 'string' && x)
+    : null;
   return {
     file: statefile,
     version: typeof state.version === 'number' ? state.version : 1,
@@ -68,6 +71,7 @@ function normalizeState(raw, statefile) {
     server,
     status,
     annotations,
+    broadcast,
   };
 }
 
@@ -109,6 +113,10 @@ function writeProjectState(statefile, patch) {
   if (patch.session !== undefined) next.session = patch.session;
   if (patch.server !== undefined) next.server = patch.server;
   if (patch.status !== undefined) next.status = patch.status;
+  if (patch.broadcast !== undefined) {
+    if (Array.isArray(patch.broadcast) && patch.broadcast.length >= 2) next.broadcast = [...patch.broadcast];
+    else delete next.broadcast;
+  }
   const tmp = statefile + '.tmp';
   fs.writeFileSync(tmp, JSON.stringify(next) + '\n');
   fs.renameSync(tmp, statefile);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentp",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Pipe prompts into a running OpenCode TUI session and stream the final answer",
   "bin": {
     "agentp": "bin/agentp",