zswarm 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zswarm",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "description": "Coordinate CLI agent crews in Zellij panes",
   "engines": {
@@ -23,8 +23,8 @@
     "skills"
   ],
   "dependencies": {
-    "@zswarm/cli": "0.2.2",
-    "@zswarm/mcp": "0.1.12"
+    "@zswarm/cli": "0.2.4",
+    "@zswarm/mcp": "0.1.14"
   },
   "publishConfig": {
     "access": "public"

package/skills/zswarm/SKILL.md

@@ -57,7 +57,7 @@ pane's title when `ZELLIJ_PANE_ID` / `ZSWARM_SELF_PANE` is visible, else
 1. Target **pane ids or names** from `list` — do not invent transports.
 2. Keep the session + pane ID returned by `spawn`. Use names once `alias.observed` is true; retry observation before creating a duplicate.
 3. Prefer `send` + `wait` over polling. Prefer `tail` over repeated `dump`.
-4. Check `submitted` on `send`; `false` means the peer never got it.
+4. Check `submitted` on `send`: `false` is still in the composer, `"unverified"` is inconclusive (the screen changed while the body is not visible — never a resend), and `"not-delivered"` means nothing landed (safe to resend). `--confirm` never pastes the body twice.
 5. Prefer `diff` / `checkpoint` over reading a worktree by hand.
 6. Zellij terminal panes only — not IDE side-panel chats.
 7. Same host as Zellij, or `ZSWARM_SSH` / `ZSWARM_SERVE`. Linux/macOS SSH is

package/skills/zswarm/references/ops.md

@@ -5,7 +5,7 @@ MCP: `zswarm({ op, ... })`. CLI: `zswarm <op>`. Same surface.
 | op | Purpose |
 |----|---------|
 | `list` | Terminal panes (id, title, command, tab); `verbose` adds cwd/flags |
-| `send` | Paste body + Enter (`to` = id / title / command). `from` labels `[zswarm from=…]` (default: `ZSWARM_FROM`, else the sending pane's title, else `swarm`). `submit`: `auto` (default; Codex panes default to `double-enter`) / `double-enter` / `none`. Result `submitted: true\|false\|"unverified"`. `expect` refuses unless the screen already shows that substring |
+| `send` | Paste body + Enter (`to` = id / title / command). `from` labels `[zswarm from=…]` (default: `ZSWARM_FROM`, else the sending pane's title, else `swarm`). `submit`: `auto` (default; Codex panes default to `double-enter`) / `double-enter` / `none`. `submitted`: `true` (accepted and running) \| `"queued"` (accepted behind a running turn) \| `false` (still in the composer, not submitted) \| `"unverified"` (inconclusive) \| `"not-delivered"` (the pane was unchanged apart from the composer; op fails `not_delivered`, resend is safe). Settle (`--settle-ms`, default 300) and pane-observe (`--observe-ms`, default 1000) budgets scale up to 5x on a slow Zellij, explicit flags win. `--confirm` re-pastes only on `not-delivered` (Enter when still in the composer, an extra dump on `unverified`) and never pastes twice. `expect` refuses unless the screen already shows that substring `ifIdle: true` (`--if-idle`) refuses a live-leased pane (`pane_leased`) or a harness that shows it is working (`pane_busy`; OpenCode's progress bar, Claude Code's `esc to interrupt`) instead of sending. |
 | `dump` | Full-screen read; capped at 8000 chars (tail) — expensive vs `tail` |
 | `tail` | Incremental read since last cursor; `reset: true` returns the whole screen |
 | `wait` | Block until quiet or `match`; returns `reason` + a 2000-char tail. Bus holds one pipe for the wait |
@@ -28,14 +28,20 @@ MCP: `zswarm({ op, ... })`. CLI: `zswarm <op>`. Same surface.
 | `unworktree` | Remove a worktree (`path` or `branch`; `worktree` aliases `branch`) |
 | `diff` | What a peer changed in its worktree |
 | `checkpoint` | Commit a peer worktree (`message`); clean tree is not an error |
-| `sessions` | Live Zellij session names |
+| `sessions` | Zellij session names; `--exited` for resurrectable ones, `--prune-exited [--older-than 7d] [--dry-run]` deletes them |
 | `bus` | Event-bus status; `install: true` loads the plugin, `clear: true` forgets it |
 | `serve` | Listen for remote zswarm (`--listen`). `--install` / `--clear` installs/removes a service (Windows logon task, Linux systemd user unit, macOS launchd job). MCP cannot listen; set `ZSWARM_SERVE` on the client. See [remote.md](remote.md) |
 | `doctor` | Inspect-only route/SSH/serve/Zellij/bus diagnostics |
 
 `submit=auto` retries Enter if the paste is still sitting in a TUI composer.
 `submit=double-enter` always sends the extra Enter; `submit=none` skips the check.
-Check `submitted` — a queued composer used to report success.
+Check `submitted`: `true` is submitted, `"queued"` is accepted but waiting behind a
+running turn (Claude Code shows "Press up to edit queued messages"), `false` is still
+in the composer, `"unverified"` means the screen changed but the body is not visible
+(never a resend), and `"not-delivered"` means the pane was unchanged apart from the
+composer — the op fails `not_delivered` so a caller can resend. `--confirm` never
+pastes the body twice.
+A queued composer now reports `"queued"`, not success.
 
 **Breaking:** `spawn`'s boolean `tab` is now `newTab`; `tab` is a tab **name**.
 
@@ -81,6 +87,12 @@ CLI: `send --body-file PATH` reads a local UTF-8 file before remote forwarding;
 body. Newlines are preserved. MCP uses `body`, never its protocol stdin. Paste
 still uses argv, so reference a shared file for very large handoffs.
 
+CLI `zswarm relay` leases its target pane until the relay reaches a final
+status (a lease whose relay is gone is stale and taken over). A second relay to
+a leased pane fails `pane_leased` unless `--queue` waits for the lease or
+`--force` shares it; `relay --list` / `--leases` show the holders.
+`send --if-idle` refuses a leased (`pane_leased`) or busy (`pane_busy`) pane.
+
 For menus: wait for a match and check `reason`, perform one
 `keys --expect TEXT --key Enter`, then wait for the resulting state. `expect`
 also applies to `chars` and `interrupt`. It is a fresh case-insensitive screen

package/skills/zswarm/references/remote.md

@@ -116,6 +116,10 @@ For frequent status polling, prefer serve beside Zellij with an SSH tunnel. Use
 
 `zswarm host install|doctor`, `zswarm crew up|status|down`, `zswarm relay`
 (hand a remote pane work, get a message in a local pane when a done line
-appears; `zswarm relay --wait ID` is the pull path) and `zswarm slot`
-(shared build slots) set up and keep a remote crew running. See
-docs/hosts.md in the zswarm repo.
+appears; `zswarm relay --wait ID` is the pull path, `--list` shows
+running and finished relays, `--leases` lists current pane leases,
+`--cancel ID` stops one) and `zswarm slot` (shared build slots) set up and
+keep a remote crew running. A relay leases its target pane until it ends; a
+second relay (or `send --if-idle`) refuses a leased pane with `pane_leased`
+(`--queue` waits, `--force` shares the lease, a stale lease is taken over).
+See docs/hosts.md in the zswarm repo.