@qvac/core 0.4.1 → 0.6.0

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 (417) hide show
  1. package/CHANGELOG.md +262 -1
  2. package/README.md +1 -1
  3. package/dist-lib/lib/api/agents.js +3 -2
  4. package/dist-lib/lib/api/app-config.d.ts +1 -1
  5. package/dist-lib/lib/api/app-config.js +54 -15
  6. package/dist-lib/lib/api/attachments.d.ts +6 -5
  7. package/dist-lib/lib/api/attachments.js +4 -2
  8. package/dist-lib/lib/api/chat.d.ts +7 -3
  9. package/dist-lib/lib/api/chat.js +4 -4
  10. package/dist-lib/lib/api/chunks.js +3 -3
  11. package/dist-lib/lib/api/config.js +2 -2
  12. package/dist-lib/lib/api/current-mesh.d.ts +3 -4
  13. package/dist-lib/lib/api/current-mesh.js +9 -4
  14. package/dist-lib/lib/api/custom-models.d.ts +8 -1
  15. package/dist-lib/lib/api/custom-models.js +53 -16
  16. package/dist-lib/lib/api/devices.d.ts +14 -5
  17. package/dist-lib/lib/api/devices.js +14 -9
  18. package/dist-lib/lib/api/diagnostics.d.ts +1 -0
  19. package/dist-lib/lib/api/diagnostics.js +1 -1
  20. package/dist-lib/lib/api/effective-ctx-size.d.ts +6 -1
  21. package/dist-lib/lib/api/effective-ctx-size.js +5 -3
  22. package/dist-lib/lib/api/execution.js +9 -2
  23. package/dist-lib/lib/api/files.js +2 -1
  24. package/dist-lib/lib/api/index.d.ts +7 -1
  25. package/dist-lib/lib/api/index.js +101 -101
  26. package/dist-lib/lib/api/instrument.js +29 -20
  27. package/dist-lib/lib/api/knowledge.d.ts +6 -5
  28. package/dist-lib/lib/api/knowledge.js +8 -6
  29. package/dist-lib/lib/api/local-files.js +1 -1
  30. package/dist-lib/lib/api/logs.js +6 -3
  31. package/dist-lib/lib/api/members.js +22 -13
  32. package/dist-lib/lib/api/mesh.d.ts +7 -2
  33. package/dist-lib/lib/api/mesh.js +10 -5
  34. package/dist-lib/lib/api/model-download.js +1 -1
  35. package/dist-lib/lib/api/network.d.ts +1 -0
  36. package/dist-lib/lib/api/network.js +1 -1
  37. package/dist-lib/lib/api/notifications.js +23 -13
  38. package/dist-lib/lib/api/rag.d.ts +6 -1
  39. package/dist-lib/lib/api/rag.js +20 -11
  40. package/dist-lib/lib/api/range.d.ts +2 -2
  41. package/dist-lib/lib/api/sync.js +1 -1
  42. package/dist-lib/lib/api/tool-activity.js +7 -3
  43. package/dist-lib/lib/api/tool-configs.js +2 -4
  44. package/dist-lib/lib/api/upload-frames.d.ts +7 -8
  45. package/dist-lib/lib/api/upload-frames.js +2 -1
  46. package/dist-lib/lib/api/watchable.d.ts +6 -1
  47. package/dist-lib/lib/api/watchable.js +23 -14
  48. package/dist-lib/lib/assistant/fetch-body.js +4 -2
  49. package/dist-lib/lib/assistant/harness.d.ts +72 -24
  50. package/dist-lib/lib/assistant/harness.js +53 -15
  51. package/dist-lib/lib/assistant/history.d.ts +9 -7
  52. package/dist-lib/lib/assistant/history.js +77 -42
  53. package/dist-lib/lib/assistant/message.d.ts +5 -3
  54. package/dist-lib/lib/assistant/message.js +4 -2
  55. package/dist-lib/lib/assistant/skill-encode.d.ts +3 -1
  56. package/dist-lib/lib/assistant/skill-encode.js +52 -62
  57. package/dist-lib/lib/assistant-client.js +7 -4
  58. package/dist-lib/lib/assistant-tree.js +36 -11
  59. package/dist-lib/lib/assistant.d.ts +37 -12
  60. package/dist-lib/lib/assistant.js +977 -373
  61. package/dist-lib/lib/audio-format.d.ts +1 -1
  62. package/dist-lib/lib/audio-format.js +1 -1
  63. package/dist-lib/lib/chat-title.js +9 -4
  64. package/dist-lib/lib/client.js +3 -2
  65. package/dist-lib/lib/collabora/convert.d.ts +2 -2
  66. package/dist-lib/lib/collabora/convert.js +6 -3
  67. package/dist-lib/lib/collabora/entry.js +9 -5
  68. package/dist-lib/lib/collabora/protocol.d.ts +2 -2
  69. package/dist-lib/lib/collabora/protocol.js +14 -7
  70. package/dist-lib/lib/collabora/worker.js +14 -7
  71. package/dist-lib/lib/compaction.d.ts +5 -6
  72. package/dist-lib/lib/compaction.js +14 -7
  73. package/dist-lib/lib/constants.d.ts +2 -0
  74. package/dist-lib/lib/constants.js +4 -0
  75. package/dist-lib/lib/core/account-recovery.d.ts +4 -3
  76. package/dist-lib/lib/core/account-recovery.js +7 -4
  77. package/dist-lib/lib/core/agent.d.ts +0 -1
  78. package/dist-lib/lib/core/agent.js +18 -16
  79. package/dist-lib/lib/core/approval-rules.d.ts +7 -6
  80. package/dist-lib/lib/core/approval-rules.js +12 -6
  81. package/dist-lib/lib/core/archived-mesh.d.ts +7 -5
  82. package/dist-lib/lib/core/archived-mesh.js +25 -22
  83. package/dist-lib/lib/core/async-iterable.js +10 -5
  84. package/dist-lib/lib/core/attachment-link.d.ts +2 -2
  85. package/dist-lib/lib/core/audio-attachment.js +1 -1
  86. package/dist-lib/lib/core/blind-peers.d.ts +2 -2
  87. package/dist-lib/lib/core/chat-activity.d.ts +2 -2
  88. package/dist-lib/lib/core/chat-activity.js +42 -21
  89. package/dist-lib/lib/core/chat-group.d.ts +8 -6
  90. package/dist-lib/lib/core/chat-group.js +17 -10
  91. package/dist-lib/lib/core/chat-order.d.ts +11 -9
  92. package/dist-lib/lib/core/chat-order.js +1 -3
  93. package/dist-lib/lib/core/chat-search.d.ts +4 -4
  94. package/dist-lib/lib/core/chat-search.js +38 -24
  95. package/dist-lib/lib/core/chat.d.ts +20 -14
  96. package/dist-lib/lib/core/chat.js +42 -28
  97. package/dist-lib/lib/core/chunk.d.ts +20 -24
  98. package/dist-lib/lib/core/chunk.js +34 -22
  99. package/dist-lib/lib/core/collections.d.ts +69 -0
  100. package/dist-lib/lib/core/collections.js +69 -0
  101. package/dist-lib/lib/core/contract/activity.d.ts +8 -2
  102. package/dist-lib/lib/core/contract/activity.js +39 -11
  103. package/dist-lib/lib/core/contract/agents.js +3 -2
  104. package/dist-lib/lib/core/contract/approval-rules.js +1 -1
  105. package/dist-lib/lib/core/contract/attestations.js +1 -1
  106. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  107. package/dist-lib/lib/core/contract/chat.js +1 -1
  108. package/dist-lib/lib/core/contract/chunks.js +16 -9
  109. package/dist-lib/lib/core/contract/compute.js +2 -1
  110. package/dist-lib/lib/core/contract/devices.js +10 -6
  111. package/dist-lib/lib/core/contract/grant-order.d.ts +5 -0
  112. package/dist-lib/lib/core/contract/grant-order.js +20 -0
  113. package/dist-lib/lib/core/contract/index.d.ts +1 -1
  114. package/dist-lib/lib/core/contract/index.js +27 -2
  115. package/dist-lib/lib/core/contract/indexing.js +3 -3
  116. package/dist-lib/lib/core/contract/invites.d.ts +16 -0
  117. package/dist-lib/lib/core/contract/invites.js +256 -0
  118. package/dist-lib/lib/core/contract/joined-meshes.js +22 -22
  119. package/dist-lib/lib/core/contract/knowledge.js +5 -5
  120. package/dist-lib/lib/core/contract/members.d.ts +15 -0
  121. package/dist-lib/lib/core/contract/members.js +116 -31
  122. package/dist-lib/lib/core/contract/mesh-kind.d.ts +6 -0
  123. package/dist-lib/lib/core/contract/mesh-kind.js +49 -0
  124. package/dist-lib/lib/core/contract/seal.js +1 -1
  125. package/dist-lib/lib/core/contract/seed-defaults.js +1 -3
  126. package/dist-lib/lib/core/contract/tool-activity.js +5 -5
  127. package/dist-lib/lib/core/contract/tool-configs.js +1 -2
  128. package/dist-lib/lib/core/contract/writers.d.ts +13 -0
  129. package/dist-lib/lib/core/contract/writers.js +181 -24
  130. package/dist-lib/lib/core/departures.js +16 -8
  131. package/dist-lib/lib/core/device-attestation.d.ts +5 -0
  132. package/dist-lib/lib/core/device-attestation.js +24 -0
  133. package/dist-lib/lib/core/device-invites.d.ts +2 -0
  134. package/dist-lib/lib/core/device-invites.js +29 -7
  135. package/dist-lib/lib/core/devices.d.ts +2 -1
  136. package/dist-lib/lib/core/devices.js +52 -2
  137. package/dist-lib/lib/core/document-attachment.d.ts +20 -11
  138. package/dist-lib/lib/core/document-attachment.js +10 -5
  139. package/dist-lib/lib/core/files/attachments.d.ts +2 -5
  140. package/dist-lib/lib/core/files/attachments.js +6 -3
  141. package/dist-lib/lib/core/files/index.d.ts +44 -52
  142. package/dist-lib/lib/core/files/index.js +142 -93
  143. package/dist-lib/lib/core/files/knowledge.d.ts +2 -5
  144. package/dist-lib/lib/core/files/local-index.js +9 -5
  145. package/dist-lib/lib/core/files/preview/image.d.ts +0 -1
  146. package/dist-lib/lib/core/files/preview/image.js +9 -6
  147. package/dist-lib/lib/core/files/preview/index.d.ts +8 -11
  148. package/dist-lib/lib/core/files/preview/index.js +20 -15
  149. package/dist-lib/lib/core/files/processing/claims.d.ts +6 -5
  150. package/dist-lib/lib/core/files/processing/claims.js +16 -8
  151. package/dist-lib/lib/core/files/processing/document.d.ts +21 -50
  152. package/dist-lib/lib/core/files/processing/index.d.ts +18 -13
  153. package/dist-lib/lib/core/files/processing/index.js +65 -37
  154. package/dist-lib/lib/core/files/processing/ownership.d.ts +8 -1
  155. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  156. package/dist-lib/lib/core/files/processing/protocol.d.ts +19 -19
  157. package/dist-lib/lib/core/files/processing/protocol.js +5 -5
  158. package/dist-lib/lib/core/files/processing/settle.d.ts +10 -7
  159. package/dist-lib/lib/core/files/processing/settle.js +22 -11
  160. package/dist-lib/lib/core/files/processing/source.js +14 -8
  161. package/dist-lib/lib/core/files/processing/state.d.ts +13 -11
  162. package/dist-lib/lib/core/files/processing/state.js +19 -12
  163. package/dist-lib/lib/core/files/rag/build.d.ts +2 -2
  164. package/dist-lib/lib/core/files/rag/build.js +2 -1
  165. package/dist-lib/lib/core/files/rag/document-types.d.ts +4 -6
  166. package/dist-lib/lib/core/files/rag/index.d.ts +10 -13
  167. package/dist-lib/lib/core/files/rag/index.js +3 -2
  168. package/dist-lib/lib/core/files/rag/load.d.ts +10 -9
  169. package/dist-lib/lib/core/files/rag/load.js +26 -13
  170. package/dist-lib/lib/core/files/rag/policy.js +2 -1
  171. package/dist-lib/lib/core/files/rag/produce.js +33 -19
  172. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +5 -3
  173. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +30 -10
  174. package/dist-lib/lib/core/files/records/chunks.js +4 -2
  175. package/dist-lib/lib/core/files/records/knowledge.d.ts +10 -11
  176. package/dist-lib/lib/core/files/records/knowledge.js +9 -8
  177. package/dist-lib/lib/core/files/records/linkage.js +6 -3
  178. package/dist-lib/lib/core/files/records/output.d.ts +5 -4
  179. package/dist-lib/lib/core/files/records/output.js +8 -4
  180. package/dist-lib/lib/core/files/records/reclaim.js +41 -25
  181. package/dist-lib/lib/core/files/records/routing.d.ts +4 -6
  182. package/dist-lib/lib/core/files/records/routing.js +15 -8
  183. package/dist-lib/lib/core/files/records/source.d.ts +5 -4
  184. package/dist-lib/lib/core/files/records/source.js +20 -14
  185. package/dist-lib/lib/core/files/records/sweep.js +1 -3
  186. package/dist-lib/lib/core/files/store/blob.d.ts +10 -10
  187. package/dist-lib/lib/core/files/store/blob.js +25 -19
  188. package/dist-lib/lib/core/files/store/index.d.ts +1 -6
  189. package/dist-lib/lib/core/files/store/index.js +4 -4
  190. package/dist-lib/lib/core/files/store/inline.d.ts +2 -2
  191. package/dist-lib/lib/core/files/store/inline.js +6 -3
  192. package/dist-lib/lib/core/files/store/reference.d.ts +6 -9
  193. package/dist-lib/lib/core/files/store/reference.js +25 -17
  194. package/dist-lib/lib/core/files/store/server.d.ts +7 -6
  195. package/dist-lib/lib/core/files/store/server.js +22 -11
  196. package/dist-lib/lib/core/files/store/sweep.js +13 -7
  197. package/dist-lib/lib/core/files/upload-input.d.ts +4 -12
  198. package/dist-lib/lib/core/files/upload-input.js +10 -5
  199. package/dist-lib/lib/core/files/upload.d.ts +27 -24
  200. package/dist-lib/lib/core/files/upload.js +74 -51
  201. package/dist-lib/lib/core/fs-drives.js +4 -2
  202. package/dist-lib/lib/core/grant-expiry.d.ts +11 -0
  203. package/dist-lib/lib/core/grant-expiry.js +66 -0
  204. package/dist-lib/lib/core/handoff-channel.d.ts +2 -1
  205. package/dist-lib/lib/core/handoff-channel.js +36 -15
  206. package/dist-lib/lib/core/harness-loan.js +35 -17
  207. package/dist-lib/lib/core/helpers/index.d.ts +2 -1
  208. package/dist-lib/lib/core/helpers/index.js +11 -6
  209. package/dist-lib/lib/core/hosted-agents.js +19 -12
  210. package/dist-lib/lib/core/id.js +1 -1
  211. package/dist-lib/lib/core/identity.d.ts +1 -0
  212. package/dist-lib/lib/core/identity.js +11 -3
  213. package/dist-lib/lib/core/image/cache-sweep.d.ts +12 -10
  214. package/dist-lib/lib/core/image/cache-sweep.js +11 -6
  215. package/dist-lib/lib/core/image/normalize.d.ts +6 -0
  216. package/dist-lib/lib/core/image/normalize.js +12 -2
  217. package/dist-lib/lib/core/image/sniff.js +42 -21
  218. package/dist-lib/lib/core/inference-calls-receiver.js +7 -4
  219. package/dist-lib/lib/core/invite-grants.d.ts +20 -0
  220. package/dist-lib/lib/core/invite-grants.js +46 -0
  221. package/dist-lib/lib/core/invite.d.ts +3 -0
  222. package/dist-lib/lib/core/invite.js +6 -3
  223. package/dist-lib/lib/core/local/files.js +20 -19
  224. package/dist-lib/lib/core/local/index.d.ts +70 -45
  225. package/dist-lib/lib/core/local/index.js +157 -126
  226. package/dist-lib/lib/core/membership.d.ts +15 -2
  227. package/dist-lib/lib/core/membership.js +95 -20
  228. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +12 -4
  229. package/dist-lib/lib/core/mesh-seed-handoff.js +23 -5
  230. package/dist-lib/lib/core/mesh.d.ts +57 -30
  231. package/dist-lib/lib/core/mesh.js +232 -78
  232. package/dist-lib/lib/core/migrations/agent-catalog.js +3 -2
  233. package/dist-lib/lib/core/migrations/agent-indexes.js +3 -3
  234. package/dist-lib/lib/core/migrations/device-indexes.d.ts +2 -0
  235. package/dist-lib/lib/core/migrations/device-indexes.js +7 -0
  236. package/dist-lib/lib/core/migrations/file-index.js +7 -4
  237. package/dist-lib/lib/core/migrations/index.d.ts +4 -3
  238. package/dist-lib/lib/core/migrations/index.js +3 -1
  239. package/dist-lib/lib/core/migrations/membership.js +9 -4
  240. package/dist-lib/lib/core/migrations/seal.js +3 -2
  241. package/dist-lib/lib/core/min-version.js +4 -2
  242. package/dist-lib/lib/core/next-frame.d.ts +5 -4
  243. package/dist-lib/lib/core/next-frame.js +6 -3
  244. package/dist-lib/lib/core/notification.d.ts +5 -1
  245. package/dist-lib/lib/core/notification.js +89 -77
  246. package/dist-lib/lib/core/ota-config.js +2 -1
  247. package/dist-lib/lib/core/pdf/rasterize.d.ts +18 -0
  248. package/dist-lib/lib/core/pdf/rasterize.js +57 -0
  249. package/dist-lib/lib/core/prompt-history.js +4 -2
  250. package/dist-lib/lib/core/range.d.ts +4 -4
  251. package/dist-lib/lib/core/range.js +12 -6
  252. package/dist-lib/lib/core/rank.d.ts +5 -4
  253. package/dist-lib/lib/core/rank.js +2 -1
  254. package/dist-lib/lib/core/send.d.ts +8 -5
  255. package/dist-lib/lib/core/send.js +9 -3
  256. package/dist-lib/lib/core/skill-overlay-receiver.js +7 -4
  257. package/dist-lib/lib/core/skill-secrets.js +16 -9
  258. package/dist-lib/lib/core/sync/chunks.js +2 -1
  259. package/dist-lib/lib/core/sync/devices.js +3 -1
  260. package/dist-lib/lib/core/sync/files.d.ts +2 -4
  261. package/dist-lib/lib/core/sync/files.js +28 -20
  262. package/dist-lib/lib/core/sync/index.d.ts +2 -5
  263. package/dist-lib/lib/core/sync/index.js +33 -17
  264. package/dist-lib/lib/core/sync-status.js +10 -7
  265. package/dist-lib/lib/core/system-info.js +4 -2
  266. package/dist-lib/lib/core/tool-activity.d.ts +4 -3
  267. package/dist-lib/lib/core/tool-activity.js +1 -1
  268. package/dist-lib/lib/core/tool-configs.js +12 -7
  269. package/dist-lib/lib/core.d.ts +107 -45
  270. package/dist-lib/lib/core.js +1765 -595
  271. package/dist-lib/lib/credential-pusher.d.ts +12 -17
  272. package/dist-lib/lib/credential-pusher.js +61 -42
  273. package/dist-lib/lib/custom-model-pusher.d.ts +7 -3
  274. package/dist-lib/lib/custom-model-pusher.js +15 -7
  275. package/dist-lib/lib/custom-model-task.d.ts +1 -0
  276. package/dist-lib/lib/custom-model-task.js +12 -0
  277. package/dist-lib/lib/deadline.js +4 -2
  278. package/dist-lib/lib/diagnostics.d.ts +1 -5
  279. package/dist-lib/lib/frame-readable.d.ts +3 -0
  280. package/dist-lib/lib/frame-readable.js +3 -0
  281. package/dist-lib/lib/fs-drive-bridge.js +24 -14
  282. package/dist-lib/lib/fs-grants.js +13 -8
  283. package/dist-lib/lib/guards.d.ts +3 -0
  284. package/dist-lib/lib/guards.js +9 -0
  285. package/dist-lib/lib/inference-calls.d.ts +28 -23
  286. package/dist-lib/lib/inference-calls.js +25 -13
  287. package/dist-lib/lib/integrations/mcp-providers.d.ts +2 -2
  288. package/dist-lib/lib/integrations/setup-routes.d.ts +2 -2
  289. package/dist-lib/lib/knowledge-search.d.ts +6 -5
  290. package/dist-lib/lib/knowledge-search.js +26 -18
  291. package/dist-lib/lib/kv-cache-reclaim.js +4 -2
  292. package/dist-lib/lib/kv-cache.js +8 -4
  293. package/dist-lib/lib/legacy-core-domain.d.ts +42 -42
  294. package/dist-lib/lib/log-buffer.js +2 -1
  295. package/dist-lib/lib/log.js +25 -15
  296. package/dist-lib/lib/mesh-scoped-engine.js +14 -4
  297. package/dist-lib/lib/model-catalog-revision.js +6 -3
  298. package/dist-lib/lib/model-clamp.js +6 -3
  299. package/dist-lib/lib/model-context.d.ts +8 -3
  300. package/dist-lib/lib/model-context.js +13 -5
  301. package/dist-lib/lib/model-download-status.js +4 -2
  302. package/dist-lib/lib/model-download.d.ts +12 -4
  303. package/dist-lib/lib/model-download.js +200 -103
  304. package/dist-lib/lib/model-idle-pusher.d.ts +10 -0
  305. package/dist-lib/lib/model-idle-pusher.js +41 -0
  306. package/dist-lib/lib/oauth/browser-connect.d.ts +10 -8
  307. package/dist-lib/lib/oauth/browser-connect.js +33 -20
  308. package/dist-lib/lib/oauth/client.d.ts +2 -2
  309. package/dist-lib/lib/oauth/flow-core.js +23 -9
  310. package/dist-lib/lib/oauth/flow.d.ts +1 -3
  311. package/dist-lib/lib/oauth/flow.js +9 -5
  312. package/dist-lib/lib/oauth/keys.d.ts +4 -4
  313. package/dist-lib/lib/oauth/keys.js +18 -12
  314. package/dist-lib/lib/oauth/loopback.d.ts +2 -2
  315. package/dist-lib/lib/oauth/loopback.js +147 -107
  316. package/dist-lib/lib/oauth/loopback.stub.d.ts +2 -2
  317. package/dist-lib/lib/oauth/loopback.stub.js +1 -1
  318. package/dist-lib/lib/oauth/pkce.d.ts +4 -2
  319. package/dist-lib/lib/oauth/pkce.js +10 -0
  320. package/dist-lib/lib/oauth/providers.js +5 -5
  321. package/dist-lib/lib/oauth/redirect-types.d.ts +12 -7
  322. package/dist-lib/lib/oauth/register.js +3 -2
  323. package/dist-lib/lib/oauth/registry.d.ts +2 -2
  324. package/dist-lib/lib/oauth/registry.js +2 -1
  325. package/dist-lib/lib/oauth/resolve.d.ts +30 -10
  326. package/dist-lib/lib/oauth/resolve.js +12 -6
  327. package/dist-lib/lib/oauth/token-exchange-core.d.ts +12 -4
  328. package/dist-lib/lib/oauth/token-exchange-core.js +1 -1
  329. package/dist-lib/lib/oauth/types.d.ts +12 -12
  330. package/dist-lib/lib/oauth.d.ts +4 -5
  331. package/dist-lib/lib/oauth.js +2 -3
  332. package/dist-lib/lib/reconnecting-watch.d.ts +1 -1
  333. package/dist-lib/lib/reconnecting-watch.js +6 -6
  334. package/dist-lib/lib/retry-budget.js +6 -3
  335. package/dist-lib/lib/run-notices.d.ts +2 -0
  336. package/dist-lib/lib/run-notices.js +7 -3
  337. package/dist-lib/lib/run-transcript.d.ts +2 -4
  338. package/dist-lib/lib/run-transcript.js +4 -2
  339. package/dist-lib/lib/skill-readiness.d.ts +1 -0
  340. package/dist-lib/lib/skill-readiness.js +17 -2
  341. package/dist-lib/lib/skill-types.d.ts +16 -16
  342. package/dist-lib/lib/suspend-lifecycle.d.ts +4 -4
  343. package/dist-lib/lib/suspend-lifecycle.js +10 -5
  344. package/dist-lib/lib/task.d.ts +5 -1
  345. package/dist-lib/lib/task.js +29 -12
  346. package/dist-lib/lib/unref.d.ts +3 -2
  347. package/dist-lib/lib/unref.js +2 -1
  348. package/dist-lib/lib/wav-duration.js +10 -5
  349. package/dist-lib/lib/write-queue.d.ts +5 -4
  350. package/dist-lib/lib/write-queue.js +2 -1
  351. package/dist-lib/schema/build.js +16 -8
  352. package/dist-lib/schema/config.d.ts +3 -4
  353. package/dist-lib/schema/config.js +1 -1
  354. package/dist-lib/schema/content.d.ts +18 -2
  355. package/dist-lib/schema/content.js +4 -1
  356. package/dist-lib/schema/engine.d.ts +3 -2
  357. package/dist-lib/schema/engine.js +192 -12
  358. package/dist-lib/schema/field-order.js +22 -11
  359. package/dist-lib/schema/indexes.d.ts +22 -0
  360. package/dist-lib/schema/{helpers.js → indexes.js} +19 -57
  361. package/dist-lib/schema/local.d.ts +3 -2
  362. package/dist-lib/schema/local.js +9 -3
  363. package/dist-lib/schema/media-kind.d.ts +8 -0
  364. package/dist-lib/schema/media-kind.js +52 -0
  365. package/dist-lib/schema/qvac.d.ts +12 -9
  366. package/dist-lib/schema/qvac.js +132 -7
  367. package/dist-lib/spec/bind.js +21 -0
  368. package/dist-lib/spec/calls.js +7 -0
  369. package/dist-lib/spec/capabilities.d.ts +18 -4
  370. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  371. package/dist-lib/spec/hrpc/hrpc.json +93 -2
  372. package/dist-lib/spec/hrpc/index.js +89 -5
  373. package/dist-lib/spec/hrpc/messages.js +1568 -941
  374. package/dist-lib/spec/hyperschema/index.js +1568 -941
  375. package/dist-lib/spec/hyperschema/schema.json +531 -1
  376. package/dist-lib/spec/hyperschema/types.d.ts +145 -1
  377. package/dist-lib/spec/local/hyperdb/index.js +1 -1
  378. package/dist-lib/spec/local/hyperdb/messages.js +92 -20
  379. package/dist-lib/spec/local/hyperschema/index.js +47 -11
  380. package/dist-lib/spec/local/hyperschema/schema.json +32 -1
  381. package/dist-lib/spec/local/hyperschema/types.d.ts +7 -1
  382. package/dist-lib/spec/mesh/hyperdb/db.json +131 -3
  383. package/dist-lib/spec/mesh/hyperdb/index.js +548 -5
  384. package/dist-lib/spec/mesh/hyperdb/messages.js +2444 -893
  385. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +37 -1
  386. package/dist-lib/spec/mesh/hyperdispatch/index.js +104 -2
  387. package/dist-lib/spec/mesh/hyperdispatch/messages.js +1035 -11
  388. package/dist-lib/spec/mesh/hyperschema/index.js +1035 -11
  389. package/dist-lib/spec/mesh/hyperschema/schema.json +553 -1
  390. package/dist-lib/spec/mesh/hyperschema/types.d.ts +143 -1
  391. package/package.json +11 -5
  392. package/tui/app.mjs +2624 -986
  393. package/tui/boot.mjs +17 -46
  394. package/tui/index.mjs +10 -5
  395. package/tui/lib/boot-timing.mjs +8 -8
  396. package/tui/lib/busy-words.mjs +21 -22
  397. package/tui/lib/export.mjs +100 -32
  398. package/tui/lib/knowledge-command.mjs +64 -19
  399. package/tui/lib/knowledge-import.mjs +52 -18
  400. package/tui/lib/render.mjs +65 -33
  401. package/tui/lib/save-file.mjs +30 -13
  402. package/tui/lib/select.mjs +23 -5
  403. package/tui/lib/selection.mjs +6 -4
  404. package/tui/lib/setup.mjs +11 -19
  405. package/tui/lib/sidebar.mjs +23 -13
  406. package/tui/lib/splash.mjs +6 -7
  407. package/tui/lib/upload-frames.mjs +1 -2
  408. package/tui/lib/usage.mjs +13 -9
  409. package/tui/lib/wrap.mjs +35 -6
  410. package/tui/main.mjs +54 -78
  411. package/worker/assistant-sidecar.mjs +5 -10
  412. package/worker/stow-entry.mjs +7 -4
  413. package/dist-lib/lib/custom-model-source.d.ts +0 -15
  414. package/dist-lib/lib/custom-model-source.js +0 -46
  415. package/dist-lib/lib/oauth/common.d.ts +0 -38
  416. package/dist-lib/lib/oauth/common.js +0 -34
  417. package/dist-lib/schema/helpers.d.ts +0 -32
@@ -0,0 +1,256 @@
1
+ import crypto from 'hypercore-crypto';
2
+ import { liveDeviceForWriter, trackActivity } from './activity.js';
3
+ import { nextGrantSequence, removedSinceMint } from './grant-order.js';
4
+ import { meshKind } from './mesh-kind.js';
5
+ import { isKickedRow } from '../helpers/index.js';
6
+ import { inviteGrantTermsRefusal, verifyInviteClaim } from '../invite-grants.js';
7
+ import { admitDevice } from './writers.js';
8
+ import { linkMember, provenMember } from './members.js';
9
+ import b4a from 'b4a';
10
+ import { DEVICES, MESH_INVITE_GRANTS, MESH_INVITE_SPENDS, WRITER_ACTIVITY } from '../collections.js';
11
+ function hex(buffer) {
12
+ return b4a.toHex(buffer).slice(0, 16);
13
+ }
14
+ async function kickedFromOutside(tx, device, memberId) {
15
+ if (!device.revokedBy)
16
+ return false;
17
+ const activity = await tx.get(WRITER_ACTIVITY, {
18
+ writerKey: device.revokedBy
19
+ });
20
+ const kicker = activity && (await tx.get(DEVICES, { id: activity.deviceId }));
21
+ if (!kicker) {
22
+ return false;
23
+ }
24
+ const kickerMember = kicker.memberId ?? kicker.claimedMemberId;
25
+ return !kickerMember || !b4a.equals(kickerMember, memberId);
26
+ }
27
+ export async function memberStanding(tx, memberId, grant) {
28
+ if (await removedSinceMint(tx, memberId, grant))
29
+ return 'removed';
30
+ for await (const device of tx.find(DEVICES)) {
31
+ if (device.revoked)
32
+ continue;
33
+ const member = device.memberId ?? device.claimedMemberId;
34
+ if (member && b4a.equals(member, memberId)) {
35
+ return 'present';
36
+ }
37
+ }
38
+ return null;
39
+ }
40
+ export async function inviteStanding(tx, { device, memberId, grant, compute = false }) {
41
+ const standing = await memberStanding(tx, memberId, grant);
42
+ if (standing !== 'present') {
43
+ return standing;
44
+ }
45
+ if (compute || (await meshKind(tx)) !== 'shared') {
46
+ return null;
47
+ }
48
+ if (!device?.revoked) {
49
+ return 'present';
50
+ }
51
+ return (await removedBy(tx, device)) === 'own-member' ? 'present' : null;
52
+ }
53
+ export async function belongsToAnotherMember(tx, device, memberId) {
54
+ if (!device?.memberId || b4a.equals(device.memberId, memberId))
55
+ return false;
56
+ return !device.revoked || (await removedBy(tx, device)) === 'another-member';
57
+ }
58
+ async function removedBy(tx, device) {
59
+ if (!isKickedRow(device))
60
+ return 'itself';
61
+ const owner = device.memberId ?? device.claimedMemberId;
62
+ if (!owner) {
63
+ return 'another-member';
64
+ }
65
+ return (await kickedFromOutside(tx, device, owner)) ? 'another-member' : 'own-member';
66
+ }
67
+ export function registerInviteRoutes(router, { compute = false } = {}) {
68
+ router.add('@qvac/put-mesh-invite-grant', trackActivity(async ({ grant }, { tx, node, log }) => {
69
+ if ((await meshKind(tx)) === 'account') {
70
+ log?.warn('contract', 'put-mesh-invite-grant dropped: an account takes no grant');
71
+ return;
72
+ }
73
+ const author = await liveDeviceForWriter(tx, node.key);
74
+ if (!author) {
75
+ log?.warn('contract', 'put-mesh-invite-grant dropped: the writer has no device row');
76
+ return;
77
+ }
78
+ const existing = await tx.get(MESH_INVITE_GRANTS, {
79
+ grantKey: grant.grantKey
80
+ });
81
+ if (!existing) {
82
+ const refusal = inviteGrantTermsRefusal(grant, node.timestamp);
83
+ if (refusal) {
84
+ log?.warn('contract', 'put-mesh-invite-grant dropped: ' + refusal, {
85
+ grantKey: hex(grant.grantKey)
86
+ });
87
+ return;
88
+ }
89
+ const minted = {
90
+ grantKey: grant.grantKey,
91
+ kind: grant.kind,
92
+ issuerDeviceId: author.id,
93
+ issuerMemberId: author.memberId ?? null,
94
+ issuedAt: node.timestamp,
95
+ expiresAt: grant.expiresAt,
96
+ maxUses: grant.maxUses,
97
+ uses: 0,
98
+ revokedAt: grant.revokedAt,
99
+ revokedBy: grant.revokedAt ? node.key : null,
100
+ updatedAt: grant.updatedAt,
101
+ sequence: await nextGrantSequence(tx)
102
+ };
103
+ await tx.insert(MESH_INVITE_GRANTS, minted);
104
+ log?.info('contract', 'invite grant minted', { grantKey: hex(grant.grantKey) });
105
+ return minted;
106
+ }
107
+ if (!grant.revokedAt) {
108
+ log?.debug('contract', 'put-mesh-invite-grant dropped: terms are fixed at the mint', {
109
+ grantKey: hex(grant.grantKey)
110
+ });
111
+ return;
112
+ }
113
+ if (existing.revokedAt) {
114
+ log?.debug('contract', 'put-mesh-invite-grant dropped: already revoked', {
115
+ grantKey: hex(grant.grantKey)
116
+ });
117
+ return;
118
+ }
119
+ const revoked = {
120
+ ...existing,
121
+ revokedAt: grant.revokedAt,
122
+ revokedBy: node.key,
123
+ updatedAt: grant.updatedAt
124
+ };
125
+ await tx.insert(MESH_INVITE_GRANTS, revoked);
126
+ log?.info('contract', 'invite grant revoked', { grantKey: hex(grant.grantKey) });
127
+ return revoked;
128
+ }));
129
+ router.add('@qvac/claim-invite', trackActivity(async (payload, context) => {
130
+ const { tx, node, host, meshPublicKey, log } = context;
131
+ if ((await meshKind(tx)) === 'account') {
132
+ log?.warn('contract', 'claim-invite dropped: an account takes no grant');
133
+ return;
134
+ }
135
+ let valid = false;
136
+ try {
137
+ valid = crypto.verify(node.key, payload.signature, meshPublicKey);
138
+ }
139
+ catch {
140
+ valid = false;
141
+ }
142
+ if (!valid) {
143
+ log?.warn('contract', 'claim-invite dropped: invalid writer-claim signature');
144
+ return;
145
+ }
146
+ const deviceId = payload.deviceId;
147
+ if (!deviceId) {
148
+ log?.warn('contract', 'claim-invite dropped: a redemption is counted per device');
149
+ return;
150
+ }
151
+ const ids = { grantKey: hex(payload.grantKey), device: hex(deviceId) };
152
+ const grant = await tx.get(MESH_INVITE_GRANTS, {
153
+ grantKey: payload.grantKey
154
+ });
155
+ if (!grant) {
156
+ log?.warn('contract', 'claim-invite dropped: the mesh holds no such grant', ids);
157
+ return;
158
+ }
159
+ if (grant.revokedAt) {
160
+ log?.warn('contract', 'claim-invite dropped: the grant was revoked', ids);
161
+ return;
162
+ }
163
+ const issuer = grant.issuerDeviceId && (await tx.get(DEVICES, { id: grant.issuerDeviceId }));
164
+ if (!issuer || issuer.revoked) {
165
+ log?.warn('contract', 'claim-invite dropped: the device that minted the grant is gone', ids);
166
+ return;
167
+ }
168
+ if (!verifyInviteClaim(payload.inviteSignature, {
169
+ meshPublicKey,
170
+ grantKey: payload.grantKey,
171
+ deviceId,
172
+ writerKey: node.key
173
+ })) {
174
+ log?.warn('contract', 'claim-invite dropped: the claim does not hold the grant secret', ids);
175
+ return;
176
+ }
177
+ const spent = await tx.get(MESH_INVITE_SPENDS, {
178
+ grantKey: payload.grantKey,
179
+ deviceId
180
+ });
181
+ const existing = await tx.get(DEVICES, { id: deviceId });
182
+ if (spent && (!existing || existing.revoked)) {
183
+ log?.warn('contract', 'claim-invite dropped: a revoked device may not replay its spend', ids);
184
+ return;
185
+ }
186
+ if (!spent && grant.expiresAt && node.timestamp > grant.expiresAt) {
187
+ log?.warn('contract', 'claim-invite dropped: the grant expired', ids);
188
+ return;
189
+ }
190
+ if (!spent && grant.maxUses && (grant.uses ?? 0) >= grant.maxUses) {
191
+ log?.warn('contract', 'claim-invite dropped: the grant is used up', ids);
192
+ return;
193
+ }
194
+ if (existing && !existing.revoked && !spent) {
195
+ log?.warn('contract', 'claim-invite dropped: the device is already live here', ids);
196
+ return;
197
+ }
198
+ if (!payload.device || !payload.member || !payload.memberClaim) {
199
+ log?.warn('contract', 'claim-invite dropped: no device profile and member claim', ids);
200
+ return;
201
+ }
202
+ const memberId = payload.member.id;
203
+ const proof = await provenMember(meshPublicKey, {
204
+ deviceId,
205
+ writerKey: node.key,
206
+ memberId,
207
+ claim: payload.memberClaim
208
+ });
209
+ if (!proof) {
210
+ log?.warn('contract', 'claim-invite dropped: the member claim does not bind this writer', ids);
211
+ return;
212
+ }
213
+ if (await belongsToAnotherMember(tx, existing, memberId)) {
214
+ log?.warn('contract', 'claim-invite dropped: the device belongs to another member', ids);
215
+ return;
216
+ }
217
+ const standing = spent
218
+ ? null
219
+ : await inviteStanding(tx, { device: existing, memberId, grant, compute });
220
+ if (standing === 'present') {
221
+ log?.warn('contract', 'claim-invite dropped: the member is still present', ids);
222
+ return;
223
+ }
224
+ if (standing === 'removed') {
225
+ log?.warn('contract', 'claim-invite dropped: the member was removed after the mint', ids);
226
+ return;
227
+ }
228
+ const admission = await admitDevice(context, payload.device, {
229
+ id: deviceId,
230
+ writerKey: node.key,
231
+ claim: payload
232
+ });
233
+ if (admission === 'refused') {
234
+ return;
235
+ }
236
+ if (!spent) {
237
+ await tx.insert(MESH_INVITE_SPENDS, {
238
+ grantKey: payload.grantKey,
239
+ deviceId,
240
+ spentAt: node.timestamp
241
+ });
242
+ await tx.insert(MESH_INVITE_GRANTS, {
243
+ ...grant,
244
+ uses: (grant.uses ?? 0) + 1
245
+ });
246
+ }
247
+ const admitted = await tx.get(DEVICES, { id: deviceId });
248
+ if (!admitted) {
249
+ return;
250
+ }
251
+ await linkMember(tx, admitted, { member: payload.member, proof });
252
+ await host.addWriter(node.key);
253
+ log?.info('contract', 'invite redeemed', ids);
254
+ return payload.device;
255
+ }));
256
+ }
@@ -1,42 +1,42 @@
1
1
  import { liveDeviceForWriter, trackActivity } from './activity.js';
2
2
  import b4a from 'b4a';
3
- const JOINED_MESHES = '@qvac/joined-meshes';
3
+ import { JOINED_MESHES } from '../collections.js';
4
4
  export function registerJoinedMeshRoutes(router) {
5
- router.add('@qvac/put-joined-mesh', trackActivity(async ({ room }, { tx, node, log }) => {
5
+ router.add('@qvac/put-joined-mesh', trackActivity(async ({ room: mesh }, { tx, node, log }) => {
6
6
  const author = await liveDeviceForWriter(tx, node.key);
7
- if (!author?.memberId?.equals(room.memberId)) {
7
+ if (!(author?.memberId && b4a.equals(author?.memberId, mesh.memberId))) {
8
8
  log?.warn('contract', 'put-joined-mesh refused: author is not a device of that member', {
9
- meshKey: b4a.toHex(room.meshKey).slice(0, 8)
9
+ meshKey: b4a.toHex(mesh.meshKey).slice(0, 8)
10
10
  });
11
11
  return;
12
12
  }
13
- const existing = await tx.get(JOINED_MESHES, { meshKey: room.meshKey });
14
- if (existing && existing.joinedAt > room.joinedAt) {
13
+ const existing = await tx.get(JOINED_MESHES, { meshKey: mesh.meshKey });
14
+ if (existing && existing.joinedAt > mesh.joinedAt) {
15
15
  log?.debug('contract', 'put-joined-mesh dropped: stale joinedAt', {
16
- meshKey: b4a.toHex(room.meshKey).slice(0, 8)
16
+ meshKey: b4a.toHex(mesh.meshKey).slice(0, 8)
17
17
  });
18
18
  return;
19
19
  }
20
- const rejoin = Boolean(existing) && room.joinedAt > existing.joinedAt;
21
- const next = existing ? merge(room, existing, rejoin) : room;
20
+ const rejoin = !!existing && mesh.joinedAt > existing.joinedAt;
21
+ const next = existing ? merge(mesh, existing, rejoin) : mesh;
22
22
  await tx.insert(JOINED_MESHES, next);
23
- log?.debug('contract', next.leftAt ? 'joined room released' : 'joined room recorded', {
24
- meshKey: b4a.toHex(room.meshKey).slice(0, 8)
23
+ log?.debug('contract', next.leftAt ? 'joined mesh released' : 'joined mesh recorded', {
24
+ meshKey: b4a.toHex(mesh.meshKey).slice(0, 8)
25
25
  });
26
26
  return next;
27
27
  }));
28
28
  }
29
- function merge(room, existing, rejoin) {
30
- const relabels = (room.labeledAt ?? 0) > (existing.labeledAt ?? 0);
31
- const remarks = (room.sharedAt ?? 0) > (existing.sharedAt ?? 0);
29
+ function merge(mesh, existing, rejoin) {
30
+ const relabels = (mesh.labeledAt ?? 0) > (existing.labeledAt ?? 0);
31
+ const remarks = (mesh.sharedAt ?? 0) > (existing.sharedAt ?? 0);
32
32
  return {
33
- meshKey: room.meshKey,
34
- memberId: room.memberId,
35
- joinedAt: room.joinedAt,
36
- leftAt: rejoin ? room.leftAt : room.leftAt || existing.leftAt,
37
- label: relabels ? room.label : existing.label,
38
- labeledAt: relabels ? room.labeledAt : existing.labeledAt,
39
- shared: remarks ? room.shared : existing.shared,
40
- sharedAt: remarks ? room.sharedAt : existing.sharedAt
33
+ meshKey: mesh.meshKey,
34
+ memberId: mesh.memberId,
35
+ joinedAt: mesh.joinedAt,
36
+ leftAt: rejoin ? mesh.leftAt : mesh.leftAt || existing.leftAt,
37
+ label: relabels ? mesh.label : existing.label,
38
+ labeledAt: relabels ? mesh.labeledAt : existing.labeledAt,
39
+ shared: remarks ? mesh.shared : existing.shared,
40
+ sharedAt: remarks ? mesh.sharedAt : existing.sharedAt
41
41
  };
42
42
  }
@@ -1,8 +1,6 @@
1
1
  import { trackActivity } from './activity.js';
2
2
  import { assertArtifactOutput } from '../files/index.js';
3
- const CHATS = '@qvac/chats';
4
- const KNOWLEDGE = '@qvac/knowledge';
5
- const KNOWLEDGE_ARTIFACTS = '@qvac/knowledge-artifacts';
3
+ import { CHATS, KNOWLEDGE, KNOWLEDGE_ARTIFACTS } from '../collections.js';
6
4
  export function registerKnowledgeRoutes(router) {
7
5
  router.add('@qvac/add-knowledge', trackActivity(async ({ knowledge }, { tx, log }) => {
8
6
  const chat = await tx.get(CHATS, { id: knowledge.chatId });
@@ -29,8 +27,9 @@ export function registerKnowledgeRoutes(router) {
29
27
  });
30
28
  return;
31
29
  }
32
- if (existing.deletedAt)
30
+ if (existing.deletedAt) {
33
31
  return;
32
+ }
34
33
  const updatedAt = Math.max(existing.updatedAt + 1, op.at);
35
34
  const tombstoned = { ...existing, deletedAt: op.at, updatedAt };
36
35
  await tx.insert(KNOWLEDGE, tombstoned);
@@ -47,8 +46,9 @@ export function registerKnowledgeRoutes(router) {
47
46
  const existing = await tx.get(KNOWLEDGE_ARTIFACTS, {
48
47
  id: artifact.id
49
48
  });
50
- if (existing)
49
+ if (existing) {
51
50
  return;
51
+ }
52
52
  await tx.insert(KNOWLEDGE_ARTIFACTS, artifact);
53
53
  return artifact;
54
54
  }));
@@ -1,2 +1,17 @@
1
+ import type HyperDB from 'hyperdb';
1
2
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
3
+ import type { QvacDevice, QvacMember } from '../../../spec/mesh/hyperschema/types.d.ts';
4
+ interface MemberClaim {
5
+ readonly deviceId: Buffer;
6
+ readonly writerKey: Buffer;
7
+ readonly memberId: Buffer;
8
+ readonly claim: Buffer;
9
+ }
10
+ export declare function provenMember(meshPublicKey: Buffer, { deviceId, writerKey, memberId, claim }: MemberClaim): Promise<Buffer | null>;
11
+ interface LinkMemberOptions {
12
+ readonly member: QvacMember;
13
+ readonly proof: Buffer;
14
+ }
15
+ export declare function linkMember(tx: HyperDB, device: QvacDevice, { member, proof }: LinkMemberOptions): Promise<QvacMember>;
2
16
  export declare function registerMemberRoutes(router: Router): void;
17
+ export {};
@@ -1,12 +1,36 @@
1
- import { bareDeviceProof, claimAttestation, verifyDeviceProof, verifyMemberClaim } from '../identity.js';
1
+ import crypto from 'hypercore-crypto';
2
+ import { bareDeviceProof, claimAttestation, verifyDeviceProof, verifyMemberClaim, verifyRecoveryClaim } from '../identity.js';
3
+ import { isKickedRow } from '../helpers/index.js';
2
4
  import { liveDeviceForWriter, trackActivity } from './activity.js';
5
+ import { meshKind } from './mesh-kind.js';
6
+ import { admitDevice } from './writers.js';
3
7
  import b4a from 'b4a';
4
- const DEVICES = '@qvac/devices';
5
- const MEMBERS = '@qvac/members';
8
+ import { DEVICES, MEMBERS, MESH_FOUNDERS } from '../collections.js';
6
9
  function hex(buffer) {
7
10
  return b4a.toHex(buffer).slice(0, 16);
8
11
  }
9
- function link(device, memberId, proof, attestedAt) {
12
+ export async function provenMember(meshPublicKey, { deviceId, writerKey, memberId, claim }) {
13
+ const attestation = claimAttestation(meshPublicKey, deviceId, writerKey);
14
+ if (!(await verifyMemberClaim(claim, { memberId, deviceId, attestation }))) {
15
+ return null;
16
+ }
17
+ return bareDeviceProof(claim);
18
+ }
19
+ export async function linkMember(tx, device, { member, proof }) {
20
+ const existing = await tx.get(MEMBERS, { id: member.id });
21
+ const joined = existing ?? {
22
+ id: member.id,
23
+ name: member.name,
24
+ joinedAt: member.joinedAt,
25
+ updatedAt: member.updatedAt
26
+ };
27
+ if (!existing) {
28
+ await tx.insert(MEMBERS, joined);
29
+ }
30
+ await tx.insert(DEVICES, link(device, { memberId: member.id, proof, attestedAt: member.joinedAt }));
31
+ return joined;
32
+ }
33
+ function link(device, { memberId, proof, attestedAt }) {
10
34
  return {
11
35
  ...device,
12
36
  memberId,
@@ -42,13 +66,14 @@ export function registerMemberRoutes(router) {
42
66
  updatedAt: member.updatedAt
43
67
  };
44
68
  await tx.insert(MEMBERS, minted);
45
- await tx.insert(DEVICES, link(minter, member.id, proof, member.joinedAt));
69
+ await tx.insert(MESH_FOUNDERS, { id: 'mesh', memberId: member.id });
70
+ await tx.insert(DEVICES, link(minter, { memberId: member.id, proof, attestedAt: member.joinedAt }));
46
71
  log?.info('contract', 'member minted', { id: b4a.toHex(member.id).slice(0, 16) });
47
72
  return minted;
48
73
  }));
49
74
  router.add('@qvac/update-member', trackActivity(async ({ member }, { tx, node, log }) => {
50
75
  const author = await liveDeviceForWriter(tx, node.key);
51
- if (!author?.memberId?.equals(member.id)) {
76
+ if (!author?.memberId || !b4a.equals(author.memberId, member.id)) {
52
77
  log?.warn('contract', 'update-member dropped: the writer is no device of this member');
53
78
  return;
54
79
  }
@@ -72,6 +97,10 @@ export function registerMemberRoutes(router) {
72
97
  }));
73
98
  router.add('@qvac/join-member', trackActivity(async ({ member, proof }, context) => {
74
99
  const { tx, node, log, meshPublicKey } = context;
100
+ if ((await meshKind(tx)) === 'shared') {
101
+ log?.warn('contract', 'join-member dropped: a shared mesh links a device only at admission');
102
+ return;
103
+ }
75
104
  const author = await liveDeviceForWriter(tx, node.key);
76
105
  const ids = {
77
106
  writer: hex(node.key),
@@ -83,7 +112,7 @@ export function registerMemberRoutes(router) {
83
112
  return;
84
113
  }
85
114
  if (author.memberId) {
86
- if (author.memberId.equals(member.id)) {
115
+ if (b4a.equals(author.memberId, member.id)) {
87
116
  log?.debug('contract', 'join-member dropped: the device is already owned by this member', ids);
88
117
  }
89
118
  else {
@@ -94,13 +123,13 @@ export function registerMemberRoutes(router) {
94
123
  }
95
124
  return;
96
125
  }
97
- const attestation = claimAttestation(meshPublicKey, author.id, node.key);
98
- const valid = await verifyMemberClaim(proof, {
99
- memberId: member.id,
126
+ const stored = await provenMember(meshPublicKey, {
100
127
  deviceId: author.id,
101
- attestation
128
+ writerKey: node.key,
129
+ memberId: member.id,
130
+ claim: proof
102
131
  });
103
- if (!valid) {
132
+ if (!stored) {
104
133
  log?.warn('contract', 'join-member dropped: the claim does not bind this mesh and writer', {
105
134
  ...ids,
106
135
  mesh: hex(meshPublicKey),
@@ -108,36 +137,90 @@ export function registerMemberRoutes(router) {
108
137
  });
109
138
  return;
110
139
  }
111
- const stored = bareDeviceProof(proof);
112
- if (!stored) {
113
- log?.warn('contract', 'join-member dropped: the proof does not re-encode', ids);
114
- return;
115
- }
116
- const existing = await tx.get(MEMBERS, { id: member.id });
117
- const joined = existing ?? {
118
- id: member.id,
119
- name: member.name,
120
- joinedAt: member.joinedAt,
121
- updatedAt: member.updatedAt
122
- };
123
- if (!existing)
124
- await tx.insert(MEMBERS, joined);
125
- await tx.insert(DEVICES, link(author, member.id, stored, member.joinedAt));
140
+ const joined = await linkMember(tx, author, { member, proof: stored });
126
141
  log?.info('contract', 'member joined', ids);
127
142
  return joined;
128
143
  }));
144
+ router.add('@qvac/recover-device', trackActivity(async (payload, context) => {
145
+ const { tx, node, host, log, meshPublicKey } = context;
146
+ const { deviceId, memberId, proof } = payload;
147
+ const ids = { writer: hex(node.key), device: hex(deviceId), member: hex(memberId) };
148
+ let valid = false;
149
+ try {
150
+ valid = crypto.verify(node.key, payload.signature, meshPublicKey);
151
+ }
152
+ catch {
153
+ valid = false;
154
+ }
155
+ if (!valid) {
156
+ log?.warn('contract', 'recover-device dropped: invalid writer-claim signature', ids);
157
+ return;
158
+ }
159
+ if ((await meshKind(tx)) === 'shared') {
160
+ log?.warn('contract', 'recover-device dropped: a shared mesh is not recovered into', ids);
161
+ return;
162
+ }
163
+ if (!(await tx.get(MEMBERS, { id: memberId }))) {
164
+ log?.warn('contract', 'recover-device dropped: the mesh holds no such member', ids);
165
+ return;
166
+ }
167
+ const existing = await tx.get(DEVICES, { id: deviceId });
168
+ if (existing && isKickedRow(existing)) {
169
+ log?.warn('contract', 'recover-device dropped: the device was removed', ids);
170
+ return;
171
+ }
172
+ if (existing?.memberId && !b4a.equals(existing.memberId, memberId)) {
173
+ log?.warn('contract', 'recover-device dropped: the device is owned by another member', ids);
174
+ return;
175
+ }
176
+ const recovered = await verifyRecoveryClaim(proof, {
177
+ memberId,
178
+ deviceId,
179
+ attestation: claimAttestation(meshPublicKey, deviceId, node.key)
180
+ });
181
+ const deviceProof = recovered ? bareDeviceProof(proof) : null;
182
+ if (!deviceProof) {
183
+ log?.warn('contract', "recover-device dropped: the claim is not the identity's own", ids);
184
+ return;
185
+ }
186
+ const admission = await admitDevice(context, payload.device, {
187
+ id: deviceId,
188
+ writerKey: node.key,
189
+ claim: payload
190
+ });
191
+ if (admission === 'refused') {
192
+ return;
193
+ }
194
+ await host.addWriter(node.key);
195
+ const admitted = await tx.get(DEVICES, { id: deviceId });
196
+ if (!admitted) {
197
+ return;
198
+ }
199
+ await tx.insert(DEVICES, link(admitted, {
200
+ memberId,
201
+ proof: deviceProof,
202
+ attestedAt: payload.device.joinedAt
203
+ }));
204
+ log?.info('contract', 'device recovered into its member', ids);
205
+ return payload.device;
206
+ }));
129
207
  router.add('@qvac/attest-member-device', async (op, { tx, node, log }) => {
130
208
  const device = await tx.get(DEVICES, { id: op.deviceId });
131
209
  if (!device) {
132
210
  log?.debug('contract', 'attest-member-device dropped: unknown device');
133
211
  return;
134
212
  }
135
- if (device.memberId && !device.memberId.equals(op.memberId)) {
213
+ if (device.memberId && !b4a.equals(device.memberId, op.memberId)) {
136
214
  log?.warn('contract', 'attest-member-device dropped: a device may not change member');
137
215
  return;
138
216
  }
139
217
  const signer = await liveDeviceForWriter(tx, node.key);
140
- const speaksForMember = signer?.memberId?.equals(op.memberId) || signer?.id.equals(op.deviceId);
218
+ if (signer?.id && b4a.equals(signer?.id, op.deviceId) && (await meshKind(tx)) === 'shared') {
219
+ log?.warn('contract', 'attest-member-device dropped: a shared mesh links a device only at admission');
220
+ return;
221
+ }
222
+ const speaksForMember = (!!signer?.memberId && b4a.equals(signer.memberId, op.memberId)) ||
223
+ (!!signer?.id && b4a.equals(signer.id, op.deviceId));
141
224
  if (!speaksForMember) {
142
225
  log?.warn('contract', 'attest-member-device dropped: the writer speaks for another member');
143
226
  return;
@@ -151,11 +234,13 @@ export function registerMemberRoutes(router) {
151
234
  log?.warn('contract', 'attest-member-device dropped: the proof does not stand');
152
235
  return;
153
236
  }
154
- if (device.memberId?.equals(op.memberId) && op.attestedAt <= (device.attestedAt || 0)) {
237
+ if (device.memberId &&
238
+ b4a.equals(device.memberId, op.memberId) &&
239
+ op.attestedAt <= (device.attestedAt || 0)) {
155
240
  log?.debug('contract', 'attest-member-device dropped: not newer than the stored attestation');
156
241
  return;
157
242
  }
158
- await tx.insert(DEVICES, link(device, op.memberId, op.proof, op.attestedAt));
243
+ await tx.insert(DEVICES, link(device, { memberId: op.memberId, proof: op.proof, attestedAt: op.attestedAt }));
159
244
  log?.info('contract', 'device attested to a member', {
160
245
  id: b4a.toHex(op.deviceId).slice(0, 16)
161
246
  });
@@ -0,0 +1,6 @@
1
+ import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
+ import type { RouterContext } from './types.ts';
3
+ export declare function meshKind(tx: RouterContext['tx']): Promise<string | null>;
4
+ export declare function registerMeshKindRoutes(router: Router, { compute }?: {
5
+ compute?: boolean | undefined;
6
+ }): void;
@@ -0,0 +1,49 @@
1
+ import { liveDeviceForWriter, trackActivity } from './activity.js';
2
+ import b4a from 'b4a';
3
+ import { MEMBERS, MESH_FOUNDERS, MESH_KINDS } from '../collections.js';
4
+ const ROW = 'mesh';
5
+ export async function meshKind(tx) {
6
+ const row = await tx.get(MESH_KINDS, { id: ROW });
7
+ return row?.kind ?? null;
8
+ }
9
+ async function mayMint(kind, { tx, host, node }, compute) {
10
+ if (kind === 'shared')
11
+ return host.genesis;
12
+ if (kind !== 'account' || compute)
13
+ return false;
14
+ const memberId = (await liveDeviceForWriter(tx, node.key))?.memberId;
15
+ if (!memberId) {
16
+ return false;
17
+ }
18
+ const founder = await tx.get(MESH_FOUNDERS, { id: ROW });
19
+ if (founder) {
20
+ return b4a.equals(founder.memberId, memberId);
21
+ }
22
+ for await (const member of tx.find(MEMBERS)) {
23
+ if (!b4a.equals(member.id, memberId))
24
+ return false;
25
+ }
26
+ return true;
27
+ }
28
+ export function registerMeshKindRoutes(router, { compute = false } = {}) {
29
+ router.add('@qvac/mint-mesh-kind', trackActivity(async ({ kind }, context) => {
30
+ const { tx, log } = context;
31
+ const existing = await tx.get(MESH_KINDS, { id: ROW });
32
+ if (existing) {
33
+ log?.debug('contract', 'mint-mesh-kind dropped: a kind is minted once', {
34
+ kind: existing.kind
35
+ });
36
+ return;
37
+ }
38
+ if (!(await mayMint(kind, context, compute))) {
39
+ log?.warn('contract', 'mint-mesh-kind dropped: not a shared mesh birth or a member sealing', {
40
+ kind
41
+ });
42
+ return;
43
+ }
44
+ const row = { id: ROW, kind };
45
+ await tx.insert(MESH_KINDS, row);
46
+ log?.info('contract', 'mesh kind stamped', { kind });
47
+ return row;
48
+ }));
49
+ }
@@ -1,4 +1,4 @@
1
- const DEVICES = '@qvac/devices';
1
+ import { DEVICES } from '../collections.js';
2
2
  export async function sealed(tx) {
3
3
  for await (const row of tx.find(DEVICES)) {
4
4
  if (row.deviceSignature)
@@ -1,7 +1,5 @@
1
1
  import { trackActivity } from './activity.js';
2
- const AGENTS = '@qvac/agents';
3
- const CHATS = '@qvac/chats';
4
- const MESH_BLIND_PEERS = '@qvac/mesh-blind-peers';
2
+ import { AGENTS, CHATS, MESH_BLIND_PEERS } from '../collections.js';
5
3
  export function registerSeedDefaultsRoutes(router) {
6
4
  router.add('@qvac/seed-defaults', trackActivity(async (op, { tx, log }) => {
7
5
  let seeded = false;