@qvac/core 1.0.0-rc.1 → 1.0.0-rc.3

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 (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -0,0 +1,38 @@
1
+ import type HyperDB from 'hyperdb';
2
+ export declare const RUN_LOG_RETENTION_MS: number;
3
+ type Locked = <T>(fn: () => Promise<T>) => Promise<T>;
4
+ export interface RunLogStep {
5
+ readonly seq: number;
6
+ readonly expectedLength: number;
7
+ readonly records: ReadonlyArray<unknown>;
8
+ }
9
+ export interface RunLogLease {
10
+ readonly generation: string;
11
+ readonly digestKey: Buffer;
12
+ readonly steps: RunLogStep[];
13
+ }
14
+ export interface RunLogKey {
15
+ readonly meshKey: Buffer;
16
+ readonly runId: string;
17
+ }
18
+ export interface RunLogAppend extends RunLogKey {
19
+ readonly generation: string;
20
+ readonly step: RunLogStep;
21
+ }
22
+ export interface RunLogRelease extends RunLogKey {
23
+ readonly generation: string;
24
+ }
25
+ export declare class LocalRunLogs {
26
+ private readonly _db;
27
+ private readonly _locked;
28
+ constructor(db: HyperDB, locked: Locked);
29
+ begin({ meshKey, runId }: RunLogKey, now?: number): Promise<RunLogLease>;
30
+ append({ meshKey, runId, generation, step }: RunLogAppend, now?: number): Promise<void>;
31
+ release({ meshKey, runId, generation }: RunLogRelease, now?: number): Promise<void>;
32
+ drop(key: RunLogKey): Promise<void>;
33
+ sweep(now?: number): Promise<number>;
34
+ private _live;
35
+ private _steps;
36
+ }
37
+ export declare function isRunLogStep(value: unknown): value is RunLogStep;
38
+ export {};
@@ -0,0 +1,132 @@
1
+ import crypto from 'hypercore-crypto';
2
+ import b4a from 'b4a';
3
+ import { LOCAL_RUN_LOGS, LOCAL_RUN_LOG_STEPS } from '../collections.js';
4
+ import { CoreError } from '../../errors.js';
5
+ import { isRecord } from '../../guards.js';
6
+ export const RUN_LOG_RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
7
+ export class LocalRunLogs {
8
+ _db;
9
+ _locked;
10
+ constructor(db, locked) {
11
+ this._db = db;
12
+ this._locked = locked;
13
+ }
14
+ begin({ meshKey, runId }, now = Date.now()) {
15
+ return this._locked(async () => {
16
+ const cursor = await this._db.get(LOCAL_RUN_LOGS, { meshKey, runId });
17
+ const generation = b4a.toHex(crypto.randomBytes(16));
18
+ const row = cursor
19
+ ? { ...cursor, generation, updatedAt: now }
20
+ : {
21
+ meshKey,
22
+ runId,
23
+ generation,
24
+ nextSeq: 0,
25
+ length: 0,
26
+ digestKey: crypto.randomBytes(32),
27
+ updatedAt: now
28
+ };
29
+ const tx = this._db.transaction();
30
+ await tx.insert(LOCAL_RUN_LOGS, row);
31
+ await tx.flush();
32
+ const steps = cursor ? await this._steps({ meshKey, runId }) : [];
33
+ return { generation, digestKey: row.digestKey, steps };
34
+ });
35
+ }
36
+ append({ meshKey, runId, generation, step }, now = Date.now()) {
37
+ return this._locked(async () => {
38
+ const cursor = await this._live({ meshKey, runId, generation });
39
+ if (step.seq !== cursor.nextSeq || step.expectedLength !== cursor.length) {
40
+ throw new CoreError('RUN_LOG_STEP_OUT_OF_ORDER', [runId, cursor.nextSeq]);
41
+ }
42
+ const tx = this._db.transaction();
43
+ await tx.insert(LOCAL_RUN_LOG_STEPS, {
44
+ meshKey,
45
+ runId,
46
+ seq: step.seq,
47
+ step
48
+ });
49
+ await tx.insert(LOCAL_RUN_LOGS, {
50
+ ...cursor,
51
+ nextSeq: cursor.nextSeq + 1,
52
+ length: cursor.length + step.records.length,
53
+ updatedAt: now
54
+ });
55
+ await tx.flush();
56
+ });
57
+ }
58
+ release({ meshKey, runId, generation }, now = Date.now()) {
59
+ return this._locked(async () => {
60
+ const cursor = await this._db.get(LOCAL_RUN_LOGS, { meshKey, runId });
61
+ if (!cursor?.generation) {
62
+ return;
63
+ }
64
+ if (cursor.generation !== generation) {
65
+ throw new CoreError('RUN_LOG_STALE_GENERATION', [runId]);
66
+ }
67
+ const tx = this._db.transaction();
68
+ await tx.insert(LOCAL_RUN_LOGS, { ...cursor, generation: null, updatedAt: now });
69
+ await tx.flush();
70
+ });
71
+ }
72
+ drop(key) {
73
+ return this._locked(async () => {
74
+ const tx = this._db.transaction();
75
+ await deleteLog(tx, key);
76
+ await tx.flush();
77
+ });
78
+ }
79
+ sweep(now = Date.now()) {
80
+ return this._locked(async () => {
81
+ const cursors = await this._db.find(LOCAL_RUN_LOGS).toArray();
82
+ const expired = cursors.filter((cursor) => now - cursor.updatedAt > RUN_LOG_RETENTION_MS);
83
+ if (expired.length === 0) {
84
+ return 0;
85
+ }
86
+ const tx = this._db.transaction();
87
+ for (const cursor of expired) {
88
+ await deleteLog(tx, cursor);
89
+ }
90
+ await tx.flush();
91
+ return expired.length;
92
+ });
93
+ }
94
+ async _live({ meshKey, runId, generation }) {
95
+ const cursor = await this._db.get(LOCAL_RUN_LOGS, { meshKey, runId });
96
+ if (!cursor?.generation || cursor.generation !== generation) {
97
+ throw new CoreError('RUN_LOG_STALE_GENERATION', [runId]);
98
+ }
99
+ return cursor;
100
+ }
101
+ async _steps({ meshKey, runId }) {
102
+ const rows = await this._db
103
+ .find(LOCAL_RUN_LOG_STEPS, {
104
+ gte: { meshKey, runId },
105
+ lte: { meshKey, runId }
106
+ })
107
+ .toArray();
108
+ return rows.map((row) => row.step).filter(isRunLogStep);
109
+ }
110
+ }
111
+ async function deleteLog(tx, { meshKey, runId }) {
112
+ const steps = await tx
113
+ .find(LOCAL_RUN_LOG_STEPS, {
114
+ gte: { meshKey, runId },
115
+ lte: { meshKey, runId }
116
+ })
117
+ .toArray();
118
+ for (const { seq } of steps) {
119
+ await tx.delete(LOCAL_RUN_LOG_STEPS, { meshKey, runId, seq });
120
+ }
121
+ await tx.delete(LOCAL_RUN_LOGS, { meshKey, runId });
122
+ }
123
+ export function isRunLogStep(value) {
124
+ if (!isRecord(value)) {
125
+ return false;
126
+ }
127
+ const { seq, expectedLength, records } = value;
128
+ return (Number.isSafeInteger(seq) &&
129
+ Number.isSafeInteger(expectedLength) &&
130
+ Array.isArray(records) &&
131
+ records.length > 0);
132
+ }
@@ -0,0 +1,7 @@
1
+ export interface BoxKeyPair {
2
+ readonly publicKey: Buffer;
3
+ readonly secretKey: Buffer;
4
+ }
5
+ export declare function memberBoxKeyPair(accountSeed: Buffer): BoxKeyPair;
6
+ export declare function sealToMember(message: Buffer, boxKey: Buffer): Buffer;
7
+ export declare function openSealedToMember(sealed: Buffer, keyPair: BoxKeyPair): Buffer | null;
@@ -0,0 +1,24 @@
1
+ import b4a from 'b4a';
2
+ import crypto from 'hypercore-crypto';
3
+ import box from 'sodium-universal/crypto_box.js';
4
+ const MEMBER_BOX = b4a.from('member-box');
5
+ export function memberBoxKeyPair(accountSeed) {
6
+ const publicKey = b4a.alloc(box.crypto_box_PUBLICKEYBYTES);
7
+ const secretKey = b4a.alloc(box.crypto_box_SECRETKEYBYTES);
8
+ box.crypto_box_seed_keypair(publicKey, secretKey, crypto.hash([MEMBER_BOX, accountSeed]));
9
+ return { publicKey, secretKey };
10
+ }
11
+ export function sealToMember(message, boxKey) {
12
+ const sealed = b4a.alloc(message.byteLength + box.crypto_box_SEALBYTES);
13
+ box.crypto_box_seal(sealed, message, boxKey);
14
+ return sealed;
15
+ }
16
+ export function openSealedToMember(sealed, keyPair) {
17
+ if (sealed.byteLength < box.crypto_box_SEALBYTES) {
18
+ return null;
19
+ }
20
+ const message = b4a.alloc(sealed.byteLength - box.crypto_box_SEALBYTES);
21
+ return box.crypto_box_seal_open(message, sealed, keyPair.publicKey, keyPair.secretKey)
22
+ ? message
23
+ : null;
24
+ }
@@ -1,10 +1,8 @@
1
1
  import type { KeyPair } from 'hyperswarm';
2
- import type { Logger } from '../../index.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
3
  import type { LocalIdentity } from '../../spec/local/hyperschema/types.d.ts';
4
4
  import type { QvacDevice } from '../../spec/mesh/hyperschema/types.d.ts';
5
- import type { DeviceInvites } from './device-invites.ts';
6
- import { type Mesh } from './mesh.ts';
7
- import type { MeshAdmissionRequest } from './mesh-seed-handoff.ts';
5
+ import type { Mesh } from './mesh.ts';
8
6
  export interface MembershipView {
9
7
  readonly members: number;
10
8
  readonly own: QvacDevice | null;
@@ -12,17 +10,9 @@ export interface MembershipView {
12
10
  }
13
11
  export interface MembershipContext {
14
12
  readonly deviceKeyPair: KeyPair;
15
- readonly log: Logger | null;
13
+ readonly log: LoggerInterface | null;
16
14
  }
17
15
  export declare function membershipView(mesh: Mesh, deviceId: Buffer): Promise<MembershipView>;
18
- export declare function attestUnattestedDevices(mesh: Mesh, { deviceKeyPair, log }: MembershipContext, invites: DeviceInvites): Promise<void>;
19
- interface AdmitInvitedDeviceOptions {
20
- readonly invites: DeviceInvites;
21
- readonly deviceId: Buffer;
22
- readonly request: MeshAdmissionRequest;
23
- }
24
- export declare function admitInvitedDevice(mesh: Mesh, { deviceKeyPair, log }: MembershipContext, { invites, deviceId, request }: AdmitInvitedDeviceOptions): Promise<boolean>;
25
- export declare function sealAccount(mesh: Mesh, { deviceKeyPair, log }: MembershipContext): Promise<void>;
26
16
  export interface KnownMember {
27
17
  readonly id: Buffer;
28
18
  readonly name: string;
@@ -37,4 +27,3 @@ export interface RenameFoundedMemberOptions {
37
27
  readonly adopt: (name: string, namedAt: number) => Promise<unknown>;
38
28
  }
39
29
  export declare function renameFoundedMember(mesh: Mesh, { deviceKeyPair, log }: MembershipContext, { identity, adopt }: RenameFoundedMemberOptions): Promise<void>;
40
- export {};
@@ -1,10 +1,7 @@
1
1
  import b4a from 'b4a';
2
- import { CAPABILITY_PROFILES } from '../../schema/qvac.js';
3
- import { verifyMemberWriterClaim, verifyWriterClaim } from './device-attestation.js';
4
2
  import { attestDeviceProof, attestMemberClaim, claimAttestation } from './identity.js';
5
- import { claimableDevice } from './mesh.js';
6
- import { meshKind } from './contract/mesh-kind.js';
7
- import { DEVICES, MEMBERS, MESH_KINDS } from './collections.js';
3
+ import { sharedKind } from './contract/mesh-kind.js';
4
+ import { DEVICES, MEMBERS } from './collections.js';
8
5
  export async function membershipView(mesh, deviceId) {
9
6
  const snap = mesh.view.snapshot();
10
7
  try {
@@ -28,97 +25,10 @@ export async function membershipView(mesh, deviceId) {
28
25
  await snap.close();
29
26
  }
30
27
  }
31
- export async function attestUnattestedDevices(mesh, { deviceKeyPair, log }, invites) {
32
- const { own, unattested } = await membershipView(mesh, deviceKeyPair.publicKey);
33
- if (!own?.memberId || !own.memberProof || unattested.length === 0) {
34
- return;
35
- }
36
- const ours = own.memberId;
37
- const adoptable = [];
38
- for (const device of unattested) {
39
- if (!device.claimedMemberId || !b4a.equals(device.claimedMemberId, ours)) {
40
- continue;
41
- }
42
- if (await invites.redeem(device.inviteToken, device.id)) {
43
- adoptable.push(device);
44
- }
45
- }
46
- if (adoptable.length === 0) {
47
- return;
48
- }
49
- const now = Date.now();
50
- const batch = mesh.batch();
51
- for (const device of adoptable) {
52
- batch.dispatch('attest-member-device', {
53
- deviceId: device.id,
54
- memberId: ours,
55
- proof: await attestDeviceProof(device.id, deviceKeyPair, own.memberProof),
56
- attestedAt: now
57
- });
58
- }
59
- await batch.flush();
60
- log?.info(['p2p', 'mesh'], 'every device that asked for our member is attested', {
61
- attested: adoptable.length
62
- });
63
- }
64
- export async function admitInvitedDevice(mesh, { deviceKeyPair, log }, { invites, deviceId, request }) {
65
- const own = await mesh.view.get(DEVICES, { id: deviceKeyPair.publicKey });
66
- if (!own?.memberId || !own.memberProof || own.revoked) {
67
- return false;
68
- }
69
- const { writerKey, name, recommendedModelName } = request;
70
- if (!writerKey) {
71
- return false;
72
- }
73
- const joinedAt = request.joinedAt ?? 0;
74
- const claim = { meshPublicKey: mesh.publicKey, deviceId, writerKey, joinedAt };
75
- if (!verifyWriterClaim(request.deviceSignature, claim) ||
76
- !verifyMemberWriterClaim(request.memberSignature, { ...claim, memberId: own.memberId })) {
77
- log?.warn(['p2p', 'mesh'], 'device invite refused: the asker did not sign its claim');
78
- return false;
79
- }
80
- const { capabilityProfile } = request;
81
- if (!name || !recommendedModelName || !isCapabilityProfile(capabilityProfile)) {
82
- log?.warn(['p2p', 'mesh'], 'device invite refused: the asker sent no usable profile');
83
- return false;
84
- }
85
- if (!(await invites.redeem(request.inviteToken, deviceId))) {
86
- log?.warn(['p2p', 'mesh'], 'device invite refused: not one of ours for this device');
87
- return false;
88
- }
89
- await mesh.dispatch('vouched-join', {
90
- signature: mesh.sign(writerKey),
91
- deviceId,
92
- device: claimableDevice({
93
- id: deviceId,
94
- joinedAt,
95
- name,
96
- capabilityProfile,
97
- recommendedModelName
98
- }),
99
- deviceSignature: request.deviceSignature,
100
- writerKey,
101
- memberProof: await attestDeviceProof(deviceId, deviceKeyPair, own.memberProof),
102
- memberSignature: request.memberSignature
103
- });
104
- log?.info(['p2p', 'mesh'], 'the device that redeemed our invite is admitted');
105
- return true;
106
- }
107
- export async function sealAccount(mesh, { deviceKeyPair, log }) {
108
- const own = await mesh.view.get(DEVICES, { id: deviceKeyPair.publicKey });
109
- if (!own?.memberId) {
110
- return;
111
- }
112
- if (await mesh.view.get(MESH_KINDS, { id: 'mesh' })) {
113
- return;
114
- }
115
- await mesh.dispatch('mint-mesh-kind', { id: 'mesh', kind: 'account' });
116
- log?.info(['p2p', 'mesh'], 'the account is sealed against a bare join');
117
- }
118
28
  export async function claimOwnMembership(mesh, { deviceKeyPair, log }, known) {
119
29
  const deviceId = deviceKeyPair.publicKey;
120
30
  const own = await mesh.view.get(DEVICES, { id: deviceId });
121
- if (!own || own.memberId || (await meshKind(mesh.view)) === 'shared') {
31
+ if (!own || own.memberId || (await sharedKind(mesh.view))) {
122
32
  return;
123
33
  }
124
34
  const member = await mesh.view.get(MEMBERS, { id: known.id });
@@ -163,6 +73,3 @@ export async function renameFoundedMember(mesh, { deviceKeyPair, log }, { identi
163
73
  });
164
74
  log?.info('membership', 'the member this device founded carries its user name');
165
75
  }
166
- function isCapabilityProfile(value) {
167
- return !!value && CAPABILITY_PROFILES.includes(value);
168
- }
@@ -1,22 +1,28 @@
1
1
  import Autobee, { type AutobeeChanges, type AutobeeHost, type AutobeeNode, type AutobeeOplogRef } from 'autobee';
2
+ import BlindPeering from 'blind-peering';
2
3
  import Corestore from 'corestore';
4
+ import type CorestoreStorage from 'hypercore-storage';
3
5
  import HyperDB from 'hyperdb';
4
6
  import Hyperblobs from 'hyperblobs';
5
7
  import type { KeyPair } from 'hypercore-crypto';
6
8
  import type Wakeup from 'protomux-wakeup';
7
9
  import ReadyResource from 'ready-resource';
8
10
  import { Files } from './files/index.ts';
9
- import type { Logger } from '../../index.ts';
11
+ import type { LoggerInterface } from '@qvac/logging';
10
12
  import { Router } from '../../spec/mesh/hyperdispatch/index.js';
11
- import type { QvacCapabilityProfile, QvacDevice, QvacMember } from '../../spec/mesh/hyperschema/types.d.ts';
12
- import type { BlindPeeringOpts } from './blind-peers.ts';
13
+ import type { QvacCapabilityProfile, QvacDevice, QvacMember, QvacMeshName } from '../../spec/mesh/hyperschema/types.d.ts';
14
+ import { type PendingUpdates } from './sync/view-updates.ts';
13
15
  import type { AttachmentUrl } from './attachment-link.ts';
14
16
  import type { MeshFileIndex } from './files/local-index.ts';
15
17
  import { type DeviceAttestation } from './device-attestation.ts';
18
+ import { type MeshRole } from './contract/roles.ts';
16
19
  import { type SyncActivity } from './sync-status.ts';
17
20
  export interface MeshView {
18
21
  readonly db: HyperDB;
19
22
  }
23
+ export interface SyncInBackgroundOptions {
24
+ readonly focus?: string;
25
+ }
20
26
  export interface DeviceMetadata {
21
27
  readonly name: string;
22
28
  readonly capabilityProfile: QvacCapabilityProfile;
@@ -29,20 +35,27 @@ export interface OrphanedBlobSweepStatus {
29
35
  }
30
36
  export interface MeshOptions {
31
37
  seed?: Buffer;
32
- compute?: boolean;
38
+ role?: MeshRole;
33
39
  key?: Buffer | null;
34
40
  writerSeed?: string;
35
41
  deviceId?: Buffer;
36
- logger?: Logger | null;
42
+ logger?: LoggerInterface | null;
37
43
  blindPeerKeys?: ReadonlyArray<Buffer>;
38
- blindPeeringOpts?: BlindPeeringOpts;
39
44
  bootFrom?: AutobeeOplogRef | null;
45
+ trustedDevice?: (deviceId: Buffer) => Promise<boolean>;
40
46
  wakeup?: Wakeup;
41
47
  attachmentUrl?: AttachmentUrl | null;
42
48
  fileIndex?: MeshFileIndex | null;
49
+ pendingUpdates?: PendingUpdates | null;
50
+ slowWriteMs?: number;
51
+ slowDrainMs?: number;
43
52
  }
53
+ export declare const SCHEMA_VERSION: number;
44
54
  export declare function meshPublicKeyFromSeed(seed: Buffer): Buffer;
45
- export declare function isOurTrustedWriter(snap: HyperDB, writerKey: Buffer, ourMemberId: Buffer | null): Promise<boolean>;
55
+ export interface TrustScope {
56
+ readonly ourMemberId: Buffer | null;
57
+ }
58
+ export declare function isTrustedWriter(snap: HyperDB, writerKey: Buffer, { ourMemberId }: TrustScope): Promise<boolean>;
46
59
  export type BirthRow = {
47
60
  readonly id: Buffer;
48
61
  readonly joinedAt: number;
@@ -56,17 +69,20 @@ export interface OurMembership {
56
69
  readonly proof: Buffer;
57
70
  readonly attestedAt: number;
58
71
  }
59
- export interface BirthClaim {
60
- readonly memberId?: Buffer;
61
- readonly inviteNonce?: Buffer | null;
62
- }
63
72
  interface BirthOptions {
64
73
  readonly member?: BirthMember;
65
- readonly claim?: BirthClaim;
66
74
  readonly sharing?: boolean;
67
- readonly grantSecret?: Buffer;
68
- readonly recovery?: RecoveryProof;
69
- readonly vouched?: boolean;
75
+ readonly defaults?: boolean;
76
+ readonly workspace?: WorkspaceIdentity;
77
+ readonly project?: ProjectIdentity;
78
+ }
79
+ export interface ProjectIdentity {
80
+ readonly name: string;
81
+ readonly upgraded?: boolean;
82
+ }
83
+ export interface WorkspaceIdentity {
84
+ readonly name: string;
85
+ readonly icon?: string;
70
86
  }
71
87
  export interface RecoveryProof {
72
88
  readonly memberId: Buffer;
@@ -92,13 +108,13 @@ export declare class Mesh extends ReadyResource {
92
108
  private _files;
93
109
  get files(): Files;
94
110
  private readonly _store;
111
+ private _namespaceId;
95
112
  private readonly _seed;
96
- private readonly _compute;
113
+ private readonly _role;
97
114
  private readonly _key;
98
115
  private readonly _writerSeed;
99
116
  private readonly _log;
100
117
  private readonly _blindPeerKeys;
101
- private readonly _blindPeeringOpts;
102
118
  private readonly _bootFrom;
103
119
  private readonly _wakeup;
104
120
  readonly attachmentUrl: AttachmentUrl | null;
@@ -109,25 +125,41 @@ export declare class Mesh extends ReadyResource {
109
125
  private readonly _deviceKeyPair;
110
126
  private readonly _encryptionKey;
111
127
  private _blindPeering;
128
+ openedEmpty: boolean;
129
+ foreign: boolean;
130
+ workspaceKey: Buffer | null;
131
+ private readonly _updates;
132
+ private _openedAt;
133
+ private readonly _trustedDevice;
134
+ private _joined;
112
135
  private _orphanedBlobSweepStatus;
113
136
  private _bootInterrupted;
114
137
  private _localWriterUploadedLength;
115
138
  private _ourMemberId;
139
+ private _name;
116
140
  private _membership;
117
141
  private readonly _deviceId;
118
- private readonly _grantExpiry;
142
+ private readonly _slowWriteMs;
143
+ private readonly _slowDrainMs;
144
+ private _stallReported;
119
145
  private _admitted;
146
+ private _refused;
147
+ private _kickSeen;
148
+ private _birth;
149
+ private _rulesRaised;
120
150
  private _autobee;
121
151
  private _blobs;
122
152
  private _syncActivity;
153
+ private readonly _background;
123
154
  readonly discoveryKey: Buffer;
124
155
  get autobee(): Autobee<MeshView>;
125
156
  get blobs(): Hyperblobs;
126
157
  get syncActivity(): SyncActivity;
127
158
  get publicKey(): Buffer;
159
+ get log(): LoggerInterface | null;
128
160
  get devicePublicKey(): Buffer;
129
161
  get key(): Buffer;
130
- get compute(): boolean;
162
+ get role(): MeshRole;
131
163
  get encryptionKey(): Buffer;
132
164
  get seed(): Buffer;
133
165
  get blindPeerKeys(): ReadonlyArray<Buffer>;
@@ -136,16 +168,27 @@ export declare class Mesh extends ReadyResource {
136
168
  get ourMemberId(): Buffer | null;
137
169
  get ourDeviceId(): Buffer | null;
138
170
  get membership(): MembershipStats;
171
+ tallyMembership(): void;
139
172
  refreshMembership(): Promise<void>;
140
- refreshOurMember(): Promise<void>;
141
- refreshGrantExpiry(): Promise<void>;
142
- bornKind(): Promise<string | null | undefined>;
143
- waitForGenesis(timeout: number): Promise<string | null | undefined>;
173
+ refreshOurMember(): Promise<QvacDevice | null>;
174
+ get name(): QvacMeshName | null;
175
+ refreshName(): Promise<void>;
176
+ setName(name: string): Promise<void>;
144
177
  sign(message: Buffer): Buffer;
145
178
  attestDevice(deviceId: Buffer): DeviceAttestation;
146
179
  constructor(store: Corestore, opts?: MeshOptions);
147
180
  _open(): Promise<void>;
148
- startBlindPeering(dht: unknown): void;
181
+ startBlindPeering(peering: BlindPeering): void;
182
+ stopBlindPeering(): void;
183
+ get bootFrom(): number | null;
184
+ wakeHeldWriters(): Promise<void>;
185
+ get writerCount(): number;
186
+ get uptimeMs(): number;
187
+ blindPeersConnected(): number;
188
+ private _sinceOpen;
189
+ private _lengths;
190
+ private _blobCoreName;
191
+ ownCoreDiscoveryKeys(storage: CorestoreStorage): Promise<Buffer[]>;
149
192
  openBlobs(coreKey: Buffer): Promise<Hyperblobs>;
150
193
  interruptBoot(): void;
151
194
  _close(): Promise<void>;
@@ -156,41 +199,75 @@ export declare class Mesh extends ReadyResource {
156
199
  get minted(): boolean;
157
200
  get writable(): boolean;
158
201
  get localLength(): number;
202
+ get joining(): boolean;
159
203
  dispatch(name: string, payload: unknown, opts?: AppendOptions): Promise<void>;
204
+ private _watchStall;
205
+ private _endStall;
206
+ private _reportStall;
207
+ private _fastForwardHeld;
208
+ private _writersHeld;
209
+ private _coresNotHeld;
210
+ private _coreHeld;
160
211
  batch(): MeshBatch;
161
- appendBirthOp(identity: Buffer | KeyPair, device?: DeviceMetadata, { member, claim, sharing, grantSecret, recovery, vouched }?: BirthOptions): Promise<void>;
212
+ private _raiseRulesLater;
213
+ private _raiseRules;
214
+ appendBirthOp(identity: Buffer | KeyPair, device?: DeviceMetadata, opts?: BirthOptions | (() => Promise<BirthOptions>)): Promise<void>;
215
+ private _settleBirth;
216
+ get joined(): boolean;
217
+ private _appendBirthOp;
218
+ private _bornKind;
219
+ private _seedDefaults;
162
220
  get interrupted(): unknown;
163
221
  throwIfInterrupted(): void;
164
- waitForWritable(timeout?: number): Promise<void>;
222
+ waitForWritable(): Promise<void>;
165
223
  pendingUploads(): number;
166
224
  suspend(): Promise<void>;
167
- resume(): Promise<void>;
225
+ resume(): void;
226
+ syncInBackground({ focus }?: SyncInBackgroundOptions): Promise<boolean>;
227
+ focusChat(chatId: string): void;
228
+ pickedFrom: (() => Promise<Mesh | null>) | null;
168
229
  syncChatOrder: ((chatIds: Set<string>) => Promise<void>) | null;
169
230
  chatOrderBuilt: Promise<void>;
170
231
  watch(listener: () => void): void;
171
232
  unwatch(listener: () => void): void;
172
233
  _autobeeIsTrusted(key: Buffer, reference: MeshView): Promise<boolean>;
173
234
  _autobeeMostRecentTrusted(target: MeshView, reference: MeshView | null): Promise<AutobeeOplogRef | null>;
235
+ private _vouchedByItsRow;
174
236
  _autobeeOpen(bee: unknown): MeshView;
175
237
  _autobeeWarmup(view: MeshView): Promise<void>;
176
238
  _autobeeApply(nodes: ReadonlyArray<AutobeeNode>, view: MeshView, host: AutobeeHost): Promise<void>;
177
239
  private _applyNode;
178
240
  private _halt;
179
- _autobeeUpdate(view: MeshView, changes: AutobeeChanges): Promise<void>;
241
+ _autobeeUpdate(_view: MeshView, changes: AutobeeChanges): Promise<void>;
242
+ synced(): Promise<void>;
243
+ private _syncUpdate;
244
+ private _arrive;
245
+ private _readLanding;
180
246
  checkOwnAdmission(): Promise<void>;
247
+ kickDirty(): Promise<void>;
248
+ private _kickState;
249
+ readKicked(): Promise<boolean>;
250
+ checkResumedRefusal(): Promise<boolean>;
181
251
  checkResumedRevocation(): Promise<'kicked' | 'left' | null>;
182
252
  ownWriterRefused(): Promise<boolean>;
253
+ private _ownRow;
183
254
  }
184
255
  export interface MeshDispatcher {
185
256
  dispatch(name: string, payload: unknown): void | Promise<void>;
186
257
  }
258
+ type WriteWatch = (op: string, write: Promise<void>) => Promise<void>;
187
259
  export interface MeshBatchOptions {
188
- readonly compute?: boolean;
260
+ readonly role?: MeshRole;
261
+ readonly joined?: boolean;
262
+ readonly watch?: WriteWatch;
189
263
  }
190
264
  export declare class MeshBatch {
191
265
  private readonly _autobee;
192
- private readonly _compute;
266
+ private readonly _role;
267
+ private readonly _joined;
268
+ private readonly _watch;
193
269
  private _ops;
270
+ private _names;
194
271
  constructor(autobee: Autobee<MeshView>, opts?: MeshBatchOptions);
195
272
  get size(): number;
196
273
  dispatch(name: string, payload: unknown): void;