crewbus 10.0.11 → 11.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/AGENTS.template.md +4 -4
  2. package/CHANGELOG.md +151 -0
  3. package/README.md +713 -706
  4. package/TEAM.template.md +1 -1
  5. package/bin/crewbus-hook.js +22 -5
  6. package/bin/crewbus-mcp.js +56 -48
  7. package/bin/crewbus.js +486 -355
  8. package/bin/lib/channels.js +1 -1
  9. package/bin/lib/export.js +1 -1
  10. package/bin/lib/groups.js +1 -5
  11. package/bin/lib/identity.js +92 -152
  12. package/bin/lib/launch.js +128 -30
  13. package/bin/lib/qrcode.js +2971 -0
  14. package/bin/lib/relay.js +26 -54
  15. package/bin/lib/spawn.js +241 -194
  16. package/bin/lib/store.js +2 -2
  17. package/bin/lib/web.js +277 -59
  18. package/claude-plugin/skills/crewbus/SKILL.md +1 -1
  19. package/docs/APPROVALS.md +8 -8
  20. package/docs/AUDIT_EXPORT.md +7 -7
  21. package/docs/CERT_READINESS.md +120 -120
  22. package/docs/COMPATIBILITY.md +196 -194
  23. package/docs/CONSOLIDATOR.md +6 -6
  24. package/docs/CONTROL_PLANE_SPEC.md +12 -14
  25. package/docs/CREWS.md +16 -13
  26. package/docs/DELIVERY.md +213 -210
  27. package/docs/GROUPS.md +8 -8
  28. package/docs/HA.md +151 -151
  29. package/docs/IDENTITY.md +6 -6
  30. package/docs/LEAD_ASSIGN.md +3 -85
  31. package/docs/LONG_RUNS.md +3 -3
  32. package/docs/M1_CLI_DRAFT.md +9 -9
  33. package/docs/ORCHESTRATOR.md +87 -0
  34. package/docs/PAIRING.md +7 -7
  35. package/docs/QUICKSTART.md +24 -13
  36. package/docs/RBAC.md +84 -73
  37. package/docs/SPLIT.md +82 -82
  38. package/docs/TENANCY.md +10 -10
  39. package/docs/THREAT_MODEL.md +68 -69
  40. package/docs/VERIFIER.md +10 -10
  41. package/docs/VERSION_SKEW.md +57 -57
  42. package/documentation.html +37 -29
  43. package/examples/hermes-pairing.md +3 -3
  44. package/examples/t3-pairing.md +1 -1
  45. package/index.html +13 -14
  46. package/opencode/plugins/dm-watch.js +1 -1
  47. package/opencode/tools/dm-send.js +4 -13
  48. package/package.json +75 -50
  49. package/packages/client-runtime/README.md +40 -40
  50. package/packages/contracts/harness.json +108 -111
  51. package/packages/contracts/launch.json +2 -3
  52. package/packages/contracts/pairing.json +3 -3
  53. package/docs/DESKTOP_SPIKE.md +0 -223
package/index.html CHANGED
@@ -114,7 +114,7 @@ details{border-top:1px solid var(--line);padding:14px 0}summary{cursor:pointer;f
114
114
 
115
115
  <div class="hero" id="top" data-page="home">
116
116
  <div>
117
- <span class="pill"><i></i>v10.0.10 is out</span>
117
+ <span class="pill"><i></i>v11.3.0 is out</span>
118
118
  <h1>Let your coding agents talk to each other.</h1>
119
119
  <p class="lede">A zero-dependency local DM bus. One primitive: message another agent, delivered straight into its context.</p>
120
120
  <div class="cta"><a class="btn" href="#install">Get started</a><a class="btn ghost" href="https://github.com/eamonpluto/crewbus">View on GitHub</a></div>
@@ -168,10 +168,10 @@ details{border-top:1px solid var(--line);padding:14px 0}summary{cursor:pointer;f
168
168
  <section data-page="home" id="start"><div class="w two">
169
169
  <div>
170
170
  <h2 id="install">Five minutes to a crew.</h2>
171
- <p class="sub" style="margin-bottom:20px">Node 18+. Initialize a project, register, and send. The desktop app needs no <code>init</code> at all: pick a project in Launch Studio.</p>
171
+ <p class="sub" style="margin-bottom:20px">Node 18+. Initialize a project, register, and send. Run <code>crewbus web --open</code> to start the local dashboard.</p>
172
172
  <div class="stats">
173
173
  <div><b>0</b><span>dependencies</span></div>
174
- <div><b>20</b><span>test suites</span></div>
174
+ <div><b>29</b><span>test suites</span></div>
175
175
  <div><b>~1s</b><span>async push on opencode</span></div>
176
176
  <div><b>10k</b><span>fan-out in about 4.6s</span></div>
177
177
  </div>
@@ -218,21 +218,20 @@ crewbus doctor</pre>
218
218
  </div></section>
219
219
 
220
220
  <section data-page="apps" hidden><div class="w">
221
- <h2>Desktop and mobile control plane.</h2>
222
- <p class="sub">Run live crews from a native app, then approve worker actions from your phone. Everything stays on your machines.</p>
221
+ <h2>Web dashboard and mobile control plane.</h2>
222
+ <p class="sub">Run live crews from your browser, then approve worker actions from your phone. Everything stays on your machines.</p>
223
223
  <div class="grid" style="grid-template-columns:repeat(auto-fit,minmax(300px,1fr))">
224
- <div class="card"><h3>CrewBus Desktop <span class="tag">v0.1.23</span></h3><p>A native GUI built on Tauri v2. It supervises an isolated sidecar on <code>127.0.0.1</code>, with zero cloud dependency.</p>
225
- <ul><li>Sidecar supervisor with auto-restart and port recovery</li><li>Fleet inspector: terminate workers live, with an Undo toast</li><li>Multi-harness launcher with a context-sensitive model selector</li><li>Briefs view: one row per fan-out with gathered threads; data-age + STALE banner</li><li>One-click QR code to pair the mobile companion</li></ul>
226
- <div class="dl"><a class="btn" href="https://github.com/eamonpluto/crewbus/releases/download/desktop-v0.1.23/CrewBus_0.1.23_x64-setup.exe">Windows</a><a class="btn" href="https://github.com/eamonpluto/crewbus/releases/download/desktop-v0.1.23/CrewBus_0.1.23_aarch64.dmg">macOS (Apple silicon)</a><a class="btn" href="https://github.com/eamonpluto/crewbus/releases/download/desktop-v0.1.23/CrewBus_0.1.23_amd64.AppImage">Linux</a></div>
227
- <a href="https://github.com/eamonpluto/crewbus/releases/tag/desktop-v0.1.23">All release assets (.msi, .deb, .rpm)</a></div>
228
- <div class="card"><h3>CrewBus Mobile <span class="tag t">preview</span></h3><p>A companion built on React Native and Expo. Pair with your desktop or relay by scanning a QR code, without exposing root credentials.</p>
224
+ <div class="card"><h3>CrewBus Web <span class="tag">standalone</span></h3><p>A zero-dependency dashboard served directly by the CLI on <code>127.0.0.1</code>, with zero cloud dependency.</p>
225
+ <ul><li>Instant browser launch with <code>crewbus web --open</code></li><li>Fleet inspector: terminate workers live, with an Undo toast</li><li>Multi-harness launcher with a context-sensitive model selector</li><li>Briefs view: one row per fan-out with gathered threads; data-age + STALE banner</li><li>One-click QR code at <code>/pair</code> to pair the mobile companion</li></ul>
226
+ <div style="margin-top:16px"><code style="padding:8px 12px;display:inline-block">crewbus web --open</code></div></div>
227
+ <div class="card"><h3>CrewBus Mobile <span class="tag t">preview</span></h3><p>A companion built on React Native and Expo. Pair with your web dashboard or relay by scanning a QR code, without exposing root credentials.</p>
229
228
  <ul><li>Per-device credentials with narrow scopes</li><li>Approve or deny worker shell calls from anywhere</li><li>Briefs screen: one row per fan-out, tap for its thread; triage grouped by brief</li><li>Foreground watcher: approvals and dead workers raise an in-app alert + buzz</li><li>Offline outbox: queued actions retry when you tap</li><li>Launch card with dynamic model selection</li></ul>
230
229
  <div class="dl"><a class="btn" href="https://expo.dev/artifacts/eas/clk0vyzypxygmxamqdpzhiib_2gggfvzsu053id9spg.apk">Android APK</a><a class="btn ghost" href="https://expo.dev/accounts/eamonpluto/projects/crewbus-mobile/builds/885a36dc-1689-4345-9274-6e31318b760f">EAS build</a></div>
231
230
  <p style="margin:0">Pair from the CLI with <code>crewbus relay pair qr</code>.</p></div>
232
231
  </div>
233
232
  <h3 class="h3">Multi-harness launch from the CLI</h3>
234
233
  <pre><span class="c"># two workers across two harnesses, replies thread back</span>
235
- crewbus launch --from lead --harness claude,antigravity \
234
+ crewbus launch --from orchestrator --harness claude,antigravity \
236
235
  --workers 2 "Verify auth flow and benchmark."
237
236
 
238
237
  <span class="c"># preview first, or POST the same arguments to a relay</span>
@@ -267,7 +266,7 @@ POST /api/launch</pre>
267
266
  <div id="faq"></div>
268
267
  </div></section>
269
268
 
270
- <div class="w"><footer><span>crewbus v10.0.10 · zero-dependency local DM bus</span><span><a href="https://github.com/eamonpluto/crewbus">GitHub</a></span></footer></div>
269
+ <div class="w"><footer><span>crewbus v11.3.0 · zero-dependency local DM bus</span><span><a href="https://github.com/eamonpluto/crewbus">GitHub</a></span></footer></div>
271
270
 
272
271
  <script>
273
272
  (function(){
@@ -306,10 +305,10 @@ $('cmp').innerHTML=tbl(['','Built-in subagents','crewbus'],[
306
305
  function cards(id,a){$(id).innerHTML=a.map(function(c){return '<div class="card"><h3>'+c[0]+'</h3><p style="margin:0">'+c[1]+'</p></div>'}).join('')}
307
306
  cards('tiers',[['Solo dev, one machine','Start with init, inbox and send. Size the live crew to your box: start around five, then raise --max-spawn.'],['A team on a LAN','Named groups per workstream, spawn --count crews, boards synced machine to machine, and one TEAM.md so a new hire is productive in ten minutes.'],['Governed crews','RBAC, OIDC login, TLS and mTLS, signed audit export, legal holds, encrypted backups, quotas and standby relays. Start at docs/CERT_READINESS.md.']]);
308
307
  cards('uses',[['Researchers','Parameter sweeps, parallel proof attempts where the first clean proof wins, literature triage, and ablations where every run is an addressable agent.'],['Programmers','Parallel refactors, whole-codebase audits by directory, review and fix loops, and incident triage with a kill switch for redundant investigators.'],['Teams','A ten-minute quickstart, and mixed-harness standups where threads and acks replace status meetings for agent work.']]);
309
- var C='init|Plants the board, writes agent instructions, installs harness wiring.|init --harness opencode;update|Self-update the global npm install to the registry latest.|update --check;register|First claim mints your token; later calls prove it.|register --from lead;token|Rotate, expire and inspect identity tokens.|token rotate --from lead;agents|Who exists and who is actually alive.|agents --active;send|The primitive: mission, scope and done-criteria in one DM.|send --to bob --body "…";inbox|Your mail, with no mark-read side effects.|inbox --unacked;listen|Block and print new arrivals, locally or via relay.|listen --timeout 60000;thread|One brief plus every reply, across inboxes.|thread --id msg-…;channel|Append-only public logs: post, tail, search, summarize.|channel tail findings;group|Named recipient sets for variant briefs.|group create team-a;gather|Reduce a batch to one transcript.|gather --batch …;ack|Accept a reply, optionally gated on a checker.|ack --verify "npm test";result|Keep verified-only group outcomes.|result record --group …;race|First verified result wins; losers stand down.|race close --kill;artifact|Publish, adopt and verify board artifacts so output compounds.|artifact list;lesson|Scoped one-liners auto-injected into later spawn briefs.|lesson post --scope … --text "…"spawn|Brief workers and boot them detached.|spawn --count 8;spawn-status|Running? Replied? Acked?|spawn-status --all;spawn-kill|Terminate workers by recorded pid.|spawn-kill --to w1;pool|Boot at most S of N at once, auto-replace exits.|pool --count 20;stop|The global kill switch.|stop --all;serve|Relay: sync, remote crews, health checks.|serve --port 8471;sync|Peer-to-peer board merge.|sync --with …;web|Fleet console on localhost.|web --port 0;doctor|Validate wiring and diagnose split boards.|doctor;prune|Retention windows for old mail and logs.|prune --dry-run';
308
+ var C='init|Plants the board, writes agent instructions, installs harness wiring.|init --harness opencode;update|Self-update the global npm install to the registry latest.|update --check;register|First claim mints your token; later calls prove it.|register --from orchestrator;token|Rotate, expire and inspect identity tokens.|token rotate --from orchestrator;agents|Who exists and who is actually alive.|agents --active;send|The primitive: mission, scope and done-criteria in one DM.|send --to bob --body "…";inbox|Your mail, with no mark-read side effects.|inbox --unacked;listen|Block and print new arrivals, locally or via relay.|listen --timeout 60000;thread|One brief plus every reply, across inboxes.|thread --id msg-…;channel|Append-only public logs: post, tail, search, summarize.|channel tail findings;group|Named recipient sets for variant briefs.|group create team-a;gather|Reduce a batch to one transcript.|gather --batch …;ack|Accept a reply, optionally gated on a checker.|ack --verify "npm test";result|Keep verified-only group outcomes.|result record --group …;race|First verified result wins; losers stand down.|race close --kill;artifact|Publish, adopt and verify board artifacts so output compounds.|artifact list;lesson|Scoped one-liners auto-injected into later spawn briefs.|lesson post --scope … --text "…"spawn|Brief workers and boot them detached.|spawn --count 8;spawn-status|Running? Replied? Acked?|spawn-status --all;spawn-kill|Terminate workers by recorded pid.|spawn-kill --to w1;pool|Boot at most S of N at once, auto-replace exits.|pool --count 20;stop|The global kill switch.|stop --all;serve|Relay: sync, remote crews, health checks.|serve --port 8471;sync|Peer-to-peer board merge.|sync --with …;web|Fleet console on localhost.|web --port 0;doctor|Validate wiring and diagnose split boards.|doctor;prune|Retention windows for old mail and logs.|prune --dry-run';
310
309
  $('cmds').innerHTML=tbl(['Command','What it does','Try first'],C.split(';').map(function(r){var p=r.split('|');return ['<code>'+p[0]+'</code>',p[1],'<code>'+p[2]+'</code>']}));
311
310
  $('docs').innerHTML='QUICKSTART TROUBLESHOOTING WHEN_NOT COMPATIBILITY DELIVERY GROUPS VERIFIER CONSOLIDATOR LIMITS THREAT_MODEL ISOLATION STORAGE EXPERIMENTS IDENTITY RBAC OIDC_TLS AUDIT_EXPORT TENANCY HA SHARED_RESPONSIBILITY CERT_READINESS PAIRING CREWS SPLIT'.split(' ').map(function(d){return '<a href="https://github.com/eamonpluto/crewbus/blob/master/docs/'+d+'.md">'+d.toLowerCase()+'</a>'}).join('');
312
- var R=[['10.0.10','2026-10-18','Observer coordinator lane model (boss / lead / peers), auto-assigned lead (--lead auto|board|none), and Desktop app alignment.'],['10.0.9','2026-10-17','Workbench compound-memory layer: artifacts with adoption/verification and depends-on edges, lessons auto-injected into spawn briefs, needs-by handoff deadlines with inbox --overdue, feed-forward gather metrics; opencode respawn session capture fixed (direct exe boot + SQLite storage fallback).'],['10.0.8','2026-10-16','Launch composer UI refinements: streamlined agent naming, clearer count stepper, flat panel styling, and clean console.'],['10.0.7','2026-10-14','Design refresh and icon fixes across desktop and mobile shells.'],['10.0.6','2026-10-13','Dashboard client hotfix: a template-literal escape killed the whole script block at parse time — fixed, with a regression test that syntax-checks the served page.'],['10.0.5','2026-10-12','Self-update command: crewbus update [--check] [--yes] [--version x.y.z] via your own npm config.'],['10.0.4','2026-10-12','Dashboard Briefs view + gather endpoint, task-scoped spawn rosters, mobile brief/thread/watcher screens.'],['10.0.3','2026-10-10','Worker-record integrity (canonical doc merge), truthful presence, Crew roster block in spawn briefs, doctor dead-man scan.'],['10.0.2','2026-10-09','Target workspace selector and persistence in Launch Studio, clearer project popover, directory picker replaces the upload prompt, desktop companion v0.1.16.'],['10.0.1','2026-10-09','Windows opencode detection fix, model selector sync that blocks incompatible pairings, refreshed model catalog with live discovery.'],['10.0.0','2026-10-08','Multi-harness orchestration (--harness claude,antigravity), canonical model selector, native desktop app, mobile companion with QR pairing, full control plane.'],['7.0.0','2026-10-05','Renamed to crewbus. Human-in-the-loop approvals, long-run resilience, respawn, checkpoints and pool-resume.'],['6.0.0','2026-10-03','Fleet hardening: capability negotiation, credential scrub for workers, per-device pairing, weighted multi-relay crews.'],['5.0.0','2026-10-03','Enterprise tier: RBAC, OIDC, TLS, audit export, legal holds, encrypted backups, quotas, standby relays.'],['3.0.0','2026-09-24','Token-bound identity, presence, pruning, detached spawn, ack and threading, local dashboard.'],['2.0.0','earlier','The DM-only rewrite: one primitive, message another agent, plus the opencode push layer.']];
311
+ var R=[['11.3.0','2026-11-17','Standard package polish: crewbus --version/version --json, command-level --help, dual-registry crewbus update (npm + GitHub Packages) with --registry override, MCP/hook version flags, and public npm publishing as crewbus.'],['11.2.1','2026-10-29','Kill robustness on Windows: spawn-kill / api/kill re-check liveness after a failed taskkill and report already-exited instead of a false kill-failed.'],['11.2.0','2026-10-29','Orchestrator model selection: --orchestrator-model <m> sets the coordinator lane model on spawn, launch, and pool when the lane is provisioned (standing coordinators keep their boot-time model).'],['11.1.0','2026-10-29','Per-worker models: --model a,b,c assigns a different model per spawned worker (cycled in worker order; a single value still applies to all) across spawn, launch, pool, web/RPC, and remote relay boots.'],['11.0.0','2026-10-29','Two-role control plane: one orchestrator plus workers. Removed boss/admin/lead/auditor; spawn "brief" --count N runs as the orchestrator (no --from/--lead); orchestrator init|show; approvals pin to --to orchestrator; docs/contracts/tests updated.'],['10.0.15','2026-10-26','CLI documentation and help flags audit, layout fixes, and Windows test cleanup.'],['10.0.14','2026-10-25','Respawn presence fix: spawnedAt refreshes to the new pid launch on every respawn, so live workers are not read as stale (all harnesses).'],['10.0.13','2026-10-25','Qwen Code harness integration (contracts, spawn targets, session-id preassign, settings init, hooks, dynamic model discovery) and strict lead coordinator auto-provisioning.'],['10.0.12','2026-10-20','Consolidate desktop into standalone crewbus web (/pair QR, --open browser launcher), enforce --lead auto, require managed AI harnesses, retire legacy compatibility.'],['10.0.10','2026-10-18','Observer coordinator lane model (boss / lead / peers), auto-assigned lead (--lead auto|board|none), and Desktop app alignment.'],['10.0.9','2026-10-17','Workbench compound-memory layer: artifacts with adoption/verification and depends-on edges, lessons auto-injected into spawn briefs, needs-by handoff deadlines with inbox --overdue, feed-forward gather metrics; opencode respawn session capture fixed (direct exe boot + SQLite storage fallback).'],['10.0.8','2026-10-16','Launch composer UI refinements: streamlined agent naming, clearer count stepper, flat panel styling, and clean console.'],['10.0.7','2026-10-14','Design refresh and icon fixes across desktop and mobile shells.'],['10.0.6','2026-10-13','Dashboard client hotfix: a template-literal escape killed the whole script block at parse time — fixed, with a regression test that syntax-checks the served page.'],['10.0.5','2026-10-12','Self-update command: crewbus update [--check] [--yes] [--version x.y.z] via your own npm config.'],['10.0.4','2026-10-12','Dashboard Briefs view + gather endpoint, task-scoped spawn rosters, mobile brief/thread/watcher screens.'],['10.0.3','2026-10-10','Worker-record integrity (canonical doc merge), truthful presence, Crew roster block in spawn briefs, doctor dead-man scan.'],['10.0.2','2026-10-09','Target workspace selector and persistence in Launch Studio, clearer project popover, directory picker replaces the upload prompt, desktop companion v0.1.16.'],['10.0.1','2026-10-09','Windows opencode detection fix, model selector sync that blocks incompatible pairings, refreshed model catalog with live discovery.'],['10.0.0','2026-10-08','Multi-harness orchestration (--harness claude,antigravity), canonical model selector, native desktop app, mobile companion with QR pairing, full control plane.'],['7.0.0','2026-10-05','Renamed to crewbus. Human-in-the-loop approvals, long-run resilience, respawn, checkpoints and pool-resume.'],['6.0.0','2026-10-03','Fleet hardening: capability negotiation, credential scrub for workers, per-device pairing, weighted multi-relay crews.'],['5.0.0','2026-10-03','Enterprise tier: RBAC, OIDC, TLS, audit export, legal holds, encrypted backups, quotas, standby relays.'],['3.0.0','2026-09-24','Token-bound identity, presence, pruning, detached spawn, ack and threading, local dashboard.'],['2.0.0','earlier','The DM-only rewrite: one primitive, message another agent, plus the opencode push layer.']];
313
312
  $('rel').innerHTML=R.map(function(r){return '<div><b>'+r[0]+'</b><span class="mono">'+r[1]+'</span><p>'+r[2]+'</p></div>'}).join('');
314
313
  var F=[['Is this just chat for robots?','No. The DM is the task object: a brief carries mission, scope and definition of done, replies thread back, and acks close the loop.'],['Can it run 10,000 agents at once?','10,000 is a broadcast limit: one brief reaches ten thousand inboxes. Live workers are whole harness processes, so size them like compute.'],['What stops an agent going rogue?','Token-bound identity with roles, relay auth with opt-in remote boot, untrusted-peer envelopes, loop and cost guards, budgets, dead-man timeouts and a global stop.'],['Does it phone home?','No. There are no accounts, no telemetry and no update checks. Boards sync only with peers you name.'],['What happens when a worker dies mid-brief?','The brief survives because it is a file, not a process. respawn reboots the worker with a catch-up brief, and pools replace exits automatically.'],['How are results verified?','ack --verify runs your tests or a checker. Only exit 0 records a verified result with its output.'],['When should I not use it?','Single-session work (use subagents), strict ordered pipelines (use a queue), and anything needing real-time guarantees, since the bus is files on disk.'],['Which Node versions work?','Node 18 and newer on Linux, macOS and Windows.'],['Who pays for the tokens agents burn?','Your model provider does. The bus itself costs nothing to run.']];
315
314
  $('faq').innerHTML=F.map(function(f){return '<details><summary>'+f[0]+'</summary><p>'+f[1]+'</p></details>'}).join('');
@@ -500,7 +500,7 @@ export const DmWatchPlugin = async ({ client, directory }) => {
500
500
  }
501
501
  if (agent) {
502
502
  output.context.push(`crewbus: context refreshed after compaction. You are '${agent}' on board ${root}${proven ? " (identity cross-checked)" : ""}.`);
503
- output.context.push(`Token: read ${path.join(root, "logs", agent + ".token")} into CREWBUS_TOKEN (0600 file written at register/mint). Lost it? Ask your lead/admin to revoke it, then re-register for a fresh one.`);
503
+ output.context.push(`Token: read ${path.join(root, "logs", agent + ".token")} into CREWBUS_TOKEN (0600 file written at register/mint). Lost it? Ask the orchestrator to revoke it, then re-register for a fresh one.`);
504
504
  output.context.push(`Then: crewbus inbox --from ${agent} --unacked --digest (escalate to full reads on hits).`);
505
505
  const doc = readJsonSafe(path.join(root, "agents", agent + ".json"));
506
506
  const ws = doc && doc.briefId ? readJsonSafe(path.join(root, "worker-sessions", agent + ".json")) : null;
@@ -4,7 +4,7 @@
4
4
  //
5
5
  // Usage from the agent (just a tool call, whenever you want):
6
6
  // dm-send({ from: "alice", to: "bob", body: "the parser accepts ISO dates only" })
7
- // dm-send({ from: "lead", to: "alice,bob,carol", subject: "brief: cards", body: "..." })
7
+ // dm-send({ from: "orchestrator", to: "alice,bob,carol", subject: "brief: cards", body: "..." })
8
8
  //
9
9
  // Fanning out work ("assign N agents"): there is no task object — the DM *is*
10
10
  // the task. `to` accepts a comma list (one copy each, shared batch id); each
@@ -109,7 +109,6 @@ function agentTokenMatches(rec, token) {
109
109
  return false;
110
110
  }
111
111
  }
112
- if (rec.token) return timingSafeEqual(String(token), String(rec.token));
113
112
  return false;
114
113
  }
115
114
 
@@ -135,7 +134,7 @@ function resolveToken(args) {
135
134
  }
136
135
 
137
136
  // First send as a new name mints its record + token (first-claim-wins).
138
- // Stores only a salted hash; legacy plaintext migrates on successful auth.
137
+ // Stores only a salted hash.
139
138
  function ensureSender(root, agent, token) {
140
139
  const rec = readAgent(root, agent);
141
140
  if (!rec) {
@@ -145,7 +144,7 @@ function ensureSender(root, agent, token) {
145
144
  writeAgentHashed(path.join(root, "agents", agent + ".json"), { name: agent, firstSeen: now, lastSeen: now, tokenHash: hashToken(fresh, salt), salt });
146
145
  return { created: true, token: fresh };
147
146
  }
148
- if (!rec.tokenHash && !rec.token) {
147
+ if (!rec.tokenHash) {
149
148
  const fresh = mintToken();
150
149
  const salt = newSalt();
151
150
  rec.tokenHash = hashToken(fresh, salt);
@@ -154,15 +153,7 @@ function ensureSender(root, agent, token) {
154
153
  writeAgentHashed(path.join(root, "agents", agent + ".json"), rec);
155
154
  return { created: true, token: fresh };
156
155
  }
157
- if (rec.token && !rec.tokenHash) {
158
- if (!agentTokenMatches(rec, token)) throw new Error(`bad token for "${agent}" (pass token or set CREWBUS_TOKEN)`);
159
- const salt = newSalt();
160
- rec.tokenHash = hashToken(String(token), salt);
161
- rec.salt = salt;
162
- delete rec.token;
163
- writeAgentHashed(path.join(root, "agents", agent + ".json"), rec);
164
- return { created: false };
165
- }
156
+
166
157
  if (!agentTokenMatches(rec, token)) throw new Error(`bad token for "${agent}" (pass token or set CREWBUS_TOKEN)`);
167
158
  return { created: false };
168
159
  }
package/package.json CHANGED
@@ -1,50 +1,75 @@
1
- {
2
- "name": "crewbus",
3
- "version": "10.0.11",
4
- "description": "Zero-dependency message bus for AI coding-agent crews: message another agent, inserted into context, just a tool call.",
5
- "type": "module",
6
- "bin": {
7
- "crewbus": "bin/crewbus.js",
8
- "crewbus-mcp": "bin/crewbus-mcp.js",
9
- "crewbus-hook": "bin/crewbus-hook.js"
10
- },
11
- "scripts": {
12
- "test": "node test/crewbus.smoke.mjs && node test/crewbus.kidproc.mjs && node test/crewbus.recover.mjs && node test/crewbus.harness.mjs && node test/crewbus.lead-assign.mjs && node test/crewbus.lead-budget.mjs && node test/crewbus.channel-member.mjs && node test/crewbus.inbox-archive.mjs && node test/crewbus.opencode-respawn.mjs && node test/crewbus.compact.mjs && node test/crewbus.tokenfile.mjs && node test/crewbus.digest.mjs && node test/crewbus.workbench.mjs && node test/crewbus.control-plane.mjs && node test/crewbus.launch.mjs && node test/crewbus.web-launch.mjs && node test/crewbus.pair-api.mjs && node test/crewbus.web-panel.mjs && node test/crewbus.web-approot.mjs && node test/crewbus.client-runtime.mjs && node test/crewbus.runtime-wiring.mjs && node test/crewbus.desktop-sidecar.mjs && node test/crewbus.mobile-client.mjs && node test/crewbus.grok-hooks.mjs && node test/crewbus.holds-quotas.mjs && node test/crewbus.approval-protocol.mjs && node test/crewbus.approvals-init.mjs && node test/crewbus.approvals-web.mjs && node test/fault-injection.mjs && node test/integration.mjs",
13
- "bench": "node test/bench.mjs",
14
- "bench:load": "node test/load.mjs",
15
- "vendor": "node scripts/vendor-runtime.mjs"
16
- },
17
- "files": [
18
- "bin/",
19
- "assets/brand/crewbus-logo-for-light.png",
20
- "assets/brand/crewbus-logo-for-dark.png",
21
- "assets/brand/crewbus-app-icon-1024-rounded.png",
22
- "assets/brand/logo.svg",
23
- "packages/contracts/",
24
- "packages/client-runtime/",
25
- "opencode/",
26
- "claude-plugin/",
27
- "docs/",
28
- "examples/",
29
- "AGENTS.template.md",
30
- "TEAM.template.md",
31
- "documentation.html",
32
- "index.html",
33
- "README.md",
34
- "CHANGELOG.md",
35
- "SECURITY.md"
36
- ],
37
- "engines": {
38
- "node": ">=18"
39
- },
40
- "license": "MIT",
41
- "author": "eamonpluto",
42
- "repository": {
43
- "type": "git",
44
- "url": "https://github.com/eamonpluto/crewbus.git"
45
- },
46
- "bugs": {
47
- "url": "https://github.com/eamonpluto/crewbus/issues"
48
- },
49
- "homepage": "https://eamonpluto.github.io/crewbus/"
50
- }
1
+ {
2
+ "name": "crewbus",
3
+ "version": "11.3.0",
4
+ "description": "Zero-dependency message bus for AI coding-agent crews: message another agent, inserted into context, just a tool call.",
5
+ "type": "module",
6
+ "keywords": [
7
+ "ai",
8
+ "agents",
9
+ "multi-agent",
10
+ "message-bus",
11
+ "mcp",
12
+ "cli",
13
+ "orchestration",
14
+ "developer-tools",
15
+ "coding-agents",
16
+ "opencode",
17
+ "claude-code",
18
+ "codex"
19
+ ],
20
+ "bin": {
21
+ "crewbus": "bin/crewbus.js",
22
+ "crewbus-mcp": "bin/crewbus-mcp.js",
23
+ "crewbus-hook": "bin/crewbus-hook.js"
24
+ },
25
+ "scripts": {
26
+ "test": "node test/crewbus.smoke.mjs && node test/crewbus.kidproc.mjs && node test/crewbus.recover.mjs && node test/crewbus.harness.mjs && node test/crewbus.lead-assign.mjs && node test/crewbus.lead-budget.mjs && node test/crewbus.channel-member.mjs && node test/crewbus.inbox-archive.mjs && node test/crewbus.opencode-respawn.mjs && node test/crewbus.compact.mjs && node test/crewbus.tokenfile.mjs && node test/crewbus.digest.mjs && node test/crewbus.workbench.mjs && node test/crewbus.control-plane.mjs && node test/crewbus.launch.mjs && node test/crewbus.web-launch.mjs && node test/crewbus.pair-api.mjs && node test/crewbus.web-panel.mjs && node test/crewbus.web-approot.mjs && node test/crewbus.client-runtime.mjs && node test/crewbus.runtime-wiring.mjs && node test/crewbus.mobile-client.mjs && node test/crewbus.grok-hooks.mjs && node test/crewbus.holds-quotas.mjs && node test/crewbus.approval-protocol.mjs && node test/crewbus.approvals-init.mjs && node test/crewbus.approvals-web.mjs && node test/fault-injection.mjs && node test/integration.mjs",
27
+ "bench": "node test/bench.mjs",
28
+ "bench:load": "node test/load.mjs",
29
+ "vendor": "node scripts/vendor-runtime.mjs",
30
+ "prepack": "node sync-embeds.mjs --check",
31
+ "pack:check": "npm pack --dry-run",
32
+ "publish:npm": "npm publish --access public --registry https://registry.npmjs.org/",
33
+ "publish:github": "node scripts/publish-github.mjs"
34
+ },
35
+ "files": [
36
+ "bin/",
37
+ "assets/brand/crewbus-logo-for-light.png",
38
+ "assets/brand/crewbus-logo-for-dark.png",
39
+ "assets/brand/crewbus-app-icon-1024-rounded.png",
40
+ "assets/brand/logo.svg",
41
+ "packages/contracts/",
42
+ "packages/client-runtime/",
43
+ "opencode/",
44
+ "claude-plugin/",
45
+ "docs/",
46
+ "examples/",
47
+ "AGENTS.template.md",
48
+ "TEAM.template.md",
49
+ "documentation.html",
50
+ "index.html",
51
+ "README.md",
52
+ "CHANGELOG.md",
53
+ "SECURITY.md"
54
+ ],
55
+ "engines": {
56
+ "node": ">=18"
57
+ },
58
+ "license": "MIT",
59
+ "author": "eamonpluto",
60
+ "funding": {
61
+ "type": "custom",
62
+ "url": "https://www.paypal.me/cifwep"
63
+ },
64
+ "publishConfig": {
65
+ "registry": "https://registry.npmjs.org/"
66
+ },
67
+ "repository": {
68
+ "type": "git",
69
+ "url": "https://github.com/eamonpluto/crewbus.git"
70
+ },
71
+ "bugs": {
72
+ "url": "https://github.com/eamonpluto/crewbus/issues"
73
+ },
74
+ "homepage": "https://eamonpluto.github.io/crewbus/"
75
+ }
@@ -1,40 +1,40 @@
1
- # CrewBus client-runtime (M3)
2
-
3
- Shared supervisor/routes/auth/cache for Tauri desktop + Expo mobile.
4
- Runtime-agnostic core: no Node-only imports. Shells inject `fetch`,
5
- timers, clocks, and secure storage. Zero dependencies, Node >= 18.
6
-
7
- ## Install
8
-
9
- Import from source or your bundler; no build step, no node_modules:
10
-
11
- ```js
12
- import { Supervisor } from "../packages/client-runtime/index.js";
13
- ```
14
-
15
- ## Routes (`routes.js`)
16
-
17
- ```js
18
- import { fetchAdvertisedRoutes, walkRoutes } from "./routes.js";
19
- const hints = await fetchAdvertisedRoutes(fetch, envBase); // GET /api/routes
20
- const won = await walkRoutes(hints, probeRoute); // first-that-works
21
- if (!won.ok) throw new Error(won.reason); // never silent loopback
22
- ```
23
-
24
- Loopback is skipped unless `allowLoopback: true` (desktop sidecar only).
25
- `LearnedRoutes` remembers LAN/tailnet winners; failures cool down 30s.
26
- While on a later route, `preflightEarlierRoutes()` re-probes earlier ones.
27
-
28
- ## Supervisor (`supervisor.js`)
29
-
30
- One retry owner: single-flight `connect()`, jittered backoff (5min cap),
31
- route-walk on every attempt, `resubscribe` hook re-establishes `/sync/wait`.
32
- Drops call `noteDrop()`; exactly one timer; `retryNow()` foreground-probes.
33
-
34
- ## Auth + cache
35
-
36
- `parsePairUrl()` takes secrets from `#fragment` only (query secrets throw).
37
- `createAuthStore({ secureStore })` holds `abd-…` creds; narrow-only scopes
38
- from `pairing.json`; `clear()` wipes memory + store. Mobile overrides the
39
- store with biometric storage. Cache keeps inbox/drafts by TTL; mutations
40
- queue but only run on explicit `retry()` — never auto-replayed.
1
+ # CrewBus client-runtime (M3)
2
+
3
+ Shared supervisor/routes/auth/cache for CrewBus Web + Expo mobile.
4
+ Runtime-agnostic core: no Node-only imports. Shells inject `fetch`,
5
+ timers, clocks, and secure storage. Zero dependencies, Node >= 18.
6
+
7
+ ## Install
8
+
9
+ Import from source or your bundler; no build step, no node_modules:
10
+
11
+ ```js
12
+ import { Supervisor } from "../packages/client-runtime/index.js";
13
+ ```
14
+
15
+ ## Routes (`routes.js`)
16
+
17
+ ```js
18
+ import { fetchAdvertisedRoutes, walkRoutes } from "./routes.js";
19
+ const hints = await fetchAdvertisedRoutes(fetch, envBase); // GET /api/routes
20
+ const won = await walkRoutes(hints, probeRoute); // first-that-works
21
+ if (!won.ok) throw new Error(won.reason); // never silent loopback
22
+ ```
23
+
24
+ Loopback is skipped unless `allowLoopback: true` (local loopback only).
25
+ `LearnedRoutes` remembers LAN/tailnet winners; failures cool down 30s.
26
+ While on a later route, `preflightEarlierRoutes()` re-probes earlier ones.
27
+
28
+ ## Supervisor (`supervisor.js`)
29
+
30
+ One retry owner: single-flight `connect()`, jittered backoff (5min cap),
31
+ route-walk on every attempt, `resubscribe` hook re-establishes `/sync/wait`.
32
+ Drops call `noteDrop()`; exactly one timer; `retryNow()` foreground-probes.
33
+
34
+ ## Auth + cache
35
+
36
+ `parsePairUrl()` takes secrets from `#fragment` only (query secrets throw).
37
+ `createAuthStore({ secureStore })` holds `abd-…` creds; narrow-only scopes
38
+ from `pairing.json`; `clear()` wipes memory + store. Mobile overrides the
39
+ store with biometric storage. Cache keeps inbox/drafts by TTL; mutations
40
+ queue but only run on explicit `retry()` — never auto-replayed.
@@ -1,111 +1,108 @@
1
- {
2
- "contract": "crewbus harness adapters",
3
- "version": 1,
4
- "status": "frozen-M0",
5
- "note": "UIs render resume unsupported when resume=false; never fake continuity. Mirrors bin/lib/spawn.js buildSpawnTarget + docs/COMPATIBILITY.md.",
6
- "drivers": [
7
- {
8
- "driver": "opencode",
9
- "displayName": "opencode",
10
- "binary": "opencode",
11
- "versionProbe": ["--version"],
12
- "briefDelivery": "file",
13
- "sessionCapture": "log",
14
- "sessionKeys": ["session.id", "session_id"],
15
- "resume": true,
16
- "capabilities": { "jsonLog": true, "preassign": false, "compactionHook": "verified", "autoModes": ["auto-approve"] },
17
- "permissionMap": { "supervised": "default prompts", "autoEdits": "not offered — supervised + note", "auto": "--auto (auto-approve non-denied)", "full": "--auto --i-understand-danger" },
18
- "spawnArgs": "run --file <brief> --format json",
19
- "resumeArgs": "run --session <id> --file <brief|catchup> --format json"
20
- },
21
- {
22
- "driver": "claude",
23
- "displayName": "Claude Code",
24
- "binary": "claude",
25
- "versionProbe": ["--version"],
26
- "briefDelivery": "stdin",
27
- "sessionCapture": "preassigned",
28
- "sessionKeys": ["session_id", "sessionId"],
29
- "resume": true,
30
- "capabilities": { "jsonLog": true, "preassign": true, "preassignFlag": "--session-id", "compactionHook": "verified", "autoModes": ["unattended -p"] },
31
- "permissionMap": { "supervised": "default prompts", "autoEdits": "acceptEdits middle ground where supported", "auto": "--auto equivalent unattended", "full": "--auto --i-understand-danger" },
32
- "spawnArgs": "-p --output-format json --session-id <uuid> < brief",
33
- "resumeArgs": "-p --resume <id> (+ CLAUDE_CODE_RESUME_INTERRUPTED_TURN=1); never --session-id with --resume"
34
- },
35
- {
36
- "driver": "codex",
37
- "displayName": "Codex CLI",
38
- "binary": "codex",
39
- "versionProbe": ["--version"],
40
- "briefDelivery": "inline",
41
- "sessionCapture": "log",
42
- "sessionKeys": ["thread_id", "thread.started"],
43
- "resume": true,
44
- "capabilities": { "jsonLog": true, "preassign": false, "compactionHook": "verified", "autoModes": ["approval-policy driven"] },
45
- "permissionMap": { "supervised": "default approval_policy", "autoEdits": "acceptEdits-class where supported", "auto": "--auto equivalent", "full": "--auto --i-understand-danger" },
46
- "spawnArgs": "exec --json <parent opts> \"<brief inline>\"",
47
- "resumeArgs": "exec <parent opts> resume <id> \"<catchup inline>\""
48
- },
49
- {
50
- "driver": "grok",
51
- "displayName": "grok-build",
52
- "binary": "grok",
53
- "versionProbe": ["--version"],
54
- "briefDelivery": "file",
55
- "sessionCapture": "preassigned",
56
- "sessionKeys": ["session_id"],
57
- "resume": true,
58
- "capabilities": { "jsonLog": true, "preassign": true, "preassignFlag": "-s", "compactionHook": "verified", "autoModes": ["--always-approve", "acceptEdits middle ground"] },
59
- "permissionMap": { "supervised": "default prompts (no auto-accept-edits offered)", "autoEdits": "not offered — supervised + note", "auto": "--always-approve or acceptEdits", "full": "--always-approve --i-understand-danger" },
60
- "spawnArgs": "--prompt-file <brief> -s <uuid> --output-format json",
61
- "resumeArgs": "--prompt-file <catchup> -r <id>"
62
- },
63
- {
64
- "driver": "antigravity",
65
- "displayName": "Antigravity",
66
- "binary": "agy",
67
- "versionProbe": ["--version"],
68
- "briefDelivery": "inline",
69
- "sessionCapture": "none",
70
- "sessionKeys": [],
71
- "resume": false,
72
- "resumeNote": "no stable conversation id on stdout; honestly unsupported until vendor emits one",
73
- "capabilities": { "jsonLog": false, "preassign": false, "compactionHook": "verified", "autoModes": ["--dangerously-skip-permissions"] },
74
- "permissionMap": { "supervised": "default --mode accept-edits + native approvals", "autoEdits": "--mode accept-edits", "auto": "--dangerously-skip-permissions (native approvals can still surface)", "full": "--dangerously-skip-permissions --i-understand-danger" },
75
- "spawnArgs": "--print --mode accept-edits \"<brief inline>\"",
76
- "resumeArgs": "-p \"<catchup>\" --conversation <id> (id rarely captured)"
77
- },
78
- {
79
- "driver": "cursor",
80
- "displayName": "Cursor",
81
- "binary": "cursor-agent",
82
- "versionProbe": ["--version"],
83
- "briefDelivery": "inline",
84
- "sessionCapture": "none",
85
- "sessionKeys": [],
86
- "resume": false,
87
- "resumeNote": "id lives in stream-json; spawn uses plain print mode; honestly unsupported",
88
- "capabilities": { "jsonLog": false, "preassign": false, "compactionHook": "verified", "autoModes": ["--yolo"] },
89
- "permissionMap": { "supervised": "default prompts", "autoEdits": "not offered — supervised + note", "auto": "--auto adds --yolo", "full": "--yolo --i-understand-danger" },
90
- "spawnArgs": "cursor-agent -p --force --trust \"<brief inline>\"",
91
- "resumeArgs": "-p --force --resume <id> \"<catchup>\" (id rarely captured)"
92
- },
93
- {
94
- "driver": "generic",
95
- "displayName": "generic",
96
- "binary": null,
97
- "binaryNote": "operator-supplied --cmd; remote needs --allow-cmd",
98
- "versionProbe": [],
99
- "briefDelivery": "file",
100
- "briefNote": "prompt file path available; command decides how to consume it",
101
- "sessionCapture": "none",
102
- "sessionKeys": [],
103
- "resume": false,
104
- "resumeNote": "no continuity — fresh boot of the catch-up brief",
105
- "capabilities": { "jsonLog": false, "preassign": false, "compactionHook": "none", "autoModes": [] },
106
- "permissionMap": { "supervised": "command default", "autoEdits": "n/a", "auto": "operator --cmd decides", "full": "operator --cmd decides" },
107
- "spawnArgs": "--cmd \"<arbitrary>\"",
108
- "resumeArgs": "fresh boot only"
109
- }
110
- ]
111
- }
1
+ {
2
+ "contract": "crewbus harness adapters",
3
+ "version": 1,
4
+ "status": "frozen-M0",
5
+ "note": "UIs render resume unsupported when resume=false; never fake continuity. Mirrors bin/lib/spawn.js buildSpawnTarget + docs/COMPATIBILITY.md.",
6
+ "drivers": [
7
+ {
8
+ "driver": "opencode",
9
+ "displayName": "opencode",
10
+ "binary": "opencode",
11
+ "versionProbe": ["--version"],
12
+ "briefDelivery": "file",
13
+ "sessionCapture": "log",
14
+ "sessionKeys": ["session.id", "session_id"],
15
+ "resume": true,
16
+ "capabilities": { "jsonLog": true, "preassign": false, "compactionHook": "verified", "autoModes": ["auto-approve"] },
17
+ "permissionMap": { "supervised": "default prompts", "autoEdits": "not offered — supervised + note", "auto": "--auto (auto-approve non-denied)", "full": "--auto --i-understand-danger" },
18
+ "spawnArgs": "run --file <brief> --format json",
19
+ "resumeArgs": "run --session <id> --file <brief|catchup> --format json"
20
+ },
21
+ {
22
+ "driver": "claude",
23
+ "displayName": "Claude Code",
24
+ "binary": "claude",
25
+ "versionProbe": ["--version"],
26
+ "briefDelivery": "stdin",
27
+ "sessionCapture": "preassigned",
28
+ "sessionKeys": ["session_id", "sessionId"],
29
+ "resume": true,
30
+ "capabilities": { "jsonLog": true, "preassign": true, "preassignFlag": "--session-id", "compactionHook": "verified", "autoModes": ["unattended -p"] },
31
+ "permissionMap": { "supervised": "default prompts", "autoEdits": "acceptEdits middle ground where supported", "auto": "--auto equivalent unattended", "full": "--auto --i-understand-danger" },
32
+ "spawnArgs": "-p --output-format json --session-id <uuid> < brief",
33
+ "resumeArgs": "-p --resume <id> (+ CLAUDE_CODE_RESUME_INTERRUPTED_TURN=1); never --session-id with --resume"
34
+ },
35
+ {
36
+ "driver": "codex",
37
+ "displayName": "Codex CLI",
38
+ "binary": "codex",
39
+ "versionProbe": ["--version"],
40
+ "briefDelivery": "inline",
41
+ "sessionCapture": "log",
42
+ "sessionKeys": ["thread_id", "thread.started"],
43
+ "resume": true,
44
+ "capabilities": { "jsonLog": true, "preassign": false, "compactionHook": "verified", "autoModes": ["approval-policy driven"] },
45
+ "permissionMap": { "supervised": "default approval_policy", "autoEdits": "acceptEdits-class where supported", "auto": "--auto equivalent", "full": "--auto --i-understand-danger" },
46
+ "spawnArgs": "exec --json <parent opts> \"<brief inline>\"",
47
+ "resumeArgs": "exec <parent opts> resume <id> \"<catchup inline>\""
48
+ },
49
+ {
50
+ "driver": "grok",
51
+ "displayName": "grok-build",
52
+ "binary": "grok",
53
+ "versionProbe": ["--version"],
54
+ "briefDelivery": "file",
55
+ "sessionCapture": "preassigned",
56
+ "sessionKeys": ["session_id"],
57
+ "resume": true,
58
+ "capabilities": { "jsonLog": true, "preassign": true, "preassignFlag": "-s", "compactionHook": "verified", "autoModes": ["--always-approve", "acceptEdits middle ground"] },
59
+ "permissionMap": { "supervised": "default prompts (no auto-accept-edits offered)", "autoEdits": "not offered — supervised + note", "auto": "--always-approve or acceptEdits", "full": "--always-approve --i-understand-danger" },
60
+ "spawnArgs": "--prompt-file <brief> -s <uuid> --output-format json",
61
+ "resumeArgs": "--prompt-file <catchup> -r <id>"
62
+ },
63
+ {
64
+ "driver": "antigravity",
65
+ "displayName": "Antigravity",
66
+ "binary": "agy",
67
+ "versionProbe": ["--version"],
68
+ "briefDelivery": "inline",
69
+ "sessionCapture": "none",
70
+ "sessionKeys": [],
71
+ "resume": false,
72
+ "resumeNote": "no stable conversation id on stdout; honestly unsupported until vendor emits one",
73
+ "capabilities": { "jsonLog": false, "preassign": false, "compactionHook": "verified", "autoModes": ["--dangerously-skip-permissions"] },
74
+ "permissionMap": { "supervised": "default --mode accept-edits + native approvals", "autoEdits": "--mode accept-edits", "auto": "--dangerously-skip-permissions (native approvals can still surface)", "full": "--dangerously-skip-permissions --i-understand-danger" },
75
+ "spawnArgs": "--print --mode accept-edits \"<brief inline>\"",
76
+ "resumeArgs": "-p \"<catchup>\" --conversation <id> (id rarely captured)"
77
+ },
78
+ {
79
+ "driver": "cursor",
80
+ "displayName": "Cursor",
81
+ "binary": "cursor-agent",
82
+ "versionProbe": ["--version"],
83
+ "briefDelivery": "inline",
84
+ "sessionCapture": "none",
85
+ "sessionKeys": [],
86
+ "resume": false,
87
+ "resumeNote": "id lives in stream-json; spawn uses plain print mode; honestly unsupported",
88
+ "capabilities": { "jsonLog": false, "preassign": false, "compactionHook": "verified", "autoModes": ["--yolo"] },
89
+ "permissionMap": { "supervised": "default prompts", "autoEdits": "not offered — supervised + note", "auto": "--auto adds --yolo", "full": "--yolo --i-understand-danger" },
90
+ "spawnArgs": "cursor-agent -p --force --trust \"<brief inline>\"",
91
+ "resumeArgs": "-p --force --resume <id> \"<catchup>\" (id rarely captured)"
92
+ },
93
+ {
94
+ "driver": "qwen",
95
+ "displayName": "Qwen Code",
96
+ "binary": "qwen",
97
+ "versionProbe": ["--version"],
98
+ "briefDelivery": "inline",
99
+ "sessionCapture": "preassigned",
100
+ "sessionKeys": ["session_id", "sessionId"],
101
+ "resume": true,
102
+ "capabilities": { "jsonLog": true, "preassign": true, "preassignFlag": "--session-id", "compactionHook": "verified", "autoModes": ["-y", "--approval-mode yolo"] },
103
+ "permissionMap": { "supervised": "default prompts", "autoEdits": "--approval-mode auto-edit", "auto": "--approval-mode auto or -y", "full": "-y --approval-mode yolo" },
104
+ "spawnArgs": "--output-format json -y --approval-mode yolo \"<brief inline>\"",
105
+ "resumeArgs": "--resume <id> \"<catchup inline>\""
106
+ }
107
+ ]
108
+ }