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

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 (509) hide show
  1. package/CHANGELOG.md +852 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +0 -1
  4. package/dist-lib/index.js +0 -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 +7 -0
  17. package/dist-lib/lib/api/chunk-delta.js +33 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +64 -13
  20. package/dist-lib/lib/api/config.d.ts +2 -1
  21. package/dist-lib/lib/api/config.js +3 -2
  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 +10 -8
  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 +20 -10
  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/host-run-log.d.ts +2 -41
  35. package/dist-lib/lib/api/host-run-log.js +35 -83
  36. package/dist-lib/lib/api/index.d.ts +28 -6
  37. package/dist-lib/lib/api/index.js +101 -33
  38. package/dist-lib/lib/api/instrument.d.ts +2 -2
  39. package/dist-lib/lib/api/instrument.js +12 -44
  40. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  41. package/dist-lib/lib/api/knowledge.js +25 -7
  42. package/dist-lib/lib/api/local-files.d.ts +5 -1
  43. package/dist-lib/lib/api/local-files.js +9 -5
  44. package/dist-lib/lib/api/logs.js +3 -3
  45. package/dist-lib/lib/api/members.d.ts +10 -1
  46. package/dist-lib/lib/api/members.js +64 -17
  47. package/dist-lib/lib/api/mesh.d.ts +12 -2
  48. package/dist-lib/lib/api/mesh.js +10 -6
  49. package/dist-lib/lib/api/model-download.d.ts +2 -1
  50. package/dist-lib/lib/api/model-download.js +2 -2
  51. package/dist-lib/lib/api/network.d.ts +10 -2
  52. package/dist-lib/lib/api/network.js +8 -2
  53. package/dist-lib/lib/api/notifications.d.ts +3 -1
  54. package/dist-lib/lib/api/notifications.js +6 -5
  55. package/dist-lib/lib/api/projects.d.ts +20 -0
  56. package/dist-lib/lib/api/projects.js +165 -0
  57. package/dist-lib/lib/api/rag.d.ts +0 -1
  58. package/dist-lib/lib/api/rag.js +47 -23
  59. package/dist-lib/lib/api/served.d.ts +17 -0
  60. package/dist-lib/lib/api/served.js +47 -0
  61. package/dist-lib/lib/api/sync.d.ts +2 -1
  62. package/dist-lib/lib/api/sync.js +2 -2
  63. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  64. package/dist-lib/lib/api/tool-activity.js +4 -3
  65. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-configs.js +6 -9
  67. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  68. package/dist-lib/lib/api/upload-frames.js +0 -1
  69. package/dist-lib/lib/api/watchable.d.ts +3 -2
  70. package/dist-lib/lib/api/watchable.js +2 -3
  71. package/dist-lib/lib/api/workspace.d.ts +5 -0
  72. package/dist-lib/lib/api/workspace.js +48 -0
  73. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  74. package/dist-lib/lib/assistant/fake-models.js +112 -0
  75. package/dist-lib/lib/assistant/harness.d.ts +29 -29
  76. package/dist-lib/lib/assistant/harness.js +34 -6
  77. package/dist-lib/lib/assistant/history.d.ts +30 -17
  78. package/dist-lib/lib/assistant/history.js +168 -82
  79. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  80. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  81. package/dist-lib/lib/assistant/message.d.ts +21 -0
  82. package/dist-lib/lib/assistant/message.js +43 -0
  83. package/dist-lib/lib/assistant/model-round.d.ts +95 -0
  84. package/dist-lib/lib/assistant/model-round.js +591 -0
  85. package/dist-lib/lib/assistant/pdf-budget.d.ts +3 -0
  86. package/dist-lib/lib/assistant/pdf-budget.js +13 -0
  87. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  88. package/dist-lib/lib/assistant/round-host.js +239 -0
  89. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  90. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  91. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  92. package/dist-lib/lib/assistant/video-budget.js +29 -0
  93. package/dist-lib/lib/assistant-client.d.ts +2 -0
  94. package/dist-lib/lib/assistant-client.js +4 -3
  95. package/dist-lib/lib/assistant-tree.d.ts +8 -3
  96. package/dist-lib/lib/assistant-tree.js +58 -18
  97. package/dist-lib/lib/assistant.d.ts +76 -20
  98. package/dist-lib/lib/assistant.js +1659 -1070
  99. package/dist-lib/lib/audio-format.js +1 -1
  100. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  101. package/dist-lib/lib/chat-suggestion.js +47 -0
  102. package/dist-lib/lib/client.d.ts +2 -2
  103. package/dist-lib/lib/constants.d.ts +7 -0
  104. package/dist-lib/lib/constants.js +7 -0
  105. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  106. package/dist-lib/lib/core/agent-copies.js +40 -0
  107. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  108. package/dist-lib/lib/core/agent-hosting.js +71 -0
  109. package/dist-lib/lib/core/agent.d.ts +9 -1
  110. package/dist-lib/lib/core/agent.js +45 -19
  111. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  112. package/dist-lib/lib/core/archived-mesh.js +77 -58
  113. package/dist-lib/lib/core/async-iterable.js +1 -1
  114. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  115. package/dist-lib/lib/core/blind-peers.js +1 -0
  116. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  117. package/dist-lib/lib/core/chat-activity.js +36 -22
  118. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  119. package/dist-lib/lib/core/chat-copy.js +395 -0
  120. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  121. package/dist-lib/lib/core/chat-fork.js +245 -0
  122. package/dist-lib/lib/core/chat-group.js +8 -7
  123. package/dist-lib/lib/core/chat-move.d.ts +71 -0
  124. package/dist-lib/lib/core/chat-move.js +567 -0
  125. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  126. package/dist-lib/lib/core/chat-order.js +19 -4
  127. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  128. package/dist-lib/lib/core/chat-project.js +15 -0
  129. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  130. package/dist-lib/lib/core/chat-read.js +49 -0
  131. package/dist-lib/lib/core/chat-search.js +14 -12
  132. package/dist-lib/lib/core/chat.d.ts +34 -4
  133. package/dist-lib/lib/core/chat.js +122 -39
  134. package/dist-lib/lib/core/chunk.d.ts +21 -4
  135. package/dist-lib/lib/core/chunk.js +138 -23
  136. package/dist-lib/lib/core/collections.d.ts +28 -0
  137. package/dist-lib/lib/core/collections.js +28 -0
  138. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  139. package/dist-lib/lib/core/contract/agent-join.js +108 -0
  140. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  141. package/dist-lib/lib/core/contract/agents.js +141 -3
  142. package/dist-lib/lib/core/contract/chat.d.ts +1 -0
  143. package/dist-lib/lib/core/contract/chat.js +42 -3
  144. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  145. package/dist-lib/lib/core/contract/chunks.js +112 -35
  146. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  147. package/dist-lib/lib/core/contract/index.js +35 -11
  148. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  149. package/dist-lib/lib/core/contract/indexing.js +51 -7
  150. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  151. package/dist-lib/lib/core/contract/invites.js +18 -9
  152. package/dist-lib/lib/core/contract/joined-meshes.js +2 -1
  153. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  154. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  155. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  156. package/dist-lib/lib/core/contract/members.js +34 -4
  157. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  158. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  159. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  160. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  161. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  162. package/dist-lib/lib/core/contract/mesh-rules.js +31 -0
  163. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  164. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  165. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  166. package/dist-lib/lib/core/contract/model-requests.js +279 -0
  167. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  168. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  169. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  170. package/dist-lib/lib/core/contract/open-join.js +77 -0
  171. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  172. package/dist-lib/lib/core/contract/project-device-keys.js +29 -0
  173. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  174. package/dist-lib/lib/core/contract/project-host-keys.js +40 -0
  175. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/project-order.js +25 -0
  177. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  178. package/dist-lib/lib/core/contract/projects.js +328 -0
  179. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  180. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  181. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  182. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  183. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  184. package/dist-lib/lib/core/contract/roles.js +120 -0
  185. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  186. package/dist-lib/lib/core/contract/run-requests.js +75 -0
  187. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  188. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  189. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  190. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  191. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  192. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  193. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  194. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  195. package/dist-lib/lib/core/contract/workspace.js +317 -0
  196. package/dist-lib/lib/core/contract/writers.js +82 -12
  197. package/dist-lib/lib/core/departures.d.ts +16 -5
  198. package/dist-lib/lib/core/departures.js +79 -6
  199. package/dist-lib/lib/core/device-control.d.ts +21 -0
  200. package/dist-lib/lib/core/device-control.js +91 -0
  201. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  202. package/dist-lib/lib/core/device-seal.js +22 -0
  203. package/dist-lib/lib/core/devices.js +1 -1
  204. package/dist-lib/lib/core/document-attachment.d.ts +7 -0
  205. package/dist-lib/lib/core/document-attachment.js +9 -0
  206. package/dist-lib/lib/core/files/attachments.js +5 -4
  207. package/dist-lib/lib/core/files/index.d.ts +21 -11
  208. package/dist-lib/lib/core/files/index.js +114 -28
  209. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  210. package/dist-lib/lib/core/files/knowledge.js +77 -5
  211. package/dist-lib/lib/core/files/preview/index.js +6 -2
  212. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  213. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  214. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  215. package/dist-lib/lib/core/files/processing/document.js +26 -2
  216. package/dist-lib/lib/core/files/processing/index.d.ts +7 -2
  217. package/dist-lib/lib/core/files/processing/index.js +91 -71
  218. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  219. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  220. package/dist-lib/lib/core/files/processing/source.d.ts +3 -0
  221. package/dist-lib/lib/core/files/processing/source.js +9 -4
  222. package/dist-lib/lib/core/files/processing/state.d.ts +4 -1
  223. package/dist-lib/lib/core/files/processing/state.js +2 -1
  224. package/dist-lib/lib/core/files/rag/build.d.ts +4 -1
  225. package/dist-lib/lib/core/files/rag/build.js +18 -7
  226. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  227. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  228. package/dist-lib/lib/core/files/rag/index.d.ts +12 -1
  229. package/dist-lib/lib/core/files/rag/index.js +29 -7
  230. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  231. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  232. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  233. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  234. package/dist-lib/lib/core/files/rag/load.js +6 -3
  235. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  236. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  237. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  238. package/dist-lib/lib/core/files/rag/produce.js +30 -18
  239. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -1
  240. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  241. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  242. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  243. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  244. package/dist-lib/lib/core/files/records/index.js +1 -1
  245. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  246. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  247. package/dist-lib/lib/core/files/records/purge.js +13 -8
  248. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  249. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  250. package/dist-lib/lib/core/files/records/routing.js +6 -2
  251. package/dist-lib/lib/core/files/records/source.js +3 -5
  252. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  253. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  254. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  255. package/dist-lib/lib/core/files/store/blob.js +2 -2
  256. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  257. package/dist-lib/lib/core/files/store/index.js +4 -1
  258. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  259. package/dist-lib/lib/core/files/store/reference.js +12 -2
  260. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  261. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  262. package/dist-lib/lib/core/files/upload.js +53 -14
  263. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  264. package/dist-lib/lib/core/fs-drives.js +30 -18
  265. package/dist-lib/lib/core/id.d.ts +1 -0
  266. package/dist-lib/lib/core/id.js +3 -0
  267. package/dist-lib/lib/core/identity.d.ts +3 -1
  268. package/dist-lib/lib/core/identity.js +25 -4
  269. package/dist-lib/lib/core/invite.d.ts +4 -0
  270. package/dist-lib/lib/core/invite.js +19 -6
  271. package/dist-lib/lib/core/local/files.d.ts +2 -1
  272. package/dist-lib/lib/core/local/files.js +5 -7
  273. package/dist-lib/lib/core/local/index.d.ts +76 -6
  274. package/dist-lib/lib/core/local/index.js +209 -19
  275. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  276. package/dist-lib/lib/core/local/run-logs.js +132 -0
  277. package/dist-lib/lib/core/member-key.d.ts +7 -0
  278. package/dist-lib/lib/core/member-key.js +24 -0
  279. package/dist-lib/lib/core/membership.d.ts +3 -14
  280. package/dist-lib/lib/core/membership.js +3 -96
  281. package/dist-lib/lib/core/mesh.d.ts +94 -28
  282. package/dist-lib/lib/core/mesh.js +527 -144
  283. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  284. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  285. package/dist-lib/lib/core/migrations/file-index.js +2 -4
  286. package/dist-lib/lib/core/migrations/index.js +6 -2
  287. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  288. package/dist-lib/lib/core/model-requests.js +65 -0
  289. package/dist-lib/lib/core/next-frame.js +2 -1
  290. package/dist-lib/lib/core/notification.js +4 -2
  291. package/dist-lib/lib/core/pdf/rasterize.d.ts +2 -2
  292. package/dist-lib/lib/core/pdf/rasterize.js +5 -6
  293. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  294. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +47 -40
  295. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  296. package/dist-lib/lib/core/project-keys.js +56 -0
  297. package/dist-lib/lib/core/prompt-history.js +4 -4
  298. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  299. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  300. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  301. package/dist-lib/lib/core/public-mesh.js +88 -0
  302. package/dist-lib/lib/core/purge.d.ts +3 -0
  303. package/dist-lib/lib/core/purge.js +7 -0
  304. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  305. package/dist-lib/lib/core/run-driver.js +20 -0
  306. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  307. package/dist-lib/lib/core/run-requests.js +59 -0
  308. package/dist-lib/lib/core/send.d.ts +2 -0
  309. package/dist-lib/lib/core/send.js +17 -4
  310. package/dist-lib/lib/core/senders.d.ts +18 -0
  311. package/dist-lib/lib/core/senders.js +52 -0
  312. package/dist-lib/lib/core/shared-agents.d.ts +39 -0
  313. package/dist-lib/lib/core/shared-agents.js +255 -0
  314. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  315. package/dist-lib/lib/core/skill-secrets.js +90 -72
  316. package/dist-lib/lib/core/sync/background.d.ts +47 -0
  317. package/dist-lib/lib/core/sync/background.js +162 -0
  318. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  319. package/dist-lib/lib/core/sync/changed.js +7 -0
  320. package/dist-lib/lib/core/sync/devices.js +1 -1
  321. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  322. package/dist-lib/lib/core/sync/files.js +50 -72
  323. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  324. package/dist-lib/lib/core/sync/index.js +154 -81
  325. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  326. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  327. package/dist-lib/lib/core/system-info.d.ts +2 -2
  328. package/dist-lib/lib/core/system-info.js +10 -11
  329. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  330. package/dist-lib/lib/core/tool-configs.js +11 -11
  331. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  332. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  333. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  334. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  335. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  336. package/dist-lib/lib/core/video/attachment.js +7 -0
  337. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  338. package/dist-lib/lib/core/video/digest.js +57 -0
  339. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  340. package/dist-lib/lib/core/video/frames.js +224 -0
  341. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  342. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  343. package/dist-lib/lib/core.d.ts +249 -79
  344. package/dist-lib/lib/core.js +3369 -1460
  345. package/dist-lib/lib/credential-pusher.d.ts +6 -0
  346. package/dist-lib/lib/credential-pusher.js +77 -60
  347. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  348. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  349. package/dist-lib/lib/custom-model-task.js +2 -2
  350. package/dist-lib/lib/diagnostics.d.ts +7 -0
  351. package/dist-lib/lib/diagnostics.js +22 -0
  352. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  353. package/dist-lib/lib/doctor/checks.js +272 -0
  354. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  355. package/dist-lib/lib/doctor/redact.js +31 -0
  356. package/dist-lib/lib/doctor/render.d.ts +8 -0
  357. package/dist-lib/lib/doctor/render.js +83 -0
  358. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  359. package/dist-lib/lib/doctor/tree.js +167 -0
  360. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  361. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  362. package/dist-lib/lib/errors.d.ts +790 -0
  363. package/dist-lib/lib/errors.js +724 -0
  364. package/dist-lib/lib/fs-drive-bridge.d.ts +1 -1
  365. package/dist-lib/lib/fs-drive-bridge.js +4 -1
  366. package/dist-lib/lib/guards.d.ts +1 -0
  367. package/dist-lib/lib/guards.js +4 -0
  368. package/dist-lib/lib/inference-calls.d.ts +1 -2
  369. package/dist-lib/lib/inference-calls.js +2 -10
  370. package/dist-lib/lib/knowledge-search.js +13 -18
  371. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  372. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  373. package/dist-lib/lib/log.d.ts +7 -6
  374. package/dist-lib/lib/log.js +14 -7
  375. package/dist-lib/lib/logger-type.d.ts +2 -5
  376. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  377. package/dist-lib/lib/model-download-status.d.ts +3 -3
  378. package/dist-lib/lib/model-download.d.ts +11 -12
  379. package/dist-lib/lib/model-download.js +63 -22
  380. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  381. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  382. package/dist-lib/lib/model-memory-cap.js +69 -0
  383. package/dist-lib/lib/models-watch.d.ts +1 -1
  384. package/dist-lib/lib/models-watch.js +4 -4
  385. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  386. package/dist-lib/lib/oauth/flow-core.js +5 -3
  387. package/dist-lib/lib/oauth/flow.js +1 -1
  388. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  389. package/dist-lib/lib/oauth/loopback.js +57 -12
  390. package/dist-lib/lib/oauth/providers.js +4 -2
  391. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  392. package/dist-lib/lib/oauth/register.js +35 -19
  393. package/dist-lib/lib/oauth/request.d.ts +10 -0
  394. package/dist-lib/lib/oauth/request.js +22 -0
  395. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  396. package/dist-lib/lib/oauth/types.d.ts +3 -0
  397. package/dist-lib/lib/oauth.d.ts +2 -1
  398. package/dist-lib/lib/oauth.js +1 -0
  399. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  400. package/dist-lib/lib/persistent-dir.js +9 -0
  401. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  402. package/dist-lib/lib/probe-rounds.js +5 -0
  403. package/dist-lib/lib/run-input.d.ts +14 -0
  404. package/dist-lib/lib/run-input.js +33 -0
  405. package/dist-lib/lib/run-notices.d.ts +3 -0
  406. package/dist-lib/lib/run-notices.js +8 -2
  407. package/dist-lib/lib/run-replay.d.ts +32 -0
  408. package/dist-lib/lib/run-replay.js +121 -0
  409. package/dist-lib/lib/run-transcript.d.ts +11 -12
  410. package/dist-lib/lib/run-transcript.js +16 -18
  411. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  412. package/dist-lib/lib/task.js +6 -4
  413. package/dist-lib/lib/test-env.d.ts +1 -0
  414. package/dist-lib/lib/test-env.js +4 -0
  415. package/dist-lib/schema/build.js +3 -1
  416. package/dist-lib/schema/config.d.ts +1 -1
  417. package/dist-lib/schema/config.js +1 -1
  418. package/dist-lib/schema/content.d.ts +5 -1
  419. package/dist-lib/schema/content.js +58 -11
  420. package/dist-lib/schema/engine.d.ts +1 -0
  421. package/dist-lib/schema/engine.js +709 -116
  422. package/dist-lib/schema/field-order.js +2 -1
  423. package/dist-lib/schema/indexes.d.ts +3 -0
  424. package/dist-lib/schema/indexes.js +30 -3
  425. package/dist-lib/schema/local.js +72 -4
  426. package/dist-lib/schema/qvac.d.ts +4 -1
  427. package/dist-lib/schema/qvac.js +364 -12
  428. package/dist-lib/spec/bind.js +209 -48
  429. package/dist-lib/spec/calls.js +45 -5
  430. package/dist-lib/spec/capabilities.d.ts +98 -18
  431. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  432. package/dist-lib/spec/hrpc/hrpc.json +726 -206
  433. package/dist-lib/spec/hrpc/index.js +832 -345
  434. package/dist-lib/spec/hrpc/messages.js +6906 -4832
  435. package/dist-lib/spec/hyperschema/index.js +6906 -4832
  436. package/dist-lib/spec/hyperschema/schema.json +4744 -3139
  437. package/dist-lib/spec/hyperschema/types.d.ts +461 -61
  438. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  439. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  440. package/dist-lib/spec/local/hyperdb/messages.js +1506 -484
  441. package/dist-lib/spec/local/hyperschema/index.js +542 -13
  442. package/dist-lib/spec/local/hyperschema/schema.json +319 -1
  443. package/dist-lib/spec/local/hyperschema/types.d.ts +78 -2
  444. package/dist-lib/spec/mesh/hyperdb/db.json +371 -5
  445. package/dist-lib/spec/mesh/hyperdb/index.js +1564 -5
  446. package/dist-lib/spec/mesh/hyperdb/messages.js +6023 -1246
  447. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +187 -1
  448. package/dist-lib/spec/mesh/hyperdispatch/index.js +528 -1
  449. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3449 -217
  450. package/dist-lib/spec/mesh/hyperschema/index.js +3449 -217
  451. package/dist-lib/spec/mesh/hyperschema/schema.json +1865 -19
  452. package/dist-lib/spec/mesh/hyperschema/types.d.ts +470 -6
  453. package/package.json +50 -35
  454. package/worker/assistant-sidecar.mjs +15 -2
  455. package/worker/stow-entry.mjs +2 -0
  456. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  457. package/dist-lib/lib/core/contract/compute.js +0 -48
  458. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  459. package/dist-lib/lib/core/device-invites.js +0 -63
  460. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  461. package/dist-lib/lib/core/grant-expiry.js +0 -66
  462. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  463. package/dist-lib/lib/core/handoff-channel.js +0 -123
  464. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  465. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  466. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  467. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  468. package/dist-lib/lib/core/hosted-agents.js +0 -140
  469. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  470. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  471. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  472. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  473. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  474. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  475. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  476. package/dist-lib/lib/core/secret-handoff.js +0 -29
  477. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  478. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  479. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  480. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  481. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  482. package/dist-lib/lib/image-cache-dir.js +0 -5
  483. package/dist-lib/lib/log-levels.d.ts +0 -7
  484. package/dist-lib/lib/log-levels.js +0 -1
  485. package/dist-lib/lib/logger.d.ts +0 -5
  486. package/dist-lib/lib/logger.js +0 -18
  487. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  488. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  489. package/tui/README.md +0 -142
  490. package/tui/app.mjs +0 -6939
  491. package/tui/boot.mjs +0 -111
  492. package/tui/index.mjs +0 -53
  493. package/tui/lib/boot-timing.mjs +0 -41
  494. package/tui/lib/busy-words.mjs +0 -116
  495. package/tui/lib/export.mjs +0 -194
  496. package/tui/lib/knowledge-command.mjs +0 -190
  497. package/tui/lib/knowledge-import.mjs +0 -171
  498. package/tui/lib/render.mjs +0 -196
  499. package/tui/lib/save-file.mjs +0 -88
  500. package/tui/lib/select.mjs +0 -81
  501. package/tui/lib/selection.mjs +0 -18
  502. package/tui/lib/setup.mjs +0 -101
  503. package/tui/lib/sidebar.mjs +0 -63
  504. package/tui/lib/splash-art.mjs +0 -107
  505. package/tui/lib/splash.mjs +0 -18
  506. package/tui/lib/upload-frames.mjs +0 -9
  507. package/tui/lib/usage.mjs +0 -59
  508. package/tui/lib/wrap.mjs +0 -143
  509. package/tui/main.mjs +0 -264
@@ -35,6 +35,11 @@ export interface CredentialEngine extends ConfigEngine {
35
35
  }): AsyncIterable<unknown> & {
36
36
  destroy(): void;
37
37
  };
38
+ agentsWatch(req: {
39
+ meshId: string;
40
+ }): AsyncIterable<unknown> & {
41
+ destroy(): void;
42
+ };
38
43
  account(req: {}): Promise<{
39
44
  meshId?: string | null;
40
45
  }>;
@@ -58,6 +63,7 @@ export interface CredentialPusherLogger {
58
63
  }
59
64
  export type CredentialPusherHandle = (() => Promise<void>) & {
60
65
  sync(): Promise<void>;
66
+ ready(): Promise<void>;
61
67
  };
62
68
  export declare function nextRefreshDelay(entries: ReadonlyArray<Pick<CredentialEntry, 'expiresAt'>>, now?: number): number;
63
69
  export declare function credentialOwners(catalog: ReadonlyArray<PusherSkill>): ReadonlyMap<string, readonly string[]>;
@@ -5,7 +5,7 @@ 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
11
  const REFRESH_INTERVAL = 10 * 60 * 1000;
@@ -101,52 +101,39 @@ function fanOut(entry, owners) {
101
101
  const skills = owners.get(entry.key) ?? [];
102
102
  return skills.length > 0 ? skills.map((skill) => ({ ...entry, skill })) : [entry];
103
103
  }
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
- }
104
+ async function resolveEntry({ mk, failure, read }, { last, owners, logger }) {
105
+ try {
106
+ const entry = await read();
107
+ if (!entry) {
108
+ last.delete(mk);
109
+ return [];
124
110
  }
111
+ last.set(mk, entry);
112
+ return fanOut(entry, owners);
125
113
  }
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
- }
114
+ catch (err) {
115
+ logger?.warn('credential-pusher', failure, errorMessage(err));
116
+ const kept = last.get(mk);
117
+ return kept ? fanOut(kept, owners) : [];
148
118
  }
149
- return entries;
119
+ }
120
+ async function resolveScope(agentId, resolution) {
121
+ const { engine, specs } = resolution;
122
+ const specKeys = new Set(specs.map((spec) => spec.credentialKey));
123
+ const pending = [
124
+ ...specs.map((spec) => ({
125
+ mk: storeKey(spec.credentialKey, agentId),
126
+ failure: `credential resolve failed for ${spec.credentialKey}`,
127
+ read: () => oauthEntry(engine, spec, agentId)
128
+ })),
129
+ ...PLAIN_KEYS.filter((key) => !specKeys.has(key)).map((key) => ({
130
+ mk: storeKey(key, agentId),
131
+ failure: `credential read failed for ${key}`,
132
+ read: () => plainEntry(engine, key, agentId)
133
+ }))
134
+ ];
135
+ const resolved = await Promise.all(pending.map((entry) => resolveEntry(entry, resolution)));
136
+ return resolved.flat();
150
137
  }
151
138
  async function resolveSettings(engine, scopes, { catalog, logger }) {
152
139
  const fields = settingFields(catalog);
@@ -174,14 +161,22 @@ async function resolveSettings(engine, scopes, { catalog, logger }) {
174
161
  }
175
162
  return entries;
176
163
  }
164
+ async function accountScopes(engine) {
165
+ const { meshId } = await engine.account({});
166
+ const ids = meshId
167
+ ? ((await engine.listAgents({ meshId })).agents ?? []).map((agent) => agent.id)
168
+ : [];
169
+ return { meshId, scopes: [undefined, ...ids] };
170
+ }
177
171
  export function startCredentialPusher(harness, engine, logger) {
178
172
  const last = new Map();
179
173
  const watches = new Map();
174
+ const agentLists = new Map();
180
175
  let disposed = false;
181
176
  let timer = null;
182
177
  const pushLock = new ScopeLock({ debounce: true });
183
178
  const watch = (key) => {
184
- const stream = engine.configWatch({ key: scopedKey(undefined, key) });
179
+ const stream = engine.configWatch({ key });
185
180
  watches.set(key, stream);
186
181
  (async () => {
187
182
  for await (const _ of stream) {
@@ -197,10 +192,11 @@ export function startCredentialPusher(harness, engine, logger) {
197
192
  logger?.warn('credential-pusher', `credential watch ended for ${key}`, errorMessage(err));
198
193
  });
199
194
  };
200
- const syncWatches = (oauthKeys) => {
195
+ const syncWatches = (oauthKeys, scopes) => {
201
196
  if (disposed)
202
197
  return;
203
- const wanted = new Set([...oauthKeys, ...PLAIN_KEYS]);
198
+ const keys = new Set([...oauthKeys, ...PLAIN_KEYS]);
199
+ const wanted = new Set(scopes.flatMap((agentId) => [...keys].map((key) => scopedKey(agentId, key))));
204
200
  for (const [key, stream] of watches) {
205
201
  if (wanted.has(key))
206
202
  continue;
@@ -217,11 +213,34 @@ export function startCredentialPusher(harness, engine, logger) {
217
213
  }
218
214
  for (const mk of last.keys()) {
219
215
  const key = mk.includes('\0') ? mk.slice(mk.indexOf('\0') + 1) : mk;
220
- if (!wanted.has(key)) {
216
+ if (!keys.has(key)) {
221
217
  last.delete(mk);
222
218
  }
223
219
  }
224
220
  };
221
+ const syncAgentsWatch = (meshId) => {
222
+ if (disposed)
223
+ return;
224
+ for (const [id, stream] of agentLists) {
225
+ if (id === meshId)
226
+ continue;
227
+ try {
228
+ stream.destroy();
229
+ }
230
+ catch { }
231
+ agentLists.delete(id);
232
+ }
233
+ if (!meshId || agentLists.has(meshId)) {
234
+ return;
235
+ }
236
+ const stream = engine.agentsWatch({ meshId });
237
+ agentLists.set(meshId, stream);
238
+ (async () => {
239
+ for await (const _ of stream) {
240
+ schedule();
241
+ }
242
+ })().catch(noop);
243
+ };
225
244
  const armTimer = (delay) => {
226
245
  if (disposed)
227
246
  return;
@@ -253,16 +272,12 @@ export function startCredentialPusher(harness, engine, logger) {
253
272
  }
254
273
  const owners = credentialOwners(skills);
255
274
  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];
275
+ const { meshId, scopes } = await accountScopes(engine);
276
+ syncWatches(specs.map((spec) => spec.credentialKey), scopes);
277
+ syncAgentsWatch(meshId);
262
278
  const resolution = { engine, last, owners, specs, logger };
263
- for (const agentId of scopes) {
264
- entries.push(...(await resolveScope(agentId, resolution)));
265
- }
279
+ const resolved = await Promise.all(scopes.map((agentId) => resolveScope(agentId, resolution)));
280
+ entries.push(...resolved.flat());
266
281
  if (disposed) {
267
282
  return;
268
283
  }
@@ -317,7 +332,7 @@ export function startCredentialPusher(harness, engine, logger) {
317
332
  pushLock.unlock();
318
333
  }
319
334
  };
320
- schedule();
335
+ const first = schedule();
321
336
  const stop = async () => {
322
337
  if (disposed)
323
338
  return;
@@ -326,15 +341,17 @@ export function startCredentialPusher(harness, engine, logger) {
326
341
  clearTimeout(timer);
327
342
  }
328
343
  timer = null;
329
- for (const stream of watches.values()) {
344
+ for (const stream of [...watches.values(), ...agentLists.values()]) {
330
345
  try {
331
346
  stream.destroy();
332
347
  }
333
348
  catch { }
334
349
  }
335
350
  watches.clear();
351
+ agentLists.clear();
336
352
  pushLock.destroy();
337
353
  await pushLock.flush();
338
354
  };
339
- return Object.assign(stop, { sync });
355
+ return Object.assign(stop, { sync, ready: () => first });
340
356
  }
357
+ 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
  }
@@ -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[];
@@ -0,0 +1,272 @@
1
+ import { isRecord } from '../guards.js';
2
+ import { humanizeBytes } from './tree.js';
3
+ const EVENT_LOOP_WARN_MS = 100;
4
+ function record(value) {
5
+ return isRecord(value) ? value : null;
6
+ }
7
+ function at(frame, path) {
8
+ let current = frame;
9
+ for (const key of path) {
10
+ const node = record(current);
11
+ if (!node) {
12
+ return undefined;
13
+ }
14
+ current = node[key];
15
+ }
16
+ return current;
17
+ }
18
+ function list(value) {
19
+ return Array.isArray(value) ? value : [];
20
+ }
21
+ function num(value) {
22
+ return typeof value === 'number' && Number.isFinite(value) ? value : null;
23
+ }
24
+ const pass = (detail) => ({ state: 'pass', detail });
25
+ const warn = (detail, fix) => ({ state: 'warn', detail, fix });
26
+ const fail = (detail, fix) => ({ state: 'fail', detail, fix });
27
+ const pending = (detail) => ({ state: 'pending', detail });
28
+ const declared = (detail, fix) => ({ state: 'declared', detail, fix });
29
+ function check(group, name, verdict) {
30
+ return { group, name, ...verdict };
31
+ }
32
+ function hardware(frame) {
33
+ const cpu = record(at(frame, ['cpu']));
34
+ const gpu = record(at(frame, ['gpu']));
35
+ const devices = list(gpu?.['devices']);
36
+ const tables = [gpu?.['drivers'], ...devices.map((device) => record(device)?.['drivers'])];
37
+ const driverFlags = tables
38
+ .flatMap((table) => Object.entries(record(table) ?? {}))
39
+ .filter(([, on]) => typeof on === 'boolean');
40
+ const backends = driverFlags.filter(([, on]) => on === true).map(([name]) => name);
41
+ const out = [];
42
+ const cpuName = typeof cpu?.['name'] === 'string' ? cpu['name'] : null;
43
+ out.push(check('Hardware', 'cpu', cpuName ? pass(cpuName) : declared('not reported by this host')));
44
+ if (devices.length) {
45
+ const names = devices.map((device) => String(record(device)?.['name'] ?? 'unnamed'));
46
+ out.push(check('Hardware', 'gpu', pass(names.join(', '))));
47
+ }
48
+ else {
49
+ out.push(check('Hardware', 'gpu', declared('no gpu reported by this host')));
50
+ }
51
+ if (driverFlags.length > 0) {
52
+ out.push(check('Hardware', 'gpu backends', backends.length
53
+ ? pass([...new Set(backends)].join(', '))
54
+ : warn('none enabled', 'no metal/vulkan/cuda/opencl backend is available, so every model runs on the cpu')));
55
+ }
56
+ const budget = record(at(frame, ['memoryBudget']));
57
+ const available = num(budget?.['availableBytes']);
58
+ if (budget && available !== null) {
59
+ const source = String(budget['source'] ?? 'unknown');
60
+ out.push(check('Hardware', 'model memory budget', pass(`${humanizeBytes(available)} from ${source}`)));
61
+ }
62
+ return out;
63
+ }
64
+ function engine(samples, frame) {
65
+ const harness = record(at(frame, ['harness']));
66
+ const assistant = record(at(frame, ['assistant']));
67
+ const out = [];
68
+ const resident = list(harness?.['models']).length;
69
+ if (harness?.['sdkLoaded'] === true) {
70
+ out.push(check('Engine', 'sdk loaded', pass('loaded')));
71
+ }
72
+ else if (harness?.['sdkLoaded'] === false && resident > 0) {
73
+ out.push(check('Engine', 'sdk loaded', fail('not loaded, but a model is resident', 'the sdk should have loaded before any model did')));
74
+ }
75
+ else {
76
+ out.push(check('Engine', 'sdk loaded', declared('not loaded yet — it loads on first use')));
77
+ }
78
+ const suspended = harness?.['suspended'] === true || assistant?.['suspended'] === true;
79
+ out.push(check('Engine', 'not suspended', suspended
80
+ ? fail('suspended', 'the engine is parked; on desktop it should only be suspended while the app is hidden')
81
+ : pass('running')));
82
+ const delay = num(at(samples.second ?? samples.first, ['process', 'delay']));
83
+ if (delay !== null) {
84
+ const shown = `${Math.round(delay)}ms delay`;
85
+ out.push(check('Engine', 'event loop', delay < EVENT_LOOP_WARN_MS
86
+ ? pass(shown)
87
+ : warn(shown, 'something is blocking the loop, so watches and streams will stutter')));
88
+ }
89
+ return out;
90
+ }
91
+ function modelLabel(model) {
92
+ return model.split(/[?#]/)[0].split(/[\\/]/).pop() || model;
93
+ }
94
+ function models(frame) {
95
+ const harness = record(at(frame, ['harness']));
96
+ const resident = list(harness?.['models']);
97
+ const out = [];
98
+ const labels = resident.map((row) => modelLabel(String(record(row)?.['model'] ?? 'unknown')));
99
+ out.push(check('Model', 'resident', labels.length
100
+ ? pass(labels.join(', '))
101
+ : declared('none loaded — idle collection is legitimate')));
102
+ if (harness?.['device']) {
103
+ out.push(check('Model', 'device requested', declared(String(harness['device']), 'what we asked the sdk for, not what it bound — see the rows below')));
104
+ }
105
+ return [...out, ...backendChecks(record(at(frame, ['backendUse'])))];
106
+ }
107
+ function backendChecks(uses) {
108
+ if (!uses || Object.keys(uses).length === 0) {
109
+ return [
110
+ check('Model', 'device used', declared('no run has reported a backend yet', 'only tools that report the backend they bound appear here, e.g. generate_music'))
111
+ ];
112
+ }
113
+ const out = [];
114
+ for (const [tool, entries] of Object.entries(uses)) {
115
+ const latest = record(list(entries).at(-1));
116
+ if (latest) {
117
+ out.push(check('Model', `${tool} last run`, backendVerdict(latest)));
118
+ }
119
+ }
120
+ return out;
121
+ }
122
+ function backendVerdict(use) {
123
+ const device = String(use['device'] ?? 'unknown');
124
+ const backend = String(use['backend'] ?? 'unknown');
125
+ if (use['requestedGpu'] === true && device === 'cpu') {
126
+ return fail(`asked for the gpu, ran on the cpu (${backend})`, 'the gpu was unavailable, so this ran on the cpu and took much longer than usual');
127
+ }
128
+ if (device === 'unknown') {
129
+ return declared('the engine reported no backend', 'absent evidence is not evidence of a fallback');
130
+ }
131
+ return pass(`${device} (${backend})`);
132
+ }
133
+ function skills(frame) {
134
+ const harness = record(at(frame, ['harness']));
135
+ return [
136
+ inventory('skills installed', list(harness?.['skills']).length, 'skill'),
137
+ inventory('tools installed', list(harness?.['toolNames']).length, 'tool')
138
+ ];
139
+ }
140
+ function inventory(name, count, noun) {
141
+ if (count === 0) {
142
+ return check('Skills', name, declared('none installed'));
143
+ }
144
+ return check('Skills', name, pass(`${count} ${noun}${count === 1 ? '' : 's'}`));
145
+ }
146
+ function mesh(samples, frame) {
147
+ const node = record(at(frame, ['mesh']));
148
+ const state = at(frame, ['state']);
149
+ if (!node) {
150
+ return [
151
+ check('Mesh', 'mesh open', declared(`no mesh reported — engine state ${String(state ?? 'unknown')}`))
152
+ ];
153
+ }
154
+ const out = [check('Mesh', 'mesh open', pass('open locally'))];
155
+ if (node['writable'] === true) {
156
+ out.push(check('Mesh', 'writable', pass('admitted as a writer')));
157
+ }
158
+ else if (node['writable'] === false) {
159
+ out.push(check('Mesh', 'writable', fail('not writable', 'this device is not admitted as a writer, so its own changes cannot land')));
160
+ }
161
+ const member = record(node['member']);
162
+ const unattested = num(member?.['unattested']);
163
+ if (member) {
164
+ const members = String(member['members'] ?? '?');
165
+ out.push(check('Mesh', 'membership', unattested && unattested > 0
166
+ ? warn(`${unattested} unattested of ${members}`, 'a member holding write access without attestation')
167
+ : pass(`${members} attested`)));
168
+ }
169
+ const indexer = indexerVerdict(samples);
170
+ if (indexer) {
171
+ out.push(check('Mesh', 'indexer', indexer));
172
+ }
173
+ const configured = num(node['blindPeerCount']) ?? 0;
174
+ if (node['blindPeering'] === false) {
175
+ out.push(check('Mesh', 'blind peers', declared('switched off on this device', 'setBlindPeering({ enabled: true }) turns it back on')));
176
+ }
177
+ else if (configured > 0) {
178
+ out.push(check('Mesh', 'blind peers', blindPeerVerdict(configured, list(node['blindPeers']))));
179
+ }
180
+ const sweep = sweepVerdict(record(node['orphanedBlobSweep']));
181
+ if (sweep) {
182
+ out.push(check('Mesh', 'blob sweep', sweep));
183
+ }
184
+ return out;
185
+ }
186
+ function indexerVerdict(samples) {
187
+ const before = num(at(samples.first, ['mesh', 'flushes']));
188
+ const after = num(at(samples.second, ['mesh', 'flushes']));
189
+ const flushes = after ?? before;
190
+ if (samples.second === undefined) {
191
+ return pending('watching for movement');
192
+ }
193
+ if (before !== null && after !== null && after > before) {
194
+ return pass(`advancing (${before} → ${after})`);
195
+ }
196
+ if (flushes === null) {
197
+ return null;
198
+ }
199
+ return declared(flushes === 0
200
+ ? 'nothing indexed on this device yet'
201
+ : `${flushes} flushes so far, idle while checking`, 'flushes only advance when there is something to index, so a still counter is normal on a quiet mesh');
202
+ }
203
+ function sweepVerdict(sweep) {
204
+ if (!sweep) {
205
+ return null;
206
+ }
207
+ const state = String(sweep['state'] ?? 'unknown');
208
+ if (state === 'failed') {
209
+ return fail('failed', String(sweep['error'] ?? 'sweep failed'));
210
+ }
211
+ return state === 'succeeded' ? pass('succeeded') : declared(state);
212
+ }
213
+ function blindPeerVerdict(configured, peers) {
214
+ const context = `${configured} key${configured === 1 ? '' : 's'} configured`;
215
+ if (peers.length === 0) {
216
+ return declared(`not peering right now — ${context}`);
217
+ }
218
+ const rows = peers.map((peer) => record(peer) ?? {});
219
+ const uploaded = rows.reduce((total, row) => total + (num(row['uploaded']) ?? 0), 0);
220
+ const connects = rows.reduce((total, row) => total + (num(row['connects']) ?? 0), 0);
221
+ const connected = rows.filter((row) => row['connected'] === true).length;
222
+ if (uploaded > 0) {
223
+ return pass(`${peers.length} peers, ${uploaded} blocks cached with them`);
224
+ }
225
+ if (connected > 0) {
226
+ return pass(`${connected} of ${peers.length} connected`);
227
+ }
228
+ return declared(connects > 0
229
+ ? `${peers.length} peers, none connected after ${connects} dial${connects === 1 ? '' : 's'} — ${context}`
230
+ : `${peers.length} peers, not dialled yet — ${context}`, 'run /doctor again: a climbing dial count with nothing connected means they are unreachable, not still connecting');
231
+ }
232
+ function network(frame) {
233
+ const node = record(at(frame, ['network']));
234
+ if (!node) {
235
+ return [check('Network', 'swarm', declared('no swarm reported'))];
236
+ }
237
+ const out = [check('Network', 'online', onlineVerdict(node))];
238
+ const nodes = num(node['nodes']);
239
+ if (nodes !== null) {
240
+ out.push(check('Network', 'dht nodes', nodes > 0
241
+ ? pass(`${nodes} known`)
242
+ : warn('none known', 'no route to a peer yet — normal moments after boot, a problem if it persists')));
243
+ }
244
+ const peers = num(node['peers']);
245
+ const connections = num(node['connections']) ?? 0;
246
+ if (peers !== null) {
247
+ out.push(check('Network', 'peers', pass(peers === 0
248
+ ? 'none connected — this device is on its own'
249
+ : `${peers} device${peers === 1 ? '' : 's'}, ${connections} connection${connections === 1 ? '' : 's'}`)));
250
+ }
251
+ return out;
252
+ }
253
+ function onlineVerdict(node) {
254
+ if (node['online'] === false) {
255
+ return fail('offline', 'this device cannot reach the dht');
256
+ }
257
+ if (node['degraded'] === true) {
258
+ return warn('degraded', 'the dht is answering slowly');
259
+ }
260
+ return node['online'] === true ? pass('online') : declared('not reported yet');
261
+ }
262
+ export function runChecks(samples) {
263
+ const frame = record(samples.second ?? samples.first);
264
+ return [
265
+ ...hardware(frame),
266
+ ...engine(samples, frame),
267
+ ...models(frame),
268
+ ...skills(frame),
269
+ ...mesh(samples, frame),
270
+ ...network(frame)
271
+ ];
272
+ }
@@ -0,0 +1,4 @@
1
+ export declare const REDACTED = "\u2039redacted\u203A";
2
+ export declare function truncateHex(value: string): string;
3
+ export declare function redactString(value: string): string;
4
+ export declare function redact(value: unknown): unknown;
@@ -0,0 +1,31 @@
1
+ const REDACTED_KEYS = new Set(['meshSeed', 'seed', 'secretKey', 'host']);
2
+ const HEX_KEY = /^[0-9a-f]{32,}$/i;
3
+ const INVITE = /^qvac:\/\//;
4
+ export const REDACTED = '‹redacted›';
5
+ export function truncateHex(value) {
6
+ return `${value.slice(0, 8)}…${value.slice(-8)}`;
7
+ }
8
+ export function redactString(value) {
9
+ if (INVITE.test(value))
10
+ return REDACTED;
11
+ if (HEX_KEY.test(value)) {
12
+ return truncateHex(value);
13
+ }
14
+ return value;
15
+ }
16
+ export function redact(value) {
17
+ if (typeof value === 'string') {
18
+ return redactString(value);
19
+ }
20
+ if (Array.isArray(value)) {
21
+ return value.map(redact);
22
+ }
23
+ if (typeof value !== 'object' || value === null) {
24
+ return value;
25
+ }
26
+ const out = {};
27
+ for (const [key, child] of Object.entries(value)) {
28
+ out[key] = REDACTED_KEYS.has(key) ? REDACTED : redact(child);
29
+ }
30
+ return out;
31
+ }
@@ -0,0 +1,8 @@
1
+ import type { Check, CheckState } from './checks.ts';
2
+ export type PaintKind = CheckState | 'title' | 'explain';
3
+ export type Paint = (text: string, kind: PaintKind) => string;
4
+ export interface RenderOptions {
5
+ paint?: Paint | undefined;
6
+ }
7
+ export declare function summarize(checks: ReadonlyArray<Check>): string;
8
+ export declare function checkLines(checks: ReadonlyArray<Check>, { paint }?: RenderOptions): string[];