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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -1,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>;
@@ -0,0 +1,22 @@
1
+ import { AbortController as BareAbortController } from 'bare-abort-controller';
2
+ const PROVIDER_REQUEST_TIMEOUT_MS = 30_000;
3
+ const AbortController = globalThis.AbortController ?? BareAbortController;
4
+ export async function providerRequest({ fetchImpl, url, init, timeoutMs = PROVIDER_REQUEST_TIMEOUT_MS, timeout, read }) {
5
+ const controller = new AbortController();
6
+ let timer;
7
+ const expired = new Promise((_resolve, reject) => {
8
+ timer = globalThis.setTimeout(() => {
9
+ controller.abort();
10
+ reject(timeout());
11
+ }, timeoutMs);
12
+ });
13
+ try {
14
+ return await Promise.race([
15
+ fetchImpl(url, { ...init, signal: controller.signal }).then(read),
16
+ expired
17
+ ]);
18
+ }
19
+ finally {
20
+ globalThis.clearTimeout(timer);
21
+ }
22
+ }
@@ -1,6 +1,6 @@
1
1
  import { scopedKey } from './keys.js';
2
2
  export const REFRESH_SKEW_MS = 60_000;
3
- const inFlightRefresh = new Map();
3
+ const inFlightRefresh = new WeakMap();
4
4
  export async function resolveOAuthCredential(opts) {
5
5
  const { engine, agentId, credentialKey, stateKey, refresh, requireClientSecret = false } = opts;
6
6
  const { value: token } = await engine.configGet({ key: scopedKey(agentId, credentialKey) });
@@ -28,9 +28,17 @@ export async function resolveOAuthCredential(opts) {
28
28
  if (typeof expiresAt !== 'number' || expiresAt - REFRESH_SKEW_MS > Date.now()) {
29
29
  return token;
30
30
  }
31
- const refreshKey = `${credentialKey}:${agentId ?? ''}`;
31
+ const refreshKey = JSON.stringify([
32
+ scopedKey(agentId, credentialKey),
33
+ scopedKey(agentId, stateKey)
34
+ ]);
32
35
  try {
33
- let pending = inFlightRefresh.get(refreshKey);
36
+ let engineRefreshes = inFlightRefresh.get(engine);
37
+ if (!engineRefreshes) {
38
+ engineRefreshes = new Map();
39
+ inFlightRefresh.set(engine, engineRefreshes);
40
+ }
41
+ let pending = engineRefreshes.get(refreshKey);
34
42
  if (!pending) {
35
43
  pending = (async () => {
36
44
  const refreshed = await refresh({
@@ -52,8 +60,8 @@ export async function resolveOAuthCredential(opts) {
52
60
  })
53
61
  });
54
62
  return refreshed.accessToken;
55
- })().finally(() => inFlightRefresh.delete(refreshKey));
56
- inFlightRefresh.set(refreshKey, pending);
63
+ })().finally(() => engineRefreshes?.delete(refreshKey));
64
+ engineRefreshes.set(refreshKey, pending);
57
65
  }
58
66
  return await pending;
59
67
  }
@@ -1,7 +1,6 @@
1
- import { AbortController as BareAbortController } from 'bare-abort-controller';
2
1
  import * as z from 'zod';
3
- const TOKEN_REQUEST_TIMEOUT_MS = 30_000;
4
- const AbortController = globalThis.AbortController ?? BareAbortController;
2
+ import { providerRequest } from './request.js';
3
+ import { CoreError } from '../errors.js';
5
4
  const TokenResponseSchema = z.object({
6
5
  access_token: z.string(),
7
6
  token_type: z.string(),
@@ -17,7 +16,7 @@ function parseTokenResponse(raw) {
17
16
  const failure = TokenErrorSchema.safeParse(raw);
18
17
  if (failure.success) {
19
18
  const detail = failure.data.error_description;
20
- throw new Error(`Token endpoint returned an error: ${failure.data.error}${detail ? ` — ${detail}` : ''}`);
19
+ throw new CoreError('OAUTH_TOKEN_ERROR', [failure.data.error, detail]);
21
20
  }
22
21
  return TokenResponseSchema.parse(raw);
23
22
  }
@@ -50,19 +49,23 @@ export async function exchangeCodeWithFetch(config, { clientId, redirectUri, cod
50
49
  Accept: 'application/json'
51
50
  };
52
51
  applyClientSecret(config, body, headers);
53
- const response = await fetchImpl(config.tokenUrl, {
54
- method: 'POST',
55
- headers,
56
- body: body.toString()
57
- });
58
- if (!response.ok) {
59
- const text = await response.text().catch(() => '');
60
- if (config.dynamicRegistration && /invalid_client/i.test(text)) {
61
- await deps.clearClientId?.();
52
+ return await providerRequest({
53
+ fetchImpl,
54
+ url: config.tokenUrl,
55
+ init: { method: 'POST', headers, body: body.toString() },
56
+ timeoutMs: deps.requestTimeoutMs,
57
+ timeout: () => new CoreError('OAUTH_TOKEN_EXCHANGE_TIMEOUT'),
58
+ read: async (response) => {
59
+ if (!response.ok) {
60
+ const text = await response.text().catch(() => '');
61
+ if (config.dynamicRegistration && /invalid_client/i.test(text)) {
62
+ await deps.clearClientId?.();
63
+ }
64
+ throw new CoreError('OAUTH_TOKEN_EXCHANGE_FAILED', [response.status, text]);
65
+ }
66
+ return toTokens(parseTokenResponse(await response.json()));
62
67
  }
63
- throw new Error(`Token exchange failed (${response.status}): ${text}`);
64
- }
65
- return toTokens(parseTokenResponse(await response.json()));
68
+ });
66
69
  }
67
70
  export async function refreshOAuthTokensWithFetch(config, refreshToken, fetchImpl) {
68
71
  const body = new URLSearchParams({
@@ -75,24 +78,19 @@ export async function refreshOAuthTokensWithFetch(config, refreshToken, fetchImp
75
78
  Accept: 'application/json'
76
79
  };
77
80
  applyClientSecret(config, body, headers);
78
- const controller = new AbortController();
79
- const timeout = globalThis.setTimeout(() => controller.abort(new Error('OAuth token refresh timed out')), TOKEN_REQUEST_TIMEOUT_MS);
80
- try {
81
- const response = await fetchImpl(config.tokenUrl, {
82
- method: 'POST',
83
- headers,
84
- body: body.toString(),
85
- signal: controller.signal
86
- });
87
- if (!response.ok) {
88
- const text = await response.text().catch(() => '');
89
- throw new Error(`Token refresh failed (${response.status}): ${text}`);
81
+ return await providerRequest({
82
+ fetchImpl,
83
+ url: config.tokenUrl,
84
+ init: { method: 'POST', headers, body: body.toString() },
85
+ timeout: () => new CoreError('OAUTH_TOKEN_REFRESH_TIMEOUT'),
86
+ read: async (response) => {
87
+ if (!response.ok) {
88
+ const text = await response.text().catch(() => '');
89
+ throw new CoreError('OAUTH_TOKEN_REFRESH_FAILED', [response.status, text]);
90
+ }
91
+ return toTokens(parseTokenResponse(await response.json()), refreshToken);
90
92
  }
91
- return toTokens(parseTokenResponse(await response.json()), refreshToken);
92
- }
93
- finally {
94
- globalThis.clearTimeout(timeout);
95
- }
93
+ });
96
94
  }
97
95
  export function isTokenExpired(record, bufferMs = 60_000) {
98
96
  return typeof record.expiresAt === 'number' && Date.now() + bufferMs >= record.expiresAt;
@@ -27,13 +27,16 @@ interface OAuthProviderConfigBase {
27
27
  readonly dynamicRegistration?: boolean;
28
28
  readonly registrationEndpoint?: string;
29
29
  }
30
+ export type OAuthFlowStage = 'awaiting-callback' | 'exchanging-code';
30
31
  export interface OAuthFlowDeps {
31
32
  readonly openUrl?: (url: string) => Promise<void>;
32
33
  readonly timeoutMs?: number;
34
+ readonly requestTimeoutMs?: number;
33
35
  readonly getClientId?: () => Promise<string | undefined>;
34
36
  readonly saveClientId?: (clientId: string) => Promise<void>;
35
37
  readonly clearClientId?: () => Promise<void>;
36
38
  readonly createRedirect?: OAuthRedirectFactory;
39
+ readonly onStage?: (stage: OAuthFlowStage) => void;
37
40
  }
38
41
  export type PkceOnlyProviderConfig = OAuthProviderConfigBase & {
39
42
  readonly tokenAuth: 'pkce-only';
@@ -1,5 +1,6 @@
1
1
  export { waitForOAuthCallback } from './oauth/browser-connect.ts';
2
2
  export { cancelOAuthFlow, runOAuthFlow } from './oauth/flow.ts';
3
+ export { deliverOAuthCallback } from './oauth/loopback.ts';
3
4
  export { OAUTH_CALLBACK_PATH, OAUTH_WAIT_FOR_CODE_TIMEOUT_MS, oauthRedirectUri, scopedKey, specFromRoute, type OAuthKeySpec, type OAuthRouteLike } from './oauth/keys.ts';
4
5
  export { oauthSpecFor, oauthSpecs } from './oauth/registry.ts';
5
6
  export { createPkce, generatePkceChallenge, type PkceChallenge } from './oauth/pkce.ts';
@@ -8,4 +9,4 @@ export type { OAuthCallbackResult, OAuthRedirect, OAuthRedirectFactory } from '.
8
9
  export { registerOAuthClient, resolveDynamicClientId } from './oauth/register.ts';
9
10
  export { resolveOAuthCredential, type ConfigEngine, type Fetch, type FetchResponse } from './oauth/resolve.ts';
10
11
  export { isTokenExpired, refreshOAuthTokens } from './oauth/token-exchange.ts';
11
- export type { OAuthCredentials, OAuthFlowDeps, OAuthFlowResult, OAuthProvider, OAuthProviderConfig, OAuthTokens } from './oauth/types.ts';
12
+ export type { OAuthCredentials, OAuthFlowDeps, OAuthFlowResult, OAuthFlowStage, OAuthProvider, OAuthProviderConfig, OAuthTokens } from './oauth/types.ts';
@@ -1,5 +1,6 @@
1
1
  export { waitForOAuthCallback } from './oauth/browser-connect.js';
2
2
  export { cancelOAuthFlow, runOAuthFlow } from './oauth/flow.js';
3
+ export { deliverOAuthCallback } from './oauth/loopback.js';
3
4
  export { OAUTH_CALLBACK_PATH, OAUTH_WAIT_FOR_CODE_TIMEOUT_MS, oauthRedirectUri, scopedKey, specFromRoute } from './oauth/keys.js';
4
5
  export { oauthSpecFor, oauthSpecs } from './oauth/registry.js';
5
6
  export { createPkce, generatePkceChallenge } from './oauth/pkce.js';
@@ -0,0 +1 @@
1
+ export declare function persistentDir(name: string): string;
@@ -0,0 +1,9 @@
1
+ import { persistent } from 'bare-storage';
2
+ import { join } from 'path';
3
+ import { underTest } from './test-env.js';
4
+ export function persistentDir(name) {
5
+ if (underTest()) {
6
+ throw new Error(`${name} would land in the device's persistent dir; pass its dir option`);
7
+ }
8
+ return join(persistent(), 'qvac', name);
9
+ }
@@ -0,0 +1,3 @@
1
+ export declare const PROBE_KINDS: readonly ['fold', 'title', 'suggestion'];
2
+ export type ProbeKind = (typeof PROBE_KINDS)[number];
3
+ export declare function isProbeRound(options: unknown): boolean;
@@ -0,0 +1,5 @@
1
+ import { isRecord } from './guards.js';
2
+ export const PROBE_KINDS = ['fold', 'title', 'suggestion'];
3
+ export function isProbeRound(options) {
4
+ return isRecord(options) && PROBE_KINDS.some((kind) => kind === options.kind);
5
+ }
@@ -1,6 +1,7 @@
1
1
  import { Readable } from 'streamx';
2
2
  import { frameReadable } from './frame-readable.js';
3
3
  import { asError } from './guards.js';
4
+ import { latestFrame } from './latest-frame.js';
4
5
  const RETRY_MIN_MS = 250;
5
6
  const RETRY_MAX_MS = 5_000;
6
7
  export function reconnectingWatch(open, onDisconnect) {
@@ -8,8 +9,9 @@ export function reconnectingWatch(open, onDisconnect) {
8
9
  let retry = null;
9
10
  let retryMs = RETRY_MIN_MS;
10
11
  let output;
12
+ const frames = latestFrame((frame) => output.push(frame));
11
13
  const schedule = (error) => {
12
- if (output.destroying)
14
+ if (output.destroying || retry)
13
15
  return;
14
16
  onDisconnect(error);
15
17
  retry = setTimeout(() => {
@@ -19,7 +21,7 @@ export function reconnectingWatch(open, onDisconnect) {
19
21
  retryMs = Math.min(retryMs * 2, RETRY_MAX_MS);
20
22
  };
21
23
  const connect = () => {
22
- if (output.destroying)
24
+ if (output.destroying || closeConnection)
23
25
  return;
24
26
  let source;
25
27
  try {
@@ -40,12 +42,13 @@ export function reconnectingWatch(open, onDisconnect) {
40
42
  if (closeConnection !== close)
41
43
  return;
42
44
  closeConnection = null;
45
+ frames.clear();
43
46
  close();
44
47
  schedule(error);
45
48
  };
46
49
  const onData = (frame) => {
47
50
  retryMs = RETRY_MIN_MS;
48
- output.push(frame);
51
+ frames.offer(frame);
49
52
  };
50
53
  const onError = (error) => disconnect(error);
51
54
  const onEnd = () => disconnect(new Error('Watch stream ended unexpectedly'));
@@ -55,22 +58,27 @@ export function reconnectingWatch(open, onDisconnect) {
55
58
  source.on('end', onEnd);
56
59
  source.on('close', onEnd);
57
60
  };
61
+ const stop = () => {
62
+ if (retry) {
63
+ clearTimeout(retry);
64
+ }
65
+ retry = null;
66
+ frames.release();
67
+ const close = closeConnection;
68
+ closeConnection = null;
69
+ close?.();
70
+ };
58
71
  output = new Readable({
59
72
  open(cb) {
60
73
  connect();
61
74
  cb(null);
62
75
  },
63
76
  read(cb) {
64
- cb(null);
77
+ frames.read(cb);
65
78
  },
79
+ predestroy: stop,
66
80
  destroy(cb) {
67
- if (retry) {
68
- clearTimeout(retry);
69
- }
70
- retry = null;
71
- const close = closeConnection;
72
- closeConnection = null;
73
- close?.();
81
+ stop();
74
82
  cb(null);
75
83
  }
76
84
  });
@@ -0,0 +1,14 @@
1
+ export interface RunInput {
2
+ mode: 'steer' | 'follow-up';
3
+ text: string;
4
+ id?: string;
5
+ }
6
+ export declare const STEERED = "steered";
7
+ export declare class RunInputQueue {
8
+ private readonly _items;
9
+ private _wake;
10
+ private _closed;
11
+ push(input: RunInput): void;
12
+ close(): void;
13
+ [Symbol.asyncIterator](): AsyncIterator<RunInput>;
14
+ }
@@ -0,0 +1,33 @@
1
+ export const STEERED = 'steered';
2
+ export class RunInputQueue {
3
+ _items = [];
4
+ _wake = null;
5
+ _closed = false;
6
+ push(input) {
7
+ if (this._closed) {
8
+ return;
9
+ }
10
+ this._items.push(input);
11
+ this._wake?.();
12
+ }
13
+ close() {
14
+ this._closed = true;
15
+ this._wake?.();
16
+ }
17
+ async *[Symbol.asyncIterator]() {
18
+ while (true) {
19
+ const next = this._items.shift();
20
+ if (next) {
21
+ yield next;
22
+ continue;
23
+ }
24
+ if (this._closed) {
25
+ return;
26
+ }
27
+ await new Promise((resolve) => {
28
+ this._wake = resolve;
29
+ });
30
+ this._wake = null;
31
+ }
32
+ }
33
+ }
@@ -1,16 +1,21 @@
1
1
  export declare const RUN_ABORT_REASONS: {
2
2
  readonly suspended: 'suspended';
3
3
  readonly ownershipLost: 'ownership-lost';
4
+ readonly agentRemoved: 'agent-removed';
4
5
  readonly runSettled: 'run-settled';
5
6
  readonly runnerDied: 'runner-died';
6
7
  readonly runnerClosed: 'runner-closed';
7
8
  readonly modelUnloaded: 'model-unloaded';
9
+ readonly stalled: 'stalled';
8
10
  };
9
11
  export type RunAbortReason = (typeof RUN_ABORT_REASONS)[keyof typeof RUN_ABORT_REASONS];
10
12
  export declare const RUN_FAILURE_REASONS: {
11
13
  readonly harnessDied: 'the model runtime died';
12
14
  readonly runtimeEndedTurn: 'the model runtime ended this turn';
13
15
  readonly capabilityUnavailable: 'this device cannot run a capability without a model';
16
+ readonly stalled: 'the agent stopped responding';
17
+ readonly agentRemoved: 'the agent was removed';
18
+ readonly videoNeedsVision: 'this model cannot see video: switch to a model that reads images to ask about one';
14
19
  };
15
20
  export type AbortOutcome = {
16
21
  readonly kind: 'replay';
@@ -1,15 +1,20 @@
1
1
  export const RUN_ABORT_REASONS = {
2
2
  suspended: 'suspended',
3
3
  ownershipLost: 'ownership-lost',
4
+ agentRemoved: 'agent-removed',
4
5
  runSettled: 'run-settled',
5
6
  runnerDied: 'runner-died',
6
7
  runnerClosed: 'runner-closed',
7
- modelUnloaded: 'model-unloaded'
8
+ modelUnloaded: 'model-unloaded',
9
+ stalled: 'stalled'
8
10
  };
9
11
  export const RUN_FAILURE_REASONS = {
10
12
  harnessDied: 'the model runtime died',
11
13
  runtimeEndedTurn: 'the model runtime ended this turn',
12
- capabilityUnavailable: 'this device cannot run a capability without a model'
14
+ capabilityUnavailable: 'this device cannot run a capability without a model',
15
+ stalled: 'the agent stopped responding',
16
+ agentRemoved: 'the agent was removed',
17
+ videoNeedsVision: 'this model cannot see video: switch to a model that reads images to ask about one'
13
18
  };
14
19
  export function knownAbortOutcome(reason) {
15
20
  if (reason === RUN_ABORT_REASONS.suspended ||
@@ -23,6 +28,12 @@ export function knownAbortOutcome(reason) {
23
28
  if (reason === RUN_ABORT_REASONS.runnerDied) {
24
29
  return { kind: 'failed', reason: RUN_FAILURE_REASONS.harnessDied };
25
30
  }
31
+ if (reason === RUN_ABORT_REASONS.agentRemoved) {
32
+ return { kind: 'failed', reason: RUN_FAILURE_REASONS.agentRemoved };
33
+ }
34
+ if (reason === RUN_ABORT_REASONS.stalled) {
35
+ return { kind: 'failed', reason: RUN_FAILURE_REASONS.stalled };
36
+ }
26
37
  return null;
27
38
  }
28
39
  export function isLifecycleTeardown(reason) {
@@ -0,0 +1,44 @@
1
+ import type { ChatMessage } from './assistant/message.ts';
2
+ export declare const LOCAL_HOLDER = "local";
3
+ export interface ReplayChat {
4
+ readonly holder: string;
5
+ readonly chatId: string;
6
+ }
7
+ export interface Forgotten {
8
+ readonly holder?: string | undefined;
9
+ readonly reason?: string | undefined;
10
+ }
11
+ export interface SentRun {
12
+ readonly messages: ChatMessage[];
13
+ readonly asked?: string | undefined;
14
+ }
15
+ export interface ReplayData {
16
+ readonly sentRuns: Map<string, ChatMessage[]>;
17
+ readonly askedRuns: Map<string, string>;
18
+ }
19
+ export declare class RunReplayStore {
20
+ private readonly _dir;
21
+ constructor(dir: string);
22
+ started(): Promise<boolean>;
23
+ start(): Promise<void>;
24
+ load(chat: ReplayChat): Promise<Map<string, ChatMessage[]>>;
25
+ loadAsked(chat: ReplayChat): Promise<Map<string, string>>;
26
+ loadReplay(chat: ReplayChat): Promise<ReplayData>;
27
+ save({ holder, chatId }: ReplayChat, runId: string, { messages, asked }: SentRun): Promise<void>;
28
+ rebuild({ holder, chatId }: ReplayChat): Promise<string | null>;
29
+ consume({ holder, chatId }: ReplayChat): Promise<void>;
30
+ private _records;
31
+ forget(chatId: string, { holder, reason }?: Forgotten): Promise<void>;
32
+ clear(holder: string): Promise<void>;
33
+ private _chatDir;
34
+ private _holders;
35
+ }
36
+ export interface SentRunTracker {
37
+ readonly used: boolean;
38
+ readonly onKey: boolean;
39
+ observe(call: Record<string, unknown>): void;
40
+ turns(inputLength: number): ChatMessage[] | null;
41
+ }
42
+ export declare function trackSentRun(cacheKey: string | undefined): SentRunTracker;
43
+ export declare function appendedTurns(sent: unknown, inputLength: number): ChatMessage[] | null;
44
+ export declare function isChatMessage(value: unknown): value is ChatMessage;