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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (509) hide show
  1. package/CHANGELOG.md +852 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +0 -1
  4. package/dist-lib/index.js +0 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +7 -0
  17. package/dist-lib/lib/api/chunk-delta.js +33 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +64 -13
  20. package/dist-lib/lib/api/config.d.ts +2 -1
  21. package/dist-lib/lib/api/config.js +3 -2
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +10 -8
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +20 -10
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  35. package/dist-lib/lib/api/host-run-log.js +35 -83
  36. package/dist-lib/lib/api/index.d.ts +28 -6
  37. package/dist-lib/lib/api/index.js +101 -33
  38. package/dist-lib/lib/api/instrument.d.ts +2 -2
  39. package/dist-lib/lib/api/instrument.js +12 -44
  40. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  41. package/dist-lib/lib/api/knowledge.js +25 -7
  42. package/dist-lib/lib/api/local-files.d.ts +5 -1
  43. package/dist-lib/lib/api/local-files.js +9 -5
  44. package/dist-lib/lib/api/logs.js +3 -3
  45. package/dist-lib/lib/api/members.d.ts +10 -1
  46. package/dist-lib/lib/api/members.js +64 -17
  47. package/dist-lib/lib/api/mesh.d.ts +12 -2
  48. package/dist-lib/lib/api/mesh.js +10 -6
  49. package/dist-lib/lib/api/model-download.d.ts +2 -1
  50. package/dist-lib/lib/api/model-download.js +2 -2
  51. package/dist-lib/lib/api/network.d.ts +10 -2
  52. package/dist-lib/lib/api/network.js +8 -2
  53. package/dist-lib/lib/api/notifications.d.ts +3 -1
  54. package/dist-lib/lib/api/notifications.js +6 -5
  55. package/dist-lib/lib/api/projects.d.ts +20 -0
  56. package/dist-lib/lib/api/projects.js +165 -0
  57. package/dist-lib/lib/api/rag.d.ts +0 -1
  58. package/dist-lib/lib/api/rag.js +47 -23
  59. package/dist-lib/lib/api/served.d.ts +17 -0
  60. package/dist-lib/lib/api/served.js +47 -0
  61. package/dist-lib/lib/api/sync.d.ts +2 -1
  62. package/dist-lib/lib/api/sync.js +2 -2
  63. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  64. package/dist-lib/lib/api/tool-activity.js +4 -3
  65. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-configs.js +6 -9
  67. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  68. package/dist-lib/lib/api/upload-frames.js +0 -1
  69. package/dist-lib/lib/api/watchable.d.ts +3 -2
  70. package/dist-lib/lib/api/watchable.js +2 -3
  71. package/dist-lib/lib/api/workspace.d.ts +5 -0
  72. package/dist-lib/lib/api/workspace.js +48 -0
  73. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  74. package/dist-lib/lib/assistant/fake-models.js +112 -0
  75. package/dist-lib/lib/assistant/harness.d.ts +29 -29
  76. package/dist-lib/lib/assistant/harness.js +34 -6
  77. package/dist-lib/lib/assistant/history.d.ts +30 -17
  78. package/dist-lib/lib/assistant/history.js +168 -82
  79. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  80. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  81. package/dist-lib/lib/assistant/message.d.ts +21 -0
  82. package/dist-lib/lib/assistant/message.js +43 -0
  83. package/dist-lib/lib/assistant/model-round.d.ts +95 -0
  84. package/dist-lib/lib/assistant/model-round.js +591 -0
  85. package/dist-lib/lib/assistant/pdf-budget.d.ts +3 -0
  86. package/dist-lib/lib/assistant/pdf-budget.js +13 -0
  87. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  88. package/dist-lib/lib/assistant/round-host.js +239 -0
  89. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  90. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  91. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  92. package/dist-lib/lib/assistant/video-budget.js +29 -0
  93. package/dist-lib/lib/assistant-client.d.ts +2 -0
  94. package/dist-lib/lib/assistant-client.js +4 -3
  95. package/dist-lib/lib/assistant-tree.d.ts +8 -3
  96. package/dist-lib/lib/assistant-tree.js +58 -18
  97. package/dist-lib/lib/assistant.d.ts +76 -20
  98. package/dist-lib/lib/assistant.js +1659 -1070
  99. package/dist-lib/lib/audio-format.js +1 -1
  100. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  101. package/dist-lib/lib/chat-suggestion.js +47 -0
  102. package/dist-lib/lib/client.d.ts +2 -2
  103. package/dist-lib/lib/constants.d.ts +7 -0
  104. package/dist-lib/lib/constants.js +7 -0
  105. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  106. package/dist-lib/lib/core/agent-copies.js +40 -0
  107. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  108. package/dist-lib/lib/core/agent-hosting.js +71 -0
  109. package/dist-lib/lib/core/agent.d.ts +9 -1
  110. package/dist-lib/lib/core/agent.js +45 -19
  111. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  112. package/dist-lib/lib/core/archived-mesh.js +77 -58
  113. package/dist-lib/lib/core/async-iterable.js +1 -1
  114. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  115. package/dist-lib/lib/core/blind-peers.js +1 -0
  116. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  117. package/dist-lib/lib/core/chat-activity.js +36 -22
  118. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  119. package/dist-lib/lib/core/chat-copy.js +395 -0
  120. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  121. package/dist-lib/lib/core/chat-fork.js +245 -0
  122. package/dist-lib/lib/core/chat-group.js +8 -7
  123. package/dist-lib/lib/core/chat-move.d.ts +71 -0
  124. package/dist-lib/lib/core/chat-move.js +567 -0
  125. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  126. package/dist-lib/lib/core/chat-order.js +19 -4
  127. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  128. package/dist-lib/lib/core/chat-project.js +15 -0
  129. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  130. package/dist-lib/lib/core/chat-read.js +49 -0
  131. package/dist-lib/lib/core/chat-search.js +14 -12
  132. package/dist-lib/lib/core/chat.d.ts +34 -4
  133. package/dist-lib/lib/core/chat.js +122 -39
  134. package/dist-lib/lib/core/chunk.d.ts +21 -4
  135. package/dist-lib/lib/core/chunk.js +138 -23
  136. package/dist-lib/lib/core/collections.d.ts +28 -0
  137. package/dist-lib/lib/core/collections.js +28 -0
  138. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  139. package/dist-lib/lib/core/contract/agent-join.js +108 -0
  140. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  141. package/dist-lib/lib/core/contract/agents.js +141 -3
  142. package/dist-lib/lib/core/contract/chat.d.ts +1 -0
  143. package/dist-lib/lib/core/contract/chat.js +42 -3
  144. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  145. package/dist-lib/lib/core/contract/chunks.js +112 -35
  146. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  147. package/dist-lib/lib/core/contract/index.js +35 -11
  148. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  149. package/dist-lib/lib/core/contract/indexing.js +51 -7
  150. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  151. package/dist-lib/lib/core/contract/invites.js +18 -9
  152. package/dist-lib/lib/core/contract/joined-meshes.js +2 -1
  153. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  154. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  155. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  156. package/dist-lib/lib/core/contract/members.js +34 -4
  157. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  158. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  159. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  160. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  161. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  162. package/dist-lib/lib/core/contract/mesh-rules.js +31 -0
  163. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  164. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  165. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  166. package/dist-lib/lib/core/contract/model-requests.js +279 -0
  167. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  168. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  169. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  170. package/dist-lib/lib/core/contract/open-join.js +77 -0
  171. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  172. package/dist-lib/lib/core/contract/project-device-keys.js +29 -0
  173. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  174. package/dist-lib/lib/core/contract/project-host-keys.js +40 -0
  175. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/project-order.js +25 -0
  177. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  178. package/dist-lib/lib/core/contract/projects.js +328 -0
  179. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  180. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  181. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  182. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  183. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  184. package/dist-lib/lib/core/contract/roles.js +120 -0
  185. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  186. package/dist-lib/lib/core/contract/run-requests.js +75 -0
  187. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  188. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  189. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  190. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  191. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  192. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  193. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  194. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  195. package/dist-lib/lib/core/contract/workspace.js +317 -0
  196. package/dist-lib/lib/core/contract/writers.js +82 -12
  197. package/dist-lib/lib/core/departures.d.ts +16 -5
  198. package/dist-lib/lib/core/departures.js +79 -6
  199. package/dist-lib/lib/core/device-control.d.ts +21 -0
  200. package/dist-lib/lib/core/device-control.js +91 -0
  201. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  202. package/dist-lib/lib/core/device-seal.js +22 -0
  203. package/dist-lib/lib/core/devices.js +1 -1
  204. package/dist-lib/lib/core/document-attachment.d.ts +7 -0
  205. package/dist-lib/lib/core/document-attachment.js +9 -0
  206. package/dist-lib/lib/core/files/attachments.js +5 -4
  207. package/dist-lib/lib/core/files/index.d.ts +21 -11
  208. package/dist-lib/lib/core/files/index.js +114 -28
  209. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  210. package/dist-lib/lib/core/files/knowledge.js +77 -5
  211. package/dist-lib/lib/core/files/preview/index.js +6 -2
  212. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  213. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  214. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  215. package/dist-lib/lib/core/files/processing/document.js +26 -2
  216. package/dist-lib/lib/core/files/processing/index.d.ts +7 -2
  217. package/dist-lib/lib/core/files/processing/index.js +91 -71
  218. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  219. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  220. package/dist-lib/lib/core/files/processing/source.d.ts +3 -0
  221. package/dist-lib/lib/core/files/processing/source.js +9 -4
  222. package/dist-lib/lib/core/files/processing/state.d.ts +4 -1
  223. package/dist-lib/lib/core/files/processing/state.js +2 -1
  224. package/dist-lib/lib/core/files/rag/build.d.ts +4 -1
  225. package/dist-lib/lib/core/files/rag/build.js +18 -7
  226. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  227. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  228. package/dist-lib/lib/core/files/rag/index.d.ts +12 -1
  229. package/dist-lib/lib/core/files/rag/index.js +29 -7
  230. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  231. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  232. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  233. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  234. package/dist-lib/lib/core/files/rag/load.js +6 -3
  235. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  236. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  237. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  238. package/dist-lib/lib/core/files/rag/produce.js +30 -18
  239. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -1
  240. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  241. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  242. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  243. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  244. package/dist-lib/lib/core/files/records/index.js +1 -1
  245. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  246. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  247. package/dist-lib/lib/core/files/records/purge.js +13 -8
  248. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  249. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  250. package/dist-lib/lib/core/files/records/routing.js +6 -2
  251. package/dist-lib/lib/core/files/records/source.js +3 -5
  252. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  253. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  254. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  255. package/dist-lib/lib/core/files/store/blob.js +2 -2
  256. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  257. package/dist-lib/lib/core/files/store/index.js +4 -1
  258. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  259. package/dist-lib/lib/core/files/store/reference.js +12 -2
  260. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  261. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  262. package/dist-lib/lib/core/files/upload.js +53 -14
  263. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  264. package/dist-lib/lib/core/fs-drives.js +30 -18
  265. package/dist-lib/lib/core/id.d.ts +1 -0
  266. package/dist-lib/lib/core/id.js +3 -0
  267. package/dist-lib/lib/core/identity.d.ts +3 -1
  268. package/dist-lib/lib/core/identity.js +25 -4
  269. package/dist-lib/lib/core/invite.d.ts +4 -0
  270. package/dist-lib/lib/core/invite.js +19 -6
  271. package/dist-lib/lib/core/local/files.d.ts +2 -1
  272. package/dist-lib/lib/core/local/files.js +5 -7
  273. package/dist-lib/lib/core/local/index.d.ts +76 -6
  274. package/dist-lib/lib/core/local/index.js +209 -19
  275. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  276. package/dist-lib/lib/core/local/run-logs.js +132 -0
  277. package/dist-lib/lib/core/member-key.d.ts +7 -0
  278. package/dist-lib/lib/core/member-key.js +24 -0
  279. package/dist-lib/lib/core/membership.d.ts +3 -14
  280. package/dist-lib/lib/core/membership.js +3 -96
  281. package/dist-lib/lib/core/mesh.d.ts +94 -28
  282. package/dist-lib/lib/core/mesh.js +527 -144
  283. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  284. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  285. package/dist-lib/lib/core/migrations/file-index.js +2 -4
  286. package/dist-lib/lib/core/migrations/index.js +6 -2
  287. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  288. package/dist-lib/lib/core/model-requests.js +65 -0
  289. package/dist-lib/lib/core/next-frame.js +2 -1
  290. package/dist-lib/lib/core/notification.js +4 -2
  291. package/dist-lib/lib/core/pdf/rasterize.d.ts +2 -2
  292. package/dist-lib/lib/core/pdf/rasterize.js +5 -6
  293. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  294. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +47 -40
  295. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  296. package/dist-lib/lib/core/project-keys.js +56 -0
  297. package/dist-lib/lib/core/prompt-history.js +4 -4
  298. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  299. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  300. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  301. package/dist-lib/lib/core/public-mesh.js +88 -0
  302. package/dist-lib/lib/core/purge.d.ts +3 -0
  303. package/dist-lib/lib/core/purge.js +7 -0
  304. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  305. package/dist-lib/lib/core/run-driver.js +20 -0
  306. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  307. package/dist-lib/lib/core/run-requests.js +59 -0
  308. package/dist-lib/lib/core/send.d.ts +2 -0
  309. package/dist-lib/lib/core/send.js +17 -4
  310. package/dist-lib/lib/core/senders.d.ts +18 -0
  311. package/dist-lib/lib/core/senders.js +52 -0
  312. package/dist-lib/lib/core/shared-agents.d.ts +39 -0
  313. package/dist-lib/lib/core/shared-agents.js +255 -0
  314. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  315. package/dist-lib/lib/core/skill-secrets.js +90 -72
  316. package/dist-lib/lib/core/sync/background.d.ts +47 -0
  317. package/dist-lib/lib/core/sync/background.js +162 -0
  318. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  319. package/dist-lib/lib/core/sync/changed.js +7 -0
  320. package/dist-lib/lib/core/sync/devices.js +1 -1
  321. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  322. package/dist-lib/lib/core/sync/files.js +50 -72
  323. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  324. package/dist-lib/lib/core/sync/index.js +154 -81
  325. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  326. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  327. package/dist-lib/lib/core/system-info.d.ts +2 -2
  328. package/dist-lib/lib/core/system-info.js +10 -11
  329. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  330. package/dist-lib/lib/core/tool-configs.js +11 -11
  331. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  332. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  333. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  334. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  335. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  336. package/dist-lib/lib/core/video/attachment.js +7 -0
  337. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  338. package/dist-lib/lib/core/video/digest.js +57 -0
  339. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  340. package/dist-lib/lib/core/video/frames.js +224 -0
  341. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  342. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  343. package/dist-lib/lib/core.d.ts +249 -79
  344. package/dist-lib/lib/core.js +3369 -1460
  345. package/dist-lib/lib/credential-pusher.d.ts +6 -0
  346. package/dist-lib/lib/credential-pusher.js +77 -60
  347. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  348. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  349. package/dist-lib/lib/custom-model-task.js +2 -2
  350. package/dist-lib/lib/diagnostics.d.ts +7 -0
  351. package/dist-lib/lib/diagnostics.js +22 -0
  352. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  353. package/dist-lib/lib/doctor/checks.js +272 -0
  354. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  355. package/dist-lib/lib/doctor/redact.js +31 -0
  356. package/dist-lib/lib/doctor/render.d.ts +8 -0
  357. package/dist-lib/lib/doctor/render.js +83 -0
  358. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  359. package/dist-lib/lib/doctor/tree.js +167 -0
  360. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  361. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  362. package/dist-lib/lib/errors.d.ts +790 -0
  363. package/dist-lib/lib/errors.js +724 -0
  364. package/dist-lib/lib/fs-drive-bridge.d.ts +1 -1
  365. package/dist-lib/lib/fs-drive-bridge.js +4 -1
  366. package/dist-lib/lib/guards.d.ts +1 -0
  367. package/dist-lib/lib/guards.js +4 -0
  368. package/dist-lib/lib/inference-calls.d.ts +1 -2
  369. package/dist-lib/lib/inference-calls.js +2 -10
  370. package/dist-lib/lib/knowledge-search.js +13 -18
  371. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  372. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  373. package/dist-lib/lib/log.d.ts +7 -6
  374. package/dist-lib/lib/log.js +14 -7
  375. package/dist-lib/lib/logger-type.d.ts +2 -5
  376. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  377. package/dist-lib/lib/model-download-status.d.ts +3 -3
  378. package/dist-lib/lib/model-download.d.ts +11 -12
  379. package/dist-lib/lib/model-download.js +63 -22
  380. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  381. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  382. package/dist-lib/lib/model-memory-cap.js +69 -0
  383. package/dist-lib/lib/models-watch.d.ts +1 -1
  384. package/dist-lib/lib/models-watch.js +4 -4
  385. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  386. package/dist-lib/lib/oauth/flow-core.js +5 -3
  387. package/dist-lib/lib/oauth/flow.js +1 -1
  388. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  389. package/dist-lib/lib/oauth/loopback.js +57 -12
  390. package/dist-lib/lib/oauth/providers.js +4 -2
  391. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  392. package/dist-lib/lib/oauth/register.js +35 -19
  393. package/dist-lib/lib/oauth/request.d.ts +10 -0
  394. package/dist-lib/lib/oauth/request.js +22 -0
  395. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  396. package/dist-lib/lib/oauth/types.d.ts +3 -0
  397. package/dist-lib/lib/oauth.d.ts +2 -1
  398. package/dist-lib/lib/oauth.js +1 -0
  399. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  400. package/dist-lib/lib/persistent-dir.js +9 -0
  401. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  402. package/dist-lib/lib/probe-rounds.js +5 -0
  403. package/dist-lib/lib/run-input.d.ts +14 -0
  404. package/dist-lib/lib/run-input.js +33 -0
  405. package/dist-lib/lib/run-notices.d.ts +3 -0
  406. package/dist-lib/lib/run-notices.js +8 -2
  407. package/dist-lib/lib/run-replay.d.ts +32 -0
  408. package/dist-lib/lib/run-replay.js +121 -0
  409. package/dist-lib/lib/run-transcript.d.ts +11 -12
  410. package/dist-lib/lib/run-transcript.js +16 -18
  411. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  412. package/dist-lib/lib/task.js +6 -4
  413. package/dist-lib/lib/test-env.d.ts +1 -0
  414. package/dist-lib/lib/test-env.js +4 -0
  415. package/dist-lib/schema/build.js +3 -1
  416. package/dist-lib/schema/config.d.ts +1 -1
  417. package/dist-lib/schema/config.js +1 -1
  418. package/dist-lib/schema/content.d.ts +5 -1
  419. package/dist-lib/schema/content.js +58 -11
  420. package/dist-lib/schema/engine.d.ts +1 -0
  421. package/dist-lib/schema/engine.js +709 -116
  422. package/dist-lib/schema/field-order.js +2 -1
  423. package/dist-lib/schema/indexes.d.ts +3 -0
  424. package/dist-lib/schema/indexes.js +30 -3
  425. package/dist-lib/schema/local.js +72 -4
  426. package/dist-lib/schema/qvac.d.ts +4 -1
  427. package/dist-lib/schema/qvac.js +364 -12
  428. package/dist-lib/spec/bind.js +209 -48
  429. package/dist-lib/spec/calls.js +45 -5
  430. package/dist-lib/spec/capabilities.d.ts +98 -18
  431. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  432. package/dist-lib/spec/hrpc/hrpc.json +726 -206
  433. package/dist-lib/spec/hrpc/index.js +832 -345
  434. package/dist-lib/spec/hrpc/messages.js +6906 -4832
  435. package/dist-lib/spec/hyperschema/index.js +6906 -4832
  436. package/dist-lib/spec/hyperschema/schema.json +4744 -3139
  437. package/dist-lib/spec/hyperschema/types.d.ts +461 -61
  438. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  439. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  440. package/dist-lib/spec/local/hyperdb/messages.js +1506 -484
  441. package/dist-lib/spec/local/hyperschema/index.js +542 -13
  442. package/dist-lib/spec/local/hyperschema/schema.json +319 -1
  443. package/dist-lib/spec/local/hyperschema/types.d.ts +78 -2
  444. package/dist-lib/spec/mesh/hyperdb/db.json +371 -5
  445. package/dist-lib/spec/mesh/hyperdb/index.js +1564 -5
  446. package/dist-lib/spec/mesh/hyperdb/messages.js +6023 -1246
  447. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +187 -1
  448. package/dist-lib/spec/mesh/hyperdispatch/index.js +528 -1
  449. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3449 -217
  450. package/dist-lib/spec/mesh/hyperschema/index.js +3449 -217
  451. package/dist-lib/spec/mesh/hyperschema/schema.json +1865 -19
  452. package/dist-lib/spec/mesh/hyperschema/types.d.ts +470 -6
  453. package/package.json +50 -35
  454. package/worker/assistant-sidecar.mjs +15 -2
  455. package/worker/stow-entry.mjs +2 -0
  456. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  457. package/dist-lib/lib/core/contract/compute.js +0 -48
  458. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  459. package/dist-lib/lib/core/device-invites.js +0 -63
  460. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  461. package/dist-lib/lib/core/grant-expiry.js +0 -66
  462. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  463. package/dist-lib/lib/core/handoff-channel.js +0 -123
  464. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  465. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  466. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  467. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  468. package/dist-lib/lib/core/hosted-agents.js +0 -140
  469. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  470. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  471. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  472. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  473. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  474. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  475. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  476. package/dist-lib/lib/core/secret-handoff.js +0 -29
  477. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  478. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  479. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  480. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  481. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  482. package/dist-lib/lib/image-cache-dir.js +0 -5
  483. package/dist-lib/lib/log-levels.d.ts +0 -7
  484. package/dist-lib/lib/log-levels.js +0 -1
  485. package/dist-lib/lib/logger.d.ts +0 -5
  486. package/dist-lib/lib/logger.js +0 -18
  487. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  488. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  489. package/tui/README.md +0 -142
  490. package/tui/app.mjs +0 -6939
  491. package/tui/boot.mjs +0 -111
  492. package/tui/index.mjs +0 -53
  493. package/tui/lib/boot-timing.mjs +0 -41
  494. package/tui/lib/busy-words.mjs +0 -116
  495. package/tui/lib/export.mjs +0 -194
  496. package/tui/lib/knowledge-command.mjs +0 -190
  497. package/tui/lib/knowledge-import.mjs +0 -171
  498. package/tui/lib/render.mjs +0 -196
  499. package/tui/lib/save-file.mjs +0 -88
  500. package/tui/lib/select.mjs +0 -81
  501. package/tui/lib/selection.mjs +0 -18
  502. package/tui/lib/setup.mjs +0 -101
  503. package/tui/lib/sidebar.mjs +0 -63
  504. package/tui/lib/splash-art.mjs +0 -107
  505. package/tui/lib/splash.mjs +0 -18
  506. package/tui/lib/upload-frames.mjs +0 -9
  507. package/tui/lib/usage.mjs +0 -59
  508. package/tui/lib/wrap.mjs +0 -143
  509. package/tui/main.mjs +0 -264
@@ -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,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
+ }
@@ -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
+ }
@@ -5,12 +5,15 @@ export declare const RUN_ABORT_REASONS: {
5
5
  readonly runnerDied: 'runner-died';
6
6
  readonly runnerClosed: 'runner-closed';
7
7
  readonly modelUnloaded: 'model-unloaded';
8
+ readonly stalled: 'stalled';
8
9
  };
9
10
  export type RunAbortReason = (typeof RUN_ABORT_REASONS)[keyof typeof RUN_ABORT_REASONS];
10
11
  export declare const RUN_FAILURE_REASONS: {
11
12
  readonly harnessDied: 'the model runtime died';
12
13
  readonly runtimeEndedTurn: 'the model runtime ended this turn';
13
14
  readonly capabilityUnavailable: 'this device cannot run a capability without a model';
15
+ readonly stalled: 'the agent stopped responding';
16
+ readonly videoNeedsVision: 'this model cannot see video: switch to a model that reads images to ask about one';
14
17
  };
15
18
  export type AbortOutcome = {
16
19
  readonly kind: 'replay';
@@ -4,12 +4,15 @@ export const RUN_ABORT_REASONS = {
4
4
  runSettled: 'run-settled',
5
5
  runnerDied: 'runner-died',
6
6
  runnerClosed: 'runner-closed',
7
- modelUnloaded: 'model-unloaded'
7
+ modelUnloaded: 'model-unloaded',
8
+ stalled: 'stalled'
8
9
  };
9
10
  export const RUN_FAILURE_REASONS = {
10
11
  harnessDied: 'the model runtime died',
11
12
  runtimeEndedTurn: 'the model runtime ended this turn',
12
- capabilityUnavailable: 'this device cannot run a capability without a model'
13
+ capabilityUnavailable: 'this device cannot run a capability without a model',
14
+ stalled: 'the agent stopped responding',
15
+ videoNeedsVision: 'this model cannot see video: switch to a model that reads images to ask about one'
13
16
  };
14
17
  export function knownAbortOutcome(reason) {
15
18
  if (reason === RUN_ABORT_REASONS.suspended ||
@@ -23,6 +26,9 @@ export function knownAbortOutcome(reason) {
23
26
  if (reason === RUN_ABORT_REASONS.runnerDied) {
24
27
  return { kind: 'failed', reason: RUN_FAILURE_REASONS.harnessDied };
25
28
  }
29
+ if (reason === RUN_ABORT_REASONS.stalled) {
30
+ return { kind: 'failed', reason: RUN_FAILURE_REASONS.stalled };
31
+ }
26
32
  return null;
27
33
  }
28
34
  export function isLifecycleTeardown(reason) {
@@ -0,0 +1,32 @@
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 SentRun {
8
+ readonly messages: ChatMessage[];
9
+ readonly asked?: string | undefined;
10
+ }
11
+ export declare class RunReplayStore {
12
+ private readonly _dir;
13
+ constructor(dir: string);
14
+ started(): Promise<boolean>;
15
+ start(): Promise<void>;
16
+ load(chat: ReplayChat): Promise<Map<string, ChatMessage[]>>;
17
+ loadAsked(chat: ReplayChat): Promise<Map<string, string>>;
18
+ save({ holder, chatId }: ReplayChat, runId: string, { messages, asked }: SentRun): Promise<void>;
19
+ private _records;
20
+ forget(chatId: string, holder?: string): Promise<void>;
21
+ clear(holder: string): Promise<void>;
22
+ private _chatDir;
23
+ private _holders;
24
+ }
25
+ export interface SentRunTracker {
26
+ readonly used: boolean;
27
+ observe(call: Record<string, unknown>): void;
28
+ turns(inputLength: number): ChatMessage[] | null;
29
+ }
30
+ export declare function trackSentRun(cacheKey: string | undefined): SentRunTracker;
31
+ export declare function appendedTurns(sent: unknown, inputLength: number): ChatMessage[] | null;
32
+ export declare function isChatMessage(value: unknown): value is ChatMessage;
@@ -0,0 +1,121 @@
1
+ import fs from 'fs';
2
+ import { join } from 'path';
3
+ import { isRecord, safeName } from './guards.js';
4
+ export const LOCAL_HOLDER = 'local';
5
+ export class RunReplayStore {
6
+ _dir;
7
+ constructor(dir) {
8
+ this._dir = dir;
9
+ }
10
+ async started() {
11
+ try {
12
+ await fs.promises.stat(this._dir);
13
+ return true;
14
+ }
15
+ catch {
16
+ return false;
17
+ }
18
+ }
19
+ async start() {
20
+ await fs.promises.mkdir(this._dir, { recursive: true });
21
+ }
22
+ async load(chat) {
23
+ const runs = new Map();
24
+ for (const record of await this._records(chat)) {
25
+ if (Array.isArray(record.messages)) {
26
+ runs.set(record.runId, record.messages.filter(isChatMessage));
27
+ }
28
+ }
29
+ return runs;
30
+ }
31
+ async loadAsked(chat) {
32
+ const asked = new Map();
33
+ for (const record of await this._records(chat)) {
34
+ if (typeof record.asked === 'string') {
35
+ asked.set(record.runId, record.asked);
36
+ }
37
+ }
38
+ return asked;
39
+ }
40
+ async save({ holder, chatId }, runId, { messages, asked }) {
41
+ const chatDir = this._chatDir(holder, chatId);
42
+ await fs.promises.mkdir(chatDir, { recursive: true });
43
+ await fs.promises.writeFile(join(chatDir, `${safeName(runId)}.json`), JSON.stringify({ runId, messages, asked }));
44
+ }
45
+ async _records({ holder, chatId }) {
46
+ const chatDir = this._chatDir(holder, chatId);
47
+ let names;
48
+ try {
49
+ names = await fs.promises.readdir(chatDir);
50
+ }
51
+ catch {
52
+ return [];
53
+ }
54
+ const records = [];
55
+ for (const name of names) {
56
+ if (!name.endsWith('.json'))
57
+ continue;
58
+ const parsed = JSON.parse(await fs.promises.readFile(join(chatDir, name), 'utf8'));
59
+ if (isRecord(parsed) && typeof parsed.runId === 'string') {
60
+ records.push({ runId: parsed.runId, messages: parsed.messages, asked: parsed.asked });
61
+ }
62
+ }
63
+ return records;
64
+ }
65
+ async forget(chatId, holder) {
66
+ const holders = holder === undefined ? await this._holders() : [holder];
67
+ for (const each of holders) {
68
+ await fs.promises.rm(this._chatDir(each, chatId), { recursive: true, force: true });
69
+ }
70
+ }
71
+ async clear(holder) {
72
+ await fs.promises.rm(join(this._dir, safeName(holder)), { recursive: true, force: true });
73
+ }
74
+ _chatDir(holder, chatId) {
75
+ return join(this._dir, safeName(holder), safeName(chatId));
76
+ }
77
+ async _holders() {
78
+ try {
79
+ return await fs.promises.readdir(this._dir);
80
+ }
81
+ catch {
82
+ return [];
83
+ }
84
+ }
85
+ }
86
+ export function trackSentRun(cacheKey) {
87
+ let used = false;
88
+ let last = null;
89
+ return {
90
+ get used() {
91
+ return used;
92
+ },
93
+ observe(call) {
94
+ if (cacheKey && call.cacheKey === cacheKey) {
95
+ used = true;
96
+ last = call.droppedTurns ? null : call.messages;
97
+ }
98
+ else if (used) {
99
+ last = null;
100
+ }
101
+ },
102
+ turns: (inputLength) => appendedTurns(last, inputLength)
103
+ };
104
+ }
105
+ export function appendedTurns(sent, inputLength) {
106
+ if (!Array.isArray(sent))
107
+ return null;
108
+ const offset = (isRecord(sent[0]) && sent[0].role === 'system' ? 1 : 0) + inputLength;
109
+ if (sent.length < offset) {
110
+ return null;
111
+ }
112
+ const turns = sent
113
+ .slice(offset)
114
+ .map((turn) => (isRecord(turn) ? { role: turn.role, content: turn.content } : null));
115
+ return turns.every(isChatMessage) ? turns : null;
116
+ }
117
+ export function isChatMessage(value) {
118
+ return (isRecord(value) &&
119
+ (value.role === 'user' || value.role === 'assistant' || value.role === 'tool') &&
120
+ typeof value.content === 'string');
121
+ }
@@ -1,18 +1,16 @@
1
1
  import type { AssistantAppendChunkRequest, AssistantChunkId, AssistantChunkContentRunStatus } from '../spec/hyperschema/types.d.ts';
2
2
  import type { ScopedCapabilities } from './mesh-scoped-engine.ts';
3
- import type { Logger } from './log.ts';
3
+ import type { LoggerInterface } from '@qvac/logging';
4
4
  import { type PendingScope } from './write-queue.ts';
5
- export type TranscriptChunk = Pick<AssistantAppendChunkRequest, 'type' | 'toolCall' | 'toolResult' | 'sources' | 'effect' | 'display' | 'rawCall' | 'round' | 'callId' | 'roundReset'>;
6
- export type TranscriptResetType = 'content' | 'thinking';
7
- interface RunStatusOptions {
8
- resumed?: boolean;
9
- }
5
+ export type TranscriptChunk = Pick<AssistantAppendChunkRequest, 'type' | 'toolCall' | 'toolResult' | 'sources' | 'effect' | 'display' | 'rawCall' | 'round' | 'callId'>;
6
+ export type ReplacedType = 'content' | 'thinking';
10
7
  export interface RunTranscriptOptions {
11
8
  chatId: string;
12
9
  runId: string;
13
10
  deviceId: Buffer;
14
11
  model: string;
15
- log?: Logger | null;
12
+ parentId?: string;
13
+ log?: LoggerInterface | null;
16
14
  }
17
15
  export declare class RunTranscript {
18
16
  private readonly _engine;
@@ -20,21 +18,22 @@ export declare class RunTranscript {
20
18
  private readonly _runId;
21
19
  private readonly _deviceId;
22
20
  private readonly _model;
21
+ private readonly _parentId;
23
22
  private readonly _log;
24
23
  private readonly _writes;
25
24
  private readonly _ticker;
26
25
  private readonly _announced;
27
26
  private _buffered;
28
- private _round;
29
27
  constructor(engine: ScopedCapabilities, opts: RunTranscriptOptions);
30
- text(type: 'content' | 'thinking', text: string, round?: number): Promise<void>;
28
+ text(type: ReplacedType, text: string, round?: number): Promise<void>;
31
29
  chunk(chunk: TranscriptChunk): Promise<AssistantChunkId>;
32
- roundReset(round: number, replacedTypes?: ReadonlyArray<TranscriptResetType>): Promise<AssistantChunkId>;
33
- status(runStatus: AssistantChunkContentRunStatus, opts?: RunStatusOptions): Promise<AssistantChunkId>;
30
+ roundReset(round: number, replacedTypes: ReadonlyArray<ReplacedType>): Promise<void>;
31
+ status(runStatus: AssistantChunkContentRunStatus, { resumed }?: {
32
+ resumed?: boolean | undefined;
33
+ }): Promise<AssistantChunkId>;
34
34
  progress(id: string, runStatus: AssistantChunkContentRunStatus): Promise<unknown>;
35
35
  flush(): Promise<void>;
36
36
  pending(): Array<PendingScope>;
37
37
  close(): void;
38
38
  private _announce;
39
39
  }
40
- export {};
@@ -10,19 +10,20 @@ export class RunTranscript {
10
10
  _runId;
11
11
  _deviceId;
12
12
  _model;
13
+ _parentId;
13
14
  _log;
14
15
  _writes;
15
16
  _ticker;
16
17
  _announced = new Set();
17
18
  _buffered = null;
18
- _round = 0;
19
19
  constructor(engine, opts) {
20
- const { chatId, runId, deviceId, model, log } = opts;
20
+ const { chatId, runId, deviceId, model, parentId, log } = opts;
21
21
  this._engine = engine;
22
22
  this._chatId = chatId;
23
23
  this._runId = runId;
24
24
  this._deviceId = deviceId;
25
25
  this._model = model;
26
+ this._parentId = parentId;
26
27
  this._log = log ?? null;
27
28
  this._writes = new WriteQueue({
28
29
  slowMs: SLOW_WRITE_MS,
@@ -33,24 +34,19 @@ export class RunTranscript {
33
34
  }, FLUSH_INTERVAL_MS);
34
35
  }
35
36
  async text(type, text, round) {
36
- const activeRound = round ?? this._round;
37
- if (this._buffered && (this._buffered.type !== type || this._buffered.round !== activeRound)) {
37
+ if (this._buffered && (this._buffered.type !== type || this._buffered.round !== round)) {
38
38
  await this.flush();
39
39
  }
40
40
  if (!this._buffered) {
41
- this._buffered = { type, text: '', round: activeRound };
41
+ this._buffered = { type, text: '', round };
42
42
  this._announce(type);
43
43
  }
44
- this._round = activeRound;
45
44
  this._buffered.text += text;
46
45
  if (this._buffered.text.length >= COALESCE_CAP) {
47
46
  await this.flush();
48
47
  }
49
48
  }
50
49
  chunk(chunk) {
51
- if (typeof chunk.round === 'number') {
52
- this._round = chunk.round;
53
- }
54
50
  return this._writes.run(TRANSCRIPT, `append:${chunk.type}`, () => this._engine.appendChunk({
55
51
  chatId: this._chatId,
56
52
  runId: this._runId,
@@ -58,16 +54,18 @@ export class RunTranscript {
58
54
  ...chunk
59
55
  }));
60
56
  }
61
- async roundReset(round, replacedTypes = ['content', 'thinking']) {
57
+ async roundReset(round, replacedTypes) {
62
58
  await this.flush();
63
- this._round = round;
64
- return this.chunk({
59
+ await this._writes.run(TRANSCRIPT, 'append:round-reset', () => this._engine.appendChunk({
60
+ chatId: this._chatId,
61
+ runId: this._runId,
65
62
  type: 'round-reset',
66
63
  round,
67
- roundReset: { replacedTypes: [...new Set(replacedTypes)] }
68
- });
64
+ roundReset: { replacedTypes: [...replacedTypes] },
65
+ originDeviceId: this._deviceId
66
+ }));
69
67
  }
70
- status(runStatus, opts = {}) {
68
+ status(runStatus, { resumed = false } = {}) {
71
69
  this._log?.info('runs', `run ${runStatus.state}`, {
72
70
  runId: this._runId,
73
71
  chatId: this._chatId,
@@ -78,7 +76,7 @@ export class RunTranscript {
78
76
  runId: this._runId,
79
77
  type: 'run-status',
80
78
  runStatus: { ...runStatus, model: this._model },
81
- resumed: opts.resumed ? true : undefined,
79
+ resumed: resumed || undefined,
82
80
  originDeviceId: this._deviceId
83
81
  }));
84
82
  }
@@ -91,13 +89,13 @@ export class RunTranscript {
91
89
  return;
92
90
  const { type, text, round } = this._buffered;
93
91
  this._buffered = null;
94
- this._round = round ?? this._round;
95
92
  const started = Date.now();
96
93
  await this._engine.appendChunk({
97
94
  chatId: this._chatId,
98
95
  runId: this._runId,
99
96
  type,
100
- round: round ?? this._round,
97
+ round,
98
+ parentId: this._parentId,
101
99
  content: type === 'content' ? { text } : null,
102
100
  thinking: type === 'thinking' ? { text } : null,
103
101
  originDeviceId: this._deviceId
@@ -1,7 +1,14 @@
1
1
  import Suspendify from 'suspendify';
2
2
  export const ASSISTANT_WAKEUP_LINGER_MS = 6_000;
3
+ const SUSPENDIFY_TARGET_RESUME = 0;
3
4
  export function createAssistantSuspendLifecycle(supervisor, options = {}) {
4
5
  const { wakeupLinger = ASSISTANT_WAKEUP_LINGER_MS, pollLinger, onSuspended = noop } = options;
6
+ const resume = async () => {
7
+ if (!supervisor.opened) {
8
+ await supervisor.ready();
9
+ }
10
+ await supervisor.resume();
11
+ };
5
12
  const lifecycle = new Suspendify({
6
13
  wakeupLinger,
7
14
  pollLinger,
@@ -26,13 +33,16 @@ export function createAssistantSuspendLifecycle(supervisor, options = {}) {
26
33
  }
27
34
  await supervisor.wakeup();
28
35
  },
29
- resume: async () => {
30
- if (!supervisor.opened) {
31
- await supervisor.ready();
36
+ suspendCancelled: async () => {
37
+ if (resuming(lifecycle)) {
38
+ await resume();
32
39
  }
33
- await supervisor.resume();
34
- }
40
+ },
41
+ resume
35
42
  });
36
43
  return lifecycle;
37
44
  }
45
+ function resuming(lifecycle) {
46
+ return 'target' in lifecycle && lifecycle.target === SUSPENDIFY_TARGET_RESUME;
47
+ }
38
48
  function noop() { }
@@ -1,6 +1,8 @@
1
- const TERMINAL_STATES = new Set(['completed', 'failed', 'canceled']);
1
+ import { CoreError } from './errors.js';
2
2
  const SETTLED_STATES = new Set([
3
- ...TERMINAL_STATES,
3
+ 'completed',
4
+ 'failed',
5
+ 'canceled',
4
6
  'paused',
5
7
  'recovery-required'
6
8
  ]);
@@ -25,7 +27,7 @@ export async function runTask(engine, request) {
25
27
  return collect(chunks, { chatId, runId, state });
26
28
  }
27
29
  }
28
- throw new Error(`chunk stream ended before the run settled: ${chatId}`);
30
+ throw new CoreError('RUN_STREAM_ENDED', [chatId]);
29
31
  }
30
32
  function terminalState(chunks, runId) {
31
33
  for (const chunk of chunks) {
@@ -59,7 +61,7 @@ function collect(all, { chatId, runId, state }) {
59
61
  if (call) {
60
62
  toolCalls.push({ name: call.name, arguments: call.arguments });
61
63
  }
62
- if (chunk.attachment && !chunk.attachment.deletedAt) {
64
+ if (chunk.attachment && !chunk.attachment.deletedAt && !chunk.sourceId) {
63
65
  attachments.push(chunk.attachment);
64
66
  }
65
67
  if (chunk.sources) {
@@ -0,0 +1 @@
1
+ export declare function underTest(): boolean;
@@ -0,0 +1,4 @@
1
+ import process from 'process';
2
+ export function underTest() {
3
+ return Boolean(process.env.QVAC_TEST);
4
+ }