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

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 (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  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 +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -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,9 @@
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"];
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
+ export declare function servedToSiblings(local: Partial<CapabilityHandlers>): DeviceRoutes;
@@ -0,0 +1,123 @@
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
+ ];
31
+ function modelRoutes(at) {
32
+ return {
33
+ listModels: (input) => answer(at(input).listModels, 'listModels', here(input)),
34
+ deleteModel: (input) => answer(at(input).deleteModel, 'deleteModel', here(input)),
35
+ loadModel: (input) => answer(at(input).loadModel, 'loadModel', here(input)),
36
+ unloadModel: (input) => answer(at(input).unloadModel, 'unloadModel', here(input)),
37
+ retryModelDownload: (input) => answer(at(input).retryModelDownload, 'retryModelDownload', here(input)),
38
+ clearModelDownload: (input) => answer(at(input).clearModelDownload, 'clearModelDownload', here(input)),
39
+ modelCatalogWatch: (input = {}) => watched(() => required(at(input).modelCatalogWatch, 'modelCatalogWatch')(here(input))),
40
+ modelDownloadsWatch: (input = {}) => watched(() => required(at(input).modelDownloadsWatch, 'modelDownloadsWatch')(here(input))),
41
+ customModelsWatch: (input = {}) => watched(() => required(at(input).customModelsWatch, 'customModelsWatch')(here(input))),
42
+ previewCustomModel: (input) => answer(at(input).previewCustomModel, 'previewCustomModel', here(input)),
43
+ addCustomModel: (input) => answer(at(input).addCustomModel, 'addCustomModel', here(input)),
44
+ removeCustomModel: (input) => answer(at(input).removeCustomModel, 'removeCustomModel', here(input)),
45
+ modelUsers: (input) => answer(at(input).modelUsers, 'modelUsers', here(input)),
46
+ modelsWatch: (input = {}) => watched(() => required(at(input).modelsWatch, 'modelsWatch')(here(input))),
47
+ configGet: (input) => answer(at(input).configGet, 'configGet', here(input)),
48
+ configSet: (input) => answer(at(input).configSet, 'configSet', here(input)),
49
+ configWatch: (input) => watched(() => required(at(input).configWatch, 'configWatch')(here(input))),
50
+ setModelPaused: (input) => answer(at(input).setModelPaused, 'setModelPaused', here(input))
51
+ };
52
+ }
53
+ export function forwardToDevices(local, opts) {
54
+ const { deviceId, remote } = opts;
55
+ const elsewhere = (input) => {
56
+ const target = input?.deviceId;
57
+ return target && !b4a.equals(target, deviceId) ? target : null;
58
+ };
59
+ const at = (input) => {
60
+ const target = elsewhere(input);
61
+ return target ? remote(target) : local;
62
+ };
63
+ return modelRoutes(at);
64
+ }
65
+ export function servedToSiblings(local) {
66
+ const routes = modelRoutes(() => local);
67
+ return {
68
+ ...routes,
69
+ previewCustomModel: (input) => {
70
+ refuseLocalSources(input);
71
+ return routes.previewCustomModel(input);
72
+ },
73
+ addCustomModel: (input) => {
74
+ refuseLocalSources(input);
75
+ return routes.addCustomModel(input);
76
+ },
77
+ configGet: (input) => {
78
+ refuseOtherKeys(input);
79
+ return routes.configGet(input);
80
+ },
81
+ configSet: (input) => {
82
+ refuseOtherKeys(input);
83
+ return routes.configSet(input);
84
+ },
85
+ configWatch: (input) => watched(() => {
86
+ refuseOtherKeys(input);
87
+ return routes.configWatch(input);
88
+ })
89
+ };
90
+ }
91
+ function here(input) {
92
+ const local = { ...input };
93
+ delete local.deviceId;
94
+ return local;
95
+ }
96
+ function required(handler, route) {
97
+ if (!handler) {
98
+ throw new CoreError('DEVICE_ROUTE_NOT_SERVED', [route]);
99
+ }
100
+ return handler;
101
+ }
102
+ function watched(open) {
103
+ try {
104
+ return open();
105
+ }
106
+ catch (err) {
107
+ return frameReadable(new Readable({ read: (cb) => cb(asError(err)) }));
108
+ }
109
+ }
110
+ async function answer(handler, route, input) {
111
+ return await required(handler, route)(input);
112
+ }
113
+ function refuseLocalSources(input) {
114
+ const sources = [input.src, input.mmprojSrc].filter((src) => !!src);
115
+ if (!sources.every((src) => /^https?:\/\//i.test(src?.trim() ?? ''))) {
116
+ throw new CoreError('LINK_SOURCES_ONLY');
117
+ }
118
+ }
119
+ function refuseOtherKeys({ key }) {
120
+ if (!SIBLING_CONFIG_KEYS.has(key)) {
121
+ throw new CoreError('MODEL_SETTINGS_ONLY');
122
+ }
123
+ }
@@ -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,13 +29,13 @@ 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
34
  const snap = mesh.view.snapshot();
31
35
  try {
32
36
  const device = await snap.get(DEVICES, { id });
33
37
  if (!device) {
34
- throw new Error(`device not found: ${b4a.toHex(id)}`);
38
+ throw new CoreError('DEVICE_NOT_FOUND', [b4a.toHex(id)]);
35
39
  }
36
40
  return device;
37
41
  }
@@ -52,11 +56,10 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
52
56
  return {
53
57
  listDevices: async (request) => list(await requireMesh(pool, request.meshId)),
54
58
  getDevice: async ({ deviceId: id, meshId }) => toEngineDevice(await mustGetDevice(await requireMesh(pool, meshId), id)),
55
- devicesWatch: meshWatchable(pool, (_request, mesh) => list(mesh), { name: 'devicesWatch' }),
59
+ devicesWatch: meshWatchable(pool, (_request, mesh) => list(mesh), { name: 'devicesWatch', log }),
56
60
  deviceInfo: async () => {
57
- logger.info(['api', 'devices'], 'deviceInfo handler reached');
58
- const computeLenderId = (await computeLender?.()) ?? undefined;
59
- return { id: deviceId, supportsKvCacheDeletion: true, computeLenderId };
61
+ log?.info(['api', 'devices'], 'deviceInfo handler reached');
62
+ return { id: deviceId, supportsKvCacheDeletion: true };
60
63
  },
61
64
  saveDeviceCapabilities: async (input) => {
62
65
  await saveDeviceCapabilities(await requireMesh(pool, input.meshId), {
@@ -66,13 +69,14 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
66
69
  installedModelNames: input.installedModelNames ?? [],
67
70
  cachedModelNames: input.cachedModelNames ?? [],
68
71
  readySkillNames: input.readySkillNames ?? null,
69
- toolCatalog: input.toolCatalog ?? null
72
+ toolCatalog: input.toolCatalog ?? null,
73
+ customModels: input.customModels ?? null
70
74
  }, isAccount);
71
75
  return { ok: true };
72
76
  },
73
77
  removeDevice: async ({ deviceId: target, meshId }) => {
74
78
  if (b4a.equals(target, deviceId)) {
75
- throw new Error('cannot remove own device, use leaveMesh');
79
+ throw new CoreError('DEVICE_REMOVE_SELF');
76
80
  }
77
81
  const mesh = await requireMesh(pool, meshId);
78
82
  const device = await mustGetDevice(mesh, target);
@@ -80,7 +84,15 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
80
84
  return { ok: true };
81
85
  }
82
86
  if (!device.writerKey) {
83
- throw new Error('device has no writer key, cannot remove');
87
+ throw new CoreError('DEVICE_NO_WRITER_KEY');
88
+ }
89
+ const owner = device.memberId ?? device.claimedMemberId;
90
+ const ours = mesh.ourMemberId;
91
+ if (mesh.role === 'workspace' && !(owner && ours && b4a.equals(owner, ours))) {
92
+ await requireOurAdmin(mesh, "remove another member's device");
93
+ if (await adminsLastDevice(mesh.view, device)) {
94
+ throw new CoreError('DEVICE_ADMIN_LAST');
95
+ }
84
96
  }
85
97
  await removeWriter(device.writerKey, target, mesh);
86
98
  return { ok: true };
@@ -88,10 +100,10 @@ export function createDevicesApi(pool, { deviceId, removeWriter, renameLocal, sa
88
100
  renameDevice: async ({ meshId, config }) => {
89
101
  const trimmed = config.name.trim();
90
102
  if (!trimmed) {
91
- throw new Error('device name must not be empty');
103
+ throw new CoreError('DEVICE_NAME_EMPTY');
92
104
  }
93
105
  if (!deviceNameWithinBounds(trimmed)) {
94
- throw new Error(`device name must be at most ${MAX_DEVICE_NAME_CHARS} characters`);
106
+ throw new CoreError('DEVICE_NAME_TOO_LONG', [MAX_DEVICE_NAME_CHARS]);
95
107
  }
96
108
  const mesh = await requireMesh(pool, meshId);
97
109
  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,14 @@
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';
1
4
  import { type MeshPool } from './current-mesh.ts';
5
+ import type { MeshStatusSource } from './mesh.ts';
2
6
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
- export declare function createExecutionApi(pool: MeshPool, deviceId: Buffer): Pick<CapabilityHandlers, 'sendMessage' | 'runAgent' | 'stopRun'>;
7
+ export interface ExecutionApiOptions {
8
+ readonly account?: () => Mesh | null;
9
+ readonly agents?: AgentPicks | null;
10
+ readonly senders?: SenderLookup | null;
11
+ readonly peers?: Pick<MeshStatusSource, 'snapshot'> | null;
12
+ readonly platform?: (() => string | null) | null;
13
+ }
14
+ export declare function createExecutionApi(pool: MeshPool, deviceId: Buffer, { account, agents, senders, peers, platform }?: ExecutionApiOptions): Pick<CapabilityHandlers, 'sendMessage' | 'runAgent' | 'stopRun'>;
@@ -1,23 +1,52 @@
1
- import { appendChunk, listChunks } from '../core/chunk.js';
1
+ import { mustGetActiveAgent } from '../core/agent.js';
2
+ import { appendChunk, listChunks, requireProjectMember, requireStoppableRun } from '../core/chunk.js';
2
3
  import { randomId } from '../core/id.js';
4
+ import { getChat, mustGetActiveChat } from '../core/chat.js';
3
5
  import { parentRequestId, sendMessage } from '../core/send.js';
6
+ import { accountPicks } from '../core/shared-agents.js';
7
+ import { ourSenderName } from '../core/senders.js';
4
8
  import { requireMesh } from './current-mesh.js';
9
+ import { isMobilePlatform } from '@qvac/harness/lib/models/model-catalog.ts';
5
10
  const TERMINAL_STATES = new Set(['completed', 'failed', 'canceled']);
6
- export function createExecutionApi(pool, deviceId) {
11
+ async function askableMesh(pool, meshId) {
12
+ const mesh = await requireMesh(pool, meshId);
13
+ await requireProjectMember(mesh, meshId);
14
+ return mesh;
15
+ }
16
+ export function createExecutionApi(pool, deviceId, { account = () => null, agents = null, senders = null, peers = null, platform = null } = {}) {
17
+ const picks = agents ?? accountPicks(account);
18
+ const askable = async (meshId, agentId, refusal) => {
19
+ const mesh = await askableMesh(pool, meshId);
20
+ await picks.pick(mesh, agentId, refusal);
21
+ return mesh;
22
+ };
23
+ const chatAgent = async (meshId, chatId) => (await mustGetActiveChat(await askableMesh(pool, meshId), chatId)).agentId;
7
24
  return {
8
- sendMessage: async (input) => sendMessage(await requireMesh(pool, input.meshId), {
9
- text: input.text,
10
- chatId: input.chatId ?? undefined,
11
- agentId: input.agentId ?? undefined,
12
- title: input.title ?? undefined,
13
- parentRunId: input.parentRunId ?? undefined,
14
- capability: input.capability ?? undefined,
15
- capabilityArgs: input.capabilityArgs ?? undefined,
16
- enhance: input.enhance ?? undefined,
17
- originDeviceId: deviceId
18
- }),
25
+ sendMessage: async (input) => {
26
+ const kept = input.agentId ? null : input.chatId;
27
+ const mesh = kept
28
+ ? await askable(input.meshId, await chatAgent(input.meshId, kept), 'CHAT_AGENT_UNAVAILABLE')
29
+ : await askable(input.meshId, input.agentId);
30
+ return sendMessage(mesh, {
31
+ text: input.text,
32
+ senderNameAtSend: await ourSenderName(mesh, input.meshId, senders),
33
+ chatId: input.chatId ?? undefined,
34
+ agentId: input.agentId ?? undefined,
35
+ title: input.title ?? undefined,
36
+ parentRunId: input.parentRunId ?? undefined,
37
+ capability: input.capability ?? undefined,
38
+ capabilityArgs: input.capabilityArgs ?? undefined,
39
+ enhance: input.enhance ?? undefined,
40
+ originDeviceId: deviceId,
41
+ peers: isMobilePlatform(platform?.() ?? '')
42
+ ? (peers?.snapshot().peerDeviceIds ?? undefined)
43
+ : undefined
44
+ });
45
+ },
19
46
  runAgent: async ({ chatId, agentId, parentRunId, meshId, capability, capabilityArgs, enhance }) => {
20
- const mesh = await requireMesh(pool, meshId);
47
+ const kept = (await getChat(await askableMesh(pool, meshId), chatId))?.agentId === agentId;
48
+ const mesh = await askable(meshId, agentId, kept ? 'CHAT_AGENT_UNAVAILABLE' : undefined);
49
+ await mustGetActiveAgent(mesh, agentId);
21
50
  const parentId = parentRunId ? await parentRequestId(mesh, chatId, parentRunId) : undefined;
22
51
  await appendChunk(mesh, {
23
52
  chatId,
@@ -34,6 +63,7 @@ export function createExecutionApi(pool, deviceId) {
34
63
  },
35
64
  stopRun: async ({ chatId, runId, meshId }) => {
36
65
  const mesh = await requireMesh(pool, meshId);
66
+ await requireStoppableRun(mesh, { meshId, chatId, runId });
37
67
  const statuses = await listChunks(mesh, { chatId, type: 'run-status' });
38
68
  const settled = statuses.some((c) => c.runId === runId && TERMINAL_STATES.has(c.runStatus?.state ?? ''));
39
69
  if (settled) {
@@ -1,3 +1,3 @@
1
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
2
  import { type MeshPool } from './current-mesh.ts';
3
- export declare function createFilesApi(pool: MeshPool): Pick<CapabilityHandlers, 'fileRead' | 'filePreview' | 'fileRetry'>;
3
+ export declare function createFilesApi(pool: MeshPool): Pick<CapabilityHandlers, 'fileRead' | 'filePreview' | 'fileRetry' | 'filesReady'>;
@@ -4,6 +4,9 @@ import { requireMesh } from './current-mesh.js';
4
4
  import { frameReadable } from '../frame-readable.js';
5
5
  export function createFilesApi(pool) {
6
6
  return {
7
+ async filesReady({ meshId, chatId, fileIds }) {
8
+ return (await requireMesh(pool, meshId)).files.ready(chatId, fileIds);
9
+ },
7
10
  async filePreview(request) {
8
11
  return (await requireMesh(pool, request.meshId)).files.preview(request);
9
12
  },
@@ -14,7 +17,10 @@ export function createFilesApi(pool) {
14
17
  fileRead(request) {
15
18
  const abort = new AbortController();
16
19
  async function* read() {
17
- const mesh = await requireMesh(pool, request.meshId);
20
+ const mesh = await abortable(requireMesh(pool, request.meshId), abort.signal);
21
+ if (!mesh || abort.signal.aborted) {
22
+ return;
23
+ }
18
24
  const close = () => stream.destroy();
19
25
  mesh.files.once('close', close);
20
26
  try {
@@ -25,25 +31,76 @@ export function createFilesApi(pool) {
25
31
  }
26
32
  }
27
33
  const iterator = read();
34
+ let reading = false;
35
+ let pendingRead = null;
36
+ let stopped = false;
37
+ const stop = () => {
38
+ if (stopped)
39
+ return;
40
+ stopped = true;
41
+ abort.abort('file read closed');
42
+ const next = pendingRead;
43
+ pendingRead = null;
44
+ reading = false;
45
+ next?.(null);
46
+ void iterator.return(undefined).catch(noop);
47
+ };
28
48
  const stream = new Readable({
29
49
  read(callback) {
50
+ if (reading)
51
+ return;
52
+ reading = true;
53
+ pendingRead = callback;
54
+ const settle = (error) => {
55
+ reading = false;
56
+ const next = pendingRead;
57
+ pendingRead = null;
58
+ next?.(error);
59
+ };
30
60
  iterator
31
61
  .next()
32
62
  .then((frame) => {
63
+ if (stream.destroying) {
64
+ return settle(null);
65
+ }
33
66
  stream.push(frame.done ? null : frame.value);
34
- callback(null);
67
+ settle(null);
35
68
  })
36
- .catch(callback);
69
+ .catch((err) => {
70
+ settle(stream.destroying ? null : err);
71
+ });
37
72
  },
38
- predestroy: () => abort.abort('file read closed'),
73
+ predestroy: stop,
39
74
  destroy(callback) {
40
- iterator
41
- .return(undefined)
42
- .then(() => callback(null))
43
- .catch(callback);
75
+ stop();
76
+ callback(null);
44
77
  }
45
78
  });
46
79
  return frameReadable(stream);
47
80
  }
48
81
  };
49
82
  }
83
+ function abortable(promise, signal) {
84
+ if (signal.aborted) {
85
+ return Promise.resolve(null);
86
+ }
87
+ return new Promise((resolve, reject) => {
88
+ let settled = false;
89
+ const finish = (value, err) => {
90
+ if (settled)
91
+ return;
92
+ settled = true;
93
+ signal.removeEventListener('abort', onAbort);
94
+ if (err) {
95
+ reject(err);
96
+ }
97
+ else {
98
+ resolve(value);
99
+ }
100
+ };
101
+ const onAbort = () => finish(null);
102
+ signal.addEventListener('abort', onAbort, { once: true });
103
+ promise.then((value) => finish(value), (err) => finish(null, err));
104
+ });
105
+ }
106
+ function noop() { }
@@ -1,43 +1,4 @@
1
- import { type EngineBoot, type EngineStep } from '@qvac/harness/run-log';
2
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
+ import { type LocalRunLogs } from '../core/local/run-logs.ts';
3
3
  import { type MeshPool } from './current-mesh.ts';
4
- import type { HostRunLogExport } from '../core/host-run-log-store.ts';
5
- export interface HostRunLogOperations {
6
- begin(input: {
7
- meshId: string;
8
- runId: string;
9
- }): Promise<{
10
- generation: string;
11
- boot?: EngineBoot;
12
- digestKey: Uint8Array;
13
- }>;
14
- append(input: {
15
- meshId: string;
16
- runId: string;
17
- generation: string;
18
- step: EngineStep;
19
- }): Promise<void>;
20
- release(input: {
21
- meshId: string;
22
- runId: string;
23
- generation: string;
24
- }): Promise<void>;
25
- exportRun(input: {
26
- meshId: string;
27
- runId: string;
28
- }): Promise<HostRunLogExport>;
29
- }
30
- export interface HostRunLogTopicOperations {
31
- advertise(descriptor: HostRunLogExport): Promise<void>;
32
- unadvertise(input: {
33
- meshId: string;
34
- runId: string;
35
- }): Promise<void>;
36
- }
37
- export interface HostRunLogApiOptions {
38
- pool: MeshPool;
39
- deviceId: Buffer | null;
40
- hostRunLogs: HostRunLogOperations;
41
- topics: HostRunLogTopicOperations;
42
- }
43
- export declare function createHostRunLogApi({ pool, deviceId, hostRunLogs, topics }: HostRunLogApiOptions): Pick<CapabilityHandlers, 'hostRunLogBegin' | 'hostRunLogAppend' | 'hostRunLogRelease' | 'hostRunLogShare' | 'hostRunLogUnshare'>;
4
+ export declare function createHostRunLogApi(pool: MeshPool, runLogs: LocalRunLogs, deviceId: Buffer | null): Pick<CapabilityHandlers, 'hostRunLogBegin' | 'hostRunLogAppend' | 'hostRunLogRelease'>;