tryharness 0.7.45 → 0.7.53

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 (99) hide show
  1. package/README.md +232 -12
  2. package/cli.mjs +406 -184
  3. package/lib/actorRoster.mjs +28 -5
  4. package/lib/adapters.mjs +9 -1
  5. package/lib/agentRuntimeConfig.mjs +36 -0
  6. package/lib/agentRuntimes.mjs +560 -0
  7. package/lib/atlas.mjs +7 -2
  8. package/lib/boardCommands.mjs +5 -10
  9. package/lib/boardFileCommands.mjs +2 -1
  10. package/lib/boardMirror.mjs +459 -0
  11. package/lib/boardProtocol.json +206 -6
  12. package/lib/boardTools.mjs +2 -6
  13. package/lib/bridge.mjs +25 -3
  14. package/lib/browserWake.mjs +60 -0
  15. package/lib/cards.mjs +35 -2
  16. package/lib/commands.mjs +20 -5
  17. package/lib/connectionTools.d.ts +13 -0
  18. package/lib/connectionTools.js +45 -0
  19. package/lib/connectorAuth.mjs +309 -0
  20. package/lib/connectorCatalog.json +41 -0
  21. package/lib/connectorCommands.mjs +121 -0
  22. package/lib/connectorGoogle.mjs +513 -0
  23. package/lib/connectors.mjs +805 -0
  24. package/lib/coordinator.mjs +8 -1
  25. package/lib/coreModels.mjs +78 -0
  26. package/lib/daemon.mjs +643 -45
  27. package/lib/desktop.mjs +7 -2
  28. package/lib/digest.mjs +32 -0
  29. package/lib/directLink.mjs +283 -0
  30. package/lib/environments.mjs +595 -0
  31. package/lib/folders.mjs +2 -2
  32. package/lib/goalCommands.mjs +58 -14
  33. package/lib/inference.mjs +263 -152
  34. package/lib/lessons.mjs +6 -0
  35. package/lib/lineup.mjs +324 -0
  36. package/lib/localmodels.mjs +10 -0
  37. package/lib/machineIdentity.mjs +3 -0
  38. package/lib/machineRoutes.mjs +40 -2
  39. package/lib/machineRuns.mjs +30 -3
  40. package/lib/machineSeal.mjs +69 -10
  41. package/lib/mcp-stdio.mjs +121 -118
  42. package/lib/mcpRelay.mjs +119 -0
  43. package/lib/members.json +12 -0
  44. package/lib/members.mjs +33 -0
  45. package/lib/modelMemory.mjs +100 -0
  46. package/lib/modelTiers.json +1183 -0
  47. package/lib/modelTiers.mjs +133 -0
  48. package/lib/models.mjs +41 -8
  49. package/lib/museSession.mjs +119 -0
  50. package/lib/nativeHost.mjs +203 -0
  51. package/lib/network.mjs +7 -2
  52. package/lib/nudge.mjs +10 -2
  53. package/lib/onboard.mjs +430 -1
  54. package/lib/oneclawLocal.mjs +150 -0
  55. package/lib/ownMachines.mjs +521 -36
  56. package/lib/pairing.mjs +165 -0
  57. package/lib/paths.mjs +4 -0
  58. package/lib/phones.mjs +61 -0
  59. package/lib/placeCommands.mjs +27 -0
  60. package/lib/places.mjs +10 -2
  61. package/lib/plans.mjs +151 -27
  62. package/lib/profile.mjs +152 -0
  63. package/lib/projects.mjs +624 -137
  64. package/lib/readiness.mjs +283 -0
  65. package/lib/repoLinks.mjs +354 -0
  66. package/lib/roomChannels.mjs +641 -0
  67. package/lib/runBrief.mjs +32 -2
  68. package/lib/runRequests.mjs +157 -0
  69. package/lib/runWorker.mjs +20 -7
  70. package/lib/runner.mjs +67 -8
  71. package/lib/secretPatterns.json +55 -0
  72. package/lib/secrets.mjs +10 -27
  73. package/lib/seen.mjs +102 -0
  74. package/lib/service.mjs +11 -6
  75. package/lib/sessionControl.mjs +10 -8
  76. package/lib/sessionIndex.mjs +5 -3
  77. package/lib/store.mjs +546 -29
  78. package/lib/subagents.mjs +8 -4
  79. package/lib/swarm.mjs +367 -37
  80. package/lib/swarmMemory.mjs +947 -0
  81. package/lib/t3.mjs +43 -13
  82. package/lib/taskCommands.mjs +56 -5
  83. package/lib/taskRuns.mjs +61 -11
  84. package/lib/team.json +17 -15
  85. package/lib/team.mjs +68 -18
  86. package/lib/threadRuns.mjs +3 -1
  87. package/lib/threadView.mjs +51 -14
  88. package/lib/tokenizer.mjs +405 -0
  89. package/lib/ui.mjs +16 -2
  90. package/lib/usageTotals.mjs +148 -0
  91. package/lib/vault.mjs +1144 -0
  92. package/lib/vaultCloud.mjs +117 -0
  93. package/lib/vaultCommands.mjs +201 -0
  94. package/lib/vaultTools.d.ts +12 -0
  95. package/lib/vaultTools.js +42 -0
  96. package/lib/windowAsks.mjs +42 -0
  97. package/lib/workFocus.mjs +59 -0
  98. package/lib/workLinks.mjs +90 -0
  99. package/package.json +9 -4
@@ -2,6 +2,17 @@
2
2
  "version": 1,
3
3
  "inboxVersion": 2,
4
4
  "commands": {
5
+ "board.connector.list": "connectors",
6
+ "board.connector.add": "connectors",
7
+ "board.connector.reconnect": "connectors",
8
+ "board.connector.tools": "connectors",
9
+ "board.connector.grant": "connectors",
10
+ "board.connector.call": "connectors",
11
+ "board.connector.result": "connectors",
12
+ "board.connector.operations": "connectors",
13
+ "board.connector.decide": "connectors",
14
+ "board.connector.revoke": "connectors",
15
+ "board.connector.refresh": "connectors",
5
16
  "board.agents": "task",
6
17
  "board.answer": "task",
7
18
  "board.audio.listen": "tools",
@@ -36,8 +47,11 @@
36
47
  "board.local.events": "watch",
37
48
  "board.media.search": "tools",
38
49
  "board.notices.take": "watch",
50
+ "board.place.op": "place",
39
51
  "board.plan.add": "plans",
52
+ "board.plan.edit": "plans",
40
53
  "board.plan.remove": "plans",
54
+ "board.plan.run": "plans",
41
55
  "board.post": "task",
42
56
  "board.project.answer": "projects",
43
57
  "board.project.create": "projects",
@@ -52,6 +66,9 @@
52
66
  "board.project.propose": "projects",
53
67
  "board.project.read": "projects",
54
68
  "board.project.repos": "projects",
69
+ "board.repo.clone": "repos",
70
+ "board.repo.clone.read": "repos",
71
+ "board.repo.find": "repos",
55
72
  "board.project.setting": "projects",
56
73
  "board.project.share": "projects",
57
74
  "board.project.withdraw": "projects",
@@ -117,6 +134,7 @@
117
134
  "board.swarm.start_run": "swarm",
118
135
  "board.swarm.stop": "swarm",
119
136
  "board.swarm.stop_all": "swarm",
137
+ "board.swarm.use_browser": "swarm",
120
138
  "board.template.check": "plans",
121
139
  "board.template.get": "plans",
122
140
  "board.template.list": "plans",
@@ -146,9 +164,24 @@
146
164
  "sessions.read": "task",
147
165
  "sessions.search": "task",
148
166
  "t3.connect": "task",
167
+ "t3.status": "task",
149
168
  "tasks.status": "task",
150
169
  "voice.status": "task",
151
- "voice.transcribe": "task"
170
+ "voice.transcribe": "task",
171
+ "board.environments.list": "environments",
172
+ "board.environments.control": "environments",
173
+ "board.project.invite": "projects",
174
+ "board.project.remove": "projects",
175
+ "board.project.agents": "projects",
176
+ "board.project.goal": "projects",
177
+ "board.project.retry": "projects",
178
+ "board.swarm.follow": "swarm",
179
+ "board.swarm.seen": "swarm",
180
+ "board.swarm.context": "swarm",
181
+ "board.native.read": "nativeRequests",
182
+ "board.native.decide": "nativeRequests",
183
+ "board.swarm.links": "swarm",
184
+ "board.swarm.link": "swarm"
152
185
  },
153
186
  "families": [
154
187
  {
@@ -170,6 +203,12 @@
170
203
  "board.relay."
171
204
  ]
172
205
  },
206
+ {
207
+ "owner": "place",
208
+ "prefixes": [
209
+ "board.place."
210
+ ]
211
+ },
173
212
  {
174
213
  "owner": "live",
175
214
  "prefixes": [
@@ -206,6 +245,24 @@
206
245
  "prefixes": [
207
246
  "board.project."
208
247
  ]
248
+ },
249
+ {
250
+ "owner": "environments",
251
+ "prefixes": [
252
+ "board.environments."
253
+ ]
254
+ },
255
+ {
256
+ "owner": "nativeRequests",
257
+ "prefixes": [
258
+ "board.native."
259
+ ]
260
+ },
261
+ {
262
+ "owner": "vault",
263
+ "prefixes": [
264
+ "board.vault."
265
+ ]
209
266
  }
210
267
  ],
211
268
  "access": {
@@ -245,6 +302,7 @@
245
302
  "board.swarm.merge",
246
303
  "board.swarm.discard",
247
304
  "board.swarm.start_run",
305
+ "board.swarm.use_browser",
248
306
  "board.swarm.agents",
249
307
  "board.swarm.note",
250
308
  "board.swarm.places",
@@ -253,7 +311,44 @@
253
311
  "board.live",
254
312
  "board.live.read",
255
313
  "board.live.say",
256
- "board.swarm.held"
314
+ "board.swarm.held",
315
+ "board.environments.list",
316
+ "board.environments.control",
317
+ "board.swarm.follow",
318
+ "board.swarm.seen",
319
+ "board.swarm.context",
320
+ "board.native.read",
321
+ "board.native.decide",
322
+ "board.swarm.links",
323
+ "board.swarm.link",
324
+ "board.vault.allow",
325
+ "board.vault.dismiss",
326
+ "board.plan.add",
327
+ "board.plan.edit",
328
+ "board.plan.remove",
329
+ "board.plan.run",
330
+ "board.template.list",
331
+ "board.template.get",
332
+ "board.template.check",
333
+ "board.template.save",
334
+ "board.template.use",
335
+ "board.relay.list",
336
+ "board.relay.network",
337
+ "board.relay.decide",
338
+ "board.relay.request",
339
+ "board.relay.seen",
340
+ "board.place.op",
341
+ "board.connector.list",
342
+ "board.connector.operations",
343
+ "board.connector.grant",
344
+ "board.connector.decide",
345
+ "board.connector.revoke",
346
+ "board.connector.refresh",
347
+ "board.file.add",
348
+ "board.swarm.models",
349
+ "board.project.answer",
350
+ "board.project.share",
351
+ "board.project.held"
257
352
  ],
258
353
  "browserPerson": [
259
354
  "board.list",
@@ -277,6 +372,7 @@
277
372
  "board.room.read",
278
373
  "board.file.get",
279
374
  "board.file.share",
375
+ "board.file.add",
280
376
  "board.swarm.list",
281
377
  "board.swarm.read",
282
378
  "board.swarm.file",
@@ -291,6 +387,7 @@
291
387
  "board.swarm.merge",
292
388
  "board.swarm.discard",
293
389
  "board.swarm.start_run",
390
+ "board.swarm.use_browser",
294
391
  "board.swarm.agents",
295
392
  "board.swarm.note",
296
393
  "board.swarm.places",
@@ -314,7 +411,15 @@
314
411
  "board.swarm.held",
315
412
  "board.project.list",
316
413
  "board.project.repos",
414
+ "board.repo.find",
415
+ "board.repo.clone",
416
+ "board.repo.clone.read",
317
417
  "board.project.create",
418
+ "board.project.retry",
419
+ "board.project.goal",
420
+ "board.project.invite",
421
+ "board.project.remove",
422
+ "board.project.agents",
318
423
  "board.project.join",
319
424
  "board.project.decline",
320
425
  "board.project.read",
@@ -326,13 +431,47 @@
326
431
  "board.project.share",
327
432
  "board.project.held",
328
433
  "board.project.work",
329
- "board.project.leave"
434
+ "board.project.leave",
435
+ "board.connector.list",
436
+ "board.connector.add",
437
+ "board.connector.reconnect",
438
+ "board.connector.tools",
439
+ "board.connector.grant",
440
+ "board.connector.call",
441
+ "board.connector.result",
442
+ "board.connector.operations",
443
+ "board.connector.decide",
444
+ "board.connector.revoke",
445
+ "board.connector.refresh",
446
+ "board.environments.list",
447
+ "board.environments.control",
448
+ "board.swarm.follow",
449
+ "board.swarm.seen",
450
+ "board.swarm.context",
451
+ "board.native.read",
452
+ "board.native.decide",
453
+ "board.swarm.links",
454
+ "board.swarm.link",
455
+ "board.vault.list",
456
+ "board.vault.save",
457
+ "board.vault.remove",
458
+ "board.vault.grant",
459
+ "board.vault.revoke",
460
+ "board.vault.dismiss",
461
+ "board.vault.backup.start",
462
+ "board.vault.backup.sync",
463
+ "board.vault.backup.stop",
464
+ "board.vault.share",
465
+ "board.vault.unshare",
466
+ "board.vault.import",
467
+ "board.vault.allow"
330
468
  ],
331
469
  "harnessBrowser": [
332
470
  "board.list",
333
471
  "board.get",
334
472
  "board.post",
335
473
  "board.claim",
474
+ "board.release",
336
475
  "board.report",
337
476
  "board.answer",
338
477
  "board.thread.read",
@@ -349,7 +488,14 @@
349
488
  "board.agents",
350
489
  "board.swarm.list",
351
490
  "board.swarm.read",
352
- "board.swarm.diff"
491
+ "board.swarm.diff",
492
+ "board.environments.list",
493
+ "board.connector.list",
494
+ "board.connector.tools",
495
+ "board.connector.call",
496
+ "board.connector.result",
497
+ "board.vault.list",
498
+ "board.vault.use"
353
499
  ],
354
500
  "queuedPhone": [
355
501
  "board.post",
@@ -367,7 +513,9 @@
367
513
  "board.swarm.stop",
368
514
  "board.swarm.stop_all",
369
515
  "board.swarm.resume",
370
- "board.swarm.start_run"
516
+ "board.swarm.start_run",
517
+ "board.project.answer",
518
+ "board.swarm.use_browser"
371
519
  ],
372
520
  "browserLane": [
373
521
  "harness.lane.share",
@@ -387,6 +535,7 @@
387
535
  "board.get",
388
536
  "board.post",
389
537
  "board.claim",
538
+ "board.release",
390
539
  "board.report",
391
540
  "board.answer",
392
541
  "board.thread.read",
@@ -409,6 +558,7 @@
409
558
  "board.post",
410
559
  "board.run",
411
560
  "board.release",
561
+ "board.swarm.use_browser",
412
562
  "board.answer",
413
563
  "board.remove",
414
564
  "board.thread.read",
@@ -452,6 +602,7 @@
452
602
  "board.live.read",
453
603
  "board.live.focus",
454
604
  "t3.connect",
605
+ "t3.status",
455
606
  "voice.status",
456
607
  "voice.transcribe",
457
608
  "board.watch.list",
@@ -473,7 +624,9 @@
473
624
  "board.relay.defaults",
474
625
  "board.relay.peers",
475
626
  "board.plan.add",
627
+ "board.plan.edit",
476
628
  "board.plan.remove",
629
+ "board.plan.run",
477
630
  "board.template.check",
478
631
  "board.template.list",
479
632
  "board.template.get",
@@ -481,9 +634,22 @@
481
634
  "board.template.remove",
482
635
  "board.template.use",
483
636
  "board.swarm.held",
637
+ "machines.list",
638
+ "machines.add",
639
+ "swarm.lineup",
640
+ "swarm.add",
641
+ "swarm.remove",
484
642
  "board.project.list",
485
643
  "board.project.repos",
644
+ "board.repo.find",
645
+ "board.repo.clone",
646
+ "board.repo.clone.read",
486
647
  "board.project.create",
648
+ "board.project.retry",
649
+ "board.project.goal",
650
+ "board.project.invite",
651
+ "board.project.remove",
652
+ "board.project.agents",
487
653
  "board.project.join",
488
654
  "board.project.decline",
489
655
  "board.project.read",
@@ -495,7 +661,41 @@
495
661
  "board.project.share",
496
662
  "board.project.held",
497
663
  "board.project.work",
498
- "board.project.leave"
664
+ "board.project.leave",
665
+ "board.place.op",
666
+ "board.connector.list",
667
+ "board.connector.add",
668
+ "board.connector.reconnect",
669
+ "board.connector.tools",
670
+ "board.connector.grant",
671
+ "board.connector.call",
672
+ "board.connector.result",
673
+ "board.connector.operations",
674
+ "board.connector.decide",
675
+ "board.connector.revoke",
676
+ "board.connector.refresh",
677
+ "board.environments.list",
678
+ "board.environments.control",
679
+ "board.swarm.follow",
680
+ "board.swarm.seen",
681
+ "board.swarm.context",
682
+ "board.native.read",
683
+ "board.native.decide",
684
+ "board.swarm.links",
685
+ "board.swarm.link",
686
+ "board.vault.list",
687
+ "board.vault.save",
688
+ "board.vault.remove",
689
+ "board.vault.grant",
690
+ "board.vault.revoke",
691
+ "board.vault.dismiss",
692
+ "board.vault.backup.start",
693
+ "board.vault.backup.sync",
694
+ "board.vault.backup.stop",
695
+ "board.vault.share",
696
+ "board.vault.unshare",
697
+ "board.vault.import",
698
+ "board.vault.allow"
499
699
  ],
500
700
  "plainPerson": [
501
701
  "board.standing.off"
@@ -5,7 +5,6 @@ import { nameOf } from "./members.mjs";
5
5
 
6
6
  export function createBoardTools({
7
7
  MAX_FILE_BYTES,
8
- askHarness,
9
8
  contextEngine,
10
9
  folderOf,
11
10
  inRoom,
@@ -14,7 +13,7 @@ export function createBoardTools({
14
13
  localHit,
15
14
  localReady,
16
15
  ocr,
17
- getPhones,
16
+ askWindows,
18
17
  getServerFeatures,
19
18
  snippets,
20
19
  roomOf,
@@ -168,10 +167,7 @@ export function createBoardTools({
168
167
  : "search_screen_text";
169
168
  return {
170
169
  ok: true,
171
- pending: getPhones().ask(
172
- { tool, input, agent: nameOf(agent) },
173
- (envelopes) => askHarness("sealed_ask", { envelopes }, null)
174
- ),
170
+ pending: askWindows({ tool, input, agent: nameOf(agent) }),
175
171
  };
176
172
  }
177
173
  if (request.command === "board.code.search") {
package/lib/bridge.mjs CHANGED
@@ -6,6 +6,9 @@ import { scrubDeep, restoreDeep } from "./firewall.mjs";
6
6
  const HEARTBEAT_MS = Number(process.env.HARNESS_HEARTBEAT_MS) || 30_000;
7
7
  // A dropped connection dials again after about a second (give or take a fifth), doubling up to 30 s.
8
8
  export const RECONNECT_FIRST_MS = 1_000;
9
+ // How long a request to Harness waits for its answer unless it says otherwise; a request between the person's own
10
+ // computers waits as long on the direct link (directLink.mjs) before it goes through Harness.
11
+ export const ASK_TIMEOUT_MS = 15_000;
9
12
  export const RECONNECT_JITTER = 0.2;
10
13
  // Harness's answer when another computer paired to this account is connected (HELD_ELSEWHERE in
11
14
  // src/server/bridge/bridgeHub.ts): 409 on the dial, or close code 4409 when two dials crossed.
@@ -33,6 +36,9 @@ const SCRUBBED = new Set([
33
36
  "check_work",
34
37
  "react",
35
38
  "reflect",
39
+ // The swarm's memory (swarmMemory.mjs): a post read for what it changes, and the dream.
40
+ "memory_change",
41
+ "dream",
36
42
  "wake",
37
43
  ]);
38
44
  // Requests that only decide (the coordinator's round, a folder pick, a model pick): nothing on Harness's server acts on
@@ -45,6 +51,8 @@ const DECIDE_ONLY = new Set([
45
51
  "check_work",
46
52
  "react",
47
53
  "reflect",
54
+ "memory_change",
55
+ "dream",
48
56
  ]);
49
57
 
50
58
  /** One connection owns request settlement, feature negotiation, outages and reconnects. */
@@ -67,6 +75,8 @@ export function createBridge({
67
75
  const relayWaiters = new Map();
68
76
  const outages = [];
69
77
  let offlineSince = Date.now();
78
+ // Whether this daemon has been on Harness yet: its first connection ends its start, not a time away.
79
+ let connectedBefore = false;
70
80
  // What the board said while the connection was down goes once Harness knows this machine again, so a wake or a
71
81
  // phone notice is not lost to a short outage (October 19: the person's answer to Grok Bot woke no one across a
72
82
  // reconnect). A restart reads the board afresh instead (handoffs.mjs).
@@ -86,7 +96,12 @@ export function createBridge({
86
96
  outbox.push(message);
87
97
  outbox.splice(0, outbox.length - 200);
88
98
  };
89
- const askHarness = (type, input, timeoutMs = 15_000, clear = null) => {
99
+ const askHarness = (
100
+ type,
101
+ input,
102
+ timeoutMs = ASK_TIMEOUT_MS,
103
+ clear = null
104
+ ) => {
90
105
  const { scrubber } = processing();
91
106
  if (!scrubber || !SCRUBBED.has(type))
92
107
  return askBridge(type, { ...input, ...clear }, timeoutMs);
@@ -107,7 +122,7 @@ export function createBridge({
107
122
  })
108
123
  .then((reply) => (vault.size ? restoreDeep(reply, vault) : reply));
109
124
  };
110
- const askBridge = (type, input, timeoutMs = 15_000) =>
125
+ const askBridge = (type, input, timeoutMs = ASK_TIMEOUT_MS) =>
111
126
  new Promise((resolve, reject) => {
112
127
  if (!state.connected) {
113
128
  reject(new Error("the daemon is not connected to Harness"));
@@ -203,8 +218,15 @@ export function createBridge({
203
218
  socket.on("open", () => {
204
219
  retry = RECONNECT_FIRST_MS;
205
220
  awaitingPong = 0;
206
- if (offlineSince)
221
+ if (offlineSince) {
207
222
  outages.push({ start: offlineSince, end: Date.now() });
223
+ // Kept in the log so how long this computer is away can be measured (the stand-in deadline, ownMachines.mjs).
224
+ if (connectedBefore)
225
+ log(
226
+ `back on Harness after ${((Date.now() - offlineSince) / 1000).toFixed(1)} s away`
227
+ );
228
+ }
229
+ connectedBefore = true;
208
230
  outages.splice(0, outages.length - 50);
209
231
  offlineSince = null;
210
232
  state.connected = true;
@@ -0,0 +1,60 @@
1
+ // What this computer hands the person's Harness page in their browser, through the Harness extension's native host
2
+ // (nativeHost.mjs, the extension's computerWake.js): the extension brings the page up, with no Harness tab open, and
3
+ // the page decides what each message means. The host asks with `next` and waits for a message, so one is carried as
4
+ // soon as it is sent; a browser asked recently is one that is listening.
5
+ //
6
+ // Messages wait here in memory only: what they are about is kept on the board, and is sent again from there.
7
+ const MAX_WAITING = 20;
8
+ const LONGEST_WAIT_MS = 25_000;
9
+ // The host asks again at once after each answer; a minute with no ask means no browser is listening.
10
+ const LISTENING_MS = 60_000;
11
+ const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
12
+
13
+ export function createBrowserWake({
14
+ log = () => {},
15
+ now = () => Date.now(),
16
+ // What should reach a browser that starts listening (after this daemon or the browser restarted).
17
+ pending = () => [],
18
+ } = {}) {
19
+ const waiting = [];
20
+ const askers = new Set();
21
+ let askedAt = -Infinity;
22
+
23
+ /** Hands `message` to the Harness page of a listening browser, the next time one asks. */
24
+ function send(message) {
25
+ waiting.push(message);
26
+ if (waiting.length > MAX_WAITING) waiting.shift();
27
+ for (const answer of [...askers]) answer();
28
+ }
29
+
30
+ /** What is waiting, or after up to `waitMs` nothing. */
31
+ function next(waitMs = LONGEST_WAIT_MS) {
32
+ if (!listening())
33
+ for (const message of pending())
34
+ if (!waiting.some((kept) => same(kept, message))) waiting.push(message);
35
+ askedAt = now();
36
+ if (waiting.length) return Promise.resolve(waiting.splice(0));
37
+ const wait = Math.min(Math.max(0, Number(waitMs) || 0), LONGEST_WAIT_MS);
38
+ return new Promise((resolve) => {
39
+ const answer = () => {
40
+ clearTimeout(timer);
41
+ askers.delete(answer);
42
+ askedAt = now();
43
+ resolve(waiting.splice(0));
44
+ };
45
+ const timer = setTimeout(answer, wait);
46
+ askers.add(answer);
47
+ }).then((messages) => {
48
+ if (messages.length)
49
+ log(`browser: handed ${messages.length} to the page`);
50
+ return messages;
51
+ });
52
+ }
53
+
54
+ /** Whether a browser has asked within the last minute. */
55
+ function listening() {
56
+ return askers.size > 0 || now() - askedAt < LISTENING_MS;
57
+ }
58
+
59
+ return { send, next, listening };
60
+ }
package/lib/cards.mjs CHANGED
@@ -1,6 +1,7 @@
1
1
  import { createHash } from "node:crypto";
2
- import { member } from "./members.mjs";
3
- import { describeAgentModel } from "./models.mjs";
2
+ import { member, nameOf } from "./members.mjs";
3
+ import { agentModelInUse, describeAgentModel } from "./models.mjs";
4
+ import { tierOf } from "./modelTiers.mjs";
4
5
  import { oneLine } from "./oneLine.mjs";
5
6
 
6
7
  // Each of the person's agents as the others see it: one card, written the same way for every reader (the block an agent
@@ -31,6 +32,14 @@ export const answersFor = (entry) =>
31
32
  const NOTE_LIMIT = 300;
32
33
  const noteKey = (id) => `agent-note:${id}`;
33
34
  export const noteOf = (store, id) => store.meta(noteKey(id)) || null;
35
+ /** The tier the person set for an agent (top, middle or bottom), or null for the benchmark's. */
36
+ export const tierChoice = (store, id) =>
37
+ store.meta(`tier-choice:${id}`) || null;
38
+ export function setTier(store, id, tier) {
39
+ store.meta(`tier-choice:${id}`, tier ?? "");
40
+ return tier ?? null;
41
+ }
42
+
34
43
  /** The person's own words about one agent ("use it for reviews"); empty clears it. */
35
44
  export function setNote(store, id, text) {
36
45
  const note = String(text || "")
@@ -111,6 +120,13 @@ export function swarmCards(store, entries, { home, lessons = true } = {}) {
111
120
  : entry.id === "harness" && describeAgentModel(store, entry.id, home)
112
121
  ? { model: describeAgentModel(store, entry.id, home) }
113
122
  : {}),
123
+ // How strong its model is, for the roles with a floor (team.json): the person's tier for it, else the benchmark's.
124
+ tier: tierOf({
125
+ ...(roster.runs === "machine" || entry.id === "harness"
126
+ ? agentModelInUse(store, entry.id, home)
127
+ : {}),
128
+ chosen: tierChoice(store, entry.id),
129
+ }),
114
130
  answers: answersFor(entry),
115
131
  record: {
116
132
  done: done.done,
@@ -207,6 +223,23 @@ export function shortCardLine(card) {
207
223
  return `- @${card.id} (${card.name}): ${sentence(card.about)}${unset}`;
208
224
  }
209
225
 
226
+ /**
227
+ * What an agent on one of the person's computers is told of itself, with its swarm: who it is and the computer it runs
228
+ * on, so it names itself and its paths by where it is. `where` is ownMachines.mjs whereIs; null for an agent that runs
229
+ * on no computer of the person's (Harness, Bankr), which is told nothing.
230
+ */
231
+ export function youLine(agent, where) {
232
+ if (!where || member(agent)?.home !== "machine") return "";
233
+ const computer = oneLine(where.computer);
234
+ const you = `You are ${nameOf(agent)} (@${agent}), running on the person's computer ${computer}`;
235
+ if (!where.others.length) return `${you}.`;
236
+ const others = where.others.map((label) => oneLine(label)).join(", ");
237
+ const place = where.home
238
+ ? `${you}, their home computer, which keeps the board; their other computers: ${others}.`
239
+ : `${you}; ${where.homeLabel ? oneLine(where.homeLabel) : "another of their computers"} is home and keeps the board.`;
240
+ return `${place} The files, folders and sessions you see are on ${computer}; say so when you name them in a thread.`;
241
+ }
242
+
210
243
  export const SWARM_HEADER =
211
244
  "Your swarm, the person's other agents. Hand one work with post_task (target_agent) or ask one in a thread with post_to_room (ask).";
212
245
 
package/lib/commands.mjs CHANGED
@@ -1,8 +1,18 @@
1
1
  import fs from "node:fs";
2
2
  import path from "node:path";
3
3
  import { spawnSync } from "node:child_process";
4
+ import { MEMBERS } from "./members.mjs";
5
+ import { runtimeOf } from "./agentRuntimeConfig.mjs";
4
6
 
5
7
  export function resolveCommand(command, env = process.env) {
8
+ if (path.isAbsolute(command)) {
9
+ try {
10
+ fs.accessSync(command, fs.constants.X_OK);
11
+ return fs.statSync(command).isFile() ? command : null;
12
+ } catch {
13
+ return null;
14
+ }
15
+ }
6
16
  const pathValue = env.PATH || "";
7
17
  const extensions =
8
18
  process.platform === "win32"
@@ -54,12 +64,17 @@ export const AGENT_COMMANDS = {
54
64
  codex: "codex",
55
65
  pi: "pi",
56
66
  opencode: "opencode",
67
+ ...Object.fromEntries(
68
+ MEMBERS.filter((entry) => entry.runtime).map((entry) => [
69
+ entry.id,
70
+ entry.runtime.command,
71
+ ])
72
+ ),
57
73
  };
58
74
 
59
75
  export function detectAgents() {
60
- return Object.entries(AGENT_COMMANDS).map(([agent, command]) => ({
61
- agent,
62
- command,
63
- path: resolveCommand(command),
64
- }));
76
+ return Object.entries(AGENT_COMMANDS).map(([agent, defaultCommand]) => {
77
+ const command = runtimeOf(agent)?.command || defaultCommand;
78
+ return { agent, command, path: resolveCommand(command) };
79
+ });
65
80
  }
@@ -0,0 +1,13 @@
1
+ export declare const CONNECTION_TOOL: {
2
+ name: "connection";
3
+ description: string;
4
+ inputSchema: Record<string, unknown>;
5
+ };
6
+ export function connectionRequest(input: Record<string, unknown>): {
7
+ command: string;
8
+ id: string;
9
+ tool?: unknown;
10
+ arguments: unknown;
11
+ requestId?: unknown;
12
+ task?: unknown;
13
+ };