@agentshouse/mdruntime 0.1.0-c698c0ebd65bd → 0.1.0-c6b1e70f2da66

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 (370) hide show
  1. package/README.md +19 -16
  2. package/dist/acceptance.d.ts +6 -0
  3. package/dist/acceptance.d.ts.map +1 -0
  4. package/dist/acceptance.js +387 -0
  5. package/dist/actions.d.ts +20 -0
  6. package/dist/actions.d.ts.map +1 -0
  7. package/dist/actions.js +251 -0
  8. package/dist/adapter.d.ts +155 -86
  9. package/dist/adapter.d.ts.map +1 -1
  10. package/dist/attached-model.d.ts +7 -10
  11. package/dist/attached-model.d.ts.map +1 -1
  12. package/dist/attached-model.js +40 -41
  13. package/dist/binary.d.ts +0 -5
  14. package/dist/binary.d.ts.map +1 -1
  15. package/dist/binary.js +1 -1
  16. package/dist/bootstrap.d.ts +31 -11
  17. package/dist/bootstrap.d.ts.map +1 -1
  18. package/dist/bootstrap.js +324 -93
  19. package/dist/cell.d.ts +6 -0
  20. package/dist/cell.d.ts.map +1 -0
  21. package/dist/cell.js +9 -0
  22. package/dist/chain.d.ts +12 -0
  23. package/dist/chain.d.ts.map +1 -0
  24. package/dist/chain.js +64 -0
  25. package/dist/change-set.d.ts +9 -14
  26. package/dist/change-set.d.ts.map +1 -1
  27. package/dist/change-set.js +11 -63
  28. package/dist/change.d.ts +32 -1
  29. package/dist/change.d.ts.map +1 -1
  30. package/dist/change.js +14 -3
  31. package/dist/chat-types.d.ts +5 -0
  32. package/dist/chat-types.d.ts.map +1 -0
  33. package/dist/chat-types.js +13 -0
  34. package/dist/client.d.ts +45 -16
  35. package/dist/client.d.ts.map +1 -1
  36. package/dist/client.js +104 -13
  37. package/dist/collection.d.ts +31 -9
  38. package/dist/collection.d.ts.map +1 -1
  39. package/dist/collection.js +49 -80
  40. package/dist/compile.d.ts +16 -0
  41. package/dist/compile.d.ts.map +1 -0
  42. package/dist/compile.js +711 -0
  43. package/dist/connection.d.ts +8 -117
  44. package/dist/connection.d.ts.map +1 -1
  45. package/dist/connection.js +106 -2486
  46. package/dist/context.d.ts +2 -0
  47. package/dist/context.d.ts.map +1 -0
  48. package/dist/{chat/context.js → context.js} +1 -4
  49. package/dist/conversation-live.d.ts +135 -0
  50. package/dist/conversation-live.d.ts.map +1 -0
  51. package/dist/conversation-live.js +247 -0
  52. package/dist/conversation-row.d.ts +33 -0
  53. package/dist/conversation-row.d.ts.map +1 -0
  54. package/dist/conversation-row.js +53 -0
  55. package/dist/conversation.d.ts +55 -42
  56. package/dist/conversation.d.ts.map +1 -1
  57. package/dist/conversation.js +985 -649
  58. package/dist/digest.d.ts +7 -0
  59. package/dist/digest.d.ts.map +1 -0
  60. package/dist/digest.js +113 -0
  61. package/dist/discovery.d.ts +10 -0
  62. package/dist/discovery.d.ts.map +1 -0
  63. package/dist/discovery.js +175 -0
  64. package/dist/durability.d.ts +19 -1
  65. package/dist/durability.d.ts.map +1 -1
  66. package/dist/durability.js +5 -0
  67. package/dist/entry.d.ts +7 -4
  68. package/dist/entry.d.ts.map +1 -1
  69. package/dist/entry.js +33 -28
  70. package/dist/expectation.d.ts +4 -2
  71. package/dist/expectation.d.ts.map +1 -1
  72. package/dist/expectation.js +33 -11
  73. package/dist/failure.d.ts +1 -0
  74. package/dist/failure.d.ts.map +1 -1
  75. package/dist/failure.js +3 -0
  76. package/dist/figures.d.ts +49 -0
  77. package/dist/figures.d.ts.map +1 -0
  78. package/dist/figures.js +197 -0
  79. package/dist/file.d.ts +2 -19
  80. package/dist/file.d.ts.map +1 -1
  81. package/dist/file.js +7 -122
  82. package/dist/holdings.d.ts +29 -0
  83. package/dist/holdings.d.ts.map +1 -0
  84. package/dist/holdings.js +95 -0
  85. package/dist/host.d.ts +11 -3
  86. package/dist/host.d.ts.map +1 -1
  87. package/dist/host.js +127 -20
  88. package/dist/index.d.ts +35 -11
  89. package/dist/index.d.ts.map +1 -1
  90. package/dist/index.js +13 -0
  91. package/dist/install.d.ts +56 -0
  92. package/dist/install.d.ts.map +1 -0
  93. package/dist/install.js +556 -0
  94. package/dist/job.d.ts +5 -0
  95. package/dist/job.d.ts.map +1 -0
  96. package/dist/job.js +7 -0
  97. package/dist/lifecycle.d.ts +7 -0
  98. package/dist/lifecycle.d.ts.map +1 -0
  99. package/dist/lifecycle.js +270 -0
  100. package/dist/listing.d.ts +53 -0
  101. package/dist/listing.d.ts.map +1 -0
  102. package/dist/listing.js +176 -0
  103. package/dist/live.d.ts +23 -0
  104. package/dist/live.d.ts.map +1 -0
  105. package/dist/live.js +165 -0
  106. package/dist/locks.d.ts +9 -0
  107. package/dist/locks.d.ts.map +1 -0
  108. package/dist/locks.js +62 -0
  109. package/dist/log.d.ts +1 -0
  110. package/dist/log.d.ts.map +1 -1
  111. package/dist/lost.d.ts +5 -0
  112. package/dist/lost.d.ts.map +1 -0
  113. package/dist/lost.js +61 -0
  114. package/dist/media.d.ts +8 -0
  115. package/dist/media.d.ts.map +1 -0
  116. package/dist/media.js +218 -0
  117. package/dist/memory.d.ts +19 -6
  118. package/dist/memory.d.ts.map +1 -1
  119. package/dist/memory.js +251 -97
  120. package/dist/messages.d.ts +49 -0
  121. package/dist/messages.d.ts.map +1 -0
  122. package/dist/messages.js +148 -0
  123. package/dist/model.d.ts +11 -12
  124. package/dist/model.d.ts.map +1 -1
  125. package/dist/model.js +7 -15
  126. package/dist/models.d.ts +14 -0
  127. package/dist/models.d.ts.map +1 -0
  128. package/dist/models.js +197 -0
  129. package/dist/name.d.ts +4 -0
  130. package/dist/name.d.ts.map +1 -0
  131. package/dist/name.js +122 -0
  132. package/dist/observation.d.ts +22 -4
  133. package/dist/observation.d.ts.map +1 -1
  134. package/dist/observation.js +127 -26
  135. package/dist/opened.d.ts +22 -0
  136. package/dist/opened.d.ts.map +1 -0
  137. package/dist/opened.js +107 -0
  138. package/dist/opening.d.ts +4 -0
  139. package/dist/opening.d.ts.map +1 -0
  140. package/dist/opening.js +60 -0
  141. package/dist/outcome.d.ts +49 -8
  142. package/dist/outcome.d.ts.map +1 -1
  143. package/dist/outcome.js +42 -0
  144. package/dist/overlay.d.ts +5 -4
  145. package/dist/overlay.d.ts.map +1 -1
  146. package/dist/overlay.js +132 -192
  147. package/dist/parts.d.ts +11 -0
  148. package/dist/parts.d.ts.map +1 -0
  149. package/dist/parts.js +21 -0
  150. package/dist/paths.d.ts +2 -0
  151. package/dist/paths.d.ts.map +1 -1
  152. package/dist/paths.js +26 -0
  153. package/dist/preparation.d.ts +20 -0
  154. package/dist/preparation.d.ts.map +1 -0
  155. package/dist/preparation.js +233 -0
  156. package/dist/queries.d.ts +16 -0
  157. package/dist/queries.d.ts.map +1 -0
  158. package/dist/queries.js +272 -0
  159. package/dist/query.d.ts +49 -183
  160. package/dist/query.d.ts.map +1 -1
  161. package/dist/query.js +3 -464
  162. package/dist/{chat/questions.d.ts → questions.d.ts} +5 -2
  163. package/dist/questions.d.ts.map +1 -0
  164. package/dist/{chat/questions.js → questions.js} +13 -2
  165. package/dist/reach.d.ts +21 -7
  166. package/dist/reach.d.ts.map +1 -1
  167. package/dist/reach.js +292 -91
  168. package/dist/react.d.ts +20 -6
  169. package/dist/react.d.ts.map +1 -1
  170. package/dist/react.js +17 -18
  171. package/dist/{chat/read.d.ts → read.d.ts} +2 -0
  172. package/dist/read.d.ts.map +1 -0
  173. package/dist/{chat/read.js → read.js} +4 -0
  174. package/dist/readiness.d.ts +49 -0
  175. package/dist/readiness.d.ts.map +1 -0
  176. package/dist/readiness.js +27 -0
  177. package/dist/reads.d.ts +37 -0
  178. package/dist/reads.d.ts.map +1 -0
  179. package/dist/reads.js +174 -0
  180. package/dist/recovery.d.ts +26 -0
  181. package/dist/recovery.d.ts.map +1 -0
  182. package/dist/recovery.js +232 -0
  183. package/dist/refresh.d.ts +17 -14
  184. package/dist/refresh.d.ts.map +1 -1
  185. package/dist/refresh.js +143 -51
  186. package/dist/refusal.d.ts +5 -0
  187. package/dist/refusal.d.ts.map +1 -0
  188. package/dist/refusal.js +57 -0
  189. package/dist/replica.d.ts +56 -33
  190. package/dist/replica.d.ts.map +1 -1
  191. package/dist/replica.js +338 -159
  192. package/dist/room-draft.d.ts +39 -9
  193. package/dist/room-draft.d.ts.map +1 -1
  194. package/dist/room-draft.js +186 -86
  195. package/dist/room-drafts.d.ts +24 -0
  196. package/dist/room-drafts.d.ts.map +1 -0
  197. package/dist/room-drafts.js +217 -0
  198. package/dist/rows.d.ts +30 -37
  199. package/dist/rows.d.ts.map +1 -1
  200. package/dist/rows.js +60 -128
  201. package/dist/runtime.d.ts +43 -0
  202. package/dist/runtime.d.ts.map +1 -0
  203. package/dist/runtime.js +1 -0
  204. package/dist/save.d.ts +58 -10
  205. package/dist/save.d.ts.map +1 -1
  206. package/dist/save.js +569 -189
  207. package/dist/saves.d.ts +70 -0
  208. package/dist/saves.d.ts.map +1 -0
  209. package/dist/saves.js +1008 -0
  210. package/dist/search.d.ts +15 -55
  211. package/dist/search.d.ts.map +1 -1
  212. package/dist/search.js +10 -121
  213. package/dist/seed.d.ts +25 -0
  214. package/dist/seed.d.ts.map +1 -0
  215. package/dist/seed.js +145 -0
  216. package/dist/shared.d.ts +10 -0
  217. package/dist/shared.d.ts.map +1 -0
  218. package/dist/shared.js +339 -0
  219. package/dist/shown.d.ts +31 -0
  220. package/dist/shown.d.ts.map +1 -0
  221. package/dist/shown.js +290 -0
  222. package/dist/socket/admission.d.ts +7 -0
  223. package/dist/socket/admission.d.ts.map +1 -0
  224. package/dist/socket/admission.js +39 -0
  225. package/dist/socket/answers.d.ts +6 -0
  226. package/dist/socket/answers.d.ts.map +1 -0
  227. package/dist/socket/answers.js +20 -0
  228. package/dist/socket/lanes.d.ts +20 -0
  229. package/dist/socket/lanes.d.ts.map +1 -0
  230. package/dist/socket/lanes.js +77 -0
  231. package/dist/socket/reads.d.ts +10 -0
  232. package/dist/socket/reads.d.ts.map +1 -0
  233. package/dist/socket/reads.js +31 -0
  234. package/dist/socket/rooms.d.ts +44 -0
  235. package/dist/socket/rooms.d.ts.map +1 -0
  236. package/dist/socket/rooms.js +90 -0
  237. package/dist/socket/session.d.ts +38 -0
  238. package/dist/socket/session.d.ts.map +1 -0
  239. package/dist/socket/session.js +23 -0
  240. package/dist/socket.d.ts +70 -0
  241. package/dist/socket.d.ts.map +1 -0
  242. package/dist/socket.js +175 -0
  243. package/dist/source.d.ts +61 -0
  244. package/dist/source.d.ts.map +1 -0
  245. package/dist/source.js +82 -0
  246. package/dist/status.d.ts +5 -2
  247. package/dist/status.d.ts.map +1 -1
  248. package/dist/status.js +3 -7
  249. package/dist/store/fences.d.ts +16 -0
  250. package/dist/store/fences.d.ts.map +1 -0
  251. package/dist/store/fences.js +26 -0
  252. package/dist/store/installs.d.ts +30 -0
  253. package/dist/store/installs.d.ts.map +1 -0
  254. package/dist/store/installs.js +34 -0
  255. package/dist/store/readiness.d.ts +10 -0
  256. package/dist/store/readiness.d.ts.map +1 -0
  257. package/dist/store/readiness.js +52 -0
  258. package/dist/store/records.d.ts +210 -0
  259. package/dist/store/records.d.ts.map +1 -0
  260. package/dist/store/records.js +428 -0
  261. package/dist/store/room-held.d.ts +8 -0
  262. package/dist/store/room-held.d.ts.map +1 -0
  263. package/dist/store/room-held.js +17 -0
  264. package/dist/store/space.d.ts +11 -0
  265. package/dist/store/space.d.ts.map +1 -0
  266. package/dist/store/space.js +41 -0
  267. package/dist/store/watchers.d.ts +17 -0
  268. package/dist/store/watchers.d.ts.map +1 -0
  269. package/dist/store/watchers.js +56 -0
  270. package/dist/store/writes.d.ts +24 -0
  271. package/dist/store/writes.d.ts.map +1 -0
  272. package/dist/store/writes.js +125 -0
  273. package/dist/store.d.ts +106 -127
  274. package/dist/store.d.ts.map +1 -1
  275. package/dist/store.js +136 -575
  276. package/dist/stored.d.ts +156 -0
  277. package/dist/stored.d.ts.map +1 -0
  278. package/dist/stored.js +649 -0
  279. package/dist/surface.d.ts +88 -0
  280. package/dist/surface.d.ts.map +1 -0
  281. package/dist/surface.js +224 -0
  282. package/dist/sync.d.ts +19 -0
  283. package/dist/sync.d.ts.map +1 -0
  284. package/dist/sync.js +532 -0
  285. package/dist/tables.d.ts +412 -0
  286. package/dist/tables.d.ts.map +1 -0
  287. package/dist/tables.js +737 -0
  288. package/dist/tallies.d.ts +18 -0
  289. package/dist/tallies.d.ts.map +1 -0
  290. package/dist/tallies.js +129 -0
  291. package/dist/transfer.d.ts +0 -5
  292. package/dist/transfer.d.ts.map +1 -1
  293. package/dist/turn.d.ts +9 -0
  294. package/dist/turn.d.ts.map +1 -0
  295. package/dist/turn.js +75 -0
  296. package/dist/validation.d.ts +29 -0
  297. package/dist/validation.d.ts.map +1 -0
  298. package/dist/validation.js +104 -0
  299. package/dist/windows.d.ts +11 -0
  300. package/dist/windows.d.ts.map +1 -0
  301. package/dist/windows.js +16 -0
  302. package/dist/wire.d.ts +181 -33
  303. package/dist/wire.d.ts.map +1 -1
  304. package/dist/wire.js +62 -31
  305. package/package.json +19 -19
  306. package/AGENTS.md +0 -299
  307. package/dist/chat/acts.d.ts +0 -33
  308. package/dist/chat/acts.d.ts.map +0 -1
  309. package/dist/chat/acts.js +0 -36
  310. package/dist/chat/context.d.ts +0 -3
  311. package/dist/chat/context.d.ts.map +0 -1
  312. package/dist/chat/input.d.ts +0 -9
  313. package/dist/chat/input.d.ts.map +0 -1
  314. package/dist/chat/input.js +0 -99
  315. package/dist/chat/kit.d.ts +0 -60
  316. package/dist/chat/kit.d.ts.map +0 -1
  317. package/dist/chat/kit.js +0 -123
  318. package/dist/chat/lasting.d.ts +0 -6
  319. package/dist/chat/lasting.d.ts.map +0 -1
  320. package/dist/chat/lasting.js +0 -19
  321. package/dist/chat/list.d.ts +0 -26
  322. package/dist/chat/list.d.ts.map +0 -1
  323. package/dist/chat/list.js +0 -62
  324. package/dist/chat/markdown.d.ts +0 -20
  325. package/dist/chat/markdown.d.ts.map +0 -1
  326. package/dist/chat/markdown.js +0 -188
  327. package/dist/chat/message.d.ts +0 -6
  328. package/dist/chat/message.d.ts.map +0 -1
  329. package/dist/chat/message.js +0 -192
  330. package/dist/chat/messages.d.ts +0 -21
  331. package/dist/chat/messages.d.ts.map +0 -1
  332. package/dist/chat/messages.js +0 -151
  333. package/dist/chat/name.d.ts +0 -6
  334. package/dist/chat/name.d.ts.map +0 -1
  335. package/dist/chat/name.js +0 -37
  336. package/dist/chat/opened.d.ts +0 -11
  337. package/dist/chat/opened.d.ts.map +0 -1
  338. package/dist/chat/opened.js +0 -17
  339. package/dist/chat/overlay.d.ts +0 -31
  340. package/dist/chat/overlay.d.ts.map +0 -1
  341. package/dist/chat/overlay.js +0 -97
  342. package/dist/chat/parts.d.ts +0 -57
  343. package/dist/chat/parts.d.ts.map +0 -1
  344. package/dist/chat/parts.js +0 -119
  345. package/dist/chat/process.d.ts +0 -20
  346. package/dist/chat/process.d.ts.map +0 -1
  347. package/dist/chat/process.js +0 -32
  348. package/dist/chat/provider.d.ts +0 -63
  349. package/dist/chat/provider.d.ts.map +0 -1
  350. package/dist/chat/provider.js +0 -620
  351. package/dist/chat/question.d.ts +0 -9
  352. package/dist/chat/question.d.ts.map +0 -1
  353. package/dist/chat/question.js +0 -80
  354. package/dist/chat/questions.d.ts.map +0 -1
  355. package/dist/chat/read.d.ts.map +0 -1
  356. package/dist/chat/ready.d.ts +0 -33
  357. package/dist/chat/ready.d.ts.map +0 -1
  358. package/dist/chat/ready.js +0 -91
  359. package/dist/chat/style.d.ts +0 -4
  360. package/dist/chat/style.d.ts.map +0 -1
  361. package/dist/chat/style.js +0 -302
  362. package/dist/chat.d.ts +0 -14
  363. package/dist/chat.d.ts.map +0 -1
  364. package/dist/chat.js +0 -8
  365. package/dist/fence.d.ts +0 -6
  366. package/dist/fence.d.ts.map +0 -1
  367. package/dist/fence.js +0 -10
  368. package/dist/read-side.d.ts +0 -18
  369. package/dist/read-side.d.ts.map +0 -1
  370. package/dist/read-side.js +0 -440
@@ -1,2498 +1,118 @@
1
- import { attachedModel } from './attached-model.js';
2
- import { cached, modelTypes, NO_MODEL, sameModel, } from './model.js';
3
- import { observing } from './observation.js';
4
- import { filterOf, identityOf, planOf, } from './query.js';
5
- import { createReadSide } from './read-side.js';
6
- import { markdownPath, roomOfKey } from './rows.js';
7
- import { createSearchIndex, searchPlanOf, } from './search.js';
8
- import { bootstrapRoom } from './bootstrap.js';
9
- import { changeSet, mergeChangeSets } from './change-set.js';
10
- import { createConversationStore, } from './conversation.js';
11
- import { queuedFile } from './change.js';
12
- import { validRoot } from './collection.js';
13
- import { runtimeError } from './failure.js';
1
+ import { submitLater, unpair } from './acceptance.js';
2
+ import { invokeAction, called, readConversationHistory, resendLater } from './actions.js';
3
+ import { builtInModel, roomTypesOf } from './attached-model.js';
4
+ import { createLiveConversations } from './conversation-live.js';
5
+ import { refusedForSpace } from './durability.js';
6
+ import { uncaught } from './failure.js';
7
+ import { createFigures } from './figures.js';
8
+ import { scheduleCurrency, spaceFreed, start } from './lifecycle.js';
9
+ import { createLiveQueries } from './live.js';
14
10
  import { createLog } from './log.js';
15
- import { binaryRecord } from './binary.js';
16
- import { absentBinary, binaryAnswer, calledResult, failure, historyAnswer, undeclared, UNCERTAIN, } from './outcome.js';
17
- import { refreshRoom } from './refresh.js';
18
- import { buildBatch, joined, limitedIn, requeued } from './save.js';
19
- import { applyReturned, compositionOf, confirmedOf, landed, readReclassified, replicaOf, sameMembership, withdrawals, } from './replica.js';
20
- import { binaryBase, changedParts, changesOf, held, heldFile, joinedDraft, readParts, returnedBy, returnedInto, staleWrite, underneath, withdrawnDrafts, } from './room-draft.js';
21
- import { same, saving, STARTING, transferring, } from './status.js';
22
- import { detectStorageLoss, nextGeneration } from './durability.js';
23
- import { FencedMap } from './fence.js';
24
- import { roomDraftRevision } from './identity.js';
25
- import { beneath, normalize } from './paths.js';
26
- import { openRuntimeStore, } from './store.js';
27
- import { unconfirmed } from './transfer.js';
28
- import { governs, holds, narrowed, planReach, } from './reach.js';
29
- function within(root, path) {
30
- return root === '' || beneath(root, path);
31
- }
32
- function declaredSelection(room) {
33
- const selection = room.typedSelection;
34
- if (selection === undefined)
35
- return true;
36
- if (!Array.isArray(selection.roots) || selection.roots.length === 0)
37
- return false;
38
- return selection.roots.every((root, index) => validRoot(root) &&
39
- root !== '' &&
40
- selection.roots.every((other, at) => at === index || !within(other, root)));
41
- }
11
+ import { scoped } from './models.js';
12
+ import { open } from './opening.js';
13
+ import { deliverOwedReadiness, filled } from './preparation.js';
14
+ import { answeredPlan, figuresCover, roomTallies } from './queries.js';
15
+ import { readAnswers } from './reads.js';
16
+ import { createRecovery } from './recovery.js';
17
+ import { settle } from './saves.js';
18
+ import { publishChangeSet, show } from './shown.js';
19
+ import { createSocket } from './socket.js';
20
+ import { createStore } from './store.js';
21
+ import { composedRuntime } from './surface.js';
22
+ import { advanced, withhold } from './sync.js';
23
+ const ROOM_ATTEMPTS = 16;
42
24
  export function composeRuntime(options) {
43
- const localSaves = options.adapter.localSaves === true;
44
- let authorization = options.authorization;
45
- let opening;
46
- let store;
47
- const fences = new Map();
48
- const isFenced = (locator) => fences.has(locator);
49
- let fencings = 0;
50
- const lastFenced = new Map();
51
- const fencedSince = (locator, since) => fences.has(locator) || (lastFenced.get(locator) ?? 0) > since;
52
- let discoveries = 0;
53
- const replicas = new FencedMap(isFenced);
54
- const queuesWithoutReplica = new FencedMap(isFenced);
55
- const pendings = new Map();
56
- const roomDrafts = new FencedMap(isFenced);
57
- const presentations = new Map();
58
- let limits = [];
59
- let capabilities = [];
60
- const rooms = new FencedMap(isFenced);
61
- const counted = new Map();
62
- const unreadable = new Set();
63
- const isModelFenced = (key) => isFenced(key.slice(key.indexOf(' ') + 1));
64
- const models = new FencedMap(isModelFenced);
65
- const liveModels = new FencedMap(isModelFenced);
66
- const invalidModels = new Set();
67
- const discovered = new Map();
68
- let roomsListed = false;
69
- const scopedRefusals = new Map();
70
- const sourceRefusals = new Map();
71
- const declarationRefusals = new Set();
72
- function modelKey(locator, attached) {
73
- return `${attached} ${locator}`;
74
- }
75
- function modelOf(locator, attached = 'collection') {
76
- return models.get(modelKey(locator, attached)) ?? NO_MODEL;
77
- }
78
- function savedModel(locator, attached) {
79
- return invalidModels.has(modelKey(locator, attached))
80
- ? { status: 'unavailable', reason: 'revoked' }
81
- : modelOf(locator, attached);
82
- }
83
- function compositionFor(record) {
84
- return compositionOf({
85
- ...record,
86
- model: savedModel(record.locator, 'collection'),
87
- selectionModel: savedModel(record.locator, 'typed-selection'),
88
- });
89
- }
90
- let refusal = null;
91
- let storageLoss = null;
92
- let status = STARTING;
93
- let shown = STARTING;
94
- let discoveryPaused = false;
95
- let resetTimer;
96
- let closed = false;
97
- let stopping = false;
98
- let withdrawStream;
99
- const announced = new Map();
100
- let underway = null;
101
- let streamed = null;
102
- let handed = false;
103
- const submitting = new Map();
104
- const answering = new Map();
105
- let complete = false;
106
- let recorded = false;
107
- const stale = new Set();
108
- let chain = Promise.resolve();
109
- let mutations = Promise.resolve();
110
- const roomListeners = new Set();
111
- const refusalListeners = new Set();
112
- const storageLossListeners = new Set();
113
- const statusListeners = new Set();
114
- const queueSubscriptions = new Set();
115
- const roomDraftListeners = new Set();
116
- const presentationListeners = new Set();
117
- const readSide = createReadSide();
118
- let withdrawConversations;
119
- let currencyQueued = false;
120
- let socketOpen = false;
121
- let serviceMode = 'open';
122
- let haltedRefusal = false;
123
- let openSignals = 0;
124
- const serviceModeListeners = new Set();
125
- let member = null;
126
- const memberListeners = new Set();
127
- const materialized = new Set();
128
- let everyRoom = false;
129
- const transfers = new FencedMap(isFenced);
130
- const conversations = createConversationStore({
131
- agents: declaredAgents,
132
- documents: (locator) => rowsQuery(planOf({ rooms: [locator], select: 'all' }, roomFacts())),
133
- call: (name, input) => invokeAction(name, input),
134
- durably,
135
- stream: () => options.adapter.conversations,
136
- publish: publishChangeSet,
137
- online: () => !status.providerUnreachable && refusal === null,
138
- closed: () => closed,
139
- });
140
- const searchIndex = createSearchIndex({
141
- documents: () => readSide.documents(),
142
- document: (room, path) => readSide.document(room, path),
143
- messages: () => conversations.messages(),
144
- message: (conversation, identity) => conversations.message(conversation, identity),
145
- });
25
+ const { adapter, shell } = options;
26
+ const roomTypes = roomTypesOf(adapter.roomTypes, adapter.nameableRoomTypes);
27
+ const builtIn = builtInModel(roomTypes);
28
+ const typedPaths = adapter.typedPaths ?? [];
146
29
  const journal = createLog();
147
- let notifyReady = () => { };
148
- const ready = new Promise((resolve) => {
149
- notifyReady = resolve;
150
- });
151
- function rememberRoomDraft(record) {
152
- const room = roomDrafts.get(record.locator) ?? new Map();
153
- room.set(record.path, record);
154
- roomDrafts.set(record.locator, room);
155
- }
156
- function forgetRoomDraft(locator, path) {
157
- const room = roomDrafts.get(locator);
158
- if (room === undefined)
159
- return;
160
- room.delete(path);
161
- if (room.size === 0)
162
- roomDrafts.delete(locator);
163
- }
164
- function roomDraftOf(record) {
165
- return structuredClone({
166
- room: record.locator,
167
- path: record.path,
168
- revision: record.revision,
169
- parts: record.parts,
170
- changedUnderneath: underneath(record.parts, record.path, replicas.get(record.locator)?.visible),
171
- returned: record.returned,
172
- });
173
- }
174
- function snapshotRoomDrafts() {
175
- const records = [...roomDrafts.values()].flatMap((room) => [...room.values()]);
176
- records.sort((left, right) => {
177
- if (left.locator !== right.locator)
178
- return left.locator < right.locator ? -1 : 1;
179
- if (left.path !== right.path)
180
- return left.path < right.path ? -1 : 1;
181
- return 0;
182
- });
183
- return records.map(roomDraftOf);
184
- }
185
- function publishRoomDrafts(waitingOnly) {
186
- if (closed)
187
- return;
188
- const value = snapshotRoomDrafts();
189
- for (const listener of roomDraftListeners) {
190
- if (waitingOnly && listener.ready)
191
- continue;
192
- listener.ready = true;
193
- listener.notify(value);
194
- }
195
- }
196
- function presentationOf(app) {
197
- const value = presentations.get(app);
198
- return value === undefined ? null : structuredClone(value);
199
- }
200
- function emitPresentation(app) {
201
- if (closed)
202
- return;
203
- for (const listener of presentationListeners) {
204
- if (listener.app === app && listener.ready)
205
- listener.notify(presentationOf(app));
206
- }
207
- }
208
- function pending() {
209
- return (!localSaves &&
210
- (queuesWithoutReplica.size > 0 ||
211
- [...replicas.values()].some((replica) => replica.queue.length > 0)));
212
- }
213
- function attention() {
214
- const attentionRequired = [];
215
- for (const record of [...roomDrafts.values()].flatMap((room) => [...room.values()])) {
216
- if (record.returned === null)
217
- continue;
218
- attentionRequired.push({
219
- room: record.locator,
220
- path: record.path,
221
- returned: structuredClone(record.returned),
222
- });
223
- }
224
- attentionRequired.sort((left, right) => {
225
- if (left.room !== right.room)
226
- return left.room < right.room ? -1 : 1;
227
- if (left.path !== right.path)
228
- return left.path < right.path ? -1 : 1;
229
- return 0;
230
- });
231
- let reset = null;
232
- for (const { submission } of pendings.values()) {
233
- if (submission.state !== 'reset')
234
- continue;
235
- if (reset === null || submission.reset < reset)
236
- reset = submission.reset;
237
- }
238
- return { attentionRequired, reset };
239
- }
240
- function documentsIn(locator) {
241
- const replica = replicas.get(locator);
242
- if (replica === undefined)
243
- return 0;
244
- const roots = replica.confirmed.record.typedSelection?.roots ?? [];
245
- const paths = [
246
- ...Object.keys(replica.visible.documents).filter(markdownPath),
247
- ...Object.keys(replica.visible.binaries),
248
- ];
249
- return paths.filter((path) => !roots.some((root) => beneath(root, path))).length;
250
- }
251
- function listed() {
252
- return structuredClone([...rooms.values()].map((room) => {
253
- const documents = documentsIn(room.locator);
254
- counted.set(room.locator, documents);
255
- return { ...room, documents };
256
- }));
257
- }
258
- function roomFacts(reach = null) {
259
- const held = [...rooms.values()]
260
- .filter((room) => holds(reach, room.locator))
261
- .map((room) => {
262
- const governed = governs(reach, room);
263
- const attached = [
264
- ...(governed.collection ? [modelOf(room.locator)] : []),
265
- ...(governed.selection ? [modelOf(room.locator, 'typed-selection')] : []),
266
- ];
267
- return {
268
- locator: room.locator,
269
- available: attached.every((model) => model.status !== 'unavailable'),
270
- types: attached.flatMap((model) => model.status === 'unavailable' ? [] : Object.values(model.types)),
271
- };
272
- });
273
- return { listed: roomsListed, rooms: held };
274
- }
275
- function emitRooms() {
276
- const value = listed();
277
- for (const listener of roomListeners)
278
- listener(value);
279
- }
280
- function emitRefusal() {
281
- for (const listener of refusalListeners)
282
- listener(refusal);
283
- }
284
- function emitStorageLoss() {
285
- for (const listener of storageLossListeners)
286
- listener(storageLoss);
287
- }
288
- function emitMember() {
289
- for (const listener of memberListeners)
290
- listener(member);
291
- }
292
- function moveTo(next) {
293
- if (closed)
294
- return;
295
- status = next;
296
- show();
297
- }
298
- function show() {
299
- if (closed)
300
- return;
301
- const next = status.state === 'synced' && !conversations.current()
302
- ? { ...status, state: 'syncing' }
303
- : status;
304
- if (same(shown, next))
305
- return;
306
- shown = next;
307
- for (const listener of statusListeners)
308
- listener(shown);
309
- }
310
- function entryOf(batch) {
311
- if (localSaves)
312
- return Object.freeze({ batch, state: 'local' });
313
- const state = pendings.get(batch.id);
314
- if (state?.accepted !== undefined) {
315
- return Object.freeze({ batch, state: 'accepted', roomVersion: state.accepted });
316
- }
317
- return Object.freeze({ batch, ...(state?.submission ?? { state: 'waiting' }) });
318
- }
319
- function entriesOf(locator) {
320
- return (replicas.get(locator)?.queue ?? queuesWithoutReplica.get(locator) ?? []).map(entryOf);
321
- }
322
- function emitQueue(locator) {
323
- const entries = entriesOf(locator);
324
- for (const subscription of queueSubscriptions) {
325
- if (subscription.locator === locator)
326
- subscription.notify(entries);
327
- }
328
- }
329
- function applyChangeSet(set) {
330
- const held = everyRoom
331
- ? set
332
- : { ...set, documents: set.documents.filter(({ locator }) => materialized.has(locator)) };
333
- readSide.apply(held);
334
- searchIndex.changed(held);
335
- }
336
- function materialize(locators) {
337
- if (everyRoom)
338
- return;
339
- if (locators === null)
340
- everyRoom = true;
341
- const sets = [];
342
- for (const locator of locators ?? [...replicas.keys()]) {
343
- if (materialized.has(locator))
344
- continue;
345
- materialized.add(locator);
346
- const replica = replicas.get(locator);
347
- if (replica !== undefined)
348
- sets.push(changeSet(locator, null, replica));
349
- }
350
- if (sets.length === 0)
351
- return;
352
- const set = mergeChangeSets(sets);
353
- readSide.apply(set);
354
- searchIndex.changed(set);
355
- }
356
- function reachedRooms(plan) {
357
- if (plan.rooms !== null)
358
- return plan.rooms;
359
- if (plan.reach === null)
360
- return null;
361
- return [...plan.reach.rooms, ...plan.reach.documents.map(roomOfKey)];
362
- }
363
- function rowsQuery(plan) {
364
- materialize(reachedRooms(plan));
365
- return readSide.query(plan);
366
- }
367
- function publishChangeSet(set) {
368
- applyChangeSet(set);
369
- if (set.rooms.length > 0 ||
370
- [...new Set(set.documents.map(({ locator }) => locator))].some((locator) => rooms.has(locator) && counted.get(locator) !== documentsIn(locator)))
371
- emitRooms();
372
- for (const locator of set.queues)
373
- emitQueue(locator);
374
- if (set.drafts.length > 0 ||
375
- set.documents.some((change) => roomDrafts.get(change.locator)?.has(change.path) === true)) {
376
- publishRoomDrafts(false);
377
- }
378
- for (const app of set.presentations)
379
- emitPresentation(app);
380
- conversations.changed(set);
381
- }
382
- function stopTimer() {
383
- if (resetTimer === undefined)
384
- return;
385
- clearTimeout(resetTimer);
386
- resetTimer = undefined;
387
- }
388
- function armTimer() {
389
- stopTimer();
390
- if (closed || stopping)
391
- return;
392
- let earliest = null;
393
- for (const { submission } of pendings.values()) {
394
- if (submission.state !== 'reset')
395
- continue;
396
- const at = Date.parse(submission.reset);
397
- if (earliest === null || at < earliest)
398
- earliest = at;
399
- }
400
- if (earliest === null)
401
- return;
402
- // A Save House held back goes again only once the reset its answer named has passed.
403
- resetTimer = setTimeout(() => {
404
- resetTimer = undefined;
405
- submitAll();
406
- }, Math.max(0, earliest - Date.now()));
407
- }
408
- async function refuse(reason, provider = null) {
409
- stopTimer();
410
- discoveryPaused = true;
411
- try {
412
- if (reason === 'revoked-authorization') {
413
- await exclusive(async () => {
414
- const revoked = { status: 'unavailable', reason: 'revoked' };
415
- try {
416
- const local = await openLocal();
417
- await local.revokeModels([...replicas.values()].map((replica) => replica.confirmed.record));
418
- }
419
- catch {
420
- journal.record('model revocation persistence failed');
421
- }
422
- const keys = new Set(models.keys());
423
- for (const locator of rooms.keys()) {
424
- keys.add(modelKey(locator, 'collection'));
425
- keys.add(modelKey(locator, 'typed-selection'));
426
- }
427
- for (const key of keys) {
428
- invalidModels.add(key);
429
- models.set(key, revoked);
430
- liveModels.delete(key);
431
- }
432
- const changed = [];
433
- for (const [locator, room] of rooms) {
434
- const before = replicas.get(locator) ?? null;
435
- if (before !== null) {
436
- const record = {
437
- ...before.confirmed.record,
438
- model: revoked,
439
- selectionModel: revoked,
440
- };
441
- replicas.set(locator, replicaOf(confirmedOf(record, before.confirmed), before.queue, before));
442
- }
443
- rooms.set(locator, {
444
- ...room,
445
- model: modelTypes(revoked),
446
- typedSelection: room.typedSelection === null
447
- ? null
448
- : { ...room.typedSelection, model: modelTypes(revoked) },
449
- });
450
- changed.push(changeSet(locator, before, replicas.get(locator) ?? null, { room: true }));
451
- }
452
- publishChangeSet(mergeChangeSets(changed));
453
- });
454
- }
455
- }
456
- finally {
457
- refusal = {
458
- code: reason,
459
- retryable: false,
460
- reauthorizationOffered: reason === 'revoked-authorization',
461
- refusal: provider,
462
- };
463
- journal.record(`connection refused ${reason}`);
464
- emitRefusal();
465
- }
466
- }
467
- function list(room, synchronizationAvailable) {
468
- const selection = room.typedSelection ?? null;
469
- rooms.set(room.locator, {
470
- name: room.name,
471
- locator: room.locator,
472
- handle: room.handle,
473
- operations: room.operations,
474
- replica: room.replica,
475
- model: modelTypes(modelOf(room.locator)),
476
- typedSelection: selection === null
477
- ? null
478
- : {
479
- roots: selection.roots,
480
- model: modelTypes(modelOf(room.locator, 'typed-selection')),
481
- },
482
- providerOwnedPaths: room.providerOwnedPaths,
483
- roomVersion: replicas.get(room.locator)?.confirmed.record.roomVersion ?? null,
484
- synchronizationAvailable,
485
- refusal: scopedRefusals.get(room.locator) ?? sourceRefusals.get(room.locator) ?? null,
486
- });
487
- }
488
- async function applyDiscovery(found, started) {
489
- for (const room of found) {
490
- const fence = fences.get(room.locator);
491
- if (fence !== undefined && fence.erased && fence.at < started)
492
- fences.delete(room.locator);
493
- }
494
- const listed = found.filter((room) => !fences.has(room.locator));
495
- const listedLocators = new Set(listed.map((room) => room.locator));
496
- for (const locator of listedLocators)
497
- scopedRefusals.delete(locator);
498
- discovered.clear();
499
- for (const room of listed)
500
- discovered.set(room.locator, room);
501
- const unlisted = unlistedHeld(new Set(found.map((room) => room.locator)));
502
- if (options.adapter.exhaustiveDiscovery === true)
503
- await loseRooms(unlisted);
504
- else
505
- unlistedKept(unlisted);
506
- for (const room of listed) {
507
- const held = replicas.get(room.locator)?.confirmed.record;
508
- if (held !== undefined && held.replica.selection !== room.replica.selection) {
509
- list(held, false);
510
- continue;
511
- }
512
- list(room, room.replica.admission === 'admitted' && !unreadable.has(room.locator));
513
- }
514
- roomsListed = true;
515
- emitRooms();
516
- return listed;
517
- }
518
- function unlistedHeld(listed) {
519
- return [
520
- ...new Set([
521
- ...rooms.keys(),
522
- ...roomDrafts.keys(),
523
- ...transfers.keys(),
524
- ...queuesWithoutReplica.keys(),
525
- ]),
526
- ].filter((locator) => !listed.has(locator));
527
- }
528
- function unlistedKept(unlisted) {
529
- for (const locator of unlisted) {
530
- const held = replicas.get(locator)?.confirmed.record;
531
- if (held !== undefined)
532
- list(held, false);
533
- else
534
- rooms.delete(locator);
535
- }
536
- }
537
- function fence(locators) {
538
- const fresh = [...new Set(locators)].filter((locator) => !fences.has(locator));
539
- const removed = fresh.map((locator) => changeSet(locator, replicas.get(locator) ?? null, null, {
540
- room: true,
541
- queue: true,
542
- drafts: [...(roomDrafts.get(locator)?.keys() ?? [])],
543
- }));
544
- for (const locator of fresh) {
545
- fences.set(locator, { at: discoveries, erased: false });
546
- lastFenced.set(locator, ++fencings);
547
- for (const batch of replicas.get(locator)?.queue ?? queuesWithoutReplica.get(locator) ?? [])
548
- pendings.delete(batch.id);
549
- replicas.delete(locator);
550
- queuesWithoutReplica.delete(locator);
551
- rooms.delete(locator);
552
- roomDrafts.delete(locator);
553
- transfers.delete(locator);
554
- discovered.delete(locator);
555
- announced.delete(locator);
556
- unreadable.delete(locator);
557
- stale.delete(locator);
558
- scopedRefusals.delete(locator);
559
- sourceRefusals.delete(locator);
560
- declarationRefusals.delete(locator);
561
- for (const attached of ['collection', 'typed-selection']) {
562
- const key = modelKey(locator, attached);
563
- models.delete(key);
564
- liveModels.delete(key);
565
- invalidModels.delete(key);
566
- }
567
- journal.record(`room lost ${locator}`);
568
- }
569
- if (fresh.length === 0)
570
- return fresh;
571
- publishChangeSet(mergeChangeSets(removed));
572
- for (const locator of fresh)
573
- materialized.delete(locator);
574
- moveTo({ ...status, ...attention() });
575
- return fresh;
576
- }
577
- async function erased(local, locators) {
578
- await local.erase(locators);
579
- for (const locator of locators) {
580
- const held = fences.get(locator);
581
- if (held !== undefined)
582
- held.erased = true;
583
- }
584
- }
585
- async function loseRooms(locators) {
586
- const fresh = fence(locators);
587
- if (fresh.length > 0)
588
- await durably((local) => erased(local, fresh));
589
- }
590
- function restored(key, persisted) {
591
- const prior = models.get(key);
592
- if (prior !== undefined &&
593
- prior.status !== 'unavailable' &&
594
- (persisted.status === 'unavailable' || !sameModel(prior.snapshot, persisted.snapshot))) {
595
- invalidModels.add(key);
596
- }
597
- const model = persisted.status === 'unavailable' ||
598
- liveModels.get(key) === JSON.stringify(persisted.snapshot)
599
- ? persisted
600
- : cached(persisted);
601
- models.set(key, model);
602
- if (model.status === 'unavailable') {
603
- liveModels.delete(key);
604
- invalidModels.delete(key);
605
- }
606
- return model;
607
- }
608
- async function hydrate(opened) {
609
- const [records, queues, kept, presented, held, chatDrafts, lastCompleted, declared, named, known, staged,] = await Promise.all([
610
- opened.all(),
611
- opened.queues(),
612
- opened.roomDrafts(),
613
- opened.presentation(),
614
- opened.conversations(),
615
- opened.chatDrafts(),
616
- opened.lastCompleted(),
617
- opened.providerLimits(),
618
- opened.capabilities(),
619
- opened.member(),
620
- opened.transfers(),
621
- ]);
622
- transfers.clear();
623
- for (const record of staged)
624
- transfers.set(record.locator, record);
625
- limits = declared;
626
- capabilities = named;
627
- member = known;
628
- roomDrafts.clear();
629
- for (const record of kept)
630
- rememberRoomDraft(record);
631
- presentations.clear();
632
- for (const record of presented)
633
- presentations.set(record.app, record.value);
634
- conversations.hydrate(held, chatDrafts);
635
- const queuedBatches = new Map(queues.map((queue) => [queue.locator, queue.pending.map(({ batch }) => batch)]));
636
- pendings.clear();
637
- for (const queue of queues) {
638
- for (const { batch, state } of queue.pending)
639
- pendings.set(batch.id, state);
640
- }
641
- const previousReplicas = new Map(replicas);
642
- replicas.clear();
643
- queuesWithoutReplica.clear();
644
- const replicated = new Set(records.map((record) => record.locator));
645
- for (const [locator, queue] of queuedBatches) {
646
- if (!replicated.has(locator))
647
- queuesWithoutReplica.set(locator, queue);
648
- }
649
- for (const record of records) {
650
- const model = restored(modelKey(record.locator, 'collection'), record.model);
651
- const selectionModel = restored(modelKey(record.locator, 'typed-selection'), record.selectionModel);
652
- const prior = previousReplicas.get(record.locator);
653
- const confirmed = confirmedOf({ ...record, model, selectionModel }, prior?.confirmed);
654
- replicas.set(record.locator, replicaOf(confirmed, queuedBatches.get(record.locator) ?? [], prior));
655
- const existing = rooms.get(record.locator);
656
- if (existing === undefined)
657
- list(record, false);
658
- else {
659
- rooms.set(record.locator, {
660
- ...existing,
661
- roomVersion: record.roomVersion,
662
- operations: record.operations,
663
- replica: record.replica,
664
- model: modelTypes(model),
665
- typedSelection: record.typedSelection === null
666
- ? null
667
- : {
668
- roots: record.typedSelection.roots,
669
- model: modelTypes(selectionModel),
670
- },
671
- });
672
- }
673
- }
674
- return {
675
- lastCompleted,
676
- locators: new Set([...queuedBatches.keys(), ...replicas.keys()]),
677
- read: mergeChangeSets([...new Set([...previousReplicas.keys(), ...replicas.keys()])].map((locator) => changeSet(locator, previousReplicas.get(locator) ?? null, replicas.get(locator) ?? null))),
678
- };
679
- }
680
- async function readState(opened) {
681
- const { lastCompleted, locators, read } = await hydrate(opened);
682
- applyChangeSet(read);
683
- if (replicas.size > 0)
684
- emitRooms();
685
- if (member !== null)
686
- emitMember();
687
- for (const locator of locators)
688
- emitQueue(locator);
689
- publishRoomDrafts(false);
690
- return lastCompleted;
691
- }
692
- async function open() {
693
- if (closed)
694
- throw new Error('runtime closed');
695
- const opened = await openRuntimeStore(isFenced);
696
- store = opened;
697
- const interrupted = await opened.fences();
698
- for (const locator of interrupted) {
699
- fences.set(locator, { at: discoveries, erased: false });
700
- lastFenced.set(locator, ++fencings);
701
- }
702
- const kept = options.shell.generation;
703
- const storedGeneration = await opened.generation();
704
- const loss = detectStorageLoss(storedGeneration, kept);
705
- const generation = nextGeneration(storedGeneration, kept);
706
- if (generation !== storedGeneration)
707
- await opened.rememberGeneration(generation);
708
- if (generation !== kept)
709
- await options.shell.keepGeneration(generation);
710
- if (loss !== null) {
711
- storageLoss = loss;
712
- emitStorageLoss();
713
- }
714
- const lastCompleted = await readState(opened);
715
- if (interrupted.length > 0)
716
- await erased(opened, interrupted);
717
- moveTo({ ...status, lastCompleted, ...attention() });
718
- return opened;
719
- }
720
- function durably(work) {
721
- return exclusive(async () => {
722
- const local = await openLocal();
723
- return work(local);
724
- });
725
- }
726
- function openLocal() {
727
- opening ??= open().catch((error) => {
728
- opening = undefined;
729
- throw error;
730
- });
731
- return opening;
732
- }
733
- function exclusive(work) {
734
- const next = mutations.then(work, work);
735
- mutations = next.then(() => undefined, () => undefined);
736
- return next;
737
- }
738
- function withdrawable(batch) {
739
- const state = pendings.get(batch.id);
740
- return state !== undefined && state.submission.state !== 'submitted' && !state.lost;
741
- }
742
- async function settle(local, locator, before, confirmed, queue, settling = {}) {
743
- const previousQueue = before?.queue ?? queuesWithoutReplica.get(locator) ?? [];
744
- const withdrawn = withdrawals(confirmed, queue, withdrawable, localSaves);
745
- const kept = queue.filter((batch) => !withdrawn.includes(batch));
746
- const unqueued = withdrawn.map((batch) => ({
747
- batch,
748
- returned: localSaves || landed(batch, confirmed) ? null : returnedBy('withdrawn'),
749
- }));
750
- const returning = [
751
- ...[...unqueued].reverse(),
752
- ...(settling.leaving === undefined ? [] : [settling.leaving]),
753
- ];
754
- const written = new Map();
755
- for (const { batch, returned } of returning) {
756
- if (returned === null)
757
- continue;
758
- for (const saved of pendings.get(batch.id)?.drafts ?? []) {
759
- const existing = written.get(saved.path) ?? roomDrafts.get(locator)?.get(saved.path);
760
- written.set(saved.path, {
761
- locator,
762
- path: saved.path,
763
- revision: roomDraftRevision(),
764
- parts: returnedInto(existing?.parts, saved.parts),
765
- returned,
766
- });
767
- }
768
- }
769
- await local.keepAuthored({ locator, queue: kept, roomDrafts: [...written.values()] });
770
- for (const batch of previousQueue) {
771
- if (!kept.includes(batch))
772
- pendings.delete(batch.id);
773
- }
774
- for (const record of written.values())
775
- rememberRoomDraft(record);
776
- try {
777
- await local.write({
778
- next: confirmed.record,
779
- previous: before?.confirmed.record ?? null,
780
- ...(settling.stored === undefined ? {} : { stored: settling.stored }),
781
- });
782
- }
783
- catch (error) {
784
- const held = before === undefined ? null : replicaOf(before.confirmed, kept, before);
785
- if (held !== null)
786
- replicas.set(locator, held);
787
- else if (kept.length > 0)
788
- queuesWithoutReplica.set(locator, kept);
789
- else
790
- queuesWithoutReplica.delete(locator);
791
- publishChangeSet(changeSet(locator, before ?? null, held, {
792
- queue: kept.length !== previousQueue.length,
793
- drafts: [...written.keys()],
794
- }));
795
- moveTo({ ...status, ...attention() });
796
- throw error;
797
- }
798
- queuesWithoutReplica.delete(locator);
799
- for (const { batch, returned } of unqueued) {
800
- const outcome = localSaves ? 'dropped' : returned === null ? 'landed' : 'withdrawn';
801
- journal.record(`outcome ${locator} ${batch.id} ${outcome}`);
802
- }
803
- replicas.set(locator, replicaOf(confirmed, kept, before));
804
- return changeSet(locator, before ?? null, replicas.get(locator) ?? null, {
805
- room: settling.room,
806
- queue: kept.length !== previousQueue.length,
807
- drafts: [...written.keys()],
808
- });
809
- }
810
- function adoptModels(locator, record) {
811
- for (const [attached, model] of [
812
- ['collection', record.model],
813
- ['typed-selection', record.selectionModel],
814
- ]) {
815
- const key = modelKey(locator, attached);
816
- models.set(key, model);
817
- invalidModels.delete(key);
818
- if (model.status === 'current')
819
- liveModels.set(key, JSON.stringify(model.snapshot));
820
- else if (model.status === 'unavailable')
821
- liveModels.delete(key);
822
- }
823
- }
824
- function remodel(locator, answers, held) {
825
- const taken = (answer, previous, attached) => {
826
- if (answer === undefined)
827
- return previous;
828
- const { state, refused } = attachedModel(answer, previous);
829
- if (refused !== null) {
830
- const where = refused.location === undefined ? '' : ` ${refused.location}`;
831
- journal.record(`model invalid ${locator} ${attached} ${refused.identity} ${refused.rule}${where}`);
832
- }
833
- models.set(modelKey(locator, attached), state);
834
- return state;
835
- };
836
- return {
837
- collection: taken(answers?.collection, held.collection, 'collection'),
838
- selection: taken(answers?.selection, held.selection, 'typed-selection'),
839
- };
840
- }
841
- function publish(local, room, confirmed, landing = {}) {
842
- const { base, stored } = landing;
843
- return exclusive(async () => {
844
- if (!continuing())
845
- return true;
846
- const prior = replicas.get(room.locator);
847
- if (base !== undefined &&
848
- (prior?.confirmed.record.roomVersion !== base.record.roomVersion ||
849
- prior.confirmed.record.revisions !== base.record.revisions)) {
850
- return false;
851
- }
852
- adoptModels(room.locator, confirmed.record);
853
- const queue = prior?.queue ?? queuesWithoutReplica.get(room.locator) ?? [];
854
- const roomVersion = confirmed.record.roomVersion;
855
- const accepted = queue.filter((batch) => {
856
- const accepted = pendings.get(batch.id)?.accepted;
857
- return (accepted !== undefined && options.adapter.reached(room.locator, roomVersion, accepted));
858
- });
859
- const set = await settle(local, room.locator, prior, confirmed, queue.filter((batch) => !accepted.includes(batch)), { room: true, ...(stored === undefined ? {} : { stored }) });
860
- if (stored !== undefined)
861
- transfers.delete(room.locator);
862
- for (const batch of accepted)
863
- pendings.delete(batch.id);
864
- stale.delete(room.locator);
865
- if (unreadable.delete(room.locator))
866
- scopedRefusals.delete(room.locator);
867
- sourceRefusals.delete(room.locator);
868
- declarationRefusals.delete(room.locator);
869
- list(room, true);
870
- publishChangeSet(set);
871
- moveTo({ ...status, ...attention() });
872
- return true;
873
- });
874
- }
875
- async function saveRoomDrafts(locator, named, writtenBy) {
876
- const local = await openLocal();
877
- const replica = replicas.get(locator);
878
- const room = rooms.get(locator);
879
- if (replica === undefined || room === undefined) {
880
- throw runtimeError('room-not-held', `No Local Replica for ${locator}`);
881
- }
882
- const saved = [];
883
- for (const { path, revision } of named) {
884
- const record = roomDrafts.get(locator)?.get(path);
885
- if (record === undefined || record.revision !== revision) {
886
- return { outcome: 'refused', code: 'stale', retryable: false, file: path };
887
- }
888
- if (!saved.some((draft) => draft.path === path))
889
- saved.push({ path, parts: record.parts });
890
- }
891
- const changed = saved.flatMap(({ path, parts }) => changedParts(path, underneath(parts, path, replica.visible)));
892
- if (changed.length > 0)
893
- return { outcome: 'refused', code: 'changed-underneath', retryable: false, parts: changed };
894
- const parts = saved.map(({ path, parts }) => changesOf(path, parts));
895
- const changes = parts.flatMap(({ changes }) => changes);
896
- const requeue = requeued(replica.queue, changes, replica.visible, withdrawable, (queue) => replicaOf(replica.confirmed, queue, replica).visible);
897
- if (requeue.kind === 'refused')
898
- return { outcome: 'refused', ...requeue.refusal };
899
- const foreign = [...requeue.withdrawn.keys()].some((origin) => {
900
- const writer = replica.queue.find((batch) => batch.id === origin)?.writtenBy;
901
- return writer?.app !== writtenBy?.app || writer?.release !== writtenBy?.release;
902
- });
903
- if (foreign) {
904
- return {
905
- outcome: 'refused',
906
- code: 'unknown-revision',
907
- retryable: false,
908
- file: [...requeue.queued].at(-1),
909
- };
910
- }
911
- const withdrawing = requeue.withdrawn.size > 0;
912
- const input = {
913
- local: localSaves,
914
- baseRoomVersion: replica.confirmed.record.roomVersion,
915
- composition: compositionFor(replica.confirmed.record),
916
- operations: room.operations,
917
- providerOwnedPaths: room.providerOwnedPaths,
918
- providerLimits: limits,
919
- handle: room.handle,
920
- visible: replica.visible,
921
- changes,
922
- bases: parts.flatMap(({ bases }) => bases),
923
- writtenBy,
924
- };
925
- const checked = withdrawing ? buildBatch({ ...input, queued: requeue.queued }) : null;
926
- if (checked?.kind === 'refused')
927
- return { outcome: 'refused', ...checked.refusal };
928
- const owners = [...requeue.owners].flatMap((origin) => {
929
- const batch = requeue.withdrawn.get(origin);
930
- return batch === undefined || batch === null ? [] : [{ origin, batch }];
931
- });
932
- if (owners.length > 1) {
933
- return {
934
- outcome: 'refused',
935
- code: 'unknown-revision',
936
- retryable: false,
937
- file: [...requeue.queued].at(-1),
938
- };
939
- }
940
- const built = !withdrawing
941
- ? buildBatch(input)
942
- : requeue.changes.length === 0
943
- ? null
944
- : buildBatch({
945
- ...input,
946
- visible: replicaOf(replica.confirmed, requeue.queue, replica).visible,
947
- changes: requeue.changes,
948
- });
949
- if (built?.kind === 'refused')
950
- return { outcome: 'refused', ...built.refusal };
951
- const [owner] = owners;
952
- const join = built === null || owner === undefined
953
- ? null
954
- : joined(requeue.queue, owner.batch, built.batch);
955
- if (join?.kind === 'refused')
956
- return { outcome: 'refused', ...join.refusal };
957
- const withdrawn = new Map(requeue.withdrawn);
958
- if (join !== null && owner !== undefined)
959
- withdrawn.set(owner.origin, join.batch);
960
- const drafted = new Map();
961
- for (const [origin, replaced] of withdrawn) {
962
- if (replaced === null)
963
- continue;
964
- const carried = withdrawnDrafts(pendings.get(origin)?.drafts ?? [], changes);
965
- drafted.set(replaced.id, replaced === join?.batch
966
- ? [
967
- ...carried.map((held) => joinedDraft(held, saved)),
968
- ...saved.filter((draft) => !carried.some((held) => held.path === draft.path)),
969
- ]
970
- : carried);
971
- }
972
- if (built !== null && join === null)
973
- drafted.set(built.batch.id, saved);
974
- const batches = join !== null ? join.queue : built === null ? requeue.queue : [...requeue.queue, built.batch];
975
- for (const replaced of withdrawn.values()) {
976
- if (replaced === null || !batches.includes(replaced))
977
- continue;
978
- const limited = limitedIn(batches, replaced, limits, (queue) => replicaOf(replica.confirmed, queue, replica).visible);
979
- if (limited !== null)
980
- return { outcome: 'refused', ...limited };
981
- }
982
- const consumed = saved.map(({ path }) => path);
983
- try {
984
- await local.keepAuthored({
985
- locator,
986
- queue: batches,
987
- saved: drafted,
988
- consumedRoomDrafts: consumed,
989
- });
990
- }
991
- catch {
992
- return { outcome: 'refused', code: 'durable-write', retryable: true };
993
- }
994
- if (fences.has(locator))
995
- throw runtimeError('room-not-held', `No Local Replica for ${locator}`);
996
- for (const origin of withdrawn.keys())
997
- pendings.delete(origin);
998
- for (const [id, drafts] of drafted) {
999
- pendings.set(id, { drafts, submission: { state: 'waiting' }, lost: false });
1000
- }
1001
- if (!localSaves)
1002
- recorded = false;
1003
- for (const path of consumed)
1004
- forgetRoomDraft(locator, path);
1005
- replicas.set(locator, replicaOf(replica.confirmed, batches, replica));
1006
- publishChangeSet(changeSet(locator, replica, replicas.get(locator) ?? null, {
1007
- queue: true,
1008
- drafts: consumed,
1009
- }));
1010
- moveTo({ ...(localSaves ? status : saving(status)), ...attention() });
1011
- submitLater(locator);
1012
- const identifier = join?.batch.id ??
1013
- built?.batch.id ??
1014
- [...requeue.withdrawn].map(([origin, replaced]) => replaced?.id ?? origin).at(-1);
1015
- return { outcome: 'saved', identifier };
1016
- }
1017
- async function mark(local, locator, identifier, submission, lost) {
1018
- const state = pendings.get(identifier);
1019
- if (!continuing() ||
1020
- state === undefined ||
1021
- (JSON.stringify(state.submission) === JSON.stringify(submission) && state.lost === lost)) {
1022
- return;
1023
- }
1024
- await local.submit(locator, identifier, submission, lost);
1025
- if (fences.has(locator))
1026
- return;
1027
- pendings.set(identifier, { ...state, submission, lost });
1028
- const replica = replicas.get(locator);
1029
- if (replica !== undefined)
1030
- publishChangeSet(changeSet(locator, replica, replica, { queue: true }));
1031
- moveTo({ ...status, ...attention() });
1032
- }
1033
- async function keepUpload(local, locator, identifier, upload) {
1034
- if (!continuing())
1035
- throw new Error('connection refused');
1036
- await local.keepUpload(locator, identifier, upload);
1037
- if (fences.has(locator))
1038
- throw runtimeError('room-not-held', `No Local Replica for ${locator}`);
1039
- pendings.set(identifier, { ...pendings.get(identifier), upload });
1040
- if (!continuing())
1041
- throw new Error('connection refused');
1042
- }
1043
- async function readHistory(locator, path, query = {}) {
1044
- if (closed || refusal !== null)
1045
- return UNCERTAIN;
1046
- try {
1047
- await ensureAuthorization();
1048
- }
1049
- catch {
1050
- return UNCERTAIN;
1051
- }
1052
- if (closed || authorization === undefined || refusal !== null)
1053
- return UNCERTAIN;
1054
- const since = fencings;
1055
- const transfer = ['transfer', 'history', locator, path];
1056
- if (query.revision !== undefined)
1057
- transfer.push(query.revision);
1058
- if (query.pageToken !== undefined)
1059
- transfer.push(query.pageToken);
1060
- journal.record(transfer.join(' '));
1061
- try {
1062
- const result = await options.adapter.history(authorization, {
1063
- locator,
1064
- path,
1065
- ...(query.revision === undefined ? {} : { revision: query.revision }),
1066
- ...(query.pageToken === undefined ? {} : { pageToken: query.pageToken }),
1067
- });
1068
- journal.record(`outcome history ${result.kind}`);
1069
- if (fencedSince(locator, since))
1070
- return failure({ kind: 'room-not-readable', locator });
1071
- if (result.kind === 'scoped-refusal') {
1072
- const room = replicas.get(result.locator)?.confirmed.record;
1073
- if (room !== undefined)
1074
- await scoped(result, room, await openLocal());
1075
- }
1076
- if (result.kind === 'revoked-authorization')
1077
- await refuse('revoked-authorization');
1078
- return historyAnswer(result);
1079
- }
1080
- catch {
1081
- journal.record('outcome history transport-uncertainty');
1082
- return UNCERTAIN;
1083
- }
1084
- }
1085
- function queuedBlob(locator, path, localId) {
1086
- for (const batch of replicas.get(locator)?.queue ?? []) {
1087
- const change = batch.changes[queuedFile(batch, path, localId)];
1088
- if (change?.kind === 'binary')
1089
- return change.blob;
1090
- }
1091
- return null;
1092
- }
1093
- function binaryRoom(request) {
1094
- if (request.kind === 'path')
1095
- return request.locator;
1096
- const scope = options.adapter.referrerScope(request.referrer);
1097
- return scope?.kind === 'room' ? scope.locator : null;
1098
- }
1099
- async function readBinary(request) {
1100
- if (closed || refusal !== null)
1101
- return UNCERTAIN;
1102
- try {
1103
- await ensureAuthorization();
1104
- }
1105
- catch {
1106
- return UNCERTAIN;
1107
- }
1108
- if (closed || authorization === undefined || refusal !== null)
1109
- return UNCERTAIN;
1110
- const since = fencings;
1111
- journal.record(request.kind === 'path'
1112
- ? `transfer binary ${request.locator} ${request.path}`
1113
- : `transfer binary ${request.fileRef}`);
1114
- try {
1115
- const result = await options.adapter.binary(authorization, request);
1116
- journal.record(`outcome binary ${result.kind}`);
1117
- const locator = binaryRoom(request);
1118
- if (locator !== null && fencedSince(locator, since))
1119
- return failure({ kind: 'room-not-readable', locator });
1120
- if (result.kind === 'scoped-refusal') {
1121
- const room = replicas.get(result.locator)?.confirmed.record;
1122
- if (room !== undefined)
1123
- await scoped(result, room, await openLocal());
1124
- }
1125
- if (result.kind === 'revoked-authorization')
1126
- await refuse('revoked-authorization');
1127
- return binaryAnswer(result);
1128
- }
1129
- catch {
1130
- journal.record('outcome binary transport-uncertainty');
1131
- return UNCERTAIN;
1132
- }
1133
- }
1134
- async function readBinaryPath(locator, path, revision) {
1135
- await ready;
1136
- if (revision !== undefined)
1137
- return readBinary({ kind: 'path', locator, path, revision });
1138
- const visible = replicas.get(locator)?.visible;
1139
- const held = visible?.binaries[path];
1140
- if (visible === undefined || held === undefined)
1141
- return absentBinary(path);
1142
- if (held.state === 'pending') {
1143
- const blob = queuedBlob(locator, path, held.localId);
1144
- return blob === null ? absentBinary(path) : { kind: 'binary', blob };
1145
- }
1146
- const record = binaryRecord(path, held, visible.revisions[path]);
1147
- if (record.state !== 'accepted')
1148
- return absentBinary(path);
1149
- const replica = replicas.get(locator);
1150
- const queued = (replica?.queue ?? []).flatMap((batch) => batch.changes);
1151
- const holds = (at) => {
1152
- const kept = replica?.confirmed.record.binaries[at];
1153
- return (kept?.state === 'accepted' &&
1154
- kept.fileRef === record.fileRef &&
1155
- replica?.confirmed.record.revisions[at] === record.revision);
1156
- };
1157
- let confirmed = path;
1158
- for (let index = queued.length - 1; index >= 0 && !holds(confirmed); index -= 1) {
1159
- const change = queued[index];
1160
- if (change.kind === 'move' && change.to === confirmed)
1161
- confirmed = change.path;
1162
- }
1163
- return readBinary({
1164
- kind: 'path',
1165
- locator,
1166
- path: confirmed,
1167
- revision: record.revision,
1168
- fileRef: record.fileRef,
1169
- });
1170
- }
1171
- async function readBinaryReference(reference) {
1172
- await ready;
1173
- return readBinary({
1174
- kind: 'reference',
1175
- fileRef: reference.fileRef,
1176
- referrer: reference.referrer,
1177
- });
1178
- }
1179
- function declaredAgents() {
1180
- for (const capability of capabilities) {
1181
- if (capability.conversationAgents !== undefined)
1182
- return capability.conversationAgents;
1183
- }
1184
- return undefined;
1185
- }
1186
- function declaredAction(name) {
1187
- for (const capability of capabilities) {
1188
- for (const action of capability.actions ?? []) {
1189
- if (action.name === name)
1190
- return action;
1191
- }
1192
- }
1193
- return undefined;
1194
- }
1195
- async function invokeAction(name, input) {
1196
- await ready;
1197
- if (closed || refusal !== null)
1198
- return UNCERTAIN;
1199
- if (declaredAction(name) === undefined)
1200
- return undeclared(name);
1201
- try {
1202
- await ensureAuthorization();
1203
- }
1204
- catch {
1205
- return UNCERTAIN;
1206
- }
1207
- if (closed || authorization === undefined || refusal !== null)
1208
- return UNCERTAIN;
1209
- journal.record(`transfer action ${name}`);
1210
- try {
1211
- const result = await options.adapter.action(authorization, { name, input });
1212
- if (result.kind === 'scoped-refusal') {
1213
- const room = replicas.get(result.locator)?.confirmed.record;
1214
- if (room !== undefined)
1215
- await scoped(result, room, await openLocal());
1216
- }
1217
- if (result.kind === 'revoked-authorization')
1218
- await refuse('revoked-authorization');
1219
- journal.record(`outcome action ${result.kind}`);
1220
- if (result.kind === 'rejected')
1221
- journal.record(`refusal rejected ${result.code}`);
1222
- return calledResult(result);
1223
- }
1224
- catch {
1225
- journal.record('outcome action transport-uncertainty');
1226
- return UNCERTAIN;
1227
- }
1228
- }
1229
- function continuing() {
1230
- return !closed && !discoveryPaused;
1231
- }
1232
- function reachedBy(locator, roomVersion) {
1233
- const held = replicas.get(locator);
1234
- return (held !== undefined &&
1235
- options.adapter.reached(locator, held.confirmed.record.roomVersion, roomVersion));
1236
- }
1237
- function writtenAfter(locator, roomVersion, path) {
1238
- const written = replicas.get(locator)?.confirmed.record.written[path];
1239
- return (written !== undefined &&
1240
- options.adapter.reached(locator, written, roomVersion) &&
1241
- !options.adapter.reached(locator, roomVersion, written));
1242
- }
1243
- async function pullRefresh(authorized, confirmed) {
1244
- if (!continuing())
1245
- return unconfirmed;
1246
- try {
1247
- const result = await refreshRoom(options.adapter, authorized, confirmed, (models, held) => remodel(confirmed.record.locator, models, held), continuing);
1248
- const detail = result.kind === 'advanced' ? result.confirmed.record.roomVersion : result.kind;
1249
- journal.record(`transfer refresh ${confirmed.record.locator} ${detail}`);
1250
- return result;
1251
- }
1252
- catch (error) {
1253
- journal.record(`transfer refresh ${confirmed.record.locator} transport-uncertainty`);
1254
- throw error;
1255
- }
1256
- }
1257
- function staging(local) {
1258
- return {
1259
- held: (locator) => transfers.get(locator) ?? null,
1260
- staged: (record) => local.staged(record),
1261
- stage: (record, page) => exclusive(async () => {
1262
- if (!continuing())
1263
- return false;
1264
- await local.stage(record, page);
1265
- transfers.set(record.locator, record);
1266
- return true;
1267
- }),
1268
- abandon: (locator) => exclusive(async () => {
1269
- if (!continuing())
1270
- return;
1271
- await local.abandon(locator);
1272
- transfers.delete(locator);
1273
- }),
1274
- };
1275
- }
1276
- async function pullBootstrap(authorized, room, local) {
1277
- if (!continuing())
1278
- return unconfirmed;
1279
- try {
1280
- const result = await bootstrapRoom(options.adapter, authorized, room, {
1281
- collection: modelOf(room.locator),
1282
- selection: modelOf(room.locator, 'typed-selection'),
1283
- }, (models, held) => remodel(room.locator, models, held), continuing, staging(local));
1284
- const detail = result.kind === 'staged' ? result.confirmed.record.roomVersion : result.kind;
1285
- journal.record(`transfer bootstrap ${room.locator} ${detail}`);
1286
- return result;
1287
- }
1288
- catch (error) {
1289
- journal.record(`transfer bootstrap ${room.locator} transport-uncertainty`);
1290
- throw error;
1291
- }
1292
- }
1293
- async function advance(room, local, authorized) {
1294
- const held = replicas.get(room.locator);
1295
- if (held !== undefined) {
1296
- const refreshed = await pullRefresh(authorized, held.confirmed);
1297
- if (!continuing())
1298
- return unconfirmed;
1299
- if (refreshed.kind === 'still-current') {
1300
- stale.delete(room.locator);
1301
- if (sourceRefusals.has(room.locator))
1302
- return null;
1303
- if (unreadable.delete(room.locator)) {
1304
- scopedRefusals.delete(room.locator);
1305
- list(room, true);
1306
- emitRooms();
30
+ const socket = createSocket(adapter, journal, options.authorization);
31
+ const store = createStore({
32
+ database: {
33
+ async ask(request) {
34
+ try {
35
+ return await options.database.ask(request);
1307
36
  }
1308
- return null;
1309
- }
1310
- if (refreshed.kind === 'advanced') {
1311
- if (!(await publish(local, room, refreshed.confirmed, { base: held.confirmed }))) {
1312
- const now = replicas.get(room.locator)?.confirmed.record.roomVersion;
1313
- const reached = now !== undefined &&
1314
- options.adapter.reached(room.locator, now, refreshed.confirmed.record.roomVersion);
1315
- return reached ? null : advance(room, local, authorized);
37
+ catch (error) {
38
+ if (refusedForSpace(error))
39
+ filled(runtime);
40
+ throw error;
1316
41
  }
1317
- await retainModel(local, room, 'collection', modelOf(room.locator));
1318
- return null;
1319
- }
1320
- if (refreshed.kind !== 'beyond-horizon')
1321
- return refreshed;
1322
- }
1323
- const bootstrapped = await pullBootstrap(authorized, room, local);
1324
- if (!continuing())
1325
- return unconfirmed;
1326
- if (bootstrapped.kind !== 'staged')
1327
- return bootstrapped;
1328
- await publish(local, room, bootstrapped.confirmed, { stored: bootstrapped.stored });
1329
- return null;
1330
- }
1331
- async function withhold(withheld, room, local, progress) {
1332
- if (withheld.kind === 'refused')
1333
- stale.delete(room.locator);
1334
- else
1335
- stale.add(room.locator);
1336
- if (withheld.kind === 'scoped-refusal') {
1337
- await scoped(withheld, room, local);
1338
- }
1339
- else if (withheld.kind === 'transport-uncertainty') {
1340
- progress.reachable = false;
1341
- }
1342
- else if (withheld.kind === 'retryable-refusal') {
1343
- journal.record(`refusal ${withheld.kind} ${withheld.code}`);
1344
- }
1345
- else if (withheld.kind === 'room-not-readable') {
1346
- unreadable.add(room.locator);
1347
- list(room, false);
1348
- emitRooms();
1349
- }
1350
- else if (withheld.kind === 'refused') {
1351
- refusedSource(room, withheld);
1352
- }
1353
- else if (withheld.kind === 'revoked-authorization') {
1354
- await refuse('revoked-authorization');
1355
- }
1356
- }
1357
- function refusedSource(room, { refusal }) {
1358
- sourceRefusals.set(room.locator, {
1359
- code: refusal.rule,
1360
- retryable: false,
1361
- fields: {
1362
- file: refusal.file,
1363
- ...(refusal.location === undefined ? {} : { location: refusal.location }),
1364
- ...(refusal.referrers === undefined ? {} : { referrers: refusal.referrers }),
1365
- },
1366
- });
1367
- declarationRefusals.delete(room.locator);
1368
- unreadable.add(room.locator);
1369
- list(room, false);
1370
- emitRooms();
1371
- journal.record(`source refused ${room.locator} ${refusal.rule} ${refusal.file}`);
1372
- }
1373
- function leaving(batch, result) {
1374
- if (result.kind === 'expired')
1375
- return { batch, returned: returnedBy('expired') };
1376
- return {
1377
- batch,
1378
- returned: {
1379
- kind: result.kind,
1380
- code: result.code,
1381
- fields: result.fields,
1382
- retryable: result.retryable,
1383
42
  },
1384
- };
1385
- }
1386
- function logAccepted(locator, submitted, accepted) {
1387
- journal.record(`outcome ${locator} ${submitted.id} accepted ${accepted.roomVersion}` +
1388
- (accepted.author === undefined ? '' : ` author ${accepted.author}`) +
1389
- (accepted.time === undefined ? '' : ` time ${accepted.time}`));
1390
- }
1391
- async function adoptAccepted(room, local, submitted, accepted) {
1392
- if (!continuing())
1393
- return unconfirmed;
1394
- const current = replicas.get(room.locator);
1395
- if (current === undefined || !current.queue.some((batch) => batch.id === submitted.id)) {
1396
- return null;
1397
- }
1398
- const held = current.confirmed.record.roomVersion;
1399
- logAccepted(room.locator, submitted, accepted);
1400
- const applied = options.adapter.reached(room.locator, held, accepted.roomVersion)
1401
- ? { kind: 'staged', confirmed: current.confirmed }
1402
- : applyReturned(current.confirmed, submitted, accepted, options.adapter.follows(room.locator, held, accepted.roomVersion)
1403
- ? accepted.roomVersion
1404
- : held, accepted.roomVersion);
1405
- if (applied.kind !== 'staged') {
1406
- const state = pendings.get(submitted.id);
1407
- await local.accept(room.locator, submitted.id, accepted.roomVersion);
1408
- if (state !== undefined && !fences.has(room.locator))
1409
- pendings.set(submitted.id, { ...state, accepted: accepted.roomVersion });
1410
- emitQueue(room.locator);
1411
- return applied;
1412
- }
1413
- const set = await settle(local, room.locator, current, applied.confirmed, current.queue.filter((batch) => batch.id !== submitted.id), { room: true });
1414
- pendings.delete(submitted.id);
1415
- unreadable.delete(room.locator);
1416
- sourceRefusals.delete(room.locator);
1417
- declarationRefusals.delete(room.locator);
1418
- list(room, true);
1419
- publishChangeSet(set);
1420
- moveTo({ ...status, ...attention() });
1421
- return null;
1422
- }
1423
- async function adopted(room, local, submitted, accepted) {
1424
- const failed = await exclusive(() => adoptAccepted(room, local, submitted, accepted));
1425
- if (failed === null)
1426
- return true;
1427
- if (failed.kind === 'refused' && continuing())
1428
- refusedSource(room, failed);
1429
- return false;
1430
- }
1431
- async function submitRoom(room, local, authorized, progress) {
1432
- while (continuing() && authorization !== undefined) {
1433
- const replica = replicas.get(room.locator);
1434
- const head = replica?.queue[0];
1435
- if (replica === undefined || head === undefined)
1436
- return;
1437
- if (pendings.get(head.id)?.accepted !== undefined)
1438
- return;
1439
- const state = pendings.get(head.id);
1440
- const { submission, lost: earlier } = state ?? {
1441
- submission: { state: 'waiting' },
1442
- lost: false,
1443
- };
1444
- if (submission.state === 'reset' && Date.now() < Date.parse(submission.reset)) {
1445
- progress.complete = false;
1446
- return;
1447
- }
1448
- if (writesHeld()) {
1449
- progress.complete = false;
1450
- journal.record(`submission ${room.locator} ${head.id} held`);
1451
- return;
1452
- }
1453
- const lost = earlier || submission.state === 'submitted';
1454
- let result;
1455
- journal.record(`submission ${room.locator} ${head.id}`);
1456
- await exclusive(() => mark(local, room.locator, head.id, { state: 'submitted' }, lost));
1457
- if (discoveryPaused || fences.has(room.locator))
1458
- return;
1459
- if (writesHeld()) {
1460
- await exclusive(() => mark(local, room.locator, head.id, submission, earlier));
1461
- progress.complete = false;
1462
- journal.record(`submission ${room.locator} ${head.id} held`);
1463
- return;
1464
- }
1465
- const opensBefore = openSignals;
1466
- const answered = awaitingAnswer(room.locator);
1467
- try {
1468
- result = await options.adapter.mutate(authorized, {
1469
- locator: room.locator,
1470
- changeBatch: head,
1471
- ...(state?.upload === undefined ? {} : { upload: state.upload }),
1472
- }, (upload) => exclusive(() => keepUpload(local, room.locator, head.id, upload)));
1473
- }
1474
- catch {
1475
- answered();
1476
- progress.complete = false;
1477
- if (continuing())
1478
- progress.reachable = false;
1479
- return;
1480
- }
1481
- if (result.kind !== 'accepted' || !continuing())
1482
- answered();
1483
- if (!continuing())
1484
- return;
1485
- if (result.kind === 'transport-uncertainty') {
1486
- progress.complete = false;
1487
- progress.reachable = false;
1488
- return;
1489
- }
1490
- if (result.kind === 'room-not-readable') {
1491
- progress.complete = false;
1492
- unreadable.add(room.locator);
1493
- list(room, false);
1494
- emitRooms();
1495
- return;
1496
- }
1497
- if (result.kind === 'revoked-authorization') {
1498
- await refuse('revoked-authorization');
1499
- return;
1500
- }
1501
- if (result.kind === 'scoped-refusal') {
1502
- await scoped(result, room, local);
1503
- progress.complete = false;
1504
- return;
1505
- }
1506
- if (result.kind === 'write-halted') {
1507
- journal.record(`outcome ${room.locator} ${head.id} write-halted`);
1508
- await exclusive(() => mark(local, room.locator, head.id, { state: 'waiting' }, lost));
1509
- if (serviceMode === 'open' && openSignals !== opensBefore)
1510
- continue;
1511
- haltedRefusal = true;
1512
- progress.complete = false;
1513
- return;
1514
- }
1515
- if (result.kind === 'conflicted' ||
1516
- result.kind === 'rejected' ||
1517
- result.kind === 'expired' ||
1518
- result.kind === 'retryable-refusal') {
1519
- if (result.kind === 'expired') {
1520
- const withheld = await advance(room, local, authorized);
1521
- if (withheld !== null)
1522
- return withhold(withheld, room, local, progress);
1523
- }
1524
- journal.record(`outcome ${room.locator} ${head.id} ${result.kind}` +
1525
- (result.kind === 'conflicted' && result.roomVersion !== undefined
1526
- ? ` ${result.roomVersion}`
1527
- : ''));
1528
- if (result.kind !== 'expired')
1529
- journal.record(`refusal ${result.kind} ${result.code}`);
1530
- }
1531
- if (result.kind === 'retryable-refusal') {
1532
- const reset = result.reset;
1533
- progress.complete = false;
1534
- await exclusive(() => mark(local, room.locator, head.id, reset === undefined ? { state: 'waiting' } : { state: 'reset', reset }, lost));
1535
- armTimer();
1536
- return;
1537
- }
1538
- if (result.kind === 'conflicted' || result.kind === 'rejected' || result.kind === 'expired') {
1539
- const left = leaving(head, result);
1540
- await exclusive(async () => {
1541
- if (!continuing())
1542
- return;
1543
- const current = replicas.get(room.locator);
1544
- if (current === undefined || !current.queue.some((batch) => batch.id === head.id)) {
1545
- return;
1546
- }
1547
- const set = await settle(local, room.locator, current, current.confirmed, current.queue.filter((batch) => batch.id !== head.id), {
1548
- leaving: (result.kind === 'expired' && landed(head, current.confirmed)) ||
1549
- (result.kind === 'conflicted' && landed(head, current.confirmed, result.affected))
1550
- ? { ...left, returned: null }
1551
- : left,
1552
- });
1553
- publishChangeSet(set);
1554
- moveTo({ ...status, ...attention() });
1555
- });
1556
- if (result.kind === 'expired')
1557
- continue;
1558
- const withheld = await advance(room, local, authorized);
1559
- if (withheld !== null)
1560
- return withhold(withheld, room, local, progress);
1561
- continue;
1562
- }
1563
- const kept = await adopted(room, local, head, result).finally(answered);
1564
- if (!kept) {
1565
- progress.complete = false;
1566
- return;
1567
- }
1568
- }
1569
- }
1570
- function awaitingAnswer(locator) {
1571
- let release = () => { };
1572
- const awaited = new Promise((resolve) => {
1573
- release = resolve;
1574
- });
1575
- answering.set(locator, awaited);
1576
- return () => {
1577
- if (answering.get(locator) === awaited)
1578
- answering.delete(locator);
1579
- release();
1580
- };
1581
- }
1582
- async function retainModel(local, room, attached, next) {
1583
- const key = modelKey(room.locator, attached);
1584
- const previous = modelOf(room.locator, attached);
1585
- const heldBefore = replicas.get(room.locator)?.confirmed.record;
1586
- if (JSON.stringify(previous) === JSON.stringify(next) &&
1587
- (heldBefore === undefined ||
1588
- (JSON.stringify(heldBefore.operations) === JSON.stringify(room.operations) &&
1589
- JSON.stringify(heldBefore.replica) === JSON.stringify(room.replica) &&
1590
- JSON.stringify(heldBefore.typedSelection) ===
1591
- JSON.stringify(room.typedSelection ?? null))))
1592
- return;
1593
- if (next.status === 'unavailable') {
1594
- invalidModels.add(key);
1595
- liveModels.delete(key);
1596
- }
1597
- await exclusive(async () => {
1598
- if (!continuing())
1599
- return;
1600
- const held = replicas.get(room.locator);
1601
- if (held !== undefined) {
1602
- const declared = {
1603
- ...held.confirmed.record,
1604
- operations: room.operations,
1605
- replica: room.replica,
1606
- typedSelection: room.typedSelection ?? null,
1607
- ...(attached === 'collection' ? { model: next } : { selectionModel: next }),
1608
- };
1609
- const reclassified = sameMembership(declared, held.confirmed.record)
1610
- ? { kind: 'staged', confirmed: confirmedOf(declared, held.confirmed) }
1611
- : readReclassified(declared, held.confirmed);
1612
- const record = reclassified.kind === 'staged'
1613
- ? declared
1614
- : {
1615
- ...declared,
1616
- typedSelection: held.confirmed.record.typedSelection,
1617
- };
1618
- const read = reclassified.kind === 'deferred'
1619
- ? { kind: 'staged', confirmed: confirmedOf(record, held.confirmed) }
1620
- : reclassified;
1621
- await local.write({ next: record, previous: held.confirmed.record });
1622
- if (read.kind === 'staged') {
1623
- replicas.set(room.locator, replicaOf(read.confirmed, held.queue, held));
1624
- if (declarationRefusals.delete(room.locator)) {
1625
- sourceRefusals.delete(room.locator);
1626
- unreadable.delete(room.locator);
1627
- }
1628
- }
1629
- else if (read.kind === 'refused') {
1630
- replicas.set(room.locator, { ...held, confirmed: { ...held.confirmed, record } });
1631
- refusedSource(room, read);
1632
- declarationRefusals.add(room.locator);
1633
- }
1634
- }
1635
- models.set(key, next);
1636
- if (next.status === 'current') {
1637
- liveModels.set(key, JSON.stringify(next.snapshot));
1638
- invalidModels.delete(key);
1639
- }
1640
- list(room, room.replica.admission === 'admitted' && !unreadable.has(room.locator));
1641
- if (held === undefined)
1642
- emitRooms();
1643
- else
1644
- publishChangeSet(changeSet(room.locator, held, replicas.get(room.locator) ?? null, { room: true }));
1645
- });
1646
- }
1647
- async function scoped(result, room, local) {
1648
- scopedRefusals.set(room.locator, {
1649
- code: result.code,
1650
- fields: result.fields,
1651
- retryable: result.retryable,
1652
- });
1653
- let scopedAway = room;
1654
- if (result.scope === 'model')
1655
- await retainModel(local, room, 'collection', {
1656
- status: 'unavailable',
1657
- reason: 'not-readable',
1658
- });
1659
- else if (result.scope !== 'operation') {
1660
- unreadable.add(room.locator);
1661
- scopedAway = {
1662
- ...room,
1663
- replica: { ...room.replica, admission: 'unavailable' },
1664
- operations: {
1665
- ...room.operations,
1666
- ...(result.scope === 'content' ? { read: [] } : {}),
1667
- ...(result.scope === 'sync' ? { sync: [] } : {}),
1668
- },
1669
- };
1670
- await retainModel(local, scopedAway, 'collection', modelOf(room.locator));
1671
- }
1672
- if (!continuing())
1673
- return;
1674
- list(scopedAway, scopedAway.replica.admission === 'admitted' && !unreadable.has(room.locator));
1675
- emitRooms();
1676
- journal.record(`scoped refusal ${room.locator} ${result.scope} ${result.code}`);
1677
- }
1678
- function heldRooms(listed) {
1679
- return listed.flatMap((room) => {
1680
- const record = replicas.get(room.locator)?.confirmed.record;
1681
- if (record === undefined || record.replica.selection !== room.replica.selection)
1682
- return [];
1683
- return [
1684
- {
1685
- locator: room.locator,
1686
- roomVersion: record.roomVersion,
1687
- documents: record.documents,
1688
- revisions: record.revisions,
1689
- },
1690
- ];
1691
- });
1692
- }
1693
- async function synchronize(listed, local, progress, attempt) {
1694
- const prepared = await Promise.allSettled(listed.map((room) => prepareRoom(room, local, progress)));
1695
- const ready = listed.filter((_, index) => {
1696
- const outcome = prepared[index];
1697
- return outcome?.status === 'fulfilled' && outcome.value;
1698
- });
1699
- if (attempt === 'opened') {
1700
- options.adapter.roomStream?.hold(heldRooms(ready));
1701
- handed = true;
1702
- }
1703
- const loaded = await Promise.allSettled(ready
1704
- .filter((room) => attempt === 'unstreamed' || !replicas.has(room.locator))
1705
- .map((room) => loadRoom(room, local, progress)));
1706
- const failed = [...prepared, ...loaded].find((room) => room.status === 'rejected');
1707
- if (failed !== undefined)
1708
- throw failed.reason;
1709
- }
1710
- async function prepareRoom(room, local, progress) {
1711
- if (closed || authorization === undefined) {
1712
- progress.complete = false;
1713
- return false;
1714
- }
1715
- const prior = replicas.get(room.locator)?.confirmed.record;
1716
- if (prior !== undefined && prior.replica.selection !== room.replica.selection) {
1717
- list(prior, false);
1718
- emitRooms();
1719
- journal.record(`selection changed ${room.locator}`);
1720
- progress.complete = false;
1721
- return false;
1722
- }
1723
- if (prior !== undefined)
1724
- await retainModel(local, room, 'collection', modelOf(room.locator));
1725
- if (discoveryPaused || authorization === undefined)
1726
- return false;
1727
- if (room.replica.admission !== 'admitted') {
1728
- if (replicas.has(room.locator))
1729
- progress.complete = false;
1730
- return false;
1731
- }
1732
- return true;
1733
- }
1734
- async function caughtUp(room, local, progress) {
1735
- const held = replicas.get(room.locator)?.confirmed.record.roomVersion;
1736
- if (held === undefined || authorization === undefined)
1737
- return;
1738
- const behind = [announced.get(room.locator), room.roomVersion].some((later) => later !== undefined && !options.adapter.reached(room.locator, held, later));
1739
- if (!behind)
1740
- return;
1741
- const withheld = await advance(room, local, authorization);
1742
- if (withheld !== null)
1743
- await withhold(withheld, room, local, progress);
1744
- }
1745
- function revoked(locator) {
1746
- return ['collection', 'typed-selection'].some((attached) => {
1747
- const model = modelOf(locator, attached);
1748
- return model.status === 'unavailable' && model.reason === 'revoked';
1749
- });
1750
- }
1751
- async function loadRoom(room, local, progress) {
1752
- if (discoveryPaused || authorization === undefined)
1753
- return;
1754
- if (replicas.has(room.locator) && revoked(room.locator)) {
1755
- await reload(room, local, progress);
1756
- return;
1757
- }
1758
- const withheld = await advance(room, local, authorization);
1759
- if (withheld !== null) {
1760
- await withhold(withheld, room, local, progress);
1761
- return;
1762
- }
1763
- await caughtUp(room, local, progress);
1764
- }
1765
- async function reload(room, local, progress) {
1766
- if (discoveryPaused || authorization === undefined)
1767
- return;
1768
- const bootstrapped = await pullBootstrap(authorization, room, local);
1769
- if (!continuing())
1770
- return;
1771
- if (bootstrapped.kind !== 'staged') {
1772
- await withhold(bootstrapped, room, local, progress);
1773
- return;
1774
- }
1775
- await publish(local, room, bootstrapped.confirmed, { stored: bootstrapped.stored });
1776
- await caughtUp(room, local, progress);
1777
- }
1778
- async function discoverRooms(local, progress, attempt) {
1779
- if (closed || authorization === undefined) {
1780
- notifyReady();
1781
- return;
1782
- }
1783
- moveTo(transferring(status));
1784
- discoveries += 1;
1785
- const started = discoveries;
1786
- let result;
1787
- try {
1788
- result = await options.adapter.discover(authorization);
1789
- }
1790
- catch {
1791
- result = { kind: 'transport-uncertainty' };
1792
- }
1793
- if (closed) {
1794
- notifyReady();
1795
- return;
1796
- }
1797
- journal.record(`connection discover ${result.kind}`);
1798
- if (result.kind === 'transport-uncertainty') {
1799
- for (const room of rooms.values()) {
1800
- await retainModel(local, room, 'collection', cached(modelOf(room.locator)));
1801
- if (room.typedSelection !== null) {
1802
- await retainModel(local, room, 'typed-selection', cached(modelOf(room.locator, 'typed-selection')));
1803
- }
1804
- }
1805
- progress.reachable = false;
1806
- progress.complete = false;
1807
- notifyReady();
1808
- return;
1809
- }
1810
- if (result.kind === 'contract-unavailable') {
1811
- journal.record(`connection contract unavailable ${result.code}`);
1812
- await refuse('missing-required-guarantee', {
1813
- code: result.code,
1814
- fields: result.fields,
1815
- retryable: result.retryable,
1816
- });
1817
- notifyReady();
1818
- return;
1819
- }
1820
- if (result.kind === 'revoked-authorization') {
1821
- await refuse('revoked-authorization');
1822
- notifyReady();
1823
- return;
1824
- }
1825
- for (const room of result.rooms) {
1826
- if (room.operations === undefined ||
1827
- !['read', 'sync', 'write', 'delete'].every((operation) => Array.isArray(room.operations[operation]) &&
1828
- room.operations[operation].every((scope) => typeof scope === 'string')) ||
1829
- room.replica === undefined ||
1830
- typeof room.replica.selection !== 'string' ||
1831
- room.replica.selection.length === 0 ||
1832
- !['admitted', 'unavailable'].includes(room.replica.admission)) {
1833
- journal.record(`invalid model or replica declaration ${room.locator}`);
1834
- await refuse('missing-required-guarantee');
1835
- notifyReady();
1836
- return;
1837
- }
1838
- if (!declaredSelection(room)) {
1839
- journal.record(`invalid typed selection declaration ${room.locator}`);
1840
- await refuse('missing-required-guarantee');
1841
- notifyReady();
1842
- return;
1843
- }
1844
- }
1845
- if (refusal !== null) {
1846
- refusal = null;
1847
- emitRefusal();
1848
- }
1849
- const previousCapabilities = capabilities;
1850
- capabilities = result.capabilities;
1851
- notifyReady();
1852
- if (JSON.stringify(result.providerLimits) !== JSON.stringify(limits) ||
1853
- JSON.stringify(result.capabilities) !== JSON.stringify(previousCapabilities)) {
1854
- limits = result.providerLimits;
1855
- await local.declare(limits, capabilities);
1856
- }
1857
- const signedIn = result.member ?? null;
1858
- if (JSON.stringify(signedIn) !== JSON.stringify(member)) {
1859
- await local.keepMember(signedIn);
1860
- member = signedIn;
1861
- emitMember();
1862
- }
1863
- await synchronize(await applyDiscovery(result.rooms, started), local, progress, attempt);
1864
- }
1865
- async function ensureAuthorization() {
1866
- if (authorization !== undefined)
1867
- return;
1868
- try {
1869
- authorization = await options.adapter.authorize();
1870
- journal.record('connection authorize');
1871
- }
1872
- catch (error) {
1873
- journal.record('connection authorize transport-uncertainty');
1874
- throw error;
1875
- }
1876
- }
1877
- function task(work) {
1878
- if (stopping)
1879
- return chain;
1880
- chain = chain.then(work, work).catch(() => undefined);
1881
- return chain;
1882
- }
1883
- function sync(attempt) {
1884
- return task(async () => {
1885
- if (closed || stopping || discoveryPaused) {
1886
- notifyReady();
1887
- return;
1888
- }
1889
- const progress = { complete: true, reachable: true };
1890
- underway = attempt === 'opened' ? progress : null;
1891
- if (attempt === 'opened')
1892
- streamed = progress;
1893
- complete = false;
1894
- recorded = false;
1895
- moveTo(transferring(status));
1896
- handed = false;
1897
- try {
1898
- const local = await openLocal();
1899
- if (closed)
1900
- return;
1901
- await ensureAuthorization();
1902
- if (closed)
1903
- return;
1904
- await discoverRooms(local, progress, attempt);
1905
- }
1906
- catch {
1907
- progress.complete = false;
1908
- if (attempt === 'opened' && !handed)
1909
- progress.reachable = false;
1910
- }
1911
- finally {
1912
- notifyReady();
1913
- }
1914
- if (attempt !== 'opened') {
1915
- await finishOpening(progress);
1916
- return;
1917
- }
1918
- if (handed || closed || progress.reachable)
1919
- return;
1920
- underway = null;
1921
- journal.record('connection reopen');
1922
- await rest(progress);
1923
- options.adapter.roomStream?.reopen();
1924
- });
1925
- }
1926
- function closedSocket(revoked) {
1927
- const opened = socketOpen;
1928
- socketOpen = false;
1929
- if (revoked) {
1930
- void refuse('revoked-authorization');
1931
- return;
1932
- }
1933
- complete = false;
1934
- if (streamed !== null)
1935
- streamed.complete = false;
1936
- moveTo({
1937
- ...status,
1938
- state: status.state === 'synced' ? 'syncing' : status.state,
1939
- providerUnreachable: status.providerUnreachable || !opened,
1940
- });
1941
- }
1942
- function applyOpening(expired) {
1943
- return task(async () => {
1944
- const progress = underway;
1945
- underway = null;
1946
- if (closed || stopping)
1947
- return;
1948
- if (progress === null) {
1949
- await reloadExpired(expired);
1950
- return;
1951
- }
1952
- try {
1953
- const local = await openLocal();
1954
- const held = [...discovered.values()].filter((room) => replicas.has(room.locator));
1955
- const reloading = held.filter((room) => expired.includes(room.locator) || revoked(room.locator));
1956
- const reloaded = await Promise.allSettled(reloading.map((room) => reload(room, local, progress)));
1957
- if (progress.reachable) {
1958
- for (const room of held)
1959
- if (!reloading.includes(room))
1960
- await confirmModels(room, local);
1961
- }
1962
- const failed = reloaded.find((outcome) => outcome.status === 'rejected');
1963
- if (failed !== undefined)
1964
- throw failed.reason;
1965
- }
1966
- catch {
1967
- progress.complete = false;
1968
- progress.reachable = false;
1969
- }
1970
- await finishOpening(progress);
1971
- });
1972
- }
1973
- async function reloadExpired(expired) {
1974
- const progress = { complete: true, reachable: true };
1975
- try {
1976
- const local = await openLocal();
1977
- await Promise.allSettled([...discovered.values()]
1978
- .filter((room) => replicas.has(room.locator) && expired.includes(room.locator))
1979
- .map((room) => reload(room, local, progress)));
1980
- }
1981
- catch {
1982
- progress.reachable = false;
1983
- }
1984
- await rest(progress);
1985
- }
1986
- async function confirmModels(room, local) {
1987
- for (const attached of ['collection', 'typed-selection']) {
1988
- const model = modelOf(room.locator, attached);
1989
- if (model.status === 'cached') {
1990
- await retainModel(local, room, attached, { ...model, status: 'current' });
1991
- }
1992
- }
1993
- }
1994
- function submitLater(locator) {
1995
- if (localSaves)
1996
- return;
1997
- const running = submitting.get(locator);
1998
- if (running !== undefined) {
1999
- running.again = true;
2000
- return;
2001
- }
2002
- const run = { again: false, done: Promise.resolve() };
2003
- submitting.set(locator, run);
2004
- run.done = (async () => {
2005
- try {
2006
- do {
2007
- run.again = false;
2008
- const room = discovered.get(locator);
2009
- if (closed || stopping || discoveryPaused || room === undefined)
2010
- return;
2011
- const progress = { complete: true, reachable: true };
2012
- try {
2013
- await ensureAuthorization();
2014
- if (authorization === undefined)
2015
- return;
2016
- await submitRoom(room, await openLocal(), authorization, progress);
2017
- }
2018
- catch {
2019
- progress.reachable = false;
2020
- }
2021
- armTimer();
2022
- await rest(progress);
2023
- } while (run.again);
2024
- }
2025
- finally {
2026
- submitting.delete(locator);
2027
- }
2028
- })();
2029
- }
2030
- function submitAll() {
2031
- for (const [locator, replica] of replicas) {
2032
- if (replica.queue.length > 0)
2033
- submitLater(locator);
2034
- }
2035
- }
2036
- async function finishOpening(progress) {
2037
- try {
2038
- if (closed || discoveryPaused) {
2039
- progress.complete = false;
2040
- return;
2041
- }
2042
- submitAll();
2043
- await conversations.reconcile();
2044
- if (status.providerUnreachable)
2045
- conversations.reconnected();
2046
- const reading = { complete: true, reachable: true };
2047
- await conversations.catchUp(reading);
2048
- if (progress.reachable && reading.reachable)
2049
- await conversations.resend(reading);
2050
- if (!reading.reachable)
2051
- progress.reachable = false;
2052
- }
2053
- catch {
2054
- progress.complete = false;
2055
- }
2056
- finally {
2057
- complete = progress.complete;
2058
- await rest(progress);
2059
- }
2060
- }
2061
- async function rest(progress) {
2062
- if (closed)
2063
- return;
2064
- let lastCompleted = status.lastCompleted;
2065
- let synced = complete && stale.size === 0 && !pending();
2066
- if (synced && !recorded) {
2067
- const completedAt = new Date().toISOString();
2068
- try {
2069
- await (await openLocal()).complete(completedAt);
2070
- recorded = true;
2071
- lastCompleted = completedAt;
2072
- }
2073
- catch {
2074
- synced = false;
2075
- }
2076
- }
2077
- moveTo({
2078
- state: pending() ? 'pending' : synced && complete ? 'synced' : 'syncing',
2079
- lastCompleted,
2080
- providerUnreachable: !progress.reachable,
2081
- ...attention(),
2082
- });
2083
- }
2084
- function applyRoom(locator, roomVersion) {
2085
- announced.set(locator, roomVersion);
2086
- return task(async () => {
2087
- await answering.get(locator);
2088
- if (closed || stopping || discoveryPaused || authorization === undefined)
2089
- return;
2090
- const room = discovered.get(locator);
2091
- const held = replicas.get(locator);
2092
- if (room === undefined || room.replica.admission !== 'admitted')
2093
- return;
2094
- if (held !== undefined &&
2095
- (held.confirmed.record.replica.selection !== room.replica.selection ||
2096
- options.adapter.reached(locator, held.confirmed.record.roomVersion, roomVersion))) {
2097
- return;
2098
- }
2099
- const during = underway;
2100
- const progress = during ?? { complete: true, reachable: true };
2101
- if (during === null)
2102
- moveTo(transferring(status));
2103
- try {
2104
- const local = await openLocal();
2105
- const withheld = await advance(room, local, authorization);
2106
- if (withheld !== null)
2107
- await withhold(withheld, room, local, progress);
2108
- }
2109
- catch {
2110
- stale.add(locator);
2111
- }
2112
- finally {
2113
- if (during === null)
2114
- await rest(progress);
2115
- }
2116
- });
2117
- }
2118
- function observeStream() {
2119
- const stream = options.adapter.roomStream;
2120
- if (stream === undefined || withdrawStream !== undefined)
2121
- return;
2122
- withdrawStream = stream.observe((event) => {
2123
- if (closed || stopping)
2124
- return;
2125
- if (event.kind === 'opened') {
2126
- socketOpen = true;
2127
- void sync('opened');
2128
- }
2129
- else if (event.kind === 'closed')
2130
- closedSocket(event.revoked);
2131
- else if (event.kind === 'opening')
2132
- void applyOpening(event.expired);
2133
- else
2134
- void applyRoom(event.locator, event.roomVersion);
2135
- });
2136
- }
2137
- function writesHeld() {
2138
- return serviceMode === 'write-halted' || haltedRefusal;
2139
- }
2140
- function signalled(mode) {
2141
- if (closed)
2142
- return;
2143
- if (mode === 'open')
2144
- openSignals += 1;
2145
- const releasing = mode === 'open' && (haltedRefusal || serviceMode === 'write-halted');
2146
- if (mode === 'open')
2147
- haltedRefusal = false;
2148
- if (mode !== serviceMode) {
2149
- serviceMode = mode;
2150
- journal.record(`service mode ${mode}`);
2151
- for (const listener of serviceModeListeners)
2152
- listener(mode);
2153
- }
2154
- if (releasing)
2155
- submitAll();
2156
- }
2157
- function observeConversations() {
2158
- const stream = options.adapter.conversations;
2159
- if (stream === undefined || withdrawConversations !== undefined)
2160
- return;
2161
- withdrawConversations = stream.observe((event) => {
2162
- if (conversations.receive(event)) {
2163
- void ready.then(scheduleCurrency);
2164
- return;
2165
- }
2166
- if (event.kind !== 'gap' || conversations.current())
2167
- return;
2168
- show();
2169
- scheduleCurrency();
2170
- });
2171
- }
2172
- function scheduleCurrency() {
2173
- if (currencyQueued || closed || stopping)
2174
- return;
2175
- currencyQueued = true;
2176
- void task(runCurrency);
2177
- }
2178
- async function runCurrency() {
2179
- currencyQueued = false;
2180
- if (closed || stopping || discoveryPaused)
2181
- return;
2182
- await conversations.reconcile();
2183
- if (conversations.current()) {
2184
- show();
2185
- return;
2186
- }
2187
- const progress = { complete: false, reachable: !status.providerUnreachable };
2188
- moveTo(transferring(status));
2189
- try {
2190
- await conversations.catchUp(progress);
2191
- }
2192
- catch {
2193
- progress.reachable = false;
2194
- }
2195
- await rest(progress);
2196
- }
2197
- function close() {
2198
- if (closed)
2199
- return;
2200
- closed = true;
2201
- withdrawStream?.();
2202
- withdrawStream = undefined;
2203
- withdrawConversations?.();
2204
- withdrawConversations = undefined;
2205
- withdrawServiceMode?.();
2206
- conversations.close();
2207
- stopTimer();
2208
- store?.close();
2209
- void opening?.then((opened) => {
2210
- opened.close();
2211
- }, () => { });
2212
- roomListeners.clear();
2213
- refusalListeners.clear();
2214
- storageLossListeners.clear();
2215
- statusListeners.clear();
2216
- serviceModeListeners.clear();
2217
- memberListeners.clear();
2218
- readSide.close();
2219
- queueSubscriptions.clear();
2220
- roomDraftListeners.clear();
2221
- presentationListeners.clear();
2222
- }
2223
- async function stop() {
2224
- stopping = true;
2225
- stopTimer();
2226
- await chain.catch(() => undefined);
2227
- await Promise.all([...submitting.values()].map((run) => run.done));
2228
- await mutations;
2229
- close();
2230
- }
2231
- const withdrawServiceMode = options.adapter.serviceMode?.observe(signalled);
2232
- observeConversations();
2233
- options.signal?.addEventListener('abort', close, { once: true });
2234
- if (options.signal?.aborted)
2235
- close();
2236
- observeStream();
2237
- void openLocal().then(() => {
2238
- if (capabilities.length > 0)
2239
- notifyReady();
2240
- }, () => {
2241
- notifyReady();
2242
- });
2243
- if (options.adapter.roomStream === undefined)
2244
- void sync('unstreamed');
2245
- function planned(input, reach) {
2246
- return planOf(input, roomFacts(reach), planReach(reach));
2247
- }
2248
- function watchPlan(plan, deliver) {
2249
- materialize(reachedRooms(plan));
2250
- return readSide.watch(plan, identityOf(plan), deliver);
2251
- }
2252
- async function searched(input, reach) {
2253
- const plan = searchPlanOf(input);
2254
- const selected = plan.documents === undefined && reach === null
2255
- ? null
2256
- : (await rowsQuery(filterOf(plan.documents ?? {}, roomFacts(reach), planReach(reach)))).documents;
2257
- if (selected === null)
2258
- materialize(null);
2259
- return searchIndex.search(reach === null || reach.conversations ? plan : { ...plan, conversations: [] }, selected);
2260
- }
2261
- const watch = (topic, input, deliver) => {
2262
- if (topic === 'room-drafts') {
2263
- const listener = { notify: deliver, ready: false };
2264
- roomDraftListeners.add(listener);
2265
- void exclusive(async () => {
2266
- await openLocal();
2267
- if (closed || !roomDraftListeners.has(listener))
2268
- return;
2269
- listener.ready = true;
2270
- }).then(() => {
2271
- if (closed || !listener.ready || !roomDraftListeners.has(listener))
2272
- return;
2273
- listener.notify(snapshotRoomDrafts());
2274
- }, () => { });
2275
- return () => {
2276
- roomDraftListeners.delete(listener);
2277
- };
2278
- }
2279
- if (topic === 'conversation') {
2280
- return conversations.watch(input[0], input[1], deliver);
2281
- }
2282
- if (topic === 'conversations')
2283
- return conversations.watchList(deliver);
2284
- if (topic === 'agents')
2285
- return conversations.watchAgents(deliver);
2286
- if (topic === 'presentation') {
2287
- const listener = {
2288
- app: input[0],
2289
- notify: deliver,
2290
- ready: false,
2291
- };
2292
- presentationListeners.add(listener);
2293
- void exclusive(async () => {
2294
- await openLocal();
2295
- }).then(() => {
2296
- if (closed || !presentationListeners.has(listener))
2297
- return;
2298
- listener.ready = true;
2299
- listener.notify(presentationOf(listener.app));
2300
- }, () => { });
2301
- return () => {
2302
- presentationListeners.delete(listener);
2303
- };
2304
- }
2305
- if (topic === 'rooms') {
2306
- roomListeners.add(deliver);
2307
- deliver(listed());
2308
- return () => {
2309
- roomListeners.delete(deliver);
2310
- };
2311
- }
2312
- if (topic === 'connection-refusal') {
2313
- refusalListeners.add(deliver);
2314
- deliver(refusal);
2315
- return () => {
2316
- refusalListeners.delete(deliver);
2317
- };
2318
- }
2319
- if (topic === 'storage-loss') {
2320
- storageLossListeners.add(deliver);
2321
- deliver(storageLoss);
2322
- return () => {
2323
- storageLossListeners.delete(deliver);
2324
- };
2325
- }
2326
- if (topic === 'sync-status') {
2327
- statusListeners.add(deliver);
2328
- deliver(shown);
2329
- return () => {
2330
- statusListeners.delete(deliver);
2331
- };
2332
- }
2333
- if (topic === 'service-mode') {
2334
- serviceModeListeners.add(deliver);
2335
- deliver(serviceMode);
2336
- return () => {
2337
- serviceModeListeners.delete(deliver);
2338
- };
2339
- }
2340
- if (topic === 'member') {
2341
- memberListeners.add(deliver);
2342
- deliver(member);
2343
- return () => {
2344
- memberListeners.delete(deliver);
2345
- };
2346
- }
2347
- if (topic === 'queue') {
2348
- const queue = { locator: input[0], notify: deliver };
2349
- queueSubscriptions.add(queue);
2350
- queue.notify(entriesOf(queue.locator));
2351
- return () => {
2352
- queueSubscriptions.delete(queue);
2353
- };
2354
- }
2355
- return watchPlan(planned(input[0], null), deliver);
2356
- };
2357
- const md = {
2358
- loaded() {
2359
- return openLocal().then(() => undefined);
2360
- },
2361
- rooms() {
2362
- return listed();
2363
- },
2364
- query: ((input) => rowsQuery(planned(input, null))),
2365
- search: (input) => searched(input, null),
2366
- types(locator) {
2367
- return {
2368
- collection: modelTypes(modelOf(locator)),
2369
- typedSelection: rooms.get(locator)?.typedSelection === undefined ||
2370
- rooms.get(locator)?.typedSelection === null
2371
- ? null
2372
- : modelTypes(modelOf(locator, 'typed-selection')),
2373
- };
2374
43
  },
2375
- roomDraft: {
2376
- list() {
2377
- return exclusive(async () => {
2378
- await openLocal();
2379
- return snapshotRoomDrafts();
2380
- }).then((listed) => {
2381
- publishRoomDrafts(true);
2382
- return listed;
2383
- });
2384
- },
2385
- read(room, path) {
2386
- const record = roomDrafts.get(room)?.get(path);
2387
- return record === undefined ? null : roomDraftOf(record);
2388
- },
2389
- write(room, path, revision, input) {
2390
- return exclusive(async () => {
2391
- const parts = readParts(input);
2392
- if (path === '' || normalize(path) !== path)
2393
- throw runtimeError('room-draft-malformed');
2394
- const local = await openLocal();
2395
- const current = roomDrafts.get(room)?.get(path);
2396
- if ((current?.revision ?? null) !== revision) {
2397
- return staleWrite(current === undefined ? null : roomDraftOf(current));
2398
- }
2399
- const file = parts.file === undefined
2400
- ? undefined
2401
- : await heldFile(parts.file.blob, binaryBase(replicas.get(room)?.visible, path));
2402
- const record = {
2403
- locator: room,
2404
- path,
2405
- revision: roomDraftRevision(),
2406
- parts: held(current?.parts, parts, file),
2407
- returned: current?.returned ?? null,
2408
- };
2409
- await local.keepRoomDraft(record);
2410
- rememberRoomDraft(record);
2411
- publishChangeSet(changeSet(room, null, null, { drafts: [path] }));
2412
- return { outcome: 'written', roomDraft: roomDraftOf(record) };
2413
- });
2414
- },
2415
- discard(room, path, revision) {
2416
- return exclusive(async () => {
2417
- const local = await openLocal();
2418
- const current = roomDrafts.get(room)?.get(path);
2419
- if (current === undefined || current.revision !== revision) {
2420
- return staleWrite(current === undefined ? null : roomDraftOf(current));
2421
- }
2422
- await local.discardRoomDraft(room, path);
2423
- forgetRoomDraft(room, path);
2424
- publishChangeSet(changeSet(room, null, null, { drafts: [path] }));
2425
- moveTo({ ...status, ...attention() });
2426
- return { outcome: 'written', roomDraft: null };
2427
- });
2428
- },
44
+ roomTypes,
45
+ builtIn,
46
+ typedPaths,
47
+ persistence: shell.persistence,
48
+ opening: (local) => open(runtime, local),
49
+ unpublished(error) {
50
+ journal.record(`publication failed ${error instanceof Error ? error.name : 'unknown'}`);
51
+ uncaught(error);
2429
52
  },
2430
- conversation: conversations.surface,
2431
- chatDraft: conversations.chatDraft,
2432
- presentation: {
2433
- read(app) {
2434
- return exclusive(async () => {
2435
- await openLocal();
2436
- return presentationOf(app);
2437
- });
53
+ changed: (set) => publishChangeSet(runtime, set),
54
+ deliverReadiness: (owed) => deliverOwedReadiness(runtime, owed),
55
+ spaceFreed: () => spaceFreed(runtime),
56
+ });
57
+ const recovery = (options.recovery ?? createRecovery()).scope(ROOM_ATTEMPTS);
58
+ const runtime = {
59
+ store,
60
+ socket,
61
+ journal,
62
+ recovery,
63
+ shell,
64
+ localSaves: adapter.localSaves === true,
65
+ roomTypes,
66
+ builtIn,
67
+ typedPaths,
68
+ pathRule: adapter.pathRule ?? (() => true),
69
+ usableWhenHeld: options.usableWhenHeld ?? [],
70
+ build: options.build ?? '',
71
+ conversations: createLiveConversations({
72
+ call: (name, input) => invokeAction(runtime, name, input),
73
+ history: (request) => readConversationHistory(runtime, request),
74
+ durably: store.durably,
75
+ local: store.open,
76
+ again: () => {
77
+ void socket.ready.then(() => scheduleCurrency(runtime));
2438
78
  },
2439
- write(app, value) {
2440
- return exclusive(async () => {
2441
- const local = await openLocal();
2442
- const stored = structuredClone(value);
2443
- await local.present({ app, value: stored });
2444
- presentations.set(app, stored);
2445
- publishChangeSet(changeSet('', null, null, { presentation: app }));
2446
- });
79
+ settled: () => {
80
+ show(runtime);
2447
81
  },
2448
- },
2449
- save(room, named, writtenBy) {
2450
- return exclusive(() => saveRoomDrafts(room, named, writtenBy));
2451
- },
2452
- history(locator, path, query) {
2453
- return readHistory(locator, path, query);
2454
- },
2455
- binaryFile: {
2456
- read: readBinaryPath,
2457
- readReference: readBinaryReference,
2458
- },
2459
- call(name, input) {
2460
- return invokeAction(name, input);
2461
- },
2462
- reached(locator, roomVersion, path) {
2463
- return path === undefined
2464
- ? reachedBy(locator, roomVersion)
2465
- : writtenAfter(locator, roomVersion, path);
2466
- },
2467
- log() {
2468
- return journal.export();
2469
- },
2470
- persistence() {
2471
- return options.shell.persistentStorage;
2472
- },
2473
- observe: observing(watch),
2474
- async reauthorize() {
2475
- if (refusal === null || !refusal.reauthorizationOffered)
2476
- return;
2477
- journal.record('connection reauthorize');
2478
- await chain.catch(() => undefined);
2479
- await mutations;
2480
- authorization = undefined;
2481
- discoveryPaused = false;
2482
- if (options.adapter.roomStream === undefined)
2483
- await sync('unstreamed');
2484
- else
2485
- await task(ensureAuthorization);
2486
- },
2487
- };
2488
- const reachable = {
2489
- md,
2490
- watch,
2491
- referrerScope: (referrer) => options.adapter.referrerScope(referrer),
2492
- plan: planned,
2493
- query: (plan) => rowsQuery(plan),
2494
- watchPlan,
2495
- search: searched,
82
+ stream: socket.conversations,
83
+ publish: store.changed,
84
+ online: socket.reached,
85
+ full: store.space.full,
86
+ closed: socket.closed,
87
+ unanswered: () => resendLater(runtime),
88
+ recovery: recovery.scope(),
89
+ }),
90
+ liveQueries: createLiveQueries((plan, cover) => answeredPlan(runtime, plan, cover), store.covering),
91
+ figures: createFigures({
92
+ cover: () => figuresCover(runtime),
93
+ rooms: (rooms, since) => roomTallies(runtime, rooms, since),
94
+ conversations: (conversations, since) => store.ask({ kind: 'conversation.tallies', conversations, since }),
95
+ }),
96
+ lastAnswers: readAnswers({
97
+ database: store,
98
+ build: options.build ?? '',
99
+ unkept: adapter.unkeptReads ?? [],
100
+ leading: adapter.leadingReads ?? [],
101
+ recovery: recovery.scope(),
102
+ call: (name, input) => called(runtime, name, input),
103
+ online: socket.reached,
104
+ streaming: socket.isOpen,
105
+ closed: socket.closed,
106
+ full: store.space.full,
107
+ filled: () => filled(runtime),
108
+ }),
109
+ settle: (...held) => settle(runtime, ...held),
110
+ scoped: (...held) => scoped(runtime, ...held),
111
+ submitLater: (locator) => submitLater(runtime, locator),
112
+ unpair: (local) => unpair(runtime, local),
113
+ advanced: (...held) => advanced(runtime, ...held),
114
+ withhold: (...held) => withhold(runtime, ...held),
2496
115
  };
2497
- return { md, stop, lose: loseRooms, watch, within: (reach) => narrowed(reachable, reach) };
116
+ start(runtime, options.signal);
117
+ return composedRuntime(runtime);
2498
118
  }