crewbus 10.0.12 → 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 +135 -0
- package/README.md +69 -44
- package/TEAM.template.md +1 -1
- package/bin/crewbus-hook.js +22 -5
- package/bin/crewbus-mcp.js +56 -48
- package/bin/crewbus.js +459 -238
- 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 +90 -128
- package/bin/lib/launch.js +63 -8
- package/bin/lib/relay.js +25 -42
- package/bin/lib/spawn.js +155 -162
- package/bin/lib/store.js +2 -2
- package/bin/lib/web.js +49 -46
- 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 +5 -5
- package/docs/COMPATIBILITY.md +6 -2
- package/docs/CONSOLIDATOR.md +6 -6
- package/docs/CONTROL_PLANE_SPEC.md +3 -3
- package/docs/CREWS.md +58 -55
- package/docs/DELIVERY.md +11 -8
- package/docs/GROUPS.md +8 -8
- package/docs/IDENTITY.md +6 -6
- package/docs/LEAD_ASSIGN.md +2 -73
- package/docs/LONG_RUNS.md +3 -3
- package/docs/M1_CLI_DRAFT.md +7 -7
- package/docs/ORCHESTRATOR.md +87 -0
- package/docs/PAIRING.md +7 -7
- package/docs/QUICKSTART.md +81 -70
- package/docs/RBAC.md +84 -73
- package/docs/TENANCY.md +10 -10
- package/docs/THREAT_MODEL.md +3 -3
- package/docs/VERIFIER.md +10 -10
- package/docs/VERSION_SKEW.md +1 -1
- package/documentation.html +33 -24
- package/examples/hermes-pairing.md +3 -3
- package/examples/t3-pairing.md +1 -1
- package/index.html +6 -6
- package/opencode/plugins/dm-watch.js +1 -1
- package/opencode/tools/dm-send.js +1 -1
- package/package.json +27 -2
- package/packages/contracts/harness.json +15 -1
- package/packages/contracts/launch.json +2 -3
- package/packages/contracts/pairing.json +3 -3
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>
|
|
@@ -171,7 +171,7 @@ details{border-top:1px solid var(--line);padding:14px 0}summary{cursor:pointer;f
|
|
|
171
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>
|
|
@@ -231,7 +231,7 @@ crewbus doctor</pre>
|
|
|
231
231
|
</div>
|
|
232
232
|
<h3 class="h3">Multi-harness launch from the CLI</h3>
|
|
233
233
|
<pre><span class="c"># two workers across two harnesses, replies thread back</span>
|
|
234
|
-
crewbus launch --from
|
|
234
|
+
crewbus launch --from orchestrator --harness claude,antigravity \
|
|
235
235
|
--workers 2 "Verify auth flow and benchmark."
|
|
236
236
|
|
|
237
237
|
<span class="c"># preview first, or POST the same arguments to a relay</span>
|
|
@@ -266,7 +266,7 @@ POST /api/launch</pre>
|
|
|
266
266
|
<div id="faq"></div>
|
|
267
267
|
</div></section>
|
|
268
268
|
|
|
269
|
-
<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>
|
|
270
270
|
|
|
271
271
|
<script>
|
|
272
272
|
(function(){
|
|
@@ -305,10 +305,10 @@ $('cmp').innerHTML=tbl(['','Built-in subagents','crewbus'],[
|
|
|
305
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('')}
|
|
306
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.']]);
|
|
307
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.']]);
|
|
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
|
|
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';
|
|
309
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>']}));
|
|
310
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('');
|
|
311
|
-
var R=[['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.']];
|
|
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.']];
|
|
312
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('');
|
|
313
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.']];
|
|
314
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
|
package/package.json
CHANGED
|
@@ -1,8 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "crewbus",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "11.3.0",
|
|
4
4
|
"description": "Zero-dependency message bus for AI coding-agent crews: message another agent, inserted into context, just a tool call.",
|
|
5
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
|
+
],
|
|
6
20
|
"bin": {
|
|
7
21
|
"crewbus": "bin/crewbus.js",
|
|
8
22
|
"crewbus-mcp": "bin/crewbus-mcp.js",
|
|
@@ -12,7 +26,11 @@
|
|
|
12
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",
|
|
13
27
|
"bench": "node test/bench.mjs",
|
|
14
28
|
"bench:load": "node test/load.mjs",
|
|
15
|
-
"vendor": "node scripts/vendor-runtime.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"
|
|
16
34
|
},
|
|
17
35
|
"files": [
|
|
18
36
|
"bin/",
|
|
@@ -39,6 +57,13 @@
|
|
|
39
57
|
},
|
|
40
58
|
"license": "MIT",
|
|
41
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
|
+
},
|
|
42
67
|
"repository": {
|
|
43
68
|
"type": "git",
|
|
44
69
|
"url": "https://github.com/eamonpluto/crewbus.git"
|
|
@@ -89,6 +89,20 @@
|
|
|
89
89
|
"permissionMap": { "supervised": "default prompts", "autoEdits": "not offered — supervised + note", "auto": "--auto adds --yolo", "full": "--yolo --i-understand-danger" },
|
|
90
90
|
"spawnArgs": "cursor-agent -p --force --trust \"<brief inline>\"",
|
|
91
91
|
"resumeArgs": "-p --force --resume <id> \"<catchup>\" (id rarely captured)"
|
|
92
|
-
}
|
|
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
|
+
}
|
|
93
107
|
]
|
|
94
108
|
}
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
"note": "Same validation as CLI launch wizard. Thin over bootWorker (local) or remoteSpawn (per relay). dryRun previews exact commands without booting.",
|
|
7
7
|
"request": {
|
|
8
8
|
"required": ["harness", "body"],
|
|
9
|
-
"optional": ["board", "count", "prefix", "to", "subject", "priority", "model", "maxTurns", "allowTools", "permission", "isolate", "worktree", "branch", "lifetime", "budgetTokens", "budgetMinutes", "timeout", "target", "dryRun"
|
|
10
|
-
"defaults": { "count": 1, "permission": "supervised", "lifetime": "oneshot", "target": "local", "dryRun": false
|
|
9
|
+
"optional": ["board", "count", "prefix", "to", "subject", "priority", "model", "models", "orchestratorModel", "maxTurns", "allowTools", "permission", "isolate", "worktree", "branch", "lifetime", "budgetTokens", "budgetMinutes", "timeout", "target", "dryRun"],
|
|
10
|
+
"defaults": { "count": 1, "permission": "supervised", "lifetime": "oneshot", "target": "local", "dryRun": false },
|
|
11
11
|
"constraints": {
|
|
12
12
|
"harness": "one of harness.json drivers",
|
|
13
13
|
"body": "max 8000 chars (MAX_BODY_CHARS)",
|
|
@@ -15,7 +15,6 @@
|
|
|
15
15
|
"permission": "supervised|autoEdits|auto|full",
|
|
16
16
|
"lifetime": "oneshot|persistent",
|
|
17
17
|
"priority": "high|normal",
|
|
18
|
-
"lead": "auto",
|
|
19
18
|
"target": "local | {relays:[{url,weight}]}"
|
|
20
19
|
},
|
|
21
20
|
"permissionMapping": {
|
|
@@ -16,10 +16,10 @@
|
|
|
16
16
|
"treat pairing URLs + abd- creds as passwords (no screenshots/logs/bug reports)"
|
|
17
17
|
],
|
|
18
18
|
"endpoints": {
|
|
19
|
-
"issue": "POST /api/pair/issue (
|
|
19
|
+
"issue": "POST /api/pair/issue (orchestrator, token-checked; body {label?, ttl?, scopes?}) -> {pairUrl, expiresAt}",
|
|
20
20
|
"exchange": "POST /api/pair/exchange (body {pairToken, label?, scopes?}) -> {deviceId, credential (abd-..., once only)}; requested scopes must be subset of granted (narrow-only, never widen)",
|
|
21
|
-
"devices": "GET /api/pair/devices (
|
|
22
|
-
"revoke": "POST /api/pair/revoke (
|
|
21
|
+
"devices": "GET /api/pair/devices (orchestrator) -> [{id, label, by, lastSeen, revoked?}]",
|
|
22
|
+
"revoke": "POST /api/pair/revoke (orchestrator; body {deviceId}) -> immediate 403 on next use"
|
|
23
23
|
},
|
|
24
24
|
"scopes": ["launch:spawn", "launch:kill", "mail:send", "mail:inbox", "mail:ack", "fleet:read", "admin:pair", "admin:revoke"],
|
|
25
25
|
"defaultScope": "full device (today's secret-equivalent) unless narrowed at exchange",
|