@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
@@ -8,6 +8,7 @@ import { RetryBudget } from './retry-budget.js';
8
8
  import { unref } from './unref.js';
9
9
  import b4a from 'b4a';
10
10
  import { errorMessage } from './guards.js';
11
+ import { CoreError } from './errors.js';
11
12
  const WATCH_RETRY_MS = 30_000;
12
13
  const LOCAL_PROGRESS_INTERVAL_MS = 750;
13
14
  const LOCAL_PROGRESS_PERCENTAGE_STEP = 1;
@@ -33,6 +34,7 @@ export class ModelDownloadReconciler {
33
34
  _observedProgress = new Map();
34
35
  _observedSpeed = new Map();
35
36
  _requestedModels = new Set();
37
+ _heldLoads = new Set();
36
38
  _releasing = new Set();
37
39
  _targetTotals = new Map();
38
40
  _config = null;
@@ -42,7 +44,6 @@ export class ModelDownloadReconciler {
42
44
  _musicChoice = undefined;
43
45
  _preemptLlm = null;
44
46
  _pausedLocalLlm = null;
45
- _profile = null;
46
47
  _capability = null;
47
48
  _handled = new Set();
48
49
  _demands = new Map();
@@ -128,6 +129,17 @@ export class ModelDownloadReconciler {
128
129
  this._runModels = next;
129
130
  this._kick();
130
131
  }
132
+ observeHeldLoad(model) {
133
+ if (this._closed)
134
+ return;
135
+ this._heldLoads.add(model);
136
+ this._kick();
137
+ }
138
+ observeDroppedHeldLoad(model) {
139
+ if (this._closed || !this._heldLoads.delete(model))
140
+ return;
141
+ this._kick();
142
+ }
131
143
  observeImageProgress(observation) {
132
144
  if (this._closed)
133
145
  return;
@@ -170,7 +182,7 @@ export class ModelDownloadReconciler {
170
182
  this._pendingCompletions.delete(name);
171
183
  this._completedTransfers.add(name);
172
184
  }
173
- async waitUntilCached(model, signal) {
185
+ async waitUntilCached(model, signal, { onHold, onProgress, onStall } = {}) {
174
186
  if (this._closed ||
175
187
  !this._harness.list ||
176
188
  !this._harness.download ||
@@ -195,7 +207,15 @@ export class ModelDownloadReconciler {
195
207
  this._removeDemandWaiter(model, waiter);
196
208
  resolve();
197
209
  };
198
- const waiter = { signal, abort, reject, resolve };
210
+ const waiter = {
211
+ signal,
212
+ abort,
213
+ reject,
214
+ resolve,
215
+ onHold: onHold ?? null,
216
+ onProgress: onProgress ?? null,
217
+ onStall: onStall ?? null
218
+ };
199
219
  const demand = this._demands.get(model) ?? {
200
220
  addon,
201
221
  failures: 0,
@@ -209,7 +229,7 @@ export class ModelDownloadReconciler {
209
229
  }
210
230
  async retry(name) {
211
231
  if (this._closed)
212
- throw new Error('model download reconciler is closed');
232
+ throw new CoreError('MODEL_DOWNLOAD_CLOSED');
213
233
  this._requestedModels.add(name);
214
234
  this._attemptGenerations.set(name, this._attemptGeneration(name) + 1);
215
235
  const demand = this._demands.get(name);
@@ -225,7 +245,7 @@ export class ModelDownloadReconciler {
225
245
  }
226
246
  async release(name, removeFiles) {
227
247
  if (this._closed)
228
- throw new Error('model download reconciler is closed');
248
+ throw new CoreError('MODEL_DOWNLOAD_CLOSED');
229
249
  this._releasing.add(name);
230
250
  this._requestedModels.delete(name);
231
251
  this._handled.delete(name);
@@ -339,18 +359,25 @@ export class ModelDownloadReconciler {
339
359
  if (!meshId) {
340
360
  return;
341
361
  }
362
+ let active = null;
342
363
  const run = async () => {
343
364
  const stream = this._engine.agentsWatch({ meshId });
344
- this._agentsStream = stream[Symbol.asyncIterator]();
365
+ const iterator = stream[Symbol.asyncIterator]();
366
+ active = iterator;
367
+ this._agentsStream = iterator;
345
368
  while (true) {
346
- const { done } = await this._agentsStream.next();
347
- if (done || this._closed) {
369
+ const { done } = await iterator.next();
370
+ if (done || this._closed || this._agentsStream !== iterator) {
348
371
  return;
349
372
  }
350
373
  this._kick();
351
374
  }
352
375
  };
353
- run().catch((err) => this._restartWatch('agents', err, () => this._watchAgents()));
376
+ run().catch((err) => {
377
+ if (active && this._agentsStream !== active)
378
+ return;
379
+ this._restartWatch('agents', err, () => this._watchAgents());
380
+ });
354
381
  }
355
382
  _restartWatch(name, err, restart) {
356
383
  if (this._closed)
@@ -410,7 +437,7 @@ export class ModelDownloadReconciler {
410
437
  if (this._closed || this._paused) {
411
438
  return;
412
439
  }
413
- const downloadable = new Map(targets.filter((t) => !t.paused).map((t) => [t.name, t]));
440
+ const downloadable = new Map(targets.filter((t) => !t.paused && !t.held).map((t) => [t.name, t]));
414
441
  if (this._active && !downloadable.has(this._active.model)) {
415
442
  const stillWanted = targets.some((t) => t.name === this._active?.model);
416
443
  await this._stopActive(!stillWanted);
@@ -427,6 +454,7 @@ export class ModelDownloadReconciler {
427
454
  }
428
455
  const next = this._active ? null : preferred;
429
456
  await this._writeWaiting(targets, next?.name, now);
457
+ this._announceHolds(targets);
430
458
  if (next && !this._closed && !this._paused) {
431
459
  this._begin(next);
432
460
  }
@@ -435,6 +463,10 @@ export class ModelDownloadReconciler {
435
463
  for (const target of targets) {
436
464
  if (target.paused) {
437
465
  await this._status.write(target.name, 'paused', { bytesPerSecond: 0 });
466
+ this._announceStall(target.name);
467
+ }
468
+ else if (target.held) {
469
+ await this._status.write(target.name, 'held', { total: target.total, bytesPerSecond: 0 });
438
470
  }
439
471
  else if (this._waiting(target.name, nextName, now)) {
440
472
  await this._status.write(target.name, 'queued', {
@@ -444,6 +476,29 @@ export class ModelDownloadReconciler {
444
476
  }
445
477
  }
446
478
  }
479
+ _announceHolds(targets) {
480
+ for (const target of targets) {
481
+ if (!target.held)
482
+ continue;
483
+ for (const waiter of this._demands.get(target.name)?.waiters ?? []) {
484
+ waiter.onHold?.();
485
+ }
486
+ }
487
+ }
488
+ _announceProgress(model, percentage) {
489
+ for (const waiter of this._demands.get(model)?.waiters ?? []) {
490
+ waiter.onProgress?.(percentage);
491
+ }
492
+ }
493
+ _announceStall(model) {
494
+ for (const waiter of this._demands.get(model)?.waiters ?? []) {
495
+ waiter.onStall?.();
496
+ }
497
+ }
498
+ async _writeFailure(model, error) {
499
+ await this._status.write(model, 'error', { error, bytesPerSecond: 0 });
500
+ this._announceStall(model);
501
+ }
447
502
  async _flushObservedProgress() {
448
503
  for (const [model, progress] of this._observedProgress) {
449
504
  await this._transfer(model);
@@ -479,6 +534,7 @@ export class ModelDownloadReconciler {
479
534
  total,
480
535
  bytesPerSecond: speed.sample({ downloaded, total, aggregate: true }, progress.at, model)
481
536
  });
537
+ this._announceProgress(model, progress.percentage);
482
538
  }
483
539
  }
484
540
  _shouldPreempt(preferred, preemptLlm) {
@@ -518,7 +574,11 @@ export class ModelDownloadReconciler {
518
574
  }
519
575
  }
520
576
  async _desired() {
577
+ if (this._config === null) {
578
+ return [];
579
+ }
521
580
  if (this._demands.size === 0 &&
581
+ this._heldLoads.size === 0 &&
522
582
  this._handled.size === 0 &&
523
583
  !this._config?.onboardingCompleted) {
524
584
  await this._status.clearUnwanted(new Set());
@@ -565,6 +625,16 @@ export class ModelDownloadReconciler {
565
625
  }
566
626
  wanted.set(name, { name, addon, paused: paused.has(name) });
567
627
  }
628
+ for (const name of this._heldLoads) {
629
+ if (this._config?.autoDownloadModels !== false || availability.cached.has(name)) {
630
+ this._heldLoads.delete(name);
631
+ continue;
632
+ }
633
+ const addon = availability.addons.get(name);
634
+ if (!wanted.has(name) && addon !== undefined) {
635
+ wanted.set(name, { name, addon, paused: paused.has(name) });
636
+ }
637
+ }
568
638
  const wantedNames = new Set(wanted.keys());
569
639
  for (const name of this._attemptGenerations.keys()) {
570
640
  if (!wantedNames.has(name)) {
@@ -583,6 +653,7 @@ export class ModelDownloadReconciler {
583
653
  }
584
654
  pending.push({
585
655
  ...model,
656
+ held: this._heldBack(model.name),
586
657
  total: availability.totals.get(model.name) ?? 0
587
658
  });
588
659
  }
@@ -599,6 +670,9 @@ export class ModelDownloadReconciler {
599
670
  }
600
671
  return pending;
601
672
  }
673
+ _heldBack(name) {
674
+ return this._config?.autoDownloadModels === false && !this._requestedModels.has(name);
675
+ }
602
676
  async _reclaimCached(cached) {
603
677
  for (const name of this._config?.releasedModels ?? []) {
604
678
  if (!cached.has(name) || this._releasing.has(name))
@@ -619,18 +693,7 @@ export class ModelDownloadReconciler {
619
693
  return { cached, totals, addons };
620
694
  }
621
695
  async _deviceProfile() {
622
- if (this._profile)
623
- return this._profile;
624
- const meshId = this._meshId();
625
- if (!meshId) {
626
- return this._profile ?? 'mid';
627
- }
628
- const { devices } = await this._engine.listDevices({ meshId }).catch(() => ({ devices: [] }));
629
- const self = (devices ?? []).find((device) => b4a.equals(device.id, this._deviceId));
630
- if (self) {
631
- this._profile = self.capabilityProfile;
632
- }
633
- return this._profile ?? 'mid';
696
+ return (await this._hostCapability())?.capabilityProfile ?? 'low';
634
697
  }
635
698
  async _hostCapability() {
636
699
  if (this._capability)
@@ -787,6 +850,7 @@ export class ModelDownloadReconciler {
787
850
  }
788
851
  const bytes = transfer ?? progressBytes(event);
789
852
  const percentage = transfer?.percentage ?? 0;
853
+ this._announceProgress(model, percentage);
790
854
  if (shouldFlush(localFlush, { at, percentage })) {
791
855
  const written = await this._status.write(model, 'downloading', {
792
856
  percentage,
@@ -818,6 +882,7 @@ export class ModelDownloadReconciler {
818
882
  })) {
819
883
  localFlush = { at: initialAt, percentage: initialPercentage };
820
884
  }
885
+ this._announceProgress(model, initialPercentage);
821
886
  if (!this._harness.download) {
822
887
  throw new Error('the harness cannot download models');
823
888
  }
@@ -846,18 +911,12 @@ export class ModelDownloadReconciler {
846
911
  else if (event.type === 'error' && current()) {
847
912
  retry = true;
848
913
  failureMessage = typeof event.message === 'string' ? event.message : 'download failed';
849
- await this._status.write(model, 'error', {
850
- error: failureMessage,
851
- bytesPerSecond: 0
852
- });
914
+ await this._writeFailure(model, failureMessage);
853
915
  }
854
916
  else if (event.type === 'aborted' && current() && !controller.signal.aborted) {
855
917
  retry = true;
856
918
  failureMessage = 'download interrupted';
857
- await this._status.write(model, 'error', {
858
- error: failureMessage,
859
- bytesPerSecond: 0
860
- });
919
+ await this._writeFailure(model, failureMessage);
861
920
  }
862
921
  }
863
922
  if (current() && !controller.signal.aborted && !completed && !retry) {
@@ -868,10 +927,7 @@ export class ModelDownloadReconciler {
868
927
  if (!this._closed && current()) {
869
928
  retry = true;
870
929
  failureMessage = errorMessage(err);
871
- await this._status.write(model, 'error', {
872
- error: failureMessage,
873
- bytesPerSecond: 0
874
- });
930
+ await this._writeFailure(model, failureMessage);
875
931
  }
876
932
  }
877
933
  finally {
@@ -1,10 +1,8 @@
1
1
  import type { Harness } from './assistant.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
2
3
  import type { openLocalStore } from './core/local/index.ts';
3
4
  type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
4
- interface Logger {
5
- warn(...args: unknown[]): void;
6
- }
7
5
  export type ModelIdleTarget = Pick<Harness, 'setModelIdleTimeout'>;
8
6
  export type ModelIdleSource = Pick<LocalStore, 'get' | 'watch' | 'unwatch'>;
9
- export declare function startModelIdlePusher(harness: ModelIdleTarget, state: ModelIdleSource, logger?: Logger | null): () => Promise<void>;
7
+ export declare function startModelIdlePusher(harness: ModelIdleTarget, state: ModelIdleSource, logger?: LoggerInterface | null): () => Promise<void>;
10
8
  export {};
@@ -0,0 +1,27 @@
1
+ import type { Harness } from './assistant.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
+ import type { openLocalStore } from './core/local/index.ts';
4
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
5
+ export type ModelMemoryTarget = Pick<Harness, 'setModelMemoryCap' | 'capability' | 'memoryUsage'>;
6
+ export type ModelMemorySource = Pick<LocalStore, 'get' | 'watch' | 'unwatch'>;
7
+ export interface ModelMemorySummary {
8
+ readonly usableBytes: number;
9
+ readonly capPercent: number;
10
+ readonly capBytes: number;
11
+ }
12
+ export interface ModelMemoryUse extends ModelMemorySummary {
13
+ readonly usedBytes: number;
14
+ readonly overCap: boolean;
15
+ }
16
+ export interface ModelMemoryCap {
17
+ summary(): Promise<ModelMemoryUse | null>;
18
+ stop(): Promise<void>;
19
+ }
20
+ export interface ModelMemoryCapOptions {
21
+ logger?: LoggerInterface | null;
22
+ onPushed?: () => void;
23
+ }
24
+ export declare function startModelMemoryCap(harness: ModelMemoryTarget, state: ModelMemorySource, { logger, onPushed }?: ModelMemoryCapOptions): ModelMemoryCap;
25
+ export declare function withUsage(cap: ModelMemorySummary, usedBytes: number): ModelMemoryUse;
26
+ export declare function memoryCapPercent(value: unknown): number;
27
+ export {};
@@ -0,0 +1,69 @@
1
+ import ScopeLock from 'scope-lock';
2
+ import { MODEL_MEMORY_CAP_DEFAULT, MODEL_MEMORY_CAP_KEY, MODEL_MEMORY_CAP_MAX, MODEL_MEMORY_CAP_MIN } from './constants.js';
3
+ import { errorMessage } from './guards.js';
4
+ export function startModelMemoryCap(harness, state, { logger, onPushed } = {}) {
5
+ const lock = new ScopeLock({ debounce: true });
6
+ let disposed = false;
7
+ let pushed = null;
8
+ let usableBytes = null;
9
+ const push = async () => {
10
+ const percent = memoryCapPercent(await state.get(MODEL_MEMORY_CAP_KEY));
11
+ if (disposed || percent === pushed || !harness.setModelMemoryCap) {
12
+ return;
13
+ }
14
+ await harness.setModelMemoryCap(percent === MODEL_MEMORY_CAP_MIN ? 0 : percent);
15
+ usableBytes ??= (await harness.capability?.())?.memoryBudget?.availableBytes ?? null;
16
+ pushed = percent;
17
+ onPushed?.();
18
+ };
19
+ const schedule = async () => {
20
+ if (disposed || !(await lock.lock()))
21
+ return;
22
+ try {
23
+ await push();
24
+ }
25
+ catch (err) {
26
+ logger?.warn('model-memory-cap', 'push failed', errorMessage(err));
27
+ }
28
+ finally {
29
+ lock.unlock();
30
+ }
31
+ };
32
+ const listener = () => void schedule();
33
+ state.watch(listener);
34
+ void schedule();
35
+ return {
36
+ summary: async () => {
37
+ const capPercent = pushed;
38
+ const usable = usableBytes;
39
+ if (capPercent === null || usable === null || !harness.memoryUsage) {
40
+ return null;
41
+ }
42
+ const usage = await harness.memoryUsage().catch((err) => {
43
+ logger?.warn('model-memory-cap', 'usage read failed', errorMessage(err));
44
+ return null;
45
+ });
46
+ const capBytes = Math.round((capPercent / 100) * usable);
47
+ return usage && withUsage({ usableBytes: usable, capPercent, capBytes }, usage.usedBytes);
48
+ },
49
+ stop: async () => {
50
+ disposed = true;
51
+ state.unwatch(listener);
52
+ lock.destroy();
53
+ await lock.flush();
54
+ }
55
+ };
56
+ }
57
+ export function withUsage(cap, usedBytes) {
58
+ return {
59
+ ...cap,
60
+ usedBytes,
61
+ overCap: cap.capPercent > MODEL_MEMORY_CAP_MIN && usedBytes > cap.capBytes
62
+ };
63
+ }
64
+ export function memoryCapPercent(value) {
65
+ if (typeof value !== 'number' || !Number.isFinite(value)) {
66
+ return MODEL_MEMORY_CAP_DEFAULT;
67
+ }
68
+ return Math.min(MODEL_MEMORY_CAP_MAX, Math.max(MODEL_MEMORY_CAP_MIN, Math.round(value)));
69
+ }
@@ -1,6 +1,6 @@
1
1
  import type { AssistantModelCatalogRevision, AssistantModelInfo, AssistantModelInfoList } from '../spec/hyperschema/types.d.ts';
2
2
  type Catalog = () => Promise<AsyncIterable<AssistantModelCatalogRevision> | null>;
3
- type Read = () => Promise<AssistantModelInfo[] | null>;
3
+ type Read = () => Promise<AssistantModelInfoList | null>;
4
4
  export declare function watchModels(catalog: Catalog, read: Read): AsyncIterable<AssistantModelInfoList>;
5
5
  export declare function asEncoded(models: AssistantModelInfo[]): AssistantModelInfo[];
6
6
  export {};
@@ -15,12 +15,12 @@ class ModelsWatch {
15
15
  this._opening ??= this._open();
16
16
  const revisions = await this._opening;
17
17
  while (revisions && !this._closed && !(await revisions.next()).done) {
18
- const models = this._closed ? null : await this._read();
19
- if (models === null || this._closed || snapshotEquals(models, this._last)) {
18
+ const list = this._closed ? null : await this._read();
19
+ if (list === null || this._closed || snapshotEquals(list, this._last)) {
20
20
  continue;
21
21
  }
22
- this._last = models;
23
- return { value: { models }, done: false };
22
+ this._last = list;
23
+ return { value: list, done: false };
24
24
  }
25
25
  return { value: undefined, done: true };
26
26
  }
@@ -1,6 +1,7 @@
1
1
  import { createServer } from 'http';
2
2
  import { URL } from 'url';
3
3
  import { OAUTH_CALLBACK_PATH, OAUTH_WAIT_FOR_CODE_TIMEOUT_MS } from './keys.js';
4
+ import { CoreError } from '../errors.js';
4
5
  export function waitForOAuthCallback(opts) {
5
6
  const { port, state, timeoutMs = OAUTH_WAIT_FOR_CODE_TIMEOUT_MS, onListening } = opts;
6
7
  return new Promise((resolve, reject) => {
@@ -51,7 +52,7 @@ export function waitForOAuthCallback(opts) {
51
52
  body: '<html><body><p>Authorization failed. You can close this tab.</p></body></html>',
52
53
  close: true
53
54
  });
54
- settle({ error: new Error(`OAuth error: ${error}`) }, res);
55
+ settle({ error: new CoreError('OAUTH_PROVIDER_ERROR', [error]) }, res);
55
56
  }
56
57
  else if (code) {
57
58
  respond(res, 200, {
@@ -64,7 +65,7 @@ export function waitForOAuthCallback(opts) {
64
65
  respond(res, 204);
65
66
  }
66
67
  });
67
- const timer = setTimeout(() => settle({ error: new Error('OAuth callback timed out') }), timeoutMs);
68
+ const timer = setTimeout(() => settle({ error: new CoreError('OAUTH_CALLBACK_TIMEOUT') }), timeoutMs);
68
69
  server.once('error', (err) => settle({ error: err }));
69
70
  server.listen(port, '127.0.0.1', () => onListening?.());
70
71
  });
@@ -1,3 +1,4 @@
1
+ import { CoreError } from '../errors.js';
1
2
  import { generateRuntimePkceChallenge } from './pkce-runtime.js';
2
3
  import { resolveDynamicClientId } from './register.js';
3
4
  import { exchangeCodeWithFetch } from './token-exchange-core.js';
@@ -17,8 +18,7 @@ function buildAuthParams(config, { clientId, redirectUri, state, pkce }) {
17
18
  return params;
18
19
  }
19
20
  export async function runOAuthFlowWithRuntime(config, deps, runtime) {
20
- const openUrl = deps.openUrl ??
21
- (() => Promise.reject(new Error('OAuth browser launcher is unavailable; inject openUrl or createRedirect')));
21
+ const openUrl = deps.openUrl ?? (() => Promise.reject(new CoreError('OAUTH_LAUNCHER_UNAVAILABLE')));
22
22
  const pkce = await generateRuntimePkceChallenge(runtime);
23
23
  const state = runtime.randomBase64Url(16);
24
24
  const redirect = await deps.createRedirect({ port: config.port, credentialKey: config.credentialKey, state }, { openUrl });
@@ -32,10 +32,12 @@ export async function runOAuthFlowWithRuntime(config, deps, runtime) {
32
32
  state,
33
33
  pkce
34
34
  });
35
+ deps.onStage?.('awaiting-callback');
35
36
  const callback = await redirect.authorize(`${config.authUrl}?${authParams.toString()}`, deps.timeoutMs, state);
36
37
  if (callback.state !== state) {
37
- throw new Error('OAuth state mismatch (possible CSRF)');
38
+ throw new CoreError('OAUTH_STATE_MISMATCH');
38
39
  }
40
+ deps.onStage?.('exchanging-code');
39
41
  return exchangeCodeWithFetch(config, {
40
42
  clientId,
41
43
  redirectUri: redirect.redirectUri,
@@ -1,4 +1,4 @@
1
- import { abortOAuthLoopback, openOAuthLoopback } from '#oauth-loopback';
1
+ import { abortOAuthLoopback, openOAuthLoopback } from './loopback.js';
2
2
  import { randomBase64Url, sha256Base64Url } from '@qvac/core/oauth/runtime/crypto';
3
3
  import defaultFetch from '@qvac/core/oauth/runtime/fetch';
4
4
  import { runOAuthFlowWithRuntime } from './flow-core.js';
@@ -1,3 +1,4 @@
1
1
  import type { OAuthLoopbackServer, OAuthLoopbackTarget } from './redirect-types.ts';
2
2
  export declare function abortOAuthLoopback(credentialKey: string): Promise<boolean>;
3
+ export declare function deliverOAuthCallback(address: string): boolean;
3
4
  export declare function openOAuthLoopback(port: number, target: OAuthLoopbackTarget): Promise<OAuthLoopbackServer>;
@@ -1,12 +1,13 @@
1
1
  import { createServer } from 'http';
2
2
  import { OAUTH_CALLBACK_PATH, OAUTH_WAIT_FOR_CODE_TIMEOUT_MS, oauthRedirectUri } from './keys.js';
3
- const DONE_PAGE = '<html><body><p>Authorization complete. You may close this tab.</p>' +
3
+ import { CoreError } from '../errors.js';
4
+ const DONE_PAGE = '<html><body><p>Authorization complete. Return to QV.AC to finish connecting. You may close this tab.</p>' +
4
5
  '<script>window.close();</script></body></html>';
5
6
  const STALE_PAGE = '<html><body><p>This sign-in link is from an earlier attempt. ' +
6
7
  'You can close this tab.</p></body></html>';
7
8
  const loopbacks = new Set();
8
9
  export async function abortOAuthLoopback(credentialKey) {
9
- return abortFor(credentialKey, new Error('OAuth flow cancelled'));
10
+ return abortFor(credentialKey, new CoreError('OAUTH_CANCELLED'));
10
11
  }
11
12
  function abortFor(credentialKey, reason) {
12
13
  const pending = [...loopbacks]
@@ -17,16 +18,51 @@ function abortFor(credentialKey, reason) {
17
18
  }
18
19
  return pending.length > 0;
19
20
  }
21
+ export function deliverOAuthCallback(address) {
22
+ const params = callbackParams(address);
23
+ const state = params?.get('state');
24
+ const waiter = state ? pendingWaiter(state) : undefined;
25
+ if (!params || !state || !waiter) {
26
+ return false;
27
+ }
28
+ settle(waiter, callbackSettlement(params, state));
29
+ return true;
30
+ }
31
+ function callbackParams(address) {
32
+ let url;
33
+ try {
34
+ url = new URL(address.trim());
35
+ }
36
+ catch {
37
+ return null;
38
+ }
39
+ const finished = url.searchParams.has('code') || url.searchParams.has('error');
40
+ return url.pathname === OAUTH_CALLBACK_PATH && finished ? url.searchParams : null;
41
+ }
42
+ function pendingWaiter(state) {
43
+ for (const loopback of loopbacks) {
44
+ const waiter = loopback.waiters.get(state);
45
+ if (waiter && waiter.settled === null) {
46
+ return waiter;
47
+ }
48
+ }
49
+ return undefined;
50
+ }
20
51
  export async function openOAuthLoopback(port, target) {
21
52
  if (!Number.isInteger(port) || port < 0 || port > 65535) {
22
- throw new Error(`OAuth loopback port must be an integer in [0, 65535], got ${port}`);
53
+ throw new CoreError('OAUTH_LOOPBACK_PORT_INVALID', [port]);
23
54
  }
24
- abortFor(target.credentialKey, new Error('OAuth loopback superseded by a new connect attempt'));
55
+ abortFor(target.credentialKey, new CoreError('OAUTH_SUPERSEDED'));
25
56
  const loopback = acquire(port);
26
57
  if (loopback.waiters.has(target.state)) {
27
- throw new Error(`OAuth loopback on port ${port} already has a flow on state ${target.state}`);
58
+ throw new CoreError('OAUTH_LOOPBACK_BUSY', [port, target.state]);
28
59
  }
29
- const waiter = { credentialKey: target.credentialKey, deliver: null, settled: null };
60
+ const waiter = {
61
+ credentialKey: target.credentialKey,
62
+ returnTo: target.returnTo,
63
+ deliver: null,
64
+ settled: null
65
+ };
30
66
  loopback.waiters.set(target.state, waiter);
31
67
  let bound;
32
68
  try {
@@ -47,7 +83,7 @@ export async function openOAuthLoopback(port, target) {
47
83
  throw new Error('OAuth loopback is already waiting for this code');
48
84
  }
49
85
  return new Promise((resolve, reject) => {
50
- const timer = globalThis.setTimeout(() => settle(waiter, { ok: false, error: new Error('OAuth callback timed out') }), timeoutMs);
86
+ const timer = globalThis.setTimeout(() => settle(waiter, { ok: false, error: new CoreError('OAUTH_CALLBACK_TIMEOUT') }), timeoutMs);
51
87
  waiter.deliver = (settlement) => {
52
88
  globalThis.clearTimeout(timer);
53
89
  if (settlement.ok) {
@@ -63,7 +99,7 @@ export async function openOAuthLoopback(port, target) {
63
99
  if (released)
64
100
  return;
65
101
  released = true;
66
- settle(waiter, { ok: false, error: new Error('OAuth loopback closed') });
102
+ settle(waiter, { ok: false, error: new CoreError('OAUTH_LOOPBACK_CLOSED') });
67
103
  release(loopback, target.state);
68
104
  }
69
105
  };
@@ -120,7 +156,12 @@ function listen(port, waiters) {
120
156
  respond(response, 200, { contentType: 'text/html; charset=utf-8', body: STALE_PAGE });
121
157
  return;
122
158
  }
123
- respond(response, 200, { contentType: 'text/html; charset=utf-8', body: DONE_PAGE });
159
+ if (waiter.returnTo) {
160
+ redirect(response, waiter.returnTo);
161
+ }
162
+ else {
163
+ respond(response, 200, { contentType: 'text/html; charset=utf-8', body: DONE_PAGE });
164
+ }
124
165
  settle(waiter, callbackSettlement(url.searchParams, state));
125
166
  });
126
167
  let listening = false;
@@ -128,7 +169,7 @@ function listen(port, waiters) {
128
169
  if (listening)
129
170
  return;
130
171
  reject('code' in error && error.code === 'EADDRINUSE'
131
- ? new Error(`OAuth loopback port ${port} is already in use by another process`)
172
+ ? new CoreError('OAUTH_LOOPBACK_PORT_IN_USE', [port])
132
173
  : error);
133
174
  });
134
175
  server.once('listening', () => {
@@ -147,11 +188,11 @@ function listen(port, waiters) {
147
188
  function callbackSettlement(params, state) {
148
189
  const error = params.get('error');
149
190
  if (error) {
150
- return { ok: false, error: new Error(`OAuth error: ${error}`) };
191
+ return { ok: false, error: new CoreError('OAUTH_PROVIDER_ERROR', [error]) };
151
192
  }
152
193
  const code = params.get('code');
153
194
  if (!code) {
154
- return { ok: false, error: new Error('OAuth callback missing code') };
195
+ return { ok: false, error: new CoreError('OAUTH_CALLBACK_INVALID') };
155
196
  }
156
197
  return { ok: true, result: { code, state } };
157
198
  }
@@ -170,3 +211,7 @@ function respond(response, status, { contentType, body }) {
170
211
  response.writeHead(status, { 'Content-Type': contentType, Connection: 'close' });
171
212
  response.end(body);
172
213
  }
214
+ function redirect(response, location) {
215
+ response.writeHead(302, { Location: location, Connection: 'close' });
216
+ response.end();
217
+ }
@@ -1,3 +1,4 @@
1
+ import { CoreError } from '../errors.js';
1
2
  export function buildProviderConfig(spec, credentials) {
2
3
  const base = {
3
4
  clientId: credentials.clientId,
@@ -20,7 +21,8 @@ export function buildProviderConfig(spec, credentials) {
20
21
  };
21
22
  }
22
23
  function requireSecret(secret, provider) {
23
- if (!secret)
24
- throw new Error(`Client secret is required for ${provider}.`);
24
+ if (!secret) {
25
+ throw new CoreError('OAUTH_CLIENT_SECRET_MISSING', [provider]);
26
+ }
25
27
  return secret;
26
28
  }
@@ -5,6 +5,7 @@ export interface OAuthCallbackResult {
5
5
  export interface OAuthLoopbackTarget {
6
6
  readonly credentialKey: string;
7
7
  readonly state: string;
8
+ readonly returnTo?: string;
8
9
  }
9
10
  export interface OAuthLoopbackServer {
10
11
  readonly redirectUri: string;