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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (509) hide show
  1. package/CHANGELOG.md +852 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +0 -1
  4. package/dist-lib/index.js +0 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +7 -0
  17. package/dist-lib/lib/api/chunk-delta.js +33 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +64 -13
  20. package/dist-lib/lib/api/config.d.ts +2 -1
  21. package/dist-lib/lib/api/config.js +3 -2
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +10 -8
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +20 -10
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  35. package/dist-lib/lib/api/host-run-log.js +35 -83
  36. package/dist-lib/lib/api/index.d.ts +28 -6
  37. package/dist-lib/lib/api/index.js +101 -33
  38. package/dist-lib/lib/api/instrument.d.ts +2 -2
  39. package/dist-lib/lib/api/instrument.js +12 -44
  40. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  41. package/dist-lib/lib/api/knowledge.js +25 -7
  42. package/dist-lib/lib/api/local-files.d.ts +5 -1
  43. package/dist-lib/lib/api/local-files.js +9 -5
  44. package/dist-lib/lib/api/logs.js +3 -3
  45. package/dist-lib/lib/api/members.d.ts +10 -1
  46. package/dist-lib/lib/api/members.js +64 -17
  47. package/dist-lib/lib/api/mesh.d.ts +12 -2
  48. package/dist-lib/lib/api/mesh.js +10 -6
  49. package/dist-lib/lib/api/model-download.d.ts +2 -1
  50. package/dist-lib/lib/api/model-download.js +2 -2
  51. package/dist-lib/lib/api/network.d.ts +10 -2
  52. package/dist-lib/lib/api/network.js +8 -2
  53. package/dist-lib/lib/api/notifications.d.ts +3 -1
  54. package/dist-lib/lib/api/notifications.js +6 -5
  55. package/dist-lib/lib/api/projects.d.ts +20 -0
  56. package/dist-lib/lib/api/projects.js +165 -0
  57. package/dist-lib/lib/api/rag.d.ts +0 -1
  58. package/dist-lib/lib/api/rag.js +47 -23
  59. package/dist-lib/lib/api/served.d.ts +17 -0
  60. package/dist-lib/lib/api/served.js +47 -0
  61. package/dist-lib/lib/api/sync.d.ts +2 -1
  62. package/dist-lib/lib/api/sync.js +2 -2
  63. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  64. package/dist-lib/lib/api/tool-activity.js +4 -3
  65. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-configs.js +6 -9
  67. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  68. package/dist-lib/lib/api/upload-frames.js +0 -1
  69. package/dist-lib/lib/api/watchable.d.ts +3 -2
  70. package/dist-lib/lib/api/watchable.js +2 -3
  71. package/dist-lib/lib/api/workspace.d.ts +5 -0
  72. package/dist-lib/lib/api/workspace.js +48 -0
  73. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  74. package/dist-lib/lib/assistant/fake-models.js +112 -0
  75. package/dist-lib/lib/assistant/harness.d.ts +29 -29
  76. package/dist-lib/lib/assistant/harness.js +34 -6
  77. package/dist-lib/lib/assistant/history.d.ts +30 -17
  78. package/dist-lib/lib/assistant/history.js +168 -82
  79. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  80. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  81. package/dist-lib/lib/assistant/message.d.ts +21 -0
  82. package/dist-lib/lib/assistant/message.js +43 -0
  83. package/dist-lib/lib/assistant/model-round.d.ts +95 -0
  84. package/dist-lib/lib/assistant/model-round.js +591 -0
  85. package/dist-lib/lib/assistant/pdf-budget.d.ts +3 -0
  86. package/dist-lib/lib/assistant/pdf-budget.js +13 -0
  87. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  88. package/dist-lib/lib/assistant/round-host.js +239 -0
  89. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  90. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  91. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  92. package/dist-lib/lib/assistant/video-budget.js +29 -0
  93. package/dist-lib/lib/assistant-client.d.ts +2 -0
  94. package/dist-lib/lib/assistant-client.js +4 -3
  95. package/dist-lib/lib/assistant-tree.d.ts +8 -3
  96. package/dist-lib/lib/assistant-tree.js +58 -18
  97. package/dist-lib/lib/assistant.d.ts +76 -20
  98. package/dist-lib/lib/assistant.js +1659 -1070
  99. package/dist-lib/lib/audio-format.js +1 -1
  100. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  101. package/dist-lib/lib/chat-suggestion.js +47 -0
  102. package/dist-lib/lib/client.d.ts +2 -2
  103. package/dist-lib/lib/constants.d.ts +7 -0
  104. package/dist-lib/lib/constants.js +7 -0
  105. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  106. package/dist-lib/lib/core/agent-copies.js +40 -0
  107. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  108. package/dist-lib/lib/core/agent-hosting.js +71 -0
  109. package/dist-lib/lib/core/agent.d.ts +9 -1
  110. package/dist-lib/lib/core/agent.js +45 -19
  111. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  112. package/dist-lib/lib/core/archived-mesh.js +77 -58
  113. package/dist-lib/lib/core/async-iterable.js +1 -1
  114. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  115. package/dist-lib/lib/core/blind-peers.js +1 -0
  116. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  117. package/dist-lib/lib/core/chat-activity.js +36 -22
  118. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  119. package/dist-lib/lib/core/chat-copy.js +395 -0
  120. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  121. package/dist-lib/lib/core/chat-fork.js +245 -0
  122. package/dist-lib/lib/core/chat-group.js +8 -7
  123. package/dist-lib/lib/core/chat-move.d.ts +71 -0
  124. package/dist-lib/lib/core/chat-move.js +567 -0
  125. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  126. package/dist-lib/lib/core/chat-order.js +19 -4
  127. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  128. package/dist-lib/lib/core/chat-project.js +15 -0
  129. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  130. package/dist-lib/lib/core/chat-read.js +49 -0
  131. package/dist-lib/lib/core/chat-search.js +14 -12
  132. package/dist-lib/lib/core/chat.d.ts +34 -4
  133. package/dist-lib/lib/core/chat.js +122 -39
  134. package/dist-lib/lib/core/chunk.d.ts +21 -4
  135. package/dist-lib/lib/core/chunk.js +138 -23
  136. package/dist-lib/lib/core/collections.d.ts +28 -0
  137. package/dist-lib/lib/core/collections.js +28 -0
  138. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  139. package/dist-lib/lib/core/contract/agent-join.js +108 -0
  140. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  141. package/dist-lib/lib/core/contract/agents.js +141 -3
  142. package/dist-lib/lib/core/contract/chat.d.ts +1 -0
  143. package/dist-lib/lib/core/contract/chat.js +42 -3
  144. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  145. package/dist-lib/lib/core/contract/chunks.js +112 -35
  146. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  147. package/dist-lib/lib/core/contract/index.js +35 -11
  148. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  149. package/dist-lib/lib/core/contract/indexing.js +51 -7
  150. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  151. package/dist-lib/lib/core/contract/invites.js +18 -9
  152. package/dist-lib/lib/core/contract/joined-meshes.js +2 -1
  153. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  154. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  155. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  156. package/dist-lib/lib/core/contract/members.js +34 -4
  157. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  158. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  159. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  160. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  161. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  162. package/dist-lib/lib/core/contract/mesh-rules.js +31 -0
  163. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  164. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  165. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  166. package/dist-lib/lib/core/contract/model-requests.js +279 -0
  167. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  168. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  169. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  170. package/dist-lib/lib/core/contract/open-join.js +77 -0
  171. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  172. package/dist-lib/lib/core/contract/project-device-keys.js +29 -0
  173. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  174. package/dist-lib/lib/core/contract/project-host-keys.js +40 -0
  175. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/project-order.js +25 -0
  177. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  178. package/dist-lib/lib/core/contract/projects.js +328 -0
  179. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  180. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  181. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  182. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  183. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  184. package/dist-lib/lib/core/contract/roles.js +120 -0
  185. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  186. package/dist-lib/lib/core/contract/run-requests.js +75 -0
  187. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  188. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  189. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  190. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  191. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  192. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  193. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  194. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  195. package/dist-lib/lib/core/contract/workspace.js +317 -0
  196. package/dist-lib/lib/core/contract/writers.js +82 -12
  197. package/dist-lib/lib/core/departures.d.ts +16 -5
  198. package/dist-lib/lib/core/departures.js +79 -6
  199. package/dist-lib/lib/core/device-control.d.ts +21 -0
  200. package/dist-lib/lib/core/device-control.js +91 -0
  201. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  202. package/dist-lib/lib/core/device-seal.js +22 -0
  203. package/dist-lib/lib/core/devices.js +1 -1
  204. package/dist-lib/lib/core/document-attachment.d.ts +7 -0
  205. package/dist-lib/lib/core/document-attachment.js +9 -0
  206. package/dist-lib/lib/core/files/attachments.js +5 -4
  207. package/dist-lib/lib/core/files/index.d.ts +21 -11
  208. package/dist-lib/lib/core/files/index.js +114 -28
  209. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  210. package/dist-lib/lib/core/files/knowledge.js +77 -5
  211. package/dist-lib/lib/core/files/preview/index.js +6 -2
  212. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  213. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  214. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  215. package/dist-lib/lib/core/files/processing/document.js +26 -2
  216. package/dist-lib/lib/core/files/processing/index.d.ts +7 -2
  217. package/dist-lib/lib/core/files/processing/index.js +91 -71
  218. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  219. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  220. package/dist-lib/lib/core/files/processing/source.d.ts +3 -0
  221. package/dist-lib/lib/core/files/processing/source.js +9 -4
  222. package/dist-lib/lib/core/files/processing/state.d.ts +4 -1
  223. package/dist-lib/lib/core/files/processing/state.js +2 -1
  224. package/dist-lib/lib/core/files/rag/build.d.ts +4 -1
  225. package/dist-lib/lib/core/files/rag/build.js +18 -7
  226. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  227. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  228. package/dist-lib/lib/core/files/rag/index.d.ts +12 -1
  229. package/dist-lib/lib/core/files/rag/index.js +29 -7
  230. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  231. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  232. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  233. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  234. package/dist-lib/lib/core/files/rag/load.js +6 -3
  235. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  236. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  237. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  238. package/dist-lib/lib/core/files/rag/produce.js +30 -18
  239. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -1
  240. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  241. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  242. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  243. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  244. package/dist-lib/lib/core/files/records/index.js +1 -1
  245. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  246. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  247. package/dist-lib/lib/core/files/records/purge.js +13 -8
  248. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  249. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  250. package/dist-lib/lib/core/files/records/routing.js +6 -2
  251. package/dist-lib/lib/core/files/records/source.js +3 -5
  252. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  253. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  254. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  255. package/dist-lib/lib/core/files/store/blob.js +2 -2
  256. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  257. package/dist-lib/lib/core/files/store/index.js +4 -1
  258. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  259. package/dist-lib/lib/core/files/store/reference.js +12 -2
  260. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  261. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  262. package/dist-lib/lib/core/files/upload.js +53 -14
  263. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  264. package/dist-lib/lib/core/fs-drives.js +30 -18
  265. package/dist-lib/lib/core/id.d.ts +1 -0
  266. package/dist-lib/lib/core/id.js +3 -0
  267. package/dist-lib/lib/core/identity.d.ts +3 -1
  268. package/dist-lib/lib/core/identity.js +25 -4
  269. package/dist-lib/lib/core/invite.d.ts +4 -0
  270. package/dist-lib/lib/core/invite.js +19 -6
  271. package/dist-lib/lib/core/local/files.d.ts +2 -1
  272. package/dist-lib/lib/core/local/files.js +5 -7
  273. package/dist-lib/lib/core/local/index.d.ts +76 -6
  274. package/dist-lib/lib/core/local/index.js +209 -19
  275. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  276. package/dist-lib/lib/core/local/run-logs.js +132 -0
  277. package/dist-lib/lib/core/member-key.d.ts +7 -0
  278. package/dist-lib/lib/core/member-key.js +24 -0
  279. package/dist-lib/lib/core/membership.d.ts +3 -14
  280. package/dist-lib/lib/core/membership.js +3 -96
  281. package/dist-lib/lib/core/mesh.d.ts +94 -28
  282. package/dist-lib/lib/core/mesh.js +527 -144
  283. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  284. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  285. package/dist-lib/lib/core/migrations/file-index.js +2 -4
  286. package/dist-lib/lib/core/migrations/index.js +6 -2
  287. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  288. package/dist-lib/lib/core/model-requests.js +65 -0
  289. package/dist-lib/lib/core/next-frame.js +2 -1
  290. package/dist-lib/lib/core/notification.js +4 -2
  291. package/dist-lib/lib/core/pdf/rasterize.d.ts +2 -2
  292. package/dist-lib/lib/core/pdf/rasterize.js +5 -6
  293. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  294. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +47 -40
  295. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  296. package/dist-lib/lib/core/project-keys.js +56 -0
  297. package/dist-lib/lib/core/prompt-history.js +4 -4
  298. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  299. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  300. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  301. package/dist-lib/lib/core/public-mesh.js +88 -0
  302. package/dist-lib/lib/core/purge.d.ts +3 -0
  303. package/dist-lib/lib/core/purge.js +7 -0
  304. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  305. package/dist-lib/lib/core/run-driver.js +20 -0
  306. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  307. package/dist-lib/lib/core/run-requests.js +59 -0
  308. package/dist-lib/lib/core/send.d.ts +2 -0
  309. package/dist-lib/lib/core/send.js +17 -4
  310. package/dist-lib/lib/core/senders.d.ts +18 -0
  311. package/dist-lib/lib/core/senders.js +52 -0
  312. package/dist-lib/lib/core/shared-agents.d.ts +39 -0
  313. package/dist-lib/lib/core/shared-agents.js +255 -0
  314. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  315. package/dist-lib/lib/core/skill-secrets.js +90 -72
  316. package/dist-lib/lib/core/sync/background.d.ts +47 -0
  317. package/dist-lib/lib/core/sync/background.js +162 -0
  318. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  319. package/dist-lib/lib/core/sync/changed.js +7 -0
  320. package/dist-lib/lib/core/sync/devices.js +1 -1
  321. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  322. package/dist-lib/lib/core/sync/files.js +50 -72
  323. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  324. package/dist-lib/lib/core/sync/index.js +154 -81
  325. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  326. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  327. package/dist-lib/lib/core/system-info.d.ts +2 -2
  328. package/dist-lib/lib/core/system-info.js +10 -11
  329. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  330. package/dist-lib/lib/core/tool-configs.js +11 -11
  331. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  332. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  333. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  334. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  335. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  336. package/dist-lib/lib/core/video/attachment.js +7 -0
  337. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  338. package/dist-lib/lib/core/video/digest.js +57 -0
  339. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  340. package/dist-lib/lib/core/video/frames.js +224 -0
  341. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  342. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  343. package/dist-lib/lib/core.d.ts +249 -79
  344. package/dist-lib/lib/core.js +3369 -1460
  345. package/dist-lib/lib/credential-pusher.d.ts +6 -0
  346. package/dist-lib/lib/credential-pusher.js +77 -60
  347. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  348. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  349. package/dist-lib/lib/custom-model-task.js +2 -2
  350. package/dist-lib/lib/diagnostics.d.ts +7 -0
  351. package/dist-lib/lib/diagnostics.js +22 -0
  352. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  353. package/dist-lib/lib/doctor/checks.js +272 -0
  354. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  355. package/dist-lib/lib/doctor/redact.js +31 -0
  356. package/dist-lib/lib/doctor/render.d.ts +8 -0
  357. package/dist-lib/lib/doctor/render.js +83 -0
  358. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  359. package/dist-lib/lib/doctor/tree.js +167 -0
  360. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  361. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  362. package/dist-lib/lib/errors.d.ts +790 -0
  363. package/dist-lib/lib/errors.js +724 -0
  364. package/dist-lib/lib/fs-drive-bridge.d.ts +1 -1
  365. package/dist-lib/lib/fs-drive-bridge.js +4 -1
  366. package/dist-lib/lib/guards.d.ts +1 -0
  367. package/dist-lib/lib/guards.js +4 -0
  368. package/dist-lib/lib/inference-calls.d.ts +1 -2
  369. package/dist-lib/lib/inference-calls.js +2 -10
  370. package/dist-lib/lib/knowledge-search.js +13 -18
  371. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  372. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  373. package/dist-lib/lib/log.d.ts +7 -6
  374. package/dist-lib/lib/log.js +14 -7
  375. package/dist-lib/lib/logger-type.d.ts +2 -5
  376. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  377. package/dist-lib/lib/model-download-status.d.ts +3 -3
  378. package/dist-lib/lib/model-download.d.ts +11 -12
  379. package/dist-lib/lib/model-download.js +63 -22
  380. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  381. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  382. package/dist-lib/lib/model-memory-cap.js +69 -0
  383. package/dist-lib/lib/models-watch.d.ts +1 -1
  384. package/dist-lib/lib/models-watch.js +4 -4
  385. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  386. package/dist-lib/lib/oauth/flow-core.js +5 -3
  387. package/dist-lib/lib/oauth/flow.js +1 -1
  388. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  389. package/dist-lib/lib/oauth/loopback.js +57 -12
  390. package/dist-lib/lib/oauth/providers.js +4 -2
  391. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  392. package/dist-lib/lib/oauth/register.js +35 -19
  393. package/dist-lib/lib/oauth/request.d.ts +10 -0
  394. package/dist-lib/lib/oauth/request.js +22 -0
  395. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  396. package/dist-lib/lib/oauth/types.d.ts +3 -0
  397. package/dist-lib/lib/oauth.d.ts +2 -1
  398. package/dist-lib/lib/oauth.js +1 -0
  399. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  400. package/dist-lib/lib/persistent-dir.js +9 -0
  401. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  402. package/dist-lib/lib/probe-rounds.js +5 -0
  403. package/dist-lib/lib/run-input.d.ts +14 -0
  404. package/dist-lib/lib/run-input.js +33 -0
  405. package/dist-lib/lib/run-notices.d.ts +3 -0
  406. package/dist-lib/lib/run-notices.js +8 -2
  407. package/dist-lib/lib/run-replay.d.ts +32 -0
  408. package/dist-lib/lib/run-replay.js +121 -0
  409. package/dist-lib/lib/run-transcript.d.ts +11 -12
  410. package/dist-lib/lib/run-transcript.js +16 -18
  411. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  412. package/dist-lib/lib/task.js +6 -4
  413. package/dist-lib/lib/test-env.d.ts +1 -0
  414. package/dist-lib/lib/test-env.js +4 -0
  415. package/dist-lib/schema/build.js +3 -1
  416. package/dist-lib/schema/config.d.ts +1 -1
  417. package/dist-lib/schema/config.js +1 -1
  418. package/dist-lib/schema/content.d.ts +5 -1
  419. package/dist-lib/schema/content.js +58 -11
  420. package/dist-lib/schema/engine.d.ts +1 -0
  421. package/dist-lib/schema/engine.js +709 -116
  422. package/dist-lib/schema/field-order.js +2 -1
  423. package/dist-lib/schema/indexes.d.ts +3 -0
  424. package/dist-lib/schema/indexes.js +30 -3
  425. package/dist-lib/schema/local.js +72 -4
  426. package/dist-lib/schema/qvac.d.ts +4 -1
  427. package/dist-lib/schema/qvac.js +364 -12
  428. package/dist-lib/spec/bind.js +209 -48
  429. package/dist-lib/spec/calls.js +45 -5
  430. package/dist-lib/spec/capabilities.d.ts +98 -18
  431. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  432. package/dist-lib/spec/hrpc/hrpc.json +726 -206
  433. package/dist-lib/spec/hrpc/index.js +832 -345
  434. package/dist-lib/spec/hrpc/messages.js +6906 -4832
  435. package/dist-lib/spec/hyperschema/index.js +6906 -4832
  436. package/dist-lib/spec/hyperschema/schema.json +4744 -3139
  437. package/dist-lib/spec/hyperschema/types.d.ts +461 -61
  438. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  439. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  440. package/dist-lib/spec/local/hyperdb/messages.js +1506 -484
  441. package/dist-lib/spec/local/hyperschema/index.js +542 -13
  442. package/dist-lib/spec/local/hyperschema/schema.json +319 -1
  443. package/dist-lib/spec/local/hyperschema/types.d.ts +78 -2
  444. package/dist-lib/spec/mesh/hyperdb/db.json +371 -5
  445. package/dist-lib/spec/mesh/hyperdb/index.js +1564 -5
  446. package/dist-lib/spec/mesh/hyperdb/messages.js +6023 -1246
  447. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +187 -1
  448. package/dist-lib/spec/mesh/hyperdispatch/index.js +528 -1
  449. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3449 -217
  450. package/dist-lib/spec/mesh/hyperschema/index.js +3449 -217
  451. package/dist-lib/spec/mesh/hyperschema/schema.json +1865 -19
  452. package/dist-lib/spec/mesh/hyperschema/types.d.ts +470 -6
  453. package/package.json +50 -35
  454. package/worker/assistant-sidecar.mjs +15 -2
  455. package/worker/stow-entry.mjs +2 -0
  456. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  457. package/dist-lib/lib/core/contract/compute.js +0 -48
  458. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  459. package/dist-lib/lib/core/device-invites.js +0 -63
  460. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  461. package/dist-lib/lib/core/grant-expiry.js +0 -66
  462. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  463. package/dist-lib/lib/core/handoff-channel.js +0 -123
  464. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  465. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  466. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  467. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  468. package/dist-lib/lib/core/hosted-agents.js +0 -140
  469. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  470. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  471. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  472. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  473. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  474. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  475. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  476. package/dist-lib/lib/core/secret-handoff.js +0 -29
  477. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  478. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  479. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  480. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  481. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  482. package/dist-lib/lib/image-cache-dir.js +0 -5
  483. package/dist-lib/lib/log-levels.d.ts +0 -7
  484. package/dist-lib/lib/log-levels.js +0 -1
  485. package/dist-lib/lib/logger.d.ts +0 -5
  486. package/dist-lib/lib/logger.js +0 -18
  487. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  488. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  489. package/tui/README.md +0 -142
  490. package/tui/app.mjs +0 -6939
  491. package/tui/boot.mjs +0 -111
  492. package/tui/index.mjs +0 -53
  493. package/tui/lib/boot-timing.mjs +0 -41
  494. package/tui/lib/busy-words.mjs +0 -116
  495. package/tui/lib/export.mjs +0 -194
  496. package/tui/lib/knowledge-command.mjs +0 -190
  497. package/tui/lib/knowledge-import.mjs +0 -171
  498. package/tui/lib/render.mjs +0 -196
  499. package/tui/lib/save-file.mjs +0 -88
  500. package/tui/lib/select.mjs +0 -81
  501. package/tui/lib/selection.mjs +0 -18
  502. package/tui/lib/setup.mjs +0 -101
  503. package/tui/lib/sidebar.mjs +0 -63
  504. package/tui/lib/splash-art.mjs +0 -107
  505. package/tui/lib/splash.mjs +0 -18
  506. package/tui/lib/upload-frames.mjs +0 -9
  507. package/tui/lib/usage.mjs +0 -59
  508. package/tui/lib/wrap.mjs +0 -143
  509. package/tui/main.mjs +0 -264
@@ -1,5 +1,4 @@
1
1
  import { toAsyncIterable } from '../core/async-iterable.js';
2
- export const UPLOAD_NAMES_NO_MESH = 'an upload must name its mesh on its first frame';
3
2
  export async function openUpload(frames) {
4
3
  const iterator = toAsyncIterable(frames)[Symbol.asyncIterator]();
5
4
  const first = await iterator.next();
@@ -1,5 +1,5 @@
1
1
  import { Readable } from 'streamx';
2
- import '../logger.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
3
  export declare function snapshotEquals(a: unknown, b: unknown): boolean;
4
4
  interface WatchableStore {
5
5
  watch(listener: () => void): void;
@@ -12,7 +12,8 @@ interface WatchableStore {
12
12
  }
13
13
  export interface WatchableOptions {
14
14
  readonly name: string;
15
+ readonly log: LoggerInterface | null;
15
16
  readonly changes?: WatchableStore;
16
17
  }
17
- export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
+ export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, log, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
19
  export {};
@@ -1,7 +1,6 @@
1
1
  import b4a from 'b4a';
2
2
  import { Readable } from 'streamx';
3
3
  import { frameReadable } from '../frame-readable.js';
4
- import '../logger.js';
5
4
  import { asError, isRecord } from '../guards.js';
6
5
  const SCOPE = ['api', 'watch'];
7
6
  const CHURN_WINDOW_MS = 30_000;
@@ -26,7 +25,7 @@ export function snapshotEquals(a, b) {
26
25
  }
27
26
  return keys.every((key) => snapshotEquals(a[key], b[key]));
28
27
  }
29
- export function watchable(storeOf, query, { name, changes }) {
28
+ export function watchable(storeOf, query, { name, log, changes }) {
30
29
  return (request) => {
31
30
  const resolved = storeOf(request);
32
31
  const pending = resolved instanceof Promise ? resolved.catch(noop) : null;
@@ -45,7 +44,7 @@ export function watchable(storeOf, query, { name, changes }) {
45
44
  if (!force && elapsed < CHURN_WINDOW_MS) {
46
45
  return;
47
46
  }
48
- logger.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
47
+ log?.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
49
48
  churn = 0;
50
49
  reportedAt = now;
51
50
  };
@@ -0,0 +1,5 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import { type MeshPool } from './current-mesh.ts';
3
+ import type { MeshStatusSource } from './mesh.ts';
4
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
5
+ export declare function createWorkspaceApi(pool: MeshPool, status: Pick<MeshStatusSource, 'createWorkspace' | 'name' | 'leaveWorkspace'>, log: LoggerInterface | null): Pick<CapabilityHandlers, 'createWorkspace' | 'getWorkspace' | 'workspaceWatch' | 'updateWorkspace' | 'leaveWorkspace'>;
@@ -0,0 +1,48 @@
1
+ import { MESH_NAMES } from '../core/collections.js';
2
+ import { MESH_NAME_ROW } from '../core/contract/mesh-name.js';
3
+ import { WORKSPACE_ROW, readWorkspace } from '../core/contract/workspace.js';
4
+ import { meshWatchable, requireMesh } from './current-mesh.js';
5
+ import { requireOurAdmin, requireWorkspace } from './members.js';
6
+ async function read(mesh, meshId) {
7
+ requireWorkspace(mesh, meshId);
8
+ const row = await readWorkspace(mesh.view);
9
+ const named = await mesh.view.get(MESH_NAMES, { id: MESH_NAME_ROW });
10
+ return { meshId, name: named?.name ?? '', icon: row?.icon || undefined };
11
+ }
12
+ export function createWorkspaceApi(pool, status, log) {
13
+ return {
14
+ createWorkspace: async (request) => {
15
+ const meshId = await status.createWorkspace({
16
+ name: request?.config?.name ?? undefined,
17
+ icon: request?.config?.icon ?? undefined
18
+ });
19
+ return read(await requireMesh(pool, meshId), meshId);
20
+ },
21
+ getWorkspace: async ({ meshId }) => read(await requireMesh(pool, meshId), meshId),
22
+ workspaceWatch: meshWatchable(pool, ({ meshId }, mesh) => read(mesh, meshId), { name: 'workspaceWatch', log }),
23
+ updateWorkspace: async (request) => update(await requireMesh(pool, request.meshId), request, status),
24
+ leaveWorkspace: async ({ meshId }) => {
25
+ requireWorkspace(await requireMesh(pool, meshId), meshId);
26
+ await status.leaveWorkspace(meshId);
27
+ return { ok: true };
28
+ }
29
+ };
30
+ }
31
+ async function update(mesh, { meshId, config }, status) {
32
+ requireWorkspace(mesh, meshId);
33
+ await requireOurAdmin(mesh, 'edit the workspace');
34
+ if (config.name) {
35
+ await status.name(meshId, config.name);
36
+ }
37
+ if (config.icon) {
38
+ const existing = await readWorkspace(mesh.view);
39
+ await mesh.dispatch('put-workspace', {
40
+ workspace: {
41
+ id: WORKSPACE_ROW,
42
+ icon: config.icon,
43
+ updatedAt: Math.max(Date.now(), (existing?.updatedAt ?? 0) + 1)
44
+ }
45
+ });
46
+ }
47
+ return read(mesh, meshId);
48
+ }
@@ -0,0 +1,20 @@
1
+ import type { openLocalStore } from '../core/local/index.ts';
2
+ import type { Harness } from './harness.ts';
3
+ import type { LoggerInterface } from '@qvac/logging';
4
+ export declare const MAX_QUACKS = 500;
5
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
6
+ export type FakeModelsSource = Pick<LocalStore, 'get' | 'watch' | 'unwatch'>;
7
+ export interface FakeModelsOptions {
8
+ enabled?: () => boolean;
9
+ paceMs?: number;
10
+ }
11
+ export declare function quackCount(prompt: string): number;
12
+ export declare function readFakeModels(state: Pick<FakeModelsSource, 'get'>): Promise<boolean>;
13
+ export interface FakeModelsWatchOptions {
14
+ initial: boolean;
15
+ onChange: (enabled: boolean) => void;
16
+ logger?: LoggerInterface | null;
17
+ }
18
+ export declare function watchFakeModels(state: FakeModelsSource, opts: FakeModelsWatchOptions): () => Promise<void>;
19
+ export declare function withFakeModels(harness: Harness, opts?: FakeModelsOptions): Harness;
20
+ export {};
@@ -0,0 +1,112 @@
1
+ import b4a from 'b4a';
2
+ import crypto from 'hypercore-crypto';
3
+ import ScopeLock from 'scope-lock';
4
+ import { FAKE_MODELS_KEY, QUACK_MODEL } from '../constants.js';
5
+ import { errorMessage } from '../guards.js';
6
+ export const MAX_QUACKS = 500;
7
+ const QUACK_ROW = {
8
+ name: QUACK_MODEL,
9
+ type: 'llm',
10
+ taskType: 'llm',
11
+ registryPath: QUACK_MODEL,
12
+ registrySource: 'fake',
13
+ isCached: true,
14
+ isLoaded: true,
15
+ expectedSize: 0,
16
+ supportsImages: false
17
+ };
18
+ export function quackCount(prompt) {
19
+ return 1 + (b4a.readUInt32LE(crypto.hash(b4a.from(prompt)), 0) % MAX_QUACKS);
20
+ }
21
+ export async function readFakeModels(state) {
22
+ return (await state.get(FAKE_MODELS_KEY)) === true;
23
+ }
24
+ export function watchFakeModels(state, opts) {
25
+ const { onChange, logger } = opts;
26
+ const lock = new ScopeLock({ debounce: true });
27
+ let disposed = false;
28
+ let reported = opts.initial;
29
+ const schedule = async () => {
30
+ if (disposed || !(await lock.lock()))
31
+ return;
32
+ try {
33
+ const enabled = await readFakeModels(state);
34
+ if (!disposed && enabled !== reported) {
35
+ reported = enabled;
36
+ onChange(enabled);
37
+ }
38
+ }
39
+ catch (err) {
40
+ logger?.warn('fake-models', 'reading the switch failed', errorMessage(err));
41
+ }
42
+ finally {
43
+ lock.unlock();
44
+ }
45
+ };
46
+ const listener = () => void schedule();
47
+ state.watch(listener);
48
+ return async () => {
49
+ disposed = true;
50
+ state.unwatch(listener);
51
+ lock.destroy();
52
+ await lock.flush();
53
+ };
54
+ }
55
+ export function withFakeModels(harness, opts = {}) {
56
+ const { enabled = () => true, paceMs = 10 } = opts;
57
+ const isQuack = (model) => model === QUACK_MODEL && enabled();
58
+ const quacking = {
59
+ ...modelCalls(harness, isQuack),
60
+ completion: (context) => isQuack(context.model) ? quack(context, paceMs) : harness.completion(context)
61
+ };
62
+ return new Proxy(harness, {
63
+ get(target, key) {
64
+ if (Object.hasOwn(quacking, key)) {
65
+ return Reflect.get(quacking, key);
66
+ }
67
+ const value = Reflect.get(target, key);
68
+ return typeof value === 'function' ? value.bind(target) : value;
69
+ }
70
+ });
71
+ }
72
+ function modelCalls(harness, isQuack) {
73
+ const list = harness.list?.bind(harness);
74
+ const warmModel = harness.warmModel?.bind(harness);
75
+ const loadModel = harness.loadModel?.bind(harness);
76
+ const unloadModel = harness.unloadModel?.bind(harness);
77
+ const deleteModel = harness.deleteModel?.bind(harness);
78
+ return {
79
+ list: list &&
80
+ (async (options) => {
81
+ const rows = await list(options);
82
+ return isQuack(QUACK_MODEL) ? withQuackRow(rows, options?.type) : rows;
83
+ }),
84
+ warmModel: warmModel && ((context) => (isQuack(context.model) ? Promise.resolve() : warmModel(context))),
85
+ loadModel: loadModel &&
86
+ ((context) => isQuack(context.model) ? Promise.resolve({ loaded: true }) : loadModel(context)),
87
+ unloadModel: unloadModel &&
88
+ ((context) => isQuack(context.model) ? Promise.resolve({ unloaded: true }) : unloadModel(context)),
89
+ deleteModel: deleteModel &&
90
+ ((name) => isQuack(name) ? Promise.resolve({ name, removed: 0, freedBytes: 0 }) : deleteModel(name))
91
+ };
92
+ }
93
+ function withQuackRow(rows, type) {
94
+ return type && type !== 'llm' ? rows : [...rows, QUACK_ROW];
95
+ }
96
+ async function* quack(context, paceMs) {
97
+ const prompt = context.messages.findLast((turn) => turn.role === 'user')?.content ?? '';
98
+ const count = quackCount(prompt);
99
+ for (let i = 0; i < count; i++) {
100
+ if (i > 0) {
101
+ await pace(paceMs);
102
+ }
103
+ if (context.signal?.aborted) {
104
+ yield { type: 'aborted' };
105
+ return;
106
+ }
107
+ yield { type: 'content', text: i === 0 ? 'quack' : ' quack' };
108
+ }
109
+ }
110
+ function pace(ms) {
111
+ return new Promise((resolve) => setTimeout(resolve, ms));
112
+ }
@@ -1,11 +1,10 @@
1
1
  import type { AbortSignal } from 'bare-abort-controller';
2
- import type { ApprovalCall, CompletionEvent, DeleteModelSummary, HostRunLog, MemoryBudget, ModelSourcePreview, PreviewModelSourceContext } from '@qvac/harness';
3
- import type { ManagedSkill, SkillFileContent } from '@qvac/harness/lib/tools/skills/overlay-crud.ts';
2
+ import type { ApprovalCall, CompletionEvent, DeleteModelSummary, DriveOpFn, GrantedDrive, HostRunLog, ManagedSkill, MemoryBudget, ModelRoundIo, ModelRoundPort, ModelRoundRequest, ModelRoundResult, ModelSourcePreview, PreviewModelSourceContext, SkillFileContent } from '@qvac/harness';
4
3
  import type { SkillCatalogOptions, SkillManagementHooks } from '../core.ts';
5
- import type { DriveOpFn, GrantedDrive } from '@qvac/harness/lib/tools/fs/remote.ts';
6
4
  import type { AssistantAgent, AssistantCapabilityProfile, AssistantChunkContentAttachment, AssistantCustomModelPreview, AssistantDeleteModelRequest, AssistantDetectLanguageRequest, AssistantDetectLanguageResponse, AssistantDeleteModelResponse, AssistantEnhanceMode, AssistantKvCacheDeletionResponse, AssistantListModelsRequest, AssistantModelInfoList, AssistantPreviewCustomModelRequest, AssistantSkillCatalogResponse, AssistantSpeakRequest, AssistantSpeakResponse, AssistantToolCatalogResponse, AssistantToolReportEntry, AssistantTranscribeRequest, AssistantTranscribeResponse } from '../../spec/hyperschema/types.d.ts';
7
5
  import type { HarnessDiagnostics } from '../diagnostics.ts';
8
6
  import type { DownloadArgs, DownloadEventStream, ImageDownloadObservation } from '../model-download.ts';
7
+ import type { RunInput } from '../run-input.ts';
9
8
  import type { AttachInput, AttachmentMeta, ChatMessage, FetchedAttachment } from './message.ts';
10
9
  import type { Skill } from './skill-encode.ts';
11
10
  export interface HarnessEvent {
@@ -49,6 +48,7 @@ export interface ModelInfo {
49
48
  expectedSize: number;
50
49
  actualSize?: number;
51
50
  taskType?: string;
51
+ memoryBytes?: number;
52
52
  }
53
53
  export interface ListModelsOptions {
54
54
  type?: ModelType;
@@ -70,19 +70,31 @@ export interface DeviceCapability {
70
70
  capabilityProfile: AssistantCapabilityProfile;
71
71
  recommendedModelName: string;
72
72
  memoryBudget?: MemoryBudget;
73
+ hostRunLog?: boolean;
74
+ hostRunLogVersion?: number;
73
75
  }
74
76
  export interface ImageProgress {
75
77
  readonly percentage: number;
76
78
  }
79
+ export interface FetchAttachmentOptions {
80
+ readonly attachmentId?: string;
81
+ readonly kind?: 'image' | 'audio';
82
+ readonly signal?: AbortSignal;
83
+ readonly meta?: boolean;
84
+ }
77
85
  export interface Harness {
78
86
  completion(context: {
79
87
  runId?: string;
80
88
  runLog?: HostRunLog;
81
- resume?: boolean;
82
89
  model: string;
83
90
  agent: AssistantAgent;
84
91
  messages: ChatMessage[];
92
+ typedText?: string;
85
93
  cacheKey?: string;
94
+ replaysContext?: boolean;
95
+ deferTools?: boolean;
96
+ modelRound?: ModelRoundPort;
97
+ session?: string;
86
98
  thinkingDefault?: string;
87
99
  toolConfigs?: Record<string, Record<string, unknown>>;
88
100
  captureInferenceCalls?: boolean;
@@ -114,40 +126,19 @@ export interface Harness {
114
126
  };
115
127
  approve?: (call: ApprovalCall) => Promise<boolean>;
116
128
  attach?: (input: AttachInput) => Promise<AssistantChunkContentAttachment>;
117
- fetchAttachment?: (query: {
118
- attachmentId?: string;
119
- signal?: AbortSignal;
120
- meta?: boolean;
121
- }) => Promise<FetchedAttachment | AttachmentMeta | null>;
122
- ragSearch?: (input: {
123
- query: string;
124
- limit?: number;
125
- }) => Promise<{
126
- enabled: boolean;
127
- indexEmpty: boolean;
128
- hasKnowledge: boolean;
129
- pendingReferenced?: boolean;
130
- errorMessage?: string | null;
131
- hits: ReadonlyArray<{
132
- content: string;
133
- metadataJson?: string | null;
134
- score: number;
135
- }>;
136
- }>;
129
+ fetchAttachment?: (query: FetchAttachmentOptions) => Promise<FetchedAttachment | AttachmentMeta | null>;
137
130
  progress?: (update: ImageProgress | null) => void;
131
+ input?: AsyncIterable<RunInput>;
138
132
  signal?: AbortSignal;
139
133
  }): AsyncIterable<HarnessEvent>;
134
+ serveModelRound?(request: ModelRoundRequest, io: ModelRoundIo): Promise<ModelRoundResult>;
140
135
  invoke?(context: {
141
136
  capability: string;
142
137
  args: Record<string, unknown>;
143
138
  enhance?: AssistantEnhanceMode;
144
139
  agent?: AssistantAgent;
145
140
  attach?: (input: AttachInput) => Promise<AssistantChunkContentAttachment>;
146
- fetchAttachment?: (query: {
147
- attachmentId?: string;
148
- signal?: AbortSignal;
149
- meta?: boolean;
150
- }) => Promise<FetchedAttachment | AttachmentMeta | null>;
141
+ fetchAttachment?: (query: FetchAttachmentOptions) => Promise<FetchedAttachment | AttachmentMeta | null>;
151
142
  progress?: (update: ImageProgress | null) => void;
152
143
  signal?: AbortSignal;
153
144
  }): AsyncIterable<HarnessEvent>;
@@ -225,6 +216,13 @@ export interface Harness {
225
216
  contextLength?: number;
226
217
  }>): void | Promise<void>;
227
218
  setModelIdleTimeout?(ms: number): void | Promise<void>;
219
+ setModelMemoryCap?(percent: number): void | Promise<void>;
220
+ memoryUsage?(): Promise<{
221
+ usedBytes: number;
222
+ }>;
223
+ setDownloadsAllowed?(request: {
224
+ allowed: boolean;
225
+ }): void | Promise<void>;
228
226
  previewModelSource?(input: PreviewModelSourceContext): Promise<ModelSourcePreview>;
229
227
  on?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
230
228
  off?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
@@ -276,4 +274,6 @@ export declare function harnessSpeakStream(harness: Pick<Harness, 'speakStream'>
276
274
  export declare function harnessDeathReason(status: unknown): string;
277
275
  export declare function harnessDied(status: unknown): boolean;
278
276
  export declare function modelCatalogChanged(state: unknown): boolean;
277
+ export declare function heldLoadModel(state: unknown): string | null;
278
+ export declare function droppedHeldLoadModel(state: unknown): string | null;
279
279
  export declare function imageDownloadProgress(state: unknown): ImageDownloadObservation | null;
@@ -3,6 +3,7 @@ import { RUN_FAILURE_REASONS } from '../run-notices.js';
3
3
  import { MODEL_TASK_TYPES } from '../../schema/engine.js';
4
4
  import { toEngineSkill } from './skill-encode.js';
5
5
  import { isRecord } from '../guards.js';
6
+ import { CoreError } from '../errors.js';
6
7
  export function isHarnessEvent(event, type) {
7
8
  return event.type === type;
8
9
  }
@@ -34,7 +35,7 @@ export const DELETE_CONTRACT_MATCHES = true;
34
35
  export function harnessPreviewModelSource(harness) {
35
36
  return async ({ src, mmprojSrc }) => {
36
37
  if (!harness.previewModelSource) {
37
- throw new Error('harness does not support previewModelSource');
38
+ throw new CoreError('CAPABILITY_UNSUPPORTED', ['previewModelSource']);
38
39
  }
39
40
  const preview = await harness.previewModelSource({ src, mmprojSrc: mmprojSrc ?? undefined });
40
41
  return {
@@ -47,7 +48,7 @@ export function harnessPreviewModelSource(harness) {
47
48
  export function harnessTranscribe(harness) {
48
49
  return async ({ audio, model }) => {
49
50
  if (!harness.transcribe) {
50
- throw new Error('harness does not support transcribe');
51
+ throw new CoreError('CAPABILITY_UNSUPPORTED', ['transcribe']);
51
52
  }
52
53
  return { text: await harness.transcribe({ audio, model: model ?? '' }) };
53
54
  };
@@ -55,7 +56,7 @@ export function harnessTranscribe(harness) {
55
56
  export function harnessDetectLanguage(harness) {
56
57
  return async ({ text, topK }) => {
57
58
  if (!harness.detectLanguage) {
58
- throw new Error('harness does not support detectLanguage');
59
+ throw new CoreError('CAPABILITY_UNSUPPORTED', ['detectLanguage']);
59
60
  }
60
61
  const languages = await harness.detectLanguage({ text, topK: topK || undefined });
61
62
  return {
@@ -69,8 +70,9 @@ export function harnessDetectLanguage(harness) {
69
70
  }
70
71
  export function harnessSpeak(harness) {
71
72
  return async ({ text, model }) => {
72
- if (!harness.speak)
73
- throw new Error('harness does not support speak');
73
+ if (!harness.speak) {
74
+ throw new CoreError('CAPABILITY_UNSUPPORTED', ['speak']);
75
+ }
74
76
  const { audio, sampleRate } = await harness.speak({ text, model: model ?? '' });
75
77
  return { audio, sampleRate };
76
78
  };
@@ -136,7 +138,7 @@ export function toolReportEntry(tool) {
136
138
  export function harnessSpeakStream(harness) {
137
139
  return async function* (text) {
138
140
  if (!harness.speakStream) {
139
- throw new Error('harness does not support speakStream');
141
+ throw new CoreError('CAPABILITY_UNSUPPORTED', ['speakStream']);
140
142
  }
141
143
  for await (const { audio, sampleRate } of harness.speakStream({ model: '', text })) {
142
144
  yield { audio, sampleRate };
@@ -164,6 +166,32 @@ export function harnessDied(status) {
164
166
  export function modelCatalogChanged(state) {
165
167
  return isRecord(state) && state.catalogChanged === true;
166
168
  }
169
+ export function heldLoadModel(state) {
170
+ if (typeof state !== 'object' ||
171
+ state === null ||
172
+ !('status' in state) ||
173
+ state.status !== 'held' ||
174
+ !('model' in state) ||
175
+ typeof state.model !== 'string') {
176
+ return null;
177
+ }
178
+ return state.model;
179
+ }
180
+ export function droppedHeldLoadModel(state) {
181
+ if (typeof state !== 'object' ||
182
+ state === null ||
183
+ !('status' in state) ||
184
+ state.status !== 'error' ||
185
+ !('message' in state) ||
186
+ state.message !== 'aborted' ||
187
+ !('addon' in state) ||
188
+ typeof state.addon !== 'string' ||
189
+ !('model' in state) ||
190
+ typeof state.model !== 'string') {
191
+ return null;
192
+ }
193
+ return state.model;
194
+ }
167
195
  export function imageDownloadProgress(state) {
168
196
  if (typeof state !== 'object' ||
169
197
  state === null ||
@@ -1,7 +1,10 @@
1
1
  import type { AbortSignal } from 'bare-abort-controller';
2
2
  import type { AssistantChunk } from '../../spec/hyperschema/types.d.ts';
3
3
  import type { ScopedCapabilities } from '../mesh-scoped-engine.ts';
4
+ import type { OwnerRounds } from './model-round.ts';
5
+ import type { DiagramRepairLink } from '@qvac/harness/lib/diagram-repair.ts';
4
6
  import type { ChatMessage } from './message.ts';
7
+ export declare function senderOf(chunk: AssistantChunk): string | undefined;
5
8
  export declare const TERMINAL_STATES: Set<string>;
6
9
  export declare const HISTORY_TYPES: AssistantChunk['type'][];
7
10
  export declare const SKILL_TOOL = "skill";
@@ -10,17 +13,18 @@ export interface StaleToolRuns {
10
13
  questionChunkIds: Set<string>;
11
14
  }
12
15
  export declare function listHistoryChunks(engine: Pick<ScopedCapabilities, 'listChunks'>, chatId: string): Promise<AssistantChunk[]>;
13
- export interface LatestAttemptStart {
14
- seq: number;
15
- resumed: boolean;
16
- cutoff?: number;
16
+ export declare function latestAttemptStarts(chunks: ReadonlyArray<AssistantChunk>): Map<string, number>;
17
+ export declare function beforeLatestAttempt(chunk: AssistantChunk, starts: Map<string, number>): boolean;
18
+ export interface RunAt {
19
+ readonly request: Pick<AssistantChunk, 'seq' | 'requesterMemberId'>;
20
+ readonly runId: string;
17
21
  }
18
- export declare function latestAttemptStarts(chunks: ReadonlyArray<AssistantChunk>): Map<string, LatestAttemptStart>;
19
- export declare function beforeLatestAttempt(chunk: AssistantChunk, starts: ReadonlyMap<string, LatestAttemptStart | number>): boolean;
20
22
  export interface CompactOptions {
21
23
  readonly signal?: AbortSignal;
24
+ readonly run?: RunAt;
22
25
  readonly onFold?: () => Promise<void> | void;
23
26
  readonly meshId: string;
27
+ readonly rounds?: OwnerRounds | undefined;
24
28
  }
25
29
  export type CompactionTrigger = 'before-run' | 'overflow';
26
30
  export interface CompactResult {
@@ -28,19 +32,28 @@ export interface CompactResult {
28
32
  readonly foldedTurns?: number;
29
33
  readonly reason?: string;
30
34
  }
31
- export declare function couldNameSenders(chunks: ReadonlyArray<AssistantChunk>): boolean;
32
- export interface SenderMember {
33
- readonly id: Buffer;
34
- readonly name: string;
35
+ export interface HistoryReplay {
36
+ readonly sentRuns?: ReadonlyMap<string, ReadonlyArray<ChatMessage>>;
37
+ readonly askedRuns?: ReadonlyMap<string, string>;
38
+ readonly readRuns?: ReadonlyMap<string, string>;
35
39
  }
36
- export interface SenderDevice {
37
- readonly id: Buffer;
38
- readonly memberId?: Buffer | null;
40
+ export declare function historyFromChunks(chunks: ReadonlyArray<AssistantChunk>, stale?: Partial<StaleToolRuns>, { sentRuns, askedRuns, readRuns }?: HistoryReplay): ChatMessage[];
41
+ export interface RunPromptView {
42
+ readonly history: AssistantChunk[];
43
+ readonly stale: StaleToolRuns;
44
+ readonly repair: DiagramRepairLink | undefined;
45
+ readonly acceptedRepairs: number;
39
46
  }
40
- export declare function senderNamesFrom(chunks: ReadonlyArray<AssistantChunk>, members: ReadonlyArray<SenderMember>, devices: ReadonlyArray<SenderDevice>): ReadonlyMap<string, string>;
41
- export declare function senderAttribution(names: ReadonlyMap<string, string>): string;
42
- export declare function historyFromChunks(chunks: ReadonlyArray<AssistantChunk>, stale?: Partial<StaleToolRuns>, senderNames?: ReadonlyMap<string, string>): ChatMessage[];
43
- export declare function inputAvailableToRun(chunk: AssistantChunk, requestSeq: number): boolean;
47
+ export declare function runPromptView(all: ReadonlyArray<AssistantChunk>, approvals: ReadonlyArray<AssistantChunk>, run: RunAt): RunPromptView;
48
+ export interface RoundReplay {
49
+ readonly sentRuns: Map<string, ChatMessage[]>;
50
+ readonly readRuns: Map<string, string>;
51
+ }
52
+ export declare function replayFromChunks(rounds: ReadonlyArray<AssistantChunk>): RoundReplay;
53
+ export declare function sentTurn(chunk: AssistantChunk): string | undefined;
54
+ export declare function runView(chunks: ReadonlyArray<AssistantChunk>, { request, runId }: RunAt): AssistantChunk[];
55
+ export declare function foldableView(chunks: ReadonlyArray<AssistantChunk>, run: RunAt): AssistantChunk[];
56
+ export declare function viewOutgrewCache(chunks: ReadonlyArray<AssistantChunk>, run: RunAt, cachedRuns: ReadonlyMap<string, unknown>): boolean;
44
57
  export declare function normalizeQuestion(text: string): string;
45
58
  export declare const GENERIC_ACKNOWLEDGEMENTS: Set<string>;
46
59
  export declare function isGenericAcknowledgement(question: string): boolean;