@qvac/core 1.0.0-rc.0 → 1.0.0-rc.10

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 +1203 -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 +18 -4
  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 +74 -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
@@ -0,0 +1,44 @@
1
+ import { isWholeDocumentQuery, resolveTargetDocument, selectCoverage } from '../core/files/index.js';
2
+ const INJECTED = 5;
3
+ const COVERAGE_CHUNKS = 512;
4
+ export async function searchPlugin(search) {
5
+ const { query, documents, scopeDocumentIds, limit } = search;
6
+ if (limit !== undefined) {
7
+ return { hits: await find(search, { k: limit, focus: documents }), targetDocumentId: null };
8
+ }
9
+ const attached = scopeDocumentIds.length > 0;
10
+ const targetDocumentId = attached ? null : resolveTargetDocument(query, documents);
11
+ const targets = attached ? scopeDocumentIds : [targetDocumentId].flatMap((id) => (id ? [id] : []));
12
+ const whole = isWholeDocumentQuery(query);
13
+ if (targets.length === 0 && !whole) {
14
+ return { hits: await find(search, { k: INJECTED }), targetDocumentId };
15
+ }
16
+ const focused = targets.length
17
+ ? documents.filter((document) => targets.includes(document.documentId))
18
+ : documents;
19
+ if (!whole) {
20
+ const hits = await find(search, { k: INJECTED, focus: focused, only: attached });
21
+ return { hits, targetDocumentId };
22
+ }
23
+ const chunks = focused.reduce((sum, document) => sum + document.index.chunksOf(document.documentId), 0);
24
+ const k = Math.min(Math.max(chunks, INJECTED), COVERAGE_CHUNKS);
25
+ const hits = await find(search, { k, focus: focused, only: true });
26
+ return { hits: selectCoverage(hits, { budgetTokens: search.budgetTokens }), targetDocumentId };
27
+ }
28
+ async function find(search, { k, focus = [], only = false }) {
29
+ const owner = search.documents[0]?.index;
30
+ if (!owner) {
31
+ return [];
32
+ }
33
+ const allowed = new Set((only ? focus : search.documents).map((document) => document.index.pluginId(document.documentId)));
34
+ const hits = await owner.find({
35
+ text: search.query,
36
+ scopes: search.scopes,
37
+ focus: focus.map((document) => document.index.pluginId(document.documentId)),
38
+ k
39
+ });
40
+ return hits.filter((hit) => allowed.has(hit.artifactId)).map(withoutArtifact);
41
+ }
42
+ function withoutArtifact({ artifactId: _artifactId, ...hit }) {
43
+ return hit;
44
+ }
@@ -1,4 +1,3 @@
1
- import '../logger.ts';
2
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
2
  import type { QvacAgent } from '../../spec/mesh/hyperschema/types.d.ts';
4
3
  import { type IndexingEmbedder, type VectorIndex } from '../core/files/index.ts';
@@ -1,10 +1,12 @@
1
- import '../logger.js';
2
1
  import { toolsetEnabled } from '@qvac/harness/lib/tools/toolsets.ts';
3
2
  import { getAgent } from '../core/agent.js';
3
+ import { runDefinition } from '../core/shared-agents.js';
4
4
  import { getChat } from '../core/chat.js';
5
- import { isKnowledgeRoutedAttachment, fullTextBudgetChars, fullTextHits, retrieveRagKnowledge, searchRagChunks, referencesPendingFile, referencedDocuments } from '../core/files/index.js';
5
+ import { isKnowledgeRoutedAttachment, fullTextBudgetChars, fullTextHits, joinedIndex, retrievalBudgetTokens, retrieveRagKnowledge, searchRagChunks, referencesPendingFile, PluginVectorIndex } from '../core/files/index.js';
6
6
  import { requireMesh } from './current-mesh.js';
7
+ import { searchPlugin } from './rag-plugin.js';
7
8
  import { errorMessage } from '../guards.js';
9
+ import b4a from 'b4a';
8
10
  export const MAX_RAG_SEARCH_LIMIT = 20;
9
11
  const DEFAULT_RAG_SEARCH_LIMIT = 5;
10
12
  function clampLimit(limit) {
@@ -14,21 +16,44 @@ function clampLimit(limit) {
14
16
  }
15
17
  export function createRagApi(pool, { index, embedder, effectiveCtxSize = null }) {
16
18
  return {
17
- ragSearch: async ({ chatId, query, mode, limit, attachmentIds, meshId }) => {
19
+ ragSearch: async ({ chatId, query, mode, limit, attachmentIds, meshId, immediate }) => {
18
20
  let pendingFiles = [];
19
- const respond = (overrides) => response({ pendingFiles, ...overrides });
21
+ let projectFilesNotReady = 0;
22
+ let chatFilesIndexingHere = 0;
23
+ const respond = (overrides) => {
24
+ const result = response({
25
+ pendingFiles,
26
+ projectFilesNotReady,
27
+ chatFilesIndexingHere,
28
+ ...overrides
29
+ });
30
+ return { ...result, chatFilesNotReady: result.pendingFiles?.length ?? 0 };
31
+ };
20
32
  const mesh = await requireMesh(pool, meshId);
21
33
  const chat = await getChat(mesh, chatId);
22
34
  const toolMode = mode === 'tool';
23
35
  if (!chat) {
24
36
  return respond({ enabled: false });
25
37
  }
26
- const agent = await getAgent(mesh, chat.agentId);
27
- let rows = await mesh.files.listKnowledge(chatId);
28
- const initialFiles = (await mesh.files.status(chatId)).files;
29
- pendingFiles = pendingFileNames(initialFiles);
38
+ const agent = await runDefinition(mesh, await getAgent(mesh, chat.agentId));
30
39
  const scopeIds = new Set(toolMode ? [] : (attachmentIds ?? []));
31
- let scopeRows = rows.filter((row) => scopeIds.has(row.id));
40
+ const off = new Set(chat.knowledgeSourcesOff ?? []);
41
+ const kept = (id) => !off.has('chat') || scopeIds.has(id);
42
+ const chatKnowledge = async () => (await mesh.files.listKnowledge(chatId)).filter((row) => kept(row.id));
43
+ const chatFiles = async () => (await mesh.files.status(chatId)).files.filter((file) => kept(file.fileId));
44
+ const indexingHere = (files) => files.filter((file) => scopeIds.has(file.fileId) && mesh.files.indexesHere(file)).length;
45
+ if (!immediate && scopeIds.size > 0) {
46
+ await mesh.files.indexingHere(chatId, [...scopeIds]);
47
+ }
48
+ const chatRows = await chatKnowledge();
49
+ const initialFiles = await chatFiles();
50
+ pendingFiles = pendingFileNames(initialFiles);
51
+ chatFilesIndexingHere = indexingHere(initialFiles);
52
+ const scopeRows = chatRows.filter((row) => scopeIds.has(row.id));
53
+ const project = off.has('project') || mesh.role !== 'project' ? null : mesh;
54
+ const kbEntries = project ? ((await project.files.knowledgeBase()).entries ?? []) : [];
55
+ const kbRows = kbEntries.filter((entry) => entry.loaded).map((entry) => entry.knowledge);
56
+ projectFilesNotReady = kbEntries.filter((entry) => !entry.loaded && entry.status !== 'failed').length;
32
57
  if (scopeIds.size > 0 && scopeRows.length === scopeIds.size) {
33
58
  const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
34
59
  const fullText = await fullTextHits(mesh, scopeRows, {
@@ -36,8 +61,10 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
36
61
  head: !agentAllowsRagSearch(agent)
37
62
  });
38
63
  if (fullText) {
64
+ const read = new Set(scopeRows.map((row) => row.id));
39
65
  return respond({
40
- pendingFiles: pendingFileNames(initialFiles, new Set(scopeRows.map((row) => row.id))),
66
+ pendingFiles: pendingFileNames(initialFiles, read),
67
+ chatFilesIndexingHere: 0,
41
68
  searchedCount: fullText.length,
42
69
  indexEmpty: false,
43
70
  hasKnowledge: true,
@@ -49,30 +76,27 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
49
76
  if (!toolMode && !agentAllowsRagSearch(agent)) {
50
77
  return respond({ enabled: false });
51
78
  }
52
- if (rows.length === 0) {
79
+ if (chatRows.length === 0 && kbRows.length === 0) {
53
80
  return respond({});
54
81
  }
55
- const namedRows = referencedDocuments(query, rows.map((row) => ({ id: row.id, title: row.fileName })));
56
- const unscoped = namedRows.length ? namedRows : rows;
57
- const requested = scopeIds.size ? scopeRows : unscoped;
58
- const waiting = requested.filter((row) => !mesh.files.hydratedArtifact(row.id));
59
- if (waiting.length) {
60
- try {
61
- await mesh.files.settle(waiting.map((row) => row.id));
62
- }
63
- catch (err) {
64
- logger.warn('rag', 'indexing settle failed', { err });
65
- }
66
- rows = await mesh.files.listKnowledge(chatId);
67
- scopeRows = rows.filter((row) => scopeIds.has(row.id));
68
- }
82
+ const rows = [...chatRows, ...kbRows];
69
83
  const hasKnowledge = rows.length > 0;
70
- const vectorIndex = index(meshId);
84
+ const chatIndex = index(meshId);
71
85
  const embed = embedder(meshId);
72
- if (!vectorIndex || !embed) {
86
+ if (!chatIndex || !embed) {
73
87
  return respond({ hasKnowledge, errorMessage: 'knowledge index unavailable on this device' });
74
88
  }
75
- const artifactByRow = new Map(rows.map((row) => [row, mesh.files.hydratedArtifact(row.id)]));
89
+ const projectIndex = project && kbRows.length ? index(b4a.toHex(project.key)) : null;
90
+ const vectorIndex = projectIndex
91
+ ? joinedIndex([chatIndex, projectIndex], {
92
+ chatId,
93
+ knowledgeBaseIds: new Set(kbRows.map((row) => row.id))
94
+ })
95
+ : chatIndex;
96
+ const artifactByRow = new Map([
97
+ ...chatRows.map((row) => [row, mesh.files.hydratedArtifact(row.id)]),
98
+ ...kbRows.map((row) => [row, project?.files.hydratedArtifact(row.id) ?? null])
99
+ ]);
76
100
  const hydratedDocuments = [];
77
101
  for (const [row, artifactId] of artifactByRow) {
78
102
  if (artifactId) {
@@ -82,11 +106,12 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
82
106
  const indexEmpty = hydratedDocuments.length === 0;
83
107
  const availableFiles = [...new Set(hydratedDocuments.map((document) => document.title))];
84
108
  const failedRows = new Set();
85
- const fileStates = (await mesh.files.status(chatId)).files;
109
+ const fileStates = await chatFiles();
110
+ const statusById = new Map(fileStates.map((file) => [file.fileId, file]));
86
111
  for (const row of rows) {
87
112
  if (artifactByRow.get(row))
88
113
  continue;
89
- if (fileStates.find((file) => file.fileId === row.id)?.state === 'failed') {
114
+ if (statusById.get(row.id)?.state === 'failed') {
90
115
  failedRows.add(row);
91
116
  }
92
117
  }
@@ -112,6 +137,14 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
112
137
  failedFiles
113
138
  });
114
139
  }
140
+ if (scopeIds.size > 0 && scopeDocumentIds.length === 0) {
141
+ return respond({
142
+ indexEmpty,
143
+ hasKnowledge,
144
+ availableFiles,
145
+ failedFiles
146
+ });
147
+ }
115
148
  const pendingReferenced = scopeDocumentIds.length === 0 &&
116
149
  referencesPendingFile(query, rows.map((row) => ({
117
150
  title: row.fileName,
@@ -140,6 +173,44 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
140
173
  failedFiles: rows.map((row) => row.fileName)
141
174
  });
142
175
  }
176
+ if (chatIndex instanceof PluginVectorIndex) {
177
+ const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
178
+ const documents = [...artifactByRow].flatMap(([row, artifactId]) => {
179
+ const owner = kbRows.includes(row) ? projectIndex : chatIndex;
180
+ return artifactId && owner instanceof PluginVectorIndex
181
+ ? [{ documentId: artifactId, title: row.fileName, index: owner }]
182
+ : [];
183
+ });
184
+ const scopes = [
185
+ ...(chatRows.length > 0 ? [chatIndex.scope(chatId)] : []),
186
+ ...(kbRows.length > 0 && projectIndex instanceof PluginVectorIndex
187
+ ? [projectIndex.scope(null)]
188
+ : [])
189
+ ];
190
+ try {
191
+ const found = await searchPlugin({
192
+ query,
193
+ scopes,
194
+ documents,
195
+ scopeDocumentIds,
196
+ budgetTokens: retrievalBudgetTokens(ctxSize),
197
+ limit: toolMode ? clampLimit(limit) : undefined
198
+ });
199
+ const hits = found.hits.map(toWireHit);
200
+ const searched = { searchedCount: hits.length, indexEmpty, hasKnowledge, availableFiles };
201
+ return toolMode
202
+ ? respond({ ...searched, hits })
203
+ : respond({ ...searched, targetDocumentId: found.targetDocumentId, failedFiles, hits });
204
+ }
205
+ catch (err) {
206
+ return respond({
207
+ indexEmpty,
208
+ hasKnowledge,
209
+ availableFiles,
210
+ errorMessage: errorMessage(err)
211
+ });
212
+ }
213
+ }
143
214
  if (toolMode) {
144
215
  try {
145
216
  const hits = await searchRagChunks({
@@ -150,7 +221,7 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
150
221
  }, {
151
222
  index: vectorIndex,
152
223
  embed: (texts) => embed.embed({ texts }),
153
- debug: (message) => logger.debug('rag', message)
224
+ debug: (message) => mesh.log?.debug('rag', message)
154
225
  });
155
226
  return respond({
156
227
  searchedCount: hits.length,
@@ -170,16 +241,18 @@ export function createRagApi(pool, { index, embedder, effectiveCtxSize = null })
170
241
  }
171
242
  }
172
243
  try {
244
+ const ctxSize = effectiveCtxSize ? await effectiveCtxSize(agent) : 0;
173
245
  const result = await retrieveRagKnowledge({
174
246
  query,
175
247
  chatId,
176
248
  documents: hydratedDocuments,
177
249
  liveSourceIds: rows.map((row) => row.id),
178
- scopeDocumentIds: scopeDocumentIds.length > 0 ? scopeDocumentIds : undefined
250
+ scopeDocumentIds: scopeDocumentIds.length > 0 ? scopeDocumentIds : undefined,
251
+ chunkBudgetTokens: retrievalBudgetTokens(ctxSize)
179
252
  }, {
180
253
  index: vectorIndex,
181
254
  embed: (texts) => embed.embed({ texts }),
182
- debug: (message) => logger.debug('rag', message)
255
+ debug: (message) => mesh.log?.debug('rag', message)
183
256
  });
184
257
  return respond({
185
258
  searchedCount: result.searchedCount,
@@ -0,0 +1,17 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import type { AssistantMeshList } from '../../spec/hyperschema/types.d.ts';
3
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
4
+ import { type MeshPool } from './current-mesh.ts';
5
+ import type { MeshStatusSource } from './mesh.ts';
6
+ export declare const SERVED_ROUTES: readonly ["listMeshes", "meshesWatch", "listChats", "chatsWatch", "listChunks", "chunksWatch", "appendChunk", "modelRequestsWatch", "takeModelRequest", "settleModelRequest"];
7
+ export type ServedRoutes = Pick<CapabilityHandlers, (typeof SERVED_ROUTES)[number]>;
8
+ export interface ServedOptions {
9
+ readonly pool: MeshPool;
10
+ readonly local: Partial<Pick<CapabilityHandlers, 'listChats' | 'chatsWatch' | 'appendChunk'>>;
11
+ readonly foreign: (meshId: string) => boolean;
12
+ readonly status: Pick<MeshStatusSource, 'watch' | 'unwatch'>;
13
+ readonly list: () => Promise<AssistantMeshList>;
14
+ readonly deviceId: Buffer | null;
15
+ readonly log: LoggerInterface | null;
16
+ }
17
+ export declare function createServedApi({ pool, local, foreign, status, list, deviceId, log }: ServedOptions): ServedRoutes;
@@ -0,0 +1,65 @@
1
+ import { lastActivity } from '../core/chat.js';
2
+ import { readChunk } from '../core/chunk.js';
3
+ import { listModelRequests } from '../core/model-requests.js';
4
+ import { servedChats } from '../core/public-mesh.js';
5
+ import { createChunksApi } from './chunks.js';
6
+ import { requireMesh, routed } from './current-mesh.js';
7
+ import { watchable } from './watchable.js';
8
+ export const SERVED_ROUTES = [
9
+ 'listMeshes',
10
+ 'meshesWatch',
11
+ 'listChats',
12
+ 'chatsWatch',
13
+ 'listChunks',
14
+ 'chunksWatch',
15
+ 'appendChunk',
16
+ 'modelRequestsWatch',
17
+ 'takeModelRequest',
18
+ 'settleModelRequest'
19
+ ];
20
+ export function createServedApi({ pool, local, foreign, status, list, deviceId, log }) {
21
+ const chunks = createChunksApi(routed(pool, 'append-chunk'), deviceId, { log });
22
+ const chatsWatch = watchable(({ meshId }) => requireMesh(pool, meshId, { follow: true, wide: true }), async (_request, mesh) => ({
23
+ chats: (deviceId ? await servedChats(mesh, deviceId) : []).map(({ id, agentId, title, createdAt }) => ({
24
+ id,
25
+ agentId,
26
+ title,
27
+ createdAt
28
+ }))
29
+ }), { name: 'chatsWatch', log });
30
+ const rounds = watchable(({ meshId }) => requireMesh(pool, meshId, { follow: true, wide: true }), async (_request, mesh) => {
31
+ const chats = new Set((deviceId ? await servedChats(mesh, deviceId) : []).map(({ id }) => id));
32
+ const live = await listModelRequests(mesh);
33
+ return { chunks: live.filter((round) => chats.has(round.chatId)).map(readChunk) };
34
+ }, { name: 'modelRequestsWatch', log });
35
+ const listChats = async ({ meshId }) => {
36
+ const mesh = await requireMesh(pool, meshId, { wide: true });
37
+ return { chats: deviceId ? await servedListing(mesh, deviceId) : [] };
38
+ };
39
+ const { listChats: ownList = listChats, chatsWatch: ownChats = chatsWatch, appendChunk: ownAppend = chunks.appendChunk } = local;
40
+ return {
41
+ listMeshes: list,
42
+ meshesWatch: watchable(() => status, list, {
43
+ name: 'meshesWatch',
44
+ log
45
+ }),
46
+ listChats: (request) => (foreign(request.meshId) ? listChats(request) : ownList(request)),
47
+ chatsWatch: (request) => (foreign(request.meshId) ? chatsWatch(request) : ownChats(request)),
48
+ listChunks: chunks.listChunks,
49
+ chunksWatch: chunks.chunksWatch,
50
+ appendChunk: (request) => foreign(request.meshId) ? chunks.appendChunk(request) : ownAppend(request),
51
+ modelRequestsWatch: (request) => foreign(request.meshId) ? rounds(request) : chunks.modelRequestsWatch(request),
52
+ takeModelRequest: chunks.takeModelRequest,
53
+ settleModelRequest: chunks.settleModelRequest
54
+ };
55
+ }
56
+ async function servedListing(mesh, deviceId) {
57
+ const activity = await lastActivity(mesh.view);
58
+ return (await servedChats(mesh, deviceId)).map(({ id, agentId, title, createdAt }) => ({
59
+ id,
60
+ agentId,
61
+ title,
62
+ createdAt,
63
+ lastActivityAt: activity.get(id) || createdAt
64
+ }));
65
+ }
@@ -1,3 +1,4 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { type MeshPool } from './current-mesh.ts';
3
- export declare function createSyncApi(pool: MeshPool): Pick<CapabilityHandlers, 'syncStatusWatch'>;
4
+ export declare function createSyncApi(pool: MeshPool, log: LoggerInterface | null): Pick<CapabilityHandlers, 'syncStatusWatch'>;
@@ -1,7 +1,17 @@
1
- import { requireMesh } from './current-mesh.js';
1
+ import { isCoreError } from '../errors.js';
2
+ import { requireMesh, routed } from './current-mesh.js';
2
3
  import { watchable } from './watchable.js';
3
- export function createSyncApi(pool) {
4
+ export function createSyncApi(pool, log) {
5
+ const chats = routed(pool, 'append-chunk');
4
6
  return {
5
- syncStatusWatch: watchable(async (request) => (await requireMesh(pool, request.meshId)).syncActivity ?? null, (_request, activity) => activity.snapshot(), { name: 'syncStatusWatch' })
7
+ syncStatusWatch: watchable(async (request) => {
8
+ const mesh = await requireMesh(chats, request.meshId, { follow: true }).catch((err) => {
9
+ if (isCoreError(err, 'ROUTE_NEEDS_WORKSPACE')) {
10
+ return requireMesh(pool, request.meshId, { follow: true });
11
+ }
12
+ throw err;
13
+ });
14
+ return mesh.syncActivity ?? null;
15
+ }, (_request, activity) => activity.snapshot(), { name: 'syncStatusWatch', log })
6
16
  };
7
17
  }
@@ -1,5 +1,6 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { type MeshPool } from './current-mesh.ts';
3
4
  type ToolActivityCapabilities = Pick<CapabilityHandlers, 'listToolActivity' | 'toolActivityWatch' | 'recordToolActivity'>;
4
- export declare function createToolActivityApi(pool: MeshPool, deviceId: Buffer | null): ToolActivityCapabilities;
5
+ export declare function createToolActivityApi(pool: MeshPool, deviceId: Buffer | null, log: LoggerInterface | null): ToolActivityCapabilities;
5
6
  export {};
@@ -1,6 +1,7 @@
1
1
  import { listToolActivity, recordToolActivity } from '../core/tool-activity.js';
2
2
  import { meshWatchable, requireMesh } from './current-mesh.js';
3
3
  import { bounds } from './range.js';
4
+ import { CoreError } from '../errors.js';
4
5
  import b4a from 'b4a';
5
6
  const DEFAULT_LIMIT = 200;
6
7
  const MAX_LIMIT = 1000;
@@ -27,7 +28,7 @@ function toEntry(row) {
27
28
  seq: row.seq ?? 0
28
29
  };
29
30
  }
30
- export function createToolActivityApi(pool, deviceId) {
31
+ export function createToolActivityApi(pool, deviceId, log) {
31
32
  const query = async ({ agentId, ...input }, mesh) => ({
32
33
  activities: (await listToolActivity(mesh, agentId, {
33
34
  ...bounds(input),
@@ -36,10 +37,10 @@ export function createToolActivityApi(pool, deviceId) {
36
37
  });
37
38
  return {
38
39
  listToolActivity: async (request) => query(request, await requireMesh(pool, request.meshId)),
39
- toolActivityWatch: meshWatchable(pool, query, { name: 'toolActivityWatch' }),
40
+ toolActivityWatch: meshWatchable(pool, query, { name: 'toolActivityWatch', log }),
40
41
  recordToolActivity: async (request) => {
41
42
  if (!deviceId) {
42
- throw new Error('cannot record tool activity without a device id');
43
+ throw new CoreError('DEVICE_ID_UNAVAILABLE');
43
44
  }
44
45
  return recordToolActivity(await requireMesh(pool, request.meshId), {
45
46
  agentId: request.agentId,
@@ -1,6 +1,7 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  import { getToolConfigs } from '../core/tool-configs.ts';
3
4
  import { type MeshPool } from './current-mesh.ts';
4
5
  type ToolConfigsCapabilities = Pick<CapabilityHandlers, 'setToolConfigs' | 'deleteToolConfigs' | 'listToolConfigs' | 'toolConfigsWatch'>;
5
- export declare function createToolConfigsApi(pool: MeshPool): ToolConfigsCapabilities;
6
+ export declare function createToolConfigsApi(pool: MeshPool, log: LoggerInterface | null): ToolConfigsCapabilities;
6
7
  export { getToolConfigs };
@@ -1,24 +1,21 @@
1
1
  import { deleteToolConfigs, getToolConfigs, listToolConfigs, setToolConfigs } from '../core/tool-configs.js';
2
2
  import { meshWatchable, requireMesh } from './current-mesh.js';
3
+ import { CoreError } from '../errors.js';
3
4
  import { isRecord } from '../guards.js';
4
5
  function ensureSettingsPayload(value) {
5
6
  if (!isRecord(value))
6
- throw new Error('tool configs must be a plain object');
7
+ throw new CoreError('TOOL_CONFIGS_INVALID');
7
8
  return value;
8
9
  }
9
- export function createToolConfigsApi(pool) {
10
+ export function createToolConfigsApi(pool, log) {
10
11
  const query = async ({ agentId }, mesh) => ({
11
12
  configs: await listToolConfigs(mesh, agentId)
12
13
  });
13
14
  return {
14
- setToolConfigs: async ({ agentId, toolName, settings, meshId }) => setToolConfigs(await requireMesh(pool, meshId), {
15
- agentId,
16
- toolName,
17
- settings: ensureSettingsPayload(settings)
18
- }),
19
- deleteToolConfigs: async ({ agentId, toolName, meshId }) => deleteToolConfigs(await requireMesh(pool, meshId), agentId, toolName),
15
+ setToolConfigs: async ({ agentId, toolName, settings, meshId }) => setToolConfigs(await requireMesh(pool, meshId), { agentId, toolName, settings: ensureSettingsPayload(settings) }, await requireMesh(pool, meshId, { route: 'put-agent' })),
16
+ deleteToolConfigs: async ({ agentId, toolName, meshId }) => deleteToolConfigs(await requireMesh(pool, meshId), { agentId, toolName }, await requireMesh(pool, meshId, { route: 'put-agent' })),
20
17
  listToolConfigs: async (request) => query(request, await requireMesh(pool, request.meshId)),
21
- toolConfigsWatch: meshWatchable(pool, query, { name: 'toolConfigsWatch' })
18
+ toolConfigsWatch: meshWatchable(pool, query, { name: 'toolConfigsWatch', log })
22
19
  };
23
20
  }
24
21
  export { getToolConfigs };
@@ -1,5 +1,4 @@
1
1
  import type { HandlerFrames } from '../../spec/capabilities.d.ts';
2
- export declare const UPLOAD_NAMES_NO_MESH = "an upload must name its mesh on its first frame";
3
2
  export type UploadFrames<Frame> = AsyncIterable<Frame> | HandlerFrames<Frame>;
4
3
  export interface OpenedUpload<Frame> {
5
4
  readonly first: Frame;
@@ -1,5 +1,4 @@
1
1
  import { toAsyncIterable } from '../core/async-iterable.js';
2
- export const UPLOAD_NAMES_NO_MESH = 'an upload must name its mesh on its first frame';
3
2
  export async function openUpload(frames) {
4
3
  const iterator = toAsyncIterable(frames)[Symbol.asyncIterator]();
5
4
  const first = await iterator.next();
@@ -1,5 +1,5 @@
1
1
  import { Readable } from 'streamx';
2
- import '../logger.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
3
  export declare function snapshotEquals(a: unknown, b: unknown): boolean;
4
4
  interface WatchableStore {
5
5
  watch(listener: () => void): void;
@@ -12,7 +12,8 @@ interface WatchableStore {
12
12
  }
13
13
  export interface WatchableOptions {
14
14
  readonly name: string;
15
+ readonly log: LoggerInterface | null;
15
16
  readonly changes?: WatchableStore;
16
17
  }
17
- export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
+ export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, { name, log, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
18
19
  export {};
@@ -1,7 +1,6 @@
1
1
  import b4a from 'b4a';
2
2
  import { Readable } from 'streamx';
3
3
  import { frameReadable } from '../frame-readable.js';
4
- import '../logger.js';
5
4
  import { asError, isRecord } from '../guards.js';
6
5
  const SCOPE = ['api', 'watch'];
7
6
  const CHURN_WINDOW_MS = 30_000;
@@ -26,7 +25,7 @@ export function snapshotEquals(a, b) {
26
25
  }
27
26
  return keys.every((key) => snapshotEquals(a[key], b[key]));
28
27
  }
29
- export function watchable(storeOf, query, { name, changes }) {
28
+ export function watchable(storeOf, query, { name, log, changes }) {
30
29
  return (request) => {
31
30
  const resolved = storeOf(request);
32
31
  const pending = resolved instanceof Promise ? resolved.catch(noop) : null;
@@ -45,7 +44,7 @@ export function watchable(storeOf, query, { name, changes }) {
45
44
  if (!force && elapsed < CHURN_WINDOW_MS) {
46
45
  return;
47
46
  }
48
- logger.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
47
+ log?.debug(SCOPE, `${name} woke with no change`, { woke: churn, ms: elapsed });
49
48
  churn = 0;
50
49
  reportedAt = now;
51
50
  };
@@ -0,0 +1,12 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
2
+ import { type MeshPool } from './current-mesh.ts';
3
+ import type { MeshStatusSource } from './mesh.ts';
4
+ import type { NameOf } from './projects.ts';
5
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
6
+ type Status = Pick<MeshStatusSource, 'createWorkspace' | 'name' | 'leaveWorkspace' | 'upgradeSummary' | 'watch' | 'unwatch'>;
7
+ interface WorkspaceOptions {
8
+ readonly nameOf: NameOf;
9
+ readonly log: LoggerInterface | null;
10
+ }
11
+ export declare function createWorkspaceApi(pool: MeshPool, status: Status, { nameOf, log }: WorkspaceOptions): Pick<CapabilityHandlers, 'createWorkspace' | 'getWorkspace' | 'workspaceWatch' | 'updateWorkspace' | 'leaveWorkspace' | 'workspaceUpgradeSummary'>;
12
+ export {};
@@ -0,0 +1,61 @@
1
+ import { WORKSPACE_ROW, readWorkspace } from '../core/contract/workspace.js';
2
+ import { readView } from '../core/view-read.js';
3
+ import { isCoreError } from '../errors.js';
4
+ import { meshWatchable, requireMesh } from './current-mesh.js';
5
+ import { requireOurAdmin, requireWorkspace } from './members.js';
6
+ async function heldWorkspace(mesh) {
7
+ try {
8
+ return await readView(mesh, readWorkspace);
9
+ }
10
+ catch (err) {
11
+ if (isCoreError(err, 'MESH_VIEW_UNAVAILABLE')) {
12
+ return null;
13
+ }
14
+ throw err;
15
+ }
16
+ }
17
+ async function read(mesh, meshId, nameOf) {
18
+ requireWorkspace(mesh, meshId);
19
+ const row = await heldWorkspace(mesh);
20
+ return { meshId, name: nameOf(mesh.key)?.name ?? '', icon: row?.icon || undefined };
21
+ }
22
+ export function createWorkspaceApi(pool, status, { nameOf, log }) {
23
+ return {
24
+ createWorkspace: async (request) => {
25
+ const meshId = await status.createWorkspace({
26
+ name: request?.config?.name ?? undefined,
27
+ icon: request?.config?.icon ?? undefined
28
+ });
29
+ return read(await requireMesh(pool, meshId), meshId, nameOf);
30
+ },
31
+ getWorkspace: async ({ meshId }) => read(await requireMesh(pool, meshId), meshId, nameOf),
32
+ workspaceWatch: meshWatchable(pool, ({ meshId }, mesh) => read(mesh, meshId, nameOf), { name: 'workspaceWatch', log, changes: status }),
33
+ updateWorkspace: async (request) => {
34
+ const mesh = await requireMesh(pool, request.meshId);
35
+ await update(mesh, request, status);
36
+ return read(mesh, request.meshId, nameOf);
37
+ },
38
+ leaveWorkspace: async ({ meshId }) => {
39
+ await status.leaveWorkspace(meshId);
40
+ return { ok: true };
41
+ },
42
+ workspaceUpgradeSummary: () => status.upgradeSummary()
43
+ };
44
+ }
45
+ async function update(mesh, { meshId, config }, status) {
46
+ requireWorkspace(mesh, meshId);
47
+ await requireOurAdmin(mesh, 'edit the workspace');
48
+ if (config.name) {
49
+ await status.name(meshId, config.name);
50
+ }
51
+ if (config.icon) {
52
+ const existing = await readWorkspace(mesh.view);
53
+ await mesh.dispatch('put-workspace', {
54
+ workspace: {
55
+ id: WORKSPACE_ROW,
56
+ icon: config.icon,
57
+ updatedAt: Math.max(Date.now(), (existing?.updatedAt ?? 0) + 1)
58
+ }
59
+ });
60
+ }
61
+ }
@@ -0,0 +1,20 @@
1
+ import type { openLocalStore } from '../core/local/index.ts';
2
+ import type { Harness } from './harness.ts';
3
+ import type { LoggerInterface } from '@qvac/logging';
4
+ export declare const MAX_QUACKS = 500;
5
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
6
+ export type FakeModelsSource = Pick<LocalStore, 'get' | 'watch' | 'unwatch'>;
7
+ export interface FakeModelsOptions {
8
+ enabled?: () => boolean;
9
+ paceMs?: number;
10
+ }
11
+ export declare function quackCount(prompt: string): number;
12
+ export declare function readFakeModels(state: Pick<FakeModelsSource, 'get'>): Promise<boolean>;
13
+ export interface FakeModelsWatchOptions {
14
+ initial: boolean;
15
+ onChange: (enabled: boolean) => void;
16
+ logger?: LoggerInterface | null;
17
+ }
18
+ export declare function watchFakeModels(state: FakeModelsSource, opts: FakeModelsWatchOptions): () => Promise<void>;
19
+ export declare function withFakeModels(harness: Harness, opts?: FakeModelsOptions): Harness;
20
+ export {};