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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (509) hide show
  1. package/CHANGELOG.md +852 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +0 -1
  4. package/dist-lib/index.js +0 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +7 -0
  17. package/dist-lib/lib/api/chunk-delta.js +33 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +64 -13
  20. package/dist-lib/lib/api/config.d.ts +2 -1
  21. package/dist-lib/lib/api/config.js +3 -2
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +10 -8
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +20 -10
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  35. package/dist-lib/lib/api/host-run-log.js +35 -83
  36. package/dist-lib/lib/api/index.d.ts +28 -6
  37. package/dist-lib/lib/api/index.js +101 -33
  38. package/dist-lib/lib/api/instrument.d.ts +2 -2
  39. package/dist-lib/lib/api/instrument.js +12 -44
  40. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  41. package/dist-lib/lib/api/knowledge.js +25 -7
  42. package/dist-lib/lib/api/local-files.d.ts +5 -1
  43. package/dist-lib/lib/api/local-files.js +9 -5
  44. package/dist-lib/lib/api/logs.js +3 -3
  45. package/dist-lib/lib/api/members.d.ts +10 -1
  46. package/dist-lib/lib/api/members.js +64 -17
  47. package/dist-lib/lib/api/mesh.d.ts +12 -2
  48. package/dist-lib/lib/api/mesh.js +10 -6
  49. package/dist-lib/lib/api/model-download.d.ts +2 -1
  50. package/dist-lib/lib/api/model-download.js +2 -2
  51. package/dist-lib/lib/api/network.d.ts +10 -2
  52. package/dist-lib/lib/api/network.js +8 -2
  53. package/dist-lib/lib/api/notifications.d.ts +3 -1
  54. package/dist-lib/lib/api/notifications.js +6 -5
  55. package/dist-lib/lib/api/projects.d.ts +20 -0
  56. package/dist-lib/lib/api/projects.js +165 -0
  57. package/dist-lib/lib/api/rag.d.ts +0 -1
  58. package/dist-lib/lib/api/rag.js +47 -23
  59. package/dist-lib/lib/api/served.d.ts +17 -0
  60. package/dist-lib/lib/api/served.js +47 -0
  61. package/dist-lib/lib/api/sync.d.ts +2 -1
  62. package/dist-lib/lib/api/sync.js +2 -2
  63. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  64. package/dist-lib/lib/api/tool-activity.js +4 -3
  65. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-configs.js +6 -9
  67. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  68. package/dist-lib/lib/api/upload-frames.js +0 -1
  69. package/dist-lib/lib/api/watchable.d.ts +3 -2
  70. package/dist-lib/lib/api/watchable.js +2 -3
  71. package/dist-lib/lib/api/workspace.d.ts +5 -0
  72. package/dist-lib/lib/api/workspace.js +48 -0
  73. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  74. package/dist-lib/lib/assistant/fake-models.js +112 -0
  75. package/dist-lib/lib/assistant/harness.d.ts +29 -29
  76. package/dist-lib/lib/assistant/harness.js +34 -6
  77. package/dist-lib/lib/assistant/history.d.ts +30 -17
  78. package/dist-lib/lib/assistant/history.js +168 -82
  79. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  80. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  81. package/dist-lib/lib/assistant/message.d.ts +21 -0
  82. package/dist-lib/lib/assistant/message.js +43 -0
  83. package/dist-lib/lib/assistant/model-round.d.ts +95 -0
  84. package/dist-lib/lib/assistant/model-round.js +591 -0
  85. package/dist-lib/lib/assistant/pdf-budget.d.ts +3 -0
  86. package/dist-lib/lib/assistant/pdf-budget.js +13 -0
  87. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  88. package/dist-lib/lib/assistant/round-host.js +239 -0
  89. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  90. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  91. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  92. package/dist-lib/lib/assistant/video-budget.js +29 -0
  93. package/dist-lib/lib/assistant-client.d.ts +2 -0
  94. package/dist-lib/lib/assistant-client.js +4 -3
  95. package/dist-lib/lib/assistant-tree.d.ts +8 -3
  96. package/dist-lib/lib/assistant-tree.js +58 -18
  97. package/dist-lib/lib/assistant.d.ts +76 -20
  98. package/dist-lib/lib/assistant.js +1659 -1070
  99. package/dist-lib/lib/audio-format.js +1 -1
  100. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  101. package/dist-lib/lib/chat-suggestion.js +47 -0
  102. package/dist-lib/lib/client.d.ts +2 -2
  103. package/dist-lib/lib/constants.d.ts +7 -0
  104. package/dist-lib/lib/constants.js +7 -0
  105. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  106. package/dist-lib/lib/core/agent-copies.js +40 -0
  107. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  108. package/dist-lib/lib/core/agent-hosting.js +71 -0
  109. package/dist-lib/lib/core/agent.d.ts +9 -1
  110. package/dist-lib/lib/core/agent.js +45 -19
  111. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  112. package/dist-lib/lib/core/archived-mesh.js +77 -58
  113. package/dist-lib/lib/core/async-iterable.js +1 -1
  114. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  115. package/dist-lib/lib/core/blind-peers.js +1 -0
  116. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  117. package/dist-lib/lib/core/chat-activity.js +36 -22
  118. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  119. package/dist-lib/lib/core/chat-copy.js +395 -0
  120. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  121. package/dist-lib/lib/core/chat-fork.js +245 -0
  122. package/dist-lib/lib/core/chat-group.js +8 -7
  123. package/dist-lib/lib/core/chat-move.d.ts +71 -0
  124. package/dist-lib/lib/core/chat-move.js +567 -0
  125. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  126. package/dist-lib/lib/core/chat-order.js +19 -4
  127. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  128. package/dist-lib/lib/core/chat-project.js +15 -0
  129. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  130. package/dist-lib/lib/core/chat-read.js +49 -0
  131. package/dist-lib/lib/core/chat-search.js +14 -12
  132. package/dist-lib/lib/core/chat.d.ts +34 -4
  133. package/dist-lib/lib/core/chat.js +122 -39
  134. package/dist-lib/lib/core/chunk.d.ts +21 -4
  135. package/dist-lib/lib/core/chunk.js +138 -23
  136. package/dist-lib/lib/core/collections.d.ts +28 -0
  137. package/dist-lib/lib/core/collections.js +28 -0
  138. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  139. package/dist-lib/lib/core/contract/agent-join.js +108 -0
  140. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  141. package/dist-lib/lib/core/contract/agents.js +141 -3
  142. package/dist-lib/lib/core/contract/chat.d.ts +1 -0
  143. package/dist-lib/lib/core/contract/chat.js +42 -3
  144. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  145. package/dist-lib/lib/core/contract/chunks.js +112 -35
  146. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  147. package/dist-lib/lib/core/contract/index.js +35 -11
  148. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  149. package/dist-lib/lib/core/contract/indexing.js +51 -7
  150. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  151. package/dist-lib/lib/core/contract/invites.js +18 -9
  152. package/dist-lib/lib/core/contract/joined-meshes.js +2 -1
  153. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  154. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  155. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  156. package/dist-lib/lib/core/contract/members.js +34 -4
  157. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  158. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  159. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  160. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  161. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  162. package/dist-lib/lib/core/contract/mesh-rules.js +31 -0
  163. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  164. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  165. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  166. package/dist-lib/lib/core/contract/model-requests.js +279 -0
  167. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  168. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  169. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  170. package/dist-lib/lib/core/contract/open-join.js +77 -0
  171. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  172. package/dist-lib/lib/core/contract/project-device-keys.js +29 -0
  173. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  174. package/dist-lib/lib/core/contract/project-host-keys.js +40 -0
  175. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/project-order.js +25 -0
  177. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  178. package/dist-lib/lib/core/contract/projects.js +328 -0
  179. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  180. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  181. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  182. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  183. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  184. package/dist-lib/lib/core/contract/roles.js +120 -0
  185. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  186. package/dist-lib/lib/core/contract/run-requests.js +75 -0
  187. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  188. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  189. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  190. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  191. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  192. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  193. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  194. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  195. package/dist-lib/lib/core/contract/workspace.js +317 -0
  196. package/dist-lib/lib/core/contract/writers.js +82 -12
  197. package/dist-lib/lib/core/departures.d.ts +16 -5
  198. package/dist-lib/lib/core/departures.js +79 -6
  199. package/dist-lib/lib/core/device-control.d.ts +21 -0
  200. package/dist-lib/lib/core/device-control.js +91 -0
  201. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  202. package/dist-lib/lib/core/device-seal.js +22 -0
  203. package/dist-lib/lib/core/devices.js +1 -1
  204. package/dist-lib/lib/core/document-attachment.d.ts +7 -0
  205. package/dist-lib/lib/core/document-attachment.js +9 -0
  206. package/dist-lib/lib/core/files/attachments.js +5 -4
  207. package/dist-lib/lib/core/files/index.d.ts +21 -11
  208. package/dist-lib/lib/core/files/index.js +114 -28
  209. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  210. package/dist-lib/lib/core/files/knowledge.js +77 -5
  211. package/dist-lib/lib/core/files/preview/index.js +6 -2
  212. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  213. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  214. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  215. package/dist-lib/lib/core/files/processing/document.js +26 -2
  216. package/dist-lib/lib/core/files/processing/index.d.ts +7 -2
  217. package/dist-lib/lib/core/files/processing/index.js +91 -71
  218. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  219. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  220. package/dist-lib/lib/core/files/processing/source.d.ts +3 -0
  221. package/dist-lib/lib/core/files/processing/source.js +9 -4
  222. package/dist-lib/lib/core/files/processing/state.d.ts +4 -1
  223. package/dist-lib/lib/core/files/processing/state.js +2 -1
  224. package/dist-lib/lib/core/files/rag/build.d.ts +4 -1
  225. package/dist-lib/lib/core/files/rag/build.js +18 -7
  226. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  227. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  228. package/dist-lib/lib/core/files/rag/index.d.ts +12 -1
  229. package/dist-lib/lib/core/files/rag/index.js +29 -7
  230. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  231. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  232. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  233. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  234. package/dist-lib/lib/core/files/rag/load.js +6 -3
  235. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  236. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  237. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  238. package/dist-lib/lib/core/files/rag/produce.js +30 -18
  239. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -1
  240. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  241. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  242. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  243. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  244. package/dist-lib/lib/core/files/records/index.js +1 -1
  245. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  246. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  247. package/dist-lib/lib/core/files/records/purge.js +13 -8
  248. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  249. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  250. package/dist-lib/lib/core/files/records/routing.js +6 -2
  251. package/dist-lib/lib/core/files/records/source.js +3 -5
  252. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  253. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  254. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  255. package/dist-lib/lib/core/files/store/blob.js +2 -2
  256. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  257. package/dist-lib/lib/core/files/store/index.js +4 -1
  258. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  259. package/dist-lib/lib/core/files/store/reference.js +12 -2
  260. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  261. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  262. package/dist-lib/lib/core/files/upload.js +53 -14
  263. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  264. package/dist-lib/lib/core/fs-drives.js +30 -18
  265. package/dist-lib/lib/core/id.d.ts +1 -0
  266. package/dist-lib/lib/core/id.js +3 -0
  267. package/dist-lib/lib/core/identity.d.ts +3 -1
  268. package/dist-lib/lib/core/identity.js +25 -4
  269. package/dist-lib/lib/core/invite.d.ts +4 -0
  270. package/dist-lib/lib/core/invite.js +19 -6
  271. package/dist-lib/lib/core/local/files.d.ts +2 -1
  272. package/dist-lib/lib/core/local/files.js +5 -7
  273. package/dist-lib/lib/core/local/index.d.ts +76 -6
  274. package/dist-lib/lib/core/local/index.js +209 -19
  275. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  276. package/dist-lib/lib/core/local/run-logs.js +132 -0
  277. package/dist-lib/lib/core/member-key.d.ts +7 -0
  278. package/dist-lib/lib/core/member-key.js +24 -0
  279. package/dist-lib/lib/core/membership.d.ts +3 -14
  280. package/dist-lib/lib/core/membership.js +3 -96
  281. package/dist-lib/lib/core/mesh.d.ts +94 -28
  282. package/dist-lib/lib/core/mesh.js +527 -144
  283. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  284. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  285. package/dist-lib/lib/core/migrations/file-index.js +2 -4
  286. package/dist-lib/lib/core/migrations/index.js +6 -2
  287. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  288. package/dist-lib/lib/core/model-requests.js +65 -0
  289. package/dist-lib/lib/core/next-frame.js +2 -1
  290. package/dist-lib/lib/core/notification.js +4 -2
  291. package/dist-lib/lib/core/pdf/rasterize.d.ts +2 -2
  292. package/dist-lib/lib/core/pdf/rasterize.js +5 -6
  293. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  294. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +47 -40
  295. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  296. package/dist-lib/lib/core/project-keys.js +56 -0
  297. package/dist-lib/lib/core/prompt-history.js +4 -4
  298. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  299. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  300. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  301. package/dist-lib/lib/core/public-mesh.js +88 -0
  302. package/dist-lib/lib/core/purge.d.ts +3 -0
  303. package/dist-lib/lib/core/purge.js +7 -0
  304. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  305. package/dist-lib/lib/core/run-driver.js +20 -0
  306. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  307. package/dist-lib/lib/core/run-requests.js +59 -0
  308. package/dist-lib/lib/core/send.d.ts +2 -0
  309. package/dist-lib/lib/core/send.js +17 -4
  310. package/dist-lib/lib/core/senders.d.ts +18 -0
  311. package/dist-lib/lib/core/senders.js +52 -0
  312. package/dist-lib/lib/core/shared-agents.d.ts +39 -0
  313. package/dist-lib/lib/core/shared-agents.js +255 -0
  314. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  315. package/dist-lib/lib/core/skill-secrets.js +90 -72
  316. package/dist-lib/lib/core/sync/background.d.ts +47 -0
  317. package/dist-lib/lib/core/sync/background.js +162 -0
  318. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  319. package/dist-lib/lib/core/sync/changed.js +7 -0
  320. package/dist-lib/lib/core/sync/devices.js +1 -1
  321. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  322. package/dist-lib/lib/core/sync/files.js +50 -72
  323. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  324. package/dist-lib/lib/core/sync/index.js +154 -81
  325. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  326. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  327. package/dist-lib/lib/core/system-info.d.ts +2 -2
  328. package/dist-lib/lib/core/system-info.js +10 -11
  329. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  330. package/dist-lib/lib/core/tool-configs.js +11 -11
  331. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  332. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  333. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  334. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  335. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  336. package/dist-lib/lib/core/video/attachment.js +7 -0
  337. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  338. package/dist-lib/lib/core/video/digest.js +57 -0
  339. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  340. package/dist-lib/lib/core/video/frames.js +224 -0
  341. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  342. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  343. package/dist-lib/lib/core.d.ts +249 -79
  344. package/dist-lib/lib/core.js +3369 -1460
  345. package/dist-lib/lib/credential-pusher.d.ts +6 -0
  346. package/dist-lib/lib/credential-pusher.js +77 -60
  347. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  348. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  349. package/dist-lib/lib/custom-model-task.js +2 -2
  350. package/dist-lib/lib/diagnostics.d.ts +7 -0
  351. package/dist-lib/lib/diagnostics.js +22 -0
  352. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  353. package/dist-lib/lib/doctor/checks.js +272 -0
  354. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  355. package/dist-lib/lib/doctor/redact.js +31 -0
  356. package/dist-lib/lib/doctor/render.d.ts +8 -0
  357. package/dist-lib/lib/doctor/render.js +83 -0
  358. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  359. package/dist-lib/lib/doctor/tree.js +167 -0
  360. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  361. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  362. package/dist-lib/lib/errors.d.ts +790 -0
  363. package/dist-lib/lib/errors.js +724 -0
  364. package/dist-lib/lib/fs-drive-bridge.d.ts +1 -1
  365. package/dist-lib/lib/fs-drive-bridge.js +4 -1
  366. package/dist-lib/lib/guards.d.ts +1 -0
  367. package/dist-lib/lib/guards.js +4 -0
  368. package/dist-lib/lib/inference-calls.d.ts +1 -2
  369. package/dist-lib/lib/inference-calls.js +2 -10
  370. package/dist-lib/lib/knowledge-search.js +13 -18
  371. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  372. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  373. package/dist-lib/lib/log.d.ts +7 -6
  374. package/dist-lib/lib/log.js +14 -7
  375. package/dist-lib/lib/logger-type.d.ts +2 -5
  376. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  377. package/dist-lib/lib/model-download-status.d.ts +3 -3
  378. package/dist-lib/lib/model-download.d.ts +11 -12
  379. package/dist-lib/lib/model-download.js +63 -22
  380. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  381. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  382. package/dist-lib/lib/model-memory-cap.js +69 -0
  383. package/dist-lib/lib/models-watch.d.ts +1 -1
  384. package/dist-lib/lib/models-watch.js +4 -4
  385. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  386. package/dist-lib/lib/oauth/flow-core.js +5 -3
  387. package/dist-lib/lib/oauth/flow.js +1 -1
  388. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  389. package/dist-lib/lib/oauth/loopback.js +57 -12
  390. package/dist-lib/lib/oauth/providers.js +4 -2
  391. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  392. package/dist-lib/lib/oauth/register.js +35 -19
  393. package/dist-lib/lib/oauth/request.d.ts +10 -0
  394. package/dist-lib/lib/oauth/request.js +22 -0
  395. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  396. package/dist-lib/lib/oauth/types.d.ts +3 -0
  397. package/dist-lib/lib/oauth.d.ts +2 -1
  398. package/dist-lib/lib/oauth.js +1 -0
  399. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  400. package/dist-lib/lib/persistent-dir.js +9 -0
  401. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  402. package/dist-lib/lib/probe-rounds.js +5 -0
  403. package/dist-lib/lib/run-input.d.ts +14 -0
  404. package/dist-lib/lib/run-input.js +33 -0
  405. package/dist-lib/lib/run-notices.d.ts +3 -0
  406. package/dist-lib/lib/run-notices.js +8 -2
  407. package/dist-lib/lib/run-replay.d.ts +32 -0
  408. package/dist-lib/lib/run-replay.js +121 -0
  409. package/dist-lib/lib/run-transcript.d.ts +11 -12
  410. package/dist-lib/lib/run-transcript.js +16 -18
  411. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  412. package/dist-lib/lib/task.js +6 -4
  413. package/dist-lib/lib/test-env.d.ts +1 -0
  414. package/dist-lib/lib/test-env.js +4 -0
  415. package/dist-lib/schema/build.js +3 -1
  416. package/dist-lib/schema/config.d.ts +1 -1
  417. package/dist-lib/schema/config.js +1 -1
  418. package/dist-lib/schema/content.d.ts +5 -1
  419. package/dist-lib/schema/content.js +58 -11
  420. package/dist-lib/schema/engine.d.ts +1 -0
  421. package/dist-lib/schema/engine.js +709 -116
  422. package/dist-lib/schema/field-order.js +2 -1
  423. package/dist-lib/schema/indexes.d.ts +3 -0
  424. package/dist-lib/schema/indexes.js +30 -3
  425. package/dist-lib/schema/local.js +72 -4
  426. package/dist-lib/schema/qvac.d.ts +4 -1
  427. package/dist-lib/schema/qvac.js +364 -12
  428. package/dist-lib/spec/bind.js +209 -48
  429. package/dist-lib/spec/calls.js +45 -5
  430. package/dist-lib/spec/capabilities.d.ts +98 -18
  431. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  432. package/dist-lib/spec/hrpc/hrpc.json +726 -206
  433. package/dist-lib/spec/hrpc/index.js +832 -345
  434. package/dist-lib/spec/hrpc/messages.js +6906 -4832
  435. package/dist-lib/spec/hyperschema/index.js +6906 -4832
  436. package/dist-lib/spec/hyperschema/schema.json +4744 -3139
  437. package/dist-lib/spec/hyperschema/types.d.ts +461 -61
  438. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  439. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  440. package/dist-lib/spec/local/hyperdb/messages.js +1506 -484
  441. package/dist-lib/spec/local/hyperschema/index.js +542 -13
  442. package/dist-lib/spec/local/hyperschema/schema.json +319 -1
  443. package/dist-lib/spec/local/hyperschema/types.d.ts +78 -2
  444. package/dist-lib/spec/mesh/hyperdb/db.json +371 -5
  445. package/dist-lib/spec/mesh/hyperdb/index.js +1564 -5
  446. package/dist-lib/spec/mesh/hyperdb/messages.js +6023 -1246
  447. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +187 -1
  448. package/dist-lib/spec/mesh/hyperdispatch/index.js +528 -1
  449. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3449 -217
  450. package/dist-lib/spec/mesh/hyperschema/index.js +3449 -217
  451. package/dist-lib/spec/mesh/hyperschema/schema.json +1865 -19
  452. package/dist-lib/spec/mesh/hyperschema/types.d.ts +470 -6
  453. package/package.json +50 -35
  454. package/worker/assistant-sidecar.mjs +15 -2
  455. package/worker/stow-entry.mjs +2 -0
  456. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  457. package/dist-lib/lib/core/contract/compute.js +0 -48
  458. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  459. package/dist-lib/lib/core/device-invites.js +0 -63
  460. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  461. package/dist-lib/lib/core/grant-expiry.js +0 -66
  462. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  463. package/dist-lib/lib/core/handoff-channel.js +0 -123
  464. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  465. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  466. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  467. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  468. package/dist-lib/lib/core/hosted-agents.js +0 -140
  469. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  470. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  471. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  472. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  473. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  474. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  475. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  476. package/dist-lib/lib/core/secret-handoff.js +0 -29
  477. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  478. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  479. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  480. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  481. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  482. package/dist-lib/lib/image-cache-dir.js +0 -5
  483. package/dist-lib/lib/log-levels.d.ts +0 -7
  484. package/dist-lib/lib/log-levels.js +0 -1
  485. package/dist-lib/lib/logger.d.ts +0 -5
  486. package/dist-lib/lib/logger.js +0 -18
  487. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  488. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  489. package/tui/README.md +0 -142
  490. package/tui/app.mjs +0 -6939
  491. package/tui/boot.mjs +0 -111
  492. package/tui/index.mjs +0 -53
  493. package/tui/lib/boot-timing.mjs +0 -41
  494. package/tui/lib/busy-words.mjs +0 -116
  495. package/tui/lib/export.mjs +0 -194
  496. package/tui/lib/knowledge-command.mjs +0 -190
  497. package/tui/lib/knowledge-import.mjs +0 -171
  498. package/tui/lib/render.mjs +0 -196
  499. package/tui/lib/save-file.mjs +0 -88
  500. package/tui/lib/select.mjs +0 -81
  501. package/tui/lib/selection.mjs +0 -18
  502. package/tui/lib/setup.mjs +0 -101
  503. package/tui/lib/sidebar.mjs +0 -63
  504. package/tui/lib/splash-art.mjs +0 -107
  505. package/tui/lib/splash.mjs +0 -18
  506. package/tui/lib/upload-frames.mjs +0 -9
  507. package/tui/lib/usage.mjs +0 -59
  508. package/tui/lib/wrap.mjs +0 -143
  509. package/tui/main.mjs +0 -264
@@ -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 } = {}) {
174
186
  if (this._closed ||
175
187
  !this._harness.list ||
176
188
  !this._harness.download ||
@@ -195,7 +207,7 @@ export class ModelDownloadReconciler {
195
207
  this._removeDemandWaiter(model, waiter);
196
208
  resolve();
197
209
  };
198
- const waiter = { signal, abort, reject, resolve };
210
+ const waiter = { signal, abort, reject, resolve, onHold: onHold ?? null };
199
211
  const demand = this._demands.get(model) ?? {
200
212
  addon,
201
213
  failures: 0,
@@ -209,7 +221,7 @@ export class ModelDownloadReconciler {
209
221
  }
210
222
  async retry(name) {
211
223
  if (this._closed)
212
- throw new Error('model download reconciler is closed');
224
+ throw new CoreError('MODEL_DOWNLOAD_CLOSED');
213
225
  this._requestedModels.add(name);
214
226
  this._attemptGenerations.set(name, this._attemptGeneration(name) + 1);
215
227
  const demand = this._demands.get(name);
@@ -225,7 +237,7 @@ export class ModelDownloadReconciler {
225
237
  }
226
238
  async release(name, removeFiles) {
227
239
  if (this._closed)
228
- throw new Error('model download reconciler is closed');
240
+ throw new CoreError('MODEL_DOWNLOAD_CLOSED');
229
241
  this._releasing.add(name);
230
242
  this._requestedModels.delete(name);
231
243
  this._handled.delete(name);
@@ -339,18 +351,25 @@ export class ModelDownloadReconciler {
339
351
  if (!meshId) {
340
352
  return;
341
353
  }
354
+ let active = null;
342
355
  const run = async () => {
343
356
  const stream = this._engine.agentsWatch({ meshId });
344
- this._agentsStream = stream[Symbol.asyncIterator]();
357
+ const iterator = stream[Symbol.asyncIterator]();
358
+ active = iterator;
359
+ this._agentsStream = iterator;
345
360
  while (true) {
346
- const { done } = await this._agentsStream.next();
347
- if (done || this._closed) {
361
+ const { done } = await iterator.next();
362
+ if (done || this._closed || this._agentsStream !== iterator) {
348
363
  return;
349
364
  }
350
365
  this._kick();
351
366
  }
352
367
  };
353
- run().catch((err) => this._restartWatch('agents', err, () => this._watchAgents()));
368
+ run().catch((err) => {
369
+ if (active && this._agentsStream !== active)
370
+ return;
371
+ this._restartWatch('agents', err, () => this._watchAgents());
372
+ });
354
373
  }
355
374
  _restartWatch(name, err, restart) {
356
375
  if (this._closed)
@@ -410,7 +429,7 @@ export class ModelDownloadReconciler {
410
429
  if (this._closed || this._paused) {
411
430
  return;
412
431
  }
413
- const downloadable = new Map(targets.filter((t) => !t.paused).map((t) => [t.name, t]));
432
+ const downloadable = new Map(targets.filter((t) => !t.paused && !t.held).map((t) => [t.name, t]));
414
433
  if (this._active && !downloadable.has(this._active.model)) {
415
434
  const stillWanted = targets.some((t) => t.name === this._active?.model);
416
435
  await this._stopActive(!stillWanted);
@@ -427,6 +446,7 @@ export class ModelDownloadReconciler {
427
446
  }
428
447
  const next = this._active ? null : preferred;
429
448
  await this._writeWaiting(targets, next?.name, now);
449
+ this._announceHolds(targets);
430
450
  if (next && !this._closed && !this._paused) {
431
451
  this._begin(next);
432
452
  }
@@ -436,6 +456,9 @@ export class ModelDownloadReconciler {
436
456
  if (target.paused) {
437
457
  await this._status.write(target.name, 'paused', { bytesPerSecond: 0 });
438
458
  }
459
+ else if (target.held) {
460
+ await this._status.write(target.name, 'held', { total: target.total, bytesPerSecond: 0 });
461
+ }
439
462
  else if (this._waiting(target.name, nextName, now)) {
440
463
  await this._status.write(target.name, 'queued', {
441
464
  total: target.total,
@@ -444,6 +467,17 @@ export class ModelDownloadReconciler {
444
467
  }
445
468
  }
446
469
  }
470
+ _announceHolds(targets) {
471
+ for (const target of targets) {
472
+ if (!target.held)
473
+ continue;
474
+ for (const waiter of this._demands.get(target.name)?.waiters ?? []) {
475
+ const onHold = waiter.onHold;
476
+ waiter.onHold = null;
477
+ onHold?.();
478
+ }
479
+ }
480
+ }
447
481
  async _flushObservedProgress() {
448
482
  for (const [model, progress] of this._observedProgress) {
449
483
  await this._transfer(model);
@@ -518,7 +552,11 @@ export class ModelDownloadReconciler {
518
552
  }
519
553
  }
520
554
  async _desired() {
555
+ if (this._config === null) {
556
+ return [];
557
+ }
521
558
  if (this._demands.size === 0 &&
559
+ this._heldLoads.size === 0 &&
522
560
  this._handled.size === 0 &&
523
561
  !this._config?.onboardingCompleted) {
524
562
  await this._status.clearUnwanted(new Set());
@@ -565,6 +603,16 @@ export class ModelDownloadReconciler {
565
603
  }
566
604
  wanted.set(name, { name, addon, paused: paused.has(name) });
567
605
  }
606
+ for (const name of this._heldLoads) {
607
+ if (this._config?.autoDownloadModels !== false || availability.cached.has(name)) {
608
+ this._heldLoads.delete(name);
609
+ continue;
610
+ }
611
+ const addon = availability.addons.get(name);
612
+ if (!wanted.has(name) && addon !== undefined) {
613
+ wanted.set(name, { name, addon, paused: paused.has(name) });
614
+ }
615
+ }
568
616
  const wantedNames = new Set(wanted.keys());
569
617
  for (const name of this._attemptGenerations.keys()) {
570
618
  if (!wantedNames.has(name)) {
@@ -583,6 +631,7 @@ export class ModelDownloadReconciler {
583
631
  }
584
632
  pending.push({
585
633
  ...model,
634
+ held: this._heldBack(model.name),
586
635
  total: availability.totals.get(model.name) ?? 0
587
636
  });
588
637
  }
@@ -599,6 +648,9 @@ export class ModelDownloadReconciler {
599
648
  }
600
649
  return pending;
601
650
  }
651
+ _heldBack(name) {
652
+ return this._config?.autoDownloadModels === false && !this._requestedModels.has(name);
653
+ }
602
654
  async _reclaimCached(cached) {
603
655
  for (const name of this._config?.releasedModels ?? []) {
604
656
  if (!cached.has(name) || this._releasing.has(name))
@@ -619,18 +671,7 @@ export class ModelDownloadReconciler {
619
671
  return { cached, totals, addons };
620
672
  }
621
673
  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';
674
+ return (await this._hostCapability())?.capabilityProfile ?? 'low';
634
675
  }
635
676
  async _hostCapability() {
636
677
  if (this._capability)
@@ -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;
@@ -1,35 +1,51 @@
1
1
  import * as z from 'zod';
2
+ import { providerRequest } from './request.js';
3
+ import { CoreError } from '../errors.js';
2
4
  const RegistrationResponseSchema = z.object({
3
5
  client_id: z.string().min(1)
4
6
  });
5
- export async function registerOAuthClient(config, redirectUri, fetchImpl = globalThis.fetch) {
7
+ export function registerOAuthClient(config, redirectUri, fetchImpl) {
8
+ return register(config, redirectUri, { fetchImpl });
9
+ }
10
+ async function register(config, redirectUri, { fetchImpl = globalThis.fetch, timeoutMs }) {
6
11
  if (!config.registrationEndpoint) {
7
- throw new Error('Dynamic client registration requested without a registration endpoint');
12
+ throw new CoreError('OAUTH_REGISTRATION_UNAVAILABLE');
8
13
  }
9
- const response = await fetchImpl(config.registrationEndpoint, {
10
- method: 'POST',
11
- headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
12
- body: JSON.stringify({
13
- client_name: 'QV.AC',
14
- redirect_uris: [redirectUri],
15
- grant_types: ['authorization_code', 'refresh_token'],
16
- response_types: ['code'],
17
- token_endpoint_auth_method: 'none',
18
- application_type: 'native'
19
- })
14
+ return await providerRequest({
15
+ fetchImpl,
16
+ url: config.registrationEndpoint,
17
+ init: {
18
+ method: 'POST',
19
+ headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
20
+ body: JSON.stringify({
21
+ client_name: 'QV.AC',
22
+ redirect_uris: [redirectUri],
23
+ grant_types: ['authorization_code', 'refresh_token'],
24
+ response_types: ['code'],
25
+ token_endpoint_auth_method: 'none',
26
+ application_type: 'native'
27
+ })
28
+ },
29
+ timeoutMs,
30
+ timeout: () => new CoreError('OAUTH_REGISTRATION_TIMEOUT'),
31
+ read: async (response) => {
32
+ if (!response.ok) {
33
+ const text = await response.text().catch(() => '');
34
+ throw new CoreError('OAUTH_REGISTRATION_FAILED', [response.status, text]);
35
+ }
36
+ return RegistrationResponseSchema.parse(await response.json()).client_id;
37
+ }
20
38
  });
21
- if (!response.ok) {
22
- const text = await response.text().catch(() => '');
23
- throw new Error(`Client registration failed (${response.status}): ${text}`);
24
- }
25
- return RegistrationResponseSchema.parse(await response.json()).client_id;
26
39
  }
27
40
  export async function resolveDynamicClientId(config, redirectUri, deps, fetchImpl) {
28
41
  const cached = await deps.getClientId?.();
29
42
  if (cached) {
30
43
  return cached;
31
44
  }
32
- const clientId = await registerOAuthClient(config, redirectUri, fetchImpl);
45
+ const clientId = await register(config, redirectUri, {
46
+ fetchImpl,
47
+ timeoutMs: deps.requestTimeoutMs
48
+ });
33
49
  await deps.saveClientId?.(clientId);
34
50
  return clientId;
35
51
  }
@@ -0,0 +1,10 @@
1
+ import type { OAuthFetch } from './types.ts';
2
+ export interface ProviderRequest<T> {
3
+ readonly fetchImpl: OAuthFetch;
4
+ readonly url: string;
5
+ readonly init: RequestInit;
6
+ readonly timeoutMs?: number | undefined;
7
+ readonly timeout: () => Error;
8
+ readonly read: (response: Response) => Promise<T>;
9
+ }
10
+ export declare function providerRequest<T>({ fetchImpl, url, init, timeoutMs, timeout, read }: ProviderRequest<T>): Promise<T>;