@qvac/core 0.5.0 → 0.6.0

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 (383) hide show
  1. package/CHANGELOG.md +75 -1
  2. package/dist-lib/lib/api/agents.js +3 -2
  3. package/dist-lib/lib/api/app-config.d.ts +1 -1
  4. package/dist-lib/lib/api/app-config.js +54 -15
  5. package/dist-lib/lib/api/attachments.d.ts +6 -5
  6. package/dist-lib/lib/api/attachments.js +4 -2
  7. package/dist-lib/lib/api/chat.d.ts +7 -3
  8. package/dist-lib/lib/api/chat.js +4 -4
  9. package/dist-lib/lib/api/chunks.js +3 -3
  10. package/dist-lib/lib/api/config.js +2 -2
  11. package/dist-lib/lib/api/current-mesh.d.ts +3 -4
  12. package/dist-lib/lib/api/current-mesh.js +9 -4
  13. package/dist-lib/lib/api/custom-models.d.ts +8 -1
  14. package/dist-lib/lib/api/custom-models.js +53 -16
  15. package/dist-lib/lib/api/devices.d.ts +14 -5
  16. package/dist-lib/lib/api/devices.js +13 -8
  17. package/dist-lib/lib/api/diagnostics.d.ts +1 -0
  18. package/dist-lib/lib/api/diagnostics.js +1 -1
  19. package/dist-lib/lib/api/effective-ctx-size.d.ts +6 -1
  20. package/dist-lib/lib/api/effective-ctx-size.js +5 -3
  21. package/dist-lib/lib/api/execution.js +2 -1
  22. package/dist-lib/lib/api/files.js +2 -1
  23. package/dist-lib/lib/api/index.d.ts +5 -1
  24. package/dist-lib/lib/api/index.js +101 -102
  25. package/dist-lib/lib/api/instrument.js +29 -20
  26. package/dist-lib/lib/api/knowledge.d.ts +6 -5
  27. package/dist-lib/lib/api/knowledge.js +8 -6
  28. package/dist-lib/lib/api/local-files.js +1 -1
  29. package/dist-lib/lib/api/logs.js +6 -3
  30. package/dist-lib/lib/api/members.js +22 -13
  31. package/dist-lib/lib/api/mesh.js +3 -3
  32. package/dist-lib/lib/api/model-download.js +1 -1
  33. package/dist-lib/lib/api/network.d.ts +1 -0
  34. package/dist-lib/lib/api/network.js +1 -1
  35. package/dist-lib/lib/api/notifications.js +23 -13
  36. package/dist-lib/lib/api/rag.d.ts +6 -1
  37. package/dist-lib/lib/api/rag.js +20 -11
  38. package/dist-lib/lib/api/range.d.ts +2 -2
  39. package/dist-lib/lib/api/sync.js +1 -1
  40. package/dist-lib/lib/api/tool-activity.js +7 -3
  41. package/dist-lib/lib/api/tool-configs.js +2 -4
  42. package/dist-lib/lib/api/upload-frames.d.ts +7 -8
  43. package/dist-lib/lib/api/upload-frames.js +2 -1
  44. package/dist-lib/lib/api/watchable.d.ts +6 -1
  45. package/dist-lib/lib/api/watchable.js +23 -14
  46. package/dist-lib/lib/assistant/fetch-body.js +4 -2
  47. package/dist-lib/lib/assistant/harness.d.ts +48 -27
  48. package/dist-lib/lib/assistant/harness.js +40 -16
  49. package/dist-lib/lib/assistant/history.d.ts +9 -7
  50. package/dist-lib/lib/assistant/history.js +77 -42
  51. package/dist-lib/lib/assistant/message.d.ts +5 -3
  52. package/dist-lib/lib/assistant/message.js +4 -2
  53. package/dist-lib/lib/assistant/skill-encode.d.ts +3 -1
  54. package/dist-lib/lib/assistant/skill-encode.js +52 -62
  55. package/dist-lib/lib/assistant-client.js +7 -4
  56. package/dist-lib/lib/assistant-tree.js +27 -11
  57. package/dist-lib/lib/assistant.d.ts +30 -11
  58. package/dist-lib/lib/assistant.js +824 -378
  59. package/dist-lib/lib/audio-format.d.ts +1 -1
  60. package/dist-lib/lib/audio-format.js +1 -1
  61. package/dist-lib/lib/chat-title.js +9 -4
  62. package/dist-lib/lib/client.js +3 -2
  63. package/dist-lib/lib/collabora/convert.d.ts +2 -2
  64. package/dist-lib/lib/collabora/convert.js +6 -3
  65. package/dist-lib/lib/collabora/entry.js +9 -5
  66. package/dist-lib/lib/collabora/protocol.d.ts +2 -2
  67. package/dist-lib/lib/collabora/protocol.js +14 -7
  68. package/dist-lib/lib/collabora/worker.js +14 -7
  69. package/dist-lib/lib/compaction.d.ts +5 -6
  70. package/dist-lib/lib/compaction.js +14 -7
  71. package/dist-lib/lib/core/account-recovery.d.ts +4 -3
  72. package/dist-lib/lib/core/account-recovery.js +7 -4
  73. package/dist-lib/lib/core/agent.js +17 -15
  74. package/dist-lib/lib/core/approval-rules.d.ts +7 -6
  75. package/dist-lib/lib/core/approval-rules.js +12 -6
  76. package/dist-lib/lib/core/archived-mesh.d.ts +7 -5
  77. package/dist-lib/lib/core/archived-mesh.js +25 -22
  78. package/dist-lib/lib/core/async-iterable.js +10 -5
  79. package/dist-lib/lib/core/attachment-link.d.ts +2 -2
  80. package/dist-lib/lib/core/audio-attachment.js +1 -1
  81. package/dist-lib/lib/core/blind-peers.d.ts +2 -2
  82. package/dist-lib/lib/core/chat-activity.d.ts +2 -2
  83. package/dist-lib/lib/core/chat-activity.js +42 -21
  84. package/dist-lib/lib/core/chat-group.d.ts +8 -6
  85. package/dist-lib/lib/core/chat-group.js +17 -10
  86. package/dist-lib/lib/core/chat-order.d.ts +11 -9
  87. package/dist-lib/lib/core/chat-order.js +1 -3
  88. package/dist-lib/lib/core/chat-search.d.ts +4 -4
  89. package/dist-lib/lib/core/chat-search.js +38 -24
  90. package/dist-lib/lib/core/chat.d.ts +20 -14
  91. package/dist-lib/lib/core/chat.js +42 -28
  92. package/dist-lib/lib/core/chunk.d.ts +19 -23
  93. package/dist-lib/lib/core/chunk.js +27 -21
  94. package/dist-lib/lib/core/collections.d.ts +69 -0
  95. package/dist-lib/lib/core/collections.js +69 -0
  96. package/dist-lib/lib/core/contract/activity.d.ts +6 -2
  97. package/dist-lib/lib/core/contract/activity.js +15 -12
  98. package/dist-lib/lib/core/contract/agents.js +3 -2
  99. package/dist-lib/lib/core/contract/approval-rules.js +1 -1
  100. package/dist-lib/lib/core/contract/attestations.js +1 -1
  101. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  102. package/dist-lib/lib/core/contract/chat.js +1 -1
  103. package/dist-lib/lib/core/contract/chunks.js +10 -9
  104. package/dist-lib/lib/core/contract/compute.js +2 -1
  105. package/dist-lib/lib/core/contract/devices.js +6 -5
  106. package/dist-lib/lib/core/contract/grant-order.js +5 -6
  107. package/dist-lib/lib/core/contract/index.js +4 -2
  108. package/dist-lib/lib/core/contract/indexing.js +3 -3
  109. package/dist-lib/lib/core/contract/invites.d.ts +8 -3
  110. package/dist-lib/lib/core/contract/invites.js +52 -26
  111. package/dist-lib/lib/core/contract/joined-meshes.js +3 -3
  112. package/dist-lib/lib/core/contract/knowledge.js +5 -5
  113. package/dist-lib/lib/core/contract/members.d.ts +13 -2
  114. package/dist-lib/lib/core/contract/members.js +46 -25
  115. package/dist-lib/lib/core/contract/mesh-kind.js +9 -8
  116. package/dist-lib/lib/core/contract/seal.js +1 -1
  117. package/dist-lib/lib/core/contract/seed-defaults.js +1 -3
  118. package/dist-lib/lib/core/contract/tool-activity.js +5 -5
  119. package/dist-lib/lib/core/contract/tool-configs.js +1 -2
  120. package/dist-lib/lib/core/contract/writers.d.ts +6 -1
  121. package/dist-lib/lib/core/contract/writers.js +55 -34
  122. package/dist-lib/lib/core/departures.js +16 -8
  123. package/dist-lib/lib/core/device-invites.js +3 -2
  124. package/dist-lib/lib/core/devices.js +6 -3
  125. package/dist-lib/lib/core/document-attachment.d.ts +20 -11
  126. package/dist-lib/lib/core/document-attachment.js +10 -5
  127. package/dist-lib/lib/core/files/attachments.d.ts +2 -5
  128. package/dist-lib/lib/core/files/attachments.js +6 -3
  129. package/dist-lib/lib/core/files/index.d.ts +44 -52
  130. package/dist-lib/lib/core/files/index.js +142 -93
  131. package/dist-lib/lib/core/files/knowledge.d.ts +2 -5
  132. package/dist-lib/lib/core/files/local-index.js +9 -5
  133. package/dist-lib/lib/core/files/preview/image.d.ts +0 -1
  134. package/dist-lib/lib/core/files/preview/image.js +9 -6
  135. package/dist-lib/lib/core/files/preview/index.d.ts +8 -11
  136. package/dist-lib/lib/core/files/preview/index.js +20 -15
  137. package/dist-lib/lib/core/files/processing/claims.d.ts +6 -5
  138. package/dist-lib/lib/core/files/processing/claims.js +16 -8
  139. package/dist-lib/lib/core/files/processing/document.d.ts +21 -50
  140. package/dist-lib/lib/core/files/processing/index.d.ts +18 -13
  141. package/dist-lib/lib/core/files/processing/index.js +65 -37
  142. package/dist-lib/lib/core/files/processing/ownership.d.ts +8 -1
  143. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  144. package/dist-lib/lib/core/files/processing/protocol.d.ts +19 -19
  145. package/dist-lib/lib/core/files/processing/protocol.js +5 -5
  146. package/dist-lib/lib/core/files/processing/settle.d.ts +10 -7
  147. package/dist-lib/lib/core/files/processing/settle.js +22 -11
  148. package/dist-lib/lib/core/files/processing/source.js +14 -8
  149. package/dist-lib/lib/core/files/processing/state.d.ts +13 -11
  150. package/dist-lib/lib/core/files/processing/state.js +19 -12
  151. package/dist-lib/lib/core/files/rag/build.d.ts +2 -2
  152. package/dist-lib/lib/core/files/rag/build.js +2 -1
  153. package/dist-lib/lib/core/files/rag/document-types.d.ts +4 -6
  154. package/dist-lib/lib/core/files/rag/index.d.ts +10 -13
  155. package/dist-lib/lib/core/files/rag/index.js +3 -2
  156. package/dist-lib/lib/core/files/rag/load.d.ts +10 -9
  157. package/dist-lib/lib/core/files/rag/load.js +26 -13
  158. package/dist-lib/lib/core/files/rag/policy.js +2 -1
  159. package/dist-lib/lib/core/files/rag/produce.js +33 -19
  160. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +5 -3
  161. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +30 -10
  162. package/dist-lib/lib/core/files/records/chunks.js +4 -2
  163. package/dist-lib/lib/core/files/records/knowledge.d.ts +10 -11
  164. package/dist-lib/lib/core/files/records/knowledge.js +9 -8
  165. package/dist-lib/lib/core/files/records/linkage.js +6 -3
  166. package/dist-lib/lib/core/files/records/output.d.ts +5 -4
  167. package/dist-lib/lib/core/files/records/output.js +8 -4
  168. package/dist-lib/lib/core/files/records/reclaim.js +41 -25
  169. package/dist-lib/lib/core/files/records/routing.d.ts +4 -6
  170. package/dist-lib/lib/core/files/records/routing.js +15 -8
  171. package/dist-lib/lib/core/files/records/source.d.ts +5 -4
  172. package/dist-lib/lib/core/files/records/source.js +20 -14
  173. package/dist-lib/lib/core/files/records/sweep.js +1 -3
  174. package/dist-lib/lib/core/files/store/blob.d.ts +10 -10
  175. package/dist-lib/lib/core/files/store/blob.js +25 -19
  176. package/dist-lib/lib/core/files/store/index.d.ts +1 -6
  177. package/dist-lib/lib/core/files/store/index.js +4 -4
  178. package/dist-lib/lib/core/files/store/inline.d.ts +2 -2
  179. package/dist-lib/lib/core/files/store/inline.js +6 -3
  180. package/dist-lib/lib/core/files/store/reference.d.ts +6 -9
  181. package/dist-lib/lib/core/files/store/reference.js +25 -17
  182. package/dist-lib/lib/core/files/store/server.d.ts +7 -6
  183. package/dist-lib/lib/core/files/store/server.js +22 -11
  184. package/dist-lib/lib/core/files/store/sweep.js +13 -7
  185. package/dist-lib/lib/core/files/upload-input.d.ts +4 -12
  186. package/dist-lib/lib/core/files/upload-input.js +10 -5
  187. package/dist-lib/lib/core/files/upload.d.ts +27 -24
  188. package/dist-lib/lib/core/files/upload.js +74 -51
  189. package/dist-lib/lib/core/fs-drives.js +4 -2
  190. package/dist-lib/lib/core/grant-expiry.js +12 -7
  191. package/dist-lib/lib/core/handoff-channel.js +27 -13
  192. package/dist-lib/lib/core/harness-loan.js +35 -17
  193. package/dist-lib/lib/core/helpers/index.js +6 -2
  194. package/dist-lib/lib/core/hosted-agents.js +19 -12
  195. package/dist-lib/lib/core/id.js +1 -1
  196. package/dist-lib/lib/core/identity.js +6 -3
  197. package/dist-lib/lib/core/image/cache-sweep.d.ts +12 -10
  198. package/dist-lib/lib/core/image/cache-sweep.js +11 -6
  199. package/dist-lib/lib/core/image/normalize.d.ts +6 -0
  200. package/dist-lib/lib/core/image/normalize.js +12 -2
  201. package/dist-lib/lib/core/image/sniff.js +42 -21
  202. package/dist-lib/lib/core/inference-calls-receiver.js +7 -4
  203. package/dist-lib/lib/core/invite-grants.js +4 -2
  204. package/dist-lib/lib/core/invite.js +2 -1
  205. package/dist-lib/lib/core/local/files.js +20 -19
  206. package/dist-lib/lib/core/local/index.d.ts +69 -46
  207. package/dist-lib/lib/core/local/index.js +146 -129
  208. package/dist-lib/lib/core/membership.d.ts +12 -2
  209. package/dist-lib/lib/core/membership.js +55 -33
  210. package/dist-lib/lib/core/mesh-seed-handoff.js +7 -1
  211. package/dist-lib/lib/core/mesh.d.ts +37 -27
  212. package/dist-lib/lib/core/mesh.js +131 -73
  213. package/dist-lib/lib/core/migrations/agent-catalog.js +3 -2
  214. package/dist-lib/lib/core/migrations/agent-indexes.js +3 -3
  215. package/dist-lib/lib/core/migrations/file-index.js +7 -4
  216. package/dist-lib/lib/core/migrations/index.d.ts +4 -3
  217. package/dist-lib/lib/core/migrations/membership.js +9 -4
  218. package/dist-lib/lib/core/migrations/seal.js +3 -2
  219. package/dist-lib/lib/core/min-version.js +4 -2
  220. package/dist-lib/lib/core/next-frame.d.ts +5 -4
  221. package/dist-lib/lib/core/next-frame.js +6 -3
  222. package/dist-lib/lib/core/notification.d.ts +5 -1
  223. package/dist-lib/lib/core/notification.js +89 -77
  224. package/dist-lib/lib/core/ota-config.js +2 -1
  225. package/dist-lib/lib/core/pdf/rasterize.d.ts +18 -0
  226. package/dist-lib/lib/core/pdf/rasterize.js +57 -0
  227. package/dist-lib/lib/core/prompt-history.js +4 -2
  228. package/dist-lib/lib/core/range.d.ts +4 -4
  229. package/dist-lib/lib/core/range.js +12 -6
  230. package/dist-lib/lib/core/rank.d.ts +5 -4
  231. package/dist-lib/lib/core/rank.js +2 -1
  232. package/dist-lib/lib/core/send.d.ts +4 -4
  233. package/dist-lib/lib/core/send.js +6 -3
  234. package/dist-lib/lib/core/skill-overlay-receiver.js +7 -4
  235. package/dist-lib/lib/core/skill-secrets.js +16 -9
  236. package/dist-lib/lib/core/sync/chunks.js +2 -1
  237. package/dist-lib/lib/core/sync/devices.js +3 -1
  238. package/dist-lib/lib/core/sync/files.d.ts +2 -4
  239. package/dist-lib/lib/core/sync/files.js +28 -20
  240. package/dist-lib/lib/core/sync/index.d.ts +2 -5
  241. package/dist-lib/lib/core/sync/index.js +20 -15
  242. package/dist-lib/lib/core/sync-status.js +10 -7
  243. package/dist-lib/lib/core/system-info.js +4 -2
  244. package/dist-lib/lib/core/tool-activity.d.ts +4 -3
  245. package/dist-lib/lib/core/tool-activity.js +1 -1
  246. package/dist-lib/lib/core/tool-configs.js +12 -7
  247. package/dist-lib/lib/core.d.ts +38 -26
  248. package/dist-lib/lib/core.js +987 -539
  249. package/dist-lib/lib/credential-pusher.d.ts +12 -17
  250. package/dist-lib/lib/credential-pusher.js +61 -42
  251. package/dist-lib/lib/custom-model-pusher.d.ts +7 -3
  252. package/dist-lib/lib/custom-model-pusher.js +15 -7
  253. package/dist-lib/lib/custom-model-task.d.ts +1 -0
  254. package/dist-lib/lib/custom-model-task.js +12 -0
  255. package/dist-lib/lib/deadline.js +4 -2
  256. package/dist-lib/lib/diagnostics.d.ts +1 -5
  257. package/dist-lib/lib/frame-readable.d.ts +3 -0
  258. package/dist-lib/lib/frame-readable.js +3 -0
  259. package/dist-lib/lib/fs-drive-bridge.js +24 -14
  260. package/dist-lib/lib/fs-grants.js +13 -8
  261. package/dist-lib/lib/guards.d.ts +3 -0
  262. package/dist-lib/lib/guards.js +9 -0
  263. package/dist-lib/lib/inference-calls.d.ts +28 -23
  264. package/dist-lib/lib/inference-calls.js +25 -13
  265. package/dist-lib/lib/integrations/mcp-providers.d.ts +2 -2
  266. package/dist-lib/lib/integrations/setup-routes.d.ts +2 -2
  267. package/dist-lib/lib/knowledge-search.d.ts +6 -5
  268. package/dist-lib/lib/knowledge-search.js +26 -18
  269. package/dist-lib/lib/kv-cache-reclaim.js +4 -2
  270. package/dist-lib/lib/kv-cache.js +8 -4
  271. package/dist-lib/lib/legacy-core-domain.d.ts +42 -42
  272. package/dist-lib/lib/log-buffer.js +2 -1
  273. package/dist-lib/lib/log.js +25 -15
  274. package/dist-lib/lib/mesh-scoped-engine.js +12 -4
  275. package/dist-lib/lib/model-catalog-revision.js +6 -3
  276. package/dist-lib/lib/model-clamp.js +6 -3
  277. package/dist-lib/lib/model-context.d.ts +8 -3
  278. package/dist-lib/lib/model-context.js +13 -5
  279. package/dist-lib/lib/model-download-status.js +4 -2
  280. package/dist-lib/lib/model-download.d.ts +12 -4
  281. package/dist-lib/lib/model-download.js +200 -103
  282. package/dist-lib/lib/model-idle-pusher.d.ts +2 -2
  283. package/dist-lib/lib/model-idle-pusher.js +3 -4
  284. package/dist-lib/lib/oauth/browser-connect.d.ts +10 -8
  285. package/dist-lib/lib/oauth/browser-connect.js +33 -20
  286. package/dist-lib/lib/oauth/client.d.ts +2 -2
  287. package/dist-lib/lib/oauth/flow-core.js +23 -9
  288. package/dist-lib/lib/oauth/flow.d.ts +1 -3
  289. package/dist-lib/lib/oauth/flow.js +9 -5
  290. package/dist-lib/lib/oauth/keys.d.ts +4 -4
  291. package/dist-lib/lib/oauth/keys.js +18 -12
  292. package/dist-lib/lib/oauth/loopback.d.ts +2 -2
  293. package/dist-lib/lib/oauth/loopback.js +147 -107
  294. package/dist-lib/lib/oauth/loopback.stub.d.ts +2 -2
  295. package/dist-lib/lib/oauth/loopback.stub.js +1 -1
  296. package/dist-lib/lib/oauth/pkce.d.ts +4 -2
  297. package/dist-lib/lib/oauth/pkce.js +10 -0
  298. package/dist-lib/lib/oauth/providers.js +5 -5
  299. package/dist-lib/lib/oauth/redirect-types.d.ts +12 -7
  300. package/dist-lib/lib/oauth/register.js +3 -2
  301. package/dist-lib/lib/oauth/registry.d.ts +2 -2
  302. package/dist-lib/lib/oauth/registry.js +2 -1
  303. package/dist-lib/lib/oauth/resolve.d.ts +30 -10
  304. package/dist-lib/lib/oauth/resolve.js +12 -6
  305. package/dist-lib/lib/oauth/token-exchange-core.d.ts +12 -4
  306. package/dist-lib/lib/oauth/token-exchange-core.js +1 -1
  307. package/dist-lib/lib/oauth/types.d.ts +12 -12
  308. package/dist-lib/lib/oauth.d.ts +4 -5
  309. package/dist-lib/lib/oauth.js +2 -3
  310. package/dist-lib/lib/reconnecting-watch.d.ts +1 -1
  311. package/dist-lib/lib/reconnecting-watch.js +6 -6
  312. package/dist-lib/lib/retry-budget.js +6 -3
  313. package/dist-lib/lib/run-notices.d.ts +1 -0
  314. package/dist-lib/lib/run-notices.js +5 -2
  315. package/dist-lib/lib/run-transcript.d.ts +2 -4
  316. package/dist-lib/lib/run-transcript.js +4 -2
  317. package/dist-lib/lib/skill-readiness.js +4 -2
  318. package/dist-lib/lib/skill-types.d.ts +16 -16
  319. package/dist-lib/lib/suspend-lifecycle.d.ts +4 -4
  320. package/dist-lib/lib/suspend-lifecycle.js +10 -5
  321. package/dist-lib/lib/task.js +22 -12
  322. package/dist-lib/lib/unref.d.ts +3 -2
  323. package/dist-lib/lib/unref.js +2 -1
  324. package/dist-lib/lib/wav-duration.js +10 -5
  325. package/dist-lib/lib/write-queue.d.ts +5 -4
  326. package/dist-lib/lib/write-queue.js +2 -1
  327. package/dist-lib/schema/build.js +10 -6
  328. package/dist-lib/schema/config.d.ts +2 -3
  329. package/dist-lib/schema/content.d.ts +17 -2
  330. package/dist-lib/schema/content.js +2 -1
  331. package/dist-lib/schema/engine.d.ts +3 -2
  332. package/dist-lib/schema/engine.js +95 -6
  333. package/dist-lib/schema/field-order.js +22 -11
  334. package/dist-lib/schema/indexes.d.ts +22 -0
  335. package/dist-lib/schema/{helpers.js → indexes.js} +14 -57
  336. package/dist-lib/schema/local.d.ts +3 -2
  337. package/dist-lib/schema/local.js +7 -2
  338. package/dist-lib/schema/media-kind.d.ts +8 -0
  339. package/dist-lib/schema/media-kind.js +52 -0
  340. package/dist-lib/schema/qvac.d.ts +12 -9
  341. package/dist-lib/schema/qvac.js +8 -4
  342. package/dist-lib/spec/bind.js +12 -0
  343. package/dist-lib/spec/calls.js +4 -0
  344. package/dist-lib/spec/capabilities.d.ts +12 -4
  345. package/dist-lib/spec/hrpc/hrpc.json +54 -2
  346. package/dist-lib/spec/hrpc/index.js +53 -5
  347. package/dist-lib/spec/hrpc/messages.js +783 -494
  348. package/dist-lib/spec/hyperschema/index.js +783 -494
  349. package/dist-lib/spec/hyperschema/schema.json +247 -1
  350. package/dist-lib/spec/hyperschema/types.d.ts +69 -1
  351. package/dist-lib/spec/local/hyperdb/index.js +1 -1
  352. package/dist-lib/spec/local/hyperdb/messages.js +82 -14
  353. package/dist-lib/spec/local/hyperschema/index.js +42 -8
  354. package/dist-lib/spec/local/hyperschema/schema.json +27 -1
  355. package/dist-lib/spec/local/hyperschema/types.d.ts +6 -1
  356. package/dist-lib/spec/mesh/hyperdb/index.js +1 -1
  357. package/package.json +7 -3
  358. package/tui/app.mjs +2424 -941
  359. package/tui/boot.mjs +17 -46
  360. package/tui/index.mjs +10 -5
  361. package/tui/lib/boot-timing.mjs +8 -8
  362. package/tui/lib/busy-words.mjs +21 -22
  363. package/tui/lib/export.mjs +100 -32
  364. package/tui/lib/knowledge-command.mjs +64 -19
  365. package/tui/lib/knowledge-import.mjs +52 -18
  366. package/tui/lib/render.mjs +65 -33
  367. package/tui/lib/save-file.mjs +30 -13
  368. package/tui/lib/select.mjs +23 -5
  369. package/tui/lib/selection.mjs +6 -4
  370. package/tui/lib/setup.mjs +11 -19
  371. package/tui/lib/sidebar.mjs +23 -13
  372. package/tui/lib/splash.mjs +6 -7
  373. package/tui/lib/upload-frames.mjs +1 -2
  374. package/tui/lib/usage.mjs +13 -9
  375. package/tui/lib/wrap.mjs +35 -6
  376. package/tui/main.mjs +54 -78
  377. package/worker/assistant-sidecar.mjs +5 -10
  378. package/worker/stow-entry.mjs +7 -4
  379. package/dist-lib/lib/custom-model-source.d.ts +0 -15
  380. package/dist-lib/lib/custom-model-source.js +0 -46
  381. package/dist-lib/lib/oauth/common.d.ts +0 -38
  382. package/dist-lib/lib/oauth/common.js +0 -34
  383. package/dist-lib/schema/helpers.d.ts +0 -33
@@ -3,7 +3,10 @@ import { requireMesh } from './current-mesh.js';
3
3
  import { watchable } from './watchable.js';
4
4
  export function createNotificationsApi(pool, local, options = {}) {
5
5
  return {
6
- notificationsWatch: watchable('notificationsWatch', async (request) => notificationSource(await requireMesh(pool, request.meshId), local), (request, source) => notificationSnapshot(source.mesh, local, request.limit, options.deviceId)),
6
+ notificationsWatch: watchable(async (request) => notificationSource(await requireMesh(pool, request.meshId), local), (request, source) => notificationSnapshot(source.mesh, local, {
7
+ limit: request.limit,
8
+ deviceId: options.deviceId
9
+ }), { name: 'notificationsWatch' }),
7
10
  ackNotification: async ({ chatId, seq, notificationId, meshId }) => {
8
11
  if (notificationId) {
9
12
  if ((chatId !== undefined && chatId !== null) || (seq ?? 0) !== 0) {
@@ -43,30 +46,37 @@ function notificationSource(mesh, local) {
43
46
  }
44
47
  };
45
48
  }
46
- async function notificationSnapshot(mesh, local, requestedLimit, deviceId) {
49
+ async function notificationSnapshot(mesh, local, { limit: requestedLimit, deviceId }) {
47
50
  let chats = { notifications: [] };
48
51
  if (!mesh.closing && !mesh.closed) {
49
52
  try {
50
- chats = await deriveNotifications(mesh, local, Number.MAX_SAFE_INTEGER, deviceId);
53
+ chats = await deriveNotifications(mesh, local, {
54
+ limit: Number.MAX_SAFE_INTEGER,
55
+ deviceId
56
+ });
51
57
  }
52
58
  catch (error) {
53
- if (!mesh.closing && !mesh.closed)
59
+ if (!mesh.closing && !mesh.closed) {
54
60
  throw error;
61
+ }
55
62
  }
56
63
  }
57
64
  const models = await local.getModelNotifications();
58
- if (mesh.closing || mesh.closed)
65
+ if (mesh.closing || mesh.closed) {
59
66
  chats = { notifications: [] };
67
+ }
60
68
  const notifications = [
61
69
  ...(chats.notifications ?? []),
62
- ...models
63
- .filter((row) => row.notificationId && !row.acknowledged)
64
- .map((row) => ({
65
- kind: 'model-downloaded',
66
- notificationId: row.notificationId,
67
- modelName: row.name,
68
- createdAt: row.completedAt
69
- }))
70
+ ...models.flatMap((row) => row.notificationId && row.completedAt && !row.acknowledged
71
+ ? [
72
+ {
73
+ kind: 'model-downloaded',
74
+ notificationId: row.notificationId,
75
+ modelName: row.name,
76
+ createdAt: row.completedAt
77
+ }
78
+ ]
79
+ : [])
70
80
  ].sort((left, right) => right.createdAt - left.createdAt || (right.seq ?? 0) - (left.seq ?? 0));
71
81
  const limit = requestedLimit || 200;
72
82
  return {
@@ -4,4 +4,9 @@ import type { QvacAgent } from '../../spec/mesh/hyperschema/types.d.ts';
4
4
  import { type IndexingEmbedder, type VectorIndex } from '../core/files/index.ts';
5
5
  import { type MeshPool } from './current-mesh.ts';
6
6
  export declare const MAX_RAG_SEARCH_LIMIT = 20;
7
- export declare function createRagApi(pool: MeshPool, index: (meshId: string) => VectorIndex | null, embedder: (meshId: string) => IndexingEmbedder | null, effectiveCtxSize?: ((agent: QvacAgent | null) => Promise<number>) | null): Pick<CapabilityHandlers, 'ragSearch'>;
7
+ export interface CreateRagApiOptions {
8
+ readonly index: (meshId: string) => VectorIndex | null;
9
+ readonly embedder: (meshId: string) => IndexingEmbedder | null;
10
+ readonly effectiveCtxSize?: ((agent: QvacAgent | null) => Promise<number>) | null;
11
+ }
12
+ export declare function createRagApi(pool: MeshPool, { index, embedder, effectiveCtxSize }: CreateRagApiOptions): Pick<CapabilityHandlers, 'ragSearch'>;
@@ -4,6 +4,7 @@ import { getAgent } from '../core/agent.js';
4
4
  import { getChat } from '../core/chat.js';
5
5
  import { isKnowledgeRoutedAttachment, fullTextBudgetChars, fullTextHits, retrieveRagKnowledge, searchRagChunks, referencesPendingFile, referencedDocuments } from '../core/files/index.js';
6
6
  import { requireMesh } from './current-mesh.js';
7
+ import { errorMessage } from '../guards.js';
7
8
  export const MAX_RAG_SEARCH_LIMIT = 20;
8
9
  const DEFAULT_RAG_SEARCH_LIMIT = 5;
9
10
  function clampLimit(limit) {
@@ -11,7 +12,7 @@ function clampLimit(limit) {
11
12
  return DEFAULT_RAG_SEARCH_LIMIT;
12
13
  return Math.min(Math.max(1, Math.floor(limit)), MAX_RAG_SEARCH_LIMIT);
13
14
  }
14
- export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
15
+ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null }) {
15
16
  return {
16
17
  ragSearch: async ({ chatId, query, mode, limit, attachmentIds, meshId }) => {
17
18
  let pendingFiles = [];
@@ -19,8 +20,9 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
19
20
  const mesh = await requireMesh(pool, meshId);
20
21
  const chat = await getChat(mesh, chatId);
21
22
  const toolMode = mode === 'tool';
22
- if (!chat)
23
+ if (!chat) {
23
24
  return respond({ enabled: false });
25
+ }
24
26
  const agent = await getAgent(mesh, chat.agentId);
25
27
  let rows = await mesh.files.listKnowledge(chatId);
26
28
  const initialFiles = (await mesh.files.status(chatId)).files;
@@ -29,7 +31,8 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
29
31
  let scopeRows = rows.filter((row) => scopeIds.has(row.id));
30
32
  if (scopeIds.size > 0 && scopeRows.length === scopeIds.size) {
31
33
  const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
32
- const fullText = await fullTextHits(mesh, scopeRows, fullTextBudgetChars(ctxSize), {
34
+ const fullText = await fullTextHits(mesh, scopeRows, {
35
+ budgetChars: fullTextBudgetChars(ctxSize),
33
36
  head: !agentAllowsRagSearch(agent)
34
37
  });
35
38
  if (fullText) {
@@ -43,12 +46,15 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
43
46
  });
44
47
  }
45
48
  }
46
- if (!toolMode && !agentAllowsRagSearch(agent))
49
+ if (!toolMode && !agentAllowsRagSearch(agent)) {
47
50
  return respond({ enabled: false });
48
- if (rows.length === 0)
51
+ }
52
+ if (rows.length === 0) {
49
53
  return respond({});
54
+ }
50
55
  const namedRows = referencedDocuments(query, rows.map((row) => ({ id: row.id, title: row.fileName })));
51
- const requested = scopeIds.size ? scopeRows : namedRows.length ? namedRows : rows;
56
+ const unscoped = namedRows.length ? namedRows : rows;
57
+ const requested = scopeIds.size ? scopeRows : unscoped;
52
58
  const waiting = requested.filter((row) => !mesh.files.hydratedArtifact(row.id));
53
59
  if (waiting.length) {
54
60
  try {
@@ -69,8 +75,9 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
69
75
  const artifactByRow = new Map(rows.map((row) => [row, mesh.files.hydratedArtifact(row.id)]));
70
76
  const hydratedDocuments = [];
71
77
  for (const [row, artifactId] of artifactByRow) {
72
- if (artifactId)
78
+ if (artifactId) {
73
79
  hydratedDocuments.push({ documentId: artifactId, title: row.fileName });
80
+ }
74
81
  }
75
82
  const indexEmpty = hydratedDocuments.length === 0;
76
83
  const availableFiles = [...new Set(hydratedDocuments.map((document) => document.title))];
@@ -89,10 +96,12 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
89
96
  let scopePending = false;
90
97
  for (const row of scopeRows) {
91
98
  const artifactId = artifactByRow.get(row);
92
- if (artifactId)
99
+ if (artifactId) {
93
100
  scopeDocumentIds.push(artifactId);
94
- else if (!failedRows.has(row))
101
+ }
102
+ else if (!failedRows.has(row)) {
95
103
  scopePending = true;
104
+ }
96
105
  }
97
106
  if (scopePending && scopeDocumentIds.length === 0) {
98
107
  return respond({
@@ -156,7 +165,7 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
156
165
  indexEmpty,
157
166
  hasKnowledge,
158
167
  availableFiles,
159
- errorMessage: err instanceof Error ? err.message : String(err)
168
+ errorMessage: errorMessage(err)
160
169
  });
161
170
  }
162
171
  }
@@ -188,7 +197,7 @@ export function createRagApi(pool, index, embedder, effectiveCtxSize = null) {
188
197
  hasKnowledge,
189
198
  availableFiles,
190
199
  failedFiles,
191
- errorMessage: err instanceof Error ? err.message : String(err)
200
+ errorMessage: errorMessage(err)
192
201
  });
193
202
  }
194
203
  }
@@ -1,11 +1,11 @@
1
1
  import type { Bounds } from '../core/range.ts';
2
- type WireBounds = {
2
+ interface WireBounds {
3
3
  gt?: number | null;
4
4
  gte?: number | null;
5
5
  lt?: number | null;
6
6
  lte?: number | null;
7
7
  reverse?: boolean | null;
8
8
  limit?: number | null;
9
- };
9
+ }
10
10
  export declare function bounds({ gt, gte, lt, lte, reverse, limit }: WireBounds): Bounds;
11
11
  export {};
@@ -2,6 +2,6 @@ import { requireMesh } from './current-mesh.js';
2
2
  import { watchable } from './watchable.js';
3
3
  export function createSyncApi(pool) {
4
4
  return {
5
- syncStatusWatch: watchable('syncStatusWatch', async (request) => (await requireMesh(pool, request.meshId)).syncActivity ?? null, (_request, activity) => activity.snapshot())
5
+ syncStatusWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).syncActivity ?? null, (_request, activity) => activity.snapshot(), { name: 'syncStatusWatch' })
6
6
  };
7
7
  }
@@ -6,7 +6,10 @@ const DEFAULT_LIMIT = 200;
6
6
  const MAX_LIMIT = 1000;
7
7
  const DECISIONS = new Set(['auto', 'allowed', 'denied', 'skip-all', 'blocked']);
8
8
  function normalizeDecision(decision) {
9
- return DECISIONS.has(decision) ? decision : 'blocked';
9
+ return isDecision(decision) ? decision : 'blocked';
10
+ }
11
+ function isDecision(decision) {
12
+ return DECISIONS.has(decision);
10
13
  }
11
14
  function toEntry(row) {
12
15
  return {
@@ -33,10 +36,11 @@ export function createToolActivityApi(pool, deviceId) {
33
36
  });
34
37
  return {
35
38
  listToolActivity: async (request) => query(request, await requireMesh(pool, request.meshId)),
36
- toolActivityWatch: meshWatchable('toolActivityWatch', pool, query),
39
+ toolActivityWatch: meshWatchable(pool, query, { name: 'toolActivityWatch' }),
37
40
  recordToolActivity: async (request) => {
38
- if (!deviceId)
41
+ if (!deviceId) {
39
42
  throw new Error('cannot record tool activity without a device id');
43
+ }
40
44
  return recordToolActivity(await requireMesh(pool, request.meshId), {
41
45
  agentId: request.agentId,
42
46
  originDeviceId: deviceId,
@@ -1,8 +1,6 @@
1
1
  import { deleteToolConfigs, getToolConfigs, listToolConfigs, setToolConfigs } from '../core/tool-configs.js';
2
2
  import { meshWatchable, requireMesh } from './current-mesh.js';
3
- function isRecord(value) {
4
- return typeof value === 'object' && value !== null && !Array.isArray(value);
5
- }
3
+ import { isRecord } from '../guards.js';
6
4
  function ensureSettingsPayload(value) {
7
5
  if (!isRecord(value))
8
6
  throw new Error('tool configs must be a plain object');
@@ -20,7 +18,7 @@ export function createToolConfigsApi(pool) {
20
18
  }),
21
19
  deleteToolConfigs: async ({ agentId, toolName, meshId }) => deleteToolConfigs(await requireMesh(pool, meshId), agentId, toolName),
22
20
  listToolConfigs: async (request) => query(request, await requireMesh(pool, request.meshId)),
23
- toolConfigsWatch: meshWatchable('toolConfigsWatch', pool, query)
21
+ toolConfigsWatch: meshWatchable(pool, query, { name: 'toolConfigsWatch' })
24
22
  };
25
23
  }
26
24
  export { getToolConfigs };
@@ -1,9 +1,8 @@
1
+ import type { HandlerFrames } from '../../spec/capabilities.d.ts';
1
2
  export declare const UPLOAD_NAMES_NO_MESH = "an upload must name its mesh on its first frame";
2
- export type UploadFrames<Frame> = AsyncIterable<Frame> | {
3
- writeStream?: unknown;
4
- on: (...args: never[]) => void;
5
- };
6
- export declare function openUpload<Frame>(frames: UploadFrames<Frame>): Promise<{
7
- first: Frame;
8
- rest: AsyncIterable<Frame>;
9
- } | null>;
3
+ export type UploadFrames<Frame> = AsyncIterable<Frame> | HandlerFrames<Frame>;
4
+ export interface OpenedUpload<Frame> {
5
+ readonly first: Frame;
6
+ readonly rest: AsyncIterable<Frame>;
7
+ }
8
+ export declare function openUpload<Frame>(frames: UploadFrames<Frame>): Promise<OpenedUpload<Frame> | null>;
@@ -3,8 +3,9 @@ export const UPLOAD_NAMES_NO_MESH = 'an upload must name its mesh on its first f
3
3
  export async function openUpload(frames) {
4
4
  const iterator = toAsyncIterable(frames)[Symbol.asyncIterator]();
5
5
  const first = await iterator.next();
6
- if (first.done)
6
+ if (first.done) {
7
7
  return null;
8
+ }
8
9
  const rest = replay(first.value, iterator);
9
10
  if ('writeStream' in frames) {
10
11
  Object.assign(rest, { writeStream: frames.writeStream });
@@ -3,10 +3,15 @@ import '../logger.ts';
3
3
  interface WatchableStore {
4
4
  watch(listener: () => void): void;
5
5
  unwatch(listener: () => void): void;
6
+ sampled?: boolean;
6
7
  once?(event: 'close', listener: () => void): unknown;
7
8
  off?(event: 'close', listener: () => void): unknown;
8
9
  closing?: unknown;
9
10
  closed?: boolean;
10
11
  }
11
- export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(name: string, storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, changes?: WatchableStore): (request: TRequest) => Readable & AsyncIterable<TResult>;
12
+ export interface WatchableOptions {
13
+ readonly name: string;
14
+ readonly changes?: WatchableStore;
15
+ }
16
+ 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>;
12
17
  export {};
@@ -1,8 +1,10 @@
1
1
  import b4a from 'b4a';
2
2
  import { Readable } from 'streamx';
3
+ import { frameReadable } from '../frame-readable.js';
3
4
  import '../logger.js';
5
+ import { asError, isRecord } from '../guards.js';
4
6
  const SCOPE = ['api', 'watch'];
5
- const CHURN_WINDOW_MS = 1000;
7
+ const CHURN_WINDOW_MS = 30_000;
6
8
  function snapshotEquals(a, b) {
7
9
  if (a === b)
8
10
  return true;
@@ -10,21 +12,21 @@ function snapshotEquals(a, b) {
10
12
  return b4a.isBuffer(a) && b4a.isBuffer(b) && b4a.equals(a, b);
11
13
  }
12
14
  if (Array.isArray(a) || Array.isArray(b)) {
13
- if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
15
+ if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {
14
16
  return false;
17
+ }
15
18
  return a.every((item, i) => snapshotEquals(item, b[i]));
16
19
  }
17
- if (!isRecord(a) || !isRecord(b))
20
+ if (!isRecord(a) || !isRecord(b)) {
18
21
  return false;
22
+ }
19
23
  const keys = Object.keys(a);
20
- if (keys.length !== Object.keys(b).length)
24
+ if (keys.length !== Object.keys(b).length) {
21
25
  return false;
26
+ }
22
27
  return keys.every((key) => snapshotEquals(a[key], b[key]));
23
28
  }
24
- function isRecord(value) {
25
- return typeof value === 'object' && value !== null;
26
- }
27
- export function watchable(name, storeOf, query, changes) {
29
+ export function watchable(storeOf, query, { name, changes }) {
28
30
  return (request) => {
29
31
  const resolved = storeOf(request);
30
32
  const pending = resolved instanceof Promise ? resolved.catch(noop) : null;
@@ -40,12 +42,19 @@ export function watchable(name, storeOf, query, changes) {
40
42
  return;
41
43
  const now = Date.now();
42
44
  const elapsed = now - reportedAt;
43
- if (!force && elapsed < CHURN_WINDOW_MS)
45
+ if (!force && elapsed < CHURN_WINDOW_MS) {
44
46
  return;
47
+ }
45
48
  logger.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
46
49
  churn = 0;
47
50
  reportedAt = now;
48
51
  };
52
+ const countUnchanged = () => {
53
+ if (store?.sampled)
54
+ return;
55
+ churn++;
56
+ reportChurn(false);
57
+ };
49
58
  const onChange = () => {
50
59
  dirty = true;
51
60
  wake?.resolve();
@@ -59,8 +68,9 @@ export function watchable(name, storeOf, query, changes) {
59
68
  const storeGone = () => store === null || ended || Boolean(store.closed) || Boolean(store.closing);
60
69
  const stream = new Readable({
61
70
  async open(cb) {
62
- if (pending)
71
+ if (pending) {
63
72
  store = (await pending) ?? null;
73
+ }
64
74
  store?.watch(onChange);
65
75
  changes?.watch(onChange);
66
76
  store?.once?.('close', onStoreClose);
@@ -85,8 +95,7 @@ export function watchable(name, storeOf, query, changes) {
85
95
  break;
86
96
  }
87
97
  if (snapshotEquals(next, last)) {
88
- churn++;
89
- reportChurn(false);
98
+ countUnchanged();
90
99
  continue;
91
100
  }
92
101
  reportChurn(true);
@@ -102,7 +111,7 @@ export function watchable(name, storeOf, query, changes) {
102
111
  cb(null);
103
112
  }
104
113
  else {
105
- cb(err);
114
+ cb(asError(err));
106
115
  }
107
116
  }
108
117
  },
@@ -117,7 +126,7 @@ export function watchable(name, storeOf, query, changes) {
117
126
  cb(null);
118
127
  }
119
128
  });
120
- return stream;
129
+ return frameReadable(stream);
121
130
  };
122
131
  }
123
132
  function noop() { }
@@ -11,8 +11,9 @@ export async function raceInactivity(promise, signal, timeoutMs) {
11
11
  return await raceAbort(Promise.race([promise, expired]), signal);
12
12
  }
13
13
  finally {
14
- if (timer !== null)
14
+ if (timer !== null) {
15
15
  clearTimeout(timer);
16
+ }
16
17
  }
17
18
  }
18
19
  export async function drainBody(body, signal, timeoutMs) {
@@ -23,8 +24,9 @@ export async function drainBody(body, signal, timeoutMs) {
23
24
  try {
24
25
  for (;;) {
25
26
  const read = await raceInactivity(reader.read(), signal, timeoutMs);
26
- if (read.done)
27
+ if (read.done) {
27
28
  break;
29
+ }
28
30
  parts.push(b4a.from(read.value));
29
31
  }
30
32
  }
@@ -1,9 +1,9 @@
1
1
  import type { AbortSignal } from 'bare-abort-controller';
2
- import type { ApprovalCall, MemoryBudget } from '@qvac/harness';
2
+ import type { ApprovalCall, CompletionEvent, DeleteModelSummary, MemoryBudget, ModelSourcePreview, PreviewModelSourceContext } from '@qvac/harness';
3
3
  import type { ManagedSkill, SkillFileContent } from '@qvac/harness/lib/tools/skills/overlay-crud.ts';
4
- import type { SkillManagementHooks } from '../core.ts';
4
+ import type { SkillCatalogOptions, SkillManagementHooks } from '../core.ts';
5
5
  import type { DriveOpFn, GrantedDrive } from '@qvac/harness/lib/tools/fs/remote.ts';
6
- import type { AssistantAgent, AssistantCapabilityProfile, AssistantChunkContentAttachment, AssistantDeleteModelRequest, AssistantDetectLanguageRequest, AssistantDetectLanguageResponse, AssistantDeleteModelResponse, AssistantEnhanceMode, AssistantKvCacheDeletionResponse, AssistantListModelsRequest, AssistantModelInfoList, AssistantSkillCatalogResponse, AssistantSpeakRequest, AssistantSpeakResponse, AssistantToolCatalogResponse, AssistantToolReportEntry, AssistantTranscribeRequest, AssistantTranscribeResponse } from '../../spec/hyperschema/types.d.ts';
6
+ 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
7
  import type { HarnessDiagnostics } from '../diagnostics.ts';
8
8
  import type { DownloadArgs, DownloadEventStream, ImageDownloadObservation } from '../model-download.ts';
9
9
  import type { AttachInput, AttachmentMeta, ChatMessage, FetchedAttachment } from './message.ts';
@@ -19,6 +19,10 @@ export interface DetectedLanguage {
19
19
  language: string;
20
20
  probability?: number;
21
21
  }
22
+ export type HarnessEventOf<Type extends CompletionEvent['type']> = HarnessEvent & CompletionEvent & {
23
+ type: Type;
24
+ };
25
+ export declare function isHarnessEvent<Type extends CompletionEvent['type']>(event: HarnessEvent, type: Type): event is HarnessEventOf<Type>;
22
26
  export interface ModelState {
23
27
  status: string;
24
28
  model?: string;
@@ -49,11 +53,7 @@ export interface ListModelsOptions {
49
53
  cachedOnly?: boolean;
50
54
  fullRegistry?: boolean;
51
55
  }
52
- export interface DeleteModelSummary {
53
- name: string;
54
- removed: number;
55
- freedBytes: number;
56
- }
56
+ export type { DeleteModelSummary };
57
57
  export interface ToolCatalogEntry {
58
58
  name: string;
59
59
  description: string;
@@ -64,6 +64,14 @@ export interface ToolCatalogEntry {
64
64
  writeRootsRequired?: boolean;
65
65
  promptChars?: number;
66
66
  }
67
+ export interface DeviceCapability {
68
+ capabilityProfile: AssistantCapabilityProfile;
69
+ recommendedModelName: string;
70
+ memoryBudget?: MemoryBudget;
71
+ }
72
+ export interface ImageProgress {
73
+ readonly percentage: number;
74
+ }
67
75
  export interface Harness {
68
76
  completion(context: {
69
77
  model: string;
@@ -121,9 +129,7 @@ export interface Harness {
121
129
  score: number;
122
130
  }>;
123
131
  }>;
124
- progress?: (update: {
125
- percentage: number;
126
- } | null) => void;
132
+ progress?: (update: ImageProgress | null) => void;
127
133
  signal?: AbortSignal;
128
134
  }): AsyncIterable<HarnessEvent>;
129
135
  invoke?(context: {
@@ -137,9 +143,7 @@ export interface Harness {
137
143
  signal?: AbortSignal;
138
144
  meta?: boolean;
139
145
  }) => Promise<FetchedAttachment | AttachmentMeta | null>;
140
- progress?: (update: {
141
- percentage: number;
142
- } | null) => void;
146
+ progress?: (update: ImageProgress | null) => void;
143
147
  signal?: AbortSignal;
144
148
  }): AsyncIterable<HarnessEvent>;
145
149
  describe?(): Promise<HarnessInfo | null> | HarnessInfo;
@@ -154,6 +158,18 @@ export interface Harness {
154
158
  agent?: AssistantAgent;
155
159
  signal?: AbortSignal;
156
160
  }): Promise<void>;
161
+ loadModel?(context: {
162
+ model: string;
163
+ agent?: Pick<AssistantAgent, 'ctxSize' | 'kvCacheK' | 'kvCacheV'>;
164
+ }): Promise<{
165
+ loaded: boolean;
166
+ reason?: 'memory';
167
+ }>;
168
+ unloadModel?(context: {
169
+ model: string;
170
+ }): Promise<{
171
+ unloaded: boolean;
172
+ }>;
157
173
  deleteModel?(name: string): Promise<DeleteModelSummary>;
158
174
  clearKvCache?(): Promise<AssistantKvCacheDeletionResponse>;
159
175
  deleteKvCache?(kvCacheKey: string): Promise<AssistantKvCacheDeletionResponse>;
@@ -161,11 +177,7 @@ export interface Harness {
161
177
  name: string;
162
178
  addon: string;
163
179
  }>>;
164
- capability?(): Promise<{
165
- capabilityProfile: AssistantCapabilityProfile;
166
- recommendedModelName: string;
167
- memoryBudget?: MemoryBudget;
168
- }>;
180
+ capability?(): Promise<DeviceCapability>;
169
181
  download?(args: DownloadArgs): DownloadEventStream;
170
182
  transcribe?(context: {
171
183
  model: string;
@@ -202,18 +214,20 @@ export interface Harness {
202
214
  name: string;
203
215
  src: string;
204
216
  projectionSrc?: string;
217
+ taskType?: string;
218
+ expectedSize?: number;
219
+ label?: string;
220
+ contextLength?: number;
205
221
  }>): void | Promise<void>;
206
222
  setModelIdleTimeout?(ms: number): void | Promise<void>;
223
+ previewModelSource?(input: PreviewModelSourceContext): Promise<ModelSourcePreview>;
207
224
  on?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
208
225
  off?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
209
226
  presuspend?(): Promise<void> | void;
210
227
  suspend?(): Promise<void> | void;
211
228
  wakeup?(): Promise<void> | void;
212
229
  resume?(): Promise<void> | void;
213
- skills?(agentId?: string | null, modelName?: string | null, options?: {
214
- readonly refresh?: boolean;
215
- readonly skipCredentialProbe?: boolean;
216
- }): Promise<ReadonlyArray<Skill>>;
230
+ skills?(agentId?: string | null, modelName?: string | null, options?: SkillCatalogOptions): Promise<ReadonlyArray<Skill>>;
217
231
  tools?(): Promise<ReadonlyArray<ToolCatalogEntry>>;
218
232
  listManagedSkills?(): Promise<ReadonlyArray<ManagedSkill>>;
219
233
  readSkillFile?(name: string): Promise<SkillFileContent | null>;
@@ -236,13 +250,20 @@ export interface Harness {
236
250
  export declare function harnessListModels(harness: Pick<Harness, 'list'>): (options: AssistantListModelsRequest) => Promise<AssistantModelInfoList>;
237
251
  export declare function harnessDeleteModel(harness: Pick<Harness, 'deleteModel'>): (options: AssistantDeleteModelRequest) => Promise<AssistantDeleteModelResponse>;
238
252
  export declare function harnessClearKvCache(harness: Pick<Harness, 'clearKvCache'>): () => Promise<AssistantKvCacheDeletionResponse>;
253
+ type SameFields<A, B> = [Exclude<keyof A, keyof B>, Exclude<keyof B, keyof A>] extends [
254
+ never,
255
+ never
256
+ ] ? true : {
257
+ onlyInHarness: Exclude<keyof A, keyof B>;
258
+ onlyInCore: Exclude<keyof B, keyof A>;
259
+ };
260
+ export declare const PREVIEW_CONTRACT_MATCHES: SameFields<ModelSourcePreview, AssistantCustomModelPreview>;
261
+ export declare const DELETE_CONTRACT_MATCHES: SameFields<DeleteModelSummary, AssistantDeleteModelResponse>;
262
+ export declare function harnessPreviewModelSource(harness: Pick<Harness, 'previewModelSource'>): (request: AssistantPreviewCustomModelRequest) => Promise<AssistantCustomModelPreview>;
239
263
  export declare function harnessTranscribe(harness: Pick<Harness, 'transcribe'>): (request: AssistantTranscribeRequest) => Promise<AssistantTranscribeResponse>;
240
264
  export declare function harnessDetectLanguage(harness: Pick<Harness, 'detectLanguage'>): (request: AssistantDetectLanguageRequest) => Promise<AssistantDetectLanguageResponse>;
241
265
  export declare function harnessSpeak(harness: Pick<Harness, 'speak'>): (request: AssistantSpeakRequest) => Promise<AssistantSpeakResponse>;
242
- export declare function harnessSkillCatalog(harness: Pick<Harness, 'skills'>, syncCredentials?: () => Promise<void> | undefined): (agentId?: string | null, modelName?: string | null, options?: {
243
- readonly refresh?: boolean;
244
- readonly skipCredentialProbe?: boolean;
245
- }) => Promise<AssistantSkillCatalogResponse>;
266
+ export declare function harnessSkillCatalog(harness: Pick<Harness, 'skills'>, syncCredentials?: () => Promise<void> | undefined): (agentId?: string | null, modelName?: string | null, options?: SkillCatalogOptions) => Promise<AssistantSkillCatalogResponse>;
246
267
  export declare function harnessSkillManagement(harness: Pick<Harness, 'listManagedSkills' | 'readSkillFile' | 'writeSkillFile' | 'copyBaseForEdit' | 'deleteOverlaySkill'>): SkillManagementHooks;
247
268
  export declare function harnessTools(harness: Pick<Harness, 'tools'>): () => Promise<AssistantToolCatalogResponse>;
248
269
  export declare function toolReportEntry(tool: ToolCatalogEntry): AssistantToolReportEntry;