@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,8 +1,10 @@
1
- import { mediaKindOrdinal } from '../../../../schema/helpers.js';
1
+ import { mediaKindOrdinal } from '../../../../schema/media-kind.js';
2
+ import { ATTACHMENTS_BY_MEDIA_KIND, CHATS, CHUNKS, CHUNKS_BY_CHAT, KNOWLEDGE } from '../../collections.js';
2
3
  export function attachmentRecord(chunk) {
3
4
  const file = chunk.attachment;
4
- if (chunk.type !== 'attachment' || !file)
5
+ if (chunk.type !== 'attachment' || !file) {
5
6
  return null;
7
+ }
6
8
  return {
7
9
  ...file,
8
10
  chatId: chunk.chatId,
@@ -17,48 +19,52 @@ export function attachmentRecord(chunk) {
17
19
  }
18
20
  export async function fileRecord(view, id, input) {
19
21
  if (input === 'knowledge') {
20
- const row = await view.get('@qvac/knowledge', { id });
22
+ const row = await view.get(KNOWLEDGE, { id });
21
23
  return row && { ...row, kind: input };
22
24
  }
23
- const chunk = await view.get('@qvac/chunks', { id });
25
+ const chunk = await view.get(CHUNKS, { id });
24
26
  return chunk && attachmentRecord(chunk);
25
27
  }
26
28
  export async function fileIds(view, input, mediaKind) {
27
29
  if (input === 'knowledge') {
28
- return (await view.find('@qvac/knowledge').toArray()).map((row) => row.id);
30
+ return (await view.find(KNOWLEDGE).toArray()).map((row) => row.id);
29
31
  }
30
32
  const ids = [];
31
33
  const chunks = mediaKind
32
- ? view.find('@qvac/attachments-by-media-kind', {
34
+ ? view.find(ATTACHMENTS_BY_MEDIA_KIND, {
33
35
  gte: { mediaKind: mediaKindOrdinal(mediaKind) },
34
36
  lte: { mediaKind: mediaKindOrdinal(mediaKind) }
35
37
  })
36
- : view.find('@qvac/chunks');
38
+ : view.find(CHUNKS);
37
39
  for await (const chunk of chunks) {
38
- if (chunk.type === 'attachment' && chunk.id === chunk.attachment?.id)
40
+ if (chunk.type === 'attachment' && chunk.id === chunk.attachment?.id) {
39
41
  ids.push(chunk.id);
42
+ }
40
43
  }
41
44
  return ids;
42
45
  }
43
46
  export async function claimSource(view, id) {
44
47
  const knowledge = await fileRecord(view, id, 'knowledge');
45
- if (knowledge)
48
+ if (knowledge) {
46
49
  return knowledge.deletedAt ? null : knowledge;
50
+ }
47
51
  const file = await fileRecord(view, id, 'attachment');
48
52
  return file?.id === id && file.preview && !file.deletedAt ? file : null;
49
53
  }
50
54
  export async function scopedFile(view, { chatId, fileId }) {
51
- const chat = await view.get('@qvac/chats', { id: chatId });
52
- if (chat?.deletedAt)
55
+ const chat = await view.get(CHATS, { id: chatId });
56
+ if (chat?.deletedAt) {
53
57
  return null;
54
- const direct = await view.get('@qvac/chunks', { id: fileId });
58
+ }
59
+ const direct = await view.get(CHUNKS, { id: fileId });
55
60
  if (direct?.chatId === chatId && direct.attachment?.id === fileId) {
56
61
  return direct.attachment.deletedAt ? null : attachmentRecord(direct);
57
62
  }
58
63
  const row = await fileRecord(view, fileId, 'knowledge');
59
- if (row)
64
+ if (row) {
60
65
  return row.chatId === chatId && !row.deletedAt ? row : null;
61
- for await (const chunk of view.find('@qvac/chunks-by-chat', {
66
+ }
67
+ for await (const chunk of view.find(CHUNKS_BY_CHAT, {
62
68
  gte: { chatId },
63
69
  lte: { chatId }
64
70
  })) {
@@ -1,6 +1,4 @@
1
- const CHUNKS = '@qvac/chunks';
2
- const KNOWLEDGE = '@qvac/knowledge';
3
- const KNOWLEDGE_ARTIFACTS = '@qvac/knowledge-artifacts';
1
+ import { CHUNKS, KNOWLEDGE, KNOWLEDGE_ARTIFACTS } from '../../collections.js';
4
2
  export async function referencedBlobs(mesh) {
5
3
  const references = [];
6
4
  const snapshot = mesh.view.snapshot();
@@ -1,6 +1,7 @@
1
1
  import type { BlobId } from 'hyperblobs';
2
2
  import type Hyperblobs from 'hyperblobs';
3
3
  import type { AbortSignal } from 'bare-abort-controller';
4
+ import { type NextFrameOptions } from '../../next-frame.ts';
4
5
  export interface BlobHost {
5
6
  readonly blobs: Hyperblobs;
6
7
  openBlobs(key: Buffer): Promise<Hyperblobs>;
@@ -12,18 +13,17 @@ export type WriteProgress = {
12
13
  blobId: BlobId;
13
14
  byteLength: number;
14
15
  };
15
- export declare function writeBlob(blobs: Hyperblobs, chunks: AsyncIterable<Uint8Array>, options?: {
16
- signal?: AbortSignal;
17
- inactivityMs?: number;
18
- }): AsyncGenerator<WriteProgress>;
16
+ export declare function writeBlob(blobs: Hyperblobs, chunks: AsyncIterable<Uint8Array>, options?: NextFrameOptions): AsyncGenerator<WriteProgress>;
19
17
  export declare function stringifyBlobId(blobs: Hyperblobs, id: BlobId): string;
20
- export declare function readBlob(blobs: Hyperblobs, blobId: BlobId, options?: {
18
+ export interface ReadBlobOptions {
21
19
  readonly wait?: boolean;
22
20
  readonly timeout?: number;
23
21
  readonly signal?: AbortSignal;
24
- }): AsyncGenerator<{
25
- data: Buffer;
26
- bytesRead: number;
27
- byteLength: number;
28
- }>;
22
+ }
23
+ export interface BlobReadChunk {
24
+ readonly data: Buffer;
25
+ readonly bytesRead: number;
26
+ readonly byteLength: number;
27
+ }
28
+ export declare function readBlob(blobs: Hyperblobs, blobId: BlobId, options?: ReadBlobOptions): AsyncGenerator<BlobReadChunk>;
29
29
  export declare function clearBlob(mesh: BlobHost, blobId: string, id: string): Promise<boolean>;
@@ -18,21 +18,12 @@ export async function* writeBlob(blobs, chunks, options = {}) {
18
18
  const chunk = next.value;
19
19
  bytesWritten += chunk.length;
20
20
  if (!ws.write(chunk)) {
21
- let onDrain;
22
- const drained = new Promise((resolve) => {
23
- onDrain = () => resolve();
24
- ws.once('drain', onDrain);
25
- });
26
- try {
27
- await Promise.race([drained, done]);
28
- }
29
- finally {
30
- ws.off('drain', onDrain);
31
- }
21
+ await drained(ws, done);
32
22
  }
33
23
  next = await nextFrame(it, options);
34
- if (next.done)
24
+ if (next.done) {
35
25
  break;
26
+ }
36
27
  yield { bytesWritten };
37
28
  }
38
29
  ws.end();
@@ -45,19 +36,32 @@ export async function* writeBlob(blobs, chunks, options = {}) {
45
36
  void it.return?.().catch(noop);
46
37
  ws.end();
47
38
  const settled = await done.then(() => true, () => false);
48
- if (settled && ws.id.blockLength > 0)
39
+ if (settled && ws.id.blockLength > 0) {
49
40
  await blobs.clear(ws.id).catch(noop);
41
+ }
50
42
  }
51
43
  }
52
44
  }
45
+ async function drained(ws, done) {
46
+ const drain = Promise.withResolvers();
47
+ const onDrain = () => drain.resolve();
48
+ ws.once('drain', onDrain);
49
+ try {
50
+ await Promise.race([drain.promise, done]);
51
+ }
52
+ finally {
53
+ ws.off('drain', onDrain);
54
+ }
55
+ }
53
56
  const noop = () => { };
54
57
  export function stringifyBlobId(blobs, id) {
55
58
  return JSON.stringify({ ...id, coreKey: b4a.toHex(blobs.core.key) });
56
59
  }
57
60
  export async function* readBlob(blobs, blobId, options = {}) {
58
61
  const { signal, ...readOptions } = options;
59
- if (signal?.aborted)
62
+ if (signal?.aborted) {
60
63
  throw new AbortedError();
64
+ }
61
65
  const rs = blobs.createReadStream(blobId, readOptions);
62
66
  const abort = () => rs.destroy(new AbortedError());
63
67
  signal?.addEventListener('abort', abort, { once: true });
@@ -75,9 +79,11 @@ export async function* readBlob(blobs, blobId, options = {}) {
75
79
  }
76
80
  export async function clearBlob(mesh, blobId, id) {
77
81
  try {
78
- if (parseBlobReference(blobId).inline)
82
+ const reference = parseBlobReference(blobId);
83
+ if (reference.inline) {
79
84
  return true;
80
- await clearBlobRef(mesh, blobId);
85
+ }
86
+ await clearBlobRef(mesh, reference);
81
87
  return true;
82
88
  }
83
89
  catch (err) {
@@ -85,13 +91,13 @@ export async function clearBlob(mesh, blobId, id) {
85
91
  return false;
86
92
  }
87
93
  }
88
- async function clearBlobRef(mesh, blobId) {
89
- const { coreKey, ...id } = JSON.parse(blobId);
94
+ async function clearBlobRef(mesh, reference) {
95
+ const { coreKey, blobId: id } = reference;
90
96
  if (!coreKey || coreKey === b4a.toHex(mesh.blobs.core.key)) {
91
97
  await mesh.blobs.clear(id);
92
98
  return;
93
99
  }
94
- const remote = await mesh.openBlobs(Buffer.from(coreKey, 'hex'));
100
+ const remote = await mesh.openBlobs(b4a.from(coreKey, 'hex'));
95
101
  try {
96
102
  await remote.clear(id);
97
103
  }
@@ -1,4 +1,3 @@
1
- import { Buffer } from 'buffer';
2
1
  import EventEmitter from 'bare-events';
3
2
  import type Hyperblobs from 'hyperblobs';
4
3
  import { stringifyBlobId, writeBlob, type BlobHost } from './blob.ts';
@@ -23,11 +22,7 @@ export declare class BlobStore extends EventEmitter {
23
22
  }>;
24
23
  reference(id: Parameters<typeof stringifyBlobId>[1]): string;
25
24
  inline(bytes: Buffer, mimeType: string): string;
26
- read(reference: string, options?: Parameters<typeof readBlobReference>[2]): AsyncGenerator<{
27
- data: Buffer;
28
- bytesRead: number;
29
- byteLength: number;
30
- }, any, any>;
25
+ read(reference: string, options?: Parameters<typeof readBlobReference>[2]): AsyncGenerator<import("./blob.ts").BlobReadChunk, any, any>;
31
26
  readBytes(reference: string, options?: Parameters<typeof readBlobReferenceBytes>[2]): Promise<Buffer<ArrayBufferLike>>;
32
27
  download(reference: string, options: Parameters<typeof downloadBlobReference>[2]): Promise<void>;
33
28
  clear(reference: string, id: string): Promise<boolean>;
@@ -1,5 +1,4 @@
1
1
  import b4a from 'b4a';
2
- import { Buffer } from 'buffer';
3
2
  import EventEmitter from 'bare-events';
4
3
  import { sweepUnreferenced } from './sweep.js';
5
4
  import { inlineReference } from './inline.js';
@@ -50,13 +49,14 @@ export class BlobStore extends EventEmitter {
50
49
  return false;
51
50
  try {
52
51
  const { blobId, coreKey, inline } = parseBlobReference(reference);
53
- if (inline)
52
+ if (inline) {
54
53
  return true;
54
+ }
55
55
  let blobs = this.blobs;
56
- if (coreKey && coreKey !== b4a.toString(blobs.core.key, 'hex')) {
56
+ if (coreKey && coreKey !== b4a.toHex(blobs.core.key)) {
57
57
  let reader = this._readers.get(coreKey);
58
58
  if (!reader) {
59
- reader = this.openBlobs(Buffer.from(coreKey, 'hex')).then((remote) => {
59
+ reader = this.openBlobs(b4a.from(coreKey, 'hex')).then((remote) => {
60
60
  remote.core.on('download', this._updated);
61
61
  return remote;
62
62
  });
@@ -1,8 +1,8 @@
1
1
  export declare const MAX_INLINE_BYTES: number;
2
2
  export declare const MAX_REFERENCE_CHARS: number;
3
- export type InlinePayload = {
3
+ export interface InlinePayload {
4
4
  mimeType: string;
5
5
  data: string;
6
- };
6
+ }
7
7
  export declare function inlineReference(bytes: Buffer, mimeType: string): string;
8
8
  export declare function readInline(record: Record<string, unknown>): InlinePayload | undefined;
@@ -2,8 +2,9 @@ import b4a from 'b4a';
2
2
  export const MAX_INLINE_BYTES = 512 * 1024;
3
3
  export const MAX_REFERENCE_CHARS = 4 * Math.ceil(MAX_INLINE_BYTES / 3) + 1024;
4
4
  export function inlineReference(bytes, mimeType) {
5
- if (bytes.length > MAX_INLINE_BYTES)
5
+ if (bytes.length > MAX_INLINE_BYTES) {
6
6
  throw new Error('inline output exceeds 512 KiB');
7
+ }
7
8
  return JSON.stringify({
8
9
  blockOffset: 0,
9
10
  blockLength: 0,
@@ -30,9 +31,11 @@ export function readInline(record) {
30
31
  }
31
32
  const { data, mimeType } = inline;
32
33
  const bytes = b4a.from(data, 'base64');
33
- if (bytes.length > MAX_INLINE_BYTES)
34
+ if (bytes.length > MAX_INLINE_BYTES) {
34
35
  throw new Error('inline output exceeds 512 KiB');
35
- if (b4a.toString(bytes, 'base64') !== data)
36
+ }
37
+ if (b4a.toString(bytes, 'base64') !== data) {
36
38
  throw new TypeError('invalid inline output');
39
+ }
37
40
  return { mimeType, data };
38
41
  }
@@ -1,5 +1,5 @@
1
1
  import type { BlobId } from 'hyperblobs';
2
- import { type BlobHost } from './blob.ts';
2
+ import { type BlobHost, type BlobReadChunk } from './blob.ts';
3
3
  import type { AbortSignal } from 'bare-abort-controller';
4
4
  import { type InlinePayload } from './inline.ts';
5
5
  export interface ParsedBlobReference {
@@ -16,12 +16,9 @@ export declare function isInvalidBlobReferenceError(error: unknown): error is Ty
16
16
  export declare function parseBlobReferenceCoreKey(blobReference: string): string | undefined;
17
17
  export declare function parseBlobReference(blobReference: string): ParsedBlobReference;
18
18
  export declare function compareBlobReferences(left: string, right: string, localCoreKey?: string): boolean | null;
19
- export declare function readBlobReference(mesh: BlobHost, blobReference: string, options?: BlobReferenceReadOptions): AsyncGenerator<{
20
- data: Buffer;
21
- bytesRead: number;
22
- byteLength: number;
23
- }>;
24
- export declare function downloadBlobReference(mesh: BlobHost, reference: string, { signal }: {
25
- signal: AbortSignal;
26
- }): Promise<void>;
19
+ export declare function readBlobReference(mesh: BlobHost, blobReference: string, options?: BlobReferenceReadOptions): AsyncGenerator<BlobReadChunk>;
20
+ export interface DownloadBlobReferenceOptions {
21
+ readonly signal: AbortSignal;
22
+ }
23
+ export declare function downloadBlobReference(mesh: BlobHost, reference: string, { signal }: DownloadBlobReferenceOptions): Promise<void>;
27
24
  export declare function readBlobReferenceBytes(mesh: BlobHost, blobReference: string, options?: BlobReferenceReadOptions): Promise<Buffer>;
@@ -2,6 +2,7 @@ import { readBlob } from './blob.js';
2
2
  import { AbortedError, raceAbort } from '@qvac/harness/race-abort';
3
3
  import { MAX_REFERENCE_CHARS, readInline } from './inline.js';
4
4
  import b4a from 'b4a';
5
+ import { isRecord } from '../../../guards.js';
5
6
  const CORE_KEY_PATTERN = /^[0-9a-f]{64}$/;
6
7
  const DEFAULT_REMOTE_TIMEOUT_MS = 15_000;
7
8
  const INVALID_BLOB_REFERENCE = 'invalid blob reference';
@@ -15,12 +16,10 @@ export function isInvalidBlobReferenceError(error) {
15
16
  function blobUnavailable(cause) {
16
17
  return new Error(BLOB_UNAVAILABLE, { cause });
17
18
  }
18
- function isRecord(value) {
19
- return value !== null && typeof value === 'object' && !Array.isArray(value);
20
- }
21
19
  function parseBlobReferenceRecord(blobReference) {
22
- if (blobReference.length > MAX_REFERENCE_CHARS)
20
+ if (blobReference.length > MAX_REFERENCE_CHARS) {
23
21
  throw invalidBlobReference();
22
+ }
24
23
  let value;
25
24
  try {
26
25
  value = JSON.parse(blobReference);
@@ -28,8 +27,9 @@ function parseBlobReferenceRecord(blobReference) {
28
27
  catch {
29
28
  throw invalidBlobReference();
30
29
  }
31
- if (!isRecord(value))
30
+ if (!isRecord(value)) {
32
31
  throw invalidBlobReference();
32
+ }
33
33
  return value;
34
34
  }
35
35
  function readCoreKey(record) {
@@ -51,8 +51,9 @@ export function parseBlobReferenceCoreKey(blobReference) {
51
51
  }
52
52
  export function parseBlobReference(blobReference) {
53
53
  const value = parseBlobReferenceRecord(blobReference);
54
- if (value.blockMap)
54
+ if (value.blockMap) {
55
55
  throw invalidBlobReference();
56
+ }
56
57
  let inline;
57
58
  try {
58
59
  inline = readInline(value);
@@ -85,8 +86,9 @@ export function compareBlobReferences(left, right, localCoreKey) {
85
86
  a.blobId.byteLength === b.blobId.byteLength);
86
87
  }
87
88
  catch (error) {
88
- if (isInvalidBlobReferenceError(error))
89
+ if (isInvalidBlobReferenceError(error)) {
89
90
  return null;
91
+ }
90
92
  throw error;
91
93
  }
92
94
  }
@@ -107,10 +109,11 @@ async function closeRemote(remote) {
107
109
  }
108
110
  export async function* readBlobReference(mesh, blobReference, options = {}) {
109
111
  const { blobId, coreKey, inline } = parseBlobReference(blobReference);
110
- if (options.signal?.aborted)
112
+ if (options.signal?.aborted) {
111
113
  throw new AbortedError();
114
+ }
112
115
  if (inline) {
113
- const data = Buffer.from(inline.data, 'base64');
116
+ const data = b4a.from(inline.data, 'base64');
114
117
  yield { data, bytesRead: data.length, byteLength: data.length };
115
118
  return;
116
119
  }
@@ -118,14 +121,16 @@ export async function* readBlobReference(mesh, blobReference, options = {}) {
118
121
  const readOptions = options.wait === false ? { wait: false } : { timeout: remoteTimeout(options) };
119
122
  let remote = null;
120
123
  try {
121
- if (!local)
122
- remote = await mesh.openBlobs(Buffer.from(coreKey, 'hex'));
124
+ if (!local) {
125
+ remote = await mesh.openBlobs(b4a.from(coreKey, 'hex'));
126
+ }
123
127
  const blobs = remote ?? mesh.blobs;
124
128
  yield* readBlob(blobs, blobId, { ...readOptions, signal: options.signal });
125
129
  }
126
130
  catch (err) {
127
- if (options.signal?.aborted || err instanceof AbortedError)
131
+ if (options.signal?.aborted || err instanceof AbortedError) {
128
132
  throw new AbortedError();
133
+ }
129
134
  throw blobUnavailable(err);
130
135
  }
131
136
  finally {
@@ -134,17 +139,20 @@ export async function* readBlobReference(mesh, blobReference, options = {}) {
134
139
  }
135
140
  export async function downloadBlobReference(mesh, reference, { signal }) {
136
141
  const { blobId, coreKey, inline } = parseBlobReference(reference);
137
- if (signal.aborted)
142
+ if (signal.aborted) {
138
143
  throw new AbortedError();
139
- if (inline || !blobId.blockLength)
144
+ }
145
+ if (inline || !blobId.blockLength) {
140
146
  return;
147
+ }
141
148
  let remote = null;
142
149
  try {
143
150
  if (coreKey && coreKey !== b4a.toHex(mesh.blobs.core.key)) {
144
- remote = await mesh.openBlobs(Buffer.from(coreKey, 'hex'));
151
+ remote = await mesh.openBlobs(b4a.from(coreKey, 'hex'));
145
152
  }
146
- if (signal.aborted)
153
+ if (signal.aborted) {
147
154
  throw new AbortedError();
155
+ }
148
156
  const range = (remote ?? mesh.blobs).core.download({
149
157
  start: blobId.blockOffset,
150
158
  end: blobId.blockOffset + blobId.blockLength
@@ -165,5 +173,5 @@ export async function readBlobReferenceBytes(mesh, blobReference, options = {})
165
173
  for await (const frame of readBlobReference(mesh, blobReference, options)) {
166
174
  chunks.push(frame.data);
167
175
  }
168
- return Buffer.concat(chunks);
176
+ return b4a.concat(chunks);
169
177
  }
@@ -2,13 +2,17 @@ import type Corestore from 'corestore';
2
2
  import ReadyResource from 'ready-resource';
3
3
  import type { LinkableAttachment } from '../../attachment-link.ts';
4
4
  import type Hyperblobs from 'hyperblobs';
5
- export type MeshBlobKeys = {
5
+ export interface MeshBlobKeys {
6
6
  key: Buffer;
7
7
  blobs: Hyperblobs;
8
8
  encryptionKey: Buffer;
9
- };
9
+ }
10
10
  export type MeshForBlobCore = (coreKey: string, blockOffset: number | undefined, meshKey: Buffer | undefined) => MeshBlobKeys | null | Promise<MeshBlobKeys | null>;
11
11
  export type BlobRead = (mesh: MeshBlobKeys, coreKey: Buffer, blockOffset: number) => void;
12
+ export interface CoreBlobServerOptions {
13
+ readonly readTimeoutMs?: number;
14
+ readonly onRead?: BlobRead | null;
15
+ }
12
16
  export declare class CoreBlobServer extends ReadyResource {
13
17
  private readonly _store;
14
18
  private readonly _mesh;
@@ -17,10 +21,7 @@ export declare class CoreBlobServer extends ReadyResource {
17
21
  private readonly _readTimeoutMs;
18
22
  private readonly _onRead;
19
23
  private _suspended;
20
- constructor(store: Corestore, mesh: MeshForBlobCore, { readTimeoutMs, onRead }?: {
21
- readTimeoutMs?: number;
22
- onRead?: BlobRead | null;
23
- });
24
+ constructor(store: Corestore, mesh: MeshForBlobCore, { readTimeoutMs, onRead }?: CoreBlobServerOptions);
24
25
  get port(): number;
25
26
  link({ blobId, mimeType }: LinkableAttachment, source: MeshBlobKeys): string | null;
26
27
  suspend(): Promise<void>;
@@ -27,8 +27,9 @@ export class CoreBlobServer extends ReadyResource {
27
27
  if (!this.opened || this.closing)
28
28
  return null;
29
29
  const parsed = this._parse(blobId);
30
- if (!parsed || parsed.inline)
30
+ if (!parsed || parsed.inline) {
31
31
  return null;
32
+ }
32
33
  return this._server.getLink(parsed.coreKey ?? b4a.toHex(source.blobs.core.key), {
33
34
  blob: parsed.blobId,
34
35
  drive: source.key,
@@ -39,8 +40,9 @@ export class CoreBlobServer extends ReadyResource {
39
40
  if (this.closing)
40
41
  return;
41
42
  this._suspended = true;
42
- if (!this.opened)
43
+ if (!this.opened) {
43
44
  await this.ready();
45
+ }
44
46
  await Promise.all([...this._probes].map((core) => core.close()));
45
47
  await this._server.suspend();
46
48
  }
@@ -49,13 +51,15 @@ export class CoreBlobServer extends ReadyResource {
49
51
  return;
50
52
  if (!this.opened)
51
53
  await this.ready();
52
- if (this.closing)
54
+ if (this.closing) {
53
55
  return;
56
+ }
54
57
  this._suspended = false;
55
58
  const before = this._server.port;
56
59
  await this._server.resume();
57
- if (this._server.port !== before)
60
+ if (this._server.port !== before) {
58
61
  this.emit('rebound', this._server.port);
62
+ }
59
63
  }
60
64
  async _open() {
61
65
  await this._server.listen();
@@ -69,36 +73,42 @@ export class CoreBlobServer extends ReadyResource {
69
73
  const { blob, range } = info;
70
74
  const meshKey = info.drive ?? undefined;
71
75
  const current = await this._mesh(b4a.toHex(key), blob?.blockOffset, meshKey);
72
- if (!current || this.closing || this._suspended)
76
+ if (!current || this.closing || this._suspended) {
73
77
  return null;
78
+ }
74
79
  const keys = { encryptionKey: current.encryptionKey };
75
- if (!blob || info.head || blob.byteLength === 0)
80
+ if (!blob || info.head || blob.byteLength === 0) {
76
81
  return keys;
82
+ }
77
83
  const start = range?.start ?? 0;
78
84
  const end = !range || range.end === -1 ? blob.byteLength - 1 : Math.min(range.end, blob.byteLength - 1);
79
- if (start > end)
85
+ if (start > end) {
80
86
  return keys;
87
+ }
81
88
  const core = this._store.get({ key, ...keys });
82
89
  const deadline = Date.now() + this._readTimeoutMs;
83
90
  this._probes.add(core);
84
91
  try {
85
92
  await core.ready();
86
- if (this.closing || this._suspended || Date.now() >= deadline)
93
+ if (this.closing || this._suspended || Date.now() >= deadline) {
87
94
  return null;
95
+ }
88
96
  const position = start === 0
89
97
  ? [blob.blockOffset, 0]
90
98
  : await core.seek(blob.byteOffset + start, {
91
99
  timeout: Math.max(1, deadline - Date.now())
92
100
  });
93
- if (!position || this.closing || this._suspended || Date.now() >= deadline)
101
+ if (!position || this.closing || this._suspended || Date.now() >= deadline) {
94
102
  return null;
103
+ }
95
104
  const bytes = await core.get(position[0], { timeout: Math.max(1, deadline - Date.now()) });
96
105
  const served = bytes &&
97
106
  (await this._mesh(b4a.toHex(key), blob.blockOffset, meshKey)) === current &&
98
107
  !this.closing &&
99
108
  !this._suspended;
100
- if (served)
109
+ if (served) {
101
110
  this._onRead?.(current, key, blob.blockOffset);
111
+ }
102
112
  return served ? keys : null;
103
113
  }
104
114
  catch {
@@ -114,8 +124,9 @@ export class CoreBlobServer extends ReadyResource {
114
124
  return parseBlobReference(blobReference);
115
125
  }
116
126
  catch (err) {
117
- if (isInvalidBlobReferenceError(err))
127
+ if (isInvalidBlobReferenceError(err)) {
118
128
  return null;
129
+ }
119
130
  throw err;
120
131
  }
121
132
  }
@@ -3,21 +3,25 @@ import b4a from 'b4a';
3
3
  export async function sweepUnreferenced(blobs, references, coreLength) {
4
4
  const ranges = [];
5
5
  const key = b4a.toHex(blobs.core.key);
6
- for (const reference of references)
7
- addLocalRange(ranges, reference, key, coreLength);
6
+ const local = { localCoreKey: key, coreLength };
7
+ for (const reference of references) {
8
+ addLocalRange(ranges, reference, local);
9
+ }
8
10
  await clearGaps(blobs, mergeRanges(ranges), coreLength);
9
11
  }
10
- function addLocalRange(ranges, reference, localCoreKey, coreLength) {
12
+ function addLocalRange(ranges, reference, { localCoreKey, coreLength }) {
11
13
  const coreKey = parseBlobReferenceCoreKey(reference);
12
- if (coreKey && coreKey !== localCoreKey)
14
+ if (coreKey && coreKey !== localCoreKey) {
13
15
  return;
16
+ }
14
17
  const { blobId } = parseBlobReference(reference);
15
18
  const end = blobId.blockOffset + blobId.blockLength;
16
19
  if (!Number.isSafeInteger(end) || end > coreLength) {
17
20
  throw new TypeError('blob reference exceeds local core');
18
21
  }
19
- if (blobId.blockLength > 0)
22
+ if (blobId.blockLength > 0) {
20
23
  ranges.push({ start: blobId.blockOffset, end });
24
+ }
21
25
  }
22
26
  function mergeRanges(ranges) {
23
27
  const sorted = [...ranges].sort((a, b) => a.start - b.start || a.end - b.end);
@@ -37,10 +41,12 @@ function mergeRanges(ranges) {
37
41
  async function clearGaps(blobs, ranges, coreLength) {
38
42
  let cursor = 0;
39
43
  for (const range of ranges) {
40
- if (cursor < range.start)
44
+ if (cursor < range.start) {
41
45
  await blobs.core.clear(cursor, range.start);
46
+ }
42
47
  cursor = range.end;
43
48
  }
44
- if (cursor < coreLength)
49
+ if (cursor < coreLength) {
45
50
  await blobs.core.clear(cursor, coreLength);
51
+ }
46
52
  }
@@ -1,12 +1,7 @@
1
1
  import type { HandlerFrames } from '../../../spec/capabilities.d.ts';
2
- type UploadFrames<T> = HandlerFrames<T> & {
3
- readonly writeStream?: {
4
- readonly destroyed: boolean;
5
- readonly destroying: boolean;
6
- on(event: 'close', listener: () => void): void;
7
- off(event: 'close', listener: () => void): void;
8
- };
9
- };
2
+ export interface UploadInputOptions {
3
+ readonly inactivityMs?: number;
4
+ }
10
5
  export declare class UploadInput<T extends {
11
6
  data?: Buffer | null;
12
7
  }> {
@@ -17,11 +12,8 @@ export declare class UploadInput<T extends {
17
12
  private readonly _onClose;
18
13
  onData: ((bytes: number) => void) | null;
19
14
  onFailure: ((error: unknown) => void) | null;
20
- constructor(frames: AsyncIterable<T> | UploadFrames<T>, options: {
21
- inactivityMs?: number;
22
- });
15
+ constructor(frames: AsyncIterable<T> | HandlerFrames<T>, options: UploadInputOptions);
23
16
  check(): void;
24
17
  fail(error: unknown): void;
25
18
  close(): void;
26
19
  }
27
- export {};