@qvac/core 1.0.0-rc.1 → 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
package/README.md CHANGED
@@ -21,8 +21,7 @@
21
21
  <a href="#one-shot-tasks">Tasks</a> &middot;
22
22
  <a href="#rendering-the-chunk-stream-any-ui">Chunk stream</a> &middot;
23
23
  <a href="#harness-event-reference">Events</a> &middot;
24
- <a href="#development">Development</a> &middot;
25
- <a href="#the-duck-tui">duck TUI</a>
24
+ <a href="#development">Development</a>
26
25
  </p>
27
26
 
28
27
  A P2P, multi-device AI workbench core. Three pieces, one duplex stream:
@@ -44,23 +43,12 @@ A P2P, multi-device AI workbench core. Three pieces, one duplex stream:
44
43
 
45
44
  ## Install
46
45
 
47
- `@qvac/core` is two things: a **library** you embed, and **`duck`**, a terminal
48
- app that runs the whole stack on top of it.
49
-
50
- ```sh
51
- npm i @qvac/core # the library
52
- npm i -g @qvac/core # duck, on your PATH
53
- ```
54
-
55
46
  ```sh
56
- duck # the TUI
57
- duck --help
47
+ npm i @qvac/core
58
48
  ```
59
49
 
60
50
  The library is the three pieces above — start at
61
- [Integrating a harness](#integrating-a-harness). `duck` is the fastest way to
62
- watch them work, and what the examples here drive; it has its own section at
63
- [The duck TUI](#the-duck-tui). Runnable examples live in
51
+ [Integrating a harness](#integrating-a-harness). Runnable examples live in
64
52
  [`examples/`](./examples/README.md); `bun run mesh-two-people` is the shortest
65
53
  one, and shows what a device invite does that a member invite does not.
66
54
 
@@ -117,7 +105,7 @@ difference, because it only ever speaks capabilities. It is a
117
105
  backgrounding — stops taking new work; in-flight runs finish).
118
106
 
119
107
  The real llama.cpp harness lives in `../assistant-harness` and implements this
120
- same contract — see `tui/index.mjs` for it running end to end.
108
+ same contract.
121
109
 
122
110
  ### The harness over a wire (desktop / mobile)
123
111
 
@@ -279,6 +267,8 @@ replicated runs:
279
267
  - `generating-image` / `generating-audio` / `transcribing-audio` — the active run
280
268
  refined by the media it is producing.
281
269
  - `awaiting-approval` — the active run paused on the user.
270
+ - `awaiting-download` — the active run waits for a model the user has not let
271
+ download yet (`autoDownloadModels` is off).
282
272
 
283
273
  Every value is a mutually-exclusive state, not a parallel flag. Runs serialize
284
274
  per chat, so at most one is executing. The list carries only active chats — a
@@ -339,11 +329,25 @@ A chat IS its chunk stream — one watch drives the whole view, and every
339
329
  device renders the same thing because they all see the same chunks:
340
330
 
341
331
  ```js
342
- for await (const { chunks } of engine.chunksWatch({ meshId, chatId })) render(chunks)
332
+ const rows = new Map()
333
+ for await (const { reset, chunks = [], removed = [] } of engine.chunksDeltaWatch({
334
+ meshId,
335
+ chatId
336
+ })) {
337
+ if (reset) rows.clear()
338
+ for (const id of removed) rows.delete(id)
339
+ for (const chunk of chunks) rows.set(chunk.id, chunk)
340
+ render([...rows.values()].sort((a, b) => a.seq - b.seq))
341
+ }
343
342
  ```
344
343
 
345
- Each frame is the full chat in seq order. To render it, group chunks into
346
- turns, then map each chunk type:
344
+ The first frame is the whole chat; after that each frame carries only the rows
345
+ that changed, so a long streamed answer costs one row per chunk rather than the
346
+ whole chat each time. `chunksWatch` takes the same request and sends the full
347
+ list on every change, for a reader that wants it that way. A view over a long
348
+ chat also opens on a page and watches from its floor — see
349
+ [`chunksDeltaWatch`](docs/api/chunks.md#chunksdeltawatch). To render the rows,
350
+ group chunks into turns, then map each chunk type:
347
351
 
348
352
  **Grouping.** A `user-message` (and an `attachment`) is its own user turn —
349
353
  label it by `originDeviceId`, resolved to a name via `devicesWatch`. Every
@@ -394,9 +398,6 @@ provider" — on the agent itself, and on a busy turn whose agent is orphaned
394
398
  does NOT delete the device's agents: their chats survive, and re-homing
395
399
  brings them back.
396
400
 
397
- `tui/app.mjs` (`turnsFromChunks`, `renderTurn`) is this table as
398
- working code — the same model drives the TUI end to end.
399
-
400
401
  ## File status
401
402
 
402
403
  `Mesh.files`, implemented in `lib/core/files/index.ts`, owns file access, local
@@ -551,7 +552,9 @@ contract:
551
552
  the fetch — there is no fetch-then-subscribe race to paper over, ever.
552
553
  - **Later frames arrive only on real change** (identical snapshots are
553
554
  deduped server-side), and each frame is the full current result, not a
554
- delta.
555
+ delta. The one exception says so in its name: `chunksDeltaWatch` sends a
556
+ `reset` first and the changed rows after it, and its reset is still the
557
+ snapshot.
555
558
  - **`destroy()` is the unsubscribe** (ending a `for await` does the same
556
559
  thing). Nothing else to call, no registry to clean up — in any process,
557
560
  over any transport.
@@ -643,43 +646,30 @@ skill's `allow_list` binds that key to the URL prefixes it may be sent to.
643
646
  Credentials are **per agent** (stored at `skills.<agentId>.<key>`), so two
644
647
  agents never share one connection.
645
648
 
646
- Fill a key with a slash command in the running TUI — see
647
- [The duck TUI](#the-duck-tui):
649
+ A host fills a key: `@qvac/core/oauth` runs the browser OAuth flow for Google,
650
+ Spotify, Asana and Notion, stores the token and refreshes it on use, and
651
+ `@qvac/core/credential-pusher` keeps the harness's copy current.
648
652
 
649
- - `/connect google` · `/connect spotify` · `/connect asana` · `/connect notion` — browser OAuth;
650
- the example stores the token and refreshes it on use.
651
- - `/cred <key> <value>` — set any credential key by hand, for a service with
652
- no built-in OAuth flow.
653
-
654
- `/connect google` needs `GOOGLE_OAUTH_CLIENT_ID` + `GOOGLE_OAUTH_CLIENT_SECRET`
655
- in env, `/connect spotify` needs `SPOTIFY_OAUTH_CLIENT_ID`, `/connect asana` needs
656
- `ASANA_OAUTH_CLIENT_ID` + `ASANA_OAUTH_CLIENT_SECRET` (an MCP-type app registered
657
- at app.asana.com); `/connect notion` needs nothing — its MCP server self-provisions
658
- a public client via dynamic registration (RFC 7591) + PKCE.
653
+ Google and Asana need the host's own client id and secret (for Asana, an
654
+ MCP-type app registered at app.asana.com), Spotify a client id; Notion needs
655
+ nothing — its MCP server self-provisions a public client via dynamic
656
+ registration (RFC 7591) + PKCE.
659
657
 
660
658
  ### Notion
661
659
 
662
660
  Notion runs over its official MCP server (`https://mcp.notion.com/mcp`) via
663
- the `mcp_call` tool, under the credential key `notion_mcp_access_token`:
664
-
665
- ```
666
- /connect notion # authorize in the browser, pick the pages to share
667
- /skill on notion # if the agent's skill scope is 'selected'
668
- ```
669
-
670
- Then ask the assistant anything Notion — it loads the `notion` skill and calls
661
+ the `mcp_call` tool, under the credential key `notion_mcp_access_token`. Once the agent holds the token, and has the `notion` skill when its skill scope
662
+ is `selected`, ask the assistant anything Notion — it loads the skill and calls
671
663
  `mcp_call` itself; the session handshake and auth are handled for you. A `401`
672
- in a tool result means the token expired — run `/connect notion` again.
664
+ in a tool result means the token expired — connect Notion again.
673
665
 
674
666
  ## Development
675
667
 
676
668
  ```sh
677
669
  npm test # node + bare suites
678
670
  npm run build:schema # regenerate spec/ from schema/ (bare)
679
- bun run duck # run the TUI (no build step)
680
671
  ```
681
672
 
682
- The TUI lives in [`tui/`](tui/README.md) and installs as the `duck` command.
683
673
  Schema changes go in `schema/*.ts` (builders) — `spec/` is generated. The
684
674
  mesh schema (`spec/mesh/*`) is the replicated protocol: every device in a
685
675
  mesh must run the same generated spec. See `MIGRATION.md` for the audited
@@ -687,40 +677,9 @@ feature checklist vs core v1.
687
677
 
688
678
  ### Office documents
689
679
 
690
- Core ships no office decoder. Word-processor documents (`.docx`, `.doc`,
680
+ Core ships no office decoder. Office documents (`.docx`, `.xlsx`, `.pptx`,
691
681
  `.odt`, …) index only when the host passes one through the `extractors.office`
692
- option — the app injects `extractOfficeText` from `@qvac/harness/office`.
693
- `duck` injects none, so those formats fail to index there even though
694
- `/knowledge add` accepts them. Everything else it accepts — `.pdf`, `.txt`,
682
+ option — the desktop app injects `extractOfficeText` from
683
+ `@qvac/harness/office`. A host without one, such as mobile, fails those files
684
+ as `extractor unavailable on this device`. Everything else — `.pdf`, `.txt`,
695
685
  `.md`, `.rtf`, `.html`, `.csv`, `.json` and the rest — works from any install.
696
-
697
- ## The duck TUI
698
-
699
- `duck` brings the whole stack up — Core, the assistant, your harness — behind a
700
- terminal UI. It is on your PATH after `npm i -g @qvac/core`, or `bun run duck`
701
- in this repo. `duck --help` lists the flags.
702
-
703
- The TUI copies its mesh invite to the clipboard on ctrl+y. On a second machine
704
- (or a second terminal), start `duck` and join from inside it:
705
-
706
- ```
707
- /join qvac://mesh/…
708
- ```
709
-
710
- That retires the mesh it is on, joins the invited one, and re-resolves the agent
711
- and chat from it. The engine takes an invite live, so joining never needed to be
712
- a boot argument.
713
-
714
- `--headless` brings the same stack up with no TUI: it prints the invite and then
715
- streams logs (including the sidecar child's own output, which the TUI drops) to
716
- stdout until ctrl+C. That is the shape to run as a background mesh peer, and the
717
- only way to read the engine's logs live — `QVAC_LOG_LEVEL` picks the level:
718
-
719
- ```sh
720
- duck --headless
721
- ```
722
-
723
- The joiner brings no models and no agents — it finds the mesh's seeded agent,
724
- asks, and the _creator's_ device runs the model while both sides watch the
725
- same replicated stream: load progress, thinking, tokens, tool approvals
726
- (either side can answer), and final stats.
@@ -1,6 +1,5 @@
1
1
  export type { AssistantAgent, AssistantAgentList, AssistantConfigValue } from './spec/hyperschema/types.d.ts';
2
2
  export type { Logger } from './lib/logger-type.ts';
3
- export { setLogger } from './lib/logger.ts';
4
3
  export { Core } from './lib/core.ts';
5
4
  export { Client } from './lib/client.ts';
6
5
  export { AssistantClient } from './lib/assistant-client.ts';
package/dist-lib/index.js CHANGED
@@ -1,4 +1,3 @@
1
- export { setLogger } from './lib/logger.js';
2
1
  export { Core } from './lib/core.js';
3
2
  export { Client } from './lib/client.js';
4
3
  export { AssistantClient } from './lib/assistant-client.js';
@@ -0,0 +1,22 @@
1
+ import type { AssistantAddAgentFolderRequest, AssistantAgentFolders, AssistantAgentFoldersRequest, AssistantRemoveAgentFolderRequest } from '../../spec/hyperschema/types.d.ts';
2
+ import type { openLocalStore } from '../core/local/index.ts';
3
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
4
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
5
+ export interface AgentFoldersOptions {
6
+ readonly storageRoot: string;
7
+ }
8
+ export declare class AgentFolders {
9
+ private readonly _state;
10
+ private readonly _storageRoot;
11
+ private readonly _lock;
12
+ constructor(state: LocalStore, { storageRoot }: AgentFoldersOptions);
13
+ list({ agentId }: AssistantAgentFoldersRequest): Promise<AssistantAgentFolders>;
14
+ add({ agentId, path: given, access }: AssistantAddAgentFolderRequest): Promise<AssistantAgentFolders>;
15
+ remove({ agentId, path: given }: AssistantRemoveAgentFolderRequest): Promise<AssistantAgentFolders>;
16
+ forget(agentId: string): Promise<void>;
17
+ private _read;
18
+ private _update;
19
+ private _shareable;
20
+ }
21
+ export declare function createAgentFoldersApi(folders: AgentFolders): Pick<CapabilityHandlers, 'listAgentFolders' | 'addAgentFolder' | 'removeAgentFolder'>;
22
+ export {};
@@ -0,0 +1,115 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import ScopeLock from 'scope-lock';
4
+ import { CoreError } from '../errors.js';
5
+ import { fsGrantKey, fsWriteGrantKey } from '../fs-grant-keys.js';
6
+ import { fsGrantsFrom, grantedDirsFrom } from '../fs-grants.js';
7
+ export class AgentFolders {
8
+ _state;
9
+ _storageRoot;
10
+ _lock = new ScopeLock();
11
+ constructor(state, { storageRoot }) {
12
+ this._state = state;
13
+ this._storageRoot = storageRoot;
14
+ }
15
+ async list({ agentId }) {
16
+ return { agentId, folders: foldersOf(await this._read(agentId)) };
17
+ }
18
+ async add({ agentId, path: given, access }) {
19
+ const folder = await this._shareable(given);
20
+ return this._update(agentId, ({ roots, writable }) => ({
21
+ roots: localPathsOf(roots).includes(folder)
22
+ ? roots
23
+ : [...roots, { kind: 'local', path: folder }],
24
+ writable: access === 'write' ? withDir(writable, folder) : withoutDir(writable, folder)
25
+ }));
26
+ }
27
+ async remove({ agentId, path: given }) {
28
+ const names = await namesOf(given);
29
+ return this._update(agentId, (grants) => {
30
+ if (!foldersOf(grants).some((folder) => names.includes(folder.path))) {
31
+ throw new CoreError('AGENT_FOLDER_NOT_SHARED', [given]);
32
+ }
33
+ return {
34
+ roots: grants.roots.filter((root) => !names.includes(localPathOf(root) ?? '')),
35
+ writable: names.reduce(withoutDir, grants.writable)
36
+ };
37
+ });
38
+ }
39
+ async forget(agentId) {
40
+ await this._lock.lock();
41
+ try {
42
+ await this._state.deleteAll([fsGrantKey(agentId), fsWriteGrantKey(agentId)]);
43
+ }
44
+ finally {
45
+ this._lock.unlock();
46
+ }
47
+ }
48
+ async _read(agentId) {
49
+ const [roots, writable] = await Promise.all([
50
+ this._state.get(fsGrantKey(agentId)),
51
+ this._state.get(fsWriteGrantKey(agentId))
52
+ ]);
53
+ return { roots: Array.isArray(roots) ? roots : [], writable: grantedDirsFrom(writable) };
54
+ }
55
+ async _update(agentId, change) {
56
+ await this._lock.lock();
57
+ try {
58
+ const next = change(await this._read(agentId));
59
+ await this._state.setAll([
60
+ { key: fsGrantKey(agentId), value: next.roots },
61
+ { key: fsWriteGrantKey(agentId), value: next.writable }
62
+ ]);
63
+ return { agentId, folders: foldersOf(next) };
64
+ }
65
+ finally {
66
+ this._lock.unlock();
67
+ }
68
+ }
69
+ async _shareable(given) {
70
+ if (!path.isAbsolute(given)) {
71
+ throw new CoreError('AGENT_FOLDER_NOT_ABSOLUTE', [given]);
72
+ }
73
+ const folder = await fs.promises.realpath(given).catch(() => null);
74
+ if (!folder) {
75
+ throw new CoreError('AGENT_FOLDER_MISSING', [given]);
76
+ }
77
+ if (!(await fs.promises.stat(folder)).isDirectory()) {
78
+ throw new CoreError('AGENT_FOLDER_IS_FILE', [given]);
79
+ }
80
+ const storage = await fs.promises.realpath(this._storageRoot);
81
+ if (folder === storage || folder.startsWith(storage + path.sep)) {
82
+ throw new CoreError('AGENT_FOLDER_IN_STORAGE', [given]);
83
+ }
84
+ return folder;
85
+ }
86
+ }
87
+ export function createAgentFoldersApi(folders) {
88
+ return {
89
+ listAgentFolders: (request) => folders.list(request),
90
+ addAgentFolder: (request) => folders.add(request),
91
+ removeAgentFolder: (request) => folders.remove(request)
92
+ };
93
+ }
94
+ async function namesOf(given) {
95
+ const resolved = path.resolve(given);
96
+ const real = await fs.promises.realpath(resolved).catch(() => resolved);
97
+ return [...new Set([resolved, real])];
98
+ }
99
+ function localPathOf(root) {
100
+ const [grant] = fsGrantsFrom([root]);
101
+ return grant?.kind === 'local' ? grant.path : null;
102
+ }
103
+ function localPathsOf(roots) {
104
+ return roots.map(localPathOf).filter((dir) => dir !== null);
105
+ }
106
+ function withDir(dirs, dir) {
107
+ return dirs.includes(dir) ? dirs : [...dirs, dir];
108
+ }
109
+ function withoutDir(dirs, dir) {
110
+ return dirs.filter((other) => other !== dir);
111
+ }
112
+ function foldersOf({ roots, writable }) {
113
+ const paths = [...new Set([...localPathsOf(roots), ...writable])];
114
+ return paths.map((dir) => ({ path: dir, access: writable.includes(dir) ? 'write' : 'read' }));
115
+ }
@@ -1,5 +1,22 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import type { QvacAgent } from '../../spec/mesh/hyperschema/types.d.ts';
1
3
  import { type MeshPool } from './current-mesh.ts';
2
4
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
- type AgentCapabilities = Pick<CapabilityHandlers, 'createAgent' | 'listAgents' | 'getAgent' | 'getDefaultAgent' | 'updateAgent' | 'deleteAgent' | 'agentsWatch'>;
4
- export declare function createAgentsApi(pool: MeshPool, deviceId: Buffer | null, computeLender?: (() => Promise<Buffer | null>) | null): AgentCapabilities;
5
+ import type { MeshStatusSource } from './mesh.ts';
6
+ import type { AgentFolders } from './agent-folders.ts';
7
+ type AgentCapabilities = Pick<CapabilityHandlers, 'createAgent' | 'listAgents' | 'getAgent' | 'getDefaultAgent' | 'updateAgent' | 'deleteAgent' | 'agentsWatch' | 'shareAgent' | 'unshareAgent'>;
8
+ export interface CreateAgentsApiOptions {
9
+ readonly deviceId: Buffer | null;
10
+ readonly changed?: ((agentId: string) => Promise<void>) | null;
11
+ readonly keepCopies?: ((agent: QvacAgent) => Promise<void>) | null;
12
+ readonly peers?: Pick<MeshStatusSource, 'watch' | 'unwatch' | 'snapshot'> | null;
13
+ readonly accountChanges?: AccountChanges | null;
14
+ readonly folders: AgentFolders | null;
15
+ readonly log: LoggerInterface | null;
16
+ }
17
+ interface AccountChanges {
18
+ watch(listener: () => void): void;
19
+ unwatch(listener: () => void): void;
20
+ }
21
+ export declare function createAgentsApi(pool: MeshPool, { deviceId, changed, keepCopies, peers, accountChanges, folders, log }: CreateAgentsApiOptions): AgentCapabilities;
5
22
  export {};
@@ -1,50 +1,147 @@
1
- import { createAgent, deleteAgent, getDefaultAgent, isOrphaned, listAgents, liveProviderIds, mustGetActiveAgent, updateAgent } from '../core/agent.js';
2
- import { meshWatchable, requireMesh } from './current-mesh.js';
1
+ import { createAgent, deleteAgent, getAgent, getDefaultAgent, isOrphaned, listAgents, liveProviderIds, mustGetActiveAgent, mustGetAgent, updateAgent } from '../core/agent.js';
2
+ import { runDefinition, shareAgent, unshareAgent, workspaceAgents } from '../core/shared-agents.js';
3
+ import { softDeleteToolConfigsForAgent } from '../core/tool-configs.js';
4
+ import { CoreError } from '../errors.js';
5
+ import { requireMesh } from './current-mesh.js';
6
+ import { requireOurMember, requireWorkspace } from './members.js';
7
+ import { watchable } from './watchable.js';
3
8
  import b4a from 'b4a';
4
- export function createAgentsApi(pool, deviceId, computeLender = null) {
5
- const withOrphaned = async (mesh, agent) => ({
9
+ const WORKSPACE_ROWS = { route: 'put-project' };
10
+ const CHAT_ROWS = { route: 'put-chat' };
11
+ async function notPicked(mesh, agentId) {
12
+ if ((await getAgent(mesh, agentId))?.sharedIn) {
13
+ throw new CoreError('AGENT_NOT_OURS');
14
+ }
15
+ }
16
+ async function definitions(mesh, rows) {
17
+ const resolved = await Promise.all(rows.map((row) => runDefinition(mesh, row)));
18
+ return resolved.filter((row) => row !== null);
19
+ }
20
+ export function createAgentsApi(pool, { deviceId, changed = null, keepCopies = null, peers = null, accountChanges = null, folders, log }) {
21
+ const reachable = () => new Set([
22
+ ...(peers?.snapshot().peerDeviceIds ?? []),
23
+ ...(deviceId ? [b4a.toHex(deviceId)] : [])
24
+ ]);
25
+ const withDerived = async (mesh, agent) => ({
6
26
  ...agent,
7
- orphaned: await isOrphaned(mesh, agent)
27
+ lenderDeviceId: undefined,
28
+ orphaned: await isOrphaned(mesh, agent),
29
+ hostReachable: reachable().has(b4a.toHex(agent.providerDeviceId))
8
30
  });
9
- const list = async (mesh, providerDeviceId) => {
10
- const [agents, live] = await Promise.all([
11
- listAgents(mesh, providerDeviceId),
12
- liveProviderIds(mesh)
31
+ const list = async ({ meshId, providerDeviceId }) => {
32
+ const mesh = await requireMesh(pool, meshId);
33
+ const scope = await requireMesh(pool, meshId, WORKSPACE_ROWS);
34
+ const listed = scope.role === 'workspace' && scope !== mesh
35
+ ? await workspaceAgents(scope, await listAgents(mesh))
36
+ : await definitions(mesh, await listAgents(mesh));
37
+ const agents = listed.filter((agent) => !providerDeviceId || b4a.equals(agent.providerDeviceId, providerDeviceId));
38
+ const picked = await mesh.pickedFrom?.();
39
+ const live = new Set([
40
+ ...(await liveProviderIds(mesh)),
41
+ ...(scope === mesh ? [] : await liveProviderIds(scope)),
42
+ ...(picked ? await liveProviderIds(picked) : [])
13
43
  ]);
44
+ const hosts = reachable();
14
45
  return {
15
- agents: agents.map((agent) => ({
16
- ...agent,
17
- orphaned: !live.has(b4a.toHex(agent.providerDeviceId))
18
- }))
46
+ agents: agents.map((agent) => {
47
+ const host = b4a.toHex(agent.providerDeviceId);
48
+ return {
49
+ ...agent,
50
+ lenderDeviceId: undefined,
51
+ orphaned: !live.has(host),
52
+ hostReachable: hosts.has(host)
53
+ };
54
+ })
19
55
  };
20
56
  };
57
+ const sharing = async (meshId) => {
58
+ const workspace = await requireMesh(pool, meshId, WORKSPACE_ROWS);
59
+ requireWorkspace(workspace, meshId);
60
+ await requireOurMember(workspace);
61
+ const account = await requireMesh(pool, meshId);
62
+ if (account.role !== 'account') {
63
+ throw new CoreError('MESH_NOT_FOUND', [meshId]);
64
+ }
65
+ return { account, workspace };
66
+ };
67
+ const agentHolder = async (meshId, agentId) => {
68
+ const mesh = await requireMesh(pool, meshId);
69
+ const chats = await requireMesh(pool, meshId, CHAT_ROWS);
70
+ return chats !== mesh && !(await getAgent(mesh, agentId)) ? chats : mesh;
71
+ };
21
72
  return {
22
73
  createAgent: async ({ meshId, config }) => {
23
74
  const mesh = await requireMesh(pool, meshId);
24
- const lenderDeviceId = config.lenderDeviceId ?? (await computeLender?.()) ?? undefined;
25
- return withOrphaned(mesh, await createAgent(mesh, { ...config, lenderDeviceId }));
75
+ return withDerived(mesh, await createAgent(mesh, config));
26
76
  },
27
- listAgents: async ({ meshId, providerDeviceId }) => list(await requireMesh(pool, meshId), providerDeviceId ?? undefined),
77
+ listAgents: list,
28
78
  getAgent: async ({ agentId, meshId }) => {
29
- const mesh = await requireMesh(pool, meshId);
30
- return withOrphaned(mesh, await mustGetActiveAgent(mesh, agentId));
79
+ const mesh = await agentHolder(meshId, agentId);
80
+ const row = await mustGetAgent(mesh, agentId);
81
+ if (!row.sharedIn) {
82
+ await mustGetActiveAgent(mesh, agentId);
83
+ }
84
+ const agent = await runDefinition(mesh, row);
85
+ if (!agent) {
86
+ throw new CoreError('CHAT_AGENT_UNAVAILABLE');
87
+ }
88
+ return withDerived((await mesh.pickedFrom?.()) ?? mesh, agent);
31
89
  },
32
90
  getDefaultAgent: async ({ meshId, providerDeviceId }) => {
33
91
  const mesh = await requireMesh(pool, meshId);
34
92
  const agent = await getDefaultAgent(mesh, providerDeviceId ?? undefined);
35
- if (!agent) {
93
+ if (!agent || (await runDefinition(mesh, agent)) !== agent) {
36
94
  return {};
37
95
  }
38
- return { agent: await withOrphaned(mesh, agent) };
96
+ return { agent: await withDerived(mesh, agent) };
39
97
  },
40
98
  updateAgent: async ({ agentId, meshId, config }) => {
41
99
  const mesh = await requireMesh(pool, meshId);
42
- return withOrphaned(mesh, await updateAgent(mesh, agentId, config));
100
+ await notPicked(mesh, agentId);
101
+ const updated = await updateAgent(mesh, agentId, config);
102
+ await changed?.(agentId);
103
+ return withDerived(mesh, updated);
43
104
  },
44
- deleteAgent: async ({ agentId, meshId }) => {
105
+ deleteAgent: async ({ agentId, meshId, keepChats }) => {
45
106
  const mesh = await requireMesh(pool, meshId);
46
- return withOrphaned(mesh, await deleteAgent(mesh, deviceId, agentId));
107
+ await notPicked(mesh, agentId);
108
+ const deleted = await deleteAgent(mesh, deviceId, { id: agentId, keepChats, keepCopies });
109
+ await changed?.(agentId);
110
+ await folders?.forget(agentId);
111
+ const configs = await requireMesh(pool, meshId, { route: 'put-tool-configs' });
112
+ if (configs !== mesh) {
113
+ await softDeleteToolConfigsForAgent(configs, agentId);
114
+ }
115
+ return withDerived(mesh, deleted);
116
+ },
117
+ agentsWatch: watchable((request) => requireMesh(pool, request.meshId, { ...WORKSPACE_ROWS, follow: true }), (request) => list(request), {
118
+ name: 'agentsWatch',
119
+ log,
120
+ changes: {
121
+ watch: (listener) => {
122
+ peers?.watch(listener);
123
+ accountChanges?.watch(listener);
124
+ },
125
+ unwatch: (listener) => {
126
+ peers?.unwatch(listener);
127
+ accountChanges?.unwatch(listener);
128
+ }
129
+ }
130
+ }),
131
+ shareAgent: async ({ agentId, meshId }) => {
132
+ const { account, workspace } = await sharing(meshId);
133
+ const shared = await shareAgent(account, workspace, agentId);
134
+ return {
135
+ ...shared,
136
+ orphaned: false,
137
+ hostReachable: reachable().has(b4a.toHex(shared.providerDeviceId)),
138
+ ownerMemberId: workspace.ourMemberId,
139
+ shared: true
140
+ };
47
141
  },
48
- agentsWatch: meshWatchable(pool, (request, mesh) => list(mesh, request.providerDeviceId ?? undefined), { name: 'agentsWatch' })
142
+ unshareAgent: async ({ agentId, meshId }) => {
143
+ await unshareAgent((await sharing(meshId)).workspace, agentId);
144
+ return { ok: true };
145
+ }
49
146
  };
50
147
  }
@@ -1,5 +1,8 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import type { AssistantAppConfig } from '../../spec/hyperschema/types.d.ts';
1
3
  import type { openLocalStore } from '../core/local/index.ts';
2
4
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
5
  type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
4
- export declare function createAppConfigApi(state: LocalStore): Pick<CapabilityHandlers, 'getConfig' | 'setConfig' | 'setModelPaused' | 'setModelReleased' | 'configWatchTyped'>;
6
+ export declare function writeAutoDownloadModels(state: LocalStore, enabled: boolean): Promise<AssistantAppConfig>;
7
+ export declare function createAppConfigApi(state: LocalStore, log: LoggerInterface | null): Pick<CapabilityHandlers, 'getConfig' | 'setConfig' | 'setModelPaused' | 'setModelReleased' | 'setAutoDownloadModels' | 'configWatchTyped'>;
5
8
  export {};
@@ -22,7 +22,8 @@ const DEFAULT_CONFIG = {
22
22
  onboardingCompleted: false,
23
23
  delegation: EMPTY_DELEGATION,
24
24
  pausedModels: [],
25
- releasedModels: []
25
+ releasedModels: [],
26
+ autoDownloadModels: true
26
27
  };
27
28
  const DelegationSchema = z.object({
28
29
  enabled: z.boolean().optional(),
@@ -71,7 +72,8 @@ function toConfig(row) {
71
72
  onboardingCompleted: row.onboardingCompleted ?? false,
72
73
  delegation: normalizeDelegation(row.delegation),
73
74
  pausedModels: row.pausedModels ?? [],
74
- releasedModels: row.releasedModels ?? []
75
+ releasedModels: row.releasedModels ?? [],
76
+ autoDownloadModels: !row.manualModelDownloads
75
77
  };
76
78
  }
77
79
  function applyWrite(current, update) {
@@ -84,7 +86,8 @@ function applyWrite(current, update) {
84
86
  onboardingCompleted: update.onboardingCompleted ?? false,
85
87
  delegation: normalizeDelegation(update.delegation),
86
88
  pausedModels: current.pausedModels,
87
- releasedModels: current.releasedModels
89
+ releasedModels: current.releasedModels,
90
+ autoDownloadModels: current.autoDownloadModels
88
91
  };
89
92
  }
90
93
  function toggled(names, name, on) {
@@ -110,10 +113,15 @@ function toRow(config) {
110
113
  onboardingCompleted: config.onboardingCompleted,
111
114
  delegation: config.delegation,
112
115
  pausedModels: config.pausedModels,
113
- releasedModels: config.releasedModels
116
+ releasedModels: config.releasedModels,
117
+ manualModelDownloads: !config.autoDownloadModels
114
118
  };
115
119
  }
116
- export function createAppConfigApi(state) {
120
+ export async function writeAutoDownloadModels(state, enabled) {
121
+ const row = await state.updateAppConfigRow((current) => toRow({ ...toConfig(current), autoDownloadModels: enabled }));
122
+ return toConfig(row);
123
+ }
124
+ export function createAppConfigApi(state, log) {
117
125
  return {
118
126
  getConfig(_) {
119
127
  return readConfig(state);
@@ -142,6 +150,9 @@ export function createAppConfigApi(state) {
142
150
  });
143
151
  return toConfig(row);
144
152
  },
145
- configWatchTyped: watchable(() => state, () => readConfig(state), { name: 'configWatchTyped' })
153
+ setAutoDownloadModels(input) {
154
+ return writeAutoDownloadModels(state, input.enabled ?? false);
155
+ },
156
+ configWatchTyped: watchable(() => state, () => readConfig(state), { name: 'configWatchTyped', log })
146
157
  };
147
158
  }
@@ -1,4 +1,5 @@
1
- import { openUpload, UPLOAD_NAMES_NO_MESH } from './upload-frames.js';
1
+ import { CoreError } from '../errors.js';
2
+ import { openUpload } from './upload-frames.js';
2
3
  import { requireMesh } from './current-mesh.js';
3
4
  export { MAX_ATTACHMENT_BYTES } from '../core/files/attachments.js';
4
5
  export function createAttachmentsApi(pool, options = {}) {
@@ -9,7 +10,7 @@ export function createAttachmentsApi(pool, options = {}) {
9
10
  return;
10
11
  }
11
12
  if (!upload.first.meshId) {
12
- throw new Error(UPLOAD_NAMES_NO_MESH);
13
+ throw new CoreError('UPLOAD_MESH_MISSING');
13
14
  }
14
15
  const mesh = await requireMesh(pool, upload.first.meshId);
15
16
  yield* mesh.files.attachments(options).uploadAttachment(upload.rest);
@@ -0,0 +1,4 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
+ import type { ChatMoves } from '../core/chat-move.ts';
4
+ export declare function createChatMoveApi(moves: ChatMoves, log: LoggerInterface | null): Pick<CapabilityHandlers, 'moveChatToMesh' | 'chatMoveWatch'>;
@@ -0,0 +1,7 @@
1
+ import { watchable } from './watchable.js';
2
+ export function createChatMoveApi(moves, log) {
3
+ return {
4
+ moveChatToMesh: (request) => moves.move(request),
5
+ chatMoveWatch: watchable(() => moves, (request, store) => store.status(request), { name: 'chatMoveWatch', log })
6
+ };
7
+ }