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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -0,0 +1,619 @@
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 { errorMessage, isRecord } from '../guards.js';
6
+ import { historyFromChunks, listHistoryChunks, replayFromChunks, runPromptView, sentTurn } from './history.js';
7
+ import { nameSenders, restoreSentContent } from './message.js';
8
+ import { PdfBoundsSchema } from './pdf-pages.js';
9
+ import { isProbeRound, PROBE_KINDS } from '../probe-rounds.js';
10
+ const message = z.custom((value) => isRecord(value) && typeof value.role === 'string' && typeof value.content === 'string');
11
+ const record = () => z.custom((value) => isRecord(value));
12
+ const mediaRef = z.object({
13
+ id: z.string(),
14
+ page: z.number().optional(),
15
+ clip: PdfBoundsSchema.optional(),
16
+ frame: z.number().optional(),
17
+ frames: z.number().optional()
18
+ });
19
+ const roundOptions = z.object({
20
+ kind: z.enum(['streaming', 'wrap-up', ...PROBE_KINDS]),
21
+ attempt: z.number(),
22
+ modelId: z.string(),
23
+ continuationNudge: z.string(),
24
+ deliveredNudge: z.string(),
25
+ toolSet: z.string().optional(),
26
+ tools: z.array(record()).optional(),
27
+ system: z.string().optional(),
28
+ generationParams: record().optional(),
29
+ responseFormat: record().optional(),
30
+ toolDialect: z.custom().optional(),
31
+ unforced: record().optional(),
32
+ media: z.array(z.object({ at: z.number(), refs: z.array(mediaRef) })).optional()
33
+ });
34
+ const roundResult = z.custom((value) => isRecord(value) && typeof value.contentText === 'string' && isRecord(value.final));
35
+ export class OwnerRounds {
36
+ port;
37
+ inputLength = 0;
38
+ share = null;
39
+ _opts;
40
+ _echoes = [];
41
+ _known = null;
42
+ _contextSent = false;
43
+ _rounds = 0;
44
+ _retakes = 0;
45
+ _takers = new Map();
46
+ constructor(opts) {
47
+ this._opts = opts;
48
+ this.port = (request, io) => this._round(request, io);
49
+ }
50
+ get rounds() {
51
+ return this._rounds;
52
+ }
53
+ ranHere(round) {
54
+ if (!this._rounds)
55
+ return true;
56
+ const taker = round === undefined ? undefined : this._takers.get(round);
57
+ return !!taker && b4a.equals(taker, this._opts.deviceId);
58
+ }
59
+ retook() {
60
+ if (!this._retakes)
61
+ return false;
62
+ this._retakes--;
63
+ return true;
64
+ }
65
+ echoed(type, text) {
66
+ const at = this._echoes.findIndex((echo) => echo.type === type && echo.text === text);
67
+ if (at === -1) {
68
+ return false;
69
+ }
70
+ this._echoes.splice(at, 1);
71
+ return true;
72
+ }
73
+ async _round(request, io) {
74
+ if (io.signal.aborted)
75
+ throw new AbortedError();
76
+ const system = request.history[0]?.role === 'system' ? request.history[0].content : undefined;
77
+ const input = (system === undefined ? 0 : 1) + this.inputLength;
78
+ if (!this._contextSent) {
79
+ this._contextSent = true;
80
+ await this._sendContext(request, input);
81
+ }
82
+ const sent = {
83
+ round: request.round,
84
+ cacheKey: request.cacheKey,
85
+ promptPrefix: request.promptPrefix,
86
+ toolTurns: request.history.slice(input),
87
+ options: await this._options(request, system)
88
+ };
89
+ const agentId = (await this._switchedTo()) ?? this._opts.agentId;
90
+ const id = await this._ask(sent, agentId);
91
+ this._rounds++;
92
+ const { round, modelId, history, tools, generationParams, responseFormat, toolDialect } = request;
93
+ this._opts.inspect?.({
94
+ round,
95
+ modelId,
96
+ messages: history,
97
+ tools,
98
+ generationParams,
99
+ responseFormat,
100
+ toolDialect,
101
+ cacheKey: request.cacheKey,
102
+ promptPrefix: request.promptPrefix
103
+ });
104
+ return this._follow(sent, { id, agentId }, io);
105
+ }
106
+ async probe({ kind, prompt, modelId, responseFormat, signal }) {
107
+ if (signal.aborted)
108
+ throw new AbortedError();
109
+ const { engine, chatId, runId, deviceId } = this._opts;
110
+ const agentId = (await this._switchedTo()) ?? this._opts.agentId;
111
+ const messages = [{ role: 'user', content: prompt }];
112
+ const options = {
113
+ kind,
114
+ attempt: 0,
115
+ modelId: await this._modelOf(agentId, modelId),
116
+ continuationNudge: '',
117
+ deliveredNudge: '',
118
+ generationParams: { reasoning_budget: 0 },
119
+ responseFormat
120
+ };
121
+ const { id } = await engine.appendChunk({
122
+ chatId,
123
+ runId,
124
+ type: 'model-request',
125
+ originDeviceId: deviceId,
126
+ modelRequest: { round: 0, agents: [agentId], toolTurns: messages, options, state: 'open' }
127
+ });
128
+ const { modelId: asked, generationParams } = options;
129
+ const call = { kind, modelId: asked, messages, generationParams, responseFormat };
130
+ try {
131
+ const { contentText } = await this._probed({ id, agentId }, signal);
132
+ this._opts.inspect?.({ ...call, outcome: 'completed', result: contentText });
133
+ return contentText;
134
+ }
135
+ catch (err) {
136
+ this._opts.inspect?.({ ...call, outcome: 'failed', reason: errorMessage(err) });
137
+ throw err;
138
+ }
139
+ }
140
+ async _probed(asked, signal) {
141
+ const { engine, chatId, from } = this._opts;
142
+ const watch = engine.chunksDeltaWatch({ chatId, gte: from || undefined });
143
+ const agents = engine.agentsWatch({});
144
+ const abort = () => watch.destroy();
145
+ signal.addEventListener('abort', abort);
146
+ let round;
147
+ let ended = false;
148
+ void this._dropOnHostLoss(agents, asked, () => round).catch(noop);
149
+ try {
150
+ for await (const frame of watch) {
151
+ round = frame.chunks?.find((chunk) => chunk.id === asked.id)?.modelRequest ?? round;
152
+ ended = !!round && round.state !== 'open' && round.state !== 'taken';
153
+ const result = roundEnd(round);
154
+ if (result) {
155
+ return result;
156
+ }
157
+ }
158
+ throw new AbortedError();
159
+ }
160
+ finally {
161
+ signal.removeEventListener('abort', abort);
162
+ watch.destroy();
163
+ agents.destroy();
164
+ if (!ended) {
165
+ await engine.cancelModelRequest({ chunkId: asked.id }).catch(noop);
166
+ }
167
+ }
168
+ }
169
+ async _dropOnHostLoss(agents, asked, round) {
170
+ let reachable = false;
171
+ for await (const _frame of agents) {
172
+ const agent = await this._opts.engine.getAgent({ agentId: asked.agentId }).catch(() => null);
173
+ if (!agent) {
174
+ continue;
175
+ }
176
+ const was = reachable;
177
+ reachable = !!agent.hostReachable;
178
+ const host = round()?.hostDeviceId;
179
+ const moved = !!host && !b4a.equals(agent.providerDeviceId, host);
180
+ if (moved || (was && !reachable)) {
181
+ await this._opts.engine.cancelModelRequest({ chunkId: asked.id }).catch(noop);
182
+ return;
183
+ }
184
+ }
185
+ }
186
+ async _ask(sent, agentId) {
187
+ const { engine, chatId, runId, deviceId } = this._opts;
188
+ const modelId = await this._modelOf(agentId, sent.options.modelId);
189
+ if (sent.options.media?.some(({ refs }) => refs.some((ref) => ref.frame !== undefined))) {
190
+ await this.share?.(agentId);
191
+ }
192
+ const { id } = await engine.appendChunk({
193
+ chatId,
194
+ runId,
195
+ type: 'model-request',
196
+ originDeviceId: deviceId,
197
+ modelRequest: {
198
+ round: sent.round,
199
+ agents: [agentId],
200
+ cacheKey: sent.cacheKey,
201
+ promptPrefix: sent.promptPrefix,
202
+ toolTurns: sent.toolTurns,
203
+ options: { ...sent.options, modelId },
204
+ state: 'open'
205
+ }
206
+ });
207
+ return id;
208
+ }
209
+ async _modelOf(agentId, modelId) {
210
+ if (agentId === this._opts.agentId) {
211
+ return modelId;
212
+ }
213
+ const agent = await this._opts.engine.getAgent({ agentId }).catch(() => null);
214
+ return agent?.modelName || modelId;
215
+ }
216
+ async _switchedTo() {
217
+ const { chunks } = await this._opts.engine.listChunks({
218
+ chatId: this._opts.chatId,
219
+ type: 'agent-switch'
220
+ });
221
+ return lastSwitch(chunks ?? [], this._opts.from);
222
+ }
223
+ async _sendContext(request, input) {
224
+ const { engine, chatId, runId, deviceId } = this._opts;
225
+ const sent = request.history.slice(0, input).findLast((turn) => turn.role === 'user');
226
+ await engine.appendChunk({
227
+ chatId,
228
+ runId,
229
+ type: 'context',
230
+ originDeviceId: deviceId,
231
+ context: { turn: { sent: sent?.content }, toolSetHash: request.toolSet ?? null }
232
+ });
233
+ }
234
+ async _options(request, system) {
235
+ const known = await this._knownSets();
236
+ const options = {
237
+ kind: request.kind,
238
+ attempt: request.attempt,
239
+ modelId: request.modelId,
240
+ continuationNudge: request.continuationNudge,
241
+ deliveredNudge: request.deliveredNudge,
242
+ toolSet: request.toolSet,
243
+ tools: request.toolSet && !known.toolSets.has(request.toolSet) ? request.tools : undefined,
244
+ system: known.prefixes.has(request.promptPrefix) ? undefined : system,
245
+ generationParams: request.generationParams,
246
+ responseFormat: request.responseFormat,
247
+ toolDialect: request.toolDialect,
248
+ unforced: request.unforced,
249
+ media: this._media(request.history)
250
+ };
251
+ known.prefixes.add(request.promptPrefix);
252
+ if (request.toolSet) {
253
+ known.toolSets.add(request.toolSet);
254
+ }
255
+ return options;
256
+ }
257
+ _media(history) {
258
+ const media = history.flatMap((turn, at) => {
259
+ const refs = (turn.attachments ?? []).flatMap(({ path }) => this._opts.media?.(path) ?? []);
260
+ return refs.length ? [{ at, refs }] : [];
261
+ });
262
+ return media.length ? media : undefined;
263
+ }
264
+ _knownSets() {
265
+ this._known ??= this._readKnownSets();
266
+ return this._known;
267
+ }
268
+ async _readKnownSets() {
269
+ const { chunks } = await this._opts.engine.listChunks({
270
+ chatId: this._opts.chatId,
271
+ type: 'model-request'
272
+ });
273
+ const known = { prefixes: new Set(), toolSets: new Set() };
274
+ for (const chunk of withoutProbes(chunks ?? [])) {
275
+ const options = roundOptions.safeParse(chunk.modelRequest?.options);
276
+ const prefix = chunk.modelRequest?.promptPrefix;
277
+ if (prefix && options.data?.system !== undefined) {
278
+ known.prefixes.add(prefix);
279
+ }
280
+ if (options.data?.toolSet && options.data.tools) {
281
+ known.toolSets.add(options.data.toolSet);
282
+ }
283
+ }
284
+ return known;
285
+ }
286
+ async _follow(sent, first, io) {
287
+ const { engine, chatId, from, deviceId } = this._opts;
288
+ const watch = engine.chunksDeltaWatch({ chatId, gte: from || undefined });
289
+ const agents = engine.agentsWatch({});
290
+ const abort = () => watch.destroy();
291
+ io.signal.addEventListener('abort', abort);
292
+ const at = { asked: first, moving: null, host: null };
293
+ const output = new RoundOutput(first.id, io, {
294
+ forwarded: (echo) => this._echoes.push(echo),
295
+ retook: () => this._retakes++
296
+ });
297
+ const move = async (agentId) => {
298
+ at.moving = { agentId, after: output.newest(), emit: io.retake() };
299
+ await engine.cancelModelRequest({ chunkId: at.asked.id }).catch(noop);
300
+ };
301
+ void this._followHost(agents, { at, output, move }).catch(noop);
302
+ try {
303
+ for await (const frame of watch) {
304
+ const round = output.apply(frame);
305
+ const result = at.moving ? undefined : roundEnd(round);
306
+ if (result) {
307
+ this._takers.set(sent.round, round?.takenBy ?? null);
308
+ return result;
309
+ }
310
+ const switched = output.switchedTo(from);
311
+ if (!at.moving && switched && switched !== at.asked.agentId) {
312
+ await move(switched);
313
+ }
314
+ else if (at.moving && output.resetSince(at.moving.after, deviceId)) {
315
+ const { agentId, emit } = at.moving;
316
+ at.asked = { id: await this._ask(sent, agentId), agentId };
317
+ output.reask(at.asked.id, emit);
318
+ at.moving = null;
319
+ }
320
+ }
321
+ throw new AbortedError();
322
+ }
323
+ finally {
324
+ io.signal.removeEventListener('abort', abort);
325
+ watch.destroy();
326
+ agents.destroy();
327
+ if (io.signal.aborted) {
328
+ await engine.cancelModelRequest({ chunkId: at.asked.id }).catch(noop);
329
+ }
330
+ }
331
+ }
332
+ async _followHost(agents, { at, output, move }) {
333
+ for await (const _frame of agents) {
334
+ const agentId = at.asked.agentId;
335
+ const agent = await this._opts.engine.getAgent({ agentId }).catch(() => null);
336
+ if (!agent || at.asked.agentId !== agentId) {
337
+ continue;
338
+ }
339
+ const provider = b4a.toHex(agent.providerDeviceId);
340
+ const was = at.host;
341
+ at.host = { provider, reachable: !!agent.hostReachable, moved: was?.moved };
342
+ const host = output.round()?.hostDeviceId;
343
+ if (!host || at.moving) {
344
+ continue;
345
+ }
346
+ if (provider !== b4a.toHex(host)) {
347
+ if (at.host.moved !== provider) {
348
+ at.host.moved = provider;
349
+ await move(agentId);
350
+ }
351
+ continue;
352
+ }
353
+ const lost = was?.provider === provider && was.reachable && !at.host.reachable;
354
+ if (lost && output.round()?.state === 'taken') {
355
+ await this._opts.engine.reopenModelRequest({ chunkId: at.asked.id }).catch(noop);
356
+ }
357
+ }
358
+ }
359
+ }
360
+ export class RoundOutput {
361
+ _id;
362
+ _io;
363
+ _hooks;
364
+ _rows = new Map();
365
+ _emitted = new Set();
366
+ _emit;
367
+ _taker = null;
368
+ _takenAt = 0;
369
+ _reopened = false;
370
+ _resetAt = -1;
371
+ constructor(id, io, hooks) {
372
+ this._id = id;
373
+ this._io = io;
374
+ this._hooks = hooks;
375
+ this._emit = io.emit;
376
+ }
377
+ apply(frame) {
378
+ if (frame.reset) {
379
+ this._rows.clear();
380
+ }
381
+ for (const gone of frame.removed ?? []) {
382
+ this._rows.delete(gone);
383
+ }
384
+ for (const chunk of frame.chunks ?? []) {
385
+ this._rows.set(chunk.id, chunk);
386
+ }
387
+ const asked = this._rows.get(this._id);
388
+ const round = asked?.modelRequest;
389
+ if (!asked || !round) {
390
+ return undefined;
391
+ }
392
+ this._take(round.takenBy ?? null, round.takenAt ?? 0);
393
+ const output = [...this._rows.values()].sort((a, b) => a.seq - b.seq);
394
+ for (const chunk of output) {
395
+ const reset = chunk.type === 'round-reset' && chunk.runId === asked.runId;
396
+ if (reset && chunk.round === round.round) {
397
+ this._resetAt = Math.max(this._resetAt, chunk.seq);
398
+ }
399
+ }
400
+ for (const chunk of output) {
401
+ this._forward(chunk);
402
+ }
403
+ return round;
404
+ }
405
+ reask(id, emit) {
406
+ this._id = id;
407
+ this._emit = emit;
408
+ this._taker = null;
409
+ this._takenAt = 0;
410
+ this._reopened = false;
411
+ }
412
+ round() {
413
+ return this._rows.get(this._id)?.modelRequest ?? undefined;
414
+ }
415
+ switchedTo(from) {
416
+ return lastSwitch(this._rows.values(), from);
417
+ }
418
+ newest() {
419
+ let seq = -1;
420
+ for (const chunk of this._rows.values()) {
421
+ seq = Math.max(seq, chunk.seq);
422
+ }
423
+ return seq;
424
+ }
425
+ resetSince(seq, deviceId) {
426
+ const asked = this._rows.get(this._id);
427
+ for (const chunk of this._rows.values()) {
428
+ if (chunk.type === 'round-reset' &&
429
+ chunk.seq > seq &&
430
+ chunk.runId === asked?.runId &&
431
+ chunk.round === asked?.modelRequest?.round &&
432
+ b4a.equals(chunk.originDeviceId, deviceId)) {
433
+ return true;
434
+ }
435
+ }
436
+ return false;
437
+ }
438
+ _take(now, at) {
439
+ if (this._taker && !now) {
440
+ this._reopened = true;
441
+ }
442
+ const moved = now && this._taker && !b4a.equals(now, this._taker);
443
+ if (now && this._taker && (this._reopened || moved || at !== this._takenAt)) {
444
+ this._hooks.retook();
445
+ this._emit = this._io.retake();
446
+ this._reopened = false;
447
+ }
448
+ this._taker = now ?? this._taker;
449
+ this._takenAt = now ? at : this._takenAt;
450
+ }
451
+ _forward(chunk) {
452
+ const text = chunk.content?.text ?? chunk.thinking?.text;
453
+ const type = chunk.type;
454
+ const fresh = chunk.parentId === this._id && !this._emitted.has(chunk.id) && chunk.seq > this._resetAt;
455
+ const taken = !this._reopened && this._taker && b4a.equals(chunk.originDeviceId, this._taker);
456
+ if (!fresh || !taken || text === undefined || (type !== 'content' && type !== 'thinking')) {
457
+ return;
458
+ }
459
+ this._emitted.add(chunk.id);
460
+ this._hooks.forwarded({ type, text });
461
+ this._emit({ type, text });
462
+ }
463
+ }
464
+ export async function listRoundChunks(engine, chatId) {
465
+ const [contexts, requests] = await Promise.all([
466
+ engine.listChunks({ chatId, type: 'context' }),
467
+ engine.listChunks({ chatId, type: 'model-request' })
468
+ ]);
469
+ return [...(contexts.chunks ?? []), ...withoutProbes(requests.chunks ?? [])].sort((a, b) => a.seq - b.seq);
470
+ }
471
+ function withoutProbes(rounds) {
472
+ return rounds.filter((chunk) => !isProbeRound(chunk.modelRequest?.options));
473
+ }
474
+ export async function servedRequest(engine, round, media) {
475
+ const { chatId, runId, modelRequest } = round;
476
+ const options = roundOptions.safeParse(modelRequest?.options);
477
+ if (!runId || !modelRequest || !options.success) {
478
+ return null;
479
+ }
480
+ const { kind } = options.data;
481
+ if (kind !== 'streaming' && kind !== 'wrap-up') {
482
+ return probeRequest(runId, modelRequest, options.data);
483
+ }
484
+ const [all, rounds, { chunks: approvals }] = await Promise.all([
485
+ listHistoryChunks(engine, chatId),
486
+ listRoundChunks(engine, chatId),
487
+ engine.listChunks({ chatId, type: 'approval-request' })
488
+ ]);
489
+ const request = all.find((chunk) => chunk.type === 'run-request' && chunk.runId === runId);
490
+ const earlier = rounds.filter((chunk) => chunk.seq <= round.seq);
491
+ const sent = earlier.findLast((chunk) => chunk.runId === runId && sentTurn(chunk) !== undefined);
492
+ const prompt = sent && sentTurn(sent);
493
+ const { system, tools } = carried(earlier, modelRequest.promptPrefix ?? '', options.data.toolSet);
494
+ const toolTurns = z.array(message).safeParse(modelRequest.toolTurns ?? []);
495
+ const unresolved = system === undefined || (options.data.toolSet && !tools);
496
+ if (!request || prompt === undefined || unresolved || !toolTurns.success) {
497
+ return null;
498
+ }
499
+ const view = runPromptView(all, approvals ?? [], { request, runId });
500
+ const messages = historyFromChunks(view.history, view.stale, replayFromChunks(earlier));
501
+ if (view.repair) {
502
+ messages.push({ role: 'user', content: view.repair.promptText });
503
+ }
504
+ restoreSentContent(messages);
505
+ const input = nameSenders(messages).map(({ role, content }) => ({ role, content }));
506
+ const asked = input.findLastIndex((turn) => turn.role === 'user');
507
+ if (asked !== -1) {
508
+ input[asked] = { role: 'user', content: prompt };
509
+ }
510
+ const history = [
511
+ ...(system === null ? [] : [{ role: 'system', content: system }]),
512
+ ...input,
513
+ ...toolTurns.data.map(({ attachments: _owners, ...turn }) => turn)
514
+ ];
515
+ await showMedia(history, {
516
+ all,
517
+ media: options.data.media ?? [],
518
+ resolve: media && ((sources) => media(sources, options.data.modelId))
519
+ });
520
+ return {
521
+ runId,
522
+ round: modelRequest.round,
523
+ kind,
524
+ attempt: options.data.attempt,
525
+ modelId: options.data.modelId,
526
+ history,
527
+ tools,
528
+ toolSet: options.data.toolSet,
529
+ generationParams: options.data.generationParams,
530
+ responseFormat: options.data.responseFormat,
531
+ toolDialect: options.data.toolDialect,
532
+ cacheKey: modelRequest.cacheKey ?? undefined,
533
+ promptPrefix: modelRequest.promptPrefix ?? '',
534
+ continuationNudge: options.data.continuationNudge,
535
+ deliveredNudge: options.data.deliveredNudge,
536
+ unforced: options.data.unforced
537
+ };
538
+ }
539
+ function probeRequest(runId, modelRequest, options) {
540
+ const history = z.array(message).safeParse(modelRequest.toolTurns ?? []);
541
+ if (!history.success) {
542
+ return null;
543
+ }
544
+ return {
545
+ runId,
546
+ round: modelRequest.round,
547
+ kind: 'streaming',
548
+ attempt: options.attempt,
549
+ modelId: options.modelId,
550
+ history: history.data.map(({ role, content }) => ({ role, content })),
551
+ generationParams: options.generationParams,
552
+ responseFormat: options.responseFormat,
553
+ promptPrefix: '',
554
+ continuationNudge: options.continuationNudge,
555
+ deliveredNudge: options.deliveredNudge
556
+ };
557
+ }
558
+ async function showMedia(history, { all, media, resolve }) {
559
+ const attachments = new Map();
560
+ const digests = new Map();
561
+ for (const { attachment, sourceId } of all) {
562
+ if (!attachment || attachment.deletedAt) {
563
+ continue;
564
+ }
565
+ if (!sourceId) {
566
+ attachments.set(attachment.id, attachment);
567
+ }
568
+ else if (!digests.has(sourceId)) {
569
+ digests.set(sourceId, attachment);
570
+ }
571
+ }
572
+ const shown = media.flatMap(({ at, refs }) => refs.flatMap((ref) => {
573
+ const attachment = attachments.get(ref.id);
574
+ return attachment && history[at] ? [{ at, ref, attachment, digest: digests.get(ref.id) }] : [];
575
+ }));
576
+ const files = shown.length && resolve ? await resolve(shown) : [];
577
+ shown.forEach(({ at }, i) => {
578
+ const path = files[i];
579
+ if (path) {
580
+ history[at].attachments = [...(history[at].attachments ?? []), { path }];
581
+ }
582
+ });
583
+ }
584
+ function carried(rounds, promptPrefix, toolSet) {
585
+ const sets = new ToolSets();
586
+ let system;
587
+ for (const chunk of rounds) {
588
+ const options = roundOptions.safeParse(chunk.modelRequest?.options).data;
589
+ if (options?.tools) {
590
+ sets.add(options.tools);
591
+ }
592
+ if (options && chunk.modelRequest?.promptPrefix === promptPrefix && system === undefined) {
593
+ system = options.system ?? null;
594
+ }
595
+ }
596
+ return { system, tools: toolSet ? sets.resolve(toolSet) : undefined };
597
+ }
598
+ function roundEnd(round) {
599
+ if (round?.state === 'done') {
600
+ return roundResult.parse(round.result);
601
+ }
602
+ if (round?.state === 'failed') {
603
+ throw new Error(round.reason || 'the model round failed');
604
+ }
605
+ if (round?.state === 'cancelled') {
606
+ throw new AbortedError();
607
+ }
608
+ return undefined;
609
+ }
610
+ function lastSwitch(chunks, from) {
611
+ let last;
612
+ for (const chunk of chunks) {
613
+ if (chunk.type === 'agent-switch' && chunk.seq > from && (!last || chunk.seq > last.seq)) {
614
+ last = chunk;
615
+ }
616
+ }
617
+ return last?.agentSwitch?.agentId;
618
+ }
619
+ function noop() { }
@@ -0,0 +1,11 @@
1
+ export declare const MAX_PDF_PAGE_IMAGES = 32;
2
+ export declare const CHARS_PER_TOKEN = 4;
3
+ export interface PdfReading {
4
+ readonly ctxSize: number;
5
+ readonly cacheTokens?: number;
6
+ }
7
+ export interface PdfRoom {
8
+ tokens: number;
9
+ images: number;
10
+ }
11
+ export declare function pdfImageRoom({ ctxSize, cacheTokens }: PdfReading, textChars: number): PdfRoom;
@@ -0,0 +1,12 @@
1
+ const DOCUMENT_SHARE = 0.5;
2
+ const ANSWER_SHARE = 0.25;
3
+ export const MAX_PDF_PAGE_IMAGES = 32;
4
+ export const CHARS_PER_TOKEN = 4;
5
+ export function pdfImageRoom({ ctxSize, cacheTokens }, textChars) {
6
+ const share = ctxSize * DOCUMENT_SHARE;
7
+ const free = cacheTokens === undefined ? share : Math.min(share, ctxSize * (1 - ANSWER_SHARE) - cacheTokens);
8
+ return {
9
+ tokens: Math.max(0, Math.floor(free - textChars / CHARS_PER_TOKEN)),
10
+ images: MAX_PDF_PAGE_IMAGES
11
+ };
12
+ }
@@ -0,0 +1,25 @@
1
+ import * as z from 'zod';
2
+ import type { PdfBounds } from '../core/pdf/figure.ts';
3
+ import type { PdfDoc } from '../core/pdf/rasterize.ts';
4
+ import type { PdfRoom } from './pdf-budget.ts';
5
+ export declare const PDF_PAGES_MIME = "application/vnd.qvac.pdf-pages";
6
+ export interface PdfShot {
7
+ readonly page: number;
8
+ readonly clip?: PdfBounds;
9
+ readonly label: string;
10
+ }
11
+ export interface PdfSelection {
12
+ readonly pageCount: number;
13
+ readonly shots: ReadonlyArray<PdfShot>;
14
+ readonly cutAt?: number;
15
+ }
16
+ export declare const PdfBoundsSchema: z.ZodObject<{
17
+ x: z.ZodNumber;
18
+ y: z.ZodNumber;
19
+ width: z.ZodNumber;
20
+ height: z.ZodNumber;
21
+ }, z.core.$strip>;
22
+ export declare function pdfSelectionFileName(pdfFileName: string): string;
23
+ export declare function packPdfSelection(selection: PdfSelection): Uint8Array;
24
+ export declare function parsePdfSelection(bytes: Uint8Array): PdfSelection;
25
+ export declare function selectPdfPages(doc: PdfDoc, room: PdfRoom): Promise<PdfSelection>;