@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
@@ -2,12 +2,20 @@ import crypto from 'hypercore-crypto';
2
2
  import { devicesByWriterKey, liveDeviceForWriter, markWriterRevoked, trackActivity } from './activity.js';
3
3
  import { recordMemberRemoval } from './grant-order.js';
4
4
  import { verifyMemberWriterClaim, verifyWriterClaim } from '../device-attestation.js';
5
- import { meshKind } from './mesh-kind.js';
6
- import { isKickedRow } from '../helpers/index.js';
5
+ import { meshKind, sharedKind } from './mesh-kind.js';
6
+ import { removedBy } from './invites.js';
7
+ import { outsideAccount } from './members.js';
8
+ import { addedSince, outsideProject } from './projects.js';
9
+ import { dropMemberAgents, dropMemberCopies } from './agents.js';
10
+ import { dropDeviceSeeds } from './public-seeds.js';
11
+ import { dropDeviceHostKeys } from './project-host-keys.js';
12
+ import { dropDeviceKeysOf } from './project-device-keys.js';
13
+ import { dropHostRows, hostedDevice, releaseHostedDevice } from './agent-join.js';
14
+ import { actsFor, dropRole, kicksAdminsLastDevice, leavesNoAdmin, uncountMember } from './workspace.js';
7
15
  import { verifyDeviceProof } from '../identity.js';
8
16
  import { sealed } from './seal.js';
9
17
  import b4a from 'b4a';
10
- import { DEVICES, MEMBERS, MESH_INVITE_GRANTS } from '../collections.js';
18
+ import { DEVICES, MEMBERS, MESH_INVITE_GRANTS, PROJECT_MEMBERS } from '../collections.js';
11
19
  async function boundToAnother(tx, writerKey, id) {
12
20
  for await (const device of devicesByWriterKey(tx, writerKey)) {
13
21
  if (!b4a.equals(device.id, id))
@@ -16,15 +24,16 @@ async function boundToAnother(tx, writerKey, id) {
16
24
  return false;
17
25
  }
18
26
  export async function admitDevice({ tx, node, host, meshPublicKey, log }, device, { id, writerKey, claim }) {
27
+ const hosted = await hostedDevice(tx, id);
19
28
  const existing = await tx.get(DEVICES, { id });
20
- if ((await meshKind(tx)) === 'shared' && (await boundToAnother(tx, writerKey, id))) {
29
+ if ((await sharedKind(tx)) && (await boundToAnother(tx, writerKey, id))) {
21
30
  log?.warn('contract', 'admission refused: another device is bound to this writer key', {
22
31
  id: b4a.toHex(id).slice(0, 16)
23
32
  });
24
33
  return 'refused';
25
34
  }
26
35
  if (!device) {
27
- if (!existing) {
36
+ if (!existing && !hosted) {
28
37
  return 'writer-only';
29
38
  }
30
39
  log?.debug('contract', 'admission refused: no profile to weigh against the existing row');
@@ -58,6 +67,15 @@ export async function admitDevice({ tx, node, host, meshPublicKey, log }, device
58
67
  });
59
68
  return 'refused';
60
69
  }
70
+ if (hosted) {
71
+ if (!signed) {
72
+ log?.warn('contract', 'admission refused: a model host holds this device id', {
73
+ id: b4a.toHex(id).slice(0, 16)
74
+ });
75
+ return 'refused';
76
+ }
77
+ await releaseHostedDevice({ tx, host }, id, writerKey);
78
+ }
61
79
  await tx.insert(DEVICES, {
62
80
  ...existing,
63
81
  name: device.name,
@@ -88,7 +106,7 @@ export async function admitDevice({ tx, node, host, meshPublicKey, log }, device
88
106
  }
89
107
  await markWriterRevoked(tx, writerKey, { revoked: false });
90
108
  if (!alreadyAdmitted) {
91
- log?.info('contract', 'device admitted', { id: b4a.toHex(id).slice(0, 16) });
109
+ log?.debug('contract', 'device admitted', { id: b4a.toHex(id).slice(0, 16) });
92
110
  }
93
111
  return 'admitted';
94
112
  }
@@ -114,8 +132,13 @@ async function revokeIssuedGrants({ tx, node }, issued) {
114
132
  });
115
133
  }
116
134
  }
135
+ async function deviceOwner({ tx }, { deviceId }) {
136
+ const device = deviceId ? await tx.get(DEVICES, { id: deviceId }) : null;
137
+ return device?.memberId ?? device?.claimedMemberId ?? null;
138
+ }
117
139
  async function revokeWriter(payload, context) {
118
140
  await context.host.removeWriter(payload.writerKey);
141
+ await dropHostRows(context.tx, payload.writerKey);
119
142
  const id = payload.deviceId;
120
143
  if (!id) {
121
144
  return;
@@ -125,6 +148,10 @@ async function revokeWriter(payload, context) {
125
148
  context.log?.debug('contract', 'remove-writer: no device row to revoke');
126
149
  return;
127
150
  }
151
+ if (existing.revoked && b4a.equals(context.node.key, payload.writerKey)) {
152
+ context.log?.debug('contract', 'remove-writer: already revoked, the leave changes nothing');
153
+ return;
154
+ }
128
155
  const current = existing.writerKey;
129
156
  if (current && !b4a.equals(current, payload.writerKey)) {
130
157
  if (b4a.equals(context.node.key, payload.writerKey) || b4a.equals(context.node.key, current)) {
@@ -141,6 +168,9 @@ async function revokeWriter(payload, context) {
141
168
  };
142
169
  await context.tx.insert(DEVICES, revoked);
143
170
  await markWriterRevoked(context.tx, current ?? payload.writerKey, { revoked: true });
171
+ await dropDeviceSeeds(context.tx, id);
172
+ await dropDeviceHostKeys(context.tx, id);
173
+ await dropDeviceKeysOf(context.tx, id);
144
174
  context.log?.info('contract', 'writer removed, device revoked', {
145
175
  id: b4a.toHex(id).slice(0, 16)
146
176
  });
@@ -163,7 +193,7 @@ export function registerWriterRoutes(router) {
163
193
  return;
164
194
  }
165
195
  if (!payload.device) {
166
- if ((await meshKind(context.tx)) === 'shared') {
196
+ if (await sharedKind(context.tx)) {
167
197
  context.log?.warn('contract', 'add-writer dropped: a shared mesh admits no device-less writer');
168
198
  return;
169
199
  }
@@ -194,6 +224,14 @@ export function registerWriterRoutes(router) {
194
224
  context.log?.warn('contract', 'remove-writer dropped: the author speaks for no member here');
195
225
  return;
196
226
  }
227
+ if (!self && !(await actsFor(context, await deviceOwner(context, payload)))) {
228
+ context.log?.warn('contract', "remove-writer dropped: only an admin kicks another's device");
229
+ return;
230
+ }
231
+ if (!self && (await kicksAdminsLastDevice(context, payload.deviceId))) {
232
+ context.log?.warn('contract', "remove-writer dropped: it would unpair an admin's last device");
233
+ return;
234
+ }
197
235
  return revokeWriter(payload, context);
198
236
  }));
199
237
  router.add('@qvac/remove-member', trackActivity(async ({ memberId, revokedAt }, context) => {
@@ -201,27 +239,52 @@ export function registerWriterRoutes(router) {
201
239
  context.log?.warn('contract', 'remove-member dropped: the author speaks for no member here');
202
240
  return;
203
241
  }
242
+ if (!(await actsFor(context, memberId))) {
243
+ context.log?.warn('contract', 'remove-member dropped: only an admin removes another member');
244
+ return;
245
+ }
246
+ if (await leavesNoAdmin(context, memberId)) {
247
+ context.log?.warn('contract', 'remove-member dropped: the last admin cannot leave others');
248
+ return;
249
+ }
250
+ if (revokedAt && (await addedSince(context.tx, memberId, revokedAt))) {
251
+ context.log?.debug('contract', 'remove-member dropped: the member was added back since');
252
+ return;
253
+ }
254
+ await dropRole(context.tx, memberId);
255
+ await uncountMember(context.tx, memberId);
256
+ await context.tx.delete(PROJECT_MEMBERS, { memberId });
204
257
  const removals = [];
258
+ const devices = [];
205
259
  for await (const device of context.tx.find(DEVICES)) {
206
260
  const claims = device.memberId ?? device.claimedMemberId;
207
- if (device.revoked || !device.writerKey || !claims || !b4a.equals(claims, memberId)) {
261
+ if (!claims || !b4a.equals(claims, memberId)) {
208
262
  continue;
209
263
  }
210
- removals.push({ writerKey: device.writerKey, deviceId: device.id, revokedAt });
264
+ devices.push(device.id);
265
+ if (!device.revoked && device.writerKey) {
266
+ removals.push({ writerKey: device.writerKey, deviceId: device.id, revokedAt });
267
+ }
211
268
  }
212
269
  let removed;
213
270
  for (const removal of removals) {
214
271
  removed = (await revokeWriter(removal, context)) ?? removed;
215
272
  }
216
273
  await revokeIssuedGrants(context, (grant) => !!grant.issuerMemberId && b4a.equals(grant.issuerMemberId, memberId));
274
+ await dropMemberAgents(context.tx, memberId);
275
+ await dropMemberCopies(context.tx, devices, revokedAt ?? 0);
217
276
  return removed;
218
277
  }));
219
278
  router.add('@qvac/join', trackActivity(async (payload, context) => {
220
279
  const kind = await meshKind(context.tx);
221
- if (kind === 'shared' || kind === 'account') {
280
+ if (kind === 'account' || (await sharedKind(context.tx))) {
222
281
  context.log?.warn('contract', 'join dropped: this mesh admits no bare join', { kind });
223
282
  return;
224
283
  }
284
+ if (await outsideAccount(context.tx, null)) {
285
+ context.log?.warn('contract', 'join dropped: an account admits no bare join');
286
+ return;
287
+ }
225
288
  let valid = false;
226
289
  try {
227
290
  valid = crypto.verify(context.node.key, payload.signature, context.meshPublicKey);
@@ -273,19 +336,26 @@ export function registerWriterRoutes(router) {
273
336
  log?.warn('contract', 'vouched-join dropped: the writer is not a live linked device here');
274
337
  return;
275
338
  }
339
+ if (await outsideProject(tx, memberId)) {
340
+ log?.warn('contract', "vouched-join dropped: the voucher's member is not on the project's list");
341
+ return;
342
+ }
276
343
  const claim = { meshPublicKey, deviceId: id, writerKey, joinedAt: device.joinedAt, memberId };
277
344
  if (!verifyMemberWriterClaim(payload.memberSignature, claim)) {
278
345
  log?.warn('contract', 'vouched-join dropped: the joiner did not sign into this member');
279
346
  return;
280
347
  }
281
348
  const existing = await tx.get(DEVICES, { id });
282
- if (existing && isKickedRow(existing) && (await meshKind(tx)) === 'shared') {
349
+ if (existing?.revoked &&
350
+ (await sharedKind(tx)) &&
351
+ (await removedBy(tx, existing)) === 'another-member') {
283
352
  log?.warn('contract', 'vouched-join dropped: the joiner was removed from this mesh');
284
353
  return;
285
354
  }
286
355
  if (existing &&
287
356
  !existing.revoked &&
288
- !(existing.writerKey && b4a.equals(existing.writerKey, writerKey))) {
357
+ !(existing.writerKey && b4a.equals(existing.writerKey, writerKey)) &&
358
+ !(device.joinedAt > existing.joinedAt)) {
289
359
  log?.warn('contract', 'vouched-join dropped: the joiner is live here on another writer');
290
360
  return;
291
361
  }
@@ -1,20 +1,25 @@
1
1
  import type Corestore from 'corestore';
2
2
  import type Hyperswarm from 'hyperswarm';
3
3
  import type Wakeup from 'protomux-wakeup';
4
- import type { Logger } from '../../index.ts';
4
+ import type { LoggerInterface } from '@qvac/logging';
5
5
  import type { LocalMeshDeparture } from '../../spec/local/hyperschema/types.d.ts';
6
- import type { BlindPeeringOpts } from './blind-peers.ts';
6
+ import type BlindPeering from 'blind-peering';
7
+ import { Mesh } from './mesh.ts';
8
+ import type { MeshRole } from './contract/roles.ts';
7
9
  interface DepartureRows {
8
10
  departures(): Promise<LocalMeshDeparture[]>;
11
+ departureRole(departure: LocalMeshDeparture): Promise<MeshRole>;
9
12
  deleteDeparture(key: Buffer): Promise<void>;
10
13
  }
11
14
  export interface PendingDeparturesOptions {
12
15
  swarm: Hyperswarm;
13
16
  isPooled: (key: Buffer) => boolean;
14
- logger?: Logger | null;
17
+ deviceId: () => Buffer | null;
18
+ logger?: LoggerInterface | null;
15
19
  blindPeerKeys?: ReadonlyArray<Buffer>;
16
- blindPeeringOpts?: BlindPeeringOpts;
20
+ blindPeering: () => BlindPeering | null;
17
21
  wakeup?: Wakeup;
22
+ delivered?: (key: Buffer) => void;
18
23
  }
19
24
  export declare class PendingDepartures {
20
25
  private readonly _store;
@@ -22,22 +27,28 @@ export declare class PendingDepartures {
22
27
  private readonly _swarm;
23
28
  private readonly _log;
24
29
  private readonly _blindPeerKeys;
25
- private readonly _blindPeeringOpts;
26
30
  private readonly _wakeup;
27
31
  private readonly _isPooled;
32
+ private readonly _deviceId;
33
+ private readonly _delivered;
28
34
  private readonly _active;
29
35
  private readonly _parked;
30
36
  private readonly _lock;
31
37
  private _closing;
38
+ private readonly _blindPeering;
32
39
  constructor(store: Corestore, local: DepartureRows, opts: PendingDeparturesOptions);
33
40
  flush(): void;
34
41
  private _flush;
35
42
  private _deliver;
43
+ private _announce;
36
44
  park(key: Buffer): Promise<void>;
37
45
  unpark(key: Buffer): void;
38
46
  drop(key: Buffer): Promise<void>;
47
+ startBlindPeering(): void;
48
+ stopBlindPeering(): void;
39
49
  suspend(): Promise<void>;
40
50
  resume(): Promise<void>;
41
51
  close(): Promise<void>;
42
52
  }
53
+ export declare function waitForDelivery(mesh: Mesh): Promise<boolean>;
43
54
  export {};
@@ -8,22 +8,26 @@ export class PendingDepartures {
8
8
  _swarm;
9
9
  _log;
10
10
  _blindPeerKeys;
11
- _blindPeeringOpts;
12
11
  _wakeup;
13
12
  _isPooled;
13
+ _deviceId;
14
+ _delivered;
14
15
  _active = new Map();
15
16
  _parked = new Set();
16
17
  _lock = new ScopeLock();
17
18
  _closing = false;
19
+ _blindPeering;
18
20
  constructor(store, local, opts) {
19
21
  this._store = store;
20
22
  this._local = local;
21
23
  this._swarm = opts.swarm;
22
24
  this._isPooled = opts.isPooled;
25
+ this._deviceId = opts.deviceId;
26
+ this._delivered = opts.delivered ?? noop;
23
27
  this._log = opts.logger ?? null;
24
28
  this._blindPeerKeys = opts.blindPeerKeys ?? [];
25
- this._blindPeeringOpts = opts.blindPeeringOpts;
26
29
  this._wakeup = opts.wakeup;
30
+ this._blindPeering = opts.blindPeering;
27
31
  }
28
32
  flush() {
29
33
  void this._flush().catch((err) => this._log?.warn(SCOPE, 'departure flush failed', err));
@@ -44,10 +48,11 @@ export class PendingDepartures {
44
48
  const mesh = new Mesh(this._store, {
45
49
  seed: row.seed,
46
50
  key: row.creator ? null : row.key,
51
+ role: await this._local.departureRole(row),
47
52
  writerSeed: row.writerSeed ?? undefined,
53
+ deviceId: this._deviceId() ?? undefined,
48
54
  logger: this._log,
49
55
  blindPeerKeys: this._blindPeerKeys,
50
- blindPeeringOpts: this._blindPeeringOpts,
51
56
  wakeup: this._wakeup
52
57
  });
53
58
  const done = this._deliver(row, mesh)
@@ -62,24 +67,50 @@ export class PendingDepartures {
62
67
  }
63
68
  async _deliver(row, mesh) {
64
69
  const scope = [...SCOPE, b4a.toHex(row.key).slice(0, 8)];
70
+ let delivered = false;
65
71
  try {
66
72
  await mesh.ready();
67
73
  if (this._closing || mesh.closing) {
68
74
  return;
69
75
  }
70
76
  this._swarm.join(mesh.discoveryKey, { server: true, client: true });
71
- mesh.startBlindPeering(this._swarm.dht);
77
+ const peering = this._blindPeering();
78
+ if (peering) {
79
+ mesh.startBlindPeering(peering);
80
+ }
72
81
  this._log?.info(scope, 'reopened a departed mesh to deliver its removal');
73
- if (!(await waitForDelivery(mesh))) {
82
+ const announced = await this._announce(mesh);
83
+ if (announced === 'closed' || (announced === 'sent' && !(await waitForDelivery(mesh)))) {
74
84
  return;
75
85
  }
76
86
  await this._local.deleteDeparture(row.key);
87
+ delivered = true;
77
88
  this._log?.info(scope, 'departure delivered');
78
89
  }
79
90
  finally {
80
91
  await this._swarm.leave(mesh.discoveryKey).catch(noop);
81
92
  await mesh.close().catch(noop);
82
93
  }
94
+ if (delivered) {
95
+ this._delivered(row.key);
96
+ }
97
+ }
98
+ async _announce(mesh) {
99
+ if (mesh.localLength === 0)
100
+ return 'moot';
101
+ const deviceId = this._deviceId();
102
+ if (!deviceId || (await mesh.checkResumedRevocation())) {
103
+ return 'sent';
104
+ }
105
+ if (!(await admitted(mesh))) {
106
+ return mesh.closing ? 'closed' : 'moot';
107
+ }
108
+ await mesh.dispatch('remove-writer', {
109
+ writerKey: mesh.localWriterKey,
110
+ deviceId,
111
+ revokedAt: Date.now()
112
+ });
113
+ return 'sent';
83
114
  }
84
115
  async park(key) {
85
116
  const hex = b4a.toHex(key);
@@ -103,6 +134,20 @@ export class PendingDepartures {
103
134
  drop(key) {
104
135
  return this._local.deleteDeparture(key);
105
136
  }
137
+ startBlindPeering() {
138
+ const peering = this._blindPeering();
139
+ if (!peering) {
140
+ return;
141
+ }
142
+ for (const { mesh } of this._active.values()) {
143
+ mesh.startBlindPeering(peering);
144
+ }
145
+ }
146
+ stopBlindPeering() {
147
+ for (const { mesh } of this._active.values()) {
148
+ mesh.stopBlindPeering();
149
+ }
150
+ }
106
151
  async suspend() {
107
152
  for (const { mesh } of this._active.values()) {
108
153
  await mesh.suspend();
@@ -121,7 +166,32 @@ export class PendingDepartures {
121
166
  }));
122
167
  }
123
168
  }
124
- function waitForDelivery(mesh) {
169
+ async function admitted(mesh) {
170
+ if (mesh.writable)
171
+ return true;
172
+ if (await mesh.ownWriterRefused())
173
+ return false;
174
+ if (mesh.closing) {
175
+ return false;
176
+ }
177
+ return new Promise((resolve) => {
178
+ const settle = (ok) => {
179
+ mesh.autobee.off('writable', onWritable);
180
+ mesh.syncActivity.unwatch(check);
181
+ mesh.off('close', onClose);
182
+ resolve(ok);
183
+ };
184
+ const onWritable = () => settle(true);
185
+ const onClose = () => settle(false);
186
+ const check = () => {
187
+ void mesh.ownWriterRefused().then((refused) => refused && settle(false), noop);
188
+ };
189
+ mesh.autobee.on('writable', onWritable);
190
+ mesh.syncActivity.watch(check);
191
+ mesh.on('close', onClose);
192
+ });
193
+ }
194
+ export function waitForDelivery(mesh) {
125
195
  const local = mesh.autobee.local;
126
196
  let uploaded = 0;
127
197
  const delivered = () => local.length > 0 &&
@@ -129,6 +199,9 @@ function waitForDelivery(mesh) {
129
199
  if (delivered()) {
130
200
  return Promise.resolve(true);
131
201
  }
202
+ if (mesh.closing) {
203
+ return Promise.resolve(false);
204
+ }
132
205
  return new Promise((resolve) => {
133
206
  const settle = (ok) => {
134
207
  local.off('upload', onUpload);
@@ -0,0 +1,21 @@
1
+ import type { Capabilities, CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
+ import { type PeerStream } from './peer-duplex.ts';
3
+ export interface DeviceControlOptions {
4
+ readonly allowed: (deviceId: Uint8Array) => Promise<boolean>;
5
+ readonly served: () => Partial<CapabilityHandlers> | null;
6
+ }
7
+ export declare class DeviceControl {
8
+ private readonly _opts;
9
+ private readonly _channel;
10
+ private readonly _engines;
11
+ private readonly _ours;
12
+ private readonly _checks;
13
+ constructor(opts: DeviceControlOptions);
14
+ addStream(stream: PeerStream): void;
15
+ engine(deviceId: Uint8Array): Capabilities;
16
+ revalidate(): Promise<void>;
17
+ destroy(): void;
18
+ private _accept;
19
+ private _changed;
20
+ private _recheck;
21
+ }
@@ -0,0 +1,91 @@
1
+ import b4a from 'b4a';
2
+ import { settleOnClose } from '@qvac/harness/rpc';
3
+ import { duplexPair } from '@qvac/harness/transport';
4
+ import { bindApi } from '../../spec/bind.js';
5
+ import { engineClient } from '../../spec/calls.js';
6
+ import HRPC from '../../spec/hrpc/index.js';
7
+ import { PeerDuplexChannel } from './peer-duplex.js';
8
+ import { CoreError } from '../errors.js';
9
+ const PROTOCOL = 'qvac/device-control';
10
+ export class DeviceControl {
11
+ _opts;
12
+ _channel;
13
+ _engines;
14
+ _ours;
15
+ _checks;
16
+ constructor(opts) {
17
+ this._opts = opts;
18
+ this._channel = new PeerDuplexChannel({
19
+ protocol: PROTOCOL,
20
+ onaccept: (from) => this._accept(from),
21
+ unreachable: () => new CoreError('DEVICE_UNREACHABLE'),
22
+ revoked: () => new CoreError('DEVICE_REVOKED'),
23
+ onchange: (deviceId) => this._changed(deviceId)
24
+ });
25
+ this._engines = new Map();
26
+ this._ours = new Set();
27
+ this._checks = new Map();
28
+ }
29
+ addStream(stream) {
30
+ this._channel.addStream(stream);
31
+ }
32
+ engine(deviceId) {
33
+ const id = b4a.toHex(deviceId);
34
+ if (!this._ours.has(id)) {
35
+ throw new CoreError('DEVICE_UNREACHABLE');
36
+ }
37
+ const held = this._engines.get(id);
38
+ if (held) {
39
+ return held;
40
+ }
41
+ const stream = this._channel.dial(id);
42
+ const engine = engineClient(settleOnClose(new HRPC(stream)));
43
+ stream.once('close', () => {
44
+ if (this._engines.get(id) === engine) {
45
+ this._engines.delete(id);
46
+ }
47
+ });
48
+ this._engines.set(id, engine);
49
+ return engine;
50
+ }
51
+ async revalidate() {
52
+ await this._channel.revalidate(this._opts.allowed);
53
+ await Promise.all(this._channel.openIds().map((id) => this._recheck(id)));
54
+ }
55
+ destroy() {
56
+ this._channel.destroy();
57
+ this._engines.clear();
58
+ }
59
+ async _accept(from) {
60
+ const handlers = this._opts.served();
61
+ if (!handlers || !(await this._opts.allowed(from))) {
62
+ return null;
63
+ }
64
+ const [ours, theirs] = duplexPair();
65
+ bindApi(settleOnClose(new HRPC(ours)), handlers);
66
+ return theirs;
67
+ }
68
+ _changed(deviceId) {
69
+ if (this._channel.isOpen(deviceId)) {
70
+ void this._recheck(deviceId);
71
+ return;
72
+ }
73
+ this._ours.delete(deviceId);
74
+ this._engines.delete(deviceId);
75
+ }
76
+ async _recheck(deviceId) {
77
+ const check = (this._checks.get(deviceId) ?? 0) + 1;
78
+ this._checks.set(deviceId, check);
79
+ const allowed = await this._opts.allowed(b4a.from(deviceId, 'hex')).catch(() => false);
80
+ if (this._checks.get(deviceId) !== check) {
81
+ return;
82
+ }
83
+ if (allowed && this._channel.isOpen(deviceId)) {
84
+ this._ours.add(deviceId);
85
+ return;
86
+ }
87
+ this._ours.delete(deviceId);
88
+ this._engines.delete(deviceId);
89
+ this._channel.closeDialled(deviceId, () => new CoreError('DEVICE_REVOKED'));
90
+ }
91
+ }
@@ -0,0 +1,4 @@
1
+ import type { KeyPair } from 'hypercore-crypto';
2
+ export declare const SEALED_SEED_BYTES: number;
3
+ export declare function sealToDevice(message: Buffer, deviceId: Buffer): Buffer;
4
+ export declare function openSealedToDevice(sealed: Buffer, deviceKeyPair: KeyPair): Buffer | null;
@@ -0,0 +1,22 @@
1
+ import b4a from 'b4a';
2
+ import box from 'sodium-universal/crypto_box.js';
3
+ import sign from 'sodium-universal/crypto_sign.js';
4
+ export const SEALED_SEED_BYTES = 32 + box.crypto_box_SEALBYTES;
5
+ export function sealToDevice(message, deviceId) {
6
+ const publicKey = b4a.alloc(box.crypto_box_PUBLICKEYBYTES);
7
+ sign.crypto_sign_ed25519_pk_to_curve25519(publicKey, deviceId);
8
+ const sealed = b4a.alloc(message.byteLength + box.crypto_box_SEALBYTES);
9
+ box.crypto_box_seal(sealed, message, publicKey);
10
+ return sealed;
11
+ }
12
+ export function openSealedToDevice(sealed, deviceKeyPair) {
13
+ if (sealed.byteLength < box.crypto_box_SEALBYTES) {
14
+ return null;
15
+ }
16
+ const publicKey = b4a.alloc(box.crypto_box_PUBLICKEYBYTES);
17
+ const secretKey = b4a.alloc(box.crypto_box_SECRETKEYBYTES);
18
+ sign.crypto_sign_ed25519_pk_to_curve25519(publicKey, deviceKeyPair.publicKey);
19
+ sign.crypto_sign_ed25519_sk_to_curve25519(secretKey, deviceKeyPair.secretKey);
20
+ const message = b4a.alloc(sealed.byteLength - box.crypto_box_SEALBYTES);
21
+ return box.crypto_box_seal_open(message, sealed, publicKey, secretKey) ? message : null;
22
+ }
@@ -6,7 +6,7 @@ export async function saveDeviceCapabilities(store, input, isAccount) {
6
6
  await store.dispatch('report-device-capabilities', report);
7
7
  }
8
8
  export async function retractInventory(store, deviceId, isAccount) {
9
- if (store.compute || isAccount(store))
9
+ if (isAccount(store))
10
10
  return;
11
11
  const snap = store.view.snapshot();
12
12
  let row;
@@ -23,6 +23,13 @@ export interface DocumentReadState {
23
23
  }
24
24
  export declare function documentUnreadReason({ knowledgeOn, failedFiles, attachedCount }: DocumentReadState): DocumentUnreadReason;
25
25
  export declare function documentUnreadNotice(reason: DocumentUnreadReason, plural: boolean): string;
26
+ export interface PdfPagesCutState {
27
+ readonly fileName: string;
28
+ readonly lastPage: number;
29
+ readonly pageCount: number;
30
+ }
31
+ export declare function pdfPagesCutNotice({ fileName, lastPage, pageCount }: PdfPagesCutState): string;
32
+ export declare function pdfPagesSkippedNotice(fileName: string): string;
26
33
  export interface AnnotatedMessage {
27
34
  content: string;
28
35
  documents?: DocumentAttachment[];
@@ -1,9 +1,12 @@
1
1
  import { isAudioAttachment } from './audio-attachment.js';
2
2
  import { classifyRagDocument, RAG_DOCUMENT_KIND } from './files/rag/index.js';
3
3
  import { IMAGE_MIMES } from './image/normalize.js';
4
+ import { isVideoAttachment } from './video/attachment.js';
4
5
  export function isDocumentAttachment(ref) {
5
6
  if (IMAGE_MIMES.has(ref.mimeType.toLowerCase()))
6
7
  return false;
8
+ if (isVideoAttachment(ref.fileName, ref.mimeType))
9
+ return false;
7
10
  return !isAudioAttachment(ref.fileName, ref.mimeType);
8
11
  }
9
12
  export function isPdfAttachment(ref) {
@@ -30,6 +33,12 @@ export function documentUnreadNotice(reason, plural) {
30
33
  }[reason];
31
34
  return `[The attached document${plural ? 's' : ''} could not be read for this reply: ${why}.]`;
32
35
  }
36
+ export function pdfPagesCutNotice({ fileName, lastPage, pageCount }) {
37
+ return `[Only pages 1–${lastPage} of "${fileName}" (${pageCount} pages) were shown to you as images; pages ${lastPage + 1}–${pageCount} were not, and no tool can show them. If asked about a later page you have no excerpt for, tell the user only the first ${lastPage} pages could be read. Do not guess its content.]`;
38
+ }
39
+ export function pdfPagesSkippedNotice(fileName) {
40
+ return `[No page of "${fileName}" was shown to you as an image: the files before it in this message used up the page images, and no tool can show them. If asked about it and you have no excerpt, tell the user it could not be read. Do not guess its content.]`;
41
+ }
33
42
  export function annotateDocumentAttachments(messages) {
34
43
  for (const turn of messages.filter((message) => message.documents?.length)) {
35
44
  const block = (turn.documents ?? []).map(documentAttachmentLine).join('\n');
@@ -1,3 +1,4 @@
1
+ import { CoreError } from '../../errors.js';
1
2
  import { linkAttachment } from '../attachment-link.js';
2
3
  import { getChunk, updateChunk } from '../chunk.js';
3
4
  import { uploadFile } from './upload.js';
@@ -28,13 +29,13 @@ export function attachmentFiles(mesh, { maxBytes = MAX_ATTACHMENT_BYTES, deviceI
28
29
  }
29
30
  const chunk = await getChunk(mesh, chunkId);
30
31
  if (!chunk) {
31
- throw new Error(`chunk not found: ${chunkId}`);
32
+ throw new CoreError('CHUNK_NOT_FOUND', [chunkId]);
32
33
  }
33
34
  if (chunk.type !== 'attachment' || !chunk.attachment) {
34
- throw new Error(`not an attachment chunk: ${chunkId}`);
35
+ throw new CoreError('NOT_AN_ATTACHMENT', [chunkId]);
35
36
  }
36
37
  if (deviceId && !b4a.equals(chunk.originDeviceId, deviceId)) {
37
- throw new Error('only the origin device may delete an attachment');
38
+ throw new CoreError('ATTACHMENT_DELETE_NOT_ORIGIN');
38
39
  }
39
40
  const attachment = chunk.attachment;
40
41
  if (attachment.deletedAt) {
@@ -45,7 +46,7 @@ export function attachmentFiles(mesh, { maxBytes = MAX_ATTACHMENT_BYTES, deviceI
45
46
  attachment: { ...attachment, deletedAt: at }
46
47
  });
47
48
  if (!updated.attachment?.deletedAt) {
48
- throw new Error('delete-attachment dropped — only the origin device may delete an attachment');
49
+ throw new CoreError('ATTACHMENT_DELETE_DROPPED');
49
50
  }
50
51
  return updated;
51
52
  }