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

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