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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (579) hide show
  1. package/CHANGELOG.md +1205 -1
  2. package/README.md +56 -45
  3. package/dist-lib/index.d.ts +3 -2
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +20 -2
  8. package/dist-lib/lib/api/agents.js +128 -24
  9. package/dist-lib/lib/api/app-config.d.ts +7 -1
  10. package/dist-lib/lib/api/app-config.js +37 -6
  11. package/dist-lib/lib/api/approval-rules.d.ts +1 -1
  12. package/dist-lib/lib/api/approval-rules.js +12 -5
  13. package/dist-lib/lib/api/attachments.d.ts +1 -1
  14. package/dist-lib/lib/api/attachments.js +14 -2
  15. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  16. package/dist-lib/lib/api/chat-move.js +7 -0
  17. package/dist-lib/lib/api/chat.d.ts +12 -2
  18. package/dist-lib/lib/api/chat.js +100 -9
  19. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  20. package/dist-lib/lib/api/chunk-delta.js +115 -0
  21. package/dist-lib/lib/api/chunks.d.ts +19 -2
  22. package/dist-lib/lib/api/chunks.js +73 -13
  23. package/dist-lib/lib/api/config.d.ts +11 -3
  24. package/dist-lib/lib/api/config.js +51 -5
  25. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  26. package/dist-lib/lib/api/current-mesh.js +15 -11
  27. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  28. package/dist-lib/lib/api/custom-models.js +12 -12
  29. package/dist-lib/lib/api/device-routes.d.ts +14 -0
  30. package/dist-lib/lib/api/device-routes.js +144 -0
  31. package/dist-lib/lib/api/devices.d.ts +3 -2
  32. package/dist-lib/lib/api/devices.js +28 -28
  33. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  34. package/dist-lib/lib/api/diagnostics.js +2 -2
  35. package/dist-lib/lib/api/execution.d.ts +16 -1
  36. package/dist-lib/lib/api/execution.js +72 -16
  37. package/dist-lib/lib/api/files.d.ts +1 -1
  38. package/dist-lib/lib/api/files.js +65 -8
  39. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  40. package/dist-lib/lib/api/host-run-log.js +35 -83
  41. package/dist-lib/lib/api/index.d.ts +39 -7
  42. package/dist-lib/lib/api/index.js +116 -36
  43. package/dist-lib/lib/api/instrument.d.ts +2 -2
  44. package/dist-lib/lib/api/instrument.js +24 -48
  45. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  46. package/dist-lib/lib/api/knowledge.js +25 -7
  47. package/dist-lib/lib/api/local-files.d.ts +5 -1
  48. package/dist-lib/lib/api/local-files.js +9 -5
  49. package/dist-lib/lib/api/logs.js +3 -3
  50. package/dist-lib/lib/api/members.d.ts +10 -1
  51. package/dist-lib/lib/api/members.js +69 -44
  52. package/dist-lib/lib/api/mesh.d.ts +15 -6
  53. package/dist-lib/lib/api/mesh.js +13 -9
  54. package/dist-lib/lib/api/model-download.d.ts +2 -1
  55. package/dist-lib/lib/api/model-download.js +2 -2
  56. package/dist-lib/lib/api/network.d.ts +10 -2
  57. package/dist-lib/lib/api/network.js +8 -2
  58. package/dist-lib/lib/api/notifications.d.ts +3 -1
  59. package/dist-lib/lib/api/notifications.js +14 -9
  60. package/dist-lib/lib/api/projects.d.ts +20 -0
  61. package/dist-lib/lib/api/projects.js +172 -0
  62. package/dist-lib/lib/api/rag-plugin.d.ts +17 -0
  63. package/dist-lib/lib/api/rag-plugin.js +44 -0
  64. package/dist-lib/lib/api/rag.d.ts +0 -1
  65. package/dist-lib/lib/api/rag.js +106 -33
  66. package/dist-lib/lib/api/served.d.ts +17 -0
  67. package/dist-lib/lib/api/served.js +65 -0
  68. package/dist-lib/lib/api/sync.d.ts +2 -1
  69. package/dist-lib/lib/api/sync.js +13 -3
  70. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  71. package/dist-lib/lib/api/tool-activity.js +4 -3
  72. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  73. package/dist-lib/lib/api/tool-configs.js +6 -9
  74. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  75. package/dist-lib/lib/api/upload-frames.js +0 -1
  76. package/dist-lib/lib/api/watchable.d.ts +3 -2
  77. package/dist-lib/lib/api/watchable.js +2 -3
  78. package/dist-lib/lib/api/workspace.d.ts +12 -0
  79. package/dist-lib/lib/api/workspace.js +61 -0
  80. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  81. package/dist-lib/lib/assistant/fake-models.js +112 -0
  82. package/dist-lib/lib/assistant/harness.d.ts +48 -31
  83. package/dist-lib/lib/assistant/harness.js +51 -10
  84. package/dist-lib/lib/assistant/history.d.ts +37 -17
  85. package/dist-lib/lib/assistant/history.js +212 -87
  86. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  87. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  88. package/dist-lib/lib/assistant/media-round.d.ts +61 -0
  89. package/dist-lib/lib/assistant/media-round.js +111 -0
  90. package/dist-lib/lib/assistant/message.d.ts +28 -1
  91. package/dist-lib/lib/assistant/message.js +65 -2
  92. package/dist-lib/lib/assistant/model-round.d.ts +118 -0
  93. package/dist-lib/lib/assistant/model-round.js +706 -0
  94. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  95. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  96. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  97. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  98. package/dist-lib/lib/assistant/round-host.d.ts +65 -0
  99. package/dist-lib/lib/assistant/round-host.js +332 -0
  100. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  101. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  102. package/dist-lib/lib/assistant/upload.d.ts +12 -0
  103. package/dist-lib/lib/assistant/upload.js +36 -0
  104. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  105. package/dist-lib/lib/assistant/video-budget.js +29 -0
  106. package/dist-lib/lib/assistant-client.d.ts +5 -1
  107. package/dist-lib/lib/assistant-client.js +54 -14
  108. package/dist-lib/lib/assistant-tree.d.ts +14 -3
  109. package/dist-lib/lib/assistant-tree.js +113 -21
  110. package/dist-lib/lib/assistant.d.ts +115 -25
  111. package/dist-lib/lib/assistant.js +2409 -1245
  112. package/dist-lib/lib/audio-format.js +1 -1
  113. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  114. package/dist-lib/lib/chat-suggestion.js +47 -0
  115. package/dist-lib/lib/client.d.ts +3 -2
  116. package/dist-lib/lib/client.js +18 -3
  117. package/dist-lib/lib/compaction.d.ts +3 -1
  118. package/dist-lib/lib/compaction.js +20 -6
  119. package/dist-lib/lib/constants.d.ts +10 -0
  120. package/dist-lib/lib/constants.js +10 -0
  121. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  122. package/dist-lib/lib/core/agent-copies.js +47 -0
  123. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  124. package/dist-lib/lib/core/agent-hosting.js +76 -0
  125. package/dist-lib/lib/core/agent.d.ts +9 -1
  126. package/dist-lib/lib/core/agent.js +58 -63
  127. package/dist-lib/lib/core/approval-rules.d.ts +5 -1
  128. package/dist-lib/lib/core/approval-rules.js +17 -9
  129. package/dist-lib/lib/core/archived-mesh.d.ts +14 -7
  130. package/dist-lib/lib/core/archived-mesh.js +75 -59
  131. package/dist-lib/lib/core/async-iterable.js +1 -1
  132. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  133. package/dist-lib/lib/core/blind-peers.js +1 -0
  134. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  135. package/dist-lib/lib/core/chat-activity.js +45 -34
  136. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  137. package/dist-lib/lib/core/chat-copy.js +404 -0
  138. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  139. package/dist-lib/lib/core/chat-fork.js +246 -0
  140. package/dist-lib/lib/core/chat-group.js +10 -22
  141. package/dist-lib/lib/core/chat-move.d.ts +77 -0
  142. package/dist-lib/lib/core/chat-move.js +601 -0
  143. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  144. package/dist-lib/lib/core/chat-order.js +28 -19
  145. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  146. package/dist-lib/lib/core/chat-read.js +49 -0
  147. package/dist-lib/lib/core/chat-search.js +14 -12
  148. package/dist-lib/lib/core/chat.d.ts +32 -4
  149. package/dist-lib/lib/core/chat.js +135 -61
  150. package/dist-lib/lib/core/chunk.d.ts +35 -7
  151. package/dist-lib/lib/core/chunk.js +271 -72
  152. package/dist-lib/lib/core/collections.d.ts +41 -1
  153. package/dist-lib/lib/core/collections.js +41 -1
  154. package/dist-lib/lib/core/config-value.d.ts +7 -0
  155. package/dist-lib/lib/core/config-value.js +15 -0
  156. package/dist-lib/lib/core/contract/activity.d.ts +7 -2
  157. package/dist-lib/lib/core/contract/activity.js +71 -23
  158. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  159. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  160. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  161. package/dist-lib/lib/core/contract/agents.js +142 -3
  162. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  163. package/dist-lib/lib/core/contract/chat.js +53 -3
  164. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  165. package/dist-lib/lib/core/contract/chunks.js +125 -38
  166. package/dist-lib/lib/core/contract/devices.js +6 -4
  167. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  168. package/dist-lib/lib/core/contract/index.js +38 -11
  169. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  170. package/dist-lib/lib/core/contract/indexing.js +51 -7
  171. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  172. package/dist-lib/lib/core/contract/invites.js +26 -36
  173. package/dist-lib/lib/core/contract/joined-meshes.js +4 -1
  174. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  175. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  176. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  177. package/dist-lib/lib/core/contract/members.js +48 -12
  178. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  179. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  180. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  181. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  182. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  183. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  184. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  185. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  186. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  187. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  188. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  189. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  190. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  191. package/dist-lib/lib/core/contract/open-join.js +77 -0
  192. package/dist-lib/lib/core/contract/project-device-keys.d.ts +9 -0
  193. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  194. package/dist-lib/lib/core/contract/project-host-keys.d.ts +9 -0
  195. package/dist-lib/lib/core/contract/project-host-keys.js +52 -0
  196. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  197. package/dist-lib/lib/core/contract/project-order.js +25 -0
  198. package/dist-lib/lib/core/contract/projects.d.ts +23 -0
  199. package/dist-lib/lib/core/contract/projects.js +339 -0
  200. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  201. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  202. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  203. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  204. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  205. package/dist-lib/lib/core/contract/roles.js +123 -0
  206. package/dist-lib/lib/core/contract/run-requests.d.ts +11 -0
  207. package/dist-lib/lib/core/contract/run-requests.js +114 -0
  208. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  209. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  210. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  211. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  212. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  213. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  214. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  215. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  216. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  217. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  218. package/dist-lib/lib/core/contract/workspace.js +311 -0
  219. package/dist-lib/lib/core/contract/writers.js +100 -16
  220. package/dist-lib/lib/core/deleted-agent-runs.d.ts +8 -0
  221. package/dist-lib/lib/core/deleted-agent-runs.js +57 -0
  222. package/dist-lib/lib/core/departures.d.ts +18 -5
  223. package/dist-lib/lib/core/departures.js +82 -6
  224. package/dist-lib/lib/core/device-control.d.ts +21 -0
  225. package/dist-lib/lib/core/device-control.js +91 -0
  226. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  227. package/dist-lib/lib/core/device-seal.js +22 -0
  228. package/dist-lib/lib/core/devices.d.ts +2 -1
  229. package/dist-lib/lib/core/devices.js +6 -11
  230. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  231. package/dist-lib/lib/core/document-attachment.js +14 -0
  232. package/dist-lib/lib/core/files/attachments.d.ts +2 -0
  233. package/dist-lib/lib/core/files/attachments.js +23 -7
  234. package/dist-lib/lib/core/files/index.d.ts +28 -15
  235. package/dist-lib/lib/core/files/index.js +222 -43
  236. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  237. package/dist-lib/lib/core/files/knowledge.js +77 -5
  238. package/dist-lib/lib/core/files/preview/index.js +6 -2
  239. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  240. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  241. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  242. package/dist-lib/lib/core/files/processing/document.js +26 -2
  243. package/dist-lib/lib/core/files/processing/index.d.ts +12 -3
  244. package/dist-lib/lib/core/files/processing/index.js +122 -73
  245. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  246. package/dist-lib/lib/core/files/processing/protocol.js +27 -37
  247. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  248. package/dist-lib/lib/core/files/processing/source.js +12 -4
  249. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  250. package/dist-lib/lib/core/files/processing/state.js +9 -1
  251. package/dist-lib/lib/core/files/rag/build.d.ts +15 -2
  252. package/dist-lib/lib/core/files/rag/build.js +119 -21
  253. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  254. package/dist-lib/lib/core/files/rag/failure.js +58 -0
  255. package/dist-lib/lib/core/files/rag/index.d.ts +21 -5
  256. package/dist-lib/lib/core/files/rag/index.js +38 -9
  257. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  258. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  259. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  260. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  261. package/dist-lib/lib/core/files/rag/load.d.ts +3 -3
  262. package/dist-lib/lib/core/files/rag/load.js +6 -3
  263. package/dist-lib/lib/core/files/rag/plugin-index.d.ts +32 -0
  264. package/dist-lib/lib/core/files/rag/plugin-index.js +120 -0
  265. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  266. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  267. package/dist-lib/lib/core/files/rag/produce.d.ts +3 -4
  268. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  269. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  270. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  271. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  272. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  273. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  274. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  275. package/dist-lib/lib/core/files/records/index.js +1 -1
  276. package/dist-lib/lib/core/files/records/knowledge.d.ts +12 -4
  277. package/dist-lib/lib/core/files/records/knowledge.js +34 -30
  278. package/dist-lib/lib/core/files/records/purge.js +13 -8
  279. package/dist-lib/lib/core/files/records/reclaim.js +21 -55
  280. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  281. package/dist-lib/lib/core/files/records/routing.js +6 -2
  282. package/dist-lib/lib/core/files/records/source.js +3 -5
  283. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  284. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  285. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  286. package/dist-lib/lib/core/files/store/blob.js +2 -2
  287. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  288. package/dist-lib/lib/core/files/store/index.js +4 -1
  289. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  290. package/dist-lib/lib/core/files/store/reference.js +12 -2
  291. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  292. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  293. package/dist-lib/lib/core/files/upload.js +117 -51
  294. package/dist-lib/lib/core/first-event.d.ts +6 -0
  295. package/dist-lib/lib/core/first-event.js +13 -0
  296. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  297. package/dist-lib/lib/core/fs-drives.js +35 -35
  298. package/dist-lib/lib/core/helpers/index.d.ts +1 -1
  299. package/dist-lib/lib/core/helpers/index.js +2 -2
  300. package/dist-lib/lib/core/id.d.ts +1 -0
  301. package/dist-lib/lib/core/id.js +3 -0
  302. package/dist-lib/lib/core/identity.d.ts +3 -1
  303. package/dist-lib/lib/core/identity.js +25 -4
  304. package/dist-lib/lib/core/invite.d.ts +6 -2
  305. package/dist-lib/lib/core/invite.js +22 -8
  306. package/dist-lib/lib/core/local/files.d.ts +2 -1
  307. package/dist-lib/lib/core/local/files.js +5 -7
  308. package/dist-lib/lib/core/local/index.d.ts +93 -8
  309. package/dist-lib/lib/core/local/index.js +327 -28
  310. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  311. package/dist-lib/lib/core/local/run-logs.js +132 -0
  312. package/dist-lib/lib/core/member-key.d.ts +7 -0
  313. package/dist-lib/lib/core/member-key.js +24 -0
  314. package/dist-lib/lib/core/membership.d.ts +3 -14
  315. package/dist-lib/lib/core/membership.js +3 -96
  316. package/dist-lib/lib/core/mesh.d.ts +132 -29
  317. package/dist-lib/lib/core/mesh.js +775 -215
  318. package/dist-lib/lib/core/migrations/agent-catalog.js +2 -8
  319. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  320. package/dist-lib/lib/core/migrations/agent-tools-scope.js +18 -0
  321. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  322. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  323. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  324. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  325. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  326. package/dist-lib/lib/core/migrations/index.js +69 -8
  327. package/dist-lib/lib/core/migrations/writer-links.d.ts +3 -0
  328. package/dist-lib/lib/core/migrations/writer-links.js +30 -0
  329. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  330. package/dist-lib/lib/core/model-requests.js +65 -0
  331. package/dist-lib/lib/core/next-frame.js +2 -1
  332. package/dist-lib/lib/core/notification.js +100 -25
  333. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  334. package/dist-lib/lib/core/pdf/figure.js +64 -0
  335. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  336. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  337. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  338. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  339. package/dist-lib/lib/core/project-keys.d.ts +16 -0
  340. package/dist-lib/lib/core/project-keys.js +65 -0
  341. package/dist-lib/lib/core/prompt-history.js +4 -4
  342. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  343. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  344. package/dist-lib/lib/core/public-mesh.d.ts +25 -0
  345. package/dist-lib/lib/core/public-mesh.js +81 -0
  346. package/dist-lib/lib/core/purge.d.ts +3 -0
  347. package/dist-lib/lib/core/purge.js +7 -0
  348. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  349. package/dist-lib/lib/core/run-driver.js +20 -0
  350. package/dist-lib/lib/core/run-requests.d.ts +14 -0
  351. package/dist-lib/lib/core/run-requests.js +78 -0
  352. package/dist-lib/lib/core/send.d.ts +2 -0
  353. package/dist-lib/lib/core/send.js +17 -4
  354. package/dist-lib/lib/core/senders.d.ts +19 -0
  355. package/dist-lib/lib/core/senders.js +45 -0
  356. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  357. package/dist-lib/lib/core/shared-agents.js +283 -0
  358. package/dist-lib/lib/core/skill-availability.d.ts +33 -0
  359. package/dist-lib/lib/core/skill-availability.js +67 -0
  360. package/dist-lib/lib/core/skill-secrets.d.ts +13 -18
  361. package/dist-lib/lib/core/skill-secrets.js +93 -72
  362. package/dist-lib/lib/core/sync/background.d.ts +34 -0
  363. package/dist-lib/lib/core/sync/background.js +86 -0
  364. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  365. package/dist-lib/lib/core/sync/changed.js +7 -0
  366. package/dist-lib/lib/core/sync/devices.js +6 -3
  367. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  368. package/dist-lib/lib/core/sync/files.js +50 -72
  369. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  370. package/dist-lib/lib/core/sync/index.js +193 -81
  371. package/dist-lib/lib/core/sync/view-updates.d.ts +39 -0
  372. package/dist-lib/lib/core/sync/view-updates.js +124 -0
  373. package/dist-lib/lib/core/sync-status.js +99 -43
  374. package/dist-lib/lib/core/system-info.d.ts +2 -2
  375. package/dist-lib/lib/core/system-info.js +10 -11
  376. package/dist-lib/lib/core/tool-activity.js +6 -12
  377. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  378. package/dist-lib/lib/core/tool-configs.js +27 -39
  379. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  380. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  381. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  382. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  383. package/dist-lib/lib/core/upgrade-summary.d.ts +19 -0
  384. package/dist-lib/lib/core/upgrade-summary.js +67 -0
  385. package/dist-lib/lib/core/vault-managed-skills.d.ts +18 -0
  386. package/dist-lib/lib/core/vault-managed-skills.js +105 -0
  387. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  388. package/dist-lib/lib/core/video/attachment.js +7 -0
  389. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  390. package/dist-lib/lib/core/video/digest.js +57 -0
  391. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  392. package/dist-lib/lib/core/video/frames.js +224 -0
  393. package/dist-lib/lib/core/view-read.d.ts +4 -0
  394. package/dist-lib/lib/core/view-read.js +23 -0
  395. package/dist-lib/lib/core/workspace-upgrade.d.ts +23 -0
  396. package/dist-lib/lib/core/workspace-upgrade.js +51 -0
  397. package/dist-lib/lib/core.d.ts +345 -88
  398. package/dist-lib/lib/core.js +4275 -1513
  399. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  400. package/dist-lib/lib/credential-pusher.js +111 -62
  401. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  402. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  403. package/dist-lib/lib/custom-model-task.js +2 -2
  404. package/dist-lib/lib/device-tree.d.ts +18 -0
  405. package/dist-lib/lib/device-tree.js +32 -0
  406. package/dist-lib/lib/diagnostics.d.ts +7 -0
  407. package/dist-lib/lib/diagnostics.js +22 -0
  408. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  409. package/dist-lib/lib/doctor/checks.js +272 -0
  410. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  411. package/dist-lib/lib/doctor/redact.js +31 -0
  412. package/dist-lib/lib/doctor/render.d.ts +8 -0
  413. package/dist-lib/lib/doctor/render.js +83 -0
  414. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  415. package/dist-lib/lib/doctor/tree.js +167 -0
  416. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  417. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  418. package/dist-lib/lib/errors.d.ts +814 -0
  419. package/dist-lib/lib/errors.js +748 -0
  420. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  421. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  422. package/dist-lib/lib/guards.d.ts +1 -0
  423. package/dist-lib/lib/guards.js +4 -0
  424. package/dist-lib/lib/inference-calls.d.ts +1 -2
  425. package/dist-lib/lib/inference-calls.js +2 -10
  426. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  427. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  428. package/dist-lib/lib/knowledge-search.js +5 -51
  429. package/dist-lib/lib/kv-cache-ledger.d.ts +22 -0
  430. package/dist-lib/lib/kv-cache-ledger.js +72 -0
  431. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  432. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  433. package/dist-lib/lib/kv-cache-retention.d.ts +36 -0
  434. package/dist-lib/lib/kv-cache-retention.js +101 -0
  435. package/dist-lib/lib/latest-frame.d.ts +10 -0
  436. package/dist-lib/lib/latest-frame.js +48 -0
  437. package/dist-lib/lib/llm-model-names.d.ts +1 -1
  438. package/dist-lib/lib/llm-model-names.js +1 -1
  439. package/dist-lib/lib/log.d.ts +7 -6
  440. package/dist-lib/lib/log.js +14 -7
  441. package/dist-lib/lib/logger-type.d.ts +2 -5
  442. package/dist-lib/lib/mesh-scoped-engine.js +47 -2
  443. package/dist-lib/lib/model-context.js +1 -2
  444. package/dist-lib/lib/model-download-status.d.ts +3 -3
  445. package/dist-lib/lib/model-download.d.ts +22 -13
  446. package/dist-lib/lib/model-download.js +106 -37
  447. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  448. package/dist-lib/lib/model-memory-cap.d.ts +30 -0
  449. package/dist-lib/lib/model-memory-cap.js +78 -0
  450. package/dist-lib/lib/models-watch.d.ts +1 -1
  451. package/dist-lib/lib/models-watch.js +4 -4
  452. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  453. package/dist-lib/lib/oauth/flow-core.js +5 -3
  454. package/dist-lib/lib/oauth/flow.js +1 -1
  455. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  456. package/dist-lib/lib/oauth/loopback.js +57 -12
  457. package/dist-lib/lib/oauth/providers.js +4 -2
  458. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  459. package/dist-lib/lib/oauth/register.js +35 -19
  460. package/dist-lib/lib/oauth/request.d.ts +10 -0
  461. package/dist-lib/lib/oauth/request.js +22 -0
  462. package/dist-lib/lib/oauth/resolve.js +42 -13
  463. package/dist-lib/lib/oauth/token-exchange-core.js +40 -31
  464. package/dist-lib/lib/oauth/types.d.ts +3 -0
  465. package/dist-lib/lib/oauth.d.ts +2 -1
  466. package/dist-lib/lib/oauth.js +1 -0
  467. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  468. package/dist-lib/lib/persistent-dir.js +9 -0
  469. package/dist-lib/lib/probe-rounds.d.ts +8 -0
  470. package/dist-lib/lib/probe-rounds.js +10 -0
  471. package/dist-lib/lib/reconnecting-watch.js +19 -11
  472. package/dist-lib/lib/run-input.d.ts +14 -0
  473. package/dist-lib/lib/run-input.js +33 -0
  474. package/dist-lib/lib/run-notices.d.ts +5 -0
  475. package/dist-lib/lib/run-notices.js +13 -2
  476. package/dist-lib/lib/run-replay.d.ts +45 -0
  477. package/dist-lib/lib/run-replay.js +169 -0
  478. package/dist-lib/lib/run-transcript.d.ts +13 -12
  479. package/dist-lib/lib/run-transcript.js +20 -19
  480. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  481. package/dist-lib/lib/task.js +6 -4
  482. package/dist-lib/lib/test-env.d.ts +1 -0
  483. package/dist-lib/lib/test-env.js +4 -0
  484. package/dist-lib/schema/build.js +66 -55
  485. package/dist-lib/schema/config.d.ts +1 -1
  486. package/dist-lib/schema/config.js +1 -1
  487. package/dist-lib/schema/content.d.ts +5 -1
  488. package/dist-lib/schema/content.js +60 -12
  489. package/dist-lib/schema/engine.d.ts +1 -0
  490. package/dist-lib/schema/engine.js +941 -152
  491. package/dist-lib/schema/field-order.js +8 -1
  492. package/dist-lib/schema/indexes.d.ts +10 -0
  493. package/dist-lib/schema/indexes.js +53 -3
  494. package/dist-lib/schema/local.js +83 -5
  495. package/dist-lib/schema/qvac.d.ts +4 -1
  496. package/dist-lib/schema/qvac.js +558 -16
  497. package/dist-lib/spec/bind.js +261 -48
  498. package/dist-lib/spec/calls.js +56 -5
  499. package/dist-lib/spec/capabilities.d.ts +129 -20
  500. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  501. package/dist-lib/spec/hrpc/hrpc.json +870 -207
  502. package/dist-lib/spec/hrpc/index.js +969 -347
  503. package/dist-lib/spec/hrpc/messages.js +7590 -4896
  504. package/dist-lib/spec/hyperschema/index.js +7590 -4896
  505. package/dist-lib/spec/hyperschema/schema.json +5316 -3224
  506. package/dist-lib/spec/hyperschema/types.d.ts +576 -62
  507. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  508. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  509. package/dist-lib/spec/local/hyperdb/messages.js +1588 -488
  510. package/dist-lib/spec/local/hyperschema/index.js +584 -16
  511. package/dist-lib/spec/local/hyperschema/schema.json +369 -1
  512. package/dist-lib/spec/local/hyperschema/types.d.ts +88 -2
  513. package/dist-lib/spec/mesh/hyperdb/db.json +711 -9
  514. package/dist-lib/spec/mesh/hyperdb/index.js +2769 -7
  515. package/dist-lib/spec/mesh/hyperdb/messages.js +7140 -1298
  516. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +205 -1
  517. package/dist-lib/spec/mesh/hyperdispatch/index.js +579 -1
  518. package/dist-lib/spec/mesh/hyperdispatch/messages.js +4017 -267
  519. package/dist-lib/spec/mesh/hyperschema/index.js +4017 -267
  520. package/dist-lib/spec/mesh/hyperschema/schema.json +2193 -19
  521. package/dist-lib/spec/mesh/hyperschema/types.d.ts +550 -6
  522. package/package.json +136 -90
  523. package/tui/README.md +119 -20
  524. package/tui/app.mjs +2000 -621
  525. package/tui/boot.mjs +76 -9
  526. package/tui/cli.mjs +93 -0
  527. package/tui/index.mjs +2 -51
  528. package/tui/lib/connect-sheet.mjs +350 -0
  529. package/tui/lib/device-target.mjs +64 -0
  530. package/tui/lib/folders-command.mjs +84 -0
  531. package/tui/lib/fork-command.mjs +43 -0
  532. package/tui/lib/knowledge-import.mjs +3 -21
  533. package/tui/lib/local-path.mjs +21 -0
  534. package/tui/lib/move-command.mjs +17 -0
  535. package/tui/lib/render.mjs +30 -1
  536. package/tui/lib/setup.mjs +59 -25
  537. package/tui/lib/skill-connect.mjs +145 -0
  538. package/tui/lib/updater.mjs +86 -0
  539. package/tui/main.mjs +44 -18
  540. package/tui/plugins.mjs +158 -0
  541. package/worker/assistant-sidecar.mjs +28 -4
  542. package/worker/stow-entry.mjs +3 -50
  543. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  544. package/dist-lib/lib/core/contract/compute.js +0 -48
  545. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  546. package/dist-lib/lib/core/device-invites.js +0 -63
  547. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  548. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  549. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  550. package/dist-lib/lib/core/grant-expiry.js +0 -66
  551. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  552. package/dist-lib/lib/core/handoff-channel.js +0 -123
  553. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  554. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  555. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  556. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  557. package/dist-lib/lib/core/hosted-agents.js +0 -140
  558. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  559. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  560. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  561. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  562. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  563. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  564. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  565. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  566. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  567. package/dist-lib/lib/core/secret-handoff.js +0 -29
  568. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  569. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  570. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  571. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  572. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  573. package/dist-lib/lib/image-cache-dir.js +0 -5
  574. package/dist-lib/lib/log-levels.d.ts +0 -7
  575. package/dist-lib/lib/log-levels.js +0 -1
  576. package/dist-lib/lib/logger.d.ts +0 -5
  577. package/dist-lib/lib/logger.js +0 -18
  578. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  579. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
@@ -1,8 +1,14 @@
1
- import { type DriveOpFn, type GrantedDrive } from '@qvac/harness/lib/tools/fs/remote.ts';
1
+ import { type AbortSignal } from 'bare-abort-controller';
2
+ import type { DriveOpFn, GrantedDrive } from '@qvac/harness';
2
3
  import type { AcquiredDrive, DriveHost } from './core/fs-drives.ts';
3
4
  import type { FsGrant } from './fs-grants.ts';
4
5
  export declare const DRIVE_OP_TIMEOUT_MS = 15000;
5
6
  export declare function sweepDriveStaging(now?: number): Promise<void>;
7
+ interface PipeCappedOptions {
8
+ readonly cap: number;
9
+ readonly signal: AbortSignal;
10
+ }
11
+ export declare function pipeCapped(source: AsyncIterable<Uint8Array>, target: string, { cap, signal }: PipeCappedOptions): Promise<boolean>;
6
12
  export declare function createDriveOp(drives: ReadonlyMap<string, AcquiredDrive>): DriveOpFn;
7
13
  export interface ResolvedFsGrants {
8
14
  readonly grantedDirs: string[];
@@ -10,3 +16,4 @@ export interface ResolvedFsGrants {
10
16
  readonly driveOp?: DriveOpFn;
11
17
  }
12
18
  export declare function resolveFsGrants(grants: readonly FsGrant[], driveHost: DriveHost | undefined, onDropped?: (key: string, err: unknown) => void): Promise<ResolvedFsGrants>;
19
+ export {};
@@ -4,12 +4,70 @@ import { pipelinePromise, Readable } from 'streamx';
4
4
  import { AbortController } from 'bare-abort-controller';
5
5
  import { STAGING_DIR as HARNESS_STAGING_DIR } from '@qvac/harness/lib/staging.ts';
6
6
  import { userTmpPath } from '@qvac/harness/lib/tmp-path.ts';
7
- import { MAX_DRIVE_BYTES } from '@qvac/harness/lib/tools/fs/remote.ts';
8
7
  import { errorMessage } from './guards.js';
9
8
  export const DRIVE_OP_TIMEOUT_MS = 15_000;
9
+ const MAX_DRIVE_BYTES = 8 * 1024 * 1024;
10
10
  const STAGING_DIR = userTmpPath('qvac-fs-drive-host');
11
11
  const STAGING_MAX_AGE_MS = 60 * 60 * 1000;
12
12
  const noop = () => { };
13
+ function waitFor(promise, signal) {
14
+ if (signal.aborted) {
15
+ return Promise.reject(signal.reason ?? new Error('drive operation cancelled'));
16
+ }
17
+ return new Promise((resolve, reject) => {
18
+ let settled = false;
19
+ const finish = (result) => {
20
+ if (settled)
21
+ return;
22
+ settled = true;
23
+ signal.removeEventListener('abort', onAbort);
24
+ if (result.ok) {
25
+ resolve(result.value);
26
+ }
27
+ else {
28
+ reject(result.error);
29
+ }
30
+ };
31
+ const onAbort = () => finish({ ok: false, error: signal.reason ?? new Error('drive operation cancelled') });
32
+ signal.addEventListener('abort', onAbort, { once: true });
33
+ promise.then((value) => finish({ ok: true, value }), (error) => finish({ ok: false, error }));
34
+ });
35
+ }
36
+ async function* abortableIterable(source, signal) {
37
+ const iterator = source[Symbol.asyncIterator]();
38
+ let returning = null;
39
+ const returnIterator = () => {
40
+ if (!returning) {
41
+ returning = Promise.resolve(iterator.return?.());
42
+ }
43
+ return returning;
44
+ };
45
+ const cancel = () => {
46
+ if ('destroy' in source && typeof source.destroy === 'function') {
47
+ source.destroy();
48
+ }
49
+ void returnIterator().catch(noop);
50
+ };
51
+ signal.addEventListener('abort', cancel, { once: true });
52
+ try {
53
+ while (true) {
54
+ const next = await waitFor(iterator.next(), signal);
55
+ if (next.done) {
56
+ return;
57
+ }
58
+ yield next.value;
59
+ }
60
+ }
61
+ finally {
62
+ signal.removeEventListener('abort', cancel);
63
+ if (signal.aborted) {
64
+ cancel();
65
+ }
66
+ else {
67
+ await returnIterator().catch(noop);
68
+ }
69
+ }
70
+ }
13
71
  export async function sweepDriveStaging(now = Date.now()) {
14
72
  const names = await fs.promises.readdir(STAGING_DIR).catch(() => []);
15
73
  await Promise.all(names.map(async (name) => {
@@ -45,38 +103,141 @@ async function stagedPath(prefix) {
45
103
  function stripMetadata(entry) {
46
104
  return { ...entry, value: { ...entry.value, metadata: null } };
47
105
  }
48
- async function pipeCapped(source, target, { cap, signal }) {
106
+ export async function pipeCapped(source, target, { cap, signal }) {
107
+ const iterator = source[Symbol.asyncIterator]();
49
108
  const sink = fs.createWriteStream(target, { mode: 0o600 });
109
+ const sinkClosed = new Promise((resolve) => sink.once('close', resolve));
50
110
  let sinkError = null;
111
+ let rejectSink = null;
112
+ const sinkFailure = new Promise((_, reject) => {
113
+ rejectSink = reject;
114
+ });
115
+ void sinkFailure.catch(noop);
51
116
  sink.on('error', (err) => {
52
117
  sinkError = err;
118
+ rejectSink?.(err);
53
119
  });
54
120
  let written = 0;
55
121
  let truncated = false;
122
+ let completed = false;
123
+ let returning = null;
124
+ const returnIterator = () => {
125
+ if (!returning) {
126
+ returning = Promise.resolve(iterator.return?.());
127
+ }
128
+ return returning;
129
+ };
130
+ const abortError = () => signal.reason instanceof Error ? signal.reason : new Error('drive read aborted');
131
+ const abort = () => {
132
+ if ('destroy' in source && typeof source.destroy === 'function') {
133
+ source.destroy(abortError());
134
+ }
135
+ void returnIterator().catch(noop);
136
+ sink.destroy(abortError());
137
+ };
138
+ const next = async () => {
139
+ if (signal.aborted) {
140
+ throw abortError();
141
+ }
142
+ let onAbort = null;
143
+ try {
144
+ return await Promise.race([
145
+ iterator.next(),
146
+ sinkFailure,
147
+ new Promise((_, reject) => {
148
+ onAbort = () => reject(abortError());
149
+ signal.addEventListener('abort', onAbort, { once: true });
150
+ })
151
+ ]);
152
+ }
153
+ finally {
154
+ if (onAbort) {
155
+ signal.removeEventListener('abort', onAbort);
156
+ }
157
+ }
158
+ };
159
+ signal.addEventListener('abort', abort, { once: true });
160
+ let failure = null;
56
161
  try {
57
- for await (const chunk of source) {
58
- if (signal.aborted)
162
+ while (true) {
163
+ if (signal.aborted) {
164
+ throw abortError();
165
+ }
166
+ const item = await next();
167
+ if (signal.aborted) {
168
+ throw abortError();
169
+ }
170
+ if (item.done) {
59
171
  break;
60
- if (sinkError)
172
+ }
173
+ const chunk = item.value;
174
+ if (sinkError) {
61
175
  throw sinkError;
176
+ }
62
177
  if (written >= cap) {
63
178
  truncated = true;
64
179
  break;
65
180
  }
66
181
  const room = cap - written;
67
182
  const slice = chunk.byteLength > room ? chunk.subarray(0, room) : chunk;
68
- sink.write(slice);
183
+ if (!sink.write(slice)) {
184
+ await new Promise((resolve, reject) => {
185
+ const onDrain = () => {
186
+ sink.off('error', onError);
187
+ signal.removeEventListener('abort', onAbort);
188
+ resolve();
189
+ };
190
+ const onError = (err) => {
191
+ sink.off('drain', onDrain);
192
+ signal.removeEventListener('abort', onAbort);
193
+ reject(err);
194
+ };
195
+ const onAbort = () => {
196
+ sink.off('drain', onDrain);
197
+ sink.off('error', onError);
198
+ reject(abortError());
199
+ };
200
+ sink.once('drain', onDrain);
201
+ sink.once('error', onError);
202
+ signal.addEventListener('abort', onAbort, { once: true });
203
+ });
204
+ }
69
205
  written += slice.byteLength;
70
206
  if (slice.byteLength < chunk.byteLength) {
71
207
  truncated = true;
208
+ break;
72
209
  }
73
210
  }
211
+ completed = true;
212
+ }
213
+ catch (err) {
214
+ failure = err;
215
+ if ('destroy' in source && typeof source.destroy === 'function') {
216
+ source.destroy(err instanceof Error ? err : new Error(String(err)));
217
+ }
74
218
  }
75
219
  finally {
76
- await new Promise((resolve) => sink.end(resolve));
220
+ signal.removeEventListener('abort', abort);
221
+ if (!completed || truncated) {
222
+ await returnIterator().catch((err) => (failure ??= err));
223
+ }
224
+ if (signal.aborted || sinkError || sink.destroyed) {
225
+ if (!sink.destroyed) {
226
+ sink.destroy();
227
+ }
228
+ await sinkClosed;
229
+ }
230
+ else {
231
+ sink.end();
232
+ await sinkClosed;
233
+ }
77
234
  }
78
235
  if (sinkError) {
79
- throw sinkError;
236
+ failure ??= sinkError;
237
+ }
238
+ if (failure) {
239
+ await fs.promises.unlink(target).catch(noop);
240
+ throw failure;
80
241
  }
81
242
  return truncated;
82
243
  }
@@ -84,42 +245,138 @@ function folderRange(folder) {
84
245
  const trimmed = folder === '/' ? '' : folder.replace(/\/+$/, '');
85
246
  return { gt: `${trimmed}/`, lt: `${trimmed}0` };
86
247
  }
248
+ function childDirKey(folder, key) {
249
+ const prefix = folder === '/' ? '/' : `${folder.replace(/\/+$/, '')}/`;
250
+ const child = key.slice(prefix.length);
251
+ const slash = child.indexOf('/');
252
+ return slash === -1 ? null : `${prefix}${child.slice(0, slash)}`;
253
+ }
254
+ function directChild(folder, entry) {
255
+ const dir = childDirKey(folder, entry.key);
256
+ return dir ? { key: dir, dir: true } : stripMetadata(entry);
257
+ }
258
+ async function* childKeys(drive, options) {
259
+ const { folder } = options;
260
+ let range = options.start;
261
+ while (true) {
262
+ let past = null;
263
+ for await (const raw of abortableIterable(drive.entries(range, { ignore: options.ignore }), options.signal)) {
264
+ yield raw;
265
+ const dir = childDirKey(folder, raw.key);
266
+ if (dir) {
267
+ past = `${dir}0`;
268
+ break;
269
+ }
270
+ }
271
+ if (!past) {
272
+ return;
273
+ }
274
+ range = { gte: past, lt: options.range.lt };
275
+ }
276
+ }
277
+ async function shallowEntries(drive, request, options) {
278
+ const { signal, range } = options;
279
+ const entries = [];
280
+ let current = null;
281
+ let currentLastKey = null;
282
+ let lastEmittedKey = null;
283
+ let cursor = null;
284
+ const cursorDir = request.cursor ? childDirKey(request.folder, request.cursor) : null;
285
+ const start = cursorDir
286
+ ? { gte: `${cursorDir}0`, lt: range.lt }
287
+ : { gt: request.cursor ?? range.gt, lt: range.lt };
288
+ for await (const raw of childKeys(drive, { ...options, folder: request.folder, start })) {
289
+ if (signal.aborted) {
290
+ throw new Error('drive list cancelled');
291
+ }
292
+ const child = directChild(request.folder, raw);
293
+ if (current && current.key !== child.key) {
294
+ if (entries.length >= request.limit) {
295
+ cursor = lastEmittedKey;
296
+ break;
297
+ }
298
+ entries.push(current);
299
+ lastEmittedKey = currentLastKey;
300
+ current = child;
301
+ }
302
+ current ??= child;
303
+ currentLastKey = raw.key;
304
+ }
305
+ if (!current || cursor) {
306
+ return { entries, cursor };
307
+ }
308
+ if (entries.length >= request.limit) {
309
+ return { entries, cursor: lastEmittedKey };
310
+ }
311
+ entries.push(current);
312
+ return { entries, cursor };
313
+ }
87
314
  async function handleRequest(acquired, request, signal) {
88
315
  const drive = acquired.drive;
89
316
  switch (request.op) {
90
317
  case 'entry': {
91
- const entry = await drive.entry(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true });
318
+ if (signal.aborted) {
319
+ throw new Error('drive entry cancelled');
320
+ }
321
+ const entry = await waitFor(drive.entry(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true }), signal);
322
+ if (signal.aborted) {
323
+ throw new Error('drive entry cancelled');
324
+ }
92
325
  return { entry: entry ? stripMetadata(entry) : null };
93
326
  }
94
327
  case 'get': {
95
- const entry = await drive.entry(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true });
328
+ const entry = await waitFor(drive.entry(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true }), signal);
329
+ if (signal.aborted) {
330
+ throw new Error('drive get cancelled');
331
+ }
96
332
  if (!entry) {
97
333
  return { path: null };
98
334
  }
99
335
  if ((entry.value.blob?.byteLength ?? 0) > MAX_DRIVE_BYTES) {
100
336
  return { error: `get exceeds ${MAX_DRIVE_BYTES} bytes: ${request.key}` };
101
337
  }
102
- const buffer = await drive.get(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true });
338
+ const buffer = await waitFor(drive.get(request.key, { timeout: DRIVE_OP_TIMEOUT_MS, wait: true }), signal);
339
+ if (signal.aborted) {
340
+ throw new Error('drive get cancelled');
341
+ }
103
342
  if (!buffer) {
104
343
  return { path: null };
105
344
  }
106
345
  const target = await stagedPath('drive-get');
107
- signal.addEventListener('abort', () => void fs.promises.unlink(target).catch(noop), {
108
- once: true
109
- });
110
- await fs.promises.writeFile(target, buffer, { mode: 0o600 });
111
- return { path: target };
346
+ try {
347
+ if (signal.aborted) {
348
+ throw new Error('drive get cancelled');
349
+ }
350
+ await fs.promises.writeFile(target, buffer, { mode: 0o600 });
351
+ if (signal.aborted) {
352
+ throw new Error('drive get cancelled');
353
+ }
354
+ return { path: target };
355
+ }
356
+ catch (err) {
357
+ await fs.promises.unlink(target).catch(noop);
358
+ throw err;
359
+ }
112
360
  }
113
361
  case 'read': {
114
362
  const target = await stagedPath('drive-read');
115
- signal.addEventListener('abort', () => void fs.promises.unlink(target).catch(noop), {
116
- once: true
117
- });
118
- const truncated = await pipeCapped(drive.createReadStream(request.key), target, {
119
- cap: MAX_DRIVE_BYTES,
120
- signal
121
- });
122
- return { path: target, truncated };
363
+ try {
364
+ if (signal.aborted) {
365
+ throw new Error('drive read cancelled');
366
+ }
367
+ const truncated = await pipeCapped(drive.createReadStream(request.key), target, {
368
+ cap: MAX_DRIVE_BYTES,
369
+ signal
370
+ });
371
+ if (signal.aborted) {
372
+ throw new Error('drive read cancelled');
373
+ }
374
+ return { path: target, truncated };
375
+ }
376
+ catch (err) {
377
+ await fs.promises.unlink(target).catch(noop);
378
+ throw err;
379
+ }
123
380
  }
124
381
  case 'list': {
125
382
  const skip = new Set(request.skip);
@@ -128,7 +385,12 @@ async function handleRequest(acquired, request, signal) {
128
385
  const ignore = (key) => key.split('/').some((seg) => skip.has(seg));
129
386
  const range = folderRange(request.folder);
130
387
  const gt = request.cursor ?? range.gt;
131
- for await (const raw of drive.entries({ gt, lt: range.lt }, { ignore })) {
388
+ if (request.recursive === false) {
389
+ return shallowEntries(drive, request, { signal, ignore, range });
390
+ }
391
+ for await (const raw of abortableIterable(drive.entries({ gt, lt: range.lt }, { ignore }), signal)) {
392
+ if (signal.aborted)
393
+ throw new Error('drive list cancelled');
132
394
  entries.push(stripMetadata(raw));
133
395
  if (entries.length >= request.limit) {
134
396
  cursor = raw.key;
@@ -141,20 +403,39 @@ async function handleRequest(acquired, request, signal) {
141
403
  if (!acquired.writable) {
142
404
  return { error: `drive is read-only: cannot write ${request.key}` };
143
405
  }
406
+ const stagingRoot = await fs.promises
407
+ .realpath(HARNESS_STAGING_DIR)
408
+ .catch(() => path.resolve(HARNESS_STAGING_DIR));
144
409
  const resolvedPath = path.resolve(request.path);
145
- if (path.relative(HARNESS_STAGING_DIR, resolvedPath).startsWith('..')) {
410
+ const realPath = await fs.promises.realpath(resolvedPath);
411
+ if (path.relative(stagingRoot, realPath).startsWith('..') || realPath === stagingRoot) {
146
412
  return { error: `write path is outside the staging directory: ${request.path}` };
147
413
  }
148
- const source = Readable.from(fs.createReadStream(resolvedPath));
414
+ if (signal.aborted) {
415
+ throw new Error('drive write cancelled');
416
+ }
417
+ const source = Readable.from(fs.createReadStream(realPath));
149
418
  const sink = drive.createWriteStream(request.key, request.executable ? { executable: true } : undefined);
150
- signal.addEventListener('abort', () => {
419
+ const abort = () => {
151
420
  source.destroy();
152
421
  sink.destroy();
153
- }, { once: true });
154
- await pipelinePromise(source, sink);
155
- await fs.promises.unlink(resolvedPath).catch(noop);
422
+ };
423
+ signal.addEventListener('abort', abort, { once: true });
424
+ try {
425
+ await pipelinePromise(source, sink);
426
+ if (signal.aborted) {
427
+ throw new Error('drive write cancelled');
428
+ }
429
+ await fs.promises.unlink(realPath).catch(noop);
430
+ }
431
+ finally {
432
+ signal.removeEventListener('abort', abort);
433
+ }
156
434
  return {};
157
435
  }
436
+ case 'search': {
437
+ return { error: `drive search is not served: ${request.folder}` };
438
+ }
158
439
  }
159
440
  }
160
441
  export function createDriveOp(drives) {
@@ -1,3 +1,4 @@
1
1
  export declare function isRecord(value: unknown): value is Record<string, unknown>;
2
2
  export declare function errorMessage(err: unknown): string;
3
3
  export declare function asError(err: unknown): Error;
4
+ export declare function safeName(value: string): string;
@@ -7,3 +7,7 @@ export function errorMessage(err) {
7
7
  export function asError(err) {
8
8
  return err instanceof Error ? err : new Error(String(err));
9
9
  }
10
+ export function safeName(value) {
11
+ const fenced = value.replace(/[^A-Za-z0-9._-]/g, '_');
12
+ return /^\.*$/.test(fenced) ? `_${fenced}` : fenced;
13
+ }
@@ -27,13 +27,12 @@ export interface SweepLimits {
27
27
  export interface SweepResult {
28
28
  readonly removed: number;
29
29
  }
30
- export declare function defaultInferenceCallsDir(): string;
31
30
  export declare const MAX_TOTAL_BYTES: number;
32
31
  export declare const MAX_AGE_MS: number;
33
32
  export declare class InferenceCallStore {
34
33
  private readonly _dir;
35
34
  private readonly _writes;
36
- constructor(dir?: string);
35
+ constructor(dir: string);
37
36
  record(chatId: string, entry: InferenceCallEntry): Promise<void>;
38
37
  recordSent(chatId: string, sent: InferenceCallSent): Promise<void>;
39
38
  recordOutcome(chatId: string, verdict: InferenceCallOutcome): Promise<void>;
@@ -1,11 +1,7 @@
1
1
  import fs from 'fs';
2
2
  import { join } from 'path';
3
- import { persistent } from 'bare-storage';
4
3
  import { WriteQueue } from './write-queue.js';
5
- import { isRecord } from './guards.js';
6
- export function defaultInferenceCallsDir() {
7
- return join(persistent(), 'qvac', 'inspector');
8
- }
4
+ import { isRecord, safeName } from './guards.js';
9
5
  const CALLS_FILE = 'calls.jsonl';
10
6
  const BLOCKS_DIR = 'blocks';
11
7
  const MAX_CALLS_BYTES = 8 * 1024 * 1024;
@@ -15,7 +11,7 @@ const MAX_LINES_READ = 600;
15
11
  export class InferenceCallStore {
16
12
  _dir;
17
13
  _writes;
18
- constructor(dir = defaultInferenceCallsDir()) {
14
+ constructor(dir) {
19
15
  this._dir = dir;
20
16
  this._writes = new WriteQueue();
21
17
  }
@@ -271,8 +267,4 @@ async function sizeOf(path) {
271
267
  return null;
272
268
  }
273
269
  }
274
- function safeName(value) {
275
- const fenced = value.replace(/[^A-Za-z0-9._-]/g, '_');
276
- return /^\.*$/.test(fenced) ? `_${fenced}` : fenced;
277
- }
278
270
  function noop() { }
@@ -47,10 +47,7 @@ function prioritizeVaultPicker(setup) {
47
47
  function derivedRoutes(entry) {
48
48
  const routes = [];
49
49
  for (const key of credentialKeysFor(entry)) {
50
- const route = credentialRoute(key);
51
- if (route) {
52
- routes.push(route);
53
- }
50
+ routes.push(credentialRoute(key));
54
51
  }
55
52
  const install = installRoute(entry);
56
53
  if (install) {
@@ -79,7 +76,12 @@ function credentialRoute(credentialKey) {
79
76
  fields: [{ key: credentialKey, label: token.label, secret: true, required: true }]
80
77
  };
81
78
  }
82
- return null;
79
+ return {
80
+ kind: SETUP_ROUTE_KIND.token,
81
+ label: `Enter ${credentialKey}`,
82
+ credentialKey,
83
+ fields: [{ key: credentialKey, label: credentialKey, secret: true, required: true }]
84
+ };
83
85
  }
84
86
  function installRoute(entry) {
85
87
  const steps = entry.metadata.install ?? [];
@@ -5,4 +5,4 @@ export interface SearchKnowledgeOptions {
5
5
  readonly signal: AbortSignal;
6
6
  readonly preparing: (active: boolean) => void;
7
7
  }
8
- export declare function searchKnowledge(engine: Pick<ScopedCapabilities, 'ragSearch' | 'fileStatusWatch'>, request: Omit<AssistantRagSearchRequest, 'meshId'>, options: SearchKnowledgeOptions): Promise<AssistantRagSearchResponse>;
8
+ export declare function searchKnowledge(engine: Pick<ScopedCapabilities, 'ragSearch'>, request: Omit<AssistantRagSearchRequest, 'meshId'>, options: SearchKnowledgeOptions): Promise<AssistantRagSearchResponse>;
@@ -1,61 +1,15 @@
1
- import { isWholeDocumentQuery, referencedDocuments } from './core/files/index.js';
2
1
  import { raceAbort } from '@qvac/harness/race-abort';
3
2
  export async function searchKnowledge(engine, request, options) {
4
3
  const { signal, preparing } = options;
5
- const search = await raceAbort(engine.ragSearch(request), signal);
6
- if (!search.enabled || !search.hasKnowledge || !search.pendingFiles?.length) {
4
+ const search = await raceAbort(engine.ragSearch({ ...request, immediate: true }), signal);
5
+ if (!search.enabled || !search.hasKnowledge || !search.chatFilesIndexingHere) {
7
6
  return search;
8
7
  }
9
- const watch = engine.fileStatusWatch({ chatId: request.chatId });
10
- const iterator = watch[Symbol.asyncIterator]();
11
- let wanted = null;
12
- let waiting = false;
8
+ preparing(true);
13
9
  try {
14
- while (true) {
15
- const next = await raceAbort(iterator.next(), signal);
16
- if (next.done) {
17
- throw new Error('file status closed while preparing documents');
18
- }
19
- const files = next.value.files;
20
- const ids = (wanted ??= wantedFileIds(request, { files, pendingFiles: search.pendingFiles }));
21
- if (ids.size === 0) {
22
- return search;
23
- }
24
- if (!files.some((file) => ids.has(file.fileId) && pending(file))) {
25
- return await raceAbort(engine.ragSearch(request), signal);
26
- }
27
- if (!waiting) {
28
- waiting = true;
29
- preparing(true);
30
- }
31
- }
10
+ return await raceAbort(engine.ragSearch(request), signal);
32
11
  }
33
12
  finally {
34
- watch.destroy();
35
- if (waiting) {
36
- preparing(false);
37
- }
13
+ preparing(false);
38
14
  }
39
15
  }
40
- function pending(file) {
41
- const rag = file.processors.find((processor) => processor.processorId === 'rag');
42
- return (!file.readyForChat &&
43
- ['pending', 'running', 'uploading'].includes(file.state) &&
44
- rag?.state !== 'not-applicable');
45
- }
46
- function wantedFileIds(request, { files, pendingFiles }) {
47
- const named = referencedDocuments(request.query, files.map((file) => ({ ...file, title: file.fileName })));
48
- const requested = requestedFiles(request, { files, named });
49
- return new Set(requested.filter((file) => pendingFiles.includes(file.fileName)).map((file) => file.fileId));
50
- }
51
- function requestedFiles(request, opts) {
52
- const { files, named } = opts;
53
- const { attachmentIds } = request;
54
- if (attachmentIds?.length) {
55
- return files.filter((file) => attachmentIds.includes(file.fileId));
56
- }
57
- if (named.length) {
58
- return named;
59
- }
60
- return isWholeDocumentQuery(request.query) ? files : [];
61
- }
@@ -0,0 +1,22 @@
1
+ export interface LedgerEntry {
2
+ readonly chatId: string;
3
+ readonly meshId: string;
4
+ readonly served?: boolean;
5
+ }
6
+ export interface KnownChats {
7
+ readonly live: ReadonlySet<string>;
8
+ readonly read: ReadonlySet<string>;
9
+ readonly closed: ReadonlySet<string>;
10
+ readonly gone: ReadonlySet<string>;
11
+ }
12
+ export declare function orphanedChats(entries: ReadonlyArray<LedgerEntry>, { live, read, closed, gone }: KnownChats): string[];
13
+ export declare class KvCacheLedger {
14
+ private readonly _dir;
15
+ private readonly _recorded;
16
+ constructor(dir: string);
17
+ record({ chatId, meshId, served }: LedgerEntry): Promise<void>;
18
+ forget(chatId: string): Promise<void>;
19
+ clear(): Promise<void>;
20
+ entries(): Promise<LedgerEntry[]>;
21
+ private _file;
22
+ }