@qvac/core 1.0.0-rc.0 → 1.0.0-rc.2

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 (509) hide show
  1. package/CHANGELOG.md +852 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +0 -1
  4. package/dist-lib/index.js +0 -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 +7 -0
  17. package/dist-lib/lib/api/chunk-delta.js +33 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +64 -13
  20. package/dist-lib/lib/api/config.d.ts +2 -1
  21. package/dist-lib/lib/api/config.js +3 -2
  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 +10 -8
  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 +20 -10
  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/host-run-log.d.ts +2 -41
  35. package/dist-lib/lib/api/host-run-log.js +35 -83
  36. package/dist-lib/lib/api/index.d.ts +28 -6
  37. package/dist-lib/lib/api/index.js +101 -33
  38. package/dist-lib/lib/api/instrument.d.ts +2 -2
  39. package/dist-lib/lib/api/instrument.js +12 -44
  40. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  41. package/dist-lib/lib/api/knowledge.js +25 -7
  42. package/dist-lib/lib/api/local-files.d.ts +5 -1
  43. package/dist-lib/lib/api/local-files.js +9 -5
  44. package/dist-lib/lib/api/logs.js +3 -3
  45. package/dist-lib/lib/api/members.d.ts +10 -1
  46. package/dist-lib/lib/api/members.js +64 -17
  47. package/dist-lib/lib/api/mesh.d.ts +12 -2
  48. package/dist-lib/lib/api/mesh.js +10 -6
  49. package/dist-lib/lib/api/model-download.d.ts +2 -1
  50. package/dist-lib/lib/api/model-download.js +2 -2
  51. package/dist-lib/lib/api/network.d.ts +10 -2
  52. package/dist-lib/lib/api/network.js +8 -2
  53. package/dist-lib/lib/api/notifications.d.ts +3 -1
  54. package/dist-lib/lib/api/notifications.js +6 -5
  55. package/dist-lib/lib/api/projects.d.ts +20 -0
  56. package/dist-lib/lib/api/projects.js +165 -0
  57. package/dist-lib/lib/api/rag.d.ts +0 -1
  58. package/dist-lib/lib/api/rag.js +47 -23
  59. package/dist-lib/lib/api/served.d.ts +17 -0
  60. package/dist-lib/lib/api/served.js +47 -0
  61. package/dist-lib/lib/api/sync.d.ts +2 -1
  62. package/dist-lib/lib/api/sync.js +2 -2
  63. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  64. package/dist-lib/lib/api/tool-activity.js +4 -3
  65. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-configs.js +6 -9
  67. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  68. package/dist-lib/lib/api/upload-frames.js +0 -1
  69. package/dist-lib/lib/api/watchable.d.ts +3 -2
  70. package/dist-lib/lib/api/watchable.js +2 -3
  71. package/dist-lib/lib/api/workspace.d.ts +5 -0
  72. package/dist-lib/lib/api/workspace.js +48 -0
  73. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  74. package/dist-lib/lib/assistant/fake-models.js +112 -0
  75. package/dist-lib/lib/assistant/harness.d.ts +29 -29
  76. package/dist-lib/lib/assistant/harness.js +34 -6
  77. package/dist-lib/lib/assistant/history.d.ts +30 -17
  78. package/dist-lib/lib/assistant/history.js +168 -82
  79. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  80. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  81. package/dist-lib/lib/assistant/message.d.ts +21 -0
  82. package/dist-lib/lib/assistant/message.js +43 -0
  83. package/dist-lib/lib/assistant/model-round.d.ts +95 -0
  84. package/dist-lib/lib/assistant/model-round.js +591 -0
  85. package/dist-lib/lib/assistant/pdf-budget.d.ts +3 -0
  86. package/dist-lib/lib/assistant/pdf-budget.js +13 -0
  87. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  88. package/dist-lib/lib/assistant/round-host.js +239 -0
  89. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  90. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  91. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  92. package/dist-lib/lib/assistant/video-budget.js +29 -0
  93. package/dist-lib/lib/assistant-client.d.ts +2 -0
  94. package/dist-lib/lib/assistant-client.js +4 -3
  95. package/dist-lib/lib/assistant-tree.d.ts +8 -3
  96. package/dist-lib/lib/assistant-tree.js +58 -18
  97. package/dist-lib/lib/assistant.d.ts +76 -20
  98. package/dist-lib/lib/assistant.js +1659 -1070
  99. package/dist-lib/lib/audio-format.js +1 -1
  100. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  101. package/dist-lib/lib/chat-suggestion.js +47 -0
  102. package/dist-lib/lib/client.d.ts +2 -2
  103. package/dist-lib/lib/constants.d.ts +7 -0
  104. package/dist-lib/lib/constants.js +7 -0
  105. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  106. package/dist-lib/lib/core/agent-copies.js +40 -0
  107. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  108. package/dist-lib/lib/core/agent-hosting.js +71 -0
  109. package/dist-lib/lib/core/agent.d.ts +9 -1
  110. package/dist-lib/lib/core/agent.js +45 -19
  111. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  112. package/dist-lib/lib/core/archived-mesh.js +77 -58
  113. package/dist-lib/lib/core/async-iterable.js +1 -1
  114. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  115. package/dist-lib/lib/core/blind-peers.js +1 -0
  116. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  117. package/dist-lib/lib/core/chat-activity.js +36 -22
  118. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  119. package/dist-lib/lib/core/chat-copy.js +395 -0
  120. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  121. package/dist-lib/lib/core/chat-fork.js +245 -0
  122. package/dist-lib/lib/core/chat-group.js +8 -7
  123. package/dist-lib/lib/core/chat-move.d.ts +71 -0
  124. package/dist-lib/lib/core/chat-move.js +567 -0
  125. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  126. package/dist-lib/lib/core/chat-order.js +19 -4
  127. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  128. package/dist-lib/lib/core/chat-project.js +15 -0
  129. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  130. package/dist-lib/lib/core/chat-read.js +49 -0
  131. package/dist-lib/lib/core/chat-search.js +14 -12
  132. package/dist-lib/lib/core/chat.d.ts +34 -4
  133. package/dist-lib/lib/core/chat.js +122 -39
  134. package/dist-lib/lib/core/chunk.d.ts +21 -4
  135. package/dist-lib/lib/core/chunk.js +138 -23
  136. package/dist-lib/lib/core/collections.d.ts +28 -0
  137. package/dist-lib/lib/core/collections.js +28 -0
  138. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  139. package/dist-lib/lib/core/contract/agent-join.js +108 -0
  140. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  141. package/dist-lib/lib/core/contract/agents.js +141 -3
  142. package/dist-lib/lib/core/contract/chat.d.ts +1 -0
  143. package/dist-lib/lib/core/contract/chat.js +42 -3
  144. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  145. package/dist-lib/lib/core/contract/chunks.js +112 -35
  146. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  147. package/dist-lib/lib/core/contract/index.js +35 -11
  148. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  149. package/dist-lib/lib/core/contract/indexing.js +51 -7
  150. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  151. package/dist-lib/lib/core/contract/invites.js +18 -9
  152. package/dist-lib/lib/core/contract/joined-meshes.js +2 -1
  153. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  154. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  155. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  156. package/dist-lib/lib/core/contract/members.js +34 -4
  157. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  158. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  159. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  160. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  161. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  162. package/dist-lib/lib/core/contract/mesh-rules.js +31 -0
  163. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  164. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  165. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  166. package/dist-lib/lib/core/contract/model-requests.js +279 -0
  167. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  168. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  169. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  170. package/dist-lib/lib/core/contract/open-join.js +77 -0
  171. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  172. package/dist-lib/lib/core/contract/project-device-keys.js +29 -0
  173. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  174. package/dist-lib/lib/core/contract/project-host-keys.js +40 -0
  175. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/project-order.js +25 -0
  177. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  178. package/dist-lib/lib/core/contract/projects.js +328 -0
  179. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  180. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  181. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  182. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  183. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  184. package/dist-lib/lib/core/contract/roles.js +120 -0
  185. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  186. package/dist-lib/lib/core/contract/run-requests.js +75 -0
  187. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  188. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  189. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  190. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  191. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  192. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  193. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  194. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  195. package/dist-lib/lib/core/contract/workspace.js +317 -0
  196. package/dist-lib/lib/core/contract/writers.js +82 -12
  197. package/dist-lib/lib/core/departures.d.ts +16 -5
  198. package/dist-lib/lib/core/departures.js +79 -6
  199. package/dist-lib/lib/core/device-control.d.ts +21 -0
  200. package/dist-lib/lib/core/device-control.js +91 -0
  201. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  202. package/dist-lib/lib/core/device-seal.js +22 -0
  203. package/dist-lib/lib/core/devices.js +1 -1
  204. package/dist-lib/lib/core/document-attachment.d.ts +7 -0
  205. package/dist-lib/lib/core/document-attachment.js +9 -0
  206. package/dist-lib/lib/core/files/attachments.js +5 -4
  207. package/dist-lib/lib/core/files/index.d.ts +21 -11
  208. package/dist-lib/lib/core/files/index.js +114 -28
  209. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  210. package/dist-lib/lib/core/files/knowledge.js +77 -5
  211. package/dist-lib/lib/core/files/preview/index.js +6 -2
  212. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  213. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  214. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  215. package/dist-lib/lib/core/files/processing/document.js +26 -2
  216. package/dist-lib/lib/core/files/processing/index.d.ts +7 -2
  217. package/dist-lib/lib/core/files/processing/index.js +91 -71
  218. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  219. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  220. package/dist-lib/lib/core/files/processing/source.d.ts +3 -0
  221. package/dist-lib/lib/core/files/processing/source.js +9 -4
  222. package/dist-lib/lib/core/files/processing/state.d.ts +4 -1
  223. package/dist-lib/lib/core/files/processing/state.js +2 -1
  224. package/dist-lib/lib/core/files/rag/build.d.ts +4 -1
  225. package/dist-lib/lib/core/files/rag/build.js +18 -7
  226. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  227. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  228. package/dist-lib/lib/core/files/rag/index.d.ts +12 -1
  229. package/dist-lib/lib/core/files/rag/index.js +29 -7
  230. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  231. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  232. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  233. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  234. package/dist-lib/lib/core/files/rag/load.js +6 -3
  235. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  236. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  237. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  238. package/dist-lib/lib/core/files/rag/produce.js +30 -18
  239. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -1
  240. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  241. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  242. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  243. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  244. package/dist-lib/lib/core/files/records/index.js +1 -1
  245. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  246. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  247. package/dist-lib/lib/core/files/records/purge.js +13 -8
  248. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  249. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  250. package/dist-lib/lib/core/files/records/routing.js +6 -2
  251. package/dist-lib/lib/core/files/records/source.js +3 -5
  252. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  253. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  254. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  255. package/dist-lib/lib/core/files/store/blob.js +2 -2
  256. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  257. package/dist-lib/lib/core/files/store/index.js +4 -1
  258. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  259. package/dist-lib/lib/core/files/store/reference.js +12 -2
  260. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  261. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  262. package/dist-lib/lib/core/files/upload.js +53 -14
  263. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  264. package/dist-lib/lib/core/fs-drives.js +30 -18
  265. package/dist-lib/lib/core/id.d.ts +1 -0
  266. package/dist-lib/lib/core/id.js +3 -0
  267. package/dist-lib/lib/core/identity.d.ts +3 -1
  268. package/dist-lib/lib/core/identity.js +25 -4
  269. package/dist-lib/lib/core/invite.d.ts +4 -0
  270. package/dist-lib/lib/core/invite.js +19 -6
  271. package/dist-lib/lib/core/local/files.d.ts +2 -1
  272. package/dist-lib/lib/core/local/files.js +5 -7
  273. package/dist-lib/lib/core/local/index.d.ts +76 -6
  274. package/dist-lib/lib/core/local/index.js +209 -19
  275. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  276. package/dist-lib/lib/core/local/run-logs.js +132 -0
  277. package/dist-lib/lib/core/member-key.d.ts +7 -0
  278. package/dist-lib/lib/core/member-key.js +24 -0
  279. package/dist-lib/lib/core/membership.d.ts +3 -14
  280. package/dist-lib/lib/core/membership.js +3 -96
  281. package/dist-lib/lib/core/mesh.d.ts +94 -28
  282. package/dist-lib/lib/core/mesh.js +527 -144
  283. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  284. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  285. package/dist-lib/lib/core/migrations/file-index.js +2 -4
  286. package/dist-lib/lib/core/migrations/index.js +6 -2
  287. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  288. package/dist-lib/lib/core/model-requests.js +65 -0
  289. package/dist-lib/lib/core/next-frame.js +2 -1
  290. package/dist-lib/lib/core/notification.js +4 -2
  291. package/dist-lib/lib/core/pdf/rasterize.d.ts +2 -2
  292. package/dist-lib/lib/core/pdf/rasterize.js +5 -6
  293. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  294. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +47 -40
  295. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  296. package/dist-lib/lib/core/project-keys.js +56 -0
  297. package/dist-lib/lib/core/prompt-history.js +4 -4
  298. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  299. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  300. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  301. package/dist-lib/lib/core/public-mesh.js +88 -0
  302. package/dist-lib/lib/core/purge.d.ts +3 -0
  303. package/dist-lib/lib/core/purge.js +7 -0
  304. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  305. package/dist-lib/lib/core/run-driver.js +20 -0
  306. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  307. package/dist-lib/lib/core/run-requests.js +59 -0
  308. package/dist-lib/lib/core/send.d.ts +2 -0
  309. package/dist-lib/lib/core/send.js +17 -4
  310. package/dist-lib/lib/core/senders.d.ts +18 -0
  311. package/dist-lib/lib/core/senders.js +52 -0
  312. package/dist-lib/lib/core/shared-agents.d.ts +39 -0
  313. package/dist-lib/lib/core/shared-agents.js +255 -0
  314. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  315. package/dist-lib/lib/core/skill-secrets.js +90 -72
  316. package/dist-lib/lib/core/sync/background.d.ts +47 -0
  317. package/dist-lib/lib/core/sync/background.js +162 -0
  318. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  319. package/dist-lib/lib/core/sync/changed.js +7 -0
  320. package/dist-lib/lib/core/sync/devices.js +1 -1
  321. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  322. package/dist-lib/lib/core/sync/files.js +50 -72
  323. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  324. package/dist-lib/lib/core/sync/index.js +154 -81
  325. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  326. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  327. package/dist-lib/lib/core/system-info.d.ts +2 -2
  328. package/dist-lib/lib/core/system-info.js +10 -11
  329. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  330. package/dist-lib/lib/core/tool-configs.js +11 -11
  331. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  332. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  333. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  334. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  335. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  336. package/dist-lib/lib/core/video/attachment.js +7 -0
  337. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  338. package/dist-lib/lib/core/video/digest.js +57 -0
  339. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  340. package/dist-lib/lib/core/video/frames.js +224 -0
  341. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  342. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  343. package/dist-lib/lib/core.d.ts +249 -79
  344. package/dist-lib/lib/core.js +3369 -1460
  345. package/dist-lib/lib/credential-pusher.d.ts +6 -0
  346. package/dist-lib/lib/credential-pusher.js +77 -60
  347. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  348. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  349. package/dist-lib/lib/custom-model-task.js +2 -2
  350. package/dist-lib/lib/diagnostics.d.ts +7 -0
  351. package/dist-lib/lib/diagnostics.js +22 -0
  352. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  353. package/dist-lib/lib/doctor/checks.js +272 -0
  354. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  355. package/dist-lib/lib/doctor/redact.js +31 -0
  356. package/dist-lib/lib/doctor/render.d.ts +8 -0
  357. package/dist-lib/lib/doctor/render.js +83 -0
  358. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  359. package/dist-lib/lib/doctor/tree.js +167 -0
  360. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  361. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  362. package/dist-lib/lib/errors.d.ts +790 -0
  363. package/dist-lib/lib/errors.js +724 -0
  364. package/dist-lib/lib/fs-drive-bridge.d.ts +1 -1
  365. package/dist-lib/lib/fs-drive-bridge.js +4 -1
  366. package/dist-lib/lib/guards.d.ts +1 -0
  367. package/dist-lib/lib/guards.js +4 -0
  368. package/dist-lib/lib/inference-calls.d.ts +1 -2
  369. package/dist-lib/lib/inference-calls.js +2 -10
  370. package/dist-lib/lib/knowledge-search.js +13 -18
  371. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  372. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  373. package/dist-lib/lib/log.d.ts +7 -6
  374. package/dist-lib/lib/log.js +14 -7
  375. package/dist-lib/lib/logger-type.d.ts +2 -5
  376. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  377. package/dist-lib/lib/model-download-status.d.ts +3 -3
  378. package/dist-lib/lib/model-download.d.ts +11 -12
  379. package/dist-lib/lib/model-download.js +63 -22
  380. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  381. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  382. package/dist-lib/lib/model-memory-cap.js +69 -0
  383. package/dist-lib/lib/models-watch.d.ts +1 -1
  384. package/dist-lib/lib/models-watch.js +4 -4
  385. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  386. package/dist-lib/lib/oauth/flow-core.js +5 -3
  387. package/dist-lib/lib/oauth/flow.js +1 -1
  388. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  389. package/dist-lib/lib/oauth/loopback.js +57 -12
  390. package/dist-lib/lib/oauth/providers.js +4 -2
  391. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  392. package/dist-lib/lib/oauth/register.js +35 -19
  393. package/dist-lib/lib/oauth/request.d.ts +10 -0
  394. package/dist-lib/lib/oauth/request.js +22 -0
  395. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  396. package/dist-lib/lib/oauth/types.d.ts +3 -0
  397. package/dist-lib/lib/oauth.d.ts +2 -1
  398. package/dist-lib/lib/oauth.js +1 -0
  399. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  400. package/dist-lib/lib/persistent-dir.js +9 -0
  401. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  402. package/dist-lib/lib/probe-rounds.js +5 -0
  403. package/dist-lib/lib/run-input.d.ts +14 -0
  404. package/dist-lib/lib/run-input.js +33 -0
  405. package/dist-lib/lib/run-notices.d.ts +3 -0
  406. package/dist-lib/lib/run-notices.js +8 -2
  407. package/dist-lib/lib/run-replay.d.ts +32 -0
  408. package/dist-lib/lib/run-replay.js +121 -0
  409. package/dist-lib/lib/run-transcript.d.ts +11 -12
  410. package/dist-lib/lib/run-transcript.js +16 -18
  411. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  412. package/dist-lib/lib/task.js +6 -4
  413. package/dist-lib/lib/test-env.d.ts +1 -0
  414. package/dist-lib/lib/test-env.js +4 -0
  415. package/dist-lib/schema/build.js +3 -1
  416. package/dist-lib/schema/config.d.ts +1 -1
  417. package/dist-lib/schema/config.js +1 -1
  418. package/dist-lib/schema/content.d.ts +5 -1
  419. package/dist-lib/schema/content.js +58 -11
  420. package/dist-lib/schema/engine.d.ts +1 -0
  421. package/dist-lib/schema/engine.js +709 -116
  422. package/dist-lib/schema/field-order.js +2 -1
  423. package/dist-lib/schema/indexes.d.ts +3 -0
  424. package/dist-lib/schema/indexes.js +30 -3
  425. package/dist-lib/schema/local.js +72 -4
  426. package/dist-lib/schema/qvac.d.ts +4 -1
  427. package/dist-lib/schema/qvac.js +364 -12
  428. package/dist-lib/spec/bind.js +209 -48
  429. package/dist-lib/spec/calls.js +45 -5
  430. package/dist-lib/spec/capabilities.d.ts +98 -18
  431. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  432. package/dist-lib/spec/hrpc/hrpc.json +726 -206
  433. package/dist-lib/spec/hrpc/index.js +832 -345
  434. package/dist-lib/spec/hrpc/messages.js +6906 -4832
  435. package/dist-lib/spec/hyperschema/index.js +6906 -4832
  436. package/dist-lib/spec/hyperschema/schema.json +4744 -3139
  437. package/dist-lib/spec/hyperschema/types.d.ts +461 -61
  438. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  439. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  440. package/dist-lib/spec/local/hyperdb/messages.js +1506 -484
  441. package/dist-lib/spec/local/hyperschema/index.js +542 -13
  442. package/dist-lib/spec/local/hyperschema/schema.json +319 -1
  443. package/dist-lib/spec/local/hyperschema/types.d.ts +78 -2
  444. package/dist-lib/spec/mesh/hyperdb/db.json +371 -5
  445. package/dist-lib/spec/mesh/hyperdb/index.js +1564 -5
  446. package/dist-lib/spec/mesh/hyperdb/messages.js +6023 -1246
  447. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +187 -1
  448. package/dist-lib/spec/mesh/hyperdispatch/index.js +528 -1
  449. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3449 -217
  450. package/dist-lib/spec/mesh/hyperschema/index.js +3449 -217
  451. package/dist-lib/spec/mesh/hyperschema/schema.json +1865 -19
  452. package/dist-lib/spec/mesh/hyperschema/types.d.ts +470 -6
  453. package/package.json +50 -35
  454. package/worker/assistant-sidecar.mjs +15 -2
  455. package/worker/stow-entry.mjs +2 -0
  456. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  457. package/dist-lib/lib/core/contract/compute.js +0 -48
  458. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  459. package/dist-lib/lib/core/device-invites.js +0 -63
  460. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  461. package/dist-lib/lib/core/grant-expiry.js +0 -66
  462. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  463. package/dist-lib/lib/core/handoff-channel.js +0 -123
  464. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  465. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  466. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  467. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  468. package/dist-lib/lib/core/hosted-agents.js +0 -140
  469. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  470. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  471. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  472. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  473. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  474. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  475. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  476. package/dist-lib/lib/core/secret-handoff.js +0 -29
  477. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  478. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  479. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  480. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  481. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  482. package/dist-lib/lib/image-cache-dir.js +0 -5
  483. package/dist-lib/lib/log-levels.d.ts +0 -7
  484. package/dist-lib/lib/log-levels.js +0 -1
  485. package/dist-lib/lib/logger.d.ts +0 -5
  486. package/dist-lib/lib/logger.js +0 -18
  487. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  488. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  489. package/tui/README.md +0 -142
  490. package/tui/app.mjs +0 -6939
  491. package/tui/boot.mjs +0 -111
  492. package/tui/index.mjs +0 -53
  493. package/tui/lib/boot-timing.mjs +0 -41
  494. package/tui/lib/busy-words.mjs +0 -116
  495. package/tui/lib/export.mjs +0 -194
  496. package/tui/lib/knowledge-command.mjs +0 -190
  497. package/tui/lib/knowledge-import.mjs +0 -171
  498. package/tui/lib/render.mjs +0 -196
  499. package/tui/lib/save-file.mjs +0 -88
  500. package/tui/lib/select.mjs +0 -81
  501. package/tui/lib/selection.mjs +0 -18
  502. package/tui/lib/setup.mjs +0 -101
  503. package/tui/lib/sidebar.mjs +0 -63
  504. package/tui/lib/splash-art.mjs +0 -107
  505. package/tui/lib/splash.mjs +0 -18
  506. package/tui/lib/upload-frames.mjs +0 -9
  507. package/tui/lib/usage.mjs +0 -59
  508. package/tui/lib/wrap.mjs +0 -143
  509. package/tui/main.mjs +0 -264
@@ -0,0 +1,328 @@
1
+ import { liveDeviceForWriter, trackActivity } from './activity.js';
2
+ import { meshKind } from './mesh-kind.js';
3
+ import { WORKSPACES_RULES, rulesVersion } from './mesh-rules.js';
4
+ import { isWorkspace, readMemberKey, upgradeMembers } from './workspace.js';
5
+ import { dropMemberAgentUses, dropUser } from './agents.js';
6
+ import { dropMemberHostKeys, dropProjectHostKeys, readProjectHostKey } from './project-host-keys.js';
7
+ import { dropListingDeviceKeys, dropProjectDeviceKeys, readProjectDeviceKey } from './project-device-keys.js';
8
+ import b4a from 'b4a';
9
+ import { SEALED_SEED_BYTES } from '../device-seal.js';
10
+ import { AGENT_USERS, AGENTS, CHAT_GROUPS, DEVICES, MESH_FOUNDERS, PROJECT_DEVICE_KEYS, PROJECT_HOST_KEYS, PROJECT_KEYS, PROJECT_MEMBERS, PROJECTS } from '../collections.js';
11
+ export const UNGROUPED = '@qvac/ungrouped';
12
+ export function readProject(tx, id) {
13
+ return tx.get(PROJECTS, { id });
14
+ }
15
+ export function readProjectKey(tx, projectId, memberId) {
16
+ return tx.get(PROJECT_KEYS, { projectId, memberId });
17
+ }
18
+ async function dropProjectKeys(tx, projectId) {
19
+ const range = { gte: { projectId }, lte: { projectId } };
20
+ for (const row of await tx.find(PROJECT_KEYS, range).toArray()) {
21
+ await tx.delete(PROJECT_KEYS, { projectId, memberId: row.memberId });
22
+ }
23
+ }
24
+ export async function dropMemberProjectKeys(tx, memberId) {
25
+ for (const row of await tx.find(PROJECT_KEYS).toArray()) {
26
+ if (b4a.equals(row.memberId, memberId)) {
27
+ await tx.delete(PROJECT_KEYS, { projectId: row.projectId, memberId });
28
+ }
29
+ }
30
+ }
31
+ export function listsMember(project, memberId) {
32
+ return (project.memberIds ?? []).some((id) => b4a.equals(id, memberId));
33
+ }
34
+ export function listedProject(project, memberId) {
35
+ return !project.deletedAt && listsMember(project, memberId);
36
+ }
37
+ export function projectMember(tx, memberId) {
38
+ return tx.get(PROJECT_MEMBERS, { memberId });
39
+ }
40
+ export async function inProject(tx, memberId) {
41
+ return (await projectMember(tx, memberId)) !== null;
42
+ }
43
+ export async function addedSince(tx, memberId, at) {
44
+ return ((await projectMember(tx, memberId))?.addedAt ?? 0) > at;
45
+ }
46
+ export async function projectRules(tx) {
47
+ return (await rulesVersion(tx)) >= WORKSPACES_RULES && (await meshKind(tx)) === 'project';
48
+ }
49
+ export async function outsideProject(tx, memberId) {
50
+ if (!(await projectRules(tx))) {
51
+ return false;
52
+ }
53
+ return !memberId || !(await inProject(tx, memberId));
54
+ }
55
+ export async function liveMember(tx, memberId, since = -1) {
56
+ for await (const device of tx.find(DEVICES)) {
57
+ const theirs = device.memberId && b4a.equals(device.memberId, memberId);
58
+ if (!device.revoked && theirs && device.joinedAt > since) {
59
+ return true;
60
+ }
61
+ }
62
+ return false;
63
+ }
64
+ export async function signerMember({ tx, node }) {
65
+ return (await liveDeviceForWriter(tx, node.key))?.memberId ?? null;
66
+ }
67
+ export async function projectOfGroup(tx, groupId) {
68
+ for await (const row of tx.find(PROJECTS)) {
69
+ if (row.groupId === groupId)
70
+ return row;
71
+ }
72
+ return null;
73
+ }
74
+ async function namesGroup(tx, groupId) {
75
+ return groupId === UNGROUPED || !!(await tx.get(CHAT_GROUPS, { id: groupId }));
76
+ }
77
+ async function putProject({ project }, context) {
78
+ const { tx, log } = context;
79
+ if (!(await isWorkspace(tx))) {
80
+ log?.warn('contract', 'put-project dropped: projects are listed in a workspace');
81
+ return;
82
+ }
83
+ const signer = await signerMember(context);
84
+ if (!signer) {
85
+ log?.warn('contract', 'put-project dropped: the writer speaks for no member here');
86
+ return;
87
+ }
88
+ if (b4a.equals(project.id, context.host.key)) {
89
+ log?.warn('contract', 'put-project dropped: the id is the workspace itself');
90
+ return;
91
+ }
92
+ const existing = await readProject(tx, project.id);
93
+ if (existing) {
94
+ log?.debug('contract', 'put-project dropped: the project is already listed');
95
+ return;
96
+ }
97
+ if (project.groupId && !(await namesGroup(tx, project.groupId))) {
98
+ log?.warn('contract', 'put-project dropped: the groupId names no chat-group here');
99
+ return;
100
+ }
101
+ if (project.groupId && (await projectOfGroup(tx, project.groupId))) {
102
+ log?.debug('contract', 'put-project dropped: the group already has its project');
103
+ return;
104
+ }
105
+ const created = {
106
+ ...project,
107
+ memberIds: [signer],
108
+ createdBy: signer,
109
+ deletedAt: undefined
110
+ };
111
+ await tx.insert(PROJECTS, created);
112
+ return created;
113
+ }
114
+ async function setProjectListing({ projectId, memberId, removed, removedAt }, context) {
115
+ const { tx, log } = context;
116
+ const existing = await readProject(tx, projectId);
117
+ if (!existing || existing.deletedAt) {
118
+ log?.debug('contract', 'set-project-listing dropped: unknown or deleted project');
119
+ return;
120
+ }
121
+ const signer = await signerMember(context);
122
+ if (!signer || !listsMember(existing, signer)) {
123
+ log?.warn('contract', "set-project-listing dropped: only the project's members change it");
124
+ return;
125
+ }
126
+ if (!removed && !(await liveMember(tx, memberId))) {
127
+ log?.warn('contract', 'set-project-listing dropped: not a member of this workspace');
128
+ return;
129
+ }
130
+ if (removed && removedAt && (await liveMember(tx, memberId, removedAt))) {
131
+ log?.debug('contract', 'set-project-listing dropped: the member came back after the removal');
132
+ return;
133
+ }
134
+ const others = (existing.memberIds ?? []).filter((id) => !b4a.equals(id, memberId));
135
+ const memberIds = removed ? others : [...others, memberId];
136
+ const next = { ...existing, memberIds };
137
+ const listed = memberIds.length === 0 ? await tombstone(next, context) : next;
138
+ await tx.insert(PROJECTS, listed);
139
+ if (removed) {
140
+ await tx.delete(PROJECT_KEYS, { projectId, memberId });
141
+ await dropListingDeviceKeys(tx, projectId, memberId);
142
+ await dropMemberAgentUses(tx, memberId, projectId);
143
+ }
144
+ await dropMemberHostKeys(tx, projectId, memberId);
145
+ return listed;
146
+ }
147
+ async function tombstone(project, { tx, node }) {
148
+ await dropUser(tx, project.id);
149
+ await dropProjectKeys(tx, project.id);
150
+ await dropProjectHostKeys(tx, project.id);
151
+ await dropProjectDeviceKeys(tx, project.id);
152
+ return { ...project, deletedAt: node.timestamp };
153
+ }
154
+ async function deleteProject({ projectId }, context) {
155
+ const { tx, host, log } = context;
156
+ const existing = await readProject(tx, projectId);
157
+ if (!existing || existing.deletedAt || b4a.equals(projectId, host.key)) {
158
+ log?.debug('contract', 'delete-project dropped: unknown or already deleted project');
159
+ return;
160
+ }
161
+ const signer = await signerMember(context);
162
+ if (!signer || !listsMember(existing, signer)) {
163
+ log?.warn('contract', "delete-project dropped: only the project's members delete it");
164
+ return;
165
+ }
166
+ const deleted = await tombstone(existing, context);
167
+ await tx.insert(PROJECTS, deleted);
168
+ return deleted;
169
+ }
170
+ async function putProjectKey(op, context) {
171
+ const { tx, log } = context;
172
+ if (!(await isWorkspace(tx))) {
173
+ log?.warn('contract', 'put-project-key dropped: not a workspace');
174
+ return;
175
+ }
176
+ const project = await readProject(tx, op.projectId);
177
+ if (!project || project.deletedAt) {
178
+ log?.debug('contract', 'put-project-key dropped: unknown or deleted project');
179
+ return;
180
+ }
181
+ const signer = await signerMember(context);
182
+ if (!signer || !listsMember(project, signer) || !listsMember(project, op.memberId)) {
183
+ log?.warn('contract', 'put-project-key dropped: the project lists not both signer and member');
184
+ return;
185
+ }
186
+ const memberKey = await readMemberKey(tx, op.memberId);
187
+ if (!memberKey || !b4a.equals(memberKey.boxKey, op.boxKey)) {
188
+ log?.debug('contract', "put-project-key dropped: not sealed to the member's box key");
189
+ return;
190
+ }
191
+ if (op.sealedSeed.byteLength !== SEALED_SEED_BYTES) {
192
+ log?.warn('contract', 'put-project-key dropped: not a sealed seed');
193
+ return;
194
+ }
195
+ const held = await readProjectKey(tx, op.projectId, op.memberId);
196
+ if (held && b4a.equals(held.boxKey, op.boxKey)) {
197
+ return;
198
+ }
199
+ const row = {
200
+ projectId: op.projectId,
201
+ memberId: op.memberId,
202
+ boxKey: op.boxKey,
203
+ sealedSeed: op.sealedSeed
204
+ };
205
+ await tx.insert(PROJECT_KEYS, row);
206
+ return row;
207
+ }
208
+ async function putProjectHostKey(op, context) {
209
+ const { tx, log } = context;
210
+ if (!(await isWorkspace(tx))) {
211
+ log?.warn('contract', 'put-project-host-key dropped: not a workspace');
212
+ return;
213
+ }
214
+ const project = await readProject(tx, op.projectId);
215
+ if (!project || project.deletedAt) {
216
+ log?.debug('contract', 'put-project-host-key dropped: unknown or deleted project');
217
+ return;
218
+ }
219
+ const signer = await signerMember(context);
220
+ if (!signer || !listsMember(project, signer)) {
221
+ log?.warn('contract', "put-project-host-key dropped: only the project's members seal to a host");
222
+ return;
223
+ }
224
+ const agent = await tx.get(AGENTS, { id: op.agentId });
225
+ if (!agent || agent.deletedAt || !b4a.equals(agent.providerDeviceId, op.deviceId)) {
226
+ log?.debug('contract', "put-project-host-key dropped: not the live agent's host");
227
+ return;
228
+ }
229
+ if (!(await tx.get(AGENT_USERS, { agentId: op.agentId, userId: op.projectId }))) {
230
+ log?.debug('contract', 'put-project-host-key dropped: the project does not use the agent');
231
+ return;
232
+ }
233
+ const device = await tx.get(DEVICES, { id: op.deviceId });
234
+ const member = device && !device.revoked ? device.memberId : null;
235
+ if (!member || listsMember(project, member)) {
236
+ log?.debug('contract', 'put-project-host-key dropped: a revoked host, or a listed member');
237
+ return;
238
+ }
239
+ if (op.sealedSeed.byteLength !== SEALED_SEED_BYTES) {
240
+ log?.warn('contract', 'put-project-host-key dropped: not a sealed seed');
241
+ return;
242
+ }
243
+ if (await readProjectHostKey(tx, op.projectId, op.deviceId)) {
244
+ return;
245
+ }
246
+ const row = {
247
+ projectId: op.projectId,
248
+ deviceId: op.deviceId,
249
+ agentId: op.agentId,
250
+ sealedSeed: op.sealedSeed
251
+ };
252
+ await tx.insert(PROJECT_HOST_KEYS, row);
253
+ return row;
254
+ }
255
+ async function countedDevice(tx, { memberId, deviceId }) {
256
+ const counted = (await upgradeMembers(tx)).some((id) => b4a.equals(id, memberId));
257
+ const device = counted ? await tx.get(DEVICES, { id: deviceId }) : null;
258
+ return !!device?.memberId && !device.revoked && b4a.equals(device.memberId, memberId);
259
+ }
260
+ async function putProjectDeviceKey(op, context) {
261
+ const { tx, log } = context;
262
+ if (!(await isWorkspace(tx))) {
263
+ log?.warn('contract', 'put-project-device-key dropped: not a workspace');
264
+ return;
265
+ }
266
+ const project = await readProject(tx, op.projectId);
267
+ if (!project || project.deletedAt || !project.groupId) {
268
+ log?.debug('contract', 'put-project-device-key dropped: no live upgraded project');
269
+ return;
270
+ }
271
+ const signer = await signerMember(context);
272
+ if (!signer || !listsMember(project, signer) || !listsMember(project, op.memberId)) {
273
+ log?.warn('contract', 'put-project-device-key dropped: the project lists not both signer and member');
274
+ return;
275
+ }
276
+ if (!(await countedDevice(tx, op))) {
277
+ log?.debug('contract', 'put-project-device-key dropped: no live device of a counted member');
278
+ return;
279
+ }
280
+ if (op.sealedSeed.byteLength !== SEALED_SEED_BYTES) {
281
+ log?.warn('contract', 'put-project-device-key dropped: not a sealed seed');
282
+ return;
283
+ }
284
+ if (await readProjectDeviceKey(tx, op.projectId, op.deviceId)) {
285
+ return;
286
+ }
287
+ const row = {
288
+ projectId: op.projectId,
289
+ deviceId: op.deviceId,
290
+ memberId: op.memberId,
291
+ sealedSeed: op.sealedSeed
292
+ };
293
+ await tx.insert(PROJECT_DEVICE_KEYS, row);
294
+ return row;
295
+ }
296
+ async function putProjectMember({ memberId, addedAt }, context) {
297
+ const { tx, host, log } = context;
298
+ if ((await meshKind(tx)) !== 'project') {
299
+ log?.warn('contract', 'put-project-member dropped: not a project');
300
+ return;
301
+ }
302
+ if (host.genesis) {
303
+ const founder = await tx.get(MESH_FOUNDERS, { id: 'mesh' });
304
+ if (!founder || !b4a.equals(founder.memberId, memberId)) {
305
+ log?.warn('contract', 'put-project-member dropped: a genesis lists only its founder');
306
+ return;
307
+ }
308
+ }
309
+ else {
310
+ const signer = await signerMember(context);
311
+ if (!signer || !(await inProject(tx, signer))) {
312
+ log?.warn('contract', "put-project-member dropped: only the project's members add one");
313
+ return;
314
+ }
315
+ }
316
+ const row = { memberId, addedAt };
317
+ await tx.insert(PROJECT_MEMBERS, row);
318
+ return row;
319
+ }
320
+ export function registerProjectRoutes(router) {
321
+ router.add('@qvac/put-project', trackActivity(putProject));
322
+ router.add('@qvac/set-project-listing', trackActivity(setProjectListing));
323
+ router.add('@qvac/put-project-member', trackActivity(putProjectMember));
324
+ router.add('@qvac/delete-project', trackActivity(deleteProject));
325
+ router.add('@qvac/put-project-key', trackActivity(putProjectKey));
326
+ router.add('@qvac/put-project-host-key', trackActivity(putProjectHostKey));
327
+ router.add('@qvac/put-project-device-key', trackActivity(putProjectDeviceKey));
328
+ }
@@ -0,0 +1,3 @@
1
+ import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
+ export declare const PUBLIC_MESH_ROW = "mesh";
3
+ export declare function registerPublicMeshRoutes(router: Router): void;
@@ -0,0 +1,31 @@
1
+ import b4a from 'b4a';
2
+ import { trackActivity } from './activity.js';
3
+ import { MESH_SEEDS, PUBLIC_MESHES } from '../collections.js';
4
+ export const PUBLIC_MESH_ROW = 'mesh';
5
+ const WORKSPACE_ID = /^[0-9a-f]{64}$/;
6
+ async function heldWorkspace(row, { tx }) {
7
+ if (row.id === PUBLIC_MESH_ROW)
8
+ return true;
9
+ if (!WORKSPACE_ID.test(row.id))
10
+ return false;
11
+ return !!(await tx.get(MESH_SEEDS, { meshKey: b4a.from(row.id, 'hex') }));
12
+ }
13
+ export function registerPublicMeshRoutes(router) {
14
+ router.add('@qvac/put-public-mesh', trackActivity(async (row, context) => {
15
+ const { tx, log } = context;
16
+ if (!(await heldWorkspace(row, context))) {
17
+ log?.warn('contract', 'put-public-mesh dropped: the account holds no such workspace', {
18
+ id: row.id.slice(0, 8)
19
+ });
20
+ return;
21
+ }
22
+ if (await tx.get(PUBLIC_MESHES, { id: row.id })) {
23
+ log?.debug('contract', 'put-public-mesh dropped: the first row wins');
24
+ return;
25
+ }
26
+ const stored = { id: row.id, meshKey: row.meshKey };
27
+ await tx.insert(PUBLIC_MESHES, stored);
28
+ log?.info('contract', 'public mesh recorded', { id: row.id.slice(0, 8) });
29
+ return stored;
30
+ }));
31
+ }
@@ -0,0 +1,9 @@
1
+ import type HyperDB from 'hyperdb';
2
+ import type { QvacAgent, QvacPublicSeed } from '../../../spec/mesh/hyperschema/types.d.ts';
3
+ export declare function readPublicSeed(tx: HyperDB, memberId: Buffer, deviceId: Buffer): Promise<QvacPublicSeed | null>;
4
+ export declare function liveAgentsOn(tx: HyperDB, providerDeviceId: Buffer): Promise<QvacAgent[]>;
5
+ export declare function hostsLiveAgent(tx: HyperDB, deviceId: Buffer): Promise<boolean>;
6
+ export declare function dropMemberSeeds(tx: HyperDB, memberId: Buffer): Promise<void>;
7
+ export declare function dropDeviceSeeds(tx: HyperDB, deviceId: Buffer): Promise<void>;
8
+ export declare function usesAny(tx: HyperDB, agents: QvacAgent[], userId: Buffer): Promise<boolean>;
9
+ export declare function pruneHostSeeds(tx: HyperDB, deviceId: Buffer): Promise<void>;
@@ -0,0 +1,43 @@
1
+ import b4a from 'b4a';
2
+ import { AGENT_USERS, AGENTS_BY_PROVIDER, PUBLIC_SEEDS } from '../collections.js';
3
+ export function readPublicSeed(tx, memberId, deviceId) {
4
+ return tx.get(PUBLIC_SEEDS, { memberId, deviceId });
5
+ }
6
+ export async function liveAgentsOn(tx, providerDeviceId) {
7
+ const range = { gte: { providerDeviceId }, lte: { providerDeviceId } };
8
+ const agents = await tx.find(AGENTS_BY_PROVIDER, range).toArray();
9
+ return agents.filter((agent) => !agent.deletedAt);
10
+ }
11
+ export async function hostsLiveAgent(tx, deviceId) {
12
+ return (await liveAgentsOn(tx, deviceId)).length > 0;
13
+ }
14
+ export async function dropMemberSeeds(tx, memberId) {
15
+ const range = { gte: { memberId }, lte: { memberId } };
16
+ for (const row of await tx.find(PUBLIC_SEEDS, range).toArray()) {
17
+ await tx.delete(PUBLIC_SEEDS, { memberId, deviceId: row.deviceId });
18
+ }
19
+ }
20
+ async function seedsSealedTo(tx, deviceId) {
21
+ const rows = await tx.find(PUBLIC_SEEDS).toArray();
22
+ return rows.filter((row) => b4a.equals(row.deviceId, deviceId));
23
+ }
24
+ export async function dropDeviceSeeds(tx, deviceId) {
25
+ for (const row of await seedsSealedTo(tx, deviceId)) {
26
+ await tx.delete(PUBLIC_SEEDS, { memberId: row.memberId, deviceId });
27
+ }
28
+ }
29
+ export async function usesAny(tx, agents, userId) {
30
+ for (const agent of agents) {
31
+ if (await tx.get(AGENT_USERS, { agentId: agent.id, userId }))
32
+ return true;
33
+ }
34
+ return false;
35
+ }
36
+ export async function pruneHostSeeds(tx, deviceId) {
37
+ const agents = await liveAgentsOn(tx, deviceId);
38
+ for (const row of await seedsSealedTo(tx, deviceId)) {
39
+ if (!(await usesAny(tx, agents, row.memberId))) {
40
+ await tx.delete(PUBLIC_SEEDS, { memberId: row.memberId, deviceId });
41
+ }
42
+ }
43
+ }
@@ -0,0 +1,10 @@
1
+ import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
+ export type MeshRole = 'account' | 'public' | 'workspace' | 'project';
3
+ export interface RoleOptions {
4
+ readonly role?: MeshRole;
5
+ }
6
+ export declare const ROUTE_ROLES: Readonly<Record<string, readonly MeshRole[]>>;
7
+ export declare function inRole(role: MeshRole, route: string): boolean;
8
+ export declare function publicRoute(name: string): boolean;
9
+ export declare function assertRoleRoute(role: MeshRole, name: string): void;
10
+ export declare function roleDrops(router: Router, role: MeshRole): Router;
@@ -0,0 +1,120 @@
1
+ import { CoreError } from '../../errors.js';
2
+ import { meshKind } from './mesh-kind.js';
3
+ import { WORKSPACES_RULES, rulesVersion } from './mesh-rules.js';
4
+ const ALL = ['account', 'public', 'workspace', 'project'];
5
+ const CONTENT = ['public', 'project'];
6
+ const PRIVATE = ['account', 'project'];
7
+ const AGENT = ['account', 'public', 'project'];
8
+ const SHARED_AGENT = ['account', 'public', 'workspace', 'project'];
9
+ const WORKSPACE = ['workspace'];
10
+ const PROJECT = ['project'];
11
+ const SHARED = ['workspace', 'project'];
12
+ export const ROUTE_ROLES = {
13
+ '@qvac/append-chunk': CONTENT,
14
+ '@qvac/update-chunk': CONTENT,
15
+ '@qvac/resolve-approval': CONTENT,
16
+ '@qvac/add-writer': ALL,
17
+ '@qvac/remove-writer': ALL,
18
+ '@qvac/join': PRIVATE,
19
+ '@qvac/register-device': PRIVATE,
20
+ '@qvac/update-device': ALL,
21
+ '@qvac/put-agent': SHARED_AGENT,
22
+ '@qvac/put-approval-rule': PRIVATE,
23
+ '@qvac/seed-defaults': AGENT,
24
+ '@qvac/add-knowledge': CONTENT,
25
+ '@qvac/remove-knowledge': CONTENT,
26
+ '@qvac/add-knowledge-artifact': CONTENT,
27
+ '@qvac/report-device-capabilities': ALL,
28
+ '@qvac/claim-indexing': CONTENT,
29
+ '@qvac/resolve-indexing': CONTENT,
30
+ '@qvac/put-chat': CONTENT,
31
+ '@qvac/update-device-profile': ALL,
32
+ '@qvac/report-device-version': ALL,
33
+ '@qvac/put-tool-configs': PRIVATE,
34
+ '@qvac/append-tool-activity': CONTENT,
35
+ '@qvac/attest-device': ALL,
36
+ '@qvac/mint-member': ALL,
37
+ '@qvac/attest-member-device': ALL,
38
+ '@qvac/update-member': ALL,
39
+ '@qvac/migrate-agent-catalog': CONTENT,
40
+ '@qvac/put-chat-group': CONTENT,
41
+ '@qvac/join-member': ALL,
42
+ '@qvac/put-joined-mesh': PRIVATE,
43
+ '@qvac/remove-member': ALL,
44
+ '@qvac/reindex-agents': ALL,
45
+ '@qvac/put-mesh-invite-grant': PRIVATE,
46
+ '@qvac/claim-invite': PRIVATE,
47
+ '@qvac/mint-mesh-kind': ALL,
48
+ '@qvac/vouched-join': PRIVATE,
49
+ '@qvac/reindex-devices': ALL,
50
+ '@qvac/recover-device': PRIVATE,
51
+ '@qvac/purge-chat': CONTENT,
52
+ '@qvac/name-mesh': ALL,
53
+ '@qvac/open-join': ALL,
54
+ '@qvac/put-mesh-seed': PRIVATE,
55
+ '@qvac/raise-mesh-rules': ALL,
56
+ '@qvac/put-public-mesh': ['account'],
57
+ '@qvac/put-mesh-blind-peer': PRIVATE,
58
+ '@qvac/put-workspace': WORKSPACE,
59
+ '@qvac/set-member-role': WORKSPACE,
60
+ '@qvac/put-public-seed': WORKSPACE,
61
+ '@qvac/put-member-key': WORKSPACE,
62
+ '@qvac/put-project': WORKSPACE,
63
+ '@qvac/set-project-listing': WORKSPACE,
64
+ '@qvac/put-project-key': WORKSPACE,
65
+ '@qvac/put-project-host-key': WORKSPACE,
66
+ '@qvac/put-project-device-key': WORKSPACE,
67
+ '@qvac/put-project-member': PROJECT,
68
+ '@qvac/put-project-order': ['account'],
69
+ '@qvac/retry-indexing': PROJECT,
70
+ '@qvac/progress-indexing': CONTENT,
71
+ '@qvac/mark-chat-read': CONTENT,
72
+ '@qvac/delete-project': WORKSPACE,
73
+ '@qvac/set-knowledge-cap': PROJECT,
74
+ '@qvac/upgrade-to-workspace': SHARED,
75
+ '@qvac/take-model-request': CONTENT,
76
+ '@qvac/settle-model-request': CONTENT,
77
+ '@qvac/cancel-model-request': CONTENT,
78
+ '@qvac/reopen-model-request': CONTENT,
79
+ '@qvac/put-agent-user': WORKSPACE,
80
+ '@qvac/agent-join': CONTENT,
81
+ '@qvac/take-run-request': CONTENT,
82
+ '@qvac/put-skill-secret': ['account']
83
+ };
84
+ export function inRole(role, route) {
85
+ return ROUTE_ROLES[route]?.includes(role) ?? false;
86
+ }
87
+ export function publicRoute(name) {
88
+ const route = `@qvac/${name}`;
89
+ return inRole('public', route) && !inRole('account', route);
90
+ }
91
+ export function assertRoleRoute(role, name) {
92
+ const route = `@qvac/${name}`;
93
+ if (!inRole(role, route)) {
94
+ throw new CoreError('ROUTE_NOT_IN_ROLE', [route, role]);
95
+ }
96
+ }
97
+ function appliedRole(role, kind) {
98
+ if (kind === 'workspace')
99
+ return 'workspace';
100
+ return kind === 'shared' || kind === 'project' ? 'project' : role;
101
+ }
102
+ function byKind(role) {
103
+ return role === 'workspace' || role === 'project';
104
+ }
105
+ export function roleDrops(router, role) {
106
+ return {
107
+ add: (name, handler) => router.add(name, inRole(role, name) && !byKind(role)
108
+ ? handler
109
+ : async (op, context) => {
110
+ if ((await rulesVersion(context.tx)) < WORKSPACES_RULES) {
111
+ return handler(op, context);
112
+ }
113
+ const applied = byKind(role) ? appliedRole(role, await meshKind(context.tx)) : role;
114
+ if (inRole(applied, name)) {
115
+ return handler(op, context);
116
+ }
117
+ context.log?.warn('contract', `${name} dropped: not a route of a ${applied} mesh`);
118
+ })
119
+ };
120
+ }
@@ -0,0 +1,10 @@
1
+ import type HyperDB from 'hyperdb';
2
+ import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
3
+ import type { QvacAppendChunkOperation, QvacChunk } from '../../../spec/mesh/hyperschema/types.d.ts';
4
+ import type { RouterContext } from './types.ts';
5
+ export declare const TERMINAL_RUN_STATES: Set<string>;
6
+ export declare function runHasTerminalStatus(tx: HyperDB, chatId: string, runId: string): Promise<boolean>;
7
+ export declare function runnerRefusal(op: QvacAppendChunkOperation, { tx, node }: RouterContext): Promise<string | null>;
8
+ export declare function runTaker(tx: HyperDB, request: QvacChunk, writerKey: Buffer): Promise<Buffer | null>;
9
+ export declare function openToTake(request: QvacChunk | null): request is QvacChunk;
10
+ export declare function registerRunRequestRoutes(router: Router): void;
@@ -0,0 +1,75 @@
1
+ import b4a from 'b4a';
2
+ import { liveDeviceForWriter, trackActivity } from './activity.js';
3
+ import { ownerSigner } from './model-requests.js';
4
+ import { chunkTypeOrdinal } from '../../../schema/indexes.js';
5
+ import { CHUNKS, CHUNKS_BY_TYPE, DEVICES } from '../collections.js';
6
+ export const TERMINAL_RUN_STATES = new Set(['completed', 'failed', 'canceled']);
7
+ export async function runHasTerminalStatus(tx, chatId, runId) {
8
+ const type = chunkTypeOrdinal('run-status');
9
+ const statuses = tx.find(CHUNKS_BY_TYPE, {
10
+ gte: { chatId, type },
11
+ lte: { chatId, type }
12
+ });
13
+ for await (const chunk of statuses) {
14
+ if (chunk.runId === runId && TERMINAL_RUN_STATES.has(chunk.runStatus?.state ?? '')) {
15
+ return true;
16
+ }
17
+ }
18
+ return false;
19
+ }
20
+ export async function runnerRefusal(op, { tx, node }) {
21
+ if (!op.runnerDeviceId) {
22
+ return null;
23
+ }
24
+ if (op.type !== 'run-request' || op.capability) {
25
+ return 'only a run-request for an agent names a runner';
26
+ }
27
+ const signer = await liveDeviceForWriter(tx, node.key);
28
+ const runner = await tx.get(DEVICES, { id: op.runnerDeviceId });
29
+ const ours = !!signer?.memberId &&
30
+ !!runner?.memberId &&
31
+ !runner.revoked &&
32
+ b4a.equals(signer.memberId, runner.memberId);
33
+ return ours ? null : "a run's runner is a device of the asker's own";
34
+ }
35
+ export async function runTaker(tx, request, writerKey) {
36
+ const signer = await ownerSigner(tx, request, writerKey);
37
+ if (!signer || !request.runnerDeviceId) {
38
+ return null;
39
+ }
40
+ const named = b4a.equals(signer.id, request.runnerDeviceId);
41
+ return named || b4a.equals(signer.id, request.originDeviceId) ? signer.id : null;
42
+ }
43
+ export function openToTake(request) {
44
+ return request?.type === 'run-request' && !!request.runnerDeviceId && !request.runTakenBy;
45
+ }
46
+ export function registerRunRequestRoutes(router) {
47
+ router.add('@qvac/take-run-request', trackActivity(async (op, { tx, node, log }) => {
48
+ const request = await tx.get(CHUNKS, { id: op.id });
49
+ if (!openToTake(request) || !request.runId) {
50
+ log?.debug('contract', 'take-run-request dropped: no run-request open to take', {
51
+ id: op.id
52
+ });
53
+ return;
54
+ }
55
+ if (await runHasTerminalStatus(tx, request.chatId, request.runId)) {
56
+ log?.debug('contract', 'take-run-request dropped: the run has ended', { id: op.id });
57
+ return;
58
+ }
59
+ const runTakenBy = await runTaker(tx, request, node.key);
60
+ if (!runTakenBy) {
61
+ log?.warn('contract', 'take-run-request dropped: neither its runner nor its asker', {
62
+ id: op.id
63
+ });
64
+ return;
65
+ }
66
+ const taken = {
67
+ ...request,
68
+ runTakenBy,
69
+ runTakenAt: op.at,
70
+ updatedAt: Math.max(request.updatedAt ?? 0, op.at)
71
+ };
72
+ await tx.insert(CHUNKS, taken);
73
+ return taken;
74
+ }));
75
+ }
@@ -1,2 +1,4 @@
1
1
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
- export declare function registerSeedDefaultsRoutes(router: Router): void;
2
+ import type { RoleOptions } from './roles.ts';
3
+ export declare function registerSeedDefaultsRoutes(router: Router, options?: RoleOptions): void;
4
+ export declare function registerMeshBlindPeerRoutes(router: Router): void;