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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -1,10 +1,12 @@
1
- import '../logger.js';
2
1
  import { toolsetEnabled } from '@qvac/harness/lib/tools/toolsets.ts';
3
2
  import { getAgent } from '../core/agent.js';
3
+ import { runDefinition } from '../core/shared-agents.js';
4
4
  import { getChat } from '../core/chat.js';
5
- import { isKnowledgeRoutedAttachment, fullTextBudgetChars, fullTextHits, retrieveRagKnowledge, searchRagChunks, referencesPendingFile, referencedDocuments } from '../core/files/index.js';
6
- import { requireMesh } from './current-mesh.js';
5
+ import { chatProject } from '../core/chat-project.js';
6
+ import { isKnowledgeRoutedAttachment, fullTextBudgetChars, fullTextHits, joinedIndex, retrievalBudgetTokens, retrieveRagKnowledge, searchRagChunks, referencesPendingFile } from '../core/files/index.js';
7
+ import { heldMesh, requireMesh } from './current-mesh.js';
7
8
  import { errorMessage } from '../guards.js';
9
+ import b4a from 'b4a';
8
10
  export const MAX_RAG_SEARCH_LIMIT = 20;
9
11
  const DEFAULT_RAG_SEARCH_LIMIT = 5;
10
12
  function clampLimit(limit) {
@@ -14,21 +16,45 @@ function clampLimit(limit) {
14
16
  }
15
17
  export function createRagApi(pool, { index, embedder, effectiveCtxSize = null }) {
16
18
  return {
17
- ragSearch: async ({ chatId, query, mode, limit, attachmentIds, meshId }) => {
19
+ ragSearch: async ({ chatId, query, mode, limit, attachmentIds, meshId, immediate }) => {
18
20
  let pendingFiles = [];
19
- const respond = (overrides) => response({ pendingFiles, ...overrides });
21
+ let projectFilesNotReady = 0;
22
+ let chatFilesIndexingHere = 0;
23
+ const respond = (overrides) => {
24
+ const result = response({
25
+ pendingFiles,
26
+ projectFilesNotReady,
27
+ chatFilesIndexingHere,
28
+ ...overrides
29
+ });
30
+ return { ...result, chatFilesNotReady: result.pendingFiles?.length ?? 0 };
31
+ };
20
32
  const mesh = await requireMesh(pool, meshId);
21
33
  const chat = await getChat(mesh, chatId);
22
34
  const toolMode = mode === 'tool';
23
35
  if (!chat) {
24
36
  return respond({ enabled: false });
25
37
  }
26
- const agent = await getAgent(mesh, chat.agentId);
27
- let rows = await mesh.files.listKnowledge(chatId);
28
- const initialFiles = (await mesh.files.status(chatId)).files;
29
- pendingFiles = pendingFileNames(initialFiles);
38
+ const agent = await runDefinition(mesh, await getAgent(mesh, chat.agentId));
30
39
  const scopeIds = new Set(toolMode ? [] : (attachmentIds ?? []));
31
- let scopeRows = rows.filter((row) => scopeIds.has(row.id));
40
+ const off = new Set(chat.knowledgeSourcesOff ?? []);
41
+ const kept = (id) => !off.has('chat') || scopeIds.has(id);
42
+ const chatKnowledge = async () => (await mesh.files.listKnowledge(chatId)).filter((row) => kept(row.id));
43
+ const chatFiles = async () => (await mesh.files.status(chatId)).files.filter((file) => kept(file.fileId));
44
+ if (!immediate) {
45
+ await mesh.files.indexingHere(chatId);
46
+ }
47
+ const chatRows = await chatKnowledge();
48
+ const initialFiles = await chatFiles();
49
+ pendingFiles = pendingFileNames(initialFiles);
50
+ chatFilesIndexingHere = initialFiles.filter((file) => mesh.files.indexesHere(file)).length;
51
+ const scopeRows = chatRows.filter((row) => scopeIds.has(row.id));
52
+ const project = off.has('project')
53
+ ? null
54
+ : await chatProject(mesh, chatId, (id) => heldMesh(pool, id));
55
+ const kbEntries = project ? ((await project.files.knowledgeBase()).entries ?? []) : [];
56
+ const kbRows = kbEntries.filter((entry) => entry.loaded).map((entry) => entry.knowledge);
57
+ projectFilesNotReady = kbEntries.filter((entry) => !entry.loaded && entry.status !== 'failed').length;
32
58
  if (scopeIds.size > 0 && scopeRows.length === scopeIds.size) {
33
59
  const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
34
60
  const fullText = await fullTextHits(mesh, scopeRows, {
@@ -36,8 +62,11 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
36
62
  head: !agentAllowsRagSearch(agent)
37
63
  });
38
64
  if (fullText) {
65
+ const read = new Set(scopeRows.map((row) => row.id));
66
+ const unread = initialFiles.filter((file) => !read.has(file.fileId));
39
67
  return respond({
40
- pendingFiles: pendingFileNames(initialFiles, new Set(scopeRows.map((row) => row.id))),
68
+ pendingFiles: pendingFileNames(initialFiles, read),
69
+ chatFilesIndexingHere: unread.filter((file) => mesh.files.indexesHere(file)).length,
41
70
  searchedCount: fullText.length,
42
71
  indexEmpty: false,
43
72
  hasKnowledge: true,
@@ -49,30 +78,27 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
49
78
  if (!toolMode && !agentAllowsRagSearch(agent)) {
50
79
  return respond({ enabled: false });
51
80
  }
52
- if (rows.length === 0) {
81
+ if (chatRows.length === 0 && kbRows.length === 0) {
53
82
  return respond({});
54
83
  }
55
- const namedRows = referencedDocuments(query, rows.map((row) => ({ id: row.id, title: row.fileName })));
56
- const unscoped = namedRows.length ? namedRows : rows;
57
- const requested = scopeIds.size ? scopeRows : unscoped;
58
- const waiting = requested.filter((row) => !mesh.files.hydratedArtifact(row.id));
59
- if (waiting.length) {
60
- try {
61
- await mesh.files.settle(waiting.map((row) => row.id));
62
- }
63
- catch (err) {
64
- logger.warn('rag', 'indexing settle failed', { err });
65
- }
66
- rows = await mesh.files.listKnowledge(chatId);
67
- scopeRows = rows.filter((row) => scopeIds.has(row.id));
68
- }
84
+ const rows = [...chatRows, ...kbRows];
69
85
  const hasKnowledge = rows.length > 0;
70
- const vectorIndex = index(meshId);
86
+ const chatIndex = index(meshId);
71
87
  const embed = embedder(meshId);
72
- if (!vectorIndex || !embed) {
88
+ if (!chatIndex || !embed) {
73
89
  return respond({ hasKnowledge, errorMessage: 'knowledge index unavailable on this device' });
74
90
  }
75
- const artifactByRow = new Map(rows.map((row) => [row, mesh.files.hydratedArtifact(row.id)]));
91
+ const projectIndex = project && kbRows.length ? index(b4a.toHex(project.key)) : null;
92
+ const vectorIndex = projectIndex
93
+ ? joinedIndex([chatIndex, projectIndex], {
94
+ chatId,
95
+ knowledgeBaseIds: new Set(kbRows.map((row) => row.id))
96
+ })
97
+ : chatIndex;
98
+ const artifactByRow = new Map([
99
+ ...chatRows.map((row) => [row, mesh.files.hydratedArtifact(row.id)]),
100
+ ...kbRows.map((row) => [row, project?.files.hydratedArtifact(row.id) ?? null])
101
+ ]);
76
102
  const hydratedDocuments = [];
77
103
  for (const [row, artifactId] of artifactByRow) {
78
104
  if (artifactId) {
@@ -82,11 +108,12 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
82
108
  const indexEmpty = hydratedDocuments.length === 0;
83
109
  const availableFiles = [...new Set(hydratedDocuments.map((document) => document.title))];
84
110
  const failedRows = new Set();
85
- const fileStates = (await mesh.files.status(chatId)).files;
111
+ const fileStates = await chatFiles();
112
+ const statusById = new Map(fileStates.map((file) => [file.fileId, file]));
86
113
  for (const row of rows) {
87
114
  if (artifactByRow.get(row))
88
115
  continue;
89
- if (fileStates.find((file) => file.fileId === row.id)?.state === 'failed') {
116
+ if (statusById.get(row.id)?.state === 'failed') {
90
117
  failedRows.add(row);
91
118
  }
92
119
  }
@@ -112,6 +139,14 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
112
139
  failedFiles
113
140
  });
114
141
  }
142
+ if (scopeIds.size > 0 && scopeDocumentIds.length === 0) {
143
+ return respond({
144
+ indexEmpty,
145
+ hasKnowledge,
146
+ availableFiles,
147
+ failedFiles
148
+ });
149
+ }
115
150
  const pendingReferenced = scopeDocumentIds.length === 0 &&
116
151
  referencesPendingFile(query, rows.map((row) => ({
117
152
  title: row.fileName,
@@ -150,7 +185,7 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
150
185
  }, {
151
186
  index: vectorIndex,
152
187
  embed: (texts) => embed.embed({ texts }),
153
- debug: (message) => logger.debug('rag', message)
188
+ debug: (message) => mesh.log?.debug('rag', message)
154
189
  });
155
190
  return respond({
156
191
  searchedCount: hits.length,
@@ -170,16 +205,18 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
170
205
  }
171
206
  }
172
207
  try {
208
+ const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
173
209
  const result = await retrieveRagKnowledge({
174
210
  query,
175
211
  chatId,
176
212
  documents: hydratedDocuments,
177
213
  liveSourceIds: rows.map((row) => row.id),
178
- scopeDocumentIds: scopeDocumentIds.length > 0 ? scopeDocumentIds : undefined
214
+ scopeDocumentIds: scopeDocumentIds.length > 0 ? scopeDocumentIds : undefined,
215
+ chunkBudgetTokens: retrievalBudgetTokens(ctxSize)
179
216
  }, {
180
217
  index: vectorIndex,
181
218
  embed: (texts) => embed.embed({ texts }),
182
- debug: (message) => logger.debug('rag', message)
219
+ debug: (message) => mesh.log?.debug('rag', message)
183
220
  });
184
221
  return respond({
185
222
  searchedCount: result.searchedCount,
@@ -0,0 +1,17 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import type { AssistantMeshList } from '../../spec/hyperschema/types.d.ts';
3
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
4
+ import { type MeshPool } from './current-mesh.ts';
5
+ import type { MeshStatusSource } from './mesh.ts';
6
+ export declare const SERVED_ROUTES: readonly ["listMeshes", "meshesWatch", "chatsWatch", "listChunks", "chunksWatch", "appendChunk", "modelRequestsWatch", "takeModelRequest", "settleModelRequest"];
7
+ export type ServedRoutes = Pick<CapabilityHandlers, (typeof SERVED_ROUTES)[number]>;
8
+ export interface ServedOptions {
9
+ readonly pool: MeshPool;
10
+ readonly local: Partial<Pick<CapabilityHandlers, 'chatsWatch' | 'appendChunk'>>;
11
+ readonly foreign: (meshId: string) => boolean;
12
+ readonly status: Pick<MeshStatusSource, 'watch' | 'unwatch'>;
13
+ readonly list: () => Promise<AssistantMeshList>;
14
+ readonly deviceId: Buffer | null;
15
+ readonly log: LoggerInterface | null;
16
+ }
17
+ export declare function createServedApi({ pool, local, foreign, status, list, deviceId, log }: ServedOptions): ServedRoutes;
@@ -0,0 +1,48 @@
1
+ import { readChunk } from '../core/chunk.js';
2
+ import { listModelRequests } from '../core/model-requests.js';
3
+ import { servedChats } from '../core/public-mesh.js';
4
+ import { createChunksApi } from './chunks.js';
5
+ import { requireMesh, routed } from './current-mesh.js';
6
+ import { watchable } from './watchable.js';
7
+ export const SERVED_ROUTES = [
8
+ 'listMeshes',
9
+ 'meshesWatch',
10
+ 'chatsWatch',
11
+ 'listChunks',
12
+ 'chunksWatch',
13
+ 'appendChunk',
14
+ 'modelRequestsWatch',
15
+ 'takeModelRequest',
16
+ 'settleModelRequest'
17
+ ];
18
+ export function createServedApi({ pool, local, foreign, status, list, deviceId, log }) {
19
+ const chunks = createChunksApi(routed(pool, 'append-chunk'), deviceId, { log });
20
+ const chatsWatch = watchable(({ meshId }) => requireMesh(pool, meshId, { follow: true, wide: true }), async (_request, mesh) => ({
21
+ chats: (deviceId ? await servedChats(mesh, deviceId) : []).map(({ id, agentId, title, createdAt }) => ({
22
+ id,
23
+ agentId,
24
+ title,
25
+ createdAt
26
+ }))
27
+ }), { name: 'chatsWatch', log });
28
+ const rounds = watchable(({ meshId }) => requireMesh(pool, meshId, { follow: true, wide: true }), async (_request, mesh) => {
29
+ const chats = new Set((deviceId ? await servedChats(mesh, deviceId) : []).map(({ id }) => id));
30
+ const live = await listModelRequests(mesh);
31
+ return { chunks: live.filter((round) => chats.has(round.chatId)).map(readChunk) };
32
+ }, { name: 'modelRequestsWatch', log });
33
+ const { chatsWatch: ownChats = chatsWatch, appendChunk: ownAppend = chunks.appendChunk } = local;
34
+ return {
35
+ listMeshes: list,
36
+ meshesWatch: watchable(() => status, list, {
37
+ name: 'meshesWatch',
38
+ log
39
+ }),
40
+ chatsWatch: (request) => (foreign(request.meshId) ? chatsWatch(request) : ownChats(request)),
41
+ listChunks: chunks.listChunks,
42
+ chunksWatch: chunks.chunksWatch,
43
+ appendChunk: (request) => foreign(request.meshId) ? chunks.appendChunk(request) : ownAppend(request),
44
+ modelRequestsWatch: (request) => foreign(request.meshId) ? rounds(request) : chunks.modelRequestsWatch(request),
45
+ takeModelRequest: chunks.takeModelRequest,
46
+ settleModelRequest: chunks.settleModelRequest
47
+ };
48
+ }
@@ -1,3 +1,4 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { type MeshPool } from './current-mesh.ts';
3
- export declare function createSyncApi(pool: MeshPool): Pick<CapabilityHandlers, 'syncStatusWatch'>;
4
+ export declare function createSyncApi(pool: MeshPool, log: LoggerInterface | null): Pick<CapabilityHandlers, 'syncStatusWatch'>;
@@ -1,7 +1,7 @@
1
1
  import { requireMesh } from './current-mesh.js';
2
2
  import { watchable } from './watchable.js';
3
- export function createSyncApi(pool) {
3
+ export function createSyncApi(pool, log) {
4
4
  return {
5
- syncStatusWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).syncActivity ?? null, (_request, activity) => activity.snapshot(), { name: 'syncStatusWatch' })
5
+ syncStatusWatch: watchable(async (request) => (await requireMesh(pool, request.meshId, { follow: true })).syncActivity ?? null, (_request, activity) => activity.snapshot(), { name: 'syncStatusWatch', log })
6
6
  };
7
7
  }
@@ -1,5 +1,6 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { type MeshPool } from './current-mesh.ts';
3
4
  type ToolActivityCapabilities = Pick<CapabilityHandlers, 'listToolActivity' | 'toolActivityWatch' | 'recordToolActivity'>;
4
- export declare function createToolActivityApi(pool: MeshPool, deviceId: Buffer | null): ToolActivityCapabilities;
5
+ export declare function createToolActivityApi(pool: MeshPool, deviceId: Buffer | null, log: LoggerInterface | null): ToolActivityCapabilities;
5
6
  export {};
@@ -1,6 +1,7 @@
1
1
  import { listToolActivity, recordToolActivity } from '../core/tool-activity.js';
2
2
  import { meshWatchable, requireMesh } from './current-mesh.js';
3
3
  import { bounds } from './range.js';
4
+ import { CoreError } from '../errors.js';
4
5
  import b4a from 'b4a';
5
6
  const DEFAULT_LIMIT = 200;
6
7
  const MAX_LIMIT = 1000;
@@ -27,7 +28,7 @@ function toEntry(row) {
27
28
  seq: row.seq ?? 0
28
29
  };
29
30
  }
30
- export function createToolActivityApi(pool, deviceId) {
31
+ export function createToolActivityApi(pool, deviceId, log) {
31
32
  const query = async ({ agentId, ...input }, mesh) => ({
32
33
  activities: (await listToolActivity(mesh, agentId, {
33
34
  ...bounds(input),
@@ -36,10 +37,10 @@ export function createToolActivityApi(pool, deviceId) {
36
37
  });
37
38
  return {
38
39
  listToolActivity: async (request) => query(request, await requireMesh(pool, request.meshId)),
39
- toolActivityWatch: meshWatchable(pool, query, { name: 'toolActivityWatch' }),
40
+ toolActivityWatch: meshWatchable(pool, query, { name: 'toolActivityWatch', log }),
40
41
  recordToolActivity: async (request) => {
41
42
  if (!deviceId) {
42
- throw new Error('cannot record tool activity without a device id');
43
+ throw new CoreError('DEVICE_ID_UNAVAILABLE');
43
44
  }
44
45
  return recordToolActivity(await requireMesh(pool, request.meshId), {
45
46
  agentId: request.agentId,
@@ -1,6 +1,7 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { getToolConfigs } from '../core/tool-configs.ts';
3
4
  import { type MeshPool } from './current-mesh.ts';
4
5
  type ToolConfigsCapabilities = Pick<CapabilityHandlers, 'setToolConfigs' | 'deleteToolConfigs' | 'listToolConfigs' | 'toolConfigsWatch'>;
5
- export declare function createToolConfigsApi(pool: MeshPool): ToolConfigsCapabilities;
6
+ export declare function createToolConfigsApi(pool: MeshPool, log: LoggerInterface | null): ToolConfigsCapabilities;
6
7
  export { getToolConfigs };
@@ -1,24 +1,21 @@
1
1
  import { deleteToolConfigs, getToolConfigs, listToolConfigs, setToolConfigs } from '../core/tool-configs.js';
2
2
  import { meshWatchable, requireMesh } from './current-mesh.js';
3
+ import { CoreError } from '../errors.js';
3
4
  import { isRecord } from '../guards.js';
4
5
  function ensureSettingsPayload(value) {
5
6
  if (!isRecord(value))
6
- throw new Error('tool configs must be a plain object');
7
+ throw new CoreError('TOOL_CONFIGS_INVALID');
7
8
  return value;
8
9
  }
9
- export function createToolConfigsApi(pool) {
10
+ export function createToolConfigsApi(pool, log) {
10
11
  const query = async ({ agentId }, mesh) => ({
11
12
  configs: await listToolConfigs(mesh, agentId)
12
13
  });
13
14
  return {
14
- setToolConfigs: async ({ agentId, toolName, settings, meshId }) => setToolConfigs(await requireMesh(pool, meshId), {
15
- agentId,
16
- toolName,
17
- settings: ensureSettingsPayload(settings)
18
- }),
19
- deleteToolConfigs: async ({ agentId, toolName, meshId }) => deleteToolConfigs(await requireMesh(pool, meshId), agentId, toolName),
15
+ setToolConfigs: async ({ agentId, toolName, settings, meshId }) => setToolConfigs(await requireMesh(pool, meshId), { agentId, toolName, settings: ensureSettingsPayload(settings) }, await requireMesh(pool, meshId, { route: 'put-agent' })),
16
+ deleteToolConfigs: async ({ agentId, toolName, meshId }) => deleteToolConfigs(await requireMesh(pool, meshId), { agentId, toolName }, await requireMesh(pool, meshId, { route: 'put-agent' })),
20
17
  listToolConfigs: async (request) => query(request, await requireMesh(pool, request.meshId)),
21
- toolConfigsWatch: meshWatchable(pool, query, { name: 'toolConfigsWatch' })
18
+ toolConfigsWatch: meshWatchable(pool, query, { name: 'toolConfigsWatch', log })
22
19
  };
23
20
  }
24
21
  export { getToolConfigs };
@@ -1,5 +1,4 @@
1
1
  import type { HandlerFrames } from '../../spec/capabilities.d.ts';
2
- export declare const UPLOAD_NAMES_NO_MESH = "an upload must name its mesh on its first frame";
3
2
  export type UploadFrames<Frame> = AsyncIterable<Frame> | HandlerFrames<Frame>;
4
3
  export interface OpenedUpload<Frame> {
5
4
  readonly first: Frame;
@@ -1,5 +1,4 @@
1
1
  import { toAsyncIterable } from '../core/async-iterable.js';
2
- export const UPLOAD_NAMES_NO_MESH = 'an upload must name its mesh on its first frame';
3
2
  export async function openUpload(frames) {
4
3
  const iterator = toAsyncIterable(frames)[Symbol.asyncIterator]();
5
4
  const first = await iterator.next();
@@ -1,5 +1,5 @@
1
1
  import { Readable } from 'streamx';
2
- import '../logger.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
3
  export declare function snapshotEquals(a: unknown, b: unknown): boolean;
4
4
  interface WatchableStore {
5
5
  watch(listener: () => void): void;
@@ -12,7 +12,8 @@ interface WatchableStore {
12
12
  }
13
13
  export interface WatchableOptions {
14
14
  readonly name: string;
15
+ readonly log: LoggerInterface | null;
15
16
  readonly changes?: WatchableStore;
16
17
  }
17
- export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
+ export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, log, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
19
  export {};
@@ -1,7 +1,6 @@
1
1
  import b4a from 'b4a';
2
2
  import { Readable } from 'streamx';
3
3
  import { frameReadable } from '../frame-readable.js';
4
- import '../logger.js';
5
4
  import { asError, isRecord } from '../guards.js';
6
5
  const SCOPE = ['api', 'watch'];
7
6
  const CHURN_WINDOW_MS = 30_000;
@@ -26,7 +25,7 @@ export function snapshotEquals(a, b) {
26
25
  }
27
26
  return keys.every((key) => snapshotEquals(a[key], b[key]));
28
27
  }
29
- export function watchable(storeOf, query, { name, changes }) {
28
+ export function watchable(storeOf, query, { name, log, changes }) {
30
29
  return (request) => {
31
30
  const resolved = storeOf(request);
32
31
  const pending = resolved instanceof Promise ? resolved.catch(noop) : null;
@@ -45,7 +44,7 @@ export function watchable(storeOf, query, { name, changes }) {
45
44
  if (!force && elapsed < CHURN_WINDOW_MS) {
46
45
  return;
47
46
  }
48
- logger.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
47
+ log?.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
49
48
  churn = 0;
50
49
  reportedAt = now;
51
50
  };
@@ -0,0 +1,5 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import { type MeshPool } from './current-mesh.ts';
3
+ import type { MeshStatusSource } from './mesh.ts';
4
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
5
+ export declare function createWorkspaceApi(pool: MeshPool, status: Pick<MeshStatusSource, 'createWorkspace' | 'name' | 'leaveWorkspace'>, log: LoggerInterface | null): Pick<CapabilityHandlers, 'createWorkspace' | 'getWorkspace' | 'workspaceWatch' | 'updateWorkspace' | 'leaveWorkspace'>;
@@ -0,0 +1,47 @@
1
+ import { MESH_NAMES } from '../core/collections.js';
2
+ import { MESH_NAME_ROW } from '../core/contract/mesh-name.js';
3
+ import { WORKSPACE_ROW, readWorkspace } from '../core/contract/workspace.js';
4
+ import { meshWatchable, requireMesh } from './current-mesh.js';
5
+ import { requireOurAdmin, requireWorkspace } from './members.js';
6
+ async function read(mesh, meshId) {
7
+ requireWorkspace(mesh, meshId);
8
+ const row = await readWorkspace(mesh.view);
9
+ const named = await mesh.view.get(MESH_NAMES, { id: MESH_NAME_ROW });
10
+ return { meshId, name: named?.name ?? '', icon: row?.icon || undefined };
11
+ }
12
+ export function createWorkspaceApi(pool, status, log) {
13
+ return {
14
+ createWorkspace: async (request) => {
15
+ const meshId = await status.createWorkspace({
16
+ name: request?.config?.name ?? undefined,
17
+ icon: request?.config?.icon ?? undefined
18
+ });
19
+ return read(await requireMesh(pool, meshId), meshId);
20
+ },
21
+ getWorkspace: async ({ meshId }) => read(await requireMesh(pool, meshId), meshId),
22
+ workspaceWatch: meshWatchable(pool, ({ meshId }, mesh) => read(mesh, meshId), { name: 'workspaceWatch', log }),
23
+ updateWorkspace: async (request) => update(await requireMesh(pool, request.meshId), request, status),
24
+ leaveWorkspace: async ({ meshId }) => {
25
+ await status.leaveWorkspace(meshId);
26
+ return { ok: true };
27
+ }
28
+ };
29
+ }
30
+ async function update(mesh, { meshId, config }, status) {
31
+ requireWorkspace(mesh, meshId);
32
+ await requireOurAdmin(mesh, 'edit the workspace');
33
+ if (config.name) {
34
+ await status.name(meshId, config.name);
35
+ }
36
+ if (config.icon) {
37
+ const existing = await readWorkspace(mesh.view);
38
+ await mesh.dispatch('put-workspace', {
39
+ workspace: {
40
+ id: WORKSPACE_ROW,
41
+ icon: config.icon,
42
+ updatedAt: Math.max(Date.now(), (existing?.updatedAt ?? 0) + 1)
43
+ }
44
+ });
45
+ }
46
+ return read(mesh, meshId);
47
+ }
@@ -0,0 +1,20 @@
1
+ import type { openLocalStore } from '../core/local/index.ts';
2
+ import type { Harness } from './harness.ts';
3
+ import type { LoggerInterface } from '@qvac/logging';
4
+ export declare const MAX_QUACKS = 500;
5
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
6
+ export type FakeModelsSource = Pick<LocalStore, 'get' | 'watch' | 'unwatch'>;
7
+ export interface FakeModelsOptions {
8
+ enabled?: () => boolean;
9
+ paceMs?: number;
10
+ }
11
+ export declare function quackCount(prompt: string): number;
12
+ export declare function readFakeModels(state: Pick<FakeModelsSource, 'get'>): Promise<boolean>;
13
+ export interface FakeModelsWatchOptions {
14
+ initial: boolean;
15
+ onChange: (enabled: boolean) => void;
16
+ logger?: LoggerInterface | null;
17
+ }
18
+ export declare function watchFakeModels(state: FakeModelsSource, opts: FakeModelsWatchOptions): () => Promise<void>;
19
+ export declare function withFakeModels(harness: Harness, opts?: FakeModelsOptions): Harness;
20
+ export {};
@@ -0,0 +1,112 @@
1
+ import b4a from 'b4a';
2
+ import crypto from 'hypercore-crypto';
3
+ import ScopeLock from 'scope-lock';
4
+ import { FAKE_MODELS_KEY, QUACK_MODEL } from '../constants.js';
5
+ import { errorMessage } from '../guards.js';
6
+ export const MAX_QUACKS = 500;
7
+ const QUACK_ROW = {
8
+ name: QUACK_MODEL,
9
+ type: 'llm',
10
+ taskType: 'llm',
11
+ registryPath: QUACK_MODEL,
12
+ registrySource: 'fake',
13
+ isCached: true,
14
+ isLoaded: true,
15
+ expectedSize: 0,
16
+ supportsImages: false
17
+ };
18
+ export function quackCount(prompt) {
19
+ return 1 + (b4a.readUInt32LE(crypto.hash(b4a.from(prompt)), 0) % MAX_QUACKS);
20
+ }
21
+ export async function readFakeModels(state) {
22
+ return (await state.get(FAKE_MODELS_KEY)) === true;
23
+ }
24
+ export function watchFakeModels(state, opts) {
25
+ const { onChange, logger } = opts;
26
+ const lock = new ScopeLock({ debounce: true });
27
+ let disposed = false;
28
+ let reported = opts.initial;
29
+ const schedule = async () => {
30
+ if (disposed || !(await lock.lock()))
31
+ return;
32
+ try {
33
+ const enabled = await readFakeModels(state);
34
+ if (!disposed && enabled !== reported) {
35
+ reported = enabled;
36
+ onChange(enabled);
37
+ }
38
+ }
39
+ catch (err) {
40
+ logger?.warn('fake-models', 'reading the switch failed', errorMessage(err));
41
+ }
42
+ finally {
43
+ lock.unlock();
44
+ }
45
+ };
46
+ const listener = () => void schedule();
47
+ state.watch(listener);
48
+ return async () => {
49
+ disposed = true;
50
+ state.unwatch(listener);
51
+ lock.destroy();
52
+ await lock.flush();
53
+ };
54
+ }
55
+ export function withFakeModels(harness, opts = {}) {
56
+ const { enabled = () => true, paceMs = 10 } = opts;
57
+ const isQuack = (model) => model === QUACK_MODEL && enabled();
58
+ const quacking = {
59
+ ...modelCalls(harness, isQuack),
60
+ completion: (context) => isQuack(context.model) ? quack(context, paceMs) : harness.completion(context)
61
+ };
62
+ return new Proxy(harness, {
63
+ get(target, key) {
64
+ if (Object.hasOwn(quacking, key)) {
65
+ return Reflect.get(quacking, key);
66
+ }
67
+ const value = Reflect.get(target, key);
68
+ return typeof value === 'function' ? value.bind(target) : value;
69
+ }
70
+ });
71
+ }
72
+ function modelCalls(harness, isQuack) {
73
+ const list = harness.list?.bind(harness);
74
+ const warmModel = harness.warmModel?.bind(harness);
75
+ const loadModel = harness.loadModel?.bind(harness);
76
+ const unloadModel = harness.unloadModel?.bind(harness);
77
+ const deleteModel = harness.deleteModel?.bind(harness);
78
+ return {
79
+ list: list &&
80
+ (async (options) => {
81
+ const rows = await list(options);
82
+ return isQuack(QUACK_MODEL) ? withQuackRow(rows, options?.type) : rows;
83
+ }),
84
+ warmModel: warmModel && ((context) => (isQuack(context.model) ? Promise.resolve() : warmModel(context))),
85
+ loadModel: loadModel &&
86
+ ((context) => isQuack(context.model) ? Promise.resolve({ loaded: true }) : loadModel(context)),
87
+ unloadModel: unloadModel &&
88
+ ((context) => isQuack(context.model) ? Promise.resolve({ unloaded: true }) : unloadModel(context)),
89
+ deleteModel: deleteModel &&
90
+ ((name) => isQuack(name) ? Promise.resolve({ name, removed: 0, freedBytes: 0 }) : deleteModel(name))
91
+ };
92
+ }
93
+ function withQuackRow(rows, type) {
94
+ return type && type !== 'llm' ? rows : [...rows, QUACK_ROW];
95
+ }
96
+ async function* quack(context, paceMs) {
97
+ const prompt = context.messages.findLast((turn) => turn.role === 'user')?.content ?? '';
98
+ const count = quackCount(prompt);
99
+ for (let i = 0; i < count; i++) {
100
+ if (i > 0) {
101
+ await pace(paceMs);
102
+ }
103
+ if (context.signal?.aborted) {
104
+ yield { type: 'aborted' };
105
+ return;
106
+ }
107
+ yield { type: 'content', text: i === 0 ? 'quack' : ' quack' };
108
+ }
109
+ }
110
+ function pace(ms) {
111
+ return new Promise((resolve) => setTimeout(resolve, ms));
112
+ }