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.
- package/AGENTS.template.md +4 -4
- package/CHANGELOG.md +151 -0
- package/README.md +713 -706
- package/TEAM.template.md +1 -1
- package/bin/crewbus-hook.js +22 -5
- package/bin/crewbus-mcp.js +56 -48
- package/bin/crewbus.js +486 -355
- package/bin/lib/channels.js +1 -1
- package/bin/lib/export.js +1 -1
- package/bin/lib/groups.js +1 -5
- package/bin/lib/identity.js +92 -152
- package/bin/lib/launch.js +128 -30
- package/bin/lib/qrcode.js +2971 -0
- package/bin/lib/relay.js +26 -54
- package/bin/lib/spawn.js +241 -194
- package/bin/lib/store.js +2 -2
- package/bin/lib/web.js +277 -59
- package/claude-plugin/skills/crewbus/SKILL.md +1 -1
- package/docs/APPROVALS.md +8 -8
- package/docs/AUDIT_EXPORT.md +7 -7
- package/docs/CERT_READINESS.md +120 -120
- package/docs/COMPATIBILITY.md +196 -194
- package/docs/CONSOLIDATOR.md +6 -6
- package/docs/CONTROL_PLANE_SPEC.md +12 -14
- package/docs/CREWS.md +16 -13
- package/docs/DELIVERY.md +213 -210
- package/docs/GROUPS.md +8 -8
- package/docs/HA.md +151 -151
- package/docs/IDENTITY.md +6 -6
- package/docs/LEAD_ASSIGN.md +3 -85
- package/docs/LONG_RUNS.md +3 -3
- package/docs/M1_CLI_DRAFT.md +9 -9
- package/docs/ORCHESTRATOR.md +87 -0
- package/docs/PAIRING.md +7 -7
- package/docs/QUICKSTART.md +24 -13
- package/docs/RBAC.md +84 -73
- package/docs/SPLIT.md +82 -82
- package/docs/TENANCY.md +10 -10
- package/docs/THREAT_MODEL.md +68 -69
- package/docs/VERIFIER.md +10 -10
- package/docs/VERSION_SKEW.md +57 -57
- package/documentation.html +37 -29
- package/examples/hermes-pairing.md +3 -3
- package/examples/t3-pairing.md +1 -1
- package/index.html +13 -14
- package/opencode/plugins/dm-watch.js +1 -1
- package/opencode/tools/dm-send.js +4 -13
- package/package.json +75 -50
- package/packages/client-runtime/README.md +40 -40
- package/packages/contracts/harness.json +108 -111
- package/packages/contracts/launch.json +2 -3
- package/packages/contracts/pairing.json +3 -3
- 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>
|
|
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.
|
|
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>
|
|
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>
|
|
222
|
-
<p class="sub">Run live crews from
|
|
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
|
|
225
|
-
<ul><li>
|
|
226
|
-
<div
|
|
227
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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: "
|
|
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
|
|
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
|
|
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
|
-
|
|
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": "
|
|
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
|
-
"
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
"
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
15
|
-
"
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
"
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
"
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
"
|
|
29
|
-
"
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
"
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
"
|
|
48
|
-
|
|
49
|
-
|
|
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
|
|
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` (
|
|
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": "
|
|
95
|
-
"displayName": "
|
|
96
|
-
"binary":
|
|
97
|
-
"
|
|
98
|
-
"
|
|
99
|
-
"
|
|
100
|
-
"
|
|
101
|
-
"
|
|
102
|
-
"
|
|
103
|
-
"
|
|
104
|
-
"
|
|
105
|
-
"
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
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
|
+
}
|