zswarm 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zswarm",
-  "version": "0.2.3",
+  "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.3",
-    "@zswarm/mcp": "0.1.13"
+    "@zswarm/cli": "0.2.4",
+    "@zswarm/mcp": "0.1.14"
   },
   "publishConfig": {
     "access": "public"

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`. `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 |
+| `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 |
@@ -87,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

@@ -117,6 +117,9 @@ 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, `--list` shows
-running and finished relays, `--cancel ID` stops one) and `zswarm slot`
-(shared build slots) set up and keep a remote crew running. See
-docs/hosts.md in the zswarm repo.
+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.