@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,591 @@
1
+ import b4a from 'b4a';
2
+ import { ToolSets } from '@qvac/harness';
3
+ import { AbortedError } from '@qvac/harness/race-abort';
4
+ import * as z from 'zod';
5
+ import { isRecord } from '../guards.js';
6
+ import { historyFromChunks, listHistoryChunks, replayFromChunks, runPromptView, sentTurn } from './history.js';
7
+ import { nameSenders, restoreSentContent } from './message.js';
8
+ import { isProbeRound, PROBE_KINDS } from '../probe-rounds.js';
9
+ const message = z.custom((value) => isRecord(value) && typeof value.role === 'string' && typeof value.content === 'string');
10
+ const record = () => z.custom((value) => isRecord(value));
11
+ const mediaRef = z.object({
12
+ id: z.string(),
13
+ page: z.number().optional(),
14
+ frame: z.number().optional(),
15
+ frames: z.number().optional()
16
+ });
17
+ const roundOptions = z.object({
18
+ kind: z.enum(['streaming', 'wrap-up', ...PROBE_KINDS]),
19
+ attempt: z.number(),
20
+ modelId: z.string(),
21
+ continuationNudge: z.string(),
22
+ deliveredNudge: z.string(),
23
+ toolSet: z.string().optional(),
24
+ tools: z.array(record()).optional(),
25
+ system: z.string().optional(),
26
+ generationParams: record().optional(),
27
+ responseFormat: record().optional(),
28
+ toolDialect: z.custom().optional(),
29
+ unforced: record().optional(),
30
+ media: z.array(z.object({ at: z.number(), refs: z.array(mediaRef) })).optional()
31
+ });
32
+ const roundResult = z.custom((value) => isRecord(value) && typeof value.contentText === 'string' && isRecord(value.final));
33
+ export class OwnerRounds {
34
+ port;
35
+ inputLength = 0;
36
+ share = null;
37
+ _opts;
38
+ _echoes = [];
39
+ _known = null;
40
+ _contextSent = false;
41
+ _rounds = 0;
42
+ _retakes = 0;
43
+ constructor(opts) {
44
+ this._opts = opts;
45
+ this.port = (request, io) => this._round(request, io);
46
+ }
47
+ get rounds() {
48
+ return this._rounds;
49
+ }
50
+ retook() {
51
+ if (!this._retakes)
52
+ return false;
53
+ this._retakes--;
54
+ return true;
55
+ }
56
+ echoed(type, text) {
57
+ const at = this._echoes.findIndex((echo) => echo.type === type && echo.text === text);
58
+ if (at === -1) {
59
+ return false;
60
+ }
61
+ this._echoes.splice(at, 1);
62
+ return true;
63
+ }
64
+ async _round(request, io) {
65
+ if (io.signal.aborted)
66
+ throw new AbortedError();
67
+ const system = request.history[0]?.role === 'system' ? request.history[0].content : undefined;
68
+ const input = (system === undefined ? 0 : 1) + this.inputLength;
69
+ if (!this._contextSent) {
70
+ this._contextSent = true;
71
+ await this._sendContext(request, input);
72
+ }
73
+ const sent = {
74
+ round: request.round,
75
+ cacheKey: request.cacheKey,
76
+ promptPrefix: request.promptPrefix,
77
+ toolTurns: request.history.slice(input),
78
+ options: await this._options(request, system)
79
+ };
80
+ const agentId = (await this._switchedTo()) ?? this._opts.agentId;
81
+ const id = await this._ask(sent, agentId);
82
+ this._rounds++;
83
+ return this._follow(sent, { id, agentId }, io);
84
+ }
85
+ async probe({ kind, prompt, modelId, responseFormat, signal }) {
86
+ if (signal.aborted)
87
+ throw new AbortedError();
88
+ const { engine, chatId, runId, deviceId } = this._opts;
89
+ const agentId = (await this._switchedTo()) ?? this._opts.agentId;
90
+ const { id } = await engine.appendChunk({
91
+ chatId,
92
+ runId,
93
+ type: 'model-request',
94
+ originDeviceId: deviceId,
95
+ modelRequest: {
96
+ round: 0,
97
+ agents: [agentId],
98
+ toolTurns: [{ role: 'user', content: prompt }],
99
+ options: {
100
+ kind,
101
+ attempt: 0,
102
+ modelId: await this._modelOf(agentId, modelId),
103
+ continuationNudge: '',
104
+ deliveredNudge: '',
105
+ generationParams: { reasoning_budget: 0 },
106
+ responseFormat
107
+ },
108
+ state: 'open'
109
+ }
110
+ });
111
+ return (await this._probed({ id, agentId }, signal)).contentText;
112
+ }
113
+ async _probed(asked, signal) {
114
+ const { engine, chatId, from } = this._opts;
115
+ const watch = engine.chunksDeltaWatch({ chatId, gte: from || undefined });
116
+ const agents = engine.agentsWatch({});
117
+ const abort = () => watch.destroy();
118
+ signal.addEventListener('abort', abort);
119
+ let round;
120
+ let ended = false;
121
+ void this._dropOnHostLoss(agents, asked, () => round).catch(noop);
122
+ try {
123
+ for await (const frame of watch) {
124
+ round = frame.chunks?.find((chunk) => chunk.id === asked.id)?.modelRequest ?? round;
125
+ ended = !!round && round.state !== 'open' && round.state !== 'taken';
126
+ const result = roundEnd(round);
127
+ if (result) {
128
+ return result;
129
+ }
130
+ }
131
+ throw new AbortedError();
132
+ }
133
+ finally {
134
+ signal.removeEventListener('abort', abort);
135
+ watch.destroy();
136
+ agents.destroy();
137
+ if (!ended) {
138
+ await engine.cancelModelRequest({ chunkId: asked.id }).catch(noop);
139
+ }
140
+ }
141
+ }
142
+ async _dropOnHostLoss(agents, asked, round) {
143
+ let reachable = false;
144
+ for await (const _frame of agents) {
145
+ const agent = await this._opts.engine.getAgent({ agentId: asked.agentId }).catch(() => null);
146
+ if (!agent) {
147
+ continue;
148
+ }
149
+ const was = reachable;
150
+ reachable = !!agent.hostReachable;
151
+ const host = round()?.hostDeviceId;
152
+ const moved = !!host && !b4a.equals(agent.providerDeviceId, host);
153
+ if (moved || (was && !reachable && round()?.state === 'taken')) {
154
+ await this._opts.engine.cancelModelRequest({ chunkId: asked.id }).catch(noop);
155
+ return;
156
+ }
157
+ }
158
+ }
159
+ async _ask(sent, agentId) {
160
+ const { engine, chatId, runId, deviceId } = this._opts;
161
+ const modelId = await this._modelOf(agentId, sent.options.modelId);
162
+ if (sent.options.media?.some(({ refs }) => refs.some((ref) => ref.frame !== undefined))) {
163
+ await this.share?.(agentId);
164
+ }
165
+ const { id } = await engine.appendChunk({
166
+ chatId,
167
+ runId,
168
+ type: 'model-request',
169
+ originDeviceId: deviceId,
170
+ modelRequest: {
171
+ round: sent.round,
172
+ agents: [agentId],
173
+ cacheKey: sent.cacheKey,
174
+ promptPrefix: sent.promptPrefix,
175
+ toolTurns: sent.toolTurns,
176
+ options: { ...sent.options, modelId },
177
+ state: 'open'
178
+ }
179
+ });
180
+ return id;
181
+ }
182
+ async _modelOf(agentId, modelId) {
183
+ if (agentId === this._opts.agentId) {
184
+ return modelId;
185
+ }
186
+ const agent = await this._opts.engine.getAgent({ agentId }).catch(() => null);
187
+ return agent?.modelName || modelId;
188
+ }
189
+ async _switchedTo() {
190
+ const { chunks } = await this._opts.engine.listChunks({
191
+ chatId: this._opts.chatId,
192
+ type: 'agent-switch'
193
+ });
194
+ return lastSwitch(chunks ?? [], this._opts.from);
195
+ }
196
+ async _sendContext(request, input) {
197
+ const { engine, chatId, runId, deviceId } = this._opts;
198
+ const sent = request.history.slice(0, input).findLast((turn) => turn.role === 'user');
199
+ await engine.appendChunk({
200
+ chatId,
201
+ runId,
202
+ type: 'context',
203
+ originDeviceId: deviceId,
204
+ context: { turn: { sent: sent?.content }, toolSetHash: request.toolSet ?? null }
205
+ });
206
+ }
207
+ async _options(request, system) {
208
+ const known = await this._knownSets();
209
+ const options = {
210
+ kind: request.kind,
211
+ attempt: request.attempt,
212
+ modelId: request.modelId,
213
+ continuationNudge: request.continuationNudge,
214
+ deliveredNudge: request.deliveredNudge,
215
+ toolSet: request.toolSet,
216
+ tools: request.toolSet && !known.toolSets.has(request.toolSet) ? request.tools : undefined,
217
+ system: known.prefixes.has(request.promptPrefix) ? undefined : system,
218
+ generationParams: request.generationParams,
219
+ responseFormat: request.responseFormat,
220
+ toolDialect: request.toolDialect,
221
+ unforced: request.unforced,
222
+ media: this._media(request.history)
223
+ };
224
+ known.prefixes.add(request.promptPrefix);
225
+ if (request.toolSet) {
226
+ known.toolSets.add(request.toolSet);
227
+ }
228
+ return options;
229
+ }
230
+ _media(history) {
231
+ const media = history.flatMap((turn, at) => {
232
+ const refs = (turn.attachments ?? []).flatMap(({ path }) => this._opts.media?.(path) ?? []);
233
+ return refs.length ? [{ at, refs }] : [];
234
+ });
235
+ return media.length ? media : undefined;
236
+ }
237
+ _knownSets() {
238
+ this._known ??= this._readKnownSets();
239
+ return this._known;
240
+ }
241
+ async _readKnownSets() {
242
+ const { chunks } = await this._opts.engine.listChunks({
243
+ chatId: this._opts.chatId,
244
+ type: 'model-request'
245
+ });
246
+ const known = { prefixes: new Set(), toolSets: new Set() };
247
+ for (const chunk of withoutProbes(chunks ?? [])) {
248
+ const options = roundOptions.safeParse(chunk.modelRequest?.options);
249
+ const prefix = chunk.modelRequest?.promptPrefix;
250
+ if (prefix && options.data?.system !== undefined) {
251
+ known.prefixes.add(prefix);
252
+ }
253
+ if (options.data?.toolSet && options.data.tools) {
254
+ known.toolSets.add(options.data.toolSet);
255
+ }
256
+ }
257
+ return known;
258
+ }
259
+ async _follow(sent, first, io) {
260
+ const { engine, chatId, from, deviceId } = this._opts;
261
+ const watch = engine.chunksDeltaWatch({ chatId, gte: from || undefined });
262
+ const agents = engine.agentsWatch({});
263
+ const abort = () => watch.destroy();
264
+ io.signal.addEventListener('abort', abort);
265
+ const at = { asked: first, moving: null, host: null };
266
+ const output = new RoundOutput(first.id, io, {
267
+ forwarded: (echo) => this._echoes.push(echo),
268
+ retook: () => this._retakes++
269
+ });
270
+ const move = async (agentId) => {
271
+ at.moving = { agentId, after: output.newest(), emit: io.retake() };
272
+ await engine.cancelModelRequest({ chunkId: at.asked.id }).catch(noop);
273
+ };
274
+ void this._followHost(agents, { at, output, move }).catch(noop);
275
+ try {
276
+ for await (const frame of watch) {
277
+ const round = output.apply(frame);
278
+ const result = at.moving ? undefined : roundEnd(round);
279
+ if (result) {
280
+ return result;
281
+ }
282
+ const switched = output.switchedTo(from);
283
+ if (!at.moving && switched && switched !== at.asked.agentId) {
284
+ await move(switched);
285
+ }
286
+ else if (at.moving && output.resetSince(at.moving.after, deviceId)) {
287
+ const { agentId, emit } = at.moving;
288
+ at.asked = { id: await this._ask(sent, agentId), agentId };
289
+ output.reask(at.asked.id, emit);
290
+ at.moving = null;
291
+ }
292
+ }
293
+ throw new AbortedError();
294
+ }
295
+ finally {
296
+ io.signal.removeEventListener('abort', abort);
297
+ watch.destroy();
298
+ agents.destroy();
299
+ if (io.signal.aborted) {
300
+ await engine.cancelModelRequest({ chunkId: at.asked.id }).catch(noop);
301
+ }
302
+ }
303
+ }
304
+ async _followHost(agents, { at, output, move }) {
305
+ for await (const _frame of agents) {
306
+ const agentId = at.asked.agentId;
307
+ const agent = await this._opts.engine.getAgent({ agentId }).catch(() => null);
308
+ if (!agent || at.asked.agentId !== agentId) {
309
+ continue;
310
+ }
311
+ const provider = b4a.toHex(agent.providerDeviceId);
312
+ const was = at.host;
313
+ at.host = { provider, reachable: !!agent.hostReachable, moved: was?.moved };
314
+ const host = output.round()?.hostDeviceId;
315
+ if (!host || at.moving) {
316
+ continue;
317
+ }
318
+ if (provider !== b4a.toHex(host)) {
319
+ if (at.host.moved !== provider) {
320
+ at.host.moved = provider;
321
+ await move(agentId);
322
+ }
323
+ continue;
324
+ }
325
+ const lost = was?.provider === provider && was.reachable && !at.host.reachable;
326
+ if (lost && output.round()?.state === 'taken') {
327
+ await this._opts.engine.reopenModelRequest({ chunkId: at.asked.id }).catch(noop);
328
+ }
329
+ }
330
+ }
331
+ }
332
+ export class RoundOutput {
333
+ _id;
334
+ _io;
335
+ _hooks;
336
+ _rows = new Map();
337
+ _emitted = new Set();
338
+ _emit;
339
+ _taker = null;
340
+ _takenAt = 0;
341
+ _reopened = false;
342
+ _resetAt = -1;
343
+ constructor(id, io, hooks) {
344
+ this._id = id;
345
+ this._io = io;
346
+ this._hooks = hooks;
347
+ this._emit = io.emit;
348
+ }
349
+ apply(frame) {
350
+ if (frame.reset) {
351
+ this._rows.clear();
352
+ }
353
+ for (const gone of frame.removed ?? []) {
354
+ this._rows.delete(gone);
355
+ }
356
+ for (const chunk of frame.chunks ?? []) {
357
+ this._rows.set(chunk.id, chunk);
358
+ }
359
+ const asked = this._rows.get(this._id);
360
+ const round = asked?.modelRequest;
361
+ if (!asked || !round) {
362
+ return undefined;
363
+ }
364
+ this._take(round.takenBy ?? null, round.takenAt ?? 0);
365
+ const output = [...this._rows.values()].sort((a, b) => a.seq - b.seq);
366
+ for (const chunk of output) {
367
+ const reset = chunk.type === 'round-reset' && chunk.runId === asked.runId;
368
+ if (reset && chunk.round === round.round) {
369
+ this._resetAt = Math.max(this._resetAt, chunk.seq);
370
+ }
371
+ }
372
+ for (const chunk of output) {
373
+ this._forward(chunk);
374
+ }
375
+ return round;
376
+ }
377
+ reask(id, emit) {
378
+ this._id = id;
379
+ this._emit = emit;
380
+ this._taker = null;
381
+ this._takenAt = 0;
382
+ this._reopened = false;
383
+ }
384
+ round() {
385
+ return this._rows.get(this._id)?.modelRequest ?? undefined;
386
+ }
387
+ switchedTo(from) {
388
+ return lastSwitch(this._rows.values(), from);
389
+ }
390
+ newest() {
391
+ let seq = -1;
392
+ for (const chunk of this._rows.values()) {
393
+ seq = Math.max(seq, chunk.seq);
394
+ }
395
+ return seq;
396
+ }
397
+ resetSince(seq, deviceId) {
398
+ const asked = this._rows.get(this._id);
399
+ for (const chunk of this._rows.values()) {
400
+ if (chunk.type === 'round-reset' &&
401
+ chunk.seq > seq &&
402
+ chunk.runId === asked?.runId &&
403
+ chunk.round === asked?.modelRequest?.round &&
404
+ b4a.equals(chunk.originDeviceId, deviceId)) {
405
+ return true;
406
+ }
407
+ }
408
+ return false;
409
+ }
410
+ _take(now, at) {
411
+ if (this._taker && !now) {
412
+ this._reopened = true;
413
+ }
414
+ const moved = now && this._taker && !b4a.equals(now, this._taker);
415
+ if (now && this._taker && (this._reopened || moved || at !== this._takenAt)) {
416
+ this._hooks.retook();
417
+ this._emit = this._io.retake();
418
+ this._reopened = false;
419
+ }
420
+ this._taker = now ?? this._taker;
421
+ this._takenAt = now ? at : this._takenAt;
422
+ }
423
+ _forward(chunk) {
424
+ const text = chunk.content?.text ?? chunk.thinking?.text;
425
+ const type = chunk.type;
426
+ const fresh = chunk.parentId === this._id && !this._emitted.has(chunk.id) && chunk.seq > this._resetAt;
427
+ const taken = !this._reopened && this._taker && b4a.equals(chunk.originDeviceId, this._taker);
428
+ if (!fresh || !taken || text === undefined || (type !== 'content' && type !== 'thinking')) {
429
+ return;
430
+ }
431
+ this._emitted.add(chunk.id);
432
+ this._hooks.forwarded({ type, text });
433
+ this._emit({ type, text });
434
+ }
435
+ }
436
+ export async function listRoundChunks(engine, chatId) {
437
+ const [contexts, requests] = await Promise.all([
438
+ engine.listChunks({ chatId, type: 'context' }),
439
+ engine.listChunks({ chatId, type: 'model-request' })
440
+ ]);
441
+ return [...(contexts.chunks ?? []), ...withoutProbes(requests.chunks ?? [])].sort((a, b) => a.seq - b.seq);
442
+ }
443
+ function withoutProbes(rounds) {
444
+ return rounds.filter((chunk) => !isProbeRound(chunk.modelRequest?.options));
445
+ }
446
+ export async function servedRequest(engine, round, media) {
447
+ const { chatId, runId, modelRequest } = round;
448
+ const options = roundOptions.safeParse(modelRequest?.options);
449
+ if (!runId || !modelRequest || !options.success) {
450
+ return null;
451
+ }
452
+ const { kind } = options.data;
453
+ if (kind !== 'streaming' && kind !== 'wrap-up') {
454
+ return probeRequest(runId, modelRequest, options.data);
455
+ }
456
+ const [all, rounds, { chunks: approvals }] = await Promise.all([
457
+ listHistoryChunks(engine, chatId),
458
+ listRoundChunks(engine, chatId),
459
+ engine.listChunks({ chatId, type: 'approval-request' })
460
+ ]);
461
+ const request = all.find((chunk) => chunk.type === 'run-request' && chunk.runId === runId);
462
+ const earlier = rounds.filter((chunk) => chunk.seq <= round.seq);
463
+ const sent = earlier.findLast((chunk) => chunk.runId === runId && sentTurn(chunk) !== undefined);
464
+ const prompt = sent && sentTurn(sent);
465
+ const { system, tools } = carried(earlier, modelRequest.promptPrefix ?? '', options.data.toolSet);
466
+ const toolTurns = z.array(message).safeParse(modelRequest.toolTurns ?? []);
467
+ const unresolved = system === undefined || (options.data.toolSet && !tools);
468
+ if (!request || prompt === undefined || unresolved || !toolTurns.success) {
469
+ return null;
470
+ }
471
+ const view = runPromptView(all, approvals ?? [], { request, runId });
472
+ const messages = historyFromChunks(view.history, view.stale, replayFromChunks(earlier));
473
+ if (view.repair) {
474
+ messages.push({ role: 'user', content: view.repair.promptText });
475
+ }
476
+ restoreSentContent(messages);
477
+ const input = nameSenders(messages).map(({ role, content }) => ({ role, content }));
478
+ const asked = input.findLastIndex((turn) => turn.role === 'user');
479
+ if (asked !== -1) {
480
+ input[asked] = { role: 'user', content: prompt };
481
+ }
482
+ const history = [
483
+ ...(system === null ? [] : [{ role: 'system', content: system }]),
484
+ ...input,
485
+ ...toolTurns.data.map(({ attachments: _owners, ...turn }) => turn)
486
+ ];
487
+ await showMedia(history, {
488
+ all,
489
+ media: options.data.media ?? [],
490
+ resolve: media && ((sources) => media(sources, options.data.modelId))
491
+ });
492
+ return {
493
+ runId,
494
+ round: modelRequest.round,
495
+ kind,
496
+ attempt: options.data.attempt,
497
+ modelId: options.data.modelId,
498
+ history,
499
+ tools,
500
+ toolSet: options.data.toolSet,
501
+ generationParams: options.data.generationParams,
502
+ responseFormat: options.data.responseFormat,
503
+ toolDialect: options.data.toolDialect,
504
+ cacheKey: modelRequest.cacheKey ?? undefined,
505
+ promptPrefix: modelRequest.promptPrefix ?? '',
506
+ continuationNudge: options.data.continuationNudge,
507
+ deliveredNudge: options.data.deliveredNudge,
508
+ unforced: options.data.unforced
509
+ };
510
+ }
511
+ function probeRequest(runId, modelRequest, options) {
512
+ const history = z.array(message).safeParse(modelRequest.toolTurns ?? []);
513
+ if (!history.success) {
514
+ return null;
515
+ }
516
+ return {
517
+ runId,
518
+ round: modelRequest.round,
519
+ kind: 'streaming',
520
+ attempt: options.attempt,
521
+ modelId: options.modelId,
522
+ history: history.data.map(({ role, content }) => ({ role, content })),
523
+ generationParams: options.generationParams,
524
+ responseFormat: options.responseFormat,
525
+ promptPrefix: '',
526
+ continuationNudge: options.continuationNudge,
527
+ deliveredNudge: options.deliveredNudge
528
+ };
529
+ }
530
+ async function showMedia(history, { all, media, resolve }) {
531
+ const attachments = new Map();
532
+ const digests = new Map();
533
+ for (const { attachment, sourceId } of all) {
534
+ if (!attachment || attachment.deletedAt) {
535
+ continue;
536
+ }
537
+ if (!sourceId) {
538
+ attachments.set(attachment.id, attachment);
539
+ }
540
+ else if (!digests.has(sourceId)) {
541
+ digests.set(sourceId, attachment);
542
+ }
543
+ }
544
+ const shown = media.flatMap(({ at, refs }) => refs.flatMap((ref) => {
545
+ const attachment = attachments.get(ref.id);
546
+ return attachment && history[at] ? [{ at, ref, attachment, digest: digests.get(ref.id) }] : [];
547
+ }));
548
+ const files = shown.length && resolve ? await resolve(shown) : [];
549
+ shown.forEach(({ at }, i) => {
550
+ const path = files[i];
551
+ if (path) {
552
+ history[at].attachments = [...(history[at].attachments ?? []), { path }];
553
+ }
554
+ });
555
+ }
556
+ function carried(rounds, promptPrefix, toolSet) {
557
+ const sets = new ToolSets();
558
+ let system;
559
+ for (const chunk of rounds) {
560
+ const options = roundOptions.safeParse(chunk.modelRequest?.options).data;
561
+ if (options?.tools) {
562
+ sets.add(options.tools);
563
+ }
564
+ if (options && chunk.modelRequest?.promptPrefix === promptPrefix && system === undefined) {
565
+ system = options.system ?? null;
566
+ }
567
+ }
568
+ return { system, tools: toolSet ? sets.resolve(toolSet) : undefined };
569
+ }
570
+ function roundEnd(round) {
571
+ if (round?.state === 'done') {
572
+ return roundResult.parse(round.result);
573
+ }
574
+ if (round?.state === 'failed') {
575
+ throw new Error(round.reason || 'the model round failed');
576
+ }
577
+ if (round?.state === 'cancelled') {
578
+ throw new AbortedError();
579
+ }
580
+ return undefined;
581
+ }
582
+ function lastSwitch(chunks, from) {
583
+ let last;
584
+ for (const chunk of chunks) {
585
+ if (chunk.type === 'agent-switch' && chunk.seq > from && (!last || chunk.seq > last.seq)) {
586
+ last = chunk;
587
+ }
588
+ }
589
+ return last?.agentSwitch?.agentId;
590
+ }
591
+ function noop() { }
@@ -0,0 +1,3 @@
1
+ export declare const MIN_PDF_PAGE_IMAGES = 2;
2
+ export declare const MAX_PDF_PAGE_IMAGES = 32;
3
+ export declare function pdfPageBudget(ctxSize: number): number;
@@ -0,0 +1,13 @@
1
+ import { MAX_IMAGE_WIDTH } from '../core/image/normalize.js';
2
+ import { frameTokens } from './video-budget.js';
3
+ const PAGE_TOKENS = frameTokens({
4
+ width: MAX_IMAGE_WIDTH,
5
+ height: Math.ceil(MAX_IMAGE_WIDTH * Math.SQRT2)
6
+ });
7
+ const PDF_SHARE = 0.5;
8
+ export const MIN_PDF_PAGE_IMAGES = 2;
9
+ export const MAX_PDF_PAGE_IMAGES = 32;
10
+ export function pdfPageBudget(ctxSize) {
11
+ const fits = Math.floor((ctxSize * PDF_SHARE) / PAGE_TOKENS);
12
+ return Math.min(MAX_PDF_PAGE_IMAGES, Math.max(MIN_PDF_PAGE_IMAGES, fits));
13
+ }
@@ -0,0 +1,42 @@
1
+ import { type AbortSignal } from 'bare-abort-controller';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
+ import type { AssistantChunk, AssistantChunkList } from '../../spec/hyperschema/types.d.ts';
4
+ import type { Capabilities, WatchStream } from '../api/index.ts';
5
+ import type { Harness } from './harness.ts';
6
+ import { type MediaSource } from './model-round.ts';
7
+ export interface RoundHostOptions {
8
+ readonly engine: Capabilities;
9
+ readonly serve: NonNullable<Harness['serveModelRound']>;
10
+ readonly deviceId: () => Buffer;
11
+ readonly media?: RoundMedia | null;
12
+ readonly log?: LoggerInterface | null;
13
+ }
14
+ export interface RoundMedia {
15
+ resolve(sources: ReadonlyArray<MediaSource>, served: {
16
+ readonly id: string;
17
+ readonly modelId: string;
18
+ readonly signal: AbortSignal;
19
+ }): Promise<Array<string | null>>;
20
+ release(id: string): void;
21
+ }
22
+ export declare function servedCacheKey(round: AssistantChunk, ownerKey: string | null | undefined): string | undefined;
23
+ export declare class RoundHost {
24
+ private readonly _opts;
25
+ private readonly _serving;
26
+ private readonly _keys;
27
+ private readonly _built;
28
+ constructor(opts: RoundHostOptions);
29
+ follow(meshId: string, frames: WatchStream<AssistantChunkList>): Promise<void>;
30
+ left(chatId: string, agentId: string): string[];
31
+ stop(): void;
32
+ private _reconcile;
33
+ private _pick;
34
+ private _serve;
35
+ private _take;
36
+ private _provides;
37
+ private _answer;
38
+ private _probe;
39
+ private _claimKey;
40
+ private _retake;
41
+ private _takeFor;
42
+ }