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

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 +1203 -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 +18 -4
  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 +74 -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,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>;
@@ -0,0 +1,75 @@
1
+ import b4a from 'b4a';
2
+ import * as z from 'zod';
3
+ import { frameTokens } from './video-budget.js';
4
+ export const PDF_PAGES_MIME = 'application/vnd.qvac.pdf-pages';
5
+ export const PdfBoundsSchema = z.object({
6
+ x: z.number(),
7
+ y: z.number(),
8
+ width: z.number().positive(),
9
+ height: z.number().positive()
10
+ });
11
+ const SelectionSchema = z.object({
12
+ version: z.literal(1),
13
+ pageCount: z.number().int().nonnegative(),
14
+ shots: z.array(z.object({
15
+ page: z.number().int().nonnegative(),
16
+ clip: PdfBoundsSchema.optional(),
17
+ label: z.string()
18
+ })),
19
+ cutAt: z.number().int().nonnegative().optional()
20
+ });
21
+ export function pdfSelectionFileName(pdfFileName) {
22
+ return `${pdfFileName}.pages`;
23
+ }
24
+ export function packPdfSelection(selection) {
25
+ return b4a.from(JSON.stringify({ version: 1, ...selection }));
26
+ }
27
+ export function parsePdfSelection(bytes) {
28
+ const { version: _, ...selection } = SelectionSchema.parse(JSON.parse(b4a.toString(bytes)));
29
+ return selection;
30
+ }
31
+ function shotLabel(page, names = []) {
32
+ return names.length ? `page ${page + 1} (${names.join(', ')})` : `page ${page + 1}`;
33
+ }
34
+ export async function selectPdfPages(doc, room) {
35
+ const pageCount = doc.pageCount();
36
+ const shots = [];
37
+ let cutAt;
38
+ for (let page = 0; page < pageCount; page++) {
39
+ let shot;
40
+ try {
41
+ shot = await pictured(doc, page);
42
+ }
43
+ catch {
44
+ continue;
45
+ }
46
+ if (!shot) {
47
+ continue;
48
+ }
49
+ if (room.images <= 0) {
50
+ return { pageCount, shots, cutAt: cutAt ?? page };
51
+ }
52
+ const cost = frameTokens(doc.renderSize(page, shot.clip));
53
+ if (cost > room.tokens) {
54
+ cutAt ??= page;
55
+ continue;
56
+ }
57
+ room.tokens -= cost;
58
+ room.images--;
59
+ shots.push(shot);
60
+ }
61
+ return cutAt === undefined ? { pageCount, shots } : { pageCount, shots, cutAt };
62
+ }
63
+ async function pictured(doc, page) {
64
+ const flags = doc.pageFlags(page);
65
+ if (flags.hasText && !flags.hasImage) {
66
+ return null;
67
+ }
68
+ if (!flags.hasText && !flags.hasImage && (await doc.blank(page))) {
69
+ return null;
70
+ }
71
+ const figure = flags.hasText ? doc.figure(page) : null;
72
+ return figure
73
+ ? { page, clip: figure.clip, label: shotLabel(page, figure.names) }
74
+ : { page, label: shotLabel(page) };
75
+ }
@@ -0,0 +1,65 @@
1
+ import { type AbortSignal } from 'bare-abort-controller';
2
+ import type { ModelRoundRequest } from '@qvac/harness';
3
+ import type { MediaRoundPort } from '@qvac/harness/lib/contract/index.ts';
4
+ import type { LoggerInterface } from '@qvac/logging';
5
+ import type { AssistantChunk, AssistantChunkList } from '../../spec/hyperschema/types.d.ts';
6
+ import type { Capabilities, WatchStream } from '../api/index.ts';
7
+ import { type ScopedCapabilities } from '../mesh-scoped-engine.ts';
8
+ import type { Harness } from './harness.ts';
9
+ import type { MediaKind } from '../probe-rounds.ts';
10
+ import { type MediaSource } from './model-round.ts';
11
+ export interface RoundHostOptions {
12
+ readonly engine: Capabilities;
13
+ readonly serve: NonNullable<Harness['serveModelRound']>;
14
+ readonly deviceId: () => Buffer;
15
+ readonly media?: RoundMedia | null;
16
+ readonly load?: RoundLoad | null;
17
+ readonly generation?: RoundGeneration | null;
18
+ readonly built?: (meshId: string, chatId: string) => void;
19
+ readonly log?: LoggerInterface | null;
20
+ }
21
+ export type RoundLoad = (engine: ScopedCapabilities, agentId: string) => Promise<ModelRoundRequest['load']>;
22
+ export interface RoundMedia {
23
+ resolve(sources: ReadonlyArray<MediaSource>, served: {
24
+ readonly id: string;
25
+ readonly modelId: string;
26
+ readonly signal: AbortSignal;
27
+ }): Promise<Array<string | null>>;
28
+ release(id: string): void;
29
+ }
30
+ export interface GenerationWait {
31
+ readonly engine: ScopedCapabilities;
32
+ readonly agentId: string;
33
+ readonly kind: MediaKind;
34
+ readonly signal: AbortSignal;
35
+ }
36
+ export interface RoundGeneration {
37
+ readonly serve: MediaRoundPort;
38
+ ready(wait: GenerationWait): Promise<boolean>;
39
+ }
40
+ export declare function servedCacheKey(round: AssistantChunk, ownerKey: string | null | undefined): string | undefined;
41
+ export declare class RoundHost {
42
+ private readonly _opts;
43
+ private readonly _serving;
44
+ private readonly _keys;
45
+ private readonly _built;
46
+ constructor(opts: RoundHostOptions);
47
+ follow(meshId: string, frames: WatchStream<AssistantChunkList>): Promise<void>;
48
+ left(chatId: string, agentId: string): string[];
49
+ holds(chatId: string): boolean;
50
+ stop(): void;
51
+ drop(meshId: string): void;
52
+ private _reconcile;
53
+ private _pick;
54
+ private _serve;
55
+ private _take;
56
+ private _provides;
57
+ private _load;
58
+ private _answer;
59
+ private _generate;
60
+ private _stored;
61
+ private _probe;
62
+ private _claimKey;
63
+ private _retake;
64
+ private _takeFor;
65
+ }
@@ -0,0 +1,332 @@
1
+ import b4a from 'b4a';
2
+ import { AbortController } from 'bare-abort-controller';
3
+ import { createRagSourceTagFilter } from '../core/files/index.js';
4
+ import { errorMessage, isRecord } from '../guards.js';
5
+ import { chatKvCacheKey } from '../kv-cache-reclaim.js';
6
+ import { meshScoped } from '../mesh-scoped-engine.js';
7
+ import { isProbeRound } from '../probe-rounds.js';
8
+ import { RunTranscript } from '../run-transcript.js';
9
+ import { MODEL_MISSING, isModelMissing, mediaKindOf, mediaOptions, putBlob, readAttachment, readBlob, storedBytes } from './media-round.js';
10
+ import { servedRequest } from './model-round.js';
11
+ const LEFT = 'the round left this device';
12
+ const PLAIN_ID = /^[\w-]+(\/[\w-]+)*$/;
13
+ const REPAIR = /^\/r\d+$/;
14
+ export function servedCacheKey(round, ownerKey) {
15
+ const { chatId, runId } = round;
16
+ const agentId = round.modelRequest?.agents?.[0];
17
+ const parts = [chatId, agentId, runId];
18
+ if (!ownerKey || !agentId || !parts.every((part) => !!part && PLAIN_ID.test(part))) {
19
+ return undefined;
20
+ }
21
+ const base = chatKvCacheKey(chatId);
22
+ const repair = ownerKey.slice(base.length);
23
+ const kept = ownerKey.startsWith(base) && REPAIR.test(repair) ? repair : '';
24
+ return `${base}${kept}/a-${agentId}`;
25
+ }
26
+ export class RoundHost {
27
+ _opts;
28
+ _serving = new Map();
29
+ _keys = new Map();
30
+ _built = new Map();
31
+ constructor(opts) {
32
+ this._opts = opts;
33
+ }
34
+ async follow(meshId, frames) {
35
+ for await (const { chunks } of frames) {
36
+ this._reconcile(meshId, chunks ?? []);
37
+ }
38
+ }
39
+ left(chatId, agentId) {
40
+ const at = `${chatId}/${agentId}`;
41
+ const keys = [...(this._built.get(at) ?? [])];
42
+ this._built.delete(at);
43
+ return keys;
44
+ }
45
+ holds(chatId) {
46
+ const base = chatKvCacheKey(chatId);
47
+ return [...this._keys.keys()].some((key) => key.startsWith(`${base}/`));
48
+ }
49
+ stop() {
50
+ for (const { controller } of this._serving.values()) {
51
+ controller.abort(LEFT);
52
+ }
53
+ }
54
+ drop(meshId) {
55
+ for (const [id, serving] of this._serving) {
56
+ if (serving.meshId !== meshId)
57
+ continue;
58
+ serving.controller.abort(LEFT);
59
+ this._serving.delete(id);
60
+ }
61
+ }
62
+ _reconcile(meshId, rounds) {
63
+ const me = this._opts.deviceId();
64
+ for (const [id, serving] of this._serving) {
65
+ if (serving.meshId !== meshId)
66
+ continue;
67
+ const round = rounds.find((chunk) => chunk.id === id);
68
+ const takenBy = round?.modelRequest?.takenBy;
69
+ const stale = (round?.updatedAt ?? 0) < serving.takenAt;
70
+ const state = round?.modelRequest?.state;
71
+ const ours = takenBy
72
+ ? state === 'taken' && b4a.equals(takenBy, me)
73
+ : state === 'open' && stale;
74
+ if (serving.taken && !ours) {
75
+ serving.controller.abort(LEFT);
76
+ this._serving.delete(id);
77
+ }
78
+ }
79
+ for (const round of rounds) {
80
+ if (!this._serving.has(round.id)) {
81
+ this._pick(meshId, round, me);
82
+ }
83
+ }
84
+ }
85
+ _pick(meshId, round, me) {
86
+ const { state, takenBy, hostDeviceId } = round.modelRequest ?? {};
87
+ if (hostDeviceId && !b4a.equals(hostDeviceId, me)) {
88
+ return;
89
+ }
90
+ if (state === 'open' || (takenBy && b4a.equals(takenBy, me))) {
91
+ this._serve(meshId, round);
92
+ }
93
+ }
94
+ _serve(meshId, round) {
95
+ const serving = {
96
+ meshId,
97
+ controller: new AbortController(),
98
+ taken: false,
99
+ takenAt: 0
100
+ };
101
+ this._serving.set(round.id, serving);
102
+ const engine = meshScoped(this._opts.engine, meshId);
103
+ this._take(engine, round, serving)
104
+ .catch((err) => this._opts.log?.warn('rounds', 'round not served', { id: round.id, err }))
105
+ .finally(() => {
106
+ if (this._serving.get(round.id) === serving) {
107
+ this._serving.delete(round.id);
108
+ }
109
+ });
110
+ }
111
+ async _take(engine, round, serving) {
112
+ if (!(await this._provides(engine, round))) {
113
+ return;
114
+ }
115
+ const kind = mediaKindOf(round.modelRequest?.options);
116
+ if (kind) {
117
+ return this._generate(engine, { round, serving }, kind);
118
+ }
119
+ const { media } = this._opts;
120
+ const { signal } = serving.controller;
121
+ try {
122
+ const request = await servedRequest(engine, round, media
123
+ ? (sources, modelId) => media.resolve(sources, { id: round.id, modelId, signal })
124
+ : undefined);
125
+ if (!request || signal.aborted) {
126
+ return;
127
+ }
128
+ const load = await this._load(engine, round);
129
+ if (await this._takeFor(engine, round, serving)) {
130
+ serving.taken = true;
131
+ await this._answer(engine, { round, request: { ...request, load }, serving });
132
+ }
133
+ }
134
+ finally {
135
+ media?.release(round.id);
136
+ }
137
+ }
138
+ async _provides(engine, round) {
139
+ if (round.modelRequest?.hostDeviceId) {
140
+ return true;
141
+ }
142
+ for (const agentId of round.modelRequest?.agents ?? []) {
143
+ const agent = await engine.getAgent({ agentId }).catch(() => null);
144
+ if (agent && b4a.equals(agent.providerDeviceId, this._opts.deviceId())) {
145
+ return true;
146
+ }
147
+ }
148
+ return false;
149
+ }
150
+ async _load(engine, round) {
151
+ const agentId = round.modelRequest?.agents?.[0];
152
+ return agentId ? this._opts.load?.(engine, agentId) : undefined;
153
+ }
154
+ async _answer(engine, { round, request, serving }) {
155
+ const { signal } = serving.controller;
156
+ if (isProbeRound(round.modelRequest?.options)) {
157
+ return this._probe(engine, { round, request, serving });
158
+ }
159
+ const key = this._claimKey(round, request.cacheKey);
160
+ if (key && round.chatId) {
161
+ this._opts.built?.(serving.meshId, round.chatId);
162
+ }
163
+ const transcript = new RunTranscript(engine, {
164
+ chatId: round.chatId,
165
+ runId: request.runId,
166
+ deviceId: this._opts.deviceId(),
167
+ model: request.modelId,
168
+ parentId: round.id,
169
+ log: this._opts.log
170
+ });
171
+ const titles = await sourceTitles(engine, round);
172
+ let tags = sourceTags(titles);
173
+ let writing = Promise.resolve();
174
+ const write = (type, text) => {
175
+ if (text) {
176
+ writing = writing.then(() => transcript.text(type, text, request.round));
177
+ }
178
+ };
179
+ const emit = (event) => write(event.type, event.type === 'content' ? tags.push(event.text) : event.text);
180
+ const retake = () => {
181
+ tags = sourceTags(titles);
182
+ writing = writing.then(async () => {
183
+ await transcript.flush();
184
+ await this._retake(engine, round, serving);
185
+ });
186
+ return emit;
187
+ };
188
+ const io = { signal, emit, retake };
189
+ try {
190
+ const result = await this._opts.serve({ ...request, cacheKey: key }, io);
191
+ write('content', tags.flush());
192
+ await writing;
193
+ await transcript.flush();
194
+ await engine.settleModelRequest({ chunkId: round.id, state: 'done', result });
195
+ }
196
+ catch (err) {
197
+ await writing.catch(noop);
198
+ if (signal.aborted) {
199
+ return;
200
+ }
201
+ await transcript.flush().catch(noop);
202
+ await engine.settleModelRequest({
203
+ chunkId: round.id,
204
+ state: 'failed',
205
+ reason: errorMessage(err)
206
+ });
207
+ }
208
+ finally {
209
+ transcript.close();
210
+ if (key && this._keys.get(key) === request.runId) {
211
+ this._keys.delete(key);
212
+ }
213
+ }
214
+ }
215
+ async _generate(engine, { round, serving }, kind) {
216
+ const { generation } = this._opts;
217
+ const options = mediaOptions.safeParse(isRecord(round.modelRequest?.options) ? round.modelRequest.options.mediaRound : undefined);
218
+ const agentId = round.modelRequest?.agents?.[0];
219
+ if (!generation || !options.success || !agentId || !round.runId) {
220
+ return;
221
+ }
222
+ if (!(await this._takeFor(engine, round, serving))) {
223
+ return;
224
+ }
225
+ serving.taken = true;
226
+ const { signal } = serving.controller;
227
+ const settle = (result) => engine.settleModelRequest({ chunkId: round.id, state: 'done', result });
228
+ try {
229
+ if (!(await generation.ready({ engine, agentId, kind, signal }))) {
230
+ await settle(missing(kind));
231
+ return;
232
+ }
233
+ const { modelChoice, params, sources = [], refs } = options.data;
234
+ const { chatId } = round;
235
+ const images = await Promise.all(refs
236
+ ? refs.map(({ attachmentId }) => readAttachment(engine, { chatId, attachmentId }, signal))
237
+ : sources.map((blobId) => readBlob(engine, blobId, signal)));
238
+ const request = {
239
+ kind,
240
+ runId: round.runId,
241
+ modelChoice,
242
+ params,
243
+ images: images.length ? images : undefined,
244
+ sources: refs
245
+ };
246
+ const result = await generation.serve(request, { signal, tick: noop });
247
+ await settle(await this._stored(serving.meshId, engine, result));
248
+ }
249
+ catch (err) {
250
+ if (signal.aborted) {
251
+ return;
252
+ }
253
+ if (isModelMissing(err)) {
254
+ await settle(missing(kind));
255
+ return;
256
+ }
257
+ await engine.settleModelRequest({
258
+ chunkId: round.id,
259
+ state: 'failed',
260
+ reason: errorMessage(err)
261
+ });
262
+ }
263
+ }
264
+ async _stored(meshId, engine, result) {
265
+ if ('error' in result) {
266
+ return result;
267
+ }
268
+ const blobId = await putBlob(engine, meshId, storedBytes(result));
269
+ if (result.kind === 'image') {
270
+ return { kind: 'image', blobId };
271
+ }
272
+ const { format, gpuRequested, stats } = result;
273
+ return { kind: 'music', blobId, format, gpuRequested, stats };
274
+ }
275
+ async _probe(engine, { round, request, serving }) {
276
+ const { signal } = serving.controller;
277
+ const io = { signal, emit: noop, retake: () => noop };
278
+ try {
279
+ const result = await this._opts.serve(request, io);
280
+ await engine.settleModelRequest({ chunkId: round.id, state: 'done', result });
281
+ }
282
+ catch (err) {
283
+ if (!signal.aborted) {
284
+ await engine.settleModelRequest({
285
+ chunkId: round.id,
286
+ state: 'failed',
287
+ reason: errorMessage(err)
288
+ });
289
+ }
290
+ }
291
+ }
292
+ _claimKey(round, ownerKey) {
293
+ const key = servedCacheKey(round, ownerKey);
294
+ const runId = round.runId;
295
+ if (!key || !runId) {
296
+ return undefined;
297
+ }
298
+ const holder = this._keys.get(key);
299
+ const claimed = holder !== undefined && holder !== runId ? `${key}/r-${runId}` : key;
300
+ if (claimed === key) {
301
+ this._keys.set(key, runId);
302
+ }
303
+ const at = `${round.chatId}/${round.modelRequest?.agents?.[0]}`;
304
+ this._built.set(at, (this._built.get(at) ?? new Set()).add(claimed));
305
+ return claimed;
306
+ }
307
+ async _retake(engine, round, serving) {
308
+ if (!(await this._takeFor(engine, round, serving))) {
309
+ serving.controller.abort(LEFT);
310
+ }
311
+ }
312
+ async _takeFor(engine, round, serving) {
313
+ const taken = (await engine.takeModelRequest({ chunkId: round.id })).modelRequest;
314
+ const held = !!taken?.takenBy && b4a.equals(taken.takenBy, this._opts.deviceId());
315
+ serving.takenAt = held ? (taken?.takenAt ?? 0) : serving.takenAt;
316
+ return held;
317
+ }
318
+ }
319
+ async function sourceTitles(engine, round) {
320
+ const { chunks } = await engine.listChunks({ chatId: round.chatId, type: 'sources' });
321
+ const retrieved = (chunks ?? []).find((chunk) => chunk.runId === round.runId);
322
+ return retrieved?.sources?.sources.map((source) => source.title) ?? [];
323
+ }
324
+ function sourceTags(titles) {
325
+ const filter = createRagSourceTagFilter();
326
+ filter.add(titles);
327
+ return filter;
328
+ }
329
+ function missing(kind) {
330
+ return { error: `this device does not hold the ${kind} model`, code: MODEL_MISSING };
331
+ }
332
+ function noop() { }
@@ -1,7 +1,8 @@
1
- import type { InstallStep, SkillRequires, SkillSetup } from '@qvac/harness';
1
+ import { type InstallStep, type SkillRequires, type SkillSetup } from '@qvac/harness';
2
2
  import type { AssistantSkill } from '../../spec/hyperschema/types.d.ts';
3
3
  export interface Skill {
4
4
  name: string;
5
+ displayName?: string;
5
6
  description: string;
6
7
  status: string;
7
8
  tools: string[];
@@ -1,9 +1,10 @@
1
- import { readSetup as normalizeSkillSetup } from '@qvac/harness/lib/tools/skills/manifest-parse.ts';
1
+ import { normalizeSkillSetup } from '@qvac/harness';
2
2
  const TOKEN_AUTH = ['pkce-only', 'secret-in-body', 'secret-in-basic'];
3
3
  export function toEngineSkill(skill) {
4
4
  const setup = normalizeSkillSetup(skill.setup);
5
5
  return {
6
6
  name: skill.name,
7
+ displayName: skill.displayName,
7
8
  description: skill.description,
8
9
  tools: [...skill.tools],
9
10
  credentials: [...skill.credentials],
@@ -0,0 +1,12 @@
1
+ import type { AssistantChunkContentAttachment, AssistantUploadAttachmentResponse } from '../../spec/hyperschema/types.d.ts';
2
+ interface UploadWriter<Frame> {
3
+ readonly destroyed: boolean;
4
+ write(frame: Frame): boolean;
5
+ on(event: 'drain' | 'close', listener: () => void): unknown;
6
+ on(event: 'error', listener: (error: unknown) => void): unknown;
7
+ off(event: 'drain' | 'close', listener: () => void): unknown;
8
+ off(event: 'error', listener: (error: unknown) => void): unknown;
9
+ }
10
+ export declare function readUploadAttachment(frames: AsyncIterable<AssistantUploadAttachmentResponse>): Promise<AssistantChunkContentAttachment | null>;
11
+ export declare function writeUploadFrame<Frame>(stream: UploadWriter<Frame>, frame: Frame): Promise<void>;
12
+ export {};
@@ -0,0 +1,36 @@
1
+ export async function readUploadAttachment(frames) {
2
+ let attachment = null;
3
+ for await (const frame of frames) {
4
+ if (frame.attachment) {
5
+ attachment = frame.attachment;
6
+ }
7
+ }
8
+ return attachment;
9
+ }
10
+ export async function writeUploadFrame(stream, frame) {
11
+ if (stream.destroyed) {
12
+ throw new Error('attachment upload closed while writing');
13
+ }
14
+ if (stream.write(frame)) {
15
+ return;
16
+ }
17
+ await new Promise((resolve, reject) => {
18
+ const cleanup = () => {
19
+ stream.off('drain', drained);
20
+ stream.off('error', failed);
21
+ stream.off('close', closed);
22
+ };
23
+ const drained = () => {
24
+ cleanup();
25
+ resolve();
26
+ };
27
+ const failed = (error) => {
28
+ cleanup();
29
+ reject(error);
30
+ };
31
+ const closed = () => failed(new Error('attachment upload closed while writing'));
32
+ stream.on('drain', drained);
33
+ stream.on('error', failed);
34
+ stream.on('close', closed);
35
+ });
36
+ }
@@ -0,0 +1,13 @@
1
+ import { type Size, type VideoProbe } from '../core/video/frames.ts';
2
+ export declare const VIDEO_FRAME_EDGE = 512;
3
+ export declare const MAX_VIDEO_FRAMES = 32;
4
+ export declare const MIN_VIDEO_FRAMES = 8;
5
+ export interface ContextReading {
6
+ readonly ctxSize?: number;
7
+ readonly cacheTokens?: number;
8
+ }
9
+ export interface FrameBudget extends ContextReading {
10
+ readonly videos: number;
11
+ }
12
+ export declare function frameTokens({ width, height }: Size): number;
13
+ export declare function videoFrameCount(probe: VideoProbe, budget: FrameBudget): number;
@@ -0,0 +1,29 @@
1
+ import { frameSize } from '../core/video/frames.js';
2
+ export const VIDEO_FRAME_EDGE = 512;
3
+ export const MAX_VIDEO_FRAMES = 32;
4
+ export const MIN_VIDEO_FRAMES = 8;
5
+ const ANSWER_SHARE = 0.25;
6
+ const UNREAD_SHARE = 0.5;
7
+ const TILE = 32;
8
+ const FRAME_MARKER_TOKENS = 6;
9
+ export function frameTokens({ width, height }) {
10
+ return Math.ceil(width / TILE) * Math.ceil(height / TILE) + FRAME_MARKER_TOKENS;
11
+ }
12
+ function room({ ctxSize, cacheTokens }) {
13
+ if (!ctxSize) {
14
+ return null;
15
+ }
16
+ if (cacheTokens === undefined) {
17
+ return ctxSize * UNREAD_SHARE;
18
+ }
19
+ return ctxSize * (1 - ANSWER_SHARE) - cacheTokens;
20
+ }
21
+ export function videoFrameCount(probe, budget) {
22
+ const perSecond = Math.max(1, Math.floor(probe.duration));
23
+ const free = room(budget);
24
+ const fits = free === null
25
+ ? MAX_VIDEO_FRAMES
26
+ : Math.floor(free / Math.max(1, budget.videos) / frameTokens(frameSize(probe, VIDEO_FRAME_EDGE)));
27
+ const frames = Math.min(MAX_VIDEO_FRAMES, Math.max(MIN_VIDEO_FRAMES, fits));
28
+ return Math.min(perSecond, frames);
29
+ }
@@ -1,12 +1,15 @@
1
1
  import type { Core } from './core.ts';
2
2
  import type { DeviceMetadata } from './core/mesh.ts';
3
+ import type { Logger } from './logger-type.ts';
3
4
  import { Client, type ClientOptions } from './client.ts';
4
5
  export interface AssistantClientOptions extends ClientOptions {
6
+ logger?: Logger | null;
5
7
  sidecar?: boolean;
6
8
  storagePath: string;
7
9
  device?: DeviceMetadata;
8
10
  meshSeed?: Buffer;
9
11
  meshKey?: Buffer;
12
+ blindPeerKeys?: ReadonlyArray<Buffer>;
10
13
  bootstrapNodes?: ReadonlyArray<{
11
14
  host: string;
12
15
  port: number;
@@ -15,7 +18,8 @@ export interface AssistantClientOptions extends ClientOptions {
15
18
  }
16
19
  export declare class AssistantClient extends Client {
17
20
  private readonly _inline;
18
- constructor({ sidecar: spawnSidecar, storagePath, device, meshSeed, meshKey, bootstrapNodes, entry, ...engineOptions }: AssistantClientOptions);
21
+ private readonly _sidecar;
22
+ constructor({ sidecar: spawnSidecar, storagePath, device, meshSeed, meshKey, bootstrapNodes, blindPeerKeys, entry, ...engineOptions }: AssistantClientOptions);
19
23
  get core(): Core | null;
20
24
  _close(): Promise<void>;
21
25
  }