tryharness 0.7.44 → 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 (101) 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 +259 -6
  12. package/lib/boardTools.mjs +2 -6
  13. package/lib/bridge.mjs +27 -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 +16 -2
  25. package/lib/coreModels.mjs +78 -0
  26. package/lib/daemon.mjs +775 -46
  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 +61 -12
  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 +180 -98
  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 +38 -1
  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/projectGit.mjs +328 -0
  64. package/lib/projectSettings.mjs +120 -0
  65. package/lib/projects.mjs +2539 -0
  66. package/lib/readiness.mjs +283 -0
  67. package/lib/repoLinks.mjs +354 -0
  68. package/lib/roomChannels.mjs +641 -0
  69. package/lib/runBrief.mjs +32 -2
  70. package/lib/runRequests.mjs +157 -0
  71. package/lib/runWorker.mjs +20 -7
  72. package/lib/runner.mjs +67 -8
  73. package/lib/secretPatterns.json +55 -0
  74. package/lib/secrets.mjs +10 -27
  75. package/lib/seen.mjs +102 -0
  76. package/lib/service.mjs +11 -6
  77. package/lib/sessionControl.mjs +10 -8
  78. package/lib/sessionIndex.mjs +5 -3
  79. package/lib/store.mjs +559 -30
  80. package/lib/subagents.mjs +8 -4
  81. package/lib/swarm.mjs +379 -38
  82. package/lib/swarmMemory.mjs +947 -0
  83. package/lib/t3.mjs +43 -13
  84. package/lib/taskCommands.mjs +58 -5
  85. package/lib/taskRuns.mjs +61 -11
  86. package/lib/team.json +17 -15
  87. package/lib/team.mjs +68 -18
  88. package/lib/threadRuns.mjs +50 -7
  89. package/lib/threadView.mjs +68 -15
  90. package/lib/tokenizer.mjs +405 -0
  91. package/lib/ui.mjs +16 -2
  92. package/lib/usageTotals.mjs +148 -0
  93. package/lib/vault.mjs +1144 -0
  94. package/lib/vaultCloud.mjs +117 -0
  95. package/lib/vaultCommands.mjs +201 -0
  96. package/lib/vaultTools.d.ts +12 -0
  97. package/lib/vaultTools.js +42 -0
  98. package/lib/windowAsks.mjs +42 -0
  99. package/lib/workFocus.mjs +59 -0
  100. package/lib/workLinks.mjs +90 -0
  101. 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,9 +47,32 @@
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",
56
+ "board.project.answer": "projects",
57
+ "board.project.create": "projects",
58
+ "board.project.decide": "projects",
59
+ "board.project.decline": "projects",
60
+ "board.project.held": "projects",
61
+ "board.project.join": "projects",
62
+ "board.project.leave": "projects",
63
+ "board.project.list": "projects",
64
+ "board.project.note": "projects",
65
+ "board.project.plan": "projects",
66
+ "board.project.propose": "projects",
67
+ "board.project.read": "projects",
68
+ "board.project.repos": "projects",
69
+ "board.repo.clone": "repos",
70
+ "board.repo.clone.read": "repos",
71
+ "board.repo.find": "repos",
72
+ "board.project.setting": "projects",
73
+ "board.project.share": "projects",
74
+ "board.project.withdraw": "projects",
75
+ "board.project.work": "projects",
42
76
  "board.prompted": "prompt",
43
77
  "board.relay.decide": "relay",
44
78
  "board.relay.defaults": "relay",
@@ -100,6 +134,7 @@
100
134
  "board.swarm.start_run": "swarm",
101
135
  "board.swarm.stop": "swarm",
102
136
  "board.swarm.stop_all": "swarm",
137
+ "board.swarm.use_browser": "swarm",
103
138
  "board.template.check": "plans",
104
139
  "board.template.get": "plans",
105
140
  "board.template.list": "plans",
@@ -129,9 +164,24 @@
129
164
  "sessions.read": "task",
130
165
  "sessions.search": "task",
131
166
  "t3.connect": "task",
167
+ "t3.status": "task",
132
168
  "tasks.status": "task",
133
169
  "voice.status": "task",
134
- "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"
135
185
  },
136
186
  "families": [
137
187
  {
@@ -153,6 +203,12 @@
153
203
  "board.relay."
154
204
  ]
155
205
  },
206
+ {
207
+ "owner": "place",
208
+ "prefixes": [
209
+ "board.place."
210
+ ]
211
+ },
156
212
  {
157
213
  "owner": "live",
158
214
  "prefixes": [
@@ -183,6 +239,30 @@
183
239
  "board.plan.",
184
240
  "board.template."
185
241
  ]
242
+ },
243
+ {
244
+ "owner": "projects",
245
+ "prefixes": [
246
+ "board.project."
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
+ ]
186
266
  }
187
267
  ],
188
268
  "access": {
@@ -222,6 +302,7 @@
222
302
  "board.swarm.merge",
223
303
  "board.swarm.discard",
224
304
  "board.swarm.start_run",
305
+ "board.swarm.use_browser",
225
306
  "board.swarm.agents",
226
307
  "board.swarm.note",
227
308
  "board.swarm.places",
@@ -230,7 +311,44 @@
230
311
  "board.live",
231
312
  "board.live.read",
232
313
  "board.live.say",
233
- "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"
234
352
  ],
235
353
  "browserPerson": [
236
354
  "board.list",
@@ -254,6 +372,7 @@
254
372
  "board.room.read",
255
373
  "board.file.get",
256
374
  "board.file.share",
375
+ "board.file.add",
257
376
  "board.swarm.list",
258
377
  "board.swarm.read",
259
378
  "board.swarm.file",
@@ -268,6 +387,7 @@
268
387
  "board.swarm.merge",
269
388
  "board.swarm.discard",
270
389
  "board.swarm.start_run",
390
+ "board.swarm.use_browser",
271
391
  "board.swarm.agents",
272
392
  "board.swarm.note",
273
393
  "board.swarm.places",
@@ -288,13 +408,70 @@
288
408
  "board.relay.seen",
289
409
  "board.relay.defaults",
290
410
  "board.relay.peers",
291
- "board.swarm.held"
411
+ "board.swarm.held",
412
+ "board.project.list",
413
+ "board.project.repos",
414
+ "board.repo.find",
415
+ "board.repo.clone",
416
+ "board.repo.clone.read",
417
+ "board.project.create",
418
+ "board.project.retry",
419
+ "board.project.goal",
420
+ "board.project.invite",
421
+ "board.project.remove",
422
+ "board.project.agents",
423
+ "board.project.join",
424
+ "board.project.decline",
425
+ "board.project.read",
426
+ "board.project.answer",
427
+ "board.project.withdraw",
428
+ "board.project.setting",
429
+ "board.project.decide",
430
+ "board.project.note",
431
+ "board.project.share",
432
+ "board.project.held",
433
+ "board.project.work",
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"
292
468
  ],
293
469
  "harnessBrowser": [
294
470
  "board.list",
295
471
  "board.get",
296
472
  "board.post",
297
473
  "board.claim",
474
+ "board.release",
298
475
  "board.report",
299
476
  "board.answer",
300
477
  "board.thread.read",
@@ -311,7 +488,14 @@
311
488
  "board.agents",
312
489
  "board.swarm.list",
313
490
  "board.swarm.read",
314
- "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"
315
499
  ],
316
500
  "queuedPhone": [
317
501
  "board.post",
@@ -329,7 +513,9 @@
329
513
  "board.swarm.stop",
330
514
  "board.swarm.stop_all",
331
515
  "board.swarm.resume",
332
- "board.swarm.start_run"
516
+ "board.swarm.start_run",
517
+ "board.project.answer",
518
+ "board.swarm.use_browser"
333
519
  ],
334
520
  "browserLane": [
335
521
  "harness.lane.share",
@@ -349,6 +535,7 @@
349
535
  "board.get",
350
536
  "board.post",
351
537
  "board.claim",
538
+ "board.release",
352
539
  "board.report",
353
540
  "board.answer",
354
541
  "board.thread.read",
@@ -371,6 +558,7 @@
371
558
  "board.post",
372
559
  "board.run",
373
560
  "board.release",
561
+ "board.swarm.use_browser",
374
562
  "board.answer",
375
563
  "board.remove",
376
564
  "board.thread.read",
@@ -414,6 +602,7 @@
414
602
  "board.live.read",
415
603
  "board.live.focus",
416
604
  "t3.connect",
605
+ "t3.status",
417
606
  "voice.status",
418
607
  "voice.transcribe",
419
608
  "board.watch.list",
@@ -435,14 +624,78 @@
435
624
  "board.relay.defaults",
436
625
  "board.relay.peers",
437
626
  "board.plan.add",
627
+ "board.plan.edit",
438
628
  "board.plan.remove",
629
+ "board.plan.run",
439
630
  "board.template.check",
440
631
  "board.template.list",
441
632
  "board.template.get",
442
633
  "board.template.save",
443
634
  "board.template.remove",
444
635
  "board.template.use",
445
- "board.swarm.held"
636
+ "board.swarm.held",
637
+ "machines.list",
638
+ "machines.add",
639
+ "swarm.lineup",
640
+ "swarm.add",
641
+ "swarm.remove",
642
+ "board.project.list",
643
+ "board.project.repos",
644
+ "board.repo.find",
645
+ "board.repo.clone",
646
+ "board.repo.clone.read",
647
+ "board.project.create",
648
+ "board.project.retry",
649
+ "board.project.goal",
650
+ "board.project.invite",
651
+ "board.project.remove",
652
+ "board.project.agents",
653
+ "board.project.join",
654
+ "board.project.decline",
655
+ "board.project.read",
656
+ "board.project.answer",
657
+ "board.project.withdraw",
658
+ "board.project.setting",
659
+ "board.project.decide",
660
+ "board.project.note",
661
+ "board.project.share",
662
+ "board.project.held",
663
+ "board.project.work",
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"
446
699
  ],
447
700
  "plainPerson": [
448
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.
@@ -30,8 +33,12 @@ const SCRUBBED = new Set([
30
33
  "coordinate",
31
34
  "pick_folder",
32
35
  "route_model",
36
+ "check_work",
33
37
  "react",
34
38
  "reflect",
39
+ // The swarm's memory (swarmMemory.mjs): a post read for what it changes, and the dream.
40
+ "memory_change",
41
+ "dream",
35
42
  "wake",
36
43
  ]);
37
44
  // Requests that only decide (the coordinator's round, a folder pick, a model pick): nothing on Harness's server acts on
@@ -41,8 +48,11 @@ const DECIDE_ONLY = new Set([
41
48
  "coordinate",
42
49
  "pick_folder",
43
50
  "route_model",
51
+ "check_work",
44
52
  "react",
45
53
  "reflect",
54
+ "memory_change",
55
+ "dream",
46
56
  ]);
47
57
 
48
58
  /** One connection owns request settlement, feature negotiation, outages and reconnects. */
@@ -65,6 +75,8 @@ export function createBridge({
65
75
  const relayWaiters = new Map();
66
76
  const outages = [];
67
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;
68
80
  // What the board said while the connection was down goes once Harness knows this machine again, so a wake or a
69
81
  // phone notice is not lost to a short outage (October 19: the person's answer to Grok Bot woke no one across a
70
82
  // reconnect). A restart reads the board afresh instead (handoffs.mjs).
@@ -84,7 +96,12 @@ export function createBridge({
84
96
  outbox.push(message);
85
97
  outbox.splice(0, outbox.length - 200);
86
98
  };
87
- 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
+ ) => {
88
105
  const { scrubber } = processing();
89
106
  if (!scrubber || !SCRUBBED.has(type))
90
107
  return askBridge(type, { ...input, ...clear }, timeoutMs);
@@ -105,7 +122,7 @@ export function createBridge({
105
122
  })
106
123
  .then((reply) => (vault.size ? restoreDeep(reply, vault) : reply));
107
124
  };
108
- const askBridge = (type, input, timeoutMs = 15_000) =>
125
+ const askBridge = (type, input, timeoutMs = ASK_TIMEOUT_MS) =>
109
126
  new Promise((resolve, reject) => {
110
127
  if (!state.connected) {
111
128
  reject(new Error("the daemon is not connected to Harness"));
@@ -201,8 +218,15 @@ export function createBridge({
201
218
  socket.on("open", () => {
202
219
  retry = RECONNECT_FIRST_MS;
203
220
  awaitingPong = 0;
204
- if (offlineSince)
221
+ if (offlineSince) {
205
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;
206
230
  outages.splice(0, outages.length - 50);
207
231
  offlineSince = null;
208
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
+ };