zswarm 0.2.2 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zswarm",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "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.3",
+    "@zswarm/mcp": "0.1.13"
   },
   "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 |
 | `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**.
 

package/skills/zswarm/references/remote.md

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