tryharness 0.7.82 → 0.7.86

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 (216) hide show
  1. package/README.md +21 -19
  2. package/assets/dsh-plugin.mjs +75 -4
  3. package/assets/herdr-mod/harness/main.js +367 -0
  4. package/assets/herdr-mod/harness/mod.json +6 -0
  5. package/assets/opencode-plugin.js +87 -22
  6. package/assets/pi-extension.ts +81 -2
  7. package/cli.mjs +544 -208
  8. package/lib/adapters.mjs +62 -27
  9. package/lib/agentBinaries.mjs +6 -8
  10. package/lib/agentClaims.mjs +168 -0
  11. package/lib/agentReadTools.json +415 -0
  12. package/lib/agentSignIn.mjs +17 -18
  13. package/lib/agentWiring.mjs +114 -0
  14. package/lib/archetypes.js +10 -11
  15. package/lib/attention.mjs +100 -0
  16. package/lib/audit.mjs +1 -1
  17. package/lib/backupSetup.mjs +6 -28
  18. package/lib/bankrApprovals.mjs +86 -0
  19. package/lib/boardAccess.mjs +40 -66
  20. package/lib/boardBackup.mjs +86 -85
  21. package/lib/boardCommands.mjs +28 -0
  22. package/lib/boardFileCommands.mjs +29 -36
  23. package/lib/boardFiles.mjs +83 -15
  24. package/lib/boardMirror.mjs +78 -11
  25. package/lib/boardProtocol.json +193 -123
  26. package/lib/boardThreads.mjs +19 -37
  27. package/lib/boardTools.mjs +22 -15
  28. package/lib/boardWatches.mjs +43 -15
  29. package/lib/bridge.mjs +7 -3
  30. package/lib/browserAgentTools.mjs +59 -0
  31. package/lib/browserWake.mjs +0 -6
  32. package/lib/cards.mjs +57 -2
  33. package/lib/circling.mjs +189 -0
  34. package/lib/cleanup.mjs +234 -0
  35. package/lib/cloudBoot.mjs +21 -4
  36. package/lib/cloudSave.mjs +46 -5
  37. package/lib/compaction.mjs +8 -1
  38. package/lib/completion.mjs +358 -0
  39. package/lib/computerDevices.mjs +853 -0
  40. package/lib/connectionStatus.mjs +34 -0
  41. package/lib/connectors.mjs +139 -1
  42. package/lib/coordinator.mjs +108 -14
  43. package/lib/coreModels.mjs +36 -12
  44. package/lib/daemon.mjs +2435 -333
  45. package/lib/daemonLock.mjs +103 -0
  46. package/lib/deviceDoor.mjs +308 -0
  47. package/lib/deviceIdentity.mjs +114 -0
  48. package/lib/deviceList.mjs +172 -0
  49. package/lib/deviceSeal.mjs +74 -0
  50. package/lib/dispatcher.mjs +497 -26
  51. package/lib/dispatches.mjs +3 -3
  52. package/lib/environment.mjs +2 -1
  53. package/lib/environments.mjs +67 -41
  54. package/lib/events.mjs +318 -0
  55. package/lib/facts.mjs +170 -0
  56. package/lib/fileSource.mjs +540 -0
  57. package/lib/files.mjs +47 -2
  58. package/lib/gitHost.mjs +39 -1
  59. package/lib/goalCommands.mjs +12 -80
  60. package/lib/handover.mjs +21 -16
  61. package/lib/harnessOffers.mjs +140 -15
  62. package/lib/herdr.mjs +100 -15
  63. package/lib/herdrAppCall.mjs +19 -0
  64. package/lib/herdrCore.mjs +59 -0
  65. package/lib/herdrRuns.mjs +1126 -0
  66. package/lib/hookDialects.mjs +235 -50
  67. package/lib/identityLink.mjs +81 -0
  68. package/lib/inference.mjs +31 -2
  69. package/lib/jamAccess.mjs +82 -0
  70. package/lib/{projectBoard.mjs → jamBoard.mjs} +5 -4
  71. package/lib/{projectGit.mjs → jamGit.mjs} +53 -15
  72. package/lib/jamKey.mjs +274 -0
  73. package/lib/{projectPieces.mjs → jamPieces.mjs} +35 -29
  74. package/lib/{projectSettings.mjs → jamSettings.mjs} +12 -22
  75. package/lib/jamStore.mjs +973 -0
  76. package/lib/jamUpgrade.mjs +112 -0
  77. package/lib/jams.mjs +3079 -0
  78. package/lib/kanban.mjs +13 -7
  79. package/lib/landed.mjs +5 -1
  80. package/lib/library.mjs +41 -22
  81. package/lib/limits.mjs +91 -0
  82. package/lib/lineDiff.mjs +97 -0
  83. package/lib/lineup.mjs +18 -13
  84. package/lib/link.mjs +584 -0
  85. package/lib/localStack.mjs +75 -16
  86. package/lib/localmodels.mjs +58 -78
  87. package/lib/loopBackstop.mjs +2 -1
  88. package/lib/machine.mjs +544 -0
  89. package/lib/machineLink.mjs +446 -0
  90. package/lib/machineRoutes.mjs +68 -19
  91. package/lib/machineRuns.mjs +85 -4
  92. package/lib/machineSeal.mjs +6 -31
  93. package/lib/manager.mjs +134 -12
  94. package/lib/mcp-stdio.mjs +492 -215
  95. package/lib/mcpRelay.mjs +34 -35
  96. package/lib/members.json +2 -2
  97. package/lib/modelRoute.mjs +162 -0
  98. package/lib/nativeHost.mjs +81 -90
  99. package/lib/nativeSenses.mjs +258 -0
  100. package/lib/nerves.mjs +523 -0
  101. package/lib/network.mjs +117 -278
  102. package/lib/networkPlaces.mjs +578 -0
  103. package/lib/nextStep.mjs +95 -0
  104. package/lib/notify.mjs +2 -2
  105. package/lib/nudge.mjs +116 -10
  106. package/lib/onboard.mjs +6 -6
  107. package/lib/originals.mjs +216 -0
  108. package/lib/outsideEvents.mjs +383 -0
  109. package/lib/outsideRuns.mjs +230 -0
  110. package/lib/ownMachines.mjs +674 -256
  111. package/lib/pain.mjs +215 -0
  112. package/lib/pairing.mjs +91 -11
  113. package/lib/paths.mjs +42 -3
  114. package/lib/peerProcess.mjs +21 -7
  115. package/lib/peopleLink.mjs +268 -0
  116. package/lib/personNotices.mjs +3 -2
  117. package/lib/phones.mjs +252 -542
  118. package/lib/placeCards.mjs +282 -0
  119. package/lib/placeChecks.mjs +95 -0
  120. package/lib/placeCommands.mjs +8 -17
  121. package/lib/placeRequests.mjs +152 -0
  122. package/lib/placeStore.mjs +295 -0
  123. package/lib/placeTool.d.ts +12 -0
  124. package/lib/placeTool.js +40 -0
  125. package/lib/places.mjs +63 -14
  126. package/lib/plans.mjs +53 -8
  127. package/lib/presence.mjs +270 -0
  128. package/lib/privateNetwork.d.ts +2 -0
  129. package/lib/privateNetwork.js +93 -0
  130. package/lib/proposals.mjs +300 -0
  131. package/lib/publicFetch.d.ts +32 -0
  132. package/lib/publicFetch.js +248 -0
  133. package/lib/reach.mjs +128 -0
  134. package/lib/rebuildable.mjs +72 -0
  135. package/lib/recall.mjs +216 -0
  136. package/lib/record.mjs +13 -0
  137. package/lib/reflexes.mjs +392 -0
  138. package/lib/relayLimits.mjs +31 -2
  139. package/lib/releaseNotice.mjs +198 -0
  140. package/lib/removeHarness.mjs +15 -4
  141. package/lib/repoLinks.mjs +204 -35
  142. package/lib/runAuthority.mjs +102 -39
  143. package/lib/runBrief.mjs +93 -40
  144. package/lib/runRequests.mjs +52 -14
  145. package/lib/runUsage.mjs +31 -0
  146. package/lib/runWorker.mjs +74 -25
  147. package/lib/runner.mjs +289 -45
  148. package/lib/runtime-install.mjs +37 -8
  149. package/lib/schedules.mjs +171 -47
  150. package/lib/screenWatches.mjs +221 -0
  151. package/lib/sealed.mjs +12 -30
  152. package/lib/sealedThreads.mjs +198 -392
  153. package/lib/secretStore.mjs +178 -0
  154. package/lib/secrets.mjs +11 -0
  155. package/lib/seen.mjs +3 -9
  156. package/lib/selfUpdate.mjs +51 -15
  157. package/lib/senseCall.mjs +1514 -0
  158. package/lib/senseHook.mjs +114 -0
  159. package/lib/senseTools.mjs +1298 -0
  160. package/lib/sessionBriefs.mjs +87 -0
  161. package/lib/sessionControl.mjs +63 -13
  162. package/lib/sessionFiles.mjs +85 -0
  163. package/lib/setupChoices.mjs +12 -3
  164. package/lib/setupMode.mjs +70 -25
  165. package/lib/sharedKeys.mjs +166 -0
  166. package/lib/sleep.mjs +396 -0
  167. package/lib/sources.mjs +306 -0
  168. package/lib/speech.mjs +166 -411
  169. package/lib/spoken.mjs +210 -0
  170. package/lib/steerHook.mjs +3 -1
  171. package/lib/steerQueue.mjs +40 -11
  172. package/lib/store.mjs +323 -130
  173. package/lib/stuck.mjs +85 -7
  174. package/lib/swarm.mjs +157 -49
  175. package/lib/swarmDevices.mjs +25 -85
  176. package/lib/swarmMemory.mjs +93 -9
  177. package/lib/t3.mjs +73 -3
  178. package/lib/taskCommands.mjs +51 -60
  179. package/lib/taskRooms.mjs +30 -4
  180. package/lib/taskRules.json +29 -0
  181. package/lib/taskRules.mjs +21 -0
  182. package/lib/taskRuns.mjs +74 -11
  183. package/lib/team.mjs +2 -1
  184. package/lib/threadActions.mjs +37 -9
  185. package/lib/threadAuthority.mjs +4 -4
  186. package/lib/threadBriefs.mjs +173 -43
  187. package/lib/threadNotes.mjs +320 -0
  188. package/lib/threadRecord.mjs +491 -0
  189. package/lib/threadRuns.mjs +216 -108
  190. package/lib/threadView.mjs +27 -30
  191. package/lib/threadWatches.mjs +1962 -0
  192. package/lib/timeSense.mjs +839 -0
  193. package/lib/tripwires.mjs +454 -0
  194. package/lib/ui.mjs +1 -1
  195. package/lib/vault.mjs +560 -45
  196. package/lib/vaultCommands.mjs +5 -3
  197. package/lib/vaultPeers.mjs +165 -0
  198. package/lib/vaultTools.d.ts +4 -1
  199. package/lib/vaultTools.js +22 -1
  200. package/lib/verdicts.mjs +12 -26
  201. package/lib/versions.mjs +117 -0
  202. package/lib/waitTool.mjs +278 -0
  203. package/lib/wakePicture.mjs +268 -0
  204. package/lib/wakeQueue.mjs +108 -0
  205. package/lib/watchResponses.mjs +533 -0
  206. package/lib/watches.mjs +290 -145
  207. package/lib/windowAsks.mjs +80 -17
  208. package/lib/worktrees.mjs +159 -9
  209. package/npm-shrinkwrap.json +138 -631
  210. package/package.json +7 -6
  211. package/release.json +212 -130
  212. package/lib/callSessions.mjs +0 -51
  213. package/lib/directLink.mjs +0 -349
  214. package/lib/peopleBoard.mjs +0 -131
  215. package/lib/projects.mjs +0 -2917
  216. package/lib/roomChannels.mjs +0 -667
@@ -1,667 +0,0 @@
1
- import { createHash, randomUUID } from "node:crypto";
2
-
3
- // Membership and authenticated delivery for a shared room. Each pair uses the
4
- // existing sealed relay; a participant's computer receives their words directly
5
- // from them. The creator administers membership, but is not a message router.
6
- // Projects supply the shared record and repository behaviour over this seam.
7
- const HANDLE = /^[a-z0-9][a-z0-9-]{2,19}$/;
8
- const UUID = /^[0-9a-f-]{36}$/;
9
- const STATES = new Set(["invited", "joined", "left", "removed"]);
10
- const AGENT = /^[a-z0-9][a-z0-9._-]{0,63}$/;
11
- const parse = (text) => JSON.parse(text);
12
- export const agreementHash = (body) =>
13
- createHash("sha256").update(JSON.stringify(body)).digest("hex");
14
- const consentHashes = (value) =>
15
- Object.fromEntries(
16
- Object.entries(value && typeof value === "object" ? value : {}).filter(
17
- ([id, hash]) =>
18
- UUID.test(id) && typeof hash === "string" && /^[0-9a-f]{64}$/.test(hash)
19
- )
20
- );
21
-
22
- export function createRoomChannels({
23
- store,
24
- request,
25
- decide,
26
- invites,
27
- sentInvites = async () => [],
28
- send,
29
- end,
30
- ownAgents,
31
- details = () => ({}),
32
- onOpen,
33
- onChange,
34
- onEvent,
35
- log = () => {},
36
- }) {
37
- const db = store.db;
38
- db.exec(`
39
- create table if not exists shared_rooms (
40
- id text primary key, record text not null
41
- );
42
- create table if not exists shared_room_channels (
43
- id text primary key, room_id text not null, peer text not null,
44
- state text not null, unique(room_id, peer)
45
- );
46
- `);
47
- const all = (sql, ...values) =>
48
- db.all(sql, values.length ? values : undefined);
49
- const run = (sql, ...values) =>
50
- db.run(sql, values.length ? values : undefined);
51
- const read = (id) => {
52
- const row = all(
53
- "select record from shared_rooms where id = ?",
54
- String(id)
55
- )[0];
56
- return row ? parse(row.record) : null;
57
- };
58
- const rooms = () =>
59
- all("select record from shared_rooms").map((row) => parse(row.record));
60
- const channel = (id) =>
61
- all("select * from shared_room_channels where id = ?", String(id))[0] ??
62
- null;
63
- const routes = (id) =>
64
- all("select * from shared_room_channels where room_id = ?", String(id));
65
- const active = (room) =>
66
- room.members.filter((member) => member.status === "joined");
67
- const own = (room) =>
68
- room.members.find((member) => member.handle === room.me);
69
- const joined = (room) => own(room)?.status === "joined";
70
- const write = (room) => {
71
- run(
72
- "insert into shared_rooms(id, record) values(?, ?) on conflict(id) do update set record = excluded.record",
73
- room.id,
74
- JSON.stringify(room)
75
- );
76
- return room;
77
- };
78
- const forget = (route) => {
79
- store.meta(`shared-room-channel:${route.id}`, route.room_id);
80
- run("delete from shared_room_channels where id = ?", route.id);
81
- };
82
- const save = (room, update) => write({ ...read(room.id), ...update });
83
- const bind = (id, roomId, peer, state = "joining") =>
84
- run(
85
- "insert into shared_room_channels(id, room_id, peer, state) values(?, ?, ?, ?) on conflict(room_id, peer) do update set id = excluded.id, state = excluded.state",
86
- id,
87
- roomId,
88
- peer,
89
- state
90
- );
91
- const members = (id) => read(id)?.members ?? [];
92
- const recipients = (id) => {
93
- const room = read(id);
94
- if (!room || !joined(room)) return [];
95
- const permitted = new Set(active(room).map((member) => member.handle));
96
- return routes(id).filter(
97
- (route) => route.state === "open" && permitted.has(route.peer)
98
- );
99
- };
100
- const snapshot = (room) => ({
101
- type: "membership",
102
- owner: room.owner,
103
- revision: room.revision,
104
- members: room.members,
105
- });
106
- const publish = (room, peers = null) => send(room.id, snapshot(room), peers);
107
- const notify = (before, after) => onChange?.(after.id, before, after);
108
- const checkedMembers = (value) => {
109
- if (!Array.isArray(value) || !value.length)
110
- throw new Error("The room has no membership list.");
111
- const seen = new Set();
112
- return value.map((member) => {
113
- if (
114
- !member ||
115
- !HANDLE.test(member.handle) ||
116
- !STATES.has(member.status) ||
117
- seen.has(member.handle)
118
- )
119
- throw new Error("The room's membership list is invalid.");
120
- seen.add(member.handle);
121
- return {
122
- handle: member.handle,
123
- status: member.status,
124
- generation:
125
- Number.isSafeInteger(member.generation) && member.generation > 0
126
- ? member.generation
127
- : 1,
128
- };
129
- });
130
- };
131
- const knownAgents = (agents) => [
132
- ...new Set(
133
- (Array.isArray(agents) ? agents : []).filter(
134
- (id) => typeof id === "string" && AGENT.test(id)
135
- )
136
- ),
137
- ];
138
- const peersFor = (id) => {
139
- const room = read(id);
140
- return room
141
- ? active(room)
142
- .filter((member) => member.handle !== room.me)
143
- .map((member) => member.handle)
144
- : [];
145
- };
146
-
147
- const init = ({ id = randomUUID(), me, title, repo, settings, agents }) => {
148
- if (
149
- agents &&
150
- (!Array.isArray(agents) ||
151
- agents.some((agent) => !ownAgents().includes(agent)))
152
- )
153
- throw new Error("Choose agents available on this computer.");
154
- const room = {
155
- id,
156
- me,
157
- owner: me,
158
- title,
159
- repo,
160
- settings,
161
- revision: 1,
162
- history: "shared",
163
- agents: knownAgents(agents ?? ownAgents()),
164
- members: [{ handle: me, status: "joined", generation: 1 }],
165
- rosters: {},
166
- consents: {},
167
- errors: {},
168
- };
169
- return write(room);
170
- };
171
- const offer = (room, to, purpose = "invite") => ({
172
- v: 2,
173
- id: room.id,
174
- owner: room.owner,
175
- revision: room.revision,
176
- title: room.title,
177
- from: room.me,
178
- to,
179
- purpose,
180
- repo: room.repo,
181
- settings: room.settings,
182
- history: room.history,
183
- members: room.members,
184
- agents: room.agents,
185
- ...details(room.id),
186
- });
187
- const sending = new Set();
188
- const connect = async (id, peer, purpose) => {
189
- const key = `${id}:${peer}`;
190
- if (sending.has(key)) return;
191
- sending.add(key);
192
- try {
193
- const room = read(id);
194
- const sent = await request({
195
- to: `${peer}/person`,
196
- fromAgent: "person",
197
- about: `Room: ${room.title}`,
198
- brief: `${room.me} invited you to a shared room in Harness.`,
199
- refs: [],
200
- project: offer(room, peer, purpose),
201
- });
202
- if (!sent.sealed)
203
- throw new Error("Shared rooms need an encrypted connection.");
204
- bind(String(sent.threadId), id, peer, "invited");
205
- // Acceptance can reach the daemon before the request call returns. The
206
- // existing local thread proves it opened even if its callback ran early.
207
- if (store.getThread(String(sent.threadId))) opened(String(sent.threadId));
208
- const fresh = read(id);
209
- save(fresh, { errors: { ...fresh.errors, [peer]: null } });
210
- } catch (error) {
211
- const room = read(id);
212
- save(room, { errors: { ...room.errors, [peer]: error.message } });
213
- log(`room ${id}, ${peer}: ${error.message}`);
214
- throw error;
215
- } finally {
216
- sending.delete(key);
217
- }
218
- };
219
- const invite = async (id, handles) => {
220
- let room = read(id);
221
- if (!room || !joined(room) || room.owner !== room.me)
222
- throw new Error("Only the room's creator can invite people.");
223
- const chosen = [
224
- ...new Set(
225
- handles.map((handle) =>
226
- String(handle).trim().toLowerCase().replace(/^@/, "")
227
- )
228
- ),
229
- ];
230
- if (!chosen.length || chosen.some((handle) => !HANDLE.test(handle)))
231
- throw new Error("Write each person's swarm name, separated by commas.");
232
- if (chosen.includes(room.me))
233
- throw new Error("That's your own swarm's name.");
234
- if (
235
- chosen.some((handle) =>
236
- room.members.some(
237
- (member) =>
238
- member.handle === handle &&
239
- ["invited", "joined"].includes(member.status)
240
- )
241
- )
242
- )
243
- throw new Error("That person is already in this room or invited.");
244
- const before = room;
245
- const nextMembers = room.members.filter(
246
- (member) => !chosen.includes(member.handle)
247
- );
248
- for (const handle of chosen) {
249
- const previous = room.members.find((member) => member.handle === handle);
250
- nextMembers.push({
251
- handle,
252
- status: "invited",
253
- generation: (previous?.generation ?? 0) + 1,
254
- });
255
- for (const route of routes(id).filter((entry) => entry.peer === handle)) {
256
- end(route.id, "A new room invitation replaces this participation.");
257
- forget(route);
258
- }
259
- }
260
- room = save(room, {
261
- revision: room.revision + 1,
262
- members: nextMembers,
263
- });
264
- publish(room);
265
- notify(before, room);
266
- // Each result is retained. A failed invitation never repeats automatically.
267
- for (const handle of chosen)
268
- await connect(id, handle, "invite").catch(() => undefined);
269
- return read(id);
270
- };
271
- const validateInvite = (invitation, me) => {
272
- const incoming = invitation.project;
273
- if (
274
- incoming?.v !== 2 ||
275
- !UUID.test(incoming.id) ||
276
- incoming.to !== me ||
277
- incoming.from !== invitation.sender ||
278
- !HANDLE.test(incoming.owner) ||
279
- !Number.isSafeInteger(incoming.revision) ||
280
- incoming.revision < 1 ||
281
- incoming.history !== "shared"
282
- )
283
- throw new Error(
284
- "The room invitation does not match its sender or recipient."
285
- );
286
- const listed = checkedMembers(incoming.members);
287
- if (
288
- !listed.some((member) => member.handle === me) ||
289
- !listed.some(
290
- (member) =>
291
- member.handle === incoming.owner && member.status === "joined"
292
- )
293
- )
294
- throw new Error("The invitation has no active room owner or recipient.");
295
- return { ...incoming, members: listed };
296
- };
297
- const join = (invitation, me, agents) => {
298
- const incoming = validateInvite(invitation, me);
299
- if (incoming.purpose !== "invite" || incoming.from !== incoming.owner)
300
- throw new Error("Join a room through its creator's invitation.");
301
- if (read(incoming.id) && joined(read(incoming.id)))
302
- throw new Error("This computer already has that room.");
303
- if (
304
- agents &&
305
- (!Array.isArray(agents) ||
306
- agents.some((agent) => !ownAgents().includes(agent)))
307
- )
308
- throw new Error("Choose agents available on this computer.");
309
- for (const route of routes(incoming.id)) forget(route);
310
- const room = write({
311
- ...incoming,
312
- me,
313
- agents: knownAgents(agents ?? ownAgents()),
314
- rosters: {},
315
- consents: {
316
- [me]: Object.fromEntries(
317
- (incoming.agreements ?? []).map((entry) => [
318
- entry.id,
319
- agreementHash(entry.body),
320
- ])
321
- ),
322
- },
323
- errors: {},
324
- members: incoming.members.map((member) =>
325
- member.handle === me ? { ...member, status: "joined" } : member
326
- ),
327
- });
328
- bind(invitation.id, room.id, incoming.from);
329
- return room;
330
- };
331
- const setAgents = (id, agents) => {
332
- const room = read(id);
333
- if (!room || !joined(room)) throw new Error("You are not in this room.");
334
- const chosen = knownAgents(agents);
335
- if (chosen.some((agent) => !ownAgents().includes(agent)))
336
- throw new Error("Choose agents available on this computer.");
337
- return save(room, { agents: chosen });
338
- };
339
- const opened = (channelId) => {
340
- const route = channel(channelId);
341
- if (!route) return false;
342
- if (route.state === "open") return true;
343
- run(
344
- "update shared_room_channels set state = 'open' where id = ?",
345
- channelId
346
- );
347
- let room = read(route.room_id);
348
- if (!joined(room)) {
349
- end(channelId, "You no longer participate in this room.");
350
- return true;
351
- }
352
- const peer = room.members.find((member) => member.handle === route.peer);
353
- if (!peer || !["invited", "joined"].includes(peer.status)) {
354
- publish(room, [route.peer]);
355
- end(channelId, "This invitation is no longer active.");
356
- return true;
357
- }
358
- if (room.owner === room.me) {
359
- const member = room.members.find((entry) => entry.handle === route.peer);
360
- if (member?.status === "invited") {
361
- const before = room;
362
- room = save(room, {
363
- revision: room.revision + 1,
364
- members: room.members.map((entry) =>
365
- entry.handle === route.peer ? { ...entry, status: "joined" } : entry
366
- ),
367
- });
368
- publish(room);
369
- notify(before, room);
370
- }
371
- }
372
- onOpen(room.id, route.peer);
373
- void sync().catch((error) => log(error.message));
374
- return true;
375
- };
376
- const receive = (channelId, event) => {
377
- const route = channel(channelId);
378
- // A rejoin replaces the old pair channel. Acknowledge its queued frames
379
- // without applying them so they cannot block delivery on the new channel.
380
- if (!route)
381
- return store.meta(`shared-room-channel:${channelId}`)
382
- ? { ok: true, ignored: true }
383
- : null;
384
- let room = read(route.room_id);
385
- if (!event || typeof event !== "object")
386
- return { ok: false, error: "An empty room event." };
387
- if (!joined(room)) return { ok: true, ignored: true };
388
- if (event.type === "membership") {
389
- if (route.peer !== room.owner)
390
- return { ok: false, error: "Only the room owner changes membership." };
391
- if (
392
- !Number.isSafeInteger(event.revision) ||
393
- event.revision <= room.revision
394
- )
395
- return { ok: true, duplicate: true };
396
- let listed;
397
- try {
398
- listed = checkedMembers(event.members);
399
- } catch (error) {
400
- return { ok: false, error: error.message };
401
- }
402
- if (
403
- event.owner !== room.owner ||
404
- !listed.some(
405
- (member) => member.handle === room.owner && member.status === "joined"
406
- ) ||
407
- room.members.some(
408
- (member) =>
409
- ["left", "removed"].includes(member.status) &&
410
- listed.some(
411
- (next) =>
412
- next.handle === member.handle &&
413
- next.status === "joined" &&
414
- next.generation <= member.generation
415
- )
416
- )
417
- )
418
- return {
419
- ok: false,
420
- error: "A membership update cannot revive a departed person.",
421
- };
422
- const before = room;
423
- for (const member of listed) {
424
- const previous = room.members.find(
425
- (entry) => entry.handle === member.handle
426
- );
427
- if (previous && member.generation > previous.generation)
428
- for (const route of routes(room.id).filter(
429
- (entry) => entry.peer === member.handle
430
- ))
431
- forget(route);
432
- }
433
- room = save(room, { revision: event.revision, members: listed });
434
- notify(before, room);
435
- if (!joined(room)) closeRoutes(room, "Your room membership ended.");
436
- else void sync().catch((error) => log(error.message));
437
- return { ok: true };
438
- }
439
- const sender = room.members.find((member) => member.handle === route.peer);
440
- if (sender?.status !== "joined") return { ok: true, ignored: true };
441
- if (event.type === "room_left") {
442
- if (event.generation !== sender.generation)
443
- return { ok: true, ignored: true };
444
- const before = room;
445
- room = save(room, {
446
- revision: room.revision + (room.owner === room.me ? 1 : 0),
447
- members: room.members.map((member) =>
448
- member.handle === route.peer ? { ...member, status: "left" } : member
449
- ),
450
- });
451
- notify(before, room);
452
- if (room.owner === room.me) publish(room);
453
- return { ok: true };
454
- }
455
- if (event.type === "hello" || event.type === "roster") {
456
- const rosters = {
457
- ...room.rosters,
458
- [route.peer]: knownAgents(
459
- (event.agents ?? []).map((agent) => agent.id)
460
- ),
461
- };
462
- room = save(room, {
463
- rosters,
464
- ...(event.agreements
465
- ? {
466
- consents: {
467
- ...room.consents,
468
- [route.peer]: consentHashes(event.agreements),
469
- },
470
- }
471
- : {}),
472
- });
473
- }
474
- return onEvent(room.id, event, route.peer);
475
- };
476
- const closeRoutes = (room, reason) => {
477
- for (const route of routes(room.id)) end(route.id, reason);
478
- };
479
- const leave = (id) => {
480
- let room = read(id);
481
- if (!room || !joined(room)) return;
482
- send(id, { type: "room_left", generation: own(room).generation });
483
- const before = room;
484
- room = save(room, {
485
- members: room.members.map((member) =>
486
- member.handle === room.me ? { ...member, status: "left" } : member
487
- ),
488
- });
489
- notify(before, room);
490
- closeRoutes(room, "Left the shared room.");
491
- };
492
- const remove = (id, peer) => {
493
- const room = read(id);
494
- if (!room || !joined(room) || room.owner !== room.me)
495
- throw new Error("Only the room owner can remove someone.");
496
- if (peer === room.me)
497
- throw new Error("Use Leave to end your own participation.");
498
- if (!room.members.some((member) => member.handle === peer))
499
- throw new Error("That person is not in this room.");
500
- const updated = save(room, {
501
- revision: room.revision + 1,
502
- members: room.members.map((member) =>
503
- member.handle === peer ? { ...member, status: "removed" } : member
504
- ),
505
- });
506
- publish(updated, [...peersFor(id), peer]);
507
- notify(room, updated);
508
- };
509
- // The person blocked someone: the owner takes them out of the room; anyone else ends their pair channel with them
510
- // and keeps it ended (sync never links an errored peer again).
511
- const block = (id, peer) => {
512
- const room = read(id);
513
- if (!room || !joined(room)) return;
514
- if (
515
- room.owner === room.me &&
516
- room.members.some(
517
- (member) =>
518
- member.handle === peer &&
519
- ["invited", "joined"].includes(member.status)
520
- )
521
- )
522
- remove(id, peer);
523
- for (const route of routes(id).filter((entry) => entry.peer === peer)) {
524
- end(route.id, "Blocked.");
525
- forget(route);
526
- }
527
- const fresh = read(id);
528
- save(fresh, { errors: { ...fresh.errors, [peer]: "Blocked." } });
529
- };
530
- const closed = (channelId) => {
531
- const route = channel(channelId);
532
- if (!route) return false;
533
- run(
534
- "update shared_room_channels set state = 'closed' where id = ?",
535
- channelId
536
- );
537
- const room = read(route.room_id);
538
- if (
539
- joined(room) &&
540
- active(room).some((member) => member.handle === route.peer)
541
- ) {
542
- const next = save(room, {
543
- revision: room.revision + (room.owner === room.me ? 1 : 0),
544
- members: room.members.map((member) =>
545
- member.handle === route.peer ? { ...member, status: "left" } : member
546
- ),
547
- });
548
- notify(room, next);
549
- if (next.owner === next.me) publish(next);
550
- }
551
- return true;
552
- };
553
- let syncing = null;
554
- const retry = async (id, peer) => {
555
- const room = read(id);
556
- if (
557
- !room ||
558
- !joined(room) ||
559
- !room.members.some(
560
- (member) =>
561
- member.handle === peer &&
562
- ["invited", "joined"].includes(member.status)
563
- )
564
- )
565
- throw new Error(
566
- "That person has no active room invitation or membership."
567
- );
568
- const pending = (await sentInvites()).find(
569
- (entry) =>
570
- entry.project?.id === id &&
571
- entry.project.to === peer &&
572
- ["requested", "accepted", "accepted_pending"].includes(entry.status)
573
- );
574
- if (pending) {
575
- bind(pending.id, id, peer, "invited");
576
- if (store.getThread(pending.id)) opened(pending.id);
577
- return;
578
- }
579
- if (
580
- routes(id).some((entry) => entry.peer === peer && entry.state === "open")
581
- )
582
- return;
583
- await connect(id, peer, room.owner === room.me ? "invite" : "link");
584
- };
585
- const sync = () => {
586
- if (syncing) return syncing;
587
- syncing = (async () => {
588
- const current = rooms().filter(joined);
589
- if (!current.length) return;
590
- const waiting = await invites();
591
- for (const invitation of waiting) {
592
- if (
593
- invitation.project?.v !== 2 ||
594
- invitation.project.purpose !== "link"
595
- )
596
- continue;
597
- const room = read(invitation.project.id);
598
- if (!room || !joined(room)) continue;
599
- let incoming;
600
- try {
601
- incoming = validateInvite(invitation, room.me);
602
- } catch {
603
- continue;
604
- }
605
- if (
606
- incoming.owner !== room.owner ||
607
- incoming.revision > room.revision ||
608
- !active(room).some((member) => member.handle === incoming.from) ||
609
- routes(room.id).some((route) => route.peer === incoming.from)
610
- )
611
- continue;
612
- bind(invitation.id, room.id, incoming.from);
613
- await decide(invitation.id, "accept");
614
- }
615
- for (const room of rooms().filter(joined))
616
- for (const peer of peersFor(room.id)) {
617
- if (
618
- room.me > peer ||
619
- routes(room.id).some((route) => route.peer === peer) ||
620
- room.errors[peer]
621
- )
622
- continue;
623
- await connect(room.id, peer, "link").catch(() => undefined);
624
- }
625
- })().finally(() => {
626
- syncing = null;
627
- });
628
- return syncing;
629
- };
630
- const timer = setInterval(
631
- () => void sync().catch((error) => log(error.message)),
632
- 2_000
633
- );
634
- timer.unref?.();
635
- return {
636
- init,
637
- read,
638
- members,
639
- recipients,
640
- routes,
641
- channel,
642
- knowsChannel: (id) =>
643
- Boolean(channel(id) || store.meta(`shared-room-channel:${id}`)),
644
- invite,
645
- // Whether an invitation names its real sender and this person, as join requires; throws why not.
646
- validate: validateInvite,
647
- knownAgents,
648
- join,
649
- setAgents,
650
- opened,
651
- receive,
652
- leave,
653
- remove,
654
- block,
655
- closed,
656
- sync,
657
- retry,
658
- agents: (id) => {
659
- const available = ownAgents();
660
- return (read(id)?.agents ?? available).filter((agent) =>
661
- available.includes(agent)
662
- );
663
- },
664
- peers: peersFor,
665
- stop: () => clearInterval(timer),
666
- };
667
- }