@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,15 +1,61 @@
1
+ import { Readable } from 'streamx';
1
2
  import { watchable } from './watchable.js';
2
- export function createConfigApi(state) {
3
+ import { frameReadable } from '../frame-readable.js';
4
+ import { latestFrame } from '../latest-frame.js';
5
+ import { QUARANTINE_PREFIX, configValue, readConfigValue } from '../core/config-value.js';
6
+ function readable(state, key) {
7
+ return key.startsWith(QUARANTINE_PREFIX) ? Promise.resolve(null) : state.get(key);
8
+ }
9
+ export function readConfigAnswer(answer) {
10
+ return { value: readConfigValue(answer) };
11
+ }
12
+ export function readConfigFrames(source) {
13
+ let stopped = false;
14
+ let output;
15
+ const frames = latestFrame((frame) => output.push(frame));
16
+ const onData = (frame) => frames.offer(readConfigAnswer(frame));
17
+ const onError = (err) => output.destroy(err);
18
+ const onEnd = () => frames.end();
19
+ const stop = () => {
20
+ if (stopped)
21
+ return;
22
+ stopped = true;
23
+ source.off('data', onData);
24
+ source.off('error', onError);
25
+ source.off('end', onEnd);
26
+ source.off('close', onEnd);
27
+ source.destroy();
28
+ frames.release();
29
+ };
30
+ output = new Readable({
31
+ read(callback) {
32
+ frames.read(callback);
33
+ },
34
+ predestroy: stop,
35
+ destroy(cb) {
36
+ stop();
37
+ cb(null);
38
+ }
39
+ });
40
+ output.on('error', noop);
41
+ source.on('data', onData);
42
+ source.on('error', onError);
43
+ source.on('end', onEnd);
44
+ source.on('close', onEnd);
45
+ return frameReadable(output);
46
+ }
47
+ export function createConfigApi(state, log, { onset = null, beforeSet = null } = {}) {
3
48
  return {
4
49
  async configGet({ key }) {
5
- return { value: await state.get(key) };
50
+ return configValue(await readable(state, key));
6
51
  },
7
52
  async configSet({ key, value }) {
53
+ beforeSet?.({ key, value });
8
54
  await state.set(key, value);
55
+ await onset?.({ key, value });
9
56
  return { ok: true };
10
57
  },
11
- configWatch: watchable(() => state, async ({ key }) => ({
12
- value: await state.get(key)
13
- }), { name: 'configWatch' })
58
+ configWatch: watchable(() => state, async ({ key }) => configValue(await readable(state, key)), { name: 'configWatch', log })
14
59
  };
15
60
  }
61
+ function noop() { }
@@ -1,12 +1,20 @@
1
1
  import type { Readable } from 'streamx';
2
2
  import type { Mesh } from '../core/mesh.ts';
3
3
  import { type WatchableOptions } from './watchable.ts';
4
- export type MeshPool = (meshId: string) => Mesh | null | Promise<Mesh | null>;
5
- export declare const NO_SUCH_MESH = "no such mesh";
6
- export declare function requireMesh(pool: MeshPool, meshId: string): Promise<Mesh>;
7
- export declare function isMissingMesh(err: unknown): boolean;
8
- export declare function meshWatchable<TRequest extends MeshScoped, TResult>(pool: MeshPool, query: (request: TRequest, mesh: Mesh) => Promise<TResult>, { name, changes }: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
4
+ export interface PoolRequest {
5
+ readonly route?: string;
6
+ readonly follow?: boolean;
7
+ readonly chatId?: string | null;
8
+ readonly chunkId?: string;
9
+ readonly wide?: boolean;
10
+ }
11
+ export type MeshPool = (meshId: string, request?: PoolRequest) => Mesh | null | Promise<Mesh | null>;
12
+ export declare function requireMesh(pool: MeshPool, meshId: string, request?: PoolRequest): Promise<Mesh>;
13
+ export declare function heldMesh(pool: MeshPool, meshId: string, request?: PoolRequest): Promise<Mesh | null>;
14
+ export declare function meshWatchable<TRequest extends MeshScoped, TResult>(pool: MeshPool, query: (request: TRequest, mesh: Mesh) => Promise<TResult>, options: WatchableOptions): (request: TRequest) => Readable & AsyncIterable<TResult>;
15
+ export declare function routed(pool: MeshPool, route: string): MeshPool;
9
16
  interface MeshScoped {
10
17
  readonly meshId: string;
18
+ readonly chatId?: string | null;
11
19
  }
12
20
  export {};
@@ -1,21 +1,25 @@
1
1
  import { watchable } from './watchable.js';
2
- export const NO_SUCH_MESH = 'no such mesh';
3
- export async function requireMesh(pool, meshId) {
4
- const mesh = await pool(meshId);
2
+ import { CoreError, isCoreError } from '../errors.js';
3
+ export async function requireMesh(pool, meshId, request) {
4
+ const mesh = await pool(meshId, request);
5
5
  if (!mesh) {
6
- throw new Error(`${NO_SUCH_MESH}: ${meshId}`);
6
+ throw new CoreError('MESH_NOT_FOUND', [meshId]);
7
7
  }
8
8
  if (!mesh.opened) {
9
9
  await mesh.ready();
10
10
  }
11
11
  return mesh;
12
12
  }
13
- export function isMissingMesh(err) {
14
- return err instanceof Error && err.message.startsWith(`${NO_SUCH_MESH}: `);
15
- }
16
- export function meshWatchable(pool, query, { name, changes }) {
17
- return watchable((request) => requireMesh(pool, request.meshId), query, {
18
- name,
19
- changes
13
+ export function heldMesh(pool, meshId, request) {
14
+ return requireMesh(pool, meshId, request).catch((err) => {
15
+ if (isCoreError(err, 'MESH_NOT_FOUND'))
16
+ return null;
17
+ throw err;
20
18
  });
21
19
  }
20
+ export function meshWatchable(pool, query, options) {
21
+ return watchable((request) => requireMesh(pool, request.meshId, { follow: true, chatId: request.chatId }), query, options);
22
+ }
23
+ export function routed(pool, route) {
24
+ return (meshId, request) => pool(meshId, { ...request, route: request?.route ?? route });
25
+ }
@@ -1,3 +1,4 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { AssistantCustomModelPreview, AssistantDeleteModelResponse, AssistantPreviewCustomModelRequest } from '../../spec/hyperschema/types.d.ts';
2
3
  import type { openLocalStore } from '../core/local/index.ts';
3
4
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
@@ -8,5 +9,10 @@ export type CustomModelFileDelete = (request: {
8
9
  name: string;
9
10
  }) => Promise<AssistantDeleteModelResponse>;
10
11
  export type CustomModelPreviewSource = (request: AssistantPreviewCustomModelRequest) => Promise<AssistantCustomModelPreview>;
11
- export declare function createCustomModelApi(state: LocalStore, preview: CustomModelPreviewSource | null, deleteFiles?: CustomModelFileDelete | null): Pick<CapabilityHandlers, 'customModelsWatch' | 'addCustomModel' | 'removeCustomModel' | 'previewCustomModel'>;
12
+ export interface CreateCustomModelApiOptions {
13
+ readonly preview: CustomModelPreviewSource | null;
14
+ readonly deleteFiles: CustomModelFileDelete | null;
15
+ readonly log: LoggerInterface | null;
16
+ }
17
+ export declare function createCustomModelApi(state: LocalStore, { preview, deleteFiles, log }: CreateCustomModelApiOptions): Pick<CapabilityHandlers, 'customModelsWatch' | 'addCustomModel' | 'removeCustomModel' | 'previewCustomModel'>;
12
18
  export {};
@@ -2,6 +2,7 @@ import b4a from 'b4a';
2
2
  import crypto from 'hypercore-crypto';
3
3
  import { watchable } from './watchable.js';
4
4
  import { customModelTaskRefusal } from '../custom-model-task.js';
5
+ import { CoreError } from '../errors.js';
5
6
  export const CUSTOM_MODEL_ID_PREFIX = 'custom:';
6
7
  export function customModelId(src) {
7
8
  return CUSTOM_MODEL_ID_PREFIX + b4a.toHex(crypto.hash(b4a.from(src))).slice(0, 12);
@@ -25,33 +26,30 @@ async function readCustomModels(state) {
25
26
  }))
26
27
  };
27
28
  }
28
- export function createCustomModelApi(state, preview, deleteFiles = null) {
29
+ export function createCustomModelApi(state, { preview, deleteFiles, log }) {
29
30
  const previewSource = async (request) => {
30
- if (!preview)
31
- throw new Error('no model source preview bound');
31
+ if (!preview) {
32
+ throw new CoreError('CAPABILITY_UNBOUND', ['model source preview']);
33
+ }
32
34
  return await preview(request);
33
35
  };
34
36
  return {
35
- customModelsWatch: watchable(() => state, () => readCustomModels(state), { name: 'customModelsWatch' }),
37
+ customModelsWatch: watchable(() => state, () => readCustomModels(state), { name: 'customModelsWatch', log }),
36
38
  previewCustomModel: previewSource,
37
39
  addCustomModel: async (input) => {
38
40
  const checked = await previewSource({ src: input.src, mmprojSrc: input.mmprojSrc });
39
41
  if (!checked.ok) {
40
- throw new Error(checked.reason || 'The model source was refused.');
42
+ throw new CoreError('CUSTOM_MODEL_SOURCE_REFUSED', [checked.reason]);
41
43
  }
42
44
  if (!checked.src) {
43
- throw new Error('This repository holds several models; add one of its files.');
45
+ throw new CoreError('CUSTOM_MODEL_AMBIGUOUS');
44
46
  }
45
47
  const unrunnable = customModelTaskRefusal(checked.taskType);
46
48
  if (unrunnable) {
47
- throw new Error(unrunnable);
49
+ throw unrunnable;
48
50
  }
49
51
  const id = customModelId(checked.src);
50
52
  const label = input.label.trim();
51
- const taken = (await state.getCustomModelRows()).find((row) => (row.label || row.name) === label && row.name !== id);
52
- if (taken) {
53
- throw new Error(`${label} is already the name of another model you added.`);
54
- }
55
53
  const row = {
56
54
  name: id,
57
55
  label,
@@ -68,7 +66,9 @@ export function createCustomModelApi(state, preview, deleteFiles = null) {
68
66
  taskType: checked.taskType ?? null,
69
67
  license: checked.license ?? null
70
68
  };
71
- await state.putCustomModelRow(row);
69
+ if (!(await state.putCustomModelRowIfLabelAvailable(row))) {
70
+ throw new CoreError('CUSTOM_MODEL_LABEL_TAKEN', [label]);
71
+ }
72
72
  return { id };
73
73
  },
74
74
  removeCustomModel: async ({ name }) => {
@@ -0,0 +1,14 @@
1
+ import type { Capabilities, CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
+ export declare const DEVICE_ROUTES: readonly ["listModels", "deleteModel", "loadModel", "unloadModel", "retryModelDownload", "clearModelDownload", "modelCatalogWatch", "modelDownloadsWatch", "customModelsWatch", "previewCustomModel", "addCustomModel", "removeCustomModel", "modelUsers", "modelsWatch", "configGet", "configSet", "configWatch", "setModelPaused", "skillOauth"];
3
+ export type DeviceRoutes = Pick<CapabilityHandlers, (typeof DEVICE_ROUTES)[number]>;
4
+ export interface ForwardingOptions {
5
+ readonly deviceId: Buffer;
6
+ readonly remote: (deviceId: Buffer) => Capabilities;
7
+ }
8
+ export declare function forwardToDevices(local: Partial<CapabilityHandlers>, opts: ForwardingOptions): DeviceRoutes;
9
+ interface SiblingAsks {
10
+ asked(name: string): Promise<void> | undefined;
11
+ resumed(name: string): void;
12
+ }
13
+ export declare function servedToSiblings(local: Partial<CapabilityHandlers>, sibling: SiblingAsks): DeviceRoutes;
14
+ export {};
@@ -0,0 +1,144 @@
1
+ import b4a from 'b4a';
2
+ import { Readable } from 'streamx';
3
+ import { asError } from '../guards.js';
4
+ import { CoreError } from '../errors.js';
5
+ import { frameReadable } from '../frame-readable.js';
6
+ import { MODEL_IDLE_UNLOAD_KEY, MODEL_MEMORY_CAP_KEY } from '../constants.js';
7
+ const SIBLING_CONFIG_KEYS = new Set([
8
+ MODEL_IDLE_UNLOAD_KEY,
9
+ MODEL_MEMORY_CAP_KEY
10
+ ]);
11
+ export const DEVICE_ROUTES = [
12
+ 'listModels',
13
+ 'deleteModel',
14
+ 'loadModel',
15
+ 'unloadModel',
16
+ 'retryModelDownload',
17
+ 'clearModelDownload',
18
+ 'modelCatalogWatch',
19
+ 'modelDownloadsWatch',
20
+ 'customModelsWatch',
21
+ 'previewCustomModel',
22
+ 'addCustomModel',
23
+ 'removeCustomModel',
24
+ 'modelUsers',
25
+ 'modelsWatch',
26
+ 'configGet',
27
+ 'configSet',
28
+ 'configWatch',
29
+ 'setModelPaused',
30
+ 'skillOauth'
31
+ ];
32
+ function modelRoutes(at) {
33
+ return {
34
+ listModels: (input) => answer(at(input).listModels, 'listModels', here(input)),
35
+ deleteModel: (input) => answer(at(input).deleteModel, 'deleteModel', here(input)),
36
+ loadModel: (input) => answer(at(input).loadModel, 'loadModel', here(input)),
37
+ unloadModel: (input) => answer(at(input).unloadModel, 'unloadModel', here(input)),
38
+ retryModelDownload: (input) => answer(at(input).retryModelDownload, 'retryModelDownload', here(input)),
39
+ clearModelDownload: (input) => answer(at(input).clearModelDownload, 'clearModelDownload', here(input)),
40
+ modelCatalogWatch: (input = {}) => watched(() => required(at(input).modelCatalogWatch, 'modelCatalogWatch')(here(input))),
41
+ modelDownloadsWatch: (input = {}) => watched(() => required(at(input).modelDownloadsWatch, 'modelDownloadsWatch')(here(input))),
42
+ customModelsWatch: (input = {}) => watched(() => required(at(input).customModelsWatch, 'customModelsWatch')(here(input))),
43
+ previewCustomModel: (input) => answer(at(input).previewCustomModel, 'previewCustomModel', here(input)),
44
+ addCustomModel: (input) => answer(at(input).addCustomModel, 'addCustomModel', here(input)),
45
+ removeCustomModel: (input) => answer(at(input).removeCustomModel, 'removeCustomModel', here(input)),
46
+ modelUsers: (input) => answer(at(input).modelUsers, 'modelUsers', here(input)),
47
+ modelsWatch: (input = {}) => watched(() => required(at(input).modelsWatch, 'modelsWatch')(here(input))),
48
+ configGet: (input) => answer(at(input).configGet, 'configGet', here(input)),
49
+ configSet: (input) => answer(at(input).configSet, 'configSet', here(input)),
50
+ configWatch: (input) => watched(() => required(at(input).configWatch, 'configWatch')(here(input))),
51
+ skillOauth: (input) => answer(at(input).skillOauth, 'skillOauth', here(input)),
52
+ setModelPaused: (input) => answer(at(input).setModelPaused, 'setModelPaused', here(input))
53
+ };
54
+ }
55
+ export function forwardToDevices(local, opts) {
56
+ const { deviceId, remote } = opts;
57
+ const elsewhere = (input) => {
58
+ const target = input?.deviceId;
59
+ return target && !b4a.equals(target, deviceId) ? target : null;
60
+ };
61
+ const at = (input) => {
62
+ const target = elsewhere(input);
63
+ return target ? remote(target) : local;
64
+ };
65
+ return modelRoutes(at);
66
+ }
67
+ export function servedToSiblings(local, sibling) {
68
+ const routes = modelRoutes(() => local);
69
+ return {
70
+ ...routes,
71
+ ...siblingDownloads(routes, sibling),
72
+ previewCustomModel: (input) => {
73
+ refuseLocalSources(input);
74
+ return routes.previewCustomModel(input);
75
+ },
76
+ addCustomModel: (input) => {
77
+ refuseLocalSources(input);
78
+ return routes.addCustomModel(input);
79
+ },
80
+ configGet: (input) => {
81
+ refuseOtherKeys(input);
82
+ return routes.configGet(input);
83
+ },
84
+ configSet: (input) => {
85
+ refuseOtherKeys(input);
86
+ return routes.configSet(input);
87
+ },
88
+ configWatch: (input) => watched(() => {
89
+ refuseOtherKeys(input);
90
+ return routes.configWatch(input);
91
+ })
92
+ };
93
+ }
94
+ function siblingDownloads(routes, sibling) {
95
+ return {
96
+ retryModelDownload: async (input) => {
97
+ const asked = sibling.asked(input.name);
98
+ if (!asked) {
99
+ return await routes.retryModelDownload(input);
100
+ }
101
+ await asked;
102
+ return { ok: true };
103
+ },
104
+ setModelPaused: async (input) => {
105
+ if (!input.paused) {
106
+ sibling.resumed(input.name);
107
+ }
108
+ return await routes.setModelPaused(input);
109
+ }
110
+ };
111
+ }
112
+ function here(input) {
113
+ const local = { ...input };
114
+ delete local.deviceId;
115
+ return local;
116
+ }
117
+ function required(handler, route) {
118
+ if (!handler) {
119
+ throw new CoreError('DEVICE_ROUTE_NOT_SERVED', [route]);
120
+ }
121
+ return handler;
122
+ }
123
+ function watched(open) {
124
+ try {
125
+ return open();
126
+ }
127
+ catch (err) {
128
+ return frameReadable(new Readable({ read: (cb) => cb(asError(err)) }));
129
+ }
130
+ }
131
+ async function answer(handler, route, input) {
132
+ return await required(handler, route)(input);
133
+ }
134
+ function refuseLocalSources(input) {
135
+ const sources = [input.src, input.mmprojSrc].filter((src) => !!src);
136
+ if (!sources.every((src) => /^https?:\/\//i.test(src?.trim() ?? ''))) {
137
+ throw new CoreError('LINK_SOURCES_ONLY');
138
+ }
139
+ }
140
+ function refuseOtherKeys({ key }) {
141
+ if (!SIBLING_CONFIG_KEYS.has(key)) {
142
+ throw new CoreError('MODEL_SETTINGS_ONLY');
143
+ }
144
+ }
@@ -1,9 +1,11 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { AssistantCapabilityProfile } from '../../spec/hyperschema/types.d.ts';
2
3
  import type { Mesh } from '../core/mesh.ts';
3
4
  import { type MeshPool } from './current-mesh.ts';
4
5
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
5
6
  export interface CreateDevicesApiOptions {
6
7
  readonly deviceId: Buffer;
8
+ readonly log: LoggerInterface | null;
7
9
  readonly removeWriter: (writerKey: Buffer, deviceId: Buffer, mesh: Mesh) => Promise<void>;
8
10
  readonly renameLocal: (name: string) => Promise<void>;
9
11
  readonly saveProfileLocal: (capabilityProfile: AssistantCapabilityProfile, recommendedModelName: string, platform?: string) => Promise<void>;
@@ -13,6 +15,5 @@ export interface CreateDevicesApiOptions {
13
15
  platform?: string;
14
16
  } | null;
15
17
  readonly isAccount: (mesh: Mesh) => boolean;
16
- readonly computeLender?: (() => Promise<Buffer | null>) | null;
17
18
  }
18
- export declare function createDevicesApi(pool: MeshPool, { deviceId, removeWriter, renameLocal, saveProfileLocal, readLocalProfile, isAccount, computeLender }: CreateDevicesApiOptions): Pick<CapabilityHandlers, 'listDevices' | 'getDevice' | 'devicesWatch' | 'deviceInfo' | 'saveDeviceCapabilities' | 'saveDeviceProfile' | 'removeDevice' | 'renameDevice'>;
19
+ export declare function createDevicesApi(pool: MeshPool, { deviceId, log, removeWriter, renameLocal, saveProfileLocal, readLocalProfile, isAccount }: CreateDevicesApiOptions): Pick<CapabilityHandlers, 'listDevices' | 'getDevice' | 'devicesWatch' | 'deviceInfo' | 'saveDeviceCapabilities' | 'saveDeviceProfile' | 'removeDevice' | 'renameDevice'>;
@@ -1,8 +1,11 @@
1
1
  import { MAX_DEVICE_NAME_CHARS, deviceNameWithinBounds } from '../../schema/qvac.js';
2
2
  import { saveDeviceCapabilities } from '../core/devices.js';
3
+ import { adminsLastDevice } from '../core/contract/workspace.js';
3
4
  import { meshWatchable, requireMesh } from './current-mesh.js';
5
+ import { requireOurAdmin } from './members.js';
4
6
  import b4a from 'b4a';
5
7
  import { DEVICES } from '../core/collections.js';
8
+ import { CoreError } from '../errors.js';
6
9
  function toEngineDevice(device, overrides = {}) {
7
10
  return {
8
11
  id: device.id,
@@ -13,6 +16,7 @@ function toEngineDevice(device, overrides = {}) {
13
16
  installedSkillNames: device.installedSkillNames ?? [],
14
17
  readySkillNames: device.readySkillNames,
15
18
  toolCatalog: device.toolCatalog,
19
+ customModels: device.customModels,
16
20
  installedModelNames: device.installedModelNames ?? [],
17
21
  cachedModelNames: device.cachedModelNames ?? [],
18
22
  capabilityProfile: device.capabilityProfile,
@@ -25,38 +29,25 @@ function toEngineDevice(device, overrides = {}) {
25
29
  ...overrides
26
30
  };
27
31
  }
28
- export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, saveProfileLocal, readLocalProfile, isAccount, computeLender = null }) {
32
+ export function createDevicesApi(pool, { deviceId, log, removeWriter, renameLocal, saveProfileLocal, readLocalProfile, isAccount }) {
29
33
  const mustGetDevice = async (mesh, id) => {
30
- const snap = mesh.view.snapshot();
31
- try {
32
- const device = await snap.get(DEVICES, { id });
33
- if (!device) {
34
- throw new Error(`device not found: ${b4a.toHex(id)}`);
35
- }
36
- return device;
37
- }
38
- finally {
39
- await snap.close();
34
+ const device = await mesh.view.get(DEVICES, { id });
35
+ if (!device) {
36
+ throw new CoreError('DEVICE_NOT_FOUND', [b4a.toHex(id)]);
40
37
  }
38
+ return device;
41
39
  };
42
40
  const list = async (mesh) => {
43
- const snap = mesh.view.snapshot();
44
- try {
45
- const devices = await snap.find(DEVICES).toArray();
46
- return { devices: devices.map((device) => toEngineDevice(device)) };
47
- }
48
- finally {
49
- await snap.close();
50
- }
41
+ const devices = await mesh.view.find(DEVICES).toArray();
42
+ return { devices: devices.map((device) => toEngineDevice(device)) };
51
43
  };
52
44
  return {
53
45
  listDevices: async (request) => list(await requireMesh(pool, request.meshId)),
54
46
  getDevice: async ({ deviceId: id, meshId }) => toEngineDevice(await mustGetDevice(await requireMesh(pool, meshId), id)),
55
- devicesWatch: meshWatchable(pool, (_request, mesh) => list(mesh), { name: 'devicesWatch' }),
47
+ devicesWatch: meshWatchable(pool, (_request, mesh) => list(mesh), { name: 'devicesWatch', log }),
56
48
  deviceInfo: async () => {
57
- logger.info(['api', 'devices'], 'deviceInfo handler reached');
58
- const computeLenderId = (await computeLender?.()) ?? undefined;
59
- return { id: deviceId, supportsKvCacheDeletion: true, computeLenderId };
49
+ log?.info(['api', 'devices'], 'deviceInfo handler reached');
50
+ return { id: deviceId, supportsKvCacheDeletion: true };
60
51
  },
61
52
  saveDeviceCapabilities: async (input) => {
62
53
  await saveDeviceCapabilities(await requireMesh(pool, input.meshId), {
@@ -66,13 +57,14 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
66
57
  installedModelNames: input.installedModelNames ?? [],
67
58
  cachedModelNames: input.cachedModelNames ?? [],
68
59
  readySkillNames: input.readySkillNames ?? null,
69
- toolCatalog: input.toolCatalog ?? null
60
+ toolCatalog: input.toolCatalog ?? null,
61
+ customModels: input.customModels ?? null
70
62
  }, isAccount);
71
63
  return { ok: true };
72
64
  },
73
65
  removeDevice: async ({ deviceId: target, meshId }) => {
74
66
  if (b4a.equals(target, deviceId)) {
75
- throw new Error('cannot remove own device, use leaveMesh');
67
+ throw new CoreError('DEVICE_REMOVE_SELF');
76
68
  }
77
69
  const mesh = await requireMesh(pool, meshId);
78
70
  const device = await mustGetDevice(mesh, target);
@@ -80,7 +72,15 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
80
72
  return { ok: true };
81
73
  }
82
74
  if (!device.writerKey) {
83
- throw new Error('device has no writer key, cannot remove');
75
+ throw new CoreError('DEVICE_NO_WRITER_KEY');
76
+ }
77
+ const owner = device.memberId ?? device.claimedMemberId;
78
+ const ours = mesh.ourMemberId;
79
+ if (mesh.role === 'workspace' && !(owner && ours && b4a.equals(owner, ours))) {
80
+ await requireOurAdmin(mesh, "remove another member's device");
81
+ if (await adminsLastDevice(mesh.view, device)) {
82
+ throw new CoreError('DEVICE_ADMIN_LAST');
83
+ }
84
84
  }
85
85
  await removeWriter(device.writerKey, target, mesh);
86
86
  return { ok: true };
@@ -88,10 +88,10 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
88
88
  renameDevice: async ({ meshId, config }) => {
89
89
  const trimmed = config.name.trim();
90
90
  if (!trimmed) {
91
- throw new Error('device name must not be empty');
91
+ throw new CoreError('DEVICE_NAME_EMPTY');
92
92
  }
93
93
  if (!deviceNameWithinBounds(trimmed)) {
94
- throw new Error(`device name must be at most ${MAX_DEVICE_NAME_CHARS} characters`);
94
+ throw new CoreError('DEVICE_NAME_TOO_LONG', [MAX_DEVICE_NAME_CHARS]);
95
95
  }
96
96
  const mesh = await requireMesh(pool, meshId);
97
97
  const device = await mustGetDevice(mesh, deviceId);
@@ -1,3 +1,4 @@
1
+ import type { LoggerInterface } from '@qvac/logging';
1
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
3
  export interface DiagnosticsSource {
3
4
  watch(listener: () => void): void;
@@ -5,4 +6,4 @@ export interface DiagnosticsSource {
5
6
  snapshot(): Record<string, unknown>;
6
7
  readonly sampled: true;
7
8
  }
8
- export declare function createDiagnosticsApi(source: DiagnosticsSource): Pick<CapabilityHandlers, 'diagnostics' | 'diagnosticsWatch'>;
9
+ export declare function createDiagnosticsApi(source: DiagnosticsSource, log: LoggerInterface | null): Pick<CapabilityHandlers, 'diagnostics' | 'diagnosticsWatch'>;
@@ -1,7 +1,7 @@
1
1
  import { watchable } from './watchable.js';
2
- export function createDiagnosticsApi(source) {
2
+ export function createDiagnosticsApi(source, log) {
3
3
  return {
4
4
  diagnostics: async () => ({ stats: source.snapshot() }),
5
- diagnosticsWatch: watchable(() => source, async () => ({ stats: source.snapshot() }), { name: 'diagnosticsWatch' })
5
+ diagnosticsWatch: watchable(() => source, async () => ({ stats: source.snapshot() }), { name: 'diagnosticsWatch', log })
6
6
  };
7
7
  }
@@ -1,3 +1,18 @@
1
+ import { type AgentPicks } from '../core/shared-agents.ts';
2
+ import type { Mesh } from '../core/mesh.ts';
3
+ import { type SenderLookup } from '../core/senders.ts';
4
+ import { type CatalogSkill } from '../core/skill-availability.ts';
1
5
  import { type MeshPool } from './current-mesh.ts';
6
+ import type { MeshStatusSource } from './mesh.ts';
2
7
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
- export declare function createExecutionApi(pool: MeshPool, deviceId: Buffer): Pick<CapabilityHandlers, 'sendMessage' | 'runAgent' | 'stopRun'>;
8
+ import type { LoggerInterface } from '@qvac/logging';
9
+ export interface ExecutionApiOptions {
10
+ readonly account?: () => Mesh | null;
11
+ readonly agents?: AgentPicks | null;
12
+ readonly senders?: SenderLookup | null;
13
+ readonly peers?: Pick<MeshStatusSource, 'snapshot' | 'watch' | 'unwatch'> | null;
14
+ readonly platform?: (() => string | null) | null;
15
+ readonly skillCatalog?: (() => Promise<ReadonlyArray<CatalogSkill>>) | null;
16
+ readonly log?: LoggerInterface | null;
17
+ }
18
+ export declare function createExecutionApi(pool: MeshPool, deviceId: Buffer, { account, agents, senders, peers, platform, skillCatalog, log }?: ExecutionApiOptions): Pick<CapabilityHandlers, 'sendMessage' | 'runAgent' | 'stopRun' | 'chatSkillAvailability' | 'chatSkillAvailabilityWatch'>;