@qvac/core 0.4.1 → 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 (417) hide show
  1. package/CHANGELOG.md +262 -1
  2. package/README.md +1 -1
  3. package/dist-lib/lib/api/agents.js +3 -2
  4. package/dist-lib/lib/api/app-config.d.ts +1 -1
  5. package/dist-lib/lib/api/app-config.js +54 -15
  6. package/dist-lib/lib/api/attachments.d.ts +6 -5
  7. package/dist-lib/lib/api/attachments.js +4 -2
  8. package/dist-lib/lib/api/chat.d.ts +7 -3
  9. package/dist-lib/lib/api/chat.js +4 -4
  10. package/dist-lib/lib/api/chunks.js +3 -3
  11. package/dist-lib/lib/api/config.js +2 -2
  12. package/dist-lib/lib/api/current-mesh.d.ts +3 -4
  13. package/dist-lib/lib/api/current-mesh.js +9 -4
  14. package/dist-lib/lib/api/custom-models.d.ts +8 -1
  15. package/dist-lib/lib/api/custom-models.js +53 -16
  16. package/dist-lib/lib/api/devices.d.ts +14 -5
  17. package/dist-lib/lib/api/devices.js +14 -9
  18. package/dist-lib/lib/api/diagnostics.d.ts +1 -0
  19. package/dist-lib/lib/api/diagnostics.js +1 -1
  20. package/dist-lib/lib/api/effective-ctx-size.d.ts +6 -1
  21. package/dist-lib/lib/api/effective-ctx-size.js +5 -3
  22. package/dist-lib/lib/api/execution.js +9 -2
  23. package/dist-lib/lib/api/files.js +2 -1
  24. package/dist-lib/lib/api/index.d.ts +7 -1
  25. package/dist-lib/lib/api/index.js +101 -101
  26. package/dist-lib/lib/api/instrument.js +29 -20
  27. package/dist-lib/lib/api/knowledge.d.ts +6 -5
  28. package/dist-lib/lib/api/knowledge.js +8 -6
  29. package/dist-lib/lib/api/local-files.js +1 -1
  30. package/dist-lib/lib/api/logs.js +6 -3
  31. package/dist-lib/lib/api/members.js +22 -13
  32. package/dist-lib/lib/api/mesh.d.ts +7 -2
  33. package/dist-lib/lib/api/mesh.js +10 -5
  34. package/dist-lib/lib/api/model-download.js +1 -1
  35. package/dist-lib/lib/api/network.d.ts +1 -0
  36. package/dist-lib/lib/api/network.js +1 -1
  37. package/dist-lib/lib/api/notifications.js +23 -13
  38. package/dist-lib/lib/api/rag.d.ts +6 -1
  39. package/dist-lib/lib/api/rag.js +20 -11
  40. package/dist-lib/lib/api/range.d.ts +2 -2
  41. package/dist-lib/lib/api/sync.js +1 -1
  42. package/dist-lib/lib/api/tool-activity.js +7 -3
  43. package/dist-lib/lib/api/tool-configs.js +2 -4
  44. package/dist-lib/lib/api/upload-frames.d.ts +7 -8
  45. package/dist-lib/lib/api/upload-frames.js +2 -1
  46. package/dist-lib/lib/api/watchable.d.ts +6 -1
  47. package/dist-lib/lib/api/watchable.js +23 -14
  48. package/dist-lib/lib/assistant/fetch-body.js +4 -2
  49. package/dist-lib/lib/assistant/harness.d.ts +72 -24
  50. package/dist-lib/lib/assistant/harness.js +53 -15
  51. package/dist-lib/lib/assistant/history.d.ts +9 -7
  52. package/dist-lib/lib/assistant/history.js +77 -42
  53. package/dist-lib/lib/assistant/message.d.ts +5 -3
  54. package/dist-lib/lib/assistant/message.js +4 -2
  55. package/dist-lib/lib/assistant/skill-encode.d.ts +3 -1
  56. package/dist-lib/lib/assistant/skill-encode.js +52 -62
  57. package/dist-lib/lib/assistant-client.js +7 -4
  58. package/dist-lib/lib/assistant-tree.js +36 -11
  59. package/dist-lib/lib/assistant.d.ts +37 -12
  60. package/dist-lib/lib/assistant.js +977 -373
  61. package/dist-lib/lib/audio-format.d.ts +1 -1
  62. package/dist-lib/lib/audio-format.js +1 -1
  63. package/dist-lib/lib/chat-title.js +9 -4
  64. package/dist-lib/lib/client.js +3 -2
  65. package/dist-lib/lib/collabora/convert.d.ts +2 -2
  66. package/dist-lib/lib/collabora/convert.js +6 -3
  67. package/dist-lib/lib/collabora/entry.js +9 -5
  68. package/dist-lib/lib/collabora/protocol.d.ts +2 -2
  69. package/dist-lib/lib/collabora/protocol.js +14 -7
  70. package/dist-lib/lib/collabora/worker.js +14 -7
  71. package/dist-lib/lib/compaction.d.ts +5 -6
  72. package/dist-lib/lib/compaction.js +14 -7
  73. package/dist-lib/lib/constants.d.ts +2 -0
  74. package/dist-lib/lib/constants.js +4 -0
  75. package/dist-lib/lib/core/account-recovery.d.ts +4 -3
  76. package/dist-lib/lib/core/account-recovery.js +7 -4
  77. package/dist-lib/lib/core/agent.d.ts +0 -1
  78. package/dist-lib/lib/core/agent.js +18 -16
  79. package/dist-lib/lib/core/approval-rules.d.ts +7 -6
  80. package/dist-lib/lib/core/approval-rules.js +12 -6
  81. package/dist-lib/lib/core/archived-mesh.d.ts +7 -5
  82. package/dist-lib/lib/core/archived-mesh.js +25 -22
  83. package/dist-lib/lib/core/async-iterable.js +10 -5
  84. package/dist-lib/lib/core/attachment-link.d.ts +2 -2
  85. package/dist-lib/lib/core/audio-attachment.js +1 -1
  86. package/dist-lib/lib/core/blind-peers.d.ts +2 -2
  87. package/dist-lib/lib/core/chat-activity.d.ts +2 -2
  88. package/dist-lib/lib/core/chat-activity.js +42 -21
  89. package/dist-lib/lib/core/chat-group.d.ts +8 -6
  90. package/dist-lib/lib/core/chat-group.js +17 -10
  91. package/dist-lib/lib/core/chat-order.d.ts +11 -9
  92. package/dist-lib/lib/core/chat-order.js +1 -3
  93. package/dist-lib/lib/core/chat-search.d.ts +4 -4
  94. package/dist-lib/lib/core/chat-search.js +38 -24
  95. package/dist-lib/lib/core/chat.d.ts +20 -14
  96. package/dist-lib/lib/core/chat.js +42 -28
  97. package/dist-lib/lib/core/chunk.d.ts +20 -24
  98. package/dist-lib/lib/core/chunk.js +34 -22
  99. package/dist-lib/lib/core/collections.d.ts +69 -0
  100. package/dist-lib/lib/core/collections.js +69 -0
  101. package/dist-lib/lib/core/contract/activity.d.ts +8 -2
  102. package/dist-lib/lib/core/contract/activity.js +39 -11
  103. package/dist-lib/lib/core/contract/agents.js +3 -2
  104. package/dist-lib/lib/core/contract/approval-rules.js +1 -1
  105. package/dist-lib/lib/core/contract/attestations.js +1 -1
  106. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  107. package/dist-lib/lib/core/contract/chat.js +1 -1
  108. package/dist-lib/lib/core/contract/chunks.js +16 -9
  109. package/dist-lib/lib/core/contract/compute.js +2 -1
  110. package/dist-lib/lib/core/contract/devices.js +10 -6
  111. package/dist-lib/lib/core/contract/grant-order.d.ts +5 -0
  112. package/dist-lib/lib/core/contract/grant-order.js +20 -0
  113. package/dist-lib/lib/core/contract/index.d.ts +1 -1
  114. package/dist-lib/lib/core/contract/index.js +27 -2
  115. package/dist-lib/lib/core/contract/indexing.js +3 -3
  116. package/dist-lib/lib/core/contract/invites.d.ts +16 -0
  117. package/dist-lib/lib/core/contract/invites.js +256 -0
  118. package/dist-lib/lib/core/contract/joined-meshes.js +22 -22
  119. package/dist-lib/lib/core/contract/knowledge.js +5 -5
  120. package/dist-lib/lib/core/contract/members.d.ts +15 -0
  121. package/dist-lib/lib/core/contract/members.js +116 -31
  122. package/dist-lib/lib/core/contract/mesh-kind.d.ts +6 -0
  123. package/dist-lib/lib/core/contract/mesh-kind.js +49 -0
  124. package/dist-lib/lib/core/contract/seal.js +1 -1
  125. package/dist-lib/lib/core/contract/seed-defaults.js +1 -3
  126. package/dist-lib/lib/core/contract/tool-activity.js +5 -5
  127. package/dist-lib/lib/core/contract/tool-configs.js +1 -2
  128. package/dist-lib/lib/core/contract/writers.d.ts +13 -0
  129. package/dist-lib/lib/core/contract/writers.js +181 -24
  130. package/dist-lib/lib/core/departures.js +16 -8
  131. package/dist-lib/lib/core/device-attestation.d.ts +5 -0
  132. package/dist-lib/lib/core/device-attestation.js +24 -0
  133. package/dist-lib/lib/core/device-invites.d.ts +2 -0
  134. package/dist-lib/lib/core/device-invites.js +29 -7
  135. package/dist-lib/lib/core/devices.d.ts +2 -1
  136. package/dist-lib/lib/core/devices.js +52 -2
  137. package/dist-lib/lib/core/document-attachment.d.ts +20 -11
  138. package/dist-lib/lib/core/document-attachment.js +10 -5
  139. package/dist-lib/lib/core/files/attachments.d.ts +2 -5
  140. package/dist-lib/lib/core/files/attachments.js +6 -3
  141. package/dist-lib/lib/core/files/index.d.ts +44 -52
  142. package/dist-lib/lib/core/files/index.js +142 -93
  143. package/dist-lib/lib/core/files/knowledge.d.ts +2 -5
  144. package/dist-lib/lib/core/files/local-index.js +9 -5
  145. package/dist-lib/lib/core/files/preview/image.d.ts +0 -1
  146. package/dist-lib/lib/core/files/preview/image.js +9 -6
  147. package/dist-lib/lib/core/files/preview/index.d.ts +8 -11
  148. package/dist-lib/lib/core/files/preview/index.js +20 -15
  149. package/dist-lib/lib/core/files/processing/claims.d.ts +6 -5
  150. package/dist-lib/lib/core/files/processing/claims.js +16 -8
  151. package/dist-lib/lib/core/files/processing/document.d.ts +21 -50
  152. package/dist-lib/lib/core/files/processing/index.d.ts +18 -13
  153. package/dist-lib/lib/core/files/processing/index.js +65 -37
  154. package/dist-lib/lib/core/files/processing/ownership.d.ts +8 -1
  155. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  156. package/dist-lib/lib/core/files/processing/protocol.d.ts +19 -19
  157. package/dist-lib/lib/core/files/processing/protocol.js +5 -5
  158. package/dist-lib/lib/core/files/processing/settle.d.ts +10 -7
  159. package/dist-lib/lib/core/files/processing/settle.js +22 -11
  160. package/dist-lib/lib/core/files/processing/source.js +14 -8
  161. package/dist-lib/lib/core/files/processing/state.d.ts +13 -11
  162. package/dist-lib/lib/core/files/processing/state.js +19 -12
  163. package/dist-lib/lib/core/files/rag/build.d.ts +2 -2
  164. package/dist-lib/lib/core/files/rag/build.js +2 -1
  165. package/dist-lib/lib/core/files/rag/document-types.d.ts +4 -6
  166. package/dist-lib/lib/core/files/rag/index.d.ts +10 -13
  167. package/dist-lib/lib/core/files/rag/index.js +3 -2
  168. package/dist-lib/lib/core/files/rag/load.d.ts +10 -9
  169. package/dist-lib/lib/core/files/rag/load.js +26 -13
  170. package/dist-lib/lib/core/files/rag/policy.js +2 -1
  171. package/dist-lib/lib/core/files/rag/produce.js +33 -19
  172. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +5 -3
  173. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +30 -10
  174. package/dist-lib/lib/core/files/records/chunks.js +4 -2
  175. package/dist-lib/lib/core/files/records/knowledge.d.ts +10 -11
  176. package/dist-lib/lib/core/files/records/knowledge.js +9 -8
  177. package/dist-lib/lib/core/files/records/linkage.js +6 -3
  178. package/dist-lib/lib/core/files/records/output.d.ts +5 -4
  179. package/dist-lib/lib/core/files/records/output.js +8 -4
  180. package/dist-lib/lib/core/files/records/reclaim.js +41 -25
  181. package/dist-lib/lib/core/files/records/routing.d.ts +4 -6
  182. package/dist-lib/lib/core/files/records/routing.js +15 -8
  183. package/dist-lib/lib/core/files/records/source.d.ts +5 -4
  184. package/dist-lib/lib/core/files/records/source.js +20 -14
  185. package/dist-lib/lib/core/files/records/sweep.js +1 -3
  186. package/dist-lib/lib/core/files/store/blob.d.ts +10 -10
  187. package/dist-lib/lib/core/files/store/blob.js +25 -19
  188. package/dist-lib/lib/core/files/store/index.d.ts +1 -6
  189. package/dist-lib/lib/core/files/store/index.js +4 -4
  190. package/dist-lib/lib/core/files/store/inline.d.ts +2 -2
  191. package/dist-lib/lib/core/files/store/inline.js +6 -3
  192. package/dist-lib/lib/core/files/store/reference.d.ts +6 -9
  193. package/dist-lib/lib/core/files/store/reference.js +25 -17
  194. package/dist-lib/lib/core/files/store/server.d.ts +7 -6
  195. package/dist-lib/lib/core/files/store/server.js +22 -11
  196. package/dist-lib/lib/core/files/store/sweep.js +13 -7
  197. package/dist-lib/lib/core/files/upload-input.d.ts +4 -12
  198. package/dist-lib/lib/core/files/upload-input.js +10 -5
  199. package/dist-lib/lib/core/files/upload.d.ts +27 -24
  200. package/dist-lib/lib/core/files/upload.js +74 -51
  201. package/dist-lib/lib/core/fs-drives.js +4 -2
  202. package/dist-lib/lib/core/grant-expiry.d.ts +11 -0
  203. package/dist-lib/lib/core/grant-expiry.js +66 -0
  204. package/dist-lib/lib/core/handoff-channel.d.ts +2 -1
  205. package/dist-lib/lib/core/handoff-channel.js +36 -15
  206. package/dist-lib/lib/core/harness-loan.js +35 -17
  207. package/dist-lib/lib/core/helpers/index.d.ts +2 -1
  208. package/dist-lib/lib/core/helpers/index.js +11 -6
  209. package/dist-lib/lib/core/hosted-agents.js +19 -12
  210. package/dist-lib/lib/core/id.js +1 -1
  211. package/dist-lib/lib/core/identity.d.ts +1 -0
  212. package/dist-lib/lib/core/identity.js +11 -3
  213. package/dist-lib/lib/core/image/cache-sweep.d.ts +12 -10
  214. package/dist-lib/lib/core/image/cache-sweep.js +11 -6
  215. package/dist-lib/lib/core/image/normalize.d.ts +6 -0
  216. package/dist-lib/lib/core/image/normalize.js +12 -2
  217. package/dist-lib/lib/core/image/sniff.js +42 -21
  218. package/dist-lib/lib/core/inference-calls-receiver.js +7 -4
  219. package/dist-lib/lib/core/invite-grants.d.ts +20 -0
  220. package/dist-lib/lib/core/invite-grants.js +46 -0
  221. package/dist-lib/lib/core/invite.d.ts +3 -0
  222. package/dist-lib/lib/core/invite.js +6 -3
  223. package/dist-lib/lib/core/local/files.js +20 -19
  224. package/dist-lib/lib/core/local/index.d.ts +70 -45
  225. package/dist-lib/lib/core/local/index.js +157 -126
  226. package/dist-lib/lib/core/membership.d.ts +15 -2
  227. package/dist-lib/lib/core/membership.js +95 -20
  228. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +12 -4
  229. package/dist-lib/lib/core/mesh-seed-handoff.js +23 -5
  230. package/dist-lib/lib/core/mesh.d.ts +57 -30
  231. package/dist-lib/lib/core/mesh.js +232 -78
  232. package/dist-lib/lib/core/migrations/agent-catalog.js +3 -2
  233. package/dist-lib/lib/core/migrations/agent-indexes.js +3 -3
  234. package/dist-lib/lib/core/migrations/device-indexes.d.ts +2 -0
  235. package/dist-lib/lib/core/migrations/device-indexes.js +7 -0
  236. package/dist-lib/lib/core/migrations/file-index.js +7 -4
  237. package/dist-lib/lib/core/migrations/index.d.ts +4 -3
  238. package/dist-lib/lib/core/migrations/index.js +3 -1
  239. package/dist-lib/lib/core/migrations/membership.js +9 -4
  240. package/dist-lib/lib/core/migrations/seal.js +3 -2
  241. package/dist-lib/lib/core/min-version.js +4 -2
  242. package/dist-lib/lib/core/next-frame.d.ts +5 -4
  243. package/dist-lib/lib/core/next-frame.js +6 -3
  244. package/dist-lib/lib/core/notification.d.ts +5 -1
  245. package/dist-lib/lib/core/notification.js +89 -77
  246. package/dist-lib/lib/core/ota-config.js +2 -1
  247. package/dist-lib/lib/core/pdf/rasterize.d.ts +18 -0
  248. package/dist-lib/lib/core/pdf/rasterize.js +57 -0
  249. package/dist-lib/lib/core/prompt-history.js +4 -2
  250. package/dist-lib/lib/core/range.d.ts +4 -4
  251. package/dist-lib/lib/core/range.js +12 -6
  252. package/dist-lib/lib/core/rank.d.ts +5 -4
  253. package/dist-lib/lib/core/rank.js +2 -1
  254. package/dist-lib/lib/core/send.d.ts +8 -5
  255. package/dist-lib/lib/core/send.js +9 -3
  256. package/dist-lib/lib/core/skill-overlay-receiver.js +7 -4
  257. package/dist-lib/lib/core/skill-secrets.js +16 -9
  258. package/dist-lib/lib/core/sync/chunks.js +2 -1
  259. package/dist-lib/lib/core/sync/devices.js +3 -1
  260. package/dist-lib/lib/core/sync/files.d.ts +2 -4
  261. package/dist-lib/lib/core/sync/files.js +28 -20
  262. package/dist-lib/lib/core/sync/index.d.ts +2 -5
  263. package/dist-lib/lib/core/sync/index.js +33 -17
  264. package/dist-lib/lib/core/sync-status.js +10 -7
  265. package/dist-lib/lib/core/system-info.js +4 -2
  266. package/dist-lib/lib/core/tool-activity.d.ts +4 -3
  267. package/dist-lib/lib/core/tool-activity.js +1 -1
  268. package/dist-lib/lib/core/tool-configs.js +12 -7
  269. package/dist-lib/lib/core.d.ts +107 -45
  270. package/dist-lib/lib/core.js +1765 -595
  271. package/dist-lib/lib/credential-pusher.d.ts +12 -17
  272. package/dist-lib/lib/credential-pusher.js +61 -42
  273. package/dist-lib/lib/custom-model-pusher.d.ts +7 -3
  274. package/dist-lib/lib/custom-model-pusher.js +15 -7
  275. package/dist-lib/lib/custom-model-task.d.ts +1 -0
  276. package/dist-lib/lib/custom-model-task.js +12 -0
  277. package/dist-lib/lib/deadline.js +4 -2
  278. package/dist-lib/lib/diagnostics.d.ts +1 -5
  279. package/dist-lib/lib/frame-readable.d.ts +3 -0
  280. package/dist-lib/lib/frame-readable.js +3 -0
  281. package/dist-lib/lib/fs-drive-bridge.js +24 -14
  282. package/dist-lib/lib/fs-grants.js +13 -8
  283. package/dist-lib/lib/guards.d.ts +3 -0
  284. package/dist-lib/lib/guards.js +9 -0
  285. package/dist-lib/lib/inference-calls.d.ts +28 -23
  286. package/dist-lib/lib/inference-calls.js +25 -13
  287. package/dist-lib/lib/integrations/mcp-providers.d.ts +2 -2
  288. package/dist-lib/lib/integrations/setup-routes.d.ts +2 -2
  289. package/dist-lib/lib/knowledge-search.d.ts +6 -5
  290. package/dist-lib/lib/knowledge-search.js +26 -18
  291. package/dist-lib/lib/kv-cache-reclaim.js +4 -2
  292. package/dist-lib/lib/kv-cache.js +8 -4
  293. package/dist-lib/lib/legacy-core-domain.d.ts +42 -42
  294. package/dist-lib/lib/log-buffer.js +2 -1
  295. package/dist-lib/lib/log.js +25 -15
  296. package/dist-lib/lib/mesh-scoped-engine.js +14 -4
  297. package/dist-lib/lib/model-catalog-revision.js +6 -3
  298. package/dist-lib/lib/model-clamp.js +6 -3
  299. package/dist-lib/lib/model-context.d.ts +8 -3
  300. package/dist-lib/lib/model-context.js +13 -5
  301. package/dist-lib/lib/model-download-status.js +4 -2
  302. package/dist-lib/lib/model-download.d.ts +12 -4
  303. package/dist-lib/lib/model-download.js +200 -103
  304. package/dist-lib/lib/model-idle-pusher.d.ts +10 -0
  305. package/dist-lib/lib/model-idle-pusher.js +41 -0
  306. package/dist-lib/lib/oauth/browser-connect.d.ts +10 -8
  307. package/dist-lib/lib/oauth/browser-connect.js +33 -20
  308. package/dist-lib/lib/oauth/client.d.ts +2 -2
  309. package/dist-lib/lib/oauth/flow-core.js +23 -9
  310. package/dist-lib/lib/oauth/flow.d.ts +1 -3
  311. package/dist-lib/lib/oauth/flow.js +9 -5
  312. package/dist-lib/lib/oauth/keys.d.ts +4 -4
  313. package/dist-lib/lib/oauth/keys.js +18 -12
  314. package/dist-lib/lib/oauth/loopback.d.ts +2 -2
  315. package/dist-lib/lib/oauth/loopback.js +147 -107
  316. package/dist-lib/lib/oauth/loopback.stub.d.ts +2 -2
  317. package/dist-lib/lib/oauth/loopback.stub.js +1 -1
  318. package/dist-lib/lib/oauth/pkce.d.ts +4 -2
  319. package/dist-lib/lib/oauth/pkce.js +10 -0
  320. package/dist-lib/lib/oauth/providers.js +5 -5
  321. package/dist-lib/lib/oauth/redirect-types.d.ts +12 -7
  322. package/dist-lib/lib/oauth/register.js +3 -2
  323. package/dist-lib/lib/oauth/registry.d.ts +2 -2
  324. package/dist-lib/lib/oauth/registry.js +2 -1
  325. package/dist-lib/lib/oauth/resolve.d.ts +30 -10
  326. package/dist-lib/lib/oauth/resolve.js +12 -6
  327. package/dist-lib/lib/oauth/token-exchange-core.d.ts +12 -4
  328. package/dist-lib/lib/oauth/token-exchange-core.js +1 -1
  329. package/dist-lib/lib/oauth/types.d.ts +12 -12
  330. package/dist-lib/lib/oauth.d.ts +4 -5
  331. package/dist-lib/lib/oauth.js +2 -3
  332. package/dist-lib/lib/reconnecting-watch.d.ts +1 -1
  333. package/dist-lib/lib/reconnecting-watch.js +6 -6
  334. package/dist-lib/lib/retry-budget.js +6 -3
  335. package/dist-lib/lib/run-notices.d.ts +2 -0
  336. package/dist-lib/lib/run-notices.js +7 -3
  337. package/dist-lib/lib/run-transcript.d.ts +2 -4
  338. package/dist-lib/lib/run-transcript.js +4 -2
  339. package/dist-lib/lib/skill-readiness.d.ts +1 -0
  340. package/dist-lib/lib/skill-readiness.js +17 -2
  341. package/dist-lib/lib/skill-types.d.ts +16 -16
  342. package/dist-lib/lib/suspend-lifecycle.d.ts +4 -4
  343. package/dist-lib/lib/suspend-lifecycle.js +10 -5
  344. package/dist-lib/lib/task.d.ts +5 -1
  345. package/dist-lib/lib/task.js +29 -12
  346. package/dist-lib/lib/unref.d.ts +3 -2
  347. package/dist-lib/lib/unref.js +2 -1
  348. package/dist-lib/lib/wav-duration.js +10 -5
  349. package/dist-lib/lib/write-queue.d.ts +5 -4
  350. package/dist-lib/lib/write-queue.js +2 -1
  351. package/dist-lib/schema/build.js +16 -8
  352. package/dist-lib/schema/config.d.ts +3 -4
  353. package/dist-lib/schema/config.js +1 -1
  354. package/dist-lib/schema/content.d.ts +18 -2
  355. package/dist-lib/schema/content.js +4 -1
  356. package/dist-lib/schema/engine.d.ts +3 -2
  357. package/dist-lib/schema/engine.js +192 -12
  358. package/dist-lib/schema/field-order.js +22 -11
  359. package/dist-lib/schema/indexes.d.ts +22 -0
  360. package/dist-lib/schema/{helpers.js → indexes.js} +19 -57
  361. package/dist-lib/schema/local.d.ts +3 -2
  362. package/dist-lib/schema/local.js +9 -3
  363. package/dist-lib/schema/media-kind.d.ts +8 -0
  364. package/dist-lib/schema/media-kind.js +52 -0
  365. package/dist-lib/schema/qvac.d.ts +12 -9
  366. package/dist-lib/schema/qvac.js +132 -7
  367. package/dist-lib/spec/bind.js +21 -0
  368. package/dist-lib/spec/calls.js +7 -0
  369. package/dist-lib/spec/capabilities.d.ts +18 -4
  370. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  371. package/dist-lib/spec/hrpc/hrpc.json +93 -2
  372. package/dist-lib/spec/hrpc/index.js +89 -5
  373. package/dist-lib/spec/hrpc/messages.js +1568 -941
  374. package/dist-lib/spec/hyperschema/index.js +1568 -941
  375. package/dist-lib/spec/hyperschema/schema.json +531 -1
  376. package/dist-lib/spec/hyperschema/types.d.ts +145 -1
  377. package/dist-lib/spec/local/hyperdb/index.js +1 -1
  378. package/dist-lib/spec/local/hyperdb/messages.js +92 -20
  379. package/dist-lib/spec/local/hyperschema/index.js +47 -11
  380. package/dist-lib/spec/local/hyperschema/schema.json +32 -1
  381. package/dist-lib/spec/local/hyperschema/types.d.ts +7 -1
  382. package/dist-lib/spec/mesh/hyperdb/db.json +131 -3
  383. package/dist-lib/spec/mesh/hyperdb/index.js +548 -5
  384. package/dist-lib/spec/mesh/hyperdb/messages.js +2444 -893
  385. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +37 -1
  386. package/dist-lib/spec/mesh/hyperdispatch/index.js +104 -2
  387. package/dist-lib/spec/mesh/hyperdispatch/messages.js +1035 -11
  388. package/dist-lib/spec/mesh/hyperschema/index.js +1035 -11
  389. package/dist-lib/spec/mesh/hyperschema/schema.json +553 -1
  390. package/dist-lib/spec/mesh/hyperschema/types.d.ts +143 -1
  391. package/package.json +11 -5
  392. package/tui/app.mjs +2624 -986
  393. package/tui/boot.mjs +17 -46
  394. package/tui/index.mjs +10 -5
  395. package/tui/lib/boot-timing.mjs +8 -8
  396. package/tui/lib/busy-words.mjs +21 -22
  397. package/tui/lib/export.mjs +100 -32
  398. package/tui/lib/knowledge-command.mjs +64 -19
  399. package/tui/lib/knowledge-import.mjs +52 -18
  400. package/tui/lib/render.mjs +65 -33
  401. package/tui/lib/save-file.mjs +30 -13
  402. package/tui/lib/select.mjs +23 -5
  403. package/tui/lib/selection.mjs +6 -4
  404. package/tui/lib/setup.mjs +11 -19
  405. package/tui/lib/sidebar.mjs +23 -13
  406. package/tui/lib/splash.mjs +6 -7
  407. package/tui/lib/upload-frames.mjs +1 -2
  408. package/tui/lib/usage.mjs +13 -9
  409. package/tui/lib/wrap.mjs +35 -6
  410. package/tui/main.mjs +54 -78
  411. package/worker/assistant-sidecar.mjs +5 -10
  412. package/worker/stow-entry.mjs +7 -4
  413. package/dist-lib/lib/custom-model-source.d.ts +0 -15
  414. package/dist-lib/lib/custom-model-source.js +0 -46
  415. package/dist-lib/lib/oauth/common.d.ts +0 -38
  416. package/dist-lib/lib/oauth/common.js +0 -34
  417. package/dist-lib/schema/helpers.d.ts +0 -32
@@ -1,14 +1,20 @@
1
1
  import b4a from 'b4a';
2
2
  import '../logger.js';
3
+ import { errorMessage, isRecord } from '../guards.js';
3
4
  const SCOPE = ['api'];
4
5
  const MAX_STRING = 40;
5
6
  export function instrument(handlers) {
6
- const out = {};
7
- for (const [name, handler] of Object.entries(handlers)) {
8
- out[name] = typeof handler === 'function' ? wrap(name, handler) : handler;
7
+ const out = { ...handlers };
8
+ for (const [name, handler] of Object.entries(out)) {
9
+ if (isHandler(handler)) {
10
+ Object.assign(out, { [name]: wrap(name, handler) });
11
+ }
9
12
  }
10
13
  return out;
11
14
  }
15
+ function isHandler(value) {
16
+ return typeof value === 'function';
17
+ }
12
18
  function wrap(name, handler) {
13
19
  return function (...args) {
14
20
  const started = Date.now();
@@ -18,7 +24,7 @@ function wrap(name, handler) {
18
24
  result = handler.apply(this, args);
19
25
  }
20
26
  catch (err) {
21
- logger.debug(SCOPE, `${name} failed`, { request, ms: Date.now() - started, err: reason(err) });
27
+ logFailure(name, { request, started, err });
22
28
  throw err;
23
29
  }
24
30
  if (isStream(result)) {
@@ -30,11 +36,7 @@ function wrap(name, handler) {
30
36
  logger.debug(SCOPE, name, { request, ms: Date.now() - started, ...count(value) });
31
37
  return value;
32
38
  }, (err) => {
33
- logger.debug(SCOPE, `${name} failed`, {
34
- request,
35
- ms: Date.now() - started,
36
- err: reason(err)
37
- });
39
+ logFailure(name, { request, started, err });
38
40
  throw err;
39
41
  });
40
42
  }
@@ -42,21 +44,28 @@ function wrap(name, handler) {
42
44
  return result;
43
45
  };
44
46
  }
47
+ function logFailure(name, { request, started, err }) {
48
+ logger.debug(SCOPE, `${name} failed`, {
49
+ request,
50
+ ms: Date.now() - started,
51
+ err: errorMessage(err)
52
+ });
53
+ }
45
54
  function isPromise(value) {
46
55
  return isRecord(value) && typeof value.then === 'function';
47
56
  }
48
57
  function isStream(value) {
49
- return isRecord(value) && typeof value[Symbol.asyncIterator] === 'function';
50
- }
51
- function isRecord(value) {
52
- return typeof value === 'object' && value !== null;
58
+ return (isRecord(value) &&
59
+ Symbol.asyncIterator in value &&
60
+ typeof value[Symbol.asyncIterator] === 'function');
53
61
  }
54
62
  function count(value) {
55
63
  if (!isRecord(value))
56
64
  return null;
57
65
  for (const field of Object.values(value)) {
58
- if (Array.isArray(field))
66
+ if (Array.isArray(field)) {
59
67
  return { n: field.length };
68
+ }
60
69
  }
61
70
  return null;
62
71
  }
@@ -68,19 +77,19 @@ function summarize(request) {
68
77
  .join(' ');
69
78
  }
70
79
  function scalar(value) {
71
- if (value === null || value === undefined)
80
+ if (value === null || value === undefined) {
72
81
  return String(value);
82
+ }
73
83
  if (b4a.isBuffer(value))
74
84
  return `<${value.byteLength}b>`;
75
- if (Array.isArray(value))
85
+ if (Array.isArray(value)) {
76
86
  return `[${value.length}]`;
87
+ }
77
88
  if (typeof value === 'string') {
78
89
  return value.length > MAX_STRING ? `<str:${value.length}>` : value;
79
90
  }
80
- if (typeof value === 'object')
91
+ if (typeof value === 'object') {
81
92
  return '{}';
93
+ }
82
94
  return String(value);
83
95
  }
84
- function reason(err) {
85
- return err instanceof Error ? err.message : String(err);
86
- }
@@ -1,8 +1,9 @@
1
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
2
  import { type MeshPool } from './current-mesh.ts';
3
3
  export { MAX_KNOWLEDGE_BYTES } from '../core/files/knowledge.ts';
4
- export declare function createKnowledgeApi(pool: MeshPool, options?: {
5
- maxBytes?: number;
6
- inactivityMs?: number;
7
- deviceId?: Buffer | null;
8
- }): Pick<CapabilityHandlers, 'uploadKnowledge' | 'downloadKnowledge' | 'removeKnowledge' | 'listKnowledge' | 'knowledgeWatch' | 'listIndexing' | 'indexingWatch' | 'fileStatusWatch' | 'indexingProgressWatch'>;
4
+ export interface CreateKnowledgeApiOptions {
5
+ readonly maxBytes?: number;
6
+ readonly inactivityMs?: number;
7
+ readonly deviceId?: Buffer | null;
8
+ }
9
+ export declare function createKnowledgeApi(pool: MeshPool, options?: CreateKnowledgeApiOptions): Pick<CapabilityHandlers, 'uploadKnowledge' | 'downloadKnowledge' | 'removeKnowledge' | 'listKnowledge' | 'knowledgeWatch' | 'listIndexing' | 'indexingWatch' | 'fileStatusWatch' | 'indexingProgressWatch'>;
@@ -6,10 +6,12 @@ export function createKnowledgeApi(pool, options = {}) {
6
6
  return {
7
7
  async *uploadKnowledge(frames) {
8
8
  const upload = await openUpload(frames);
9
- if (!upload)
9
+ if (!upload) {
10
10
  return;
11
- if (!upload.first.meshId)
11
+ }
12
+ if (!upload.first.meshId) {
12
13
  throw new Error(UPLOAD_NAMES_NO_MESH);
14
+ }
13
15
  const mesh = await requireMesh(pool, upload.first.meshId);
14
16
  yield* mesh.files.knowledge(options).uploadKnowledge(upload.rest);
15
17
  },
@@ -33,9 +35,9 @@ export function createKnowledgeApi(pool, options = {}) {
33
35
  .knowledge(options)
34
36
  .listIndexing(request);
35
37
  },
36
- knowledgeWatch: meshWatchable('knowledgeWatch', pool, async (request, mesh) => mesh.files.knowledge(options).listKnowledge(request)),
37
- indexingWatch: watchable('indexingWatch', async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => files.listIndexing(chatId)),
38
- fileStatusWatch: watchable('fileStatusWatch', async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => files.status(chatId)),
39
- indexingProgressWatch: watchable('indexingProgressWatch', async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => Promise.resolve({ entries: files.progress(chatId) }))
38
+ knowledgeWatch: meshWatchable(pool, async (request, mesh) => mesh.files.knowledge(options).listKnowledge(request), { name: 'knowledgeWatch' }),
39
+ indexingWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => files.listIndexing(chatId), { name: 'indexingWatch' }),
40
+ fileStatusWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => files.status(chatId), { name: 'fileStatusWatch' }),
41
+ indexingProgressWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).files, ({ chatId }, files) => Promise.resolve({ entries: files.progress(chatId) }), { name: 'indexingProgressWatch' })
40
42
  };
41
43
  }
@@ -2,7 +2,7 @@ import b4a from 'b4a';
2
2
  export function createLocalFilesApi(files) {
3
3
  return {
4
4
  listLocalFiles: async (request) => {
5
- const meshKey = request?.meshId ? Buffer.from(request.meshId, 'hex') : undefined;
5
+ const meshKey = request?.meshId ? b4a.from(request.meshId, 'hex') : undefined;
6
6
  return { files: (await files.live(meshKey)).map(toEngineFile) };
7
7
  }
8
8
  };
@@ -1,5 +1,7 @@
1
1
  import { Readable } from 'streamx';
2
+ import { frameReadable } from '../frame-readable.js';
2
3
  import { LEVELS } from '../log-levels.js';
4
+ import { asError } from '../guards.js';
3
5
  const MAX_LIVE_QUEUE = 1000;
4
6
  export function createLogsApi(source) {
5
7
  return {
@@ -26,7 +28,8 @@ function logStream(source, request) {
26
28
  if (!matches(record))
27
29
  return;
28
30
  if (queue.length >= MAX_LIVE_QUEUE) {
29
- droppedSeq = queue.shift().seq;
31
+ droppedSeq = queue[0].seq;
32
+ queue.shift();
30
33
  dropped++;
31
34
  }
32
35
  queue.push(toLine(record));
@@ -67,7 +70,7 @@ function logStream(source, request) {
67
70
  cb(null);
68
71
  }
69
72
  catch (err) {
70
- cb(err);
73
+ cb(asError(err));
71
74
  }
72
75
  },
73
76
  predestroy() {
@@ -79,7 +82,7 @@ function logStream(source, request) {
79
82
  cb(null);
80
83
  }
81
84
  });
82
- return stream;
85
+ return frameReadable(stream);
83
86
  }
84
87
  function makeFilter(request) {
85
88
  const minLevel = request.level ? LEVELS[request.level] : 0;
@@ -1,7 +1,6 @@
1
1
  import { meshWatchable, requireMesh } from './current-mesh.js';
2
2
  import b4a from 'b4a';
3
- const MEMBERS = '@qvac/members';
4
- const DEVICES = '@qvac/devices';
3
+ import { DEVICES, MEMBERS } from '../core/collections.js';
5
4
  const RESOLVE_MEMBER_MS = 10_000;
6
5
  async function resolveOurMember(mesh) {
7
6
  let timer = null;
@@ -14,8 +13,9 @@ async function resolveOurMember(mesh) {
14
13
  ]);
15
14
  }
16
15
  finally {
17
- if (timer)
16
+ if (timer) {
18
17
  clearTimeout(timer);
18
+ }
19
19
  }
20
20
  }
21
21
  function toEngineMember(member, removed) {
@@ -25,16 +25,18 @@ async function liveMemberIds(snap) {
25
25
  const live = new Set();
26
26
  for await (const device of snap.find(DEVICES)) {
27
27
  const owner = device.revoked ? null : (device.memberId ?? device.claimedMemberId);
28
- if (owner)
28
+ if (owner) {
29
29
  live.add(b4a.toHex(owner));
30
+ }
30
31
  }
31
32
  return live;
32
33
  }
33
34
  export function createMembersApi(pool, self, state = null) {
34
35
  const mustGetMember = async (reader, id) => {
35
36
  const member = await reader.get(MEMBERS, { id });
36
- if (!member)
37
+ if (!member) {
37
38
  throw new Error(`member not found: ${b4a.toHex(id)}`);
39
+ }
38
40
  return member;
39
41
  };
40
42
  const list = async (mesh) => {
@@ -62,20 +64,24 @@ export function createMembersApi(pool, self, state = null) {
62
64
  };
63
65
  return {
64
66
  listMembers: async (request) => list(await requireMesh(pool, request.meshId)),
65
- membersWatch: meshWatchable('membersWatch', pool, (_request, mesh) => list(mesh)),
67
+ membersWatch: meshWatchable(pool, (_request, mesh) => list(mesh), { name: 'membersWatch' }),
66
68
  updateMember: async ({ config }) => {
67
69
  const trimmed = config.name.trim();
68
- if (!trimmed)
70
+ if (!trimmed) {
69
71
  throw new Error('member name must not be empty');
72
+ }
70
73
  const { meshId } = await self.account();
71
- if (!meshId)
74
+ if (!meshId) {
72
75
  throw new Error('no account to rename the member in');
76
+ }
73
77
  const mesh = await requireMesh(pool, meshId);
74
- if (!mesh.ourMemberId)
78
+ if (!mesh.ourMemberId) {
75
79
  await resolveOurMember(mesh);
80
+ }
76
81
  const id = mesh.ourMemberId;
77
- if (!id)
82
+ if (!id) {
78
83
  throw new Error('this device is in no member of its account');
84
+ }
79
85
  const member = await mustGetMember(mesh.view, id);
80
86
  const namedAt = Math.max(Date.now(), member.updatedAt + 1);
81
87
  await state?.saveDisplayName(trimmed, namedAt);
@@ -86,12 +92,15 @@ export function createMembersApi(pool, self, state = null) {
86
92
  },
87
93
  removeMember: async ({ memberId: id, meshId }) => {
88
94
  const mesh = await requireMesh(pool, meshId);
89
- if (!mesh.ourMemberId)
95
+ if (!mesh.ourMemberId) {
90
96
  await resolveOurMember(mesh);
91
- if (!mesh.ourMemberId)
97
+ }
98
+ if (!mesh.ourMemberId) {
92
99
  throw new Error('this device is in no member of this mesh');
93
- if (mesh.ourMemberId.equals(id))
100
+ }
101
+ if (b4a.equals(mesh.ourMemberId, id)) {
94
102
  throw new Error('cannot remove own member, use leaveMesh');
103
+ }
95
104
  await mesh.dispatch('remove-member', { memberId: id, revokedAt: Date.now() });
96
105
  return { ok: true };
97
106
  }
@@ -1,5 +1,6 @@
1
1
  import type { AssistantAccount, AssistantArchivedMeshContents, AssistantArchivedMeshList, AssistantArchivedMeshMigration, AssistantMeshList, AssistantMeshStatus } from '../../spec/hyperschema/types.d.ts';
2
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
+ export declare const CREATE_ROOM_RETIRED = "createRoom is retired: call createMesh with the same input";
3
4
  export interface MeshInviteResult {
4
5
  readonly invite?: string;
5
6
  readonly meshId?: string;
@@ -14,12 +15,16 @@ export interface MeshStatusSource {
14
15
  join(invite: string): Promise<void>;
15
16
  cancelJoin(): void;
16
17
  invite(member?: boolean, meshId?: string): Promise<MeshInviteResult>;
18
+ preview(invite: string): {
19
+ memberInvite: boolean;
20
+ inviterName?: string;
21
+ };
17
22
  list(): Promise<AssistantMeshList>;
18
23
  account(): Promise<AssistantAccount>;
19
24
  open(meshId: string): Promise<void>;
20
25
  close(meshId: string): Promise<void>;
21
26
  label(meshId: string, label: string): Promise<void>;
22
- createRoom(opts?: {
27
+ createMesh(opts?: {
23
28
  compute?: boolean;
24
29
  }): Promise<string>;
25
30
  listArchived(): Promise<AssistantArchivedMeshList>;
@@ -30,4 +35,4 @@ export interface MeshStatusSource {
30
35
  recover(phrase: string, timeout?: number): Promise<void>;
31
36
  displayName(): Promise<string | null>;
32
37
  }
33
- export declare function createMeshApi(status: MeshStatusSource, updateMember: CapabilityHandlers['updateMember']): Pick<CapabilityHandlers, 'meshStatusWatch' | 'listMeshes' | 'meshesWatch' | 'account' | 'accountWatch' | 'openMesh' | 'closeMesh' | 'leaveMesh' | 'acknowledgeKicked' | 'joinMesh' | 'cancelMeshJoin' | 'meshInvite' | 'setMeshLabel' | 'createRoom' | 'listArchivedMeshes' | 'archivedMeshContents' | 'migrateArchivedMesh' | 'accountRecoverable' | 'recoveryPublish' | 'recoverAccount' | 'displayName' | 'setDisplayName'>;
38
+ export declare function createMeshApi(status: MeshStatusSource, updateMember: CapabilityHandlers['updateMember']): Pick<CapabilityHandlers, 'meshStatusWatch' | 'listMeshes' | 'meshesWatch' | 'account' | 'accountWatch' | 'openMesh' | 'closeMesh' | 'leaveMesh' | 'acknowledgeKicked' | 'joinMesh' | 'cancelMeshJoin' | 'meshInvite' | 'previewMeshInvite' | 'setMeshLabel' | 'createMesh' | 'createRoom' | 'listArchivedMeshes' | 'archivedMeshContents' | 'migrateArchivedMesh' | 'accountRecoverable' | 'recoveryPublish' | 'recoverAccount' | 'displayName' | 'setDisplayName'>;
@@ -1,11 +1,12 @@
1
1
  import { watchable } from './watchable.js';
2
+ export const CREATE_ROOM_RETIRED = 'createRoom is retired: call createMesh with the same input';
2
3
  export function createMeshApi(status, updateMember) {
3
4
  return {
4
- meshStatusWatch: watchable('meshStatusWatch', () => status, async () => status.snapshot()),
5
+ meshStatusWatch: watchable(() => status, async () => status.snapshot(), { name: 'meshStatusWatch' }),
5
6
  listMeshes: () => status.list(),
6
- meshesWatch: watchable('meshesWatch', () => status, () => status.list()),
7
+ meshesWatch: watchable(() => status, () => status.list(), { name: 'meshesWatch' }),
7
8
  account: () => status.account(),
8
- accountWatch: watchable('accountWatch', () => status, () => status.account()),
9
+ accountWatch: watchable(() => status, () => status.account(), { name: 'accountWatch' }),
9
10
  openMesh: async ({ meshId }) => {
10
11
  await status.open(meshId);
11
12
  return { ok: true };
@@ -30,14 +31,18 @@ export function createMeshApi(status, updateMember) {
30
31
  status.cancelJoin();
31
32
  return { ok: true };
32
33
  },
34
+ previewMeshInvite: ({ invite }) => status.preview(invite),
33
35
  meshInvite: async ({ member, meshId }) => status.invite(member ?? false, meshId ?? undefined),
34
36
  setMeshLabel: async ({ meshId, label }) => {
35
37
  await status.label(meshId, label ?? '');
36
38
  return { ok: true };
37
39
  },
38
- createRoom: async (request) => ({
39
- meshId: await status.createRoom({ compute: request?.config?.compute })
40
+ createMesh: async (request) => ({
41
+ meshId: await status.createMesh({ compute: request?.config?.compute })
40
42
  }),
43
+ createRoom: async () => {
44
+ throw new Error(CREATE_ROOM_RETIRED);
45
+ },
41
46
  listArchivedMeshes: () => status.listArchived(),
42
47
  archivedMeshContents: ({ meshId }) => status.archivedContents(meshId),
43
48
  migrateArchivedMesh: ({ meshId }) => status.migrateArchived(meshId),
@@ -24,7 +24,7 @@ export function createModelDownloadApi(state) {
24
24
  await state.completeModelTransfer(request);
25
25
  return { ok: true };
26
26
  },
27
- modelDownloadsWatch: watchable('modelDownloadsWatch', () => state, () => readDownloads(state)),
27
+ modelDownloadsWatch: watchable(() => state, () => readDownloads(state), { name: 'modelDownloadsWatch' }),
28
28
  setModelDownloadStatus: async (input) => {
29
29
  const row = {
30
30
  name: input.name,
@@ -4,5 +4,6 @@ export interface NetworkSource {
4
4
  watch(listener: () => void): void;
5
5
  unwatch(listener: () => void): void;
6
6
  snapshot(): AssistantNetworkStatus;
7
+ readonly sampled: true;
7
8
  }
8
9
  export declare function createNetworkApi(source: NetworkSource): Pick<CapabilityHandlers, 'networkWatch'>;
@@ -1,6 +1,6 @@
1
1
  import { watchable } from './watchable.js';
2
2
  export function createNetworkApi(source) {
3
3
  return {
4
- networkWatch: watchable('networkWatch', () => source, async () => source.snapshot())
4
+ networkWatch: watchable(() => source, async () => source.snapshot(), { name: 'networkWatch' })
5
5
  };
6
6
  }
@@ -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>;