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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/CHANGELOG.md +1008 -1
  2. package/README.md +40 -81
  3. package/dist-lib/index.d.ts +1 -1
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +19 -2
  8. package/dist-lib/lib/api/agents.js +121 -24
  9. package/dist-lib/lib/api/app-config.d.ts +4 -1
  10. package/dist-lib/lib/api/app-config.js +17 -6
  11. package/dist-lib/lib/api/attachments.js +3 -2
  12. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  13. package/dist-lib/lib/api/chat-move.js +7 -0
  14. package/dist-lib/lib/api/chat.d.ts +13 -2
  15. package/dist-lib/lib/api/chat.js +114 -9
  16. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  17. package/dist-lib/lib/api/chunk-delta.js +115 -0
  18. package/dist-lib/lib/api/chunks.d.ts +17 -2
  19. package/dist-lib/lib/api/chunks.js +70 -13
  20. package/dist-lib/lib/api/config.d.ts +6 -2
  21. package/dist-lib/lib/api/config.js +47 -5
  22. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  23. package/dist-lib/lib/api/current-mesh.js +15 -11
  24. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  25. package/dist-lib/lib/api/custom-models.js +12 -12
  26. package/dist-lib/lib/api/device-routes.d.ts +9 -0
  27. package/dist-lib/lib/api/device-routes.js +123 -0
  28. package/dist-lib/lib/api/devices.d.ts +3 -2
  29. package/dist-lib/lib/api/devices.js +23 -11
  30. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  31. package/dist-lib/lib/api/diagnostics.js +2 -2
  32. package/dist-lib/lib/api/execution.d.ts +12 -1
  33. package/dist-lib/lib/api/execution.js +44 -14
  34. package/dist-lib/lib/api/files.d.ts +1 -1
  35. package/dist-lib/lib/api/files.js +65 -8
  36. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  37. package/dist-lib/lib/api/host-run-log.js +35 -83
  38. package/dist-lib/lib/api/index.d.ts +28 -6
  39. package/dist-lib/lib/api/index.js +101 -33
  40. package/dist-lib/lib/api/instrument.d.ts +2 -2
  41. package/dist-lib/lib/api/instrument.js +24 -48
  42. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  43. package/dist-lib/lib/api/knowledge.js +25 -7
  44. package/dist-lib/lib/api/local-files.d.ts +5 -1
  45. package/dist-lib/lib/api/local-files.js +9 -5
  46. package/dist-lib/lib/api/logs.js +3 -3
  47. package/dist-lib/lib/api/members.d.ts +10 -1
  48. package/dist-lib/lib/api/members.js +67 -26
  49. package/dist-lib/lib/api/mesh.d.ts +12 -4
  50. package/dist-lib/lib/api/mesh.js +12 -8
  51. package/dist-lib/lib/api/model-download.d.ts +2 -1
  52. package/dist-lib/lib/api/model-download.js +2 -2
  53. package/dist-lib/lib/api/network.d.ts +10 -2
  54. package/dist-lib/lib/api/network.js +8 -2
  55. package/dist-lib/lib/api/notifications.d.ts +3 -1
  56. package/dist-lib/lib/api/notifications.js +14 -9
  57. package/dist-lib/lib/api/projects.d.ts +20 -0
  58. package/dist-lib/lib/api/projects.js +169 -0
  59. package/dist-lib/lib/api/rag.d.ts +0 -1
  60. package/dist-lib/lib/api/rag.js +71 -34
  61. package/dist-lib/lib/api/served.d.ts +17 -0
  62. package/dist-lib/lib/api/served.js +48 -0
  63. package/dist-lib/lib/api/sync.d.ts +2 -1
  64. package/dist-lib/lib/api/sync.js +2 -2
  65. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  66. package/dist-lib/lib/api/tool-activity.js +4 -3
  67. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  68. package/dist-lib/lib/api/tool-configs.js +6 -9
  69. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  70. package/dist-lib/lib/api/upload-frames.js +0 -1
  71. package/dist-lib/lib/api/watchable.d.ts +3 -2
  72. package/dist-lib/lib/api/watchable.js +2 -3
  73. package/dist-lib/lib/api/workspace.d.ts +5 -0
  74. package/dist-lib/lib/api/workspace.js +47 -0
  75. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  76. package/dist-lib/lib/assistant/fake-models.js +112 -0
  77. package/dist-lib/lib/assistant/harness.d.ts +37 -31
  78. package/dist-lib/lib/assistant/harness.js +51 -10
  79. package/dist-lib/lib/assistant/history.d.ts +30 -17
  80. package/dist-lib/lib/assistant/history.js +179 -87
  81. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  82. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  83. package/dist-lib/lib/assistant/message.d.ts +27 -1
  84. package/dist-lib/lib/assistant/message.js +65 -2
  85. package/dist-lib/lib/assistant/model-round.d.ts +100 -0
  86. package/dist-lib/lib/assistant/model-round.js +619 -0
  87. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  88. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  89. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  90. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  91. package/dist-lib/lib/assistant/round-host.d.ts +42 -0
  92. package/dist-lib/lib/assistant/round-host.js +241 -0
  93. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  94. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  95. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  96. package/dist-lib/lib/assistant/video-budget.js +29 -0
  97. package/dist-lib/lib/assistant-client.d.ts +4 -1
  98. package/dist-lib/lib/assistant-client.js +27 -8
  99. package/dist-lib/lib/assistant-tree.d.ts +10 -3
  100. package/dist-lib/lib/assistant-tree.js +63 -20
  101. package/dist-lib/lib/assistant.d.ts +93 -24
  102. package/dist-lib/lib/assistant.js +2048 -1231
  103. package/dist-lib/lib/audio-format.js +1 -1
  104. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  105. package/dist-lib/lib/chat-suggestion.js +47 -0
  106. package/dist-lib/lib/client.d.ts +2 -2
  107. package/dist-lib/lib/client.js +10 -1
  108. package/dist-lib/lib/compaction.d.ts +3 -1
  109. package/dist-lib/lib/compaction.js +18 -4
  110. package/dist-lib/lib/constants.d.ts +10 -0
  111. package/dist-lib/lib/constants.js +10 -0
  112. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  113. package/dist-lib/lib/core/agent-copies.js +40 -0
  114. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  115. package/dist-lib/lib/core/agent-hosting.js +71 -0
  116. package/dist-lib/lib/core/agent.d.ts +9 -1
  117. package/dist-lib/lib/core/agent.js +45 -19
  118. package/dist-lib/lib/core/archived-mesh.d.ts +11 -6
  119. package/dist-lib/lib/core/archived-mesh.js +77 -58
  120. package/dist-lib/lib/core/async-iterable.js +1 -1
  121. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  122. package/dist-lib/lib/core/blind-peers.js +1 -0
  123. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  124. package/dist-lib/lib/core/chat-activity.js +45 -34
  125. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  126. package/dist-lib/lib/core/chat-copy.js +395 -0
  127. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  128. package/dist-lib/lib/core/chat-fork.js +246 -0
  129. package/dist-lib/lib/core/chat-group.js +8 -7
  130. package/dist-lib/lib/core/chat-move.d.ts +75 -0
  131. package/dist-lib/lib/core/chat-move.js +598 -0
  132. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  133. package/dist-lib/lib/core/chat-order.js +19 -4
  134. package/dist-lib/lib/core/chat-project.d.ts +2 -0
  135. package/dist-lib/lib/core/chat-project.js +15 -0
  136. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  137. package/dist-lib/lib/core/chat-read.js +49 -0
  138. package/dist-lib/lib/core/chat-search.js +14 -12
  139. package/dist-lib/lib/core/chat.d.ts +33 -4
  140. package/dist-lib/lib/core/chat.js +122 -39
  141. package/dist-lib/lib/core/chunk.d.ts +35 -7
  142. package/dist-lib/lib/core/chunk.js +250 -45
  143. package/dist-lib/lib/core/collections.d.ts +40 -1
  144. package/dist-lib/lib/core/collections.js +40 -1
  145. package/dist-lib/lib/core/config-value.d.ts +6 -0
  146. package/dist-lib/lib/core/config-value.js +14 -0
  147. package/dist-lib/lib/core/contract/activity.d.ts +3 -2
  148. package/dist-lib/lib/core/contract/activity.js +39 -21
  149. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  150. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  151. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  152. package/dist-lib/lib/core/contract/agents.js +142 -3
  153. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  154. package/dist-lib/lib/core/contract/chat.js +53 -3
  155. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  156. package/dist-lib/lib/core/contract/chunks.js +125 -38
  157. package/dist-lib/lib/core/contract/devices.js +6 -4
  158. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  159. package/dist-lib/lib/core/contract/index.js +36 -11
  160. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  161. package/dist-lib/lib/core/contract/indexing.js +51 -7
  162. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  163. package/dist-lib/lib/core/contract/invites.js +26 -36
  164. package/dist-lib/lib/core/contract/joined-meshes.js +3 -1
  165. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  166. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  167. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  168. package/dist-lib/lib/core/contract/members.js +34 -4
  169. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  170. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  171. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  172. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  173. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  174. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  175. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  176. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  177. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  178. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  179. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  180. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  181. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  182. package/dist-lib/lib/core/contract/open-join.js +77 -0
  183. package/dist-lib/lib/core/contract/project-device-keys.d.ts +7 -0
  184. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  185. package/dist-lib/lib/core/contract/project-host-keys.d.ts +7 -0
  186. package/dist-lib/lib/core/contract/project-host-keys.js +41 -0
  187. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  188. package/dist-lib/lib/core/contract/project-order.js +25 -0
  189. package/dist-lib/lib/core/contract/projects.d.ts +21 -0
  190. package/dist-lib/lib/core/contract/projects.js +327 -0
  191. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  192. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  193. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  194. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  195. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  196. package/dist-lib/lib/core/contract/roles.js +121 -0
  197. package/dist-lib/lib/core/contract/run-requests.d.ts +10 -0
  198. package/dist-lib/lib/core/contract/run-requests.js +81 -0
  199. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  200. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  201. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  202. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  203. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  204. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  205. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  206. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  207. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  208. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  209. package/dist-lib/lib/core/contract/workspace.js +311 -0
  210. package/dist-lib/lib/core/contract/writers.js +100 -16
  211. package/dist-lib/lib/core/departures.d.ts +16 -5
  212. package/dist-lib/lib/core/departures.js +79 -6
  213. package/dist-lib/lib/core/device-control.d.ts +21 -0
  214. package/dist-lib/lib/core/device-control.js +91 -0
  215. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  216. package/dist-lib/lib/core/device-seal.js +22 -0
  217. package/dist-lib/lib/core/devices.d.ts +2 -1
  218. package/dist-lib/lib/core/devices.js +5 -3
  219. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  220. package/dist-lib/lib/core/document-attachment.js +14 -0
  221. package/dist-lib/lib/core/files/attachments.js +8 -7
  222. package/dist-lib/lib/core/files/index.d.ts +27 -14
  223. package/dist-lib/lib/core/files/index.js +220 -43
  224. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  225. package/dist-lib/lib/core/files/knowledge.js +77 -5
  226. package/dist-lib/lib/core/files/preview/index.js +6 -2
  227. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  228. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  229. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  230. package/dist-lib/lib/core/files/processing/document.js +26 -2
  231. package/dist-lib/lib/core/files/processing/index.d.ts +8 -3
  232. package/dist-lib/lib/core/files/processing/index.js +99 -73
  233. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  234. package/dist-lib/lib/core/files/processing/protocol.js +14 -3
  235. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  236. package/dist-lib/lib/core/files/processing/source.js +12 -4
  237. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  238. package/dist-lib/lib/core/files/processing/state.js +9 -1
  239. package/dist-lib/lib/core/files/rag/build.d.ts +5 -1
  240. package/dist-lib/lib/core/files/rag/build.js +32 -8
  241. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  242. package/dist-lib/lib/core/files/rag/failure.js +57 -0
  243. package/dist-lib/lib/core/files/rag/index.d.ts +13 -2
  244. package/dist-lib/lib/core/files/rag/index.js +30 -8
  245. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  246. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  247. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  248. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  249. package/dist-lib/lib/core/files/rag/load.js +6 -3
  250. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  251. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  252. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  253. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  254. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  255. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  256. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  257. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  258. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  259. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  260. package/dist-lib/lib/core/files/records/index.js +1 -1
  261. package/dist-lib/lib/core/files/records/knowledge.d.ts +11 -1
  262. package/dist-lib/lib/core/files/records/knowledge.js +40 -3
  263. package/dist-lib/lib/core/files/records/purge.js +13 -8
  264. package/dist-lib/lib/core/files/records/reclaim.js +20 -48
  265. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  266. package/dist-lib/lib/core/files/records/routing.js +6 -2
  267. package/dist-lib/lib/core/files/records/source.js +3 -5
  268. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  269. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  270. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  271. package/dist-lib/lib/core/files/store/blob.js +2 -2
  272. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  273. package/dist-lib/lib/core/files/store/index.js +4 -1
  274. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  275. package/dist-lib/lib/core/files/store/reference.js +12 -2
  276. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  277. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  278. package/dist-lib/lib/core/files/upload.js +53 -14
  279. package/dist-lib/lib/core/first-event.d.ts +6 -0
  280. package/dist-lib/lib/core/first-event.js +13 -0
  281. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  282. package/dist-lib/lib/core/fs-drives.js +30 -18
  283. package/dist-lib/lib/core/id.d.ts +1 -0
  284. package/dist-lib/lib/core/id.js +3 -0
  285. package/dist-lib/lib/core/identity.d.ts +3 -1
  286. package/dist-lib/lib/core/identity.js +25 -4
  287. package/dist-lib/lib/core/invite.d.ts +6 -2
  288. package/dist-lib/lib/core/invite.js +22 -8
  289. package/dist-lib/lib/core/local/files.d.ts +2 -1
  290. package/dist-lib/lib/core/local/files.js +5 -7
  291. package/dist-lib/lib/core/local/index.d.ts +86 -7
  292. package/dist-lib/lib/core/local/index.js +312 -27
  293. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  294. package/dist-lib/lib/core/local/run-logs.js +132 -0
  295. package/dist-lib/lib/core/member-key.d.ts +7 -0
  296. package/dist-lib/lib/core/member-key.js +24 -0
  297. package/dist-lib/lib/core/membership.d.ts +3 -14
  298. package/dist-lib/lib/core/membership.js +3 -96
  299. package/dist-lib/lib/core/mesh.d.ts +107 -30
  300. package/dist-lib/lib/core/mesh.js +625 -171
  301. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  302. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  303. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  304. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  305. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  306. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  307. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  308. package/dist-lib/lib/core/migrations/index.js +69 -8
  309. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  310. package/dist-lib/lib/core/model-requests.js +65 -0
  311. package/dist-lib/lib/core/next-frame.js +2 -1
  312. package/dist-lib/lib/core/notification.js +100 -25
  313. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  314. package/dist-lib/lib/core/pdf/figure.js +64 -0
  315. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  316. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  317. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  318. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  319. package/dist-lib/lib/core/project-keys.d.ts +13 -0
  320. package/dist-lib/lib/core/project-keys.js +56 -0
  321. package/dist-lib/lib/core/prompt-history.js +4 -4
  322. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  323. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  324. package/dist-lib/lib/core/public-mesh.d.ts +26 -0
  325. package/dist-lib/lib/core/public-mesh.js +94 -0
  326. package/dist-lib/lib/core/purge.d.ts +3 -0
  327. package/dist-lib/lib/core/purge.js +7 -0
  328. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  329. package/dist-lib/lib/core/run-driver.js +20 -0
  330. package/dist-lib/lib/core/run-requests.d.ts +11 -0
  331. package/dist-lib/lib/core/run-requests.js +58 -0
  332. package/dist-lib/lib/core/send.d.ts +2 -0
  333. package/dist-lib/lib/core/send.js +17 -4
  334. package/dist-lib/lib/core/senders.d.ts +19 -0
  335. package/dist-lib/lib/core/senders.js +45 -0
  336. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  337. package/dist-lib/lib/core/shared-agents.js +283 -0
  338. package/dist-lib/lib/core/skill-secrets.d.ts +10 -16
  339. package/dist-lib/lib/core/skill-secrets.js +90 -72
  340. package/dist-lib/lib/core/sync/background.d.ts +35 -0
  341. package/dist-lib/lib/core/sync/background.js +85 -0
  342. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  343. package/dist-lib/lib/core/sync/changed.js +7 -0
  344. package/dist-lib/lib/core/sync/devices.js +6 -3
  345. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  346. package/dist-lib/lib/core/sync/files.js +50 -72
  347. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  348. package/dist-lib/lib/core/sync/index.js +164 -81
  349. package/dist-lib/lib/core/sync/view-updates.d.ts +33 -0
  350. package/dist-lib/lib/core/sync/view-updates.js +133 -0
  351. package/dist-lib/lib/core/sync-status.js +3 -3
  352. package/dist-lib/lib/core/system-info.d.ts +2 -2
  353. package/dist-lib/lib/core/system-info.js +10 -11
  354. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  355. package/dist-lib/lib/core/tool-configs.js +11 -11
  356. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  357. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  358. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  359. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  360. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  361. package/dist-lib/lib/core/video/attachment.js +7 -0
  362. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  363. package/dist-lib/lib/core/video/digest.js +57 -0
  364. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  365. package/dist-lib/lib/core/video/frames.js +224 -0
  366. package/dist-lib/lib/core/workspace-upgrade.d.ts +22 -0
  367. package/dist-lib/lib/core/workspace-upgrade.js +50 -0
  368. package/dist-lib/lib/core.d.ts +303 -84
  369. package/dist-lib/lib/core.js +3952 -1511
  370. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  371. package/dist-lib/lib/credential-pusher.js +111 -62
  372. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  373. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  374. package/dist-lib/lib/custom-model-task.js +2 -2
  375. package/dist-lib/lib/device-tree.d.ts +18 -0
  376. package/dist-lib/lib/device-tree.js +32 -0
  377. package/dist-lib/lib/diagnostics.d.ts +7 -0
  378. package/dist-lib/lib/diagnostics.js +22 -0
  379. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  380. package/dist-lib/lib/doctor/checks.js +272 -0
  381. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  382. package/dist-lib/lib/doctor/redact.js +31 -0
  383. package/dist-lib/lib/doctor/render.d.ts +8 -0
  384. package/dist-lib/lib/doctor/render.js +83 -0
  385. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  386. package/dist-lib/lib/doctor/tree.js +167 -0
  387. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  388. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  389. package/dist-lib/lib/errors.d.ts +794 -0
  390. package/dist-lib/lib/errors.js +728 -0
  391. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  392. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  393. package/dist-lib/lib/guards.d.ts +1 -0
  394. package/dist-lib/lib/guards.js +4 -0
  395. package/dist-lib/lib/inference-calls.d.ts +1 -2
  396. package/dist-lib/lib/inference-calls.js +2 -10
  397. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  398. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  399. package/dist-lib/lib/knowledge-search.js +5 -51
  400. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  401. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  402. package/dist-lib/lib/kv-cache-retention.d.ts +35 -0
  403. package/dist-lib/lib/kv-cache-retention.js +98 -0
  404. package/dist-lib/lib/latest-frame.d.ts +10 -0
  405. package/dist-lib/lib/latest-frame.js +48 -0
  406. package/dist-lib/lib/log.d.ts +7 -6
  407. package/dist-lib/lib/log.js +14 -7
  408. package/dist-lib/lib/logger-type.d.ts +2 -5
  409. package/dist-lib/lib/mesh-scoped-engine.js +42 -2
  410. package/dist-lib/lib/model-download-status.d.ts +3 -3
  411. package/dist-lib/lib/model-download.d.ts +16 -12
  412. package/dist-lib/lib/model-download.js +90 -34
  413. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  414. package/dist-lib/lib/model-memory-cap.d.ts +27 -0
  415. package/dist-lib/lib/model-memory-cap.js +69 -0
  416. package/dist-lib/lib/models-watch.d.ts +1 -1
  417. package/dist-lib/lib/models-watch.js +4 -4
  418. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  419. package/dist-lib/lib/oauth/flow-core.js +5 -3
  420. package/dist-lib/lib/oauth/flow.js +1 -1
  421. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  422. package/dist-lib/lib/oauth/loopback.js +57 -12
  423. package/dist-lib/lib/oauth/providers.js +4 -2
  424. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  425. package/dist-lib/lib/oauth/register.js +35 -19
  426. package/dist-lib/lib/oauth/request.d.ts +10 -0
  427. package/dist-lib/lib/oauth/request.js +22 -0
  428. package/dist-lib/lib/oauth/resolve.js +13 -5
  429. package/dist-lib/lib/oauth/token-exchange-core.js +31 -33
  430. package/dist-lib/lib/oauth/types.d.ts +3 -0
  431. package/dist-lib/lib/oauth.d.ts +2 -1
  432. package/dist-lib/lib/oauth.js +1 -0
  433. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  434. package/dist-lib/lib/persistent-dir.js +9 -0
  435. package/dist-lib/lib/probe-rounds.d.ts +3 -0
  436. package/dist-lib/lib/probe-rounds.js +5 -0
  437. package/dist-lib/lib/reconnecting-watch.js +19 -11
  438. package/dist-lib/lib/run-input.d.ts +14 -0
  439. package/dist-lib/lib/run-input.js +33 -0
  440. package/dist-lib/lib/run-notices.d.ts +5 -0
  441. package/dist-lib/lib/run-notices.js +13 -2
  442. package/dist-lib/lib/run-replay.d.ts +44 -0
  443. package/dist-lib/lib/run-replay.js +158 -0
  444. package/dist-lib/lib/run-transcript.d.ts +11 -12
  445. package/dist-lib/lib/run-transcript.js +16 -18
  446. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  447. package/dist-lib/lib/task.js +6 -4
  448. package/dist-lib/lib/test-env.d.ts +1 -0
  449. package/dist-lib/lib/test-env.js +4 -0
  450. package/dist-lib/schema/build.js +66 -55
  451. package/dist-lib/schema/config.d.ts +1 -1
  452. package/dist-lib/schema/config.js +1 -1
  453. package/dist-lib/schema/content.d.ts +5 -1
  454. package/dist-lib/schema/content.js +60 -12
  455. package/dist-lib/schema/engine.d.ts +1 -0
  456. package/dist-lib/schema/engine.js +780 -155
  457. package/dist-lib/schema/field-order.js +8 -1
  458. package/dist-lib/schema/indexes.d.ts +7 -0
  459. package/dist-lib/schema/indexes.js +48 -3
  460. package/dist-lib/schema/local.js +80 -5
  461. package/dist-lib/schema/qvac.d.ts +4 -1
  462. package/dist-lib/schema/qvac.js +474 -14
  463. package/dist-lib/spec/bind.js +212 -48
  464. package/dist-lib/spec/calls.js +46 -5
  465. package/dist-lib/spec/capabilities.d.ts +100 -18
  466. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  467. package/dist-lib/spec/hrpc/hrpc.json +739 -206
  468. package/dist-lib/spec/hrpc/index.js +844 -345
  469. package/dist-lib/spec/hrpc/messages.js +3906 -1749
  470. package/dist-lib/spec/hyperschema/index.js +3906 -1749
  471. package/dist-lib/spec/hyperschema/schema.json +4809 -3119
  472. package/dist-lib/spec/hyperschema/types.d.ts +482 -62
  473. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  474. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  475. package/dist-lib/spec/local/hyperdb/messages.js +1565 -487
  476. package/dist-lib/spec/local/hyperschema/index.js +573 -16
  477. package/dist-lib/spec/local/hyperschema/schema.json +354 -1
  478. package/dist-lib/spec/local/hyperschema/types.d.ts +85 -2
  479. package/dist-lib/spec/mesh/hyperdb/db.json +577 -7
  480. package/dist-lib/spec/mesh/hyperdb/index.js +2224 -6
  481. package/dist-lib/spec/mesh/hyperdb/messages.js +6476 -1266
  482. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +193 -1
  483. package/dist-lib/spec/mesh/hyperdispatch/index.js +545 -1
  484. package/dist-lib/spec/mesh/hyperdispatch/messages.js +3655 -265
  485. package/dist-lib/spec/mesh/hyperschema/index.js +3655 -265
  486. package/dist-lib/spec/mesh/hyperschema/schema.json +1974 -19
  487. package/dist-lib/spec/mesh/hyperschema/types.d.ts +498 -6
  488. package/package.json +64 -43
  489. package/worker/assistant-sidecar.mjs +18 -2
  490. package/worker/stow-entry.mjs +2 -0
  491. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  492. package/dist-lib/lib/core/contract/compute.js +0 -48
  493. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  494. package/dist-lib/lib/core/device-invites.js +0 -63
  495. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  496. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  497. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  498. package/dist-lib/lib/core/grant-expiry.js +0 -66
  499. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  500. package/dist-lib/lib/core/handoff-channel.js +0 -123
  501. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  502. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  503. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  504. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  505. package/dist-lib/lib/core/hosted-agents.js +0 -140
  506. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  507. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  508. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  509. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  510. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  511. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  512. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  513. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  514. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  515. package/dist-lib/lib/core/secret-handoff.js +0 -29
  516. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  517. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  518. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  519. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  520. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  521. package/dist-lib/lib/image-cache-dir.js +0 -5
  522. package/dist-lib/lib/log-levels.d.ts +0 -7
  523. package/dist-lib/lib/log-levels.js +0 -1
  524. package/dist-lib/lib/logger.d.ts +0 -5
  525. package/dist-lib/lib/logger.js +0 -18
  526. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  527. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
  528. package/tui/README.md +0 -142
  529. package/tui/app.mjs +0 -6939
  530. package/tui/boot.mjs +0 -111
  531. package/tui/index.mjs +0 -53
  532. package/tui/lib/boot-timing.mjs +0 -41
  533. package/tui/lib/busy-words.mjs +0 -116
  534. package/tui/lib/export.mjs +0 -194
  535. package/tui/lib/knowledge-command.mjs +0 -190
  536. package/tui/lib/knowledge-import.mjs +0 -171
  537. package/tui/lib/render.mjs +0 -196
  538. package/tui/lib/save-file.mjs +0 -88
  539. package/tui/lib/select.mjs +0 -81
  540. package/tui/lib/selection.mjs +0 -18
  541. package/tui/lib/setup.mjs +0 -101
  542. package/tui/lib/sidebar.mjs +0 -63
  543. package/tui/lib/splash-art.mjs +0 -107
  544. package/tui/lib/splash.mjs +0 -18
  545. package/tui/lib/upload-frames.mjs +0 -9
  546. package/tui/lib/usage.mjs +0 -59
  547. package/tui/lib/wrap.mjs +0 -143
  548. package/tui/main.mjs +0 -264
@@ -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[redactString(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[];
@@ -0,0 +1,83 @@
1
+ const GLYPH = {
2
+ pass: '✓',
3
+ warn: '⚠',
4
+ fail: '✗',
5
+ declared: '·',
6
+ pending: '⋯'
7
+ };
8
+ const TEE = '├─';
9
+ const ELBOW = '└─';
10
+ const PIPE = '│ ';
11
+ const GAP = ' ';
12
+ const plain = (text) => text;
13
+ export function summarize(checks) {
14
+ const counts = { pass: 0, warn: 0, fail: 0, declared: 0, pending: 0 };
15
+ for (const item of checks) {
16
+ counts[item.state] += 1;
17
+ }
18
+ const parts = [`${counts.pass} ok`];
19
+ if (counts.warn) {
20
+ parts.push(`${counts.warn} warning${counts.warn === 1 ? '' : 's'}`);
21
+ }
22
+ if (counts.fail) {
23
+ parts.push(`${counts.fail} failed`);
24
+ }
25
+ if (counts.declared) {
26
+ parts.push(`${counts.declared} unverified`);
27
+ }
28
+ if (counts.pending) {
29
+ parts.push(`${counts.pending} measuring`);
30
+ }
31
+ return parts.join(' · ');
32
+ }
33
+ function groupsOf(checks) {
34
+ const groups = new Map();
35
+ for (const item of checks) {
36
+ const existing = groups.get(item.group);
37
+ if (existing) {
38
+ existing.push(item);
39
+ }
40
+ else {
41
+ groups.set(item.group, [item]);
42
+ }
43
+ }
44
+ return groups;
45
+ }
46
+ export function checkLines(checks, { paint = plain } = {}) {
47
+ const out = [];
48
+ for (const [group, items] of groupsOf(checks)) {
49
+ out.push('', paint(group.toUpperCase(), 'title'));
50
+ const width = Math.max(...items.map((item) => item.name.length));
51
+ items.forEach((item, index) => {
52
+ const last = index === items.length - 1;
53
+ const glyph = paint(GLYPH[item.state], item.state);
54
+ out.push(`${last ? ELBOW : TEE} ${glyph} ${item.name.padEnd(width)} ${item.detail}`);
55
+ if (item.state === 'declared' && item.fix) {
56
+ out.push(`${last ? GAP : PIPE} ${paint(item.fix, 'explain')}`);
57
+ }
58
+ });
59
+ }
60
+ return [...out, ...problemLines(checks, paint), ...legendLines(checks, paint)];
61
+ }
62
+ function problemLines(checks, paint) {
63
+ const problems = checks.filter((item) => item.state === 'fail' || item.state === 'warn');
64
+ if (problems.length === 0) {
65
+ return [];
66
+ }
67
+ const out = ['', paint('WHAT TO DO', 'title')];
68
+ problems.forEach((item, index) => {
69
+ const connector = index === problems.length - 1 ? ELBOW : TEE;
70
+ const glyph = paint(GLYPH[item.state], item.state);
71
+ out.push(`${connector} ${glyph} ${item.name} — ${item.fix ?? item.detail}`);
72
+ });
73
+ return out;
74
+ }
75
+ function legendLines(checks, paint) {
76
+ if (!checks.some((item) => item.state === 'declared'))
77
+ return [];
78
+ return [
79
+ '',
80
+ paint(`${GLYPH.declared} unverified — reported by config or not measured in this run, so it is not`, 'explain'),
81
+ paint(' proof the thing works. Never read one as a pass.', 'explain')
82
+ ];
83
+ }
@@ -0,0 +1,5 @@
1
+ export declare function humanizeBytes(value: number): string;
2
+ export declare function formatValue(value: unknown, key: string): string;
3
+ export declare function walkList(items: ReadonlyArray<unknown>, prefix: string, out: string[]): void;
4
+ export declare function headerLine(stats: unknown): string;
5
+ export declare function diagnosticsLines(stats: unknown): string[];
@@ -0,0 +1,167 @@
1
+ import { isRecord } from '../guards.js';
2
+ import { redact, truncateHex } from './redact.js';
3
+ const UNITS = ['B', 'KB', 'MB', 'GB', 'TB'];
4
+ const BYTE_KEYS = new Set([
5
+ 'rss',
6
+ 'heapUsed',
7
+ 'heapTotal',
8
+ 'external',
9
+ 'memory'
10
+ ]);
11
+ export function humanizeBytes(value) {
12
+ if (!Number.isFinite(value) || value <= 0)
13
+ return '0 B';
14
+ let scaled = value;
15
+ let unit = 0;
16
+ while (scaled >= 1024 && unit < UNITS.length - 1) {
17
+ scaled /= 1024;
18
+ unit += 1;
19
+ }
20
+ return `${unit === 0 ? Math.round(scaled) : scaled.toFixed(1)} ${UNITS[unit]}`;
21
+ }
22
+ function isByteKey(key) {
23
+ return BYTE_KEYS.has(key) || key.toLowerCase().endsWith('bytes');
24
+ }
25
+ function isTimestampKey(key) {
26
+ return key === 'at' || /[a-z]At$/.test(key);
27
+ }
28
+ const YEAR_2001_MS = 978_307_200_000;
29
+ function formatTimestamp(value) {
30
+ return new Date(value).toISOString().replace('T', ' ').slice(0, 19);
31
+ }
32
+ export function formatValue(value, key) {
33
+ if (value === null || value === undefined)
34
+ return 'null';
35
+ if (typeof value === 'boolean') {
36
+ return value ? 'true' : 'false';
37
+ }
38
+ if (typeof value === 'number' || typeof value === 'bigint') {
39
+ const num = Number(value);
40
+ if (isByteKey(key) && Number.isFinite(num)) {
41
+ return humanizeBytes(num);
42
+ }
43
+ if (isTimestampKey(key) && num >= YEAR_2001_MS) {
44
+ return formatTimestamp(num);
45
+ }
46
+ return Number.isInteger(num) ? String(num) : num.toFixed(3);
47
+ }
48
+ return String(value);
49
+ }
50
+ function isBranch(value) {
51
+ return isRecord(value) || Array.isArray(value);
52
+ }
53
+ function isScalarList(value) {
54
+ return Array.isArray(value) && value.every((item) => !isBranch(item));
55
+ }
56
+ const TEE = '├─ ';
57
+ const ELBOW = '└─ ';
58
+ const PIPE = '│ ';
59
+ const GAP = ' ';
60
+ function walk(value, prefix, out) {
61
+ const entries = Object.entries(value);
62
+ const inline = entries.filter(([, child]) => !isBranch(child) || isScalarList(child));
63
+ const width = Math.max(0, ...inline.map(([key]) => key.length));
64
+ entries.forEach(([key, child], index) => {
65
+ const last = index === entries.length - 1;
66
+ const head = `${prefix}${last ? ELBOW : TEE}`;
67
+ const below = `${prefix}${last ? GAP : PIPE}`;
68
+ if (isScalarList(child)) {
69
+ const text = child.length ? child.map((item) => formatValue(item, key)).join(', ') : 'none';
70
+ out.push(`${head}${key.padEnd(width)} ${text}`);
71
+ return;
72
+ }
73
+ if (Array.isArray(child)) {
74
+ out.push(`${head}${key}`);
75
+ walkList(child, below, out);
76
+ return;
77
+ }
78
+ if (isRecord(child)) {
79
+ if (Object.keys(child).length === 0) {
80
+ out.push(`${head}${key.padEnd(width)} none`);
81
+ return;
82
+ }
83
+ out.push(`${head}${key}`);
84
+ walk(child, below, out);
85
+ return;
86
+ }
87
+ out.push(`${head}${key.padEnd(width)} ${formatValue(child, key)}`);
88
+ });
89
+ }
90
+ export function walkList(items, prefix, out) {
91
+ const [only] = items;
92
+ if (items.length === 1 && isRecord(only)) {
93
+ walk(only, prefix, out);
94
+ return;
95
+ }
96
+ items.forEach((item, index) => {
97
+ const last = index === items.length - 1;
98
+ const head = `${prefix}${last ? ELBOW : TEE}`;
99
+ const below = `${prefix}${last ? GAP : PIPE}`;
100
+ if (!isRecord(item)) {
101
+ out.push(`${head}${formatValue(item, '')}`);
102
+ return;
103
+ }
104
+ out.push(`${head}${index + 1}`);
105
+ walk(item, below, out);
106
+ });
107
+ }
108
+ const SECTIONS = [
109
+ 'deviceInfo',
110
+ 'cpu',
111
+ 'gpu',
112
+ 'mesh',
113
+ 'network',
114
+ 'process',
115
+ 'harness',
116
+ 'assistant',
117
+ 'backendUse',
118
+ 'localConfig'
119
+ ];
120
+ const HEADER_KEYS = new Set(['device']);
121
+ export function headerLine(stats) {
122
+ const frame = isRecord(stats) ? stats : {};
123
+ const mesh = isRecord(frame['mesh']) ? frame['mesh'] : null;
124
+ const device = frame['device'];
125
+ const at = formatTimestamp(Date.now());
126
+ return [
127
+ at,
128
+ `device ${typeof device === 'string' ? truncateHex(device) : 'none'}`,
129
+ `mesh ${typeof mesh?.['key'] === 'string' ? truncateHex(mesh['key']) : 'none'}`
130
+ ].join(' · ');
131
+ }
132
+ function sectionTitle(key) {
133
+ return key.replace(/([a-z0-9])([A-Z])/g, '$1 $2').toUpperCase();
134
+ }
135
+ export function diagnosticsLines(stats) {
136
+ const header = headerLine(stats);
137
+ const frame = redact(stats);
138
+ if (!isRecord(frame)) {
139
+ return [header, '', '(no diagnostics snapshot yet)'];
140
+ }
141
+ const entries = Object.entries(frame);
142
+ const out = [header];
143
+ const loose = entries.filter(([key, value]) => !isBranch(value) && !HEADER_KEYS.has(key));
144
+ if (loose.length) {
145
+ out.push('');
146
+ walk(Object.fromEntries(loose), '', out);
147
+ }
148
+ const branches = entries.filter(([, value]) => isBranch(value)).map(([key]) => key);
149
+ const ordered = [
150
+ ...SECTIONS.filter((section) => branches.includes(section)),
151
+ ...branches.filter((key) => !SECTIONS.includes(key))
152
+ ];
153
+ for (const section of ordered) {
154
+ out.push('', sectionTitle(section));
155
+ const value = frame[section];
156
+ if (Array.isArray(value) && value.length) {
157
+ walkList(value, '', out);
158
+ }
159
+ else if (isRecord(value) && Object.keys(value).length) {
160
+ walk(value, '', out);
161
+ }
162
+ else {
163
+ out.push('└─ none');
164
+ }
165
+ }
166
+ return out;
167
+ }
@@ -0,0 +1,8 @@
1
+ import type { Harness } from './assistant.ts';
2
+ import type { LoggerInterface } from '@qvac/logging';
3
+ import type { openLocalStore } from './core/local/index.ts';
4
+ type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
5
+ export type DownloadsAllowedTarget = Pick<Harness, 'setDownloadsAllowed'>;
6
+ export type DownloadsAllowedSource = Pick<LocalStore, 'getAppConfigRow' | 'watch' | 'unwatch'>;
7
+ export declare function startDownloadsAllowedPusher(harness: DownloadsAllowedTarget, state: DownloadsAllowedSource, logger?: LoggerInterface | null): () => Promise<void>;
8
+ export {};
@@ -0,0 +1,37 @@
1
+ import ScopeLock from 'scope-lock';
2
+ import { errorMessage } from './guards.js';
3
+ export function startDownloadsAllowedPusher(harness, state, logger) {
4
+ const lock = new ScopeLock({ debounce: true });
5
+ let disposed = false;
6
+ let pushed = null;
7
+ const push = async () => {
8
+ const allowed = !(await state.getAppConfigRow())?.manualModelDownloads;
9
+ if (disposed || allowed === pushed) {
10
+ return;
11
+ }
12
+ await harness.setDownloadsAllowed?.({ allowed });
13
+ pushed = allowed;
14
+ };
15
+ const schedule = async () => {
16
+ if (disposed || !(await lock.lock()))
17
+ return;
18
+ try {
19
+ await push();
20
+ }
21
+ catch (err) {
22
+ logger?.warn('downloads-allowed-pusher', 'push failed', errorMessage(err));
23
+ }
24
+ finally {
25
+ lock.unlock();
26
+ }
27
+ };
28
+ const listener = () => void schedule();
29
+ state.watch(listener);
30
+ void schedule();
31
+ return async () => {
32
+ disposed = true;
33
+ state.unwatch(listener);
34
+ lock.destroy();
35
+ await lock.flush();
36
+ };
37
+ }