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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (579) hide show
  1. package/CHANGELOG.md +1203 -1
  2. package/README.md +56 -45
  3. package/dist-lib/index.d.ts +3 -2
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +20 -2
  8. package/dist-lib/lib/api/agents.js +128 -24
  9. package/dist-lib/lib/api/app-config.d.ts +7 -1
  10. package/dist-lib/lib/api/app-config.js +37 -6
  11. package/dist-lib/lib/api/approval-rules.d.ts +1 -1
  12. package/dist-lib/lib/api/approval-rules.js +12 -5
  13. package/dist-lib/lib/api/attachments.d.ts +1 -1
  14. package/dist-lib/lib/api/attachments.js +14 -2
  15. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  16. package/dist-lib/lib/api/chat-move.js +7 -0
  17. package/dist-lib/lib/api/chat.d.ts +12 -2
  18. package/dist-lib/lib/api/chat.js +100 -9
  19. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  20. package/dist-lib/lib/api/chunk-delta.js +115 -0
  21. package/dist-lib/lib/api/chunks.d.ts +19 -2
  22. package/dist-lib/lib/api/chunks.js +73 -13
  23. package/dist-lib/lib/api/config.d.ts +11 -3
  24. package/dist-lib/lib/api/config.js +51 -5
  25. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  26. package/dist-lib/lib/api/current-mesh.js +15 -11
  27. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  28. package/dist-lib/lib/api/custom-models.js +12 -12
  29. package/dist-lib/lib/api/device-routes.d.ts +14 -0
  30. package/dist-lib/lib/api/device-routes.js +144 -0
  31. package/dist-lib/lib/api/devices.d.ts +3 -2
  32. package/dist-lib/lib/api/devices.js +28 -28
  33. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  34. package/dist-lib/lib/api/diagnostics.js +2 -2
  35. package/dist-lib/lib/api/execution.d.ts +16 -1
  36. package/dist-lib/lib/api/execution.js +72 -16
  37. package/dist-lib/lib/api/files.d.ts +1 -1
  38. package/dist-lib/lib/api/files.js +65 -8
  39. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  40. package/dist-lib/lib/api/host-run-log.js +35 -83
  41. package/dist-lib/lib/api/index.d.ts +39 -7
  42. package/dist-lib/lib/api/index.js +116 -36
  43. package/dist-lib/lib/api/instrument.d.ts +2 -2
  44. package/dist-lib/lib/api/instrument.js +24 -48
  45. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  46. package/dist-lib/lib/api/knowledge.js +25 -7
  47. package/dist-lib/lib/api/local-files.d.ts +5 -1
  48. package/dist-lib/lib/api/local-files.js +9 -5
  49. package/dist-lib/lib/api/logs.js +3 -3
  50. package/dist-lib/lib/api/members.d.ts +10 -1
  51. package/dist-lib/lib/api/members.js +69 -44
  52. package/dist-lib/lib/api/mesh.d.ts +15 -6
  53. package/dist-lib/lib/api/mesh.js +13 -9
  54. package/dist-lib/lib/api/model-download.d.ts +2 -1
  55. package/dist-lib/lib/api/model-download.js +2 -2
  56. package/dist-lib/lib/api/network.d.ts +10 -2
  57. package/dist-lib/lib/api/network.js +8 -2
  58. package/dist-lib/lib/api/notifications.d.ts +3 -1
  59. package/dist-lib/lib/api/notifications.js +14 -9
  60. package/dist-lib/lib/api/projects.d.ts +20 -0
  61. package/dist-lib/lib/api/projects.js +172 -0
  62. package/dist-lib/lib/api/rag-plugin.d.ts +17 -0
  63. package/dist-lib/lib/api/rag-plugin.js +44 -0
  64. package/dist-lib/lib/api/rag.d.ts +0 -1
  65. package/dist-lib/lib/api/rag.js +106 -33
  66. package/dist-lib/lib/api/served.d.ts +17 -0
  67. package/dist-lib/lib/api/served.js +65 -0
  68. package/dist-lib/lib/api/sync.d.ts +2 -1
  69. package/dist-lib/lib/api/sync.js +13 -3
  70. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  71. package/dist-lib/lib/api/tool-activity.js +4 -3
  72. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  73. package/dist-lib/lib/api/tool-configs.js +6 -9
  74. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  75. package/dist-lib/lib/api/upload-frames.js +0 -1
  76. package/dist-lib/lib/api/watchable.d.ts +3 -2
  77. package/dist-lib/lib/api/watchable.js +2 -3
  78. package/dist-lib/lib/api/workspace.d.ts +12 -0
  79. package/dist-lib/lib/api/workspace.js +61 -0
  80. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  81. package/dist-lib/lib/assistant/fake-models.js +112 -0
  82. package/dist-lib/lib/assistant/harness.d.ts +48 -31
  83. package/dist-lib/lib/assistant/harness.js +51 -10
  84. package/dist-lib/lib/assistant/history.d.ts +37 -17
  85. package/dist-lib/lib/assistant/history.js +212 -87
  86. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  87. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  88. package/dist-lib/lib/assistant/media-round.d.ts +61 -0
  89. package/dist-lib/lib/assistant/media-round.js +111 -0
  90. package/dist-lib/lib/assistant/message.d.ts +28 -1
  91. package/dist-lib/lib/assistant/message.js +65 -2
  92. package/dist-lib/lib/assistant/model-round.d.ts +118 -0
  93. package/dist-lib/lib/assistant/model-round.js +706 -0
  94. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  95. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  96. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  97. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  98. package/dist-lib/lib/assistant/round-host.d.ts +65 -0
  99. package/dist-lib/lib/assistant/round-host.js +332 -0
  100. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  101. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  102. package/dist-lib/lib/assistant/upload.d.ts +12 -0
  103. package/dist-lib/lib/assistant/upload.js +36 -0
  104. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  105. package/dist-lib/lib/assistant/video-budget.js +29 -0
  106. package/dist-lib/lib/assistant-client.d.ts +5 -1
  107. package/dist-lib/lib/assistant-client.js +54 -14
  108. package/dist-lib/lib/assistant-tree.d.ts +14 -3
  109. package/dist-lib/lib/assistant-tree.js +113 -21
  110. package/dist-lib/lib/assistant.d.ts +115 -25
  111. package/dist-lib/lib/assistant.js +2409 -1245
  112. package/dist-lib/lib/audio-format.js +1 -1
  113. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  114. package/dist-lib/lib/chat-suggestion.js +47 -0
  115. package/dist-lib/lib/client.d.ts +3 -2
  116. package/dist-lib/lib/client.js +18 -3
  117. package/dist-lib/lib/compaction.d.ts +3 -1
  118. package/dist-lib/lib/compaction.js +18 -4
  119. package/dist-lib/lib/constants.d.ts +10 -0
  120. package/dist-lib/lib/constants.js +10 -0
  121. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  122. package/dist-lib/lib/core/agent-copies.js +47 -0
  123. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  124. package/dist-lib/lib/core/agent-hosting.js +76 -0
  125. package/dist-lib/lib/core/agent.d.ts +9 -1
  126. package/dist-lib/lib/core/agent.js +58 -63
  127. package/dist-lib/lib/core/approval-rules.d.ts +5 -1
  128. package/dist-lib/lib/core/approval-rules.js +17 -9
  129. package/dist-lib/lib/core/archived-mesh.d.ts +14 -7
  130. package/dist-lib/lib/core/archived-mesh.js +75 -59
  131. package/dist-lib/lib/core/async-iterable.js +1 -1
  132. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  133. package/dist-lib/lib/core/blind-peers.js +1 -0
  134. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  135. package/dist-lib/lib/core/chat-activity.js +45 -34
  136. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  137. package/dist-lib/lib/core/chat-copy.js +404 -0
  138. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  139. package/dist-lib/lib/core/chat-fork.js +246 -0
  140. package/dist-lib/lib/core/chat-group.js +10 -22
  141. package/dist-lib/lib/core/chat-move.d.ts +77 -0
  142. package/dist-lib/lib/core/chat-move.js +601 -0
  143. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  144. package/dist-lib/lib/core/chat-order.js +28 -19
  145. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  146. package/dist-lib/lib/core/chat-read.js +49 -0
  147. package/dist-lib/lib/core/chat-search.js +14 -12
  148. package/dist-lib/lib/core/chat.d.ts +32 -4
  149. package/dist-lib/lib/core/chat.js +135 -61
  150. package/dist-lib/lib/core/chunk.d.ts +35 -7
  151. package/dist-lib/lib/core/chunk.js +271 -72
  152. package/dist-lib/lib/core/collections.d.ts +41 -1
  153. package/dist-lib/lib/core/collections.js +41 -1
  154. package/dist-lib/lib/core/config-value.d.ts +7 -0
  155. package/dist-lib/lib/core/config-value.js +15 -0
  156. package/dist-lib/lib/core/contract/activity.d.ts +7 -2
  157. package/dist-lib/lib/core/contract/activity.js +71 -23
  158. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  159. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  160. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  161. package/dist-lib/lib/core/contract/agents.js +142 -3
  162. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  163. package/dist-lib/lib/core/contract/chat.js +53 -3
  164. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  165. package/dist-lib/lib/core/contract/chunks.js +125 -38
  166. package/dist-lib/lib/core/contract/devices.js +6 -4
  167. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  168. package/dist-lib/lib/core/contract/index.js +38 -11
  169. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  170. package/dist-lib/lib/core/contract/indexing.js +51 -7
  171. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  172. package/dist-lib/lib/core/contract/invites.js +26 -36
  173. package/dist-lib/lib/core/contract/joined-meshes.js +4 -1
  174. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  175. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  176. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  177. package/dist-lib/lib/core/contract/members.js +48 -12
  178. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  179. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  180. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  181. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  182. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  183. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  184. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  185. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  186. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  187. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  188. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  189. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  190. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  191. package/dist-lib/lib/core/contract/open-join.js +77 -0
  192. package/dist-lib/lib/core/contract/project-device-keys.d.ts +9 -0
  193. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  194. package/dist-lib/lib/core/contract/project-host-keys.d.ts +9 -0
  195. package/dist-lib/lib/core/contract/project-host-keys.js +52 -0
  196. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  197. package/dist-lib/lib/core/contract/project-order.js +25 -0
  198. package/dist-lib/lib/core/contract/projects.d.ts +23 -0
  199. package/dist-lib/lib/core/contract/projects.js +339 -0
  200. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  201. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  202. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  203. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  204. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  205. package/dist-lib/lib/core/contract/roles.js +123 -0
  206. package/dist-lib/lib/core/contract/run-requests.d.ts +11 -0
  207. package/dist-lib/lib/core/contract/run-requests.js +114 -0
  208. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  209. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  210. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  211. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  212. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  213. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  214. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  215. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  216. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  217. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  218. package/dist-lib/lib/core/contract/workspace.js +311 -0
  219. package/dist-lib/lib/core/contract/writers.js +100 -16
  220. package/dist-lib/lib/core/deleted-agent-runs.d.ts +8 -0
  221. package/dist-lib/lib/core/deleted-agent-runs.js +57 -0
  222. package/dist-lib/lib/core/departures.d.ts +18 -5
  223. package/dist-lib/lib/core/departures.js +82 -6
  224. package/dist-lib/lib/core/device-control.d.ts +21 -0
  225. package/dist-lib/lib/core/device-control.js +91 -0
  226. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  227. package/dist-lib/lib/core/device-seal.js +22 -0
  228. package/dist-lib/lib/core/devices.d.ts +2 -1
  229. package/dist-lib/lib/core/devices.js +6 -11
  230. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  231. package/dist-lib/lib/core/document-attachment.js +14 -0
  232. package/dist-lib/lib/core/files/attachments.d.ts +2 -0
  233. package/dist-lib/lib/core/files/attachments.js +23 -7
  234. package/dist-lib/lib/core/files/index.d.ts +28 -15
  235. package/dist-lib/lib/core/files/index.js +222 -43
  236. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  237. package/dist-lib/lib/core/files/knowledge.js +77 -5
  238. package/dist-lib/lib/core/files/preview/index.js +6 -2
  239. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  240. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  241. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  242. package/dist-lib/lib/core/files/processing/document.js +26 -2
  243. package/dist-lib/lib/core/files/processing/index.d.ts +12 -3
  244. package/dist-lib/lib/core/files/processing/index.js +122 -73
  245. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  246. package/dist-lib/lib/core/files/processing/protocol.js +27 -37
  247. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  248. package/dist-lib/lib/core/files/processing/source.js +12 -4
  249. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  250. package/dist-lib/lib/core/files/processing/state.js +9 -1
  251. package/dist-lib/lib/core/files/rag/build.d.ts +15 -2
  252. package/dist-lib/lib/core/files/rag/build.js +119 -21
  253. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  254. package/dist-lib/lib/core/files/rag/failure.js +58 -0
  255. package/dist-lib/lib/core/files/rag/index.d.ts +21 -5
  256. package/dist-lib/lib/core/files/rag/index.js +38 -9
  257. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  258. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  259. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  260. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  261. package/dist-lib/lib/core/files/rag/load.d.ts +3 -3
  262. package/dist-lib/lib/core/files/rag/load.js +6 -3
  263. package/dist-lib/lib/core/files/rag/plugin-index.d.ts +32 -0
  264. package/dist-lib/lib/core/files/rag/plugin-index.js +120 -0
  265. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  266. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  267. package/dist-lib/lib/core/files/rag/produce.d.ts +3 -4
  268. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  269. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  270. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  271. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  272. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  273. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  274. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  275. package/dist-lib/lib/core/files/records/index.js +1 -1
  276. package/dist-lib/lib/core/files/records/knowledge.d.ts +12 -4
  277. package/dist-lib/lib/core/files/records/knowledge.js +34 -30
  278. package/dist-lib/lib/core/files/records/purge.js +13 -8
  279. package/dist-lib/lib/core/files/records/reclaim.js +21 -55
  280. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  281. package/dist-lib/lib/core/files/records/routing.js +6 -2
  282. package/dist-lib/lib/core/files/records/source.js +3 -5
  283. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  284. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  285. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  286. package/dist-lib/lib/core/files/store/blob.js +2 -2
  287. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  288. package/dist-lib/lib/core/files/store/index.js +4 -1
  289. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  290. package/dist-lib/lib/core/files/store/reference.js +12 -2
  291. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  292. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  293. package/dist-lib/lib/core/files/upload.js +117 -51
  294. package/dist-lib/lib/core/first-event.d.ts +6 -0
  295. package/dist-lib/lib/core/first-event.js +13 -0
  296. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  297. package/dist-lib/lib/core/fs-drives.js +35 -35
  298. package/dist-lib/lib/core/helpers/index.d.ts +1 -1
  299. package/dist-lib/lib/core/helpers/index.js +2 -2
  300. package/dist-lib/lib/core/id.d.ts +1 -0
  301. package/dist-lib/lib/core/id.js +3 -0
  302. package/dist-lib/lib/core/identity.d.ts +3 -1
  303. package/dist-lib/lib/core/identity.js +25 -4
  304. package/dist-lib/lib/core/invite.d.ts +6 -2
  305. package/dist-lib/lib/core/invite.js +22 -8
  306. package/dist-lib/lib/core/local/files.d.ts +2 -1
  307. package/dist-lib/lib/core/local/files.js +5 -7
  308. package/dist-lib/lib/core/local/index.d.ts +93 -8
  309. package/dist-lib/lib/core/local/index.js +327 -28
  310. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  311. package/dist-lib/lib/core/local/run-logs.js +132 -0
  312. package/dist-lib/lib/core/member-key.d.ts +7 -0
  313. package/dist-lib/lib/core/member-key.js +24 -0
  314. package/dist-lib/lib/core/membership.d.ts +3 -14
  315. package/dist-lib/lib/core/membership.js +3 -96
  316. package/dist-lib/lib/core/mesh.d.ts +132 -29
  317. package/dist-lib/lib/core/mesh.js +775 -215
  318. package/dist-lib/lib/core/migrations/agent-catalog.js +2 -8
  319. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  320. package/dist-lib/lib/core/migrations/agent-tools-scope.js +18 -0
  321. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  322. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  323. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  324. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  325. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  326. package/dist-lib/lib/core/migrations/index.js +69 -8
  327. package/dist-lib/lib/core/migrations/writer-links.d.ts +3 -0
  328. package/dist-lib/lib/core/migrations/writer-links.js +30 -0
  329. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  330. package/dist-lib/lib/core/model-requests.js +65 -0
  331. package/dist-lib/lib/core/next-frame.js +2 -1
  332. package/dist-lib/lib/core/notification.js +100 -25
  333. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  334. package/dist-lib/lib/core/pdf/figure.js +64 -0
  335. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  336. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  337. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  338. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  339. package/dist-lib/lib/core/project-keys.d.ts +16 -0
  340. package/dist-lib/lib/core/project-keys.js +65 -0
  341. package/dist-lib/lib/core/prompt-history.js +4 -4
  342. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  343. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  344. package/dist-lib/lib/core/public-mesh.d.ts +25 -0
  345. package/dist-lib/lib/core/public-mesh.js +81 -0
  346. package/dist-lib/lib/core/purge.d.ts +3 -0
  347. package/dist-lib/lib/core/purge.js +7 -0
  348. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  349. package/dist-lib/lib/core/run-driver.js +20 -0
  350. package/dist-lib/lib/core/run-requests.d.ts +14 -0
  351. package/dist-lib/lib/core/run-requests.js +78 -0
  352. package/dist-lib/lib/core/send.d.ts +2 -0
  353. package/dist-lib/lib/core/send.js +17 -4
  354. package/dist-lib/lib/core/senders.d.ts +19 -0
  355. package/dist-lib/lib/core/senders.js +45 -0
  356. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  357. package/dist-lib/lib/core/shared-agents.js +283 -0
  358. package/dist-lib/lib/core/skill-availability.d.ts +33 -0
  359. package/dist-lib/lib/core/skill-availability.js +67 -0
  360. package/dist-lib/lib/core/skill-secrets.d.ts +13 -18
  361. package/dist-lib/lib/core/skill-secrets.js +93 -72
  362. package/dist-lib/lib/core/sync/background.d.ts +34 -0
  363. package/dist-lib/lib/core/sync/background.js +86 -0
  364. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  365. package/dist-lib/lib/core/sync/changed.js +7 -0
  366. package/dist-lib/lib/core/sync/devices.js +6 -3
  367. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  368. package/dist-lib/lib/core/sync/files.js +50 -72
  369. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  370. package/dist-lib/lib/core/sync/index.js +193 -81
  371. package/dist-lib/lib/core/sync/view-updates.d.ts +39 -0
  372. package/dist-lib/lib/core/sync/view-updates.js +124 -0
  373. package/dist-lib/lib/core/sync-status.js +99 -43
  374. package/dist-lib/lib/core/system-info.d.ts +2 -2
  375. package/dist-lib/lib/core/system-info.js +10 -11
  376. package/dist-lib/lib/core/tool-activity.js +6 -12
  377. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  378. package/dist-lib/lib/core/tool-configs.js +27 -39
  379. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  380. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  381. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  382. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  383. package/dist-lib/lib/core/upgrade-summary.d.ts +19 -0
  384. package/dist-lib/lib/core/upgrade-summary.js +67 -0
  385. package/dist-lib/lib/core/vault-managed-skills.d.ts +18 -0
  386. package/dist-lib/lib/core/vault-managed-skills.js +105 -0
  387. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  388. package/dist-lib/lib/core/video/attachment.js +7 -0
  389. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  390. package/dist-lib/lib/core/video/digest.js +57 -0
  391. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  392. package/dist-lib/lib/core/video/frames.js +224 -0
  393. package/dist-lib/lib/core/view-read.d.ts +4 -0
  394. package/dist-lib/lib/core/view-read.js +23 -0
  395. package/dist-lib/lib/core/workspace-upgrade.d.ts +23 -0
  396. package/dist-lib/lib/core/workspace-upgrade.js +51 -0
  397. package/dist-lib/lib/core.d.ts +345 -88
  398. package/dist-lib/lib/core.js +4275 -1513
  399. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  400. package/dist-lib/lib/credential-pusher.js +111 -62
  401. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  402. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  403. package/dist-lib/lib/custom-model-task.js +2 -2
  404. package/dist-lib/lib/device-tree.d.ts +18 -0
  405. package/dist-lib/lib/device-tree.js +32 -0
  406. package/dist-lib/lib/diagnostics.d.ts +7 -0
  407. package/dist-lib/lib/diagnostics.js +22 -0
  408. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  409. package/dist-lib/lib/doctor/checks.js +272 -0
  410. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  411. package/dist-lib/lib/doctor/redact.js +31 -0
  412. package/dist-lib/lib/doctor/render.d.ts +8 -0
  413. package/dist-lib/lib/doctor/render.js +83 -0
  414. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  415. package/dist-lib/lib/doctor/tree.js +167 -0
  416. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  417. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  418. package/dist-lib/lib/errors.d.ts +814 -0
  419. package/dist-lib/lib/errors.js +748 -0
  420. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  421. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  422. package/dist-lib/lib/guards.d.ts +1 -0
  423. package/dist-lib/lib/guards.js +4 -0
  424. package/dist-lib/lib/inference-calls.d.ts +1 -2
  425. package/dist-lib/lib/inference-calls.js +2 -10
  426. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  427. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  428. package/dist-lib/lib/knowledge-search.js +5 -51
  429. package/dist-lib/lib/kv-cache-ledger.d.ts +22 -0
  430. package/dist-lib/lib/kv-cache-ledger.js +72 -0
  431. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  432. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  433. package/dist-lib/lib/kv-cache-retention.d.ts +36 -0
  434. package/dist-lib/lib/kv-cache-retention.js +101 -0
  435. package/dist-lib/lib/latest-frame.d.ts +10 -0
  436. package/dist-lib/lib/latest-frame.js +48 -0
  437. package/dist-lib/lib/llm-model-names.d.ts +1 -1
  438. package/dist-lib/lib/llm-model-names.js +1 -1
  439. package/dist-lib/lib/log.d.ts +7 -6
  440. package/dist-lib/lib/log.js +14 -7
  441. package/dist-lib/lib/logger-type.d.ts +2 -5
  442. package/dist-lib/lib/mesh-scoped-engine.js +47 -2
  443. package/dist-lib/lib/model-context.js +1 -2
  444. package/dist-lib/lib/model-download-status.d.ts +3 -3
  445. package/dist-lib/lib/model-download.d.ts +22 -13
  446. package/dist-lib/lib/model-download.js +106 -37
  447. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  448. package/dist-lib/lib/model-memory-cap.d.ts +30 -0
  449. package/dist-lib/lib/model-memory-cap.js +78 -0
  450. package/dist-lib/lib/models-watch.d.ts +1 -1
  451. package/dist-lib/lib/models-watch.js +4 -4
  452. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  453. package/dist-lib/lib/oauth/flow-core.js +5 -3
  454. package/dist-lib/lib/oauth/flow.js +1 -1
  455. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  456. package/dist-lib/lib/oauth/loopback.js +57 -12
  457. package/dist-lib/lib/oauth/providers.js +4 -2
  458. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  459. package/dist-lib/lib/oauth/register.js +35 -19
  460. package/dist-lib/lib/oauth/request.d.ts +10 -0
  461. package/dist-lib/lib/oauth/request.js +22 -0
  462. package/dist-lib/lib/oauth/resolve.js +42 -13
  463. package/dist-lib/lib/oauth/token-exchange-core.js +40 -31
  464. package/dist-lib/lib/oauth/types.d.ts +3 -0
  465. package/dist-lib/lib/oauth.d.ts +2 -1
  466. package/dist-lib/lib/oauth.js +1 -0
  467. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  468. package/dist-lib/lib/persistent-dir.js +9 -0
  469. package/dist-lib/lib/probe-rounds.d.ts +8 -0
  470. package/dist-lib/lib/probe-rounds.js +10 -0
  471. package/dist-lib/lib/reconnecting-watch.js +19 -11
  472. package/dist-lib/lib/run-input.d.ts +14 -0
  473. package/dist-lib/lib/run-input.js +33 -0
  474. package/dist-lib/lib/run-notices.d.ts +5 -0
  475. package/dist-lib/lib/run-notices.js +13 -2
  476. package/dist-lib/lib/run-replay.d.ts +45 -0
  477. package/dist-lib/lib/run-replay.js +169 -0
  478. package/dist-lib/lib/run-transcript.d.ts +13 -12
  479. package/dist-lib/lib/run-transcript.js +20 -19
  480. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  481. package/dist-lib/lib/task.js +6 -4
  482. package/dist-lib/lib/test-env.d.ts +1 -0
  483. package/dist-lib/lib/test-env.js +4 -0
  484. package/dist-lib/schema/build.js +66 -55
  485. package/dist-lib/schema/config.d.ts +1 -1
  486. package/dist-lib/schema/config.js +1 -1
  487. package/dist-lib/schema/content.d.ts +5 -1
  488. package/dist-lib/schema/content.js +60 -12
  489. package/dist-lib/schema/engine.d.ts +1 -0
  490. package/dist-lib/schema/engine.js +941 -152
  491. package/dist-lib/schema/field-order.js +8 -1
  492. package/dist-lib/schema/indexes.d.ts +10 -0
  493. package/dist-lib/schema/indexes.js +53 -3
  494. package/dist-lib/schema/local.js +83 -5
  495. package/dist-lib/schema/qvac.d.ts +4 -1
  496. package/dist-lib/schema/qvac.js +558 -16
  497. package/dist-lib/spec/bind.js +261 -48
  498. package/dist-lib/spec/calls.js +56 -5
  499. package/dist-lib/spec/capabilities.d.ts +129 -20
  500. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  501. package/dist-lib/spec/hrpc/hrpc.json +870 -207
  502. package/dist-lib/spec/hrpc/index.js +969 -347
  503. package/dist-lib/spec/hrpc/messages.js +7590 -4896
  504. package/dist-lib/spec/hyperschema/index.js +7590 -4896
  505. package/dist-lib/spec/hyperschema/schema.json +5316 -3224
  506. package/dist-lib/spec/hyperschema/types.d.ts +576 -62
  507. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  508. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  509. package/dist-lib/spec/local/hyperdb/messages.js +1588 -488
  510. package/dist-lib/spec/local/hyperschema/index.js +584 -16
  511. package/dist-lib/spec/local/hyperschema/schema.json +369 -1
  512. package/dist-lib/spec/local/hyperschema/types.d.ts +88 -2
  513. package/dist-lib/spec/mesh/hyperdb/db.json +711 -9
  514. package/dist-lib/spec/mesh/hyperdb/index.js +2769 -7
  515. package/dist-lib/spec/mesh/hyperdb/messages.js +7140 -1298
  516. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +205 -1
  517. package/dist-lib/spec/mesh/hyperdispatch/index.js +579 -1
  518. package/dist-lib/spec/mesh/hyperdispatch/messages.js +4017 -267
  519. package/dist-lib/spec/mesh/hyperschema/index.js +4017 -267
  520. package/dist-lib/spec/mesh/hyperschema/schema.json +2193 -19
  521. package/dist-lib/spec/mesh/hyperschema/types.d.ts +550 -6
  522. package/package.json +136 -90
  523. package/tui/README.md +119 -20
  524. package/tui/app.mjs +2000 -621
  525. package/tui/boot.mjs +74 -9
  526. package/tui/cli.mjs +93 -0
  527. package/tui/index.mjs +2 -51
  528. package/tui/lib/connect-sheet.mjs +350 -0
  529. package/tui/lib/device-target.mjs +64 -0
  530. package/tui/lib/folders-command.mjs +84 -0
  531. package/tui/lib/fork-command.mjs +43 -0
  532. package/tui/lib/knowledge-import.mjs +3 -21
  533. package/tui/lib/local-path.mjs +21 -0
  534. package/tui/lib/move-command.mjs +17 -0
  535. package/tui/lib/render.mjs +30 -1
  536. package/tui/lib/setup.mjs +59 -25
  537. package/tui/lib/skill-connect.mjs +145 -0
  538. package/tui/lib/updater.mjs +86 -0
  539. package/tui/main.mjs +44 -18
  540. package/tui/plugins.mjs +158 -0
  541. package/worker/assistant-sidecar.mjs +28 -4
  542. package/worker/stow-entry.mjs +3 -50
  543. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  544. package/dist-lib/lib/core/contract/compute.js +0 -48
  545. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  546. package/dist-lib/lib/core/device-invites.js +0 -63
  547. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  548. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  549. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  550. package/dist-lib/lib/core/grant-expiry.js +0 -66
  551. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  552. package/dist-lib/lib/core/handoff-channel.js +0 -123
  553. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  554. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  555. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  556. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  557. package/dist-lib/lib/core/hosted-agents.js +0 -140
  558. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  559. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  560. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  561. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  562. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  563. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  564. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  565. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  566. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  567. package/dist-lib/lib/core/secret-handoff.js +0 -29
  568. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  569. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  570. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  571. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  572. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  573. package/dist-lib/lib/image-cache-dir.js +0 -5
  574. package/dist-lib/lib/log-levels.d.ts +0 -7
  575. package/dist-lib/lib/log-levels.js +0 -1
  576. package/dist-lib/lib/logger.d.ts +0 -5
  577. package/dist-lib/lib/logger.js +0 -18
  578. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  579. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
@@ -1,6 +1,6 @@
1
1
  import type { Harness } from './assistant.ts';
2
2
  import { type ConfigEngine } from './oauth.ts';
3
- import type { OAuthRouteLike } from './oauth/keys.ts';
3
+ import type { OAuthKeySpec, OAuthRouteLike } from './oauth/keys.ts';
4
4
  export interface CredentialEntry {
5
5
  key: string;
6
6
  token?: string | null;
@@ -14,19 +14,21 @@ export interface SettingEntry {
14
14
  value: string;
15
15
  agentId?: string | null;
16
16
  }
17
+ type PusherRoute = OAuthRouteLike & {
18
+ fields?: ReadonlyArray<{
19
+ key: string;
20
+ secret?: boolean;
21
+ }>;
22
+ };
17
23
  export interface PusherSkill {
18
24
  name: string;
25
+ origin?: string;
19
26
  credentials?: readonly string[];
20
27
  requires?: {
21
28
  credentials?: readonly string[];
22
29
  };
23
30
  setup?: {
24
- routes?: ReadonlyArray<OAuthRouteLike & {
25
- fields?: ReadonlyArray<{
26
- key: string;
27
- secret?: boolean;
28
- }>;
29
- }>;
31
+ routes?: ReadonlyArray<PusherRoute>;
30
32
  };
31
33
  }
32
34
  export interface CredentialEngine extends ConfigEngine {
@@ -35,6 +37,11 @@ export interface CredentialEngine extends ConfigEngine {
35
37
  }): AsyncIterable<unknown> & {
36
38
  destroy(): void;
37
39
  };
40
+ agentsWatch(req: {
41
+ meshId: string;
42
+ }): AsyncIterable<unknown> & {
43
+ destroy(): void;
44
+ };
38
45
  account(req: {}): Promise<{
39
46
  meshId?: string | null;
40
47
  }>;
@@ -58,9 +65,12 @@ export interface CredentialPusherLogger {
58
65
  }
59
66
  export type CredentialPusherHandle = (() => Promise<void>) & {
60
67
  sync(): Promise<void>;
68
+ ready(): Promise<void>;
61
69
  };
62
70
  export declare function nextRefreshDelay(entries: ReadonlyArray<Pick<CredentialEntry, 'expiresAt'>>, now?: number): number;
63
71
  export declare function credentialOwners(catalog: ReadonlyArray<PusherSkill>): ReadonlyMap<string, readonly string[]>;
72
+ export declare function plainCredentialKeys(catalog: ReadonlyArray<PusherSkill>, specs: ReadonlyArray<OAuthKeySpec>): ReadonlyArray<string>;
64
73
  export declare function settingFields(catalog: ReadonlyArray<PusherSkill>): ReadonlyArray<Pick<SettingEntry, 'skill' | 'key'>>;
65
74
  export declare function settingConfigKey(agentId: string | undefined, skill: string, key: string): string;
66
75
  export declare function startCredentialPusher(harness: CredentialTarget, engine: CredentialEngine, logger?: CredentialPusherLogger | null): CredentialPusherHandle;
76
+ export {};
@@ -5,9 +5,10 @@ import { REFRESH_SKEW_MS, resolveOAuthCredential } from './oauth/resolve.js';
5
5
  import { buildProviderConfig } from './oauth/providers.js';
6
6
  import { refreshOAuthTokens } from './oauth/token-exchange.js';
7
7
  import ScopeLock from 'scope-lock';
8
- import { credentialSlots } from '@qvac/harness/lib/tools/skills/credential-slots.ts';
8
+ import { credentialSlots } from '@qvac/harness/skill-manifest';
9
9
  import { errorMessage } from './guards.js';
10
10
  const PLAIN_KEYS = ['github_access_token', OBSIDIAN_VAULT_PATH_CREDENTIAL_KEY];
11
+ const PLAIN_KEY = /^[A-Za-z0-9_-]+$/;
11
12
  const REFRESH_INTERVAL = 10 * 60 * 1000;
12
13
  const MIN_REFRESH_DELAY = 30_000;
13
14
  function storeKey(key, agentId) {
@@ -69,7 +70,7 @@ async function plainEntry(engine, key, agentId) {
69
70
  }
70
71
  export function credentialOwners(catalog) {
71
72
  const owners = new Map();
72
- for (const skill of catalog) {
73
+ for (const skill of trusted(catalog)) {
73
74
  for (const key of credentialSlots(skill).flat()) {
74
75
  const list = owners.get(key) ?? [];
75
76
  if (!list.includes(skill.name)) {
@@ -80,6 +81,37 @@ export function credentialOwners(catalog) {
80
81
  }
81
82
  return owners;
82
83
  }
84
+ function trusted(catalog) {
85
+ return catalog.filter((skill) => skill.origin !== 'overlay');
86
+ }
87
+ export function plainCredentialKeys(catalog, specs) {
88
+ const oauth = new Set(specs.map((spec) => spec.credentialKey));
89
+ const reserved = new Set();
90
+ const declared = new Set(PLAIN_KEYS);
91
+ for (const skill of trusted(catalog)) {
92
+ for (const key of credentialSlots(skill).flat()) {
93
+ declared.add(key);
94
+ }
95
+ for (const route of skill.setup?.routes ?? []) {
96
+ routeKeys(route, route.oauth ? reserved : declared);
97
+ }
98
+ }
99
+ const allowed = (key) => PLAIN_KEYS.includes(key) || (!reserved.has(key) && PLAIN_KEY.test(key));
100
+ return [...declared].filter((key) => !oauth.has(key) && allowed(key));
101
+ }
102
+ function routeKeys(route, into) {
103
+ if (route.oauth?.stateKey) {
104
+ into.add(route.oauth.stateKey);
105
+ }
106
+ if (route.credentialKey && !route.oauth) {
107
+ into.add(route.credentialKey);
108
+ }
109
+ for (const field of route.fields ?? []) {
110
+ if (route.oauth || field.secret === true) {
111
+ into.add(field.key);
112
+ }
113
+ }
114
+ }
83
115
  export function settingFields(catalog) {
84
116
  const fields = [];
85
117
  for (const skill of catalog) {
@@ -101,52 +133,38 @@ function fanOut(entry, owners) {
101
133
  const skills = owners.get(entry.key) ?? [];
102
134
  return skills.length > 0 ? skills.map((skill) => ({ ...entry, skill })) : [entry];
103
135
  }
104
- async function resolveScope(agentId, { engine, last, owners, specs, logger }) {
105
- const entries = [];
106
- for (const spec of specs) {
107
- const mk = storeKey(spec.credentialKey, agentId);
108
- try {
109
- const entry = await oauthEntry(engine, spec, agentId);
110
- if (entry) {
111
- last.set(mk, entry);
112
- entries.push(...fanOut(entry, owners));
113
- }
114
- else {
115
- last.delete(mk);
116
- }
117
- }
118
- catch (err) {
119
- logger?.warn('credential-pusher', `credential resolve failed for ${spec.credentialKey}`, errorMessage(err));
120
- const kept = last.get(mk);
121
- if (kept) {
122
- entries.push(...fanOut(kept, owners));
123
- }
136
+ async function resolveEntry({ mk, failure, read }, { last, owners, logger }) {
137
+ try {
138
+ const entry = await read();
139
+ if (!entry) {
140
+ last.delete(mk);
141
+ return [];
124
142
  }
143
+ last.set(mk, entry);
144
+ return fanOut(entry, owners);
125
145
  }
126
- const specKeys = new Set(specs.map((spec) => spec.credentialKey));
127
- for (const key of PLAIN_KEYS) {
128
- if (specKeys.has(key))
129
- continue;
130
- const mk = storeKey(key, agentId);
131
- try {
132
- const entry = await plainEntry(engine, key, agentId);
133
- if (entry) {
134
- last.set(mk, entry);
135
- entries.push(...fanOut(entry, owners));
136
- }
137
- else {
138
- last.delete(mk);
139
- }
140
- }
141
- catch (err) {
142
- logger?.warn('credential-pusher', `credential read failed for ${key}`, errorMessage(err));
143
- const kept = last.get(mk);
144
- if (kept) {
145
- entries.push(...fanOut(kept, owners));
146
- }
147
- }
146
+ catch (err) {
147
+ logger?.warn('credential-pusher', failure, errorMessage(err));
148
+ const kept = last.get(mk);
149
+ return kept ? fanOut(kept, owners) : [];
148
150
  }
149
- return entries;
151
+ }
152
+ async function resolveScope(agentId, resolution) {
153
+ const { engine, specs, plainKeys } = resolution;
154
+ const pending = [
155
+ ...specs.map((spec) => ({
156
+ mk: storeKey(spec.credentialKey, agentId),
157
+ failure: `credential resolve failed for ${spec.credentialKey}`,
158
+ read: () => oauthEntry(engine, spec, agentId)
159
+ })),
160
+ ...plainKeys.map((key) => ({
161
+ mk: storeKey(key, agentId),
162
+ failure: `credential read failed for ${key}`,
163
+ read: () => plainEntry(engine, key, agentId)
164
+ }))
165
+ ];
166
+ const resolved = await Promise.all(pending.map((entry) => resolveEntry(entry, resolution)));
167
+ return resolved.flat();
150
168
  }
151
169
  async function resolveSettings(engine, scopes, { catalog, logger }) {
152
170
  const fields = settingFields(catalog);
@@ -174,14 +192,22 @@ async function resolveSettings(engine, scopes, { catalog, logger }) {
174
192
  }
175
193
  return entries;
176
194
  }
195
+ async function accountScopes(engine) {
196
+ const { meshId } = await engine.account({});
197
+ const ids = meshId
198
+ ? ((await engine.listAgents({ meshId })).agents ?? []).map((agent) => agent.id)
199
+ : [];
200
+ return { meshId, scopes: [undefined, ...ids] };
201
+ }
177
202
  export function startCredentialPusher(harness, engine, logger) {
178
203
  const last = new Map();
179
204
  const watches = new Map();
205
+ const agentLists = new Map();
180
206
  let disposed = false;
181
207
  let timer = null;
182
208
  const pushLock = new ScopeLock({ debounce: true });
183
209
  const watch = (key) => {
184
- const stream = engine.configWatch({ key: scopedKey(undefined, key) });
210
+ const stream = engine.configWatch({ key });
185
211
  watches.set(key, stream);
186
212
  (async () => {
187
213
  for await (const _ of stream) {
@@ -197,10 +223,11 @@ export function startCredentialPusher(harness, engine, logger) {
197
223
  logger?.warn('credential-pusher', `credential watch ended for ${key}`, errorMessage(err));
198
224
  });
199
225
  };
200
- const syncWatches = (oauthKeys) => {
226
+ const syncWatches = (pushedKeys, scopes) => {
201
227
  if (disposed)
202
228
  return;
203
- const wanted = new Set([...oauthKeys, ...PLAIN_KEYS]);
229
+ const keys = new Set(pushedKeys);
230
+ const wanted = new Set(scopes.flatMap((agentId) => [...keys].map((key) => scopedKey(agentId, key))));
204
231
  for (const [key, stream] of watches) {
205
232
  if (wanted.has(key))
206
233
  continue;
@@ -217,11 +244,34 @@ export function startCredentialPusher(harness, engine, logger) {
217
244
  }
218
245
  for (const mk of last.keys()) {
219
246
  const key = mk.includes('\0') ? mk.slice(mk.indexOf('\0') + 1) : mk;
220
- if (!wanted.has(key)) {
247
+ if (!keys.has(key)) {
221
248
  last.delete(mk);
222
249
  }
223
250
  }
224
251
  };
252
+ const syncAgentsWatch = (meshId) => {
253
+ if (disposed)
254
+ return;
255
+ for (const [id, stream] of agentLists) {
256
+ if (id === meshId)
257
+ continue;
258
+ try {
259
+ stream.destroy();
260
+ }
261
+ catch { }
262
+ agentLists.delete(id);
263
+ }
264
+ if (!meshId || agentLists.has(meshId)) {
265
+ return;
266
+ }
267
+ const stream = engine.agentsWatch({ meshId });
268
+ agentLists.set(meshId, stream);
269
+ (async () => {
270
+ for await (const _ of stream) {
271
+ schedule();
272
+ }
273
+ })().catch(noop);
274
+ };
225
275
  const armTimer = (delay) => {
226
276
  if (disposed)
227
277
  return;
@@ -253,16 +303,13 @@ export function startCredentialPusher(harness, engine, logger) {
253
303
  }
254
304
  const owners = credentialOwners(skills);
255
305
  const specs = oauthSpecs(skills);
256
- syncWatches(specs.map((spec) => spec.credentialKey));
257
- const { meshId } = await engine.account({});
258
- const ids = meshId
259
- ? ((await engine.listAgents({ meshId })).agents ?? []).map((agent) => agent.id)
260
- : [];
261
- const scopes = [undefined, ...ids];
262
- const resolution = { engine, last, owners, specs, logger };
263
- for (const agentId of scopes) {
264
- entries.push(...(await resolveScope(agentId, resolution)));
265
- }
306
+ const plainKeys = plainCredentialKeys(skills, specs);
307
+ const { meshId, scopes } = await accountScopes(engine);
308
+ syncWatches([...specs.map((spec) => spec.credentialKey), ...plainKeys], scopes);
309
+ syncAgentsWatch(meshId);
310
+ const resolution = { engine, last, owners, specs, plainKeys, logger };
311
+ const resolved = await Promise.all(scopes.map((agentId) => resolveScope(agentId, resolution)));
312
+ entries.push(...resolved.flat());
266
313
  if (disposed) {
267
314
  return;
268
315
  }
@@ -317,7 +364,7 @@ export function startCredentialPusher(harness, engine, logger) {
317
364
  pushLock.unlock();
318
365
  }
319
366
  };
320
- schedule();
367
+ const first = schedule();
321
368
  const stop = async () => {
322
369
  if (disposed)
323
370
  return;
@@ -326,15 +373,17 @@ export function startCredentialPusher(harness, engine, logger) {
326
373
  clearTimeout(timer);
327
374
  }
328
375
  timer = null;
329
- for (const stream of watches.values()) {
376
+ for (const stream of [...watches.values(), ...agentLists.values()]) {
330
377
  try {
331
378
  stream.destroy();
332
379
  }
333
380
  catch { }
334
381
  }
335
382
  watches.clear();
383
+ agentLists.clear();
336
384
  pushLock.destroy();
337
385
  await pushLock.flush();
338
386
  };
339
- return Object.assign(stop, { sync });
387
+ return Object.assign(stop, { sync, ready: () => first });
340
388
  }
389
+ function noop() { }
@@ -1,12 +1,10 @@
1
1
  import type { Harness } from './assistant.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
2
3
  import type { openLocalStore } from './core/local/index.ts';
3
4
  type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
4
- interface Logger {
5
- warn(...args: unknown[]): void;
6
- }
7
5
  export type CustomModelTarget = Pick<Harness, 'setCustomModels'>;
8
6
  export interface CustomModelPusherOptions {
9
- logger?: Logger | null;
7
+ logger?: LoggerInterface | null;
10
8
  onPushed?: () => void;
11
9
  }
12
10
  export declare function startCustomModelPusher(harness: CustomModelTarget, state: LocalStore, opts?: CustomModelPusherOptions): () => Promise<void>;
@@ -1 +1,2 @@
1
- export declare function customModelTaskRefusal(taskType: string | null | undefined): string | null;
1
+ import { CoreError } from './errors.ts';
2
+ export declare function customModelTaskRefusal(taskType: string | null | undefined): CoreError<'CUSTOM_MODEL_TASK_UNSUPPORTED'> | null;
@@ -1,3 +1,4 @@
1
+ import { CoreError } from './errors.js';
1
2
  const TASK_NAMES = {
2
3
  embeddings: 'embedding',
3
4
  'speech-to-text': 'speech-to-text',
@@ -7,6 +8,5 @@ const TASK_NAMES = {
7
8
  export function customModelTaskRefusal(taskType) {
8
9
  if (!taskType || taskType === 'llm')
9
10
  return null;
10
- const task = TASK_NAMES[taskType] ?? taskType;
11
- return `This is ${/^[aeiou]/i.test(task) ? 'an' : 'a'} ${task} model. Custom models run as the assistant's text model only.`;
11
+ return new CoreError('CUSTOM_MODEL_TASK_UNSUPPORTED', [TASK_NAMES[taskType] ?? taskType]);
12
12
  }
@@ -0,0 +1,18 @@
1
+ import Supervisor from 'bare-supervisor';
2
+ import type { Transport } from '@qvac/harness/rpc';
3
+ import type { LoggerInterface } from '@qvac/logging';
4
+ import { type AssistantChildOptions } from './assistant-tree.ts';
5
+ import { Core, type CoreOptions } from './core.ts';
6
+ export interface DeviceTreeOptions {
7
+ core: Omit<CoreOptions, 'apiLifecycle'>;
8
+ assistant: Omit<AssistantChildOptions, 'core'>;
9
+ office?: {
10
+ close: () => unknown;
11
+ };
12
+ logger?: LoggerInterface | null;
13
+ }
14
+ export interface DeviceTree {
15
+ supervisor: Supervisor;
16
+ core: Core;
17
+ }
18
+ export declare function deviceTree(transport: Transport, opts: DeviceTreeOptions): DeviceTree;
@@ -0,0 +1,32 @@
1
+ import Supervisor from 'bare-supervisor';
2
+ import { assistantChild } from './assistant-tree.js';
3
+ import { Core } from './core.js';
4
+ export function deviceTree(transport, opts) {
5
+ const { office, logger = null } = opts;
6
+ const supervisor = new Supervisor();
7
+ const core = new Core(transport, {
8
+ ...opts.core,
9
+ apiLifecycle: {
10
+ suspend: () => supervisor.suspend(),
11
+ resume: () => supervisor.resume()
12
+ }
13
+ });
14
+ if (office) {
15
+ supervisor.add('office', { start: () => office });
16
+ }
17
+ supervisor.add('core', {
18
+ deps: office ? ['office'] : [],
19
+ start: () => core,
20
+ presuspend: (handle) => handle.presuspend(),
21
+ suspend: (handle) => handle.suspend(),
22
+ wakeup: (handle) => handle.wakeup(),
23
+ resume: (handle) => handle.resume()
24
+ });
25
+ supervisor.add('assistant', assistantChild({ logger, ...opts.assistant }));
26
+ for (const event of ['child-died', 'child-restarting', 'stall']) {
27
+ supervisor.on(event, (payload) => logger?.warn('device-tree', event, { ...payload, error: payload.error?.message }));
28
+ }
29
+ supervisor.on('gave-up', ({ name, error }) => logger?.error('device-tree', `${name} gave up`, error?.message));
30
+ supervisor.on('power', (payload) => logger?.info('device-tree', 'power', payload));
31
+ return { supervisor, core };
32
+ }
@@ -21,11 +21,18 @@ export interface AssistantDiagnostics {
21
21
  activeChats: number;
22
22
  queued: number;
23
23
  }
24
+ export interface BackendUse {
25
+ requestedGpu: boolean;
26
+ device: string;
27
+ backend: string;
28
+ }
24
29
  export interface DiagnosticsSlice {
25
30
  harness: HarnessDiagnostics | null;
26
31
  assistant: AssistantDiagnostics;
27
32
  platform: string;
28
33
  mobileClass: boolean;
29
34
  memoryBudget: MemoryBudget | null;
35
+ backendUse: Record<string, BackendUse[]>;
30
36
  }
37
+ export declare function recordBackends(into: Map<string, BackendUse[]>, backends: unknown): void;
31
38
  export declare function summarizeRuns(runs: Iterable<RunSummary>, suspended: boolean): AssistantDiagnostics;
@@ -1,3 +1,25 @@
1
+ import * as z from 'zod';
2
+ const BACKEND_USES_KEPT = 5;
3
+ const RunBackendUse = z.object({
4
+ tool: z.string(),
5
+ requestedGpu: z.boolean(),
6
+ device: z.string(),
7
+ backend: z.string()
8
+ });
9
+ export function recordBackends(into, backends) {
10
+ if (!Array.isArray(backends)) {
11
+ return;
12
+ }
13
+ for (const raw of backends) {
14
+ const parsed = RunBackendUse.safeParse(raw);
15
+ if (!parsed.success) {
16
+ continue;
17
+ }
18
+ const { tool, requestedGpu, device, backend } = parsed.data;
19
+ const uses = [...(into.get(tool) ?? []), { requestedGpu, device, backend }];
20
+ into.set(tool, uses.slice(-BACKEND_USES_KEPT));
21
+ }
22
+ }
1
23
  export function summarizeRuns(runs, suspended) {
2
24
  const list = [];
3
25
  const chats = new Set();
@@ -0,0 +1,15 @@
1
+ export type CheckState = 'pass' | 'warn' | 'fail' | 'declared' | 'pending';
2
+ export interface Verdict {
3
+ state: CheckState;
4
+ detail: string;
5
+ fix?: string | undefined;
6
+ }
7
+ export interface Check extends Verdict {
8
+ group: string;
9
+ name: string;
10
+ }
11
+ export interface Samples {
12
+ first: unknown;
13
+ second?: unknown;
14
+ }
15
+ export declare function runChecks(samples: Samples): Check[];