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

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 (579) hide show
  1. package/CHANGELOG.md +1205 -1
  2. package/README.md +56 -45
  3. package/dist-lib/index.d.ts +3 -2
  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 +20 -2
  8. package/dist-lib/lib/api/agents.js +128 -24
  9. package/dist-lib/lib/api/app-config.d.ts +7 -1
  10. package/dist-lib/lib/api/app-config.js +37 -6
  11. package/dist-lib/lib/api/approval-rules.d.ts +1 -1
  12. package/dist-lib/lib/api/approval-rules.js +12 -5
  13. package/dist-lib/lib/api/attachments.d.ts +1 -1
  14. package/dist-lib/lib/api/attachments.js +14 -2
  15. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  16. package/dist-lib/lib/api/chat-move.js +7 -0
  17. package/dist-lib/lib/api/chat.d.ts +12 -2
  18. package/dist-lib/lib/api/chat.js +100 -9
  19. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  20. package/dist-lib/lib/api/chunk-delta.js +115 -0
  21. package/dist-lib/lib/api/chunks.d.ts +19 -2
  22. package/dist-lib/lib/api/chunks.js +73 -13
  23. package/dist-lib/lib/api/config.d.ts +11 -3
  24. package/dist-lib/lib/api/config.js +51 -5
  25. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  26. package/dist-lib/lib/api/current-mesh.js +15 -11
  27. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  28. package/dist-lib/lib/api/custom-models.js +12 -12
  29. package/dist-lib/lib/api/device-routes.d.ts +14 -0
  30. package/dist-lib/lib/api/device-routes.js +144 -0
  31. package/dist-lib/lib/api/devices.d.ts +3 -2
  32. package/dist-lib/lib/api/devices.js +28 -28
  33. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  34. package/dist-lib/lib/api/diagnostics.js +2 -2
  35. package/dist-lib/lib/api/execution.d.ts +16 -1
  36. package/dist-lib/lib/api/execution.js +72 -16
  37. package/dist-lib/lib/api/files.d.ts +1 -1
  38. package/dist-lib/lib/api/files.js +65 -8
  39. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  40. package/dist-lib/lib/api/host-run-log.js +35 -83
  41. package/dist-lib/lib/api/index.d.ts +39 -7
  42. package/dist-lib/lib/api/index.js +116 -36
  43. package/dist-lib/lib/api/instrument.d.ts +2 -2
  44. package/dist-lib/lib/api/instrument.js +24 -48
  45. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  46. package/dist-lib/lib/api/knowledge.js +25 -7
  47. package/dist-lib/lib/api/local-files.d.ts +5 -1
  48. package/dist-lib/lib/api/local-files.js +9 -5
  49. package/dist-lib/lib/api/logs.js +3 -3
  50. package/dist-lib/lib/api/members.d.ts +10 -1
  51. package/dist-lib/lib/api/members.js +69 -44
  52. package/dist-lib/lib/api/mesh.d.ts +15 -6
  53. package/dist-lib/lib/api/mesh.js +13 -9
  54. package/dist-lib/lib/api/model-download.d.ts +2 -1
  55. package/dist-lib/lib/api/model-download.js +2 -2
  56. package/dist-lib/lib/api/network.d.ts +10 -2
  57. package/dist-lib/lib/api/network.js +8 -2
  58. package/dist-lib/lib/api/notifications.d.ts +3 -1
  59. package/dist-lib/lib/api/notifications.js +14 -9
  60. package/dist-lib/lib/api/projects.d.ts +20 -0
  61. package/dist-lib/lib/api/projects.js +172 -0
  62. package/dist-lib/lib/api/rag-plugin.d.ts +17 -0
  63. package/dist-lib/lib/api/rag-plugin.js +44 -0
  64. package/dist-lib/lib/api/rag.d.ts +0 -1
  65. package/dist-lib/lib/api/rag.js +106 -33
  66. package/dist-lib/lib/api/served.d.ts +17 -0
  67. package/dist-lib/lib/api/served.js +65 -0
  68. package/dist-lib/lib/api/sync.d.ts +2 -1
  69. package/dist-lib/lib/api/sync.js +13 -3
  70. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  71. package/dist-lib/lib/api/tool-activity.js +4 -3
  72. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  73. package/dist-lib/lib/api/tool-configs.js +6 -9
  74. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  75. package/dist-lib/lib/api/upload-frames.js +0 -1
  76. package/dist-lib/lib/api/watchable.d.ts +3 -2
  77. package/dist-lib/lib/api/watchable.js +2 -3
  78. package/dist-lib/lib/api/workspace.d.ts +12 -0
  79. package/dist-lib/lib/api/workspace.js +61 -0
  80. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  81. package/dist-lib/lib/assistant/fake-models.js +112 -0
  82. package/dist-lib/lib/assistant/harness.d.ts +48 -31
  83. package/dist-lib/lib/assistant/harness.js +51 -10
  84. package/dist-lib/lib/assistant/history.d.ts +37 -17
  85. package/dist-lib/lib/assistant/history.js +212 -87
  86. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  87. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  88. package/dist-lib/lib/assistant/media-round.d.ts +61 -0
  89. package/dist-lib/lib/assistant/media-round.js +111 -0
  90. package/dist-lib/lib/assistant/message.d.ts +28 -1
  91. package/dist-lib/lib/assistant/message.js +65 -2
  92. package/dist-lib/lib/assistant/model-round.d.ts +118 -0
  93. package/dist-lib/lib/assistant/model-round.js +706 -0
  94. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  95. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  96. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  97. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  98. package/dist-lib/lib/assistant/round-host.d.ts +65 -0
  99. package/dist-lib/lib/assistant/round-host.js +332 -0
  100. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  101. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  102. package/dist-lib/lib/assistant/upload.d.ts +12 -0
  103. package/dist-lib/lib/assistant/upload.js +36 -0
  104. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  105. package/dist-lib/lib/assistant/video-budget.js +29 -0
  106. package/dist-lib/lib/assistant-client.d.ts +5 -1
  107. package/dist-lib/lib/assistant-client.js +54 -14
  108. package/dist-lib/lib/assistant-tree.d.ts +14 -3
  109. package/dist-lib/lib/assistant-tree.js +113 -21
  110. package/dist-lib/lib/assistant.d.ts +115 -25
  111. package/dist-lib/lib/assistant.js +2409 -1245
  112. package/dist-lib/lib/audio-format.js +1 -1
  113. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  114. package/dist-lib/lib/chat-suggestion.js +47 -0
  115. package/dist-lib/lib/client.d.ts +3 -2
  116. package/dist-lib/lib/client.js +18 -3
  117. package/dist-lib/lib/compaction.d.ts +3 -1
  118. package/dist-lib/lib/compaction.js +20 -6
  119. package/dist-lib/lib/constants.d.ts +10 -0
  120. package/dist-lib/lib/constants.js +10 -0
  121. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  122. package/dist-lib/lib/core/agent-copies.js +47 -0
  123. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  124. package/dist-lib/lib/core/agent-hosting.js +76 -0
  125. package/dist-lib/lib/core/agent.d.ts +9 -1
  126. package/dist-lib/lib/core/agent.js +58 -63
  127. package/dist-lib/lib/core/approval-rules.d.ts +5 -1
  128. package/dist-lib/lib/core/approval-rules.js +17 -9
  129. package/dist-lib/lib/core/archived-mesh.d.ts +14 -7
  130. package/dist-lib/lib/core/archived-mesh.js +75 -59
  131. package/dist-lib/lib/core/async-iterable.js +1 -1
  132. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  133. package/dist-lib/lib/core/blind-peers.js +1 -0
  134. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  135. package/dist-lib/lib/core/chat-activity.js +45 -34
  136. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  137. package/dist-lib/lib/core/chat-copy.js +404 -0
  138. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  139. package/dist-lib/lib/core/chat-fork.js +246 -0
  140. package/dist-lib/lib/core/chat-group.js +10 -22
  141. package/dist-lib/lib/core/chat-move.d.ts +77 -0
  142. package/dist-lib/lib/core/chat-move.js +601 -0
  143. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  144. package/dist-lib/lib/core/chat-order.js +28 -19
  145. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  146. package/dist-lib/lib/core/chat-read.js +49 -0
  147. package/dist-lib/lib/core/chat-search.js +14 -12
  148. package/dist-lib/lib/core/chat.d.ts +32 -4
  149. package/dist-lib/lib/core/chat.js +135 -61
  150. package/dist-lib/lib/core/chunk.d.ts +35 -7
  151. package/dist-lib/lib/core/chunk.js +271 -72
  152. package/dist-lib/lib/core/collections.d.ts +41 -1
  153. package/dist-lib/lib/core/collections.js +41 -1
  154. package/dist-lib/lib/core/config-value.d.ts +7 -0
  155. package/dist-lib/lib/core/config-value.js +15 -0
  156. package/dist-lib/lib/core/contract/activity.d.ts +7 -2
  157. package/dist-lib/lib/core/contract/activity.js +71 -23
  158. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  159. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  160. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  161. package/dist-lib/lib/core/contract/agents.js +142 -3
  162. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  163. package/dist-lib/lib/core/contract/chat.js +53 -3
  164. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  165. package/dist-lib/lib/core/contract/chunks.js +125 -38
  166. package/dist-lib/lib/core/contract/devices.js +6 -4
  167. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  168. package/dist-lib/lib/core/contract/index.js +38 -11
  169. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  170. package/dist-lib/lib/core/contract/indexing.js +51 -7
  171. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  172. package/dist-lib/lib/core/contract/invites.js +26 -36
  173. package/dist-lib/lib/core/contract/joined-meshes.js +4 -1
  174. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  175. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  176. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  177. package/dist-lib/lib/core/contract/members.js +48 -12
  178. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  179. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  180. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  181. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  182. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  183. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  184. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  185. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  186. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  187. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  188. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  189. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  190. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  191. package/dist-lib/lib/core/contract/open-join.js +77 -0
  192. package/dist-lib/lib/core/contract/project-device-keys.d.ts +9 -0
  193. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  194. package/dist-lib/lib/core/contract/project-host-keys.d.ts +9 -0
  195. package/dist-lib/lib/core/contract/project-host-keys.js +52 -0
  196. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  197. package/dist-lib/lib/core/contract/project-order.js +25 -0
  198. package/dist-lib/lib/core/contract/projects.d.ts +23 -0
  199. package/dist-lib/lib/core/contract/projects.js +339 -0
  200. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  201. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  202. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  203. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  204. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  205. package/dist-lib/lib/core/contract/roles.js +123 -0
  206. package/dist-lib/lib/core/contract/run-requests.d.ts +11 -0
  207. package/dist-lib/lib/core/contract/run-requests.js +114 -0
  208. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  209. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  210. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  211. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  212. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  213. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  214. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  215. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  216. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  217. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  218. package/dist-lib/lib/core/contract/workspace.js +311 -0
  219. package/dist-lib/lib/core/contract/writers.js +100 -16
  220. package/dist-lib/lib/core/deleted-agent-runs.d.ts +8 -0
  221. package/dist-lib/lib/core/deleted-agent-runs.js +57 -0
  222. package/dist-lib/lib/core/departures.d.ts +18 -5
  223. package/dist-lib/lib/core/departures.js +82 -6
  224. package/dist-lib/lib/core/device-control.d.ts +21 -0
  225. package/dist-lib/lib/core/device-control.js +91 -0
  226. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  227. package/dist-lib/lib/core/device-seal.js +22 -0
  228. package/dist-lib/lib/core/devices.d.ts +2 -1
  229. package/dist-lib/lib/core/devices.js +6 -11
  230. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  231. package/dist-lib/lib/core/document-attachment.js +14 -0
  232. package/dist-lib/lib/core/files/attachments.d.ts +2 -0
  233. package/dist-lib/lib/core/files/attachments.js +23 -7
  234. package/dist-lib/lib/core/files/index.d.ts +28 -15
  235. package/dist-lib/lib/core/files/index.js +222 -43
  236. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  237. package/dist-lib/lib/core/files/knowledge.js +77 -5
  238. package/dist-lib/lib/core/files/preview/index.js +6 -2
  239. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  240. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  241. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  242. package/dist-lib/lib/core/files/processing/document.js +26 -2
  243. package/dist-lib/lib/core/files/processing/index.d.ts +12 -3
  244. package/dist-lib/lib/core/files/processing/index.js +122 -73
  245. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  246. package/dist-lib/lib/core/files/processing/protocol.js +27 -37
  247. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  248. package/dist-lib/lib/core/files/processing/source.js +12 -4
  249. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  250. package/dist-lib/lib/core/files/processing/state.js +9 -1
  251. package/dist-lib/lib/core/files/rag/build.d.ts +15 -2
  252. package/dist-lib/lib/core/files/rag/build.js +119 -21
  253. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  254. package/dist-lib/lib/core/files/rag/failure.js +58 -0
  255. package/dist-lib/lib/core/files/rag/index.d.ts +21 -5
  256. package/dist-lib/lib/core/files/rag/index.js +38 -9
  257. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  258. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  259. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  260. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  261. package/dist-lib/lib/core/files/rag/load.d.ts +3 -3
  262. package/dist-lib/lib/core/files/rag/load.js +6 -3
  263. package/dist-lib/lib/core/files/rag/plugin-index.d.ts +32 -0
  264. package/dist-lib/lib/core/files/rag/plugin-index.js +120 -0
  265. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  266. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  267. package/dist-lib/lib/core/files/rag/produce.d.ts +3 -4
  268. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  269. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  270. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  271. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  272. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  273. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  274. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  275. package/dist-lib/lib/core/files/records/index.js +1 -1
  276. package/dist-lib/lib/core/files/records/knowledge.d.ts +12 -4
  277. package/dist-lib/lib/core/files/records/knowledge.js +34 -30
  278. package/dist-lib/lib/core/files/records/purge.js +13 -8
  279. package/dist-lib/lib/core/files/records/reclaim.js +21 -55
  280. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  281. package/dist-lib/lib/core/files/records/routing.js +6 -2
  282. package/dist-lib/lib/core/files/records/source.js +3 -5
  283. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  284. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  285. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  286. package/dist-lib/lib/core/files/store/blob.js +2 -2
  287. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  288. package/dist-lib/lib/core/files/store/index.js +4 -1
  289. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  290. package/dist-lib/lib/core/files/store/reference.js +12 -2
  291. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  292. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  293. package/dist-lib/lib/core/files/upload.js +117 -51
  294. package/dist-lib/lib/core/first-event.d.ts +6 -0
  295. package/dist-lib/lib/core/first-event.js +13 -0
  296. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  297. package/dist-lib/lib/core/fs-drives.js +35 -35
  298. package/dist-lib/lib/core/helpers/index.d.ts +1 -1
  299. package/dist-lib/lib/core/helpers/index.js +2 -2
  300. package/dist-lib/lib/core/id.d.ts +1 -0
  301. package/dist-lib/lib/core/id.js +3 -0
  302. package/dist-lib/lib/core/identity.d.ts +3 -1
  303. package/dist-lib/lib/core/identity.js +25 -4
  304. package/dist-lib/lib/core/invite.d.ts +6 -2
  305. package/dist-lib/lib/core/invite.js +22 -8
  306. package/dist-lib/lib/core/local/files.d.ts +2 -1
  307. package/dist-lib/lib/core/local/files.js +5 -7
  308. package/dist-lib/lib/core/local/index.d.ts +93 -8
  309. package/dist-lib/lib/core/local/index.js +327 -28
  310. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  311. package/dist-lib/lib/core/local/run-logs.js +132 -0
  312. package/dist-lib/lib/core/member-key.d.ts +7 -0
  313. package/dist-lib/lib/core/member-key.js +24 -0
  314. package/dist-lib/lib/core/membership.d.ts +3 -14
  315. package/dist-lib/lib/core/membership.js +3 -96
  316. package/dist-lib/lib/core/mesh.d.ts +132 -29
  317. package/dist-lib/lib/core/mesh.js +775 -215
  318. package/dist-lib/lib/core/migrations/agent-catalog.js +2 -8
  319. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  320. package/dist-lib/lib/core/migrations/agent-tools-scope.js +18 -0
  321. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  322. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  323. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  324. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  325. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  326. package/dist-lib/lib/core/migrations/index.js +69 -8
  327. package/dist-lib/lib/core/migrations/writer-links.d.ts +3 -0
  328. package/dist-lib/lib/core/migrations/writer-links.js +30 -0
  329. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  330. package/dist-lib/lib/core/model-requests.js +65 -0
  331. package/dist-lib/lib/core/next-frame.js +2 -1
  332. package/dist-lib/lib/core/notification.js +100 -25
  333. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  334. package/dist-lib/lib/core/pdf/figure.js +64 -0
  335. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  336. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  337. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  338. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  339. package/dist-lib/lib/core/project-keys.d.ts +16 -0
  340. package/dist-lib/lib/core/project-keys.js +65 -0
  341. package/dist-lib/lib/core/prompt-history.js +4 -4
  342. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  343. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  344. package/dist-lib/lib/core/public-mesh.d.ts +25 -0
  345. package/dist-lib/lib/core/public-mesh.js +81 -0
  346. package/dist-lib/lib/core/purge.d.ts +3 -0
  347. package/dist-lib/lib/core/purge.js +7 -0
  348. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  349. package/dist-lib/lib/core/run-driver.js +20 -0
  350. package/dist-lib/lib/core/run-requests.d.ts +14 -0
  351. package/dist-lib/lib/core/run-requests.js +78 -0
  352. package/dist-lib/lib/core/send.d.ts +2 -0
  353. package/dist-lib/lib/core/send.js +17 -4
  354. package/dist-lib/lib/core/senders.d.ts +19 -0
  355. package/dist-lib/lib/core/senders.js +45 -0
  356. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  357. package/dist-lib/lib/core/shared-agents.js +283 -0
  358. package/dist-lib/lib/core/skill-availability.d.ts +33 -0
  359. package/dist-lib/lib/core/skill-availability.js +67 -0
  360. package/dist-lib/lib/core/skill-secrets.d.ts +13 -18
  361. package/dist-lib/lib/core/skill-secrets.js +93 -72
  362. package/dist-lib/lib/core/sync/background.d.ts +34 -0
  363. package/dist-lib/lib/core/sync/background.js +86 -0
  364. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  365. package/dist-lib/lib/core/sync/changed.js +7 -0
  366. package/dist-lib/lib/core/sync/devices.js +6 -3
  367. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  368. package/dist-lib/lib/core/sync/files.js +50 -72
  369. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  370. package/dist-lib/lib/core/sync/index.js +193 -81
  371. package/dist-lib/lib/core/sync/view-updates.d.ts +39 -0
  372. package/dist-lib/lib/core/sync/view-updates.js +124 -0
  373. package/dist-lib/lib/core/sync-status.js +99 -43
  374. package/dist-lib/lib/core/system-info.d.ts +2 -2
  375. package/dist-lib/lib/core/system-info.js +10 -11
  376. package/dist-lib/lib/core/tool-activity.js +6 -12
  377. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  378. package/dist-lib/lib/core/tool-configs.js +27 -39
  379. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  380. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  381. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  382. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  383. package/dist-lib/lib/core/upgrade-summary.d.ts +19 -0
  384. package/dist-lib/lib/core/upgrade-summary.js +67 -0
  385. package/dist-lib/lib/core/vault-managed-skills.d.ts +18 -0
  386. package/dist-lib/lib/core/vault-managed-skills.js +105 -0
  387. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  388. package/dist-lib/lib/core/video/attachment.js +7 -0
  389. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  390. package/dist-lib/lib/core/video/digest.js +57 -0
  391. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  392. package/dist-lib/lib/core/video/frames.js +224 -0
  393. package/dist-lib/lib/core/view-read.d.ts +4 -0
  394. package/dist-lib/lib/core/view-read.js +23 -0
  395. package/dist-lib/lib/core/workspace-upgrade.d.ts +23 -0
  396. package/dist-lib/lib/core/workspace-upgrade.js +51 -0
  397. package/dist-lib/lib/core.d.ts +345 -88
  398. package/dist-lib/lib/core.js +4275 -1513
  399. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  400. package/dist-lib/lib/credential-pusher.js +111 -62
  401. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  402. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  403. package/dist-lib/lib/custom-model-task.js +2 -2
  404. package/dist-lib/lib/device-tree.d.ts +18 -0
  405. package/dist-lib/lib/device-tree.js +32 -0
  406. package/dist-lib/lib/diagnostics.d.ts +7 -0
  407. package/dist-lib/lib/diagnostics.js +22 -0
  408. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  409. package/dist-lib/lib/doctor/checks.js +272 -0
  410. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  411. package/dist-lib/lib/doctor/redact.js +31 -0
  412. package/dist-lib/lib/doctor/render.d.ts +8 -0
  413. package/dist-lib/lib/doctor/render.js +83 -0
  414. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  415. package/dist-lib/lib/doctor/tree.js +167 -0
  416. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  417. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  418. package/dist-lib/lib/errors.d.ts +814 -0
  419. package/dist-lib/lib/errors.js +748 -0
  420. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  421. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  422. package/dist-lib/lib/guards.d.ts +1 -0
  423. package/dist-lib/lib/guards.js +4 -0
  424. package/dist-lib/lib/inference-calls.d.ts +1 -2
  425. package/dist-lib/lib/inference-calls.js +2 -10
  426. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  427. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  428. package/dist-lib/lib/knowledge-search.js +5 -51
  429. package/dist-lib/lib/kv-cache-ledger.d.ts +22 -0
  430. package/dist-lib/lib/kv-cache-ledger.js +72 -0
  431. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  432. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  433. package/dist-lib/lib/kv-cache-retention.d.ts +36 -0
  434. package/dist-lib/lib/kv-cache-retention.js +101 -0
  435. package/dist-lib/lib/latest-frame.d.ts +10 -0
  436. package/dist-lib/lib/latest-frame.js +48 -0
  437. package/dist-lib/lib/llm-model-names.d.ts +1 -1
  438. package/dist-lib/lib/llm-model-names.js +1 -1
  439. package/dist-lib/lib/log.d.ts +7 -6
  440. package/dist-lib/lib/log.js +14 -7
  441. package/dist-lib/lib/logger-type.d.ts +2 -5
  442. package/dist-lib/lib/mesh-scoped-engine.js +47 -2
  443. package/dist-lib/lib/model-context.js +1 -2
  444. package/dist-lib/lib/model-download-status.d.ts +3 -3
  445. package/dist-lib/lib/model-download.d.ts +22 -13
  446. package/dist-lib/lib/model-download.js +106 -37
  447. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  448. package/dist-lib/lib/model-memory-cap.d.ts +30 -0
  449. package/dist-lib/lib/model-memory-cap.js +78 -0
  450. package/dist-lib/lib/models-watch.d.ts +1 -1
  451. package/dist-lib/lib/models-watch.js +4 -4
  452. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  453. package/dist-lib/lib/oauth/flow-core.js +5 -3
  454. package/dist-lib/lib/oauth/flow.js +1 -1
  455. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  456. package/dist-lib/lib/oauth/loopback.js +57 -12
  457. package/dist-lib/lib/oauth/providers.js +4 -2
  458. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  459. package/dist-lib/lib/oauth/register.js +35 -19
  460. package/dist-lib/lib/oauth/request.d.ts +10 -0
  461. package/dist-lib/lib/oauth/request.js +22 -0
  462. package/dist-lib/lib/oauth/resolve.js +42 -13
  463. package/dist-lib/lib/oauth/token-exchange-core.js +40 -31
  464. package/dist-lib/lib/oauth/types.d.ts +3 -0
  465. package/dist-lib/lib/oauth.d.ts +2 -1
  466. package/dist-lib/lib/oauth.js +1 -0
  467. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  468. package/dist-lib/lib/persistent-dir.js +9 -0
  469. package/dist-lib/lib/probe-rounds.d.ts +8 -0
  470. package/dist-lib/lib/probe-rounds.js +10 -0
  471. package/dist-lib/lib/reconnecting-watch.js +19 -11
  472. package/dist-lib/lib/run-input.d.ts +14 -0
  473. package/dist-lib/lib/run-input.js +33 -0
  474. package/dist-lib/lib/run-notices.d.ts +5 -0
  475. package/dist-lib/lib/run-notices.js +13 -2
  476. package/dist-lib/lib/run-replay.d.ts +45 -0
  477. package/dist-lib/lib/run-replay.js +169 -0
  478. package/dist-lib/lib/run-transcript.d.ts +13 -12
  479. package/dist-lib/lib/run-transcript.js +20 -19
  480. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  481. package/dist-lib/lib/task.js +6 -4
  482. package/dist-lib/lib/test-env.d.ts +1 -0
  483. package/dist-lib/lib/test-env.js +4 -0
  484. package/dist-lib/schema/build.js +66 -55
  485. package/dist-lib/schema/config.d.ts +1 -1
  486. package/dist-lib/schema/config.js +1 -1
  487. package/dist-lib/schema/content.d.ts +5 -1
  488. package/dist-lib/schema/content.js +60 -12
  489. package/dist-lib/schema/engine.d.ts +1 -0
  490. package/dist-lib/schema/engine.js +941 -152
  491. package/dist-lib/schema/field-order.js +8 -1
  492. package/dist-lib/schema/indexes.d.ts +10 -0
  493. package/dist-lib/schema/indexes.js +53 -3
  494. package/dist-lib/schema/local.js +83 -5
  495. package/dist-lib/schema/qvac.d.ts +4 -1
  496. package/dist-lib/schema/qvac.js +558 -16
  497. package/dist-lib/spec/bind.js +261 -48
  498. package/dist-lib/spec/calls.js +56 -5
  499. package/dist-lib/spec/capabilities.d.ts +129 -20
  500. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  501. package/dist-lib/spec/hrpc/hrpc.json +870 -207
  502. package/dist-lib/spec/hrpc/index.js +969 -347
  503. package/dist-lib/spec/hrpc/messages.js +7590 -4896
  504. package/dist-lib/spec/hyperschema/index.js +7590 -4896
  505. package/dist-lib/spec/hyperschema/schema.json +5316 -3224
  506. package/dist-lib/spec/hyperschema/types.d.ts +576 -62
  507. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  508. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  509. package/dist-lib/spec/local/hyperdb/messages.js +1588 -488
  510. package/dist-lib/spec/local/hyperschema/index.js +584 -16
  511. package/dist-lib/spec/local/hyperschema/schema.json +369 -1
  512. package/dist-lib/spec/local/hyperschema/types.d.ts +88 -2
  513. package/dist-lib/spec/mesh/hyperdb/db.json +711 -9
  514. package/dist-lib/spec/mesh/hyperdb/index.js +2769 -7
  515. package/dist-lib/spec/mesh/hyperdb/messages.js +7140 -1298
  516. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +205 -1
  517. package/dist-lib/spec/mesh/hyperdispatch/index.js +579 -1
  518. package/dist-lib/spec/mesh/hyperdispatch/messages.js +4017 -267
  519. package/dist-lib/spec/mesh/hyperschema/index.js +4017 -267
  520. package/dist-lib/spec/mesh/hyperschema/schema.json +2193 -19
  521. package/dist-lib/spec/mesh/hyperschema/types.d.ts +550 -6
  522. package/package.json +136 -90
  523. package/tui/README.md +119 -20
  524. package/tui/app.mjs +2000 -621
  525. package/tui/boot.mjs +76 -9
  526. package/tui/cli.mjs +93 -0
  527. package/tui/index.mjs +2 -51
  528. package/tui/lib/connect-sheet.mjs +350 -0
  529. package/tui/lib/device-target.mjs +64 -0
  530. package/tui/lib/folders-command.mjs +84 -0
  531. package/tui/lib/fork-command.mjs +43 -0
  532. package/tui/lib/knowledge-import.mjs +3 -21
  533. package/tui/lib/local-path.mjs +21 -0
  534. package/tui/lib/move-command.mjs +17 -0
  535. package/tui/lib/render.mjs +30 -1
  536. package/tui/lib/setup.mjs +59 -25
  537. package/tui/lib/skill-connect.mjs +145 -0
  538. package/tui/lib/updater.mjs +86 -0
  539. package/tui/main.mjs +44 -18
  540. package/tui/plugins.mjs +158 -0
  541. package/worker/assistant-sidecar.mjs +28 -4
  542. package/worker/stow-entry.mjs +3 -50
  543. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  544. package/dist-lib/lib/core/contract/compute.js +0 -48
  545. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  546. package/dist-lib/lib/core/device-invites.js +0 -63
  547. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  548. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  549. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  550. package/dist-lib/lib/core/grant-expiry.js +0 -66
  551. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  552. package/dist-lib/lib/core/handoff-channel.js +0 -123
  553. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  554. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  555. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  556. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  557. package/dist-lib/lib/core/hosted-agents.js +0 -140
  558. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  559. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  560. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  561. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  562. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  563. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  564. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  565. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  566. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  567. package/dist-lib/lib/core/secret-handoff.js +0 -29
  568. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  569. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  570. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  571. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  572. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  573. package/dist-lib/lib/image-cache-dir.js +0 -5
  574. package/dist-lib/lib/log-levels.d.ts +0 -7
  575. package/dist-lib/lib/log-levels.js +0 -1
  576. package/dist-lib/lib/logger.d.ts +0 -5
  577. package/dist-lib/lib/logger.js +0 -18
  578. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  579. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
@@ -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>;
@@ -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,7 @@
1
1
  import { scopedKey } from './keys.js';
2
+ import { isCoreError } from '../errors.js';
2
3
  export const REFRESH_SKEW_MS = 60_000;
3
- const inFlightRefresh = new Map();
4
+ const inFlightRefresh = new WeakMap();
4
5
  export async function resolveOAuthCredential(opts) {
5
6
  const { engine, agentId, credentialKey, stateKey, refresh, requireClientSecret = false } = opts;
6
7
  const { value: token } = await engine.configGet({ key: scopedKey(agentId, credentialKey) });
@@ -28,17 +29,29 @@ export async function resolveOAuthCredential(opts) {
28
29
  if (typeof expiresAt !== 'number' || expiresAt - REFRESH_SKEW_MS > Date.now()) {
29
30
  return token;
30
31
  }
31
- const refreshKey = `${credentialKey}:${agentId ?? ''}`;
32
+ const refreshKey = JSON.stringify([
33
+ scopedKey(agentId, credentialKey),
34
+ scopedKey(agentId, stateKey)
35
+ ]);
32
36
  try {
33
- let pending = inFlightRefresh.get(refreshKey);
37
+ let engineRefreshes = inFlightRefresh.get(engine);
38
+ if (!engineRefreshes) {
39
+ engineRefreshes = new Map();
40
+ inFlightRefresh.set(engine, engineRefreshes);
41
+ }
42
+ let pending = engineRefreshes.get(refreshKey);
34
43
  if (!pending) {
35
44
  pending = (async () => {
36
- const refreshed = await refresh({
37
- clientId,
38
- clientSecret,
39
- refreshToken,
40
- fetch: opts.fetch
41
- });
45
+ let refreshed;
46
+ try {
47
+ refreshed = await refresh({ clientId, clientSecret, refreshToken, fetch: opts.fetch });
48
+ }
49
+ catch (err) {
50
+ if (isCoreError(err, 'OAUTH_GRANT_REVOKED')) {
51
+ await forgetGrant(opts, refreshToken);
52
+ }
53
+ throw err;
54
+ }
42
55
  await engine.configSet({
43
56
  key: scopedKey(agentId, credentialKey),
44
57
  value: refreshed.accessToken
@@ -52,12 +65,28 @@ export async function resolveOAuthCredential(opts) {
52
65
  })
53
66
  });
54
67
  return refreshed.accessToken;
55
- })().finally(() => inFlightRefresh.delete(refreshKey));
56
- inFlightRefresh.set(refreshKey, pending);
68
+ })().finally(() => engineRefreshes?.delete(refreshKey));
69
+ engineRefreshes.set(refreshKey, pending);
57
70
  }
58
71
  return await pending;
59
72
  }
60
- catch {
61
- return token;
73
+ catch (err) {
74
+ return isCoreError(err, 'OAUTH_GRANT_REVOKED') ? null : token;
75
+ }
76
+ }
77
+ async function forgetGrant({ engine, agentId, credentialKey, stateKey }, deadRefreshToken) {
78
+ const { value: raw } = await engine.configGet({ key: scopedKey(agentId, stateKey) });
79
+ let current = {};
80
+ try {
81
+ current = (typeof raw === 'string' && JSON.parse(raw)) || {};
82
+ }
83
+ catch { }
84
+ if (current.refreshToken !== deadRefreshToken) {
85
+ return;
62
86
  }
87
+ await engine.configSet({ key: scopedKey(agentId, credentialKey), value: '' });
88
+ await engine.configSet({
89
+ key: scopedKey(agentId, stateKey),
90
+ value: JSON.stringify({ ...current, refreshToken: undefined, expiresAt: undefined })
91
+ });
63
92
  }
@@ -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,23 +78,29 @@ 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
+ if (isInvalidGrant(text)) {
90
+ throw new CoreError('OAUTH_GRANT_REVOKED');
91
+ }
92
+ throw new CoreError('OAUTH_TOKEN_REFRESH_FAILED', [response.status, text]);
93
+ }
94
+ return toTokens(parseTokenResponse(await response.json()), refreshToken);
90
95
  }
91
- return toTokens(parseTokenResponse(await response.json()), refreshToken);
96
+ });
97
+ }
98
+ function isInvalidGrant(text) {
99
+ try {
100
+ return TokenErrorSchema.safeParse(JSON.parse(text)).data?.error === 'invalid_grant';
92
101
  }
93
- finally {
94
- globalThis.clearTimeout(timeout);
102
+ catch {
103
+ return false;
95
104
  }
96
105
  }
97
106
  export function isTokenExpired(record, bufferMs = 60_000) {
@@ -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,8 @@
1
+ export declare const MEDIA_KINDS: readonly ['image', 'music'];
2
+ declare const TEXT_KINDS: readonly ['fold', 'title', 'suggestion'];
3
+ export declare const PROBE_KINDS: readonly ["fold", "title", "suggestion", "image", "music"];
4
+ export type ProbeKind = (typeof TEXT_KINDS)[number];
5
+ export type MediaKind = (typeof MEDIA_KINDS)[number];
6
+ export declare function isProbeRound(options: unknown): boolean;
7
+ export declare function isMediaRound(options: unknown): boolean;
8
+ export {};
@@ -0,0 +1,10 @@
1
+ import { isRecord } from './guards.js';
2
+ export const MEDIA_KINDS = ['image', 'music'];
3
+ const TEXT_KINDS = ['fold', 'title', 'suggestion'];
4
+ export const PROBE_KINDS = [...TEXT_KINDS, ...MEDIA_KINDS];
5
+ export function isProbeRound(options) {
6
+ return isRecord(options) && PROBE_KINDS.some((kind) => kind === options.kind);
7
+ }
8
+ export function isMediaRound(options) {
9
+ return isRecord(options) && MEDIA_KINDS.some((kind) => kind === options.kind);
10
+ }
@@ -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
+ }