@qvac/core 0.4.1 → 0.6.0

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 (417) hide show
  1. package/CHANGELOG.md +262 -1
  2. package/README.md +1 -1
  3. package/dist-lib/lib/api/agents.js +3 -2
  4. package/dist-lib/lib/api/app-config.d.ts +1 -1
  5. package/dist-lib/lib/api/app-config.js +54 -15
  6. package/dist-lib/lib/api/attachments.d.ts +6 -5
  7. package/dist-lib/lib/api/attachments.js +4 -2
  8. package/dist-lib/lib/api/chat.d.ts +7 -3
  9. package/dist-lib/lib/api/chat.js +4 -4
  10. package/dist-lib/lib/api/chunks.js +3 -3
  11. package/dist-lib/lib/api/config.js +2 -2
  12. package/dist-lib/lib/api/current-mesh.d.ts +3 -4
  13. package/dist-lib/lib/api/current-mesh.js +9 -4
  14. package/dist-lib/lib/api/custom-models.d.ts +8 -1
  15. package/dist-lib/lib/api/custom-models.js +53 -16
  16. package/dist-lib/lib/api/devices.d.ts +14 -5
  17. package/dist-lib/lib/api/devices.js +14 -9
  18. package/dist-lib/lib/api/diagnostics.d.ts +1 -0
  19. package/dist-lib/lib/api/diagnostics.js +1 -1
  20. package/dist-lib/lib/api/effective-ctx-size.d.ts +6 -1
  21. package/dist-lib/lib/api/effective-ctx-size.js +5 -3
  22. package/dist-lib/lib/api/execution.js +9 -2
  23. package/dist-lib/lib/api/files.js +2 -1
  24. package/dist-lib/lib/api/index.d.ts +7 -1
  25. package/dist-lib/lib/api/index.js +101 -101
  26. package/dist-lib/lib/api/instrument.js +29 -20
  27. package/dist-lib/lib/api/knowledge.d.ts +6 -5
  28. package/dist-lib/lib/api/knowledge.js +8 -6
  29. package/dist-lib/lib/api/local-files.js +1 -1
  30. package/dist-lib/lib/api/logs.js +6 -3
  31. package/dist-lib/lib/api/members.js +22 -13
  32. package/dist-lib/lib/api/mesh.d.ts +7 -2
  33. package/dist-lib/lib/api/mesh.js +10 -5
  34. package/dist-lib/lib/api/model-download.js +1 -1
  35. package/dist-lib/lib/api/network.d.ts +1 -0
  36. package/dist-lib/lib/api/network.js +1 -1
  37. package/dist-lib/lib/api/notifications.js +23 -13
  38. package/dist-lib/lib/api/rag.d.ts +6 -1
  39. package/dist-lib/lib/api/rag.js +20 -11
  40. package/dist-lib/lib/api/range.d.ts +2 -2
  41. package/dist-lib/lib/api/sync.js +1 -1
  42. package/dist-lib/lib/api/tool-activity.js +7 -3
  43. package/dist-lib/lib/api/tool-configs.js +2 -4
  44. package/dist-lib/lib/api/upload-frames.d.ts +7 -8
  45. package/dist-lib/lib/api/upload-frames.js +2 -1
  46. package/dist-lib/lib/api/watchable.d.ts +6 -1
  47. package/dist-lib/lib/api/watchable.js +23 -14
  48. package/dist-lib/lib/assistant/fetch-body.js +4 -2
  49. package/dist-lib/lib/assistant/harness.d.ts +72 -24
  50. package/dist-lib/lib/assistant/harness.js +53 -15
  51. package/dist-lib/lib/assistant/history.d.ts +9 -7
  52. package/dist-lib/lib/assistant/history.js +77 -42
  53. package/dist-lib/lib/assistant/message.d.ts +5 -3
  54. package/dist-lib/lib/assistant/message.js +4 -2
  55. package/dist-lib/lib/assistant/skill-encode.d.ts +3 -1
  56. package/dist-lib/lib/assistant/skill-encode.js +52 -62
  57. package/dist-lib/lib/assistant-client.js +7 -4
  58. package/dist-lib/lib/assistant-tree.js +36 -11
  59. package/dist-lib/lib/assistant.d.ts +37 -12
  60. package/dist-lib/lib/assistant.js +977 -373
  61. package/dist-lib/lib/audio-format.d.ts +1 -1
  62. package/dist-lib/lib/audio-format.js +1 -1
  63. package/dist-lib/lib/chat-title.js +9 -4
  64. package/dist-lib/lib/client.js +3 -2
  65. package/dist-lib/lib/collabora/convert.d.ts +2 -2
  66. package/dist-lib/lib/collabora/convert.js +6 -3
  67. package/dist-lib/lib/collabora/entry.js +9 -5
  68. package/dist-lib/lib/collabora/protocol.d.ts +2 -2
  69. package/dist-lib/lib/collabora/protocol.js +14 -7
  70. package/dist-lib/lib/collabora/worker.js +14 -7
  71. package/dist-lib/lib/compaction.d.ts +5 -6
  72. package/dist-lib/lib/compaction.js +14 -7
  73. package/dist-lib/lib/constants.d.ts +2 -0
  74. package/dist-lib/lib/constants.js +4 -0
  75. package/dist-lib/lib/core/account-recovery.d.ts +4 -3
  76. package/dist-lib/lib/core/account-recovery.js +7 -4
  77. package/dist-lib/lib/core/agent.d.ts +0 -1
  78. package/dist-lib/lib/core/agent.js +18 -16
  79. package/dist-lib/lib/core/approval-rules.d.ts +7 -6
  80. package/dist-lib/lib/core/approval-rules.js +12 -6
  81. package/dist-lib/lib/core/archived-mesh.d.ts +7 -5
  82. package/dist-lib/lib/core/archived-mesh.js +25 -22
  83. package/dist-lib/lib/core/async-iterable.js +10 -5
  84. package/dist-lib/lib/core/attachment-link.d.ts +2 -2
  85. package/dist-lib/lib/core/audio-attachment.js +1 -1
  86. package/dist-lib/lib/core/blind-peers.d.ts +2 -2
  87. package/dist-lib/lib/core/chat-activity.d.ts +2 -2
  88. package/dist-lib/lib/core/chat-activity.js +42 -21
  89. package/dist-lib/lib/core/chat-group.d.ts +8 -6
  90. package/dist-lib/lib/core/chat-group.js +17 -10
  91. package/dist-lib/lib/core/chat-order.d.ts +11 -9
  92. package/dist-lib/lib/core/chat-order.js +1 -3
  93. package/dist-lib/lib/core/chat-search.d.ts +4 -4
  94. package/dist-lib/lib/core/chat-search.js +38 -24
  95. package/dist-lib/lib/core/chat.d.ts +20 -14
  96. package/dist-lib/lib/core/chat.js +42 -28
  97. package/dist-lib/lib/core/chunk.d.ts +20 -24
  98. package/dist-lib/lib/core/chunk.js +34 -22
  99. package/dist-lib/lib/core/collections.d.ts +69 -0
  100. package/dist-lib/lib/core/collections.js +69 -0
  101. package/dist-lib/lib/core/contract/activity.d.ts +8 -2
  102. package/dist-lib/lib/core/contract/activity.js +39 -11
  103. package/dist-lib/lib/core/contract/agents.js +3 -2
  104. package/dist-lib/lib/core/contract/approval-rules.js +1 -1
  105. package/dist-lib/lib/core/contract/attestations.js +1 -1
  106. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  107. package/dist-lib/lib/core/contract/chat.js +1 -1
  108. package/dist-lib/lib/core/contract/chunks.js +16 -9
  109. package/dist-lib/lib/core/contract/compute.js +2 -1
  110. package/dist-lib/lib/core/contract/devices.js +10 -6
  111. package/dist-lib/lib/core/contract/grant-order.d.ts +5 -0
  112. package/dist-lib/lib/core/contract/grant-order.js +20 -0
  113. package/dist-lib/lib/core/contract/index.d.ts +1 -1
  114. package/dist-lib/lib/core/contract/index.js +27 -2
  115. package/dist-lib/lib/core/contract/indexing.js +3 -3
  116. package/dist-lib/lib/core/contract/invites.d.ts +16 -0
  117. package/dist-lib/lib/core/contract/invites.js +256 -0
  118. package/dist-lib/lib/core/contract/joined-meshes.js +22 -22
  119. package/dist-lib/lib/core/contract/knowledge.js +5 -5
  120. package/dist-lib/lib/core/contract/members.d.ts +15 -0
  121. package/dist-lib/lib/core/contract/members.js +116 -31
  122. package/dist-lib/lib/core/contract/mesh-kind.d.ts +6 -0
  123. package/dist-lib/lib/core/contract/mesh-kind.js +49 -0
  124. package/dist-lib/lib/core/contract/seal.js +1 -1
  125. package/dist-lib/lib/core/contract/seed-defaults.js +1 -3
  126. package/dist-lib/lib/core/contract/tool-activity.js +5 -5
  127. package/dist-lib/lib/core/contract/tool-configs.js +1 -2
  128. package/dist-lib/lib/core/contract/writers.d.ts +13 -0
  129. package/dist-lib/lib/core/contract/writers.js +181 -24
  130. package/dist-lib/lib/core/departures.js +16 -8
  131. package/dist-lib/lib/core/device-attestation.d.ts +5 -0
  132. package/dist-lib/lib/core/device-attestation.js +24 -0
  133. package/dist-lib/lib/core/device-invites.d.ts +2 -0
  134. package/dist-lib/lib/core/device-invites.js +29 -7
  135. package/dist-lib/lib/core/devices.d.ts +2 -1
  136. package/dist-lib/lib/core/devices.js +52 -2
  137. package/dist-lib/lib/core/document-attachment.d.ts +20 -11
  138. package/dist-lib/lib/core/document-attachment.js +10 -5
  139. package/dist-lib/lib/core/files/attachments.d.ts +2 -5
  140. package/dist-lib/lib/core/files/attachments.js +6 -3
  141. package/dist-lib/lib/core/files/index.d.ts +44 -52
  142. package/dist-lib/lib/core/files/index.js +142 -93
  143. package/dist-lib/lib/core/files/knowledge.d.ts +2 -5
  144. package/dist-lib/lib/core/files/local-index.js +9 -5
  145. package/dist-lib/lib/core/files/preview/image.d.ts +0 -1
  146. package/dist-lib/lib/core/files/preview/image.js +9 -6
  147. package/dist-lib/lib/core/files/preview/index.d.ts +8 -11
  148. package/dist-lib/lib/core/files/preview/index.js +20 -15
  149. package/dist-lib/lib/core/files/processing/claims.d.ts +6 -5
  150. package/dist-lib/lib/core/files/processing/claims.js +16 -8
  151. package/dist-lib/lib/core/files/processing/document.d.ts +21 -50
  152. package/dist-lib/lib/core/files/processing/index.d.ts +18 -13
  153. package/dist-lib/lib/core/files/processing/index.js +65 -37
  154. package/dist-lib/lib/core/files/processing/ownership.d.ts +8 -1
  155. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  156. package/dist-lib/lib/core/files/processing/protocol.d.ts +19 -19
  157. package/dist-lib/lib/core/files/processing/protocol.js +5 -5
  158. package/dist-lib/lib/core/files/processing/settle.d.ts +10 -7
  159. package/dist-lib/lib/core/files/processing/settle.js +22 -11
  160. package/dist-lib/lib/core/files/processing/source.js +14 -8
  161. package/dist-lib/lib/core/files/processing/state.d.ts +13 -11
  162. package/dist-lib/lib/core/files/processing/state.js +19 -12
  163. package/dist-lib/lib/core/files/rag/build.d.ts +2 -2
  164. package/dist-lib/lib/core/files/rag/build.js +2 -1
  165. package/dist-lib/lib/core/files/rag/document-types.d.ts +4 -6
  166. package/dist-lib/lib/core/files/rag/index.d.ts +10 -13
  167. package/dist-lib/lib/core/files/rag/index.js +3 -2
  168. package/dist-lib/lib/core/files/rag/load.d.ts +10 -9
  169. package/dist-lib/lib/core/files/rag/load.js +26 -13
  170. package/dist-lib/lib/core/files/rag/policy.js +2 -1
  171. package/dist-lib/lib/core/files/rag/produce.js +33 -19
  172. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +5 -3
  173. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +30 -10
  174. package/dist-lib/lib/core/files/records/chunks.js +4 -2
  175. package/dist-lib/lib/core/files/records/knowledge.d.ts +10 -11
  176. package/dist-lib/lib/core/files/records/knowledge.js +9 -8
  177. package/dist-lib/lib/core/files/records/linkage.js +6 -3
  178. package/dist-lib/lib/core/files/records/output.d.ts +5 -4
  179. package/dist-lib/lib/core/files/records/output.js +8 -4
  180. package/dist-lib/lib/core/files/records/reclaim.js +41 -25
  181. package/dist-lib/lib/core/files/records/routing.d.ts +4 -6
  182. package/dist-lib/lib/core/files/records/routing.js +15 -8
  183. package/dist-lib/lib/core/files/records/source.d.ts +5 -4
  184. package/dist-lib/lib/core/files/records/source.js +20 -14
  185. package/dist-lib/lib/core/files/records/sweep.js +1 -3
  186. package/dist-lib/lib/core/files/store/blob.d.ts +10 -10
  187. package/dist-lib/lib/core/files/store/blob.js +25 -19
  188. package/dist-lib/lib/core/files/store/index.d.ts +1 -6
  189. package/dist-lib/lib/core/files/store/index.js +4 -4
  190. package/dist-lib/lib/core/files/store/inline.d.ts +2 -2
  191. package/dist-lib/lib/core/files/store/inline.js +6 -3
  192. package/dist-lib/lib/core/files/store/reference.d.ts +6 -9
  193. package/dist-lib/lib/core/files/store/reference.js +25 -17
  194. package/dist-lib/lib/core/files/store/server.d.ts +7 -6
  195. package/dist-lib/lib/core/files/store/server.js +22 -11
  196. package/dist-lib/lib/core/files/store/sweep.js +13 -7
  197. package/dist-lib/lib/core/files/upload-input.d.ts +4 -12
  198. package/dist-lib/lib/core/files/upload-input.js +10 -5
  199. package/dist-lib/lib/core/files/upload.d.ts +27 -24
  200. package/dist-lib/lib/core/files/upload.js +74 -51
  201. package/dist-lib/lib/core/fs-drives.js +4 -2
  202. package/dist-lib/lib/core/grant-expiry.d.ts +11 -0
  203. package/dist-lib/lib/core/grant-expiry.js +66 -0
  204. package/dist-lib/lib/core/handoff-channel.d.ts +2 -1
  205. package/dist-lib/lib/core/handoff-channel.js +36 -15
  206. package/dist-lib/lib/core/harness-loan.js +35 -17
  207. package/dist-lib/lib/core/helpers/index.d.ts +2 -1
  208. package/dist-lib/lib/core/helpers/index.js +11 -6
  209. package/dist-lib/lib/core/hosted-agents.js +19 -12
  210. package/dist-lib/lib/core/id.js +1 -1
  211. package/dist-lib/lib/core/identity.d.ts +1 -0
  212. package/dist-lib/lib/core/identity.js +11 -3
  213. package/dist-lib/lib/core/image/cache-sweep.d.ts +12 -10
  214. package/dist-lib/lib/core/image/cache-sweep.js +11 -6
  215. package/dist-lib/lib/core/image/normalize.d.ts +6 -0
  216. package/dist-lib/lib/core/image/normalize.js +12 -2
  217. package/dist-lib/lib/core/image/sniff.js +42 -21
  218. package/dist-lib/lib/core/inference-calls-receiver.js +7 -4
  219. package/dist-lib/lib/core/invite-grants.d.ts +20 -0
  220. package/dist-lib/lib/core/invite-grants.js +46 -0
  221. package/dist-lib/lib/core/invite.d.ts +3 -0
  222. package/dist-lib/lib/core/invite.js +6 -3
  223. package/dist-lib/lib/core/local/files.js +20 -19
  224. package/dist-lib/lib/core/local/index.d.ts +70 -45
  225. package/dist-lib/lib/core/local/index.js +157 -126
  226. package/dist-lib/lib/core/membership.d.ts +15 -2
  227. package/dist-lib/lib/core/membership.js +95 -20
  228. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +12 -4
  229. package/dist-lib/lib/core/mesh-seed-handoff.js +23 -5
  230. package/dist-lib/lib/core/mesh.d.ts +57 -30
  231. package/dist-lib/lib/core/mesh.js +232 -78
  232. package/dist-lib/lib/core/migrations/agent-catalog.js +3 -2
  233. package/dist-lib/lib/core/migrations/agent-indexes.js +3 -3
  234. package/dist-lib/lib/core/migrations/device-indexes.d.ts +2 -0
  235. package/dist-lib/lib/core/migrations/device-indexes.js +7 -0
  236. package/dist-lib/lib/core/migrations/file-index.js +7 -4
  237. package/dist-lib/lib/core/migrations/index.d.ts +4 -3
  238. package/dist-lib/lib/core/migrations/index.js +3 -1
  239. package/dist-lib/lib/core/migrations/membership.js +9 -4
  240. package/dist-lib/lib/core/migrations/seal.js +3 -2
  241. package/dist-lib/lib/core/min-version.js +4 -2
  242. package/dist-lib/lib/core/next-frame.d.ts +5 -4
  243. package/dist-lib/lib/core/next-frame.js +6 -3
  244. package/dist-lib/lib/core/notification.d.ts +5 -1
  245. package/dist-lib/lib/core/notification.js +89 -77
  246. package/dist-lib/lib/core/ota-config.js +2 -1
  247. package/dist-lib/lib/core/pdf/rasterize.d.ts +18 -0
  248. package/dist-lib/lib/core/pdf/rasterize.js +57 -0
  249. package/dist-lib/lib/core/prompt-history.js +4 -2
  250. package/dist-lib/lib/core/range.d.ts +4 -4
  251. package/dist-lib/lib/core/range.js +12 -6
  252. package/dist-lib/lib/core/rank.d.ts +5 -4
  253. package/dist-lib/lib/core/rank.js +2 -1
  254. package/dist-lib/lib/core/send.d.ts +8 -5
  255. package/dist-lib/lib/core/send.js +9 -3
  256. package/dist-lib/lib/core/skill-overlay-receiver.js +7 -4
  257. package/dist-lib/lib/core/skill-secrets.js +16 -9
  258. package/dist-lib/lib/core/sync/chunks.js +2 -1
  259. package/dist-lib/lib/core/sync/devices.js +3 -1
  260. package/dist-lib/lib/core/sync/files.d.ts +2 -4
  261. package/dist-lib/lib/core/sync/files.js +28 -20
  262. package/dist-lib/lib/core/sync/index.d.ts +2 -5
  263. package/dist-lib/lib/core/sync/index.js +33 -17
  264. package/dist-lib/lib/core/sync-status.js +10 -7
  265. package/dist-lib/lib/core/system-info.js +4 -2
  266. package/dist-lib/lib/core/tool-activity.d.ts +4 -3
  267. package/dist-lib/lib/core/tool-activity.js +1 -1
  268. package/dist-lib/lib/core/tool-configs.js +12 -7
  269. package/dist-lib/lib/core.d.ts +107 -45
  270. package/dist-lib/lib/core.js +1765 -595
  271. package/dist-lib/lib/credential-pusher.d.ts +12 -17
  272. package/dist-lib/lib/credential-pusher.js +61 -42
  273. package/dist-lib/lib/custom-model-pusher.d.ts +7 -3
  274. package/dist-lib/lib/custom-model-pusher.js +15 -7
  275. package/dist-lib/lib/custom-model-task.d.ts +1 -0
  276. package/dist-lib/lib/custom-model-task.js +12 -0
  277. package/dist-lib/lib/deadline.js +4 -2
  278. package/dist-lib/lib/diagnostics.d.ts +1 -5
  279. package/dist-lib/lib/frame-readable.d.ts +3 -0
  280. package/dist-lib/lib/frame-readable.js +3 -0
  281. package/dist-lib/lib/fs-drive-bridge.js +24 -14
  282. package/dist-lib/lib/fs-grants.js +13 -8
  283. package/dist-lib/lib/guards.d.ts +3 -0
  284. package/dist-lib/lib/guards.js +9 -0
  285. package/dist-lib/lib/inference-calls.d.ts +28 -23
  286. package/dist-lib/lib/inference-calls.js +25 -13
  287. package/dist-lib/lib/integrations/mcp-providers.d.ts +2 -2
  288. package/dist-lib/lib/integrations/setup-routes.d.ts +2 -2
  289. package/dist-lib/lib/knowledge-search.d.ts +6 -5
  290. package/dist-lib/lib/knowledge-search.js +26 -18
  291. package/dist-lib/lib/kv-cache-reclaim.js +4 -2
  292. package/dist-lib/lib/kv-cache.js +8 -4
  293. package/dist-lib/lib/legacy-core-domain.d.ts +42 -42
  294. package/dist-lib/lib/log-buffer.js +2 -1
  295. package/dist-lib/lib/log.js +25 -15
  296. package/dist-lib/lib/mesh-scoped-engine.js +14 -4
  297. package/dist-lib/lib/model-catalog-revision.js +6 -3
  298. package/dist-lib/lib/model-clamp.js +6 -3
  299. package/dist-lib/lib/model-context.d.ts +8 -3
  300. package/dist-lib/lib/model-context.js +13 -5
  301. package/dist-lib/lib/model-download-status.js +4 -2
  302. package/dist-lib/lib/model-download.d.ts +12 -4
  303. package/dist-lib/lib/model-download.js +200 -103
  304. package/dist-lib/lib/model-idle-pusher.d.ts +10 -0
  305. package/dist-lib/lib/model-idle-pusher.js +41 -0
  306. package/dist-lib/lib/oauth/browser-connect.d.ts +10 -8
  307. package/dist-lib/lib/oauth/browser-connect.js +33 -20
  308. package/dist-lib/lib/oauth/client.d.ts +2 -2
  309. package/dist-lib/lib/oauth/flow-core.js +23 -9
  310. package/dist-lib/lib/oauth/flow.d.ts +1 -3
  311. package/dist-lib/lib/oauth/flow.js +9 -5
  312. package/dist-lib/lib/oauth/keys.d.ts +4 -4
  313. package/dist-lib/lib/oauth/keys.js +18 -12
  314. package/dist-lib/lib/oauth/loopback.d.ts +2 -2
  315. package/dist-lib/lib/oauth/loopback.js +147 -107
  316. package/dist-lib/lib/oauth/loopback.stub.d.ts +2 -2
  317. package/dist-lib/lib/oauth/loopback.stub.js +1 -1
  318. package/dist-lib/lib/oauth/pkce.d.ts +4 -2
  319. package/dist-lib/lib/oauth/pkce.js +10 -0
  320. package/dist-lib/lib/oauth/providers.js +5 -5
  321. package/dist-lib/lib/oauth/redirect-types.d.ts +12 -7
  322. package/dist-lib/lib/oauth/register.js +3 -2
  323. package/dist-lib/lib/oauth/registry.d.ts +2 -2
  324. package/dist-lib/lib/oauth/registry.js +2 -1
  325. package/dist-lib/lib/oauth/resolve.d.ts +30 -10
  326. package/dist-lib/lib/oauth/resolve.js +12 -6
  327. package/dist-lib/lib/oauth/token-exchange-core.d.ts +12 -4
  328. package/dist-lib/lib/oauth/token-exchange-core.js +1 -1
  329. package/dist-lib/lib/oauth/types.d.ts +12 -12
  330. package/dist-lib/lib/oauth.d.ts +4 -5
  331. package/dist-lib/lib/oauth.js +2 -3
  332. package/dist-lib/lib/reconnecting-watch.d.ts +1 -1
  333. package/dist-lib/lib/reconnecting-watch.js +6 -6
  334. package/dist-lib/lib/retry-budget.js +6 -3
  335. package/dist-lib/lib/run-notices.d.ts +2 -0
  336. package/dist-lib/lib/run-notices.js +7 -3
  337. package/dist-lib/lib/run-transcript.d.ts +2 -4
  338. package/dist-lib/lib/run-transcript.js +4 -2
  339. package/dist-lib/lib/skill-readiness.d.ts +1 -0
  340. package/dist-lib/lib/skill-readiness.js +17 -2
  341. package/dist-lib/lib/skill-types.d.ts +16 -16
  342. package/dist-lib/lib/suspend-lifecycle.d.ts +4 -4
  343. package/dist-lib/lib/suspend-lifecycle.js +10 -5
  344. package/dist-lib/lib/task.d.ts +5 -1
  345. package/dist-lib/lib/task.js +29 -12
  346. package/dist-lib/lib/unref.d.ts +3 -2
  347. package/dist-lib/lib/unref.js +2 -1
  348. package/dist-lib/lib/wav-duration.js +10 -5
  349. package/dist-lib/lib/write-queue.d.ts +5 -4
  350. package/dist-lib/lib/write-queue.js +2 -1
  351. package/dist-lib/schema/build.js +16 -8
  352. package/dist-lib/schema/config.d.ts +3 -4
  353. package/dist-lib/schema/config.js +1 -1
  354. package/dist-lib/schema/content.d.ts +18 -2
  355. package/dist-lib/schema/content.js +4 -1
  356. package/dist-lib/schema/engine.d.ts +3 -2
  357. package/dist-lib/schema/engine.js +192 -12
  358. package/dist-lib/schema/field-order.js +22 -11
  359. package/dist-lib/schema/indexes.d.ts +22 -0
  360. package/dist-lib/schema/{helpers.js → indexes.js} +19 -57
  361. package/dist-lib/schema/local.d.ts +3 -2
  362. package/dist-lib/schema/local.js +9 -3
  363. package/dist-lib/schema/media-kind.d.ts +8 -0
  364. package/dist-lib/schema/media-kind.js +52 -0
  365. package/dist-lib/schema/qvac.d.ts +12 -9
  366. package/dist-lib/schema/qvac.js +132 -7
  367. package/dist-lib/spec/bind.js +21 -0
  368. package/dist-lib/spec/calls.js +7 -0
  369. package/dist-lib/spec/capabilities.d.ts +18 -4
  370. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  371. package/dist-lib/spec/hrpc/hrpc.json +93 -2
  372. package/dist-lib/spec/hrpc/index.js +89 -5
  373. package/dist-lib/spec/hrpc/messages.js +1568 -941
  374. package/dist-lib/spec/hyperschema/index.js +1568 -941
  375. package/dist-lib/spec/hyperschema/schema.json +531 -1
  376. package/dist-lib/spec/hyperschema/types.d.ts +145 -1
  377. package/dist-lib/spec/local/hyperdb/index.js +1 -1
  378. package/dist-lib/spec/local/hyperdb/messages.js +92 -20
  379. package/dist-lib/spec/local/hyperschema/index.js +47 -11
  380. package/dist-lib/spec/local/hyperschema/schema.json +32 -1
  381. package/dist-lib/spec/local/hyperschema/types.d.ts +7 -1
  382. package/dist-lib/spec/mesh/hyperdb/db.json +131 -3
  383. package/dist-lib/spec/mesh/hyperdb/index.js +548 -5
  384. package/dist-lib/spec/mesh/hyperdb/messages.js +2444 -893
  385. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +37 -1
  386. package/dist-lib/spec/mesh/hyperdispatch/index.js +104 -2
  387. package/dist-lib/spec/mesh/hyperdispatch/messages.js +1035 -11
  388. package/dist-lib/spec/mesh/hyperschema/index.js +1035 -11
  389. package/dist-lib/spec/mesh/hyperschema/schema.json +553 -1
  390. package/dist-lib/spec/mesh/hyperschema/types.d.ts +143 -1
  391. package/package.json +11 -5
  392. package/tui/app.mjs +2624 -986
  393. package/tui/boot.mjs +17 -46
  394. package/tui/index.mjs +10 -5
  395. package/tui/lib/boot-timing.mjs +8 -8
  396. package/tui/lib/busy-words.mjs +21 -22
  397. package/tui/lib/export.mjs +100 -32
  398. package/tui/lib/knowledge-command.mjs +64 -19
  399. package/tui/lib/knowledge-import.mjs +52 -18
  400. package/tui/lib/render.mjs +65 -33
  401. package/tui/lib/save-file.mjs +30 -13
  402. package/tui/lib/select.mjs +23 -5
  403. package/tui/lib/selection.mjs +6 -4
  404. package/tui/lib/setup.mjs +11 -19
  405. package/tui/lib/sidebar.mjs +23 -13
  406. package/tui/lib/splash.mjs +6 -7
  407. package/tui/lib/upload-frames.mjs +1 -2
  408. package/tui/lib/usage.mjs +13 -9
  409. package/tui/lib/wrap.mjs +35 -6
  410. package/tui/main.mjs +54 -78
  411. package/worker/assistant-sidecar.mjs +5 -10
  412. package/worker/stow-entry.mjs +7 -4
  413. package/dist-lib/lib/custom-model-source.d.ts +0 -15
  414. package/dist-lib/lib/custom-model-source.js +0 -46
  415. package/dist-lib/lib/oauth/common.d.ts +0 -38
  416. package/dist-lib/lib/oauth/common.js +0 -34
  417. package/dist-lib/schema/helpers.d.ts +0 -32
@@ -3,6 +3,30 @@ export interface InferenceCallEntry {
3
3
  at: number;
4
4
  call: Record<string, unknown>;
5
5
  }
6
+ export interface InferenceCallSent {
7
+ readonly runId: string;
8
+ readonly round: number;
9
+ readonly messages: unknown;
10
+ readonly tokens: unknown;
11
+ readonly outcome: unknown;
12
+ readonly reason: unknown;
13
+ }
14
+ export interface InferenceCallOutcome {
15
+ readonly runId: string;
16
+ readonly outcome: string;
17
+ readonly reason: string | null;
18
+ }
19
+ export interface InferenceCallPage {
20
+ readonly calls: ReadonlyArray<InferenceCallEntry>;
21
+ readonly truncated: boolean;
22
+ }
23
+ export interface SweepLimits {
24
+ readonly maxTotalBytes?: number;
25
+ readonly maxAgeMs?: number;
26
+ }
27
+ export interface SweepResult {
28
+ readonly removed: number;
29
+ }
6
30
  export declare function defaultInferenceCallsDir(): string;
7
31
  export declare const MAX_TOTAL_BYTES: number;
8
32
  export declare const MAX_AGE_MS: number;
@@ -11,30 +35,11 @@ export declare class InferenceCallStore {
11
35
  private readonly _writes;
12
36
  constructor(dir?: string);
13
37
  record(chatId: string, entry: InferenceCallEntry): Promise<void>;
14
- recordSent(chatId: string, sent: {
15
- runId: string;
16
- round: number;
17
- messages: unknown;
18
- tokens: unknown;
19
- outcome: unknown;
20
- reason: unknown;
21
- }): Promise<void>;
22
- recordOutcome(chatId: string, verdict: {
23
- runId: string;
24
- outcome: string;
25
- reason: string | null;
26
- }): Promise<void>;
27
- list(chatId: string): {
28
- calls: ReadonlyArray<InferenceCallEntry>;
29
- truncated: boolean;
30
- };
38
+ recordSent(chatId: string, sent: InferenceCallSent): Promise<void>;
39
+ recordOutcome(chatId: string, verdict: InferenceCallOutcome): Promise<void>;
40
+ list(chatId: string): InferenceCallPage;
31
41
  forget(chatId: string): Promise<void>;
32
- sweep(limits?: {
33
- maxTotalBytes?: number;
34
- maxAgeMs?: number;
35
- }): Promise<{
36
- removed: number;
37
- }>;
42
+ sweep(limits?: SweepLimits): Promise<SweepResult>;
38
43
  private _drop;
39
44
  private _chatSizes;
40
45
  }
@@ -2,6 +2,7 @@ import fs from 'fs';
2
2
  import { join } from 'path';
3
3
  import { persistent } from 'bare-storage';
4
4
  import { WriteQueue } from './write-queue.js';
5
+ import { isRecord } from './guards.js';
5
6
  export function defaultInferenceCallsDir() {
6
7
  return join(persistent(), 'qvac', 'inspector');
7
8
  }
@@ -24,13 +25,14 @@ export class InferenceCallStore {
24
25
  const chatDir = join(this._dir, safeName(chatId));
25
26
  await fs.promises.mkdir(join(chatDir, BLOCKS_DIR), { recursive: true });
26
27
  const callsPath = join(chatDir, CALLS_FILE);
27
- if (((await sizeOf(callsPath)) ?? 0) > MAX_CALLS_BYTES)
28
+ if (((await sizeOf(callsPath)) ?? 0) > MAX_CALLS_BYTES) {
28
29
  return;
30
+ }
29
31
  if (promptPrefix) {
30
32
  const blockPath = join(chatDir, BLOCKS_DIR, `${safeName(promptPrefix)}.json`);
31
33
  await fs.promises
32
34
  .writeFile(blockPath, JSON.stringify({ system, tools }), { flag: 'wx' })
33
- .catch(() => undefined);
35
+ .catch(noop);
34
36
  }
35
37
  const line = JSON.stringify({ runId: entry.runId, at: entry.at, ...rest });
36
38
  await fs.promises.appendFile(callsPath, `${line}\n`);
@@ -41,8 +43,9 @@ export class InferenceCallStore {
41
43
  const chatDir = join(this._dir, safeName(chatId));
42
44
  const callsPath = join(chatDir, CALLS_FILE);
43
45
  const size = await sizeOf(callsPath);
44
- if (size === null || size > MAX_CALLS_BYTES)
46
+ if (size === null || size > MAX_CALLS_BYTES) {
45
47
  return;
48
+ }
46
49
  const line = JSON.stringify({
47
50
  sentFor: sent.round,
48
51
  sentRun: sent.runId,
@@ -58,8 +61,9 @@ export class InferenceCallStore {
58
61
  return this._writes.run(chatId, 'inference-outcome', async () => {
59
62
  const callsPath = join(this._dir, safeName(chatId), CALLS_FILE);
60
63
  const size = await sizeOf(callsPath);
61
- if (size === null || size > MAX_CALLS_BYTES)
64
+ if (size === null || size > MAX_CALLS_BYTES) {
62
65
  return;
66
+ }
63
67
  const line = JSON.stringify({
64
68
  outcomeFor: verdict.runId,
65
69
  outcome: verdict.outcome,
@@ -76,8 +80,9 @@ export class InferenceCallStore {
76
80
  const entries = [];
77
81
  for (const line of lines) {
78
82
  const parsed = parseLine(line);
79
- if (!parsed)
83
+ if (!parsed) {
80
84
  continue;
85
+ }
81
86
  if ('sentFor' in parsed) {
82
87
  foldSent(entries, parsed);
83
88
  continue;
@@ -145,8 +150,9 @@ export class InferenceCallStore {
145
150
  const chats = [];
146
151
  for (const name of names) {
147
152
  const measured = await measureDir(join(this._dir, name));
148
- if (measured)
153
+ if (measured) {
149
154
  chats.push({ name, ...measured });
155
+ }
150
156
  }
151
157
  return chats;
152
158
  }
@@ -157,8 +163,9 @@ async function measureDir(dir) {
157
163
  const visit = async (path) => {
158
164
  const stat = await fs.promises.stat(path);
159
165
  if (stat.isDirectory()) {
160
- for (const child of await fs.promises.readdir(path))
166
+ for (const child of await fs.promises.readdir(path)) {
161
167
  await visit(join(path, child));
168
+ }
162
169
  return;
163
170
  }
164
171
  bytes += stat.size;
@@ -177,8 +184,9 @@ function foldSent(entries, parsed) {
177
184
  const runId = parsed.sentRun === undefined ? null : String(parsed.sentRun);
178
185
  for (let index = entries.length - 1; index >= 0; index--) {
179
186
  const entry = entries[index];
180
- if (runId !== null && entry?.runId !== runId)
187
+ if (runId !== null && entry?.runId !== runId) {
181
188
  continue;
189
+ }
182
190
  if (entry && Number(entry.call.round ?? -1) === round) {
183
191
  entry.call.sent = parsed.sent ?? null;
184
192
  entry.call.tokens = parsed.tokens ?? null;
@@ -213,24 +221,27 @@ function split(call) {
213
221
  };
214
222
  }
215
223
  function isSystemTurn(turn) {
216
- return typeof turn === 'object' && turn !== null && 'role' in turn && turn.role === 'system';
224
+ return isRecord(turn) && turn.role === 'system';
217
225
  }
218
226
  function readBlock(cache, chatDir, prefix) {
219
227
  const hit = cache.get(prefix);
220
- if (hit)
228
+ if (hit) {
221
229
  return hit;
230
+ }
222
231
  const raw = readFile(join(chatDir, BLOCKS_DIR, `${safeName(prefix)}.json`));
223
- if (!raw)
232
+ if (!raw) {
224
233
  return null;
234
+ }
225
235
  const parsed = parseBlock(raw);
226
- if (parsed)
236
+ if (parsed) {
227
237
  cache.set(prefix, parsed);
238
+ }
228
239
  return parsed;
229
240
  }
230
241
  function parseLine(line) {
231
242
  try {
232
243
  const value = JSON.parse(line);
233
- return typeof value === 'object' && value !== null ? value : null;
244
+ return isRecord(value) ? value : null;
234
245
  }
235
246
  catch {
236
247
  return null;
@@ -264,3 +275,4 @@ function safeName(value) {
264
275
  const fenced = value.replace(/[^A-Za-z0-9._-]/g, '_');
265
276
  return /^\.*$/.test(fenced) ? `_${fenced}` : fenced;
266
277
  }
278
+ function noop() { }
@@ -1,12 +1,12 @@
1
1
  export type McpTokenProvider = 'github';
2
- export type McpProviderConfig = {
2
+ export interface McpProviderConfig {
3
3
  readonly provider: McpTokenProvider;
4
4
  readonly credentialKey: string;
5
5
  readonly label: string;
6
6
  readonly description: string;
7
7
  readonly tokenHelpUrl: string;
8
8
  readonly guide?: ReadonlyArray<string> | undefined;
9
- };
9
+ }
10
10
  export declare const MCP_TOKEN_PROVIDERS: ReadonlyArray<McpProviderConfig>;
11
11
  export declare function isMcpTokenProvider(value: unknown): value is McpTokenProvider;
12
12
  export declare function resolveMcpProvider(provider: McpTokenProvider): McpProviderConfig;
@@ -6,7 +6,7 @@ export declare const SETUP_ROUTE_KIND: {
6
6
  readonly picker: 'picker';
7
7
  readonly instructions: 'instructions';
8
8
  };
9
- export type DeriveSetupOptions = {
9
+ export interface DeriveSetupOptions {
10
10
  readonly sandboxed?: boolean;
11
- };
11
+ }
12
12
  export declare function deriveSetupRoutes(entry: SkillEntry, options?: DeriveSetupOptions): SkillSetup;
@@ -1,7 +1,8 @@
1
1
  import type { AbortSignal } from 'bare-abort-controller';
2
2
  import type { ScopedCapabilities } from './mesh-scoped-engine.ts';
3
- import type { AssistantRagSearchRequest } from '../spec/hyperschema/types.d.ts';
4
- export declare function searchKnowledge(engine: Pick<ScopedCapabilities, 'ragSearch' | 'fileStatusWatch'>, request: Omit<AssistantRagSearchRequest, 'meshId'>, options: {
5
- signal: AbortSignal;
6
- preparing: (active: boolean) => void;
7
- }): Promise<import("../spec/index").AssistantRagSearchResponse>;
3
+ import type { AssistantRagSearchRequest, AssistantRagSearchResponse } from '../spec/hyperschema/types.d.ts';
4
+ export interface SearchKnowledgeOptions {
5
+ readonly signal: AbortSignal;
6
+ readonly preparing: (active: boolean) => void;
7
+ }
8
+ export declare function searchKnowledge(engine: Pick<ScopedCapabilities, 'ragSearch' | 'fileStatusWatch'>, request: Omit<AssistantRagSearchRequest, 'meshId'>, options: SearchKnowledgeOptions): Promise<AssistantRagSearchResponse>;
@@ -3,8 +3,9 @@ import { raceAbort } from '@qvac/harness/race-abort';
3
3
  export async function searchKnowledge(engine, request, options) {
4
4
  const { signal, preparing } = options;
5
5
  const search = await raceAbort(engine.ragSearch(request), signal);
6
- if (!search.enabled || !search.hasKnowledge || !search.pendingFiles?.length)
6
+ if (!search.enabled || !search.hasKnowledge || !search.pendingFiles?.length) {
7
7
  return search;
8
+ }
8
9
  const watch = engine.fileStatusWatch({ chatId: request.chatId });
9
10
  const iterator = watch[Symbol.asyncIterator]();
10
11
  let wanted = null;
@@ -12,25 +13,15 @@ export async function searchKnowledge(engine, request, options) {
12
13
  try {
13
14
  while (true) {
14
15
  const next = await raceAbort(iterator.next(), signal);
15
- if (next.done)
16
+ if (next.done) {
16
17
  throw new Error('file status closed while preparing documents');
18
+ }
17
19
  const files = next.value.files;
18
- if (!wanted) {
19
- const named = referencedDocuments(request.query, files.map((file) => ({ ...file, title: file.fileName })));
20
- const requested = request.attachmentIds?.length
21
- ? files.filter((file) => request.attachmentIds.includes(file.fileId))
22
- : named.length
23
- ? named
24
- : isWholeDocumentQuery(request.query)
25
- ? files
26
- : [];
27
- wanted = new Set(requested
28
- .filter((file) => search.pendingFiles.includes(file.fileName))
29
- .map((file) => file.fileId));
30
- if (wanted.size === 0)
31
- return search;
20
+ const ids = (wanted ??= wantedFileIds(request, { files, pendingFiles: search.pendingFiles }));
21
+ if (ids.size === 0) {
22
+ return search;
32
23
  }
33
- if (!files.some((file) => wanted.has(file.fileId) && pending(file))) {
24
+ if (!files.some((file) => ids.has(file.fileId) && pending(file))) {
34
25
  return await raceAbort(engine.ragSearch(request), signal);
35
26
  }
36
27
  if (!waiting) {
@@ -41,8 +32,9 @@ export async function searchKnowledge(engine, request, options) {
41
32
  }
42
33
  finally {
43
34
  watch.destroy();
44
- if (waiting)
35
+ if (waiting) {
45
36
  preparing(false);
37
+ }
46
38
  }
47
39
  }
48
40
  function pending(file) {
@@ -51,3 +43,19 @@ function pending(file) {
51
43
  ['pending', 'running', 'uploading'].includes(file.state) &&
52
44
  rag?.state !== 'not-applicable');
53
45
  }
46
+ function wantedFileIds(request, { files, pendingFiles }) {
47
+ const named = referencedDocuments(request.query, files.map((file) => ({ ...file, title: file.fileName })));
48
+ const requested = requestedFiles(request, { files, named });
49
+ return new Set(requested.filter((file) => pendingFiles.includes(file.fileName)).map((file) => file.fileId));
50
+ }
51
+ function requestedFiles(request, opts) {
52
+ const { files, named } = opts;
53
+ const { attachmentIds } = request;
54
+ if (attachmentIds?.length) {
55
+ return files.filter((file) => attachmentIds.includes(file.fileId));
56
+ }
57
+ if (named.length) {
58
+ return named;
59
+ }
60
+ return isWholeDocumentQuery(request.query) ? files : [];
61
+ }
@@ -8,9 +8,11 @@ export function chatRepairKvCacheKey(chatId, acceptedRepairs) {
8
8
  export function disappearedChatIds(known, current) {
9
9
  const live = new Set(current);
10
10
  const gone = [];
11
- for (const id of known)
12
- if (!live.has(id))
11
+ for (const id of known) {
12
+ if (!live.has(id)) {
13
13
  gone.push(id);
14
+ }
15
+ }
14
16
  return gone;
15
17
  }
16
18
  export function agentRekeyFingerprint(agent) {
@@ -1,3 +1,4 @@
1
+ import { errorMessage } from './guards.js';
1
2
  export async function clearKvCache(client) {
2
3
  const clear = client.clearKvCache?.bind(client);
3
4
  return deleteWhenSupported(client, clear);
@@ -7,15 +8,18 @@ export async function deleteChatKvCache(client, chatId) {
7
8
  return deleteWhenSupported(client, remove && (() => remove({ chatId })));
8
9
  }
9
10
  async function deleteWhenSupported(client, deletion) {
10
- if (!client.deviceInfo || !deletion)
11
+ if (!client.deviceInfo || !deletion) {
11
12
  return unsupported();
13
+ }
12
14
  try {
13
15
  const info = await client.deviceInfo();
14
- if (info.supportsKvCacheDeletion !== true)
16
+ if (info.supportsKvCacheDeletion !== true) {
15
17
  return unsupported();
18
+ }
16
19
  const response = await deletion();
17
- if (response.status === 'success')
20
+ if (response.status === 'success') {
18
21
  return { status: 'success' };
22
+ }
19
23
  if (response.status === 'failure') {
20
24
  return { status: 'failure', error: response.error ?? 'Core KV cache deletion failed' };
21
25
  }
@@ -24,7 +28,7 @@ async function deleteWhenSupported(client, deletion) {
24
28
  catch (error) {
25
29
  return {
26
30
  status: 'failure',
27
- error: error instanceof Error ? error.message : String(error)
31
+ error: errorMessage(error)
28
32
  };
29
33
  }
30
34
  }
@@ -1,5 +1,5 @@
1
1
  import type { ImageModelChoice } from '@qvac/harness/model-catalog';
2
- export type Attachment = {
2
+ export interface Attachment {
3
3
  readonly id: string;
4
4
  readonly messageId: string;
5
5
  readonly fileName: string;
@@ -7,43 +7,43 @@ export type Attachment = {
7
7
  readonly byteLength: number;
8
8
  readonly blobId: string;
9
9
  readonly createdAt: number;
10
- };
11
- export type DelegationCapabilities = {
10
+ }
11
+ export interface DelegationCapabilities {
12
12
  chat: boolean;
13
13
  transcription: boolean;
14
14
  tts: boolean;
15
15
  embeddings: boolean;
16
16
  knowledge: boolean;
17
- };
18
- export type DelegationConfig = {
17
+ }
18
+ export interface DelegationConfig {
19
19
  enabled: boolean;
20
20
  targetDeviceId: string | null;
21
21
  targetAgentId: string | null;
22
22
  capabilities: DelegationCapabilities;
23
- };
23
+ }
24
24
  export type JsonPrimitive = string | number | boolean | null;
25
25
  export type JsonValue = JsonPrimitive | JsonObject | ReadonlyArray<JsonValue>;
26
- export type JsonObject = {
26
+ export interface JsonObject {
27
27
  readonly [key: string]: JsonValue;
28
- };
29
- export type ToolCallData = {
28
+ }
29
+ export interface ToolCallData {
30
30
  readonly id: string;
31
31
  readonly name: string;
32
32
  readonly arguments: JsonObject;
33
- };
34
- export type ToolCallErrorData = {
33
+ }
34
+ export interface ToolCallErrorData {
35
35
  readonly code: string;
36
36
  readonly message: string;
37
- };
38
- export type InferenceMetrics = {
37
+ }
38
+ export interface InferenceMetrics {
39
39
  readonly ttft: number;
40
40
  readonly tps: number;
41
41
  readonly totalTokens: number;
42
42
  readonly durationMs: number;
43
43
  readonly promptTokens: number | null;
44
44
  readonly cacheTokens: number | null;
45
- };
46
- export type RagSourceData = {
45
+ }
46
+ export interface RagSourceData {
47
47
  readonly label: string;
48
48
  readonly fileName: string;
49
49
  readonly chunkIndex: number;
@@ -52,15 +52,15 @@ export type RagSourceData = {
52
52
  readonly artifactId: string | null;
53
53
  readonly documentId: string | null;
54
54
  readonly score: number;
55
- };
56
- export type ToolApprovalRequest = {
55
+ }
56
+ export interface ToolApprovalRequest {
57
57
  readonly id: string;
58
58
  readonly toolCallId?: string | undefined;
59
59
  readonly runId?: string | null | undefined;
60
60
  readonly toolName: string;
61
61
  readonly action?: string | undefined;
62
62
  readonly args: JsonObject;
63
- };
63
+ }
64
64
  export type StreamEvent = {
65
65
  readonly type: 'thinking';
66
66
  readonly token: string;
@@ -163,32 +163,32 @@ export type StreamEvent = {
163
163
  readonly resultCount: number;
164
164
  }>;
165
165
  };
166
- export type LocalStreamEvent = {
166
+ export interface LocalStreamEvent {
167
167
  readonly runId: string;
168
168
  readonly chatId: string;
169
169
  readonly event: StreamEvent;
170
- };
171
- export type RemoteStreamEvent = {
170
+ }
171
+ export interface RemoteStreamEvent {
172
172
  readonly taskId: string;
173
173
  readonly chatId: string;
174
174
  readonly event: StreamEvent | {
175
175
  readonly type: 'done';
176
176
  };
177
177
  readonly targetDeviceId?: string | undefined;
178
- };
179
- export type NetworkAddress = {
178
+ }
179
+ export interface NetworkAddress {
180
180
  readonly host: string;
181
181
  readonly port: number;
182
- };
183
- export type DhtConnectionStat = {
182
+ }
183
+ export interface DhtConnectionStat {
184
184
  readonly host: string | null;
185
185
  readonly port: number | null;
186
186
  readonly online: boolean | null;
187
187
  readonly degraded: boolean | null;
188
188
  readonly connections: number;
189
189
  readonly peers: ReadonlyArray<string>;
190
- };
191
- export type DhtHealthStat = {
190
+ }
191
+ export interface DhtHealthStat {
192
192
  readonly online: boolean;
193
193
  readonly degraded: boolean;
194
194
  readonly cold: boolean;
@@ -196,16 +196,16 @@ export type DhtHealthStat = {
196
196
  readonly responses: number;
197
197
  readonly timeouts: number;
198
198
  readonly timeoutsRate: number;
199
- };
200
- export type DhtConfigStat = {
199
+ }
200
+ export interface DhtConfigStat {
201
201
  readonly concurrency: number;
202
202
  readonly maxWindow: number;
203
203
  readonly randomPunchInterval: number;
204
204
  readonly connectionKeepAlive: number;
205
205
  readonly sendDownHints: boolean;
206
206
  readonly downHintsRateLimit: number;
207
- };
208
- export type NetworkStat = {
207
+ }
208
+ export interface NetworkStat {
209
209
  readonly tick: number;
210
210
  readonly localAddress: NetworkAddress | null;
211
211
  readonly remoteAddress: NetworkAddress | null;
@@ -214,8 +214,8 @@ export type NetworkStat = {
214
214
  readonly health: DhtHealthStat;
215
215
  readonly nodes: number;
216
216
  readonly config: DhtConfigStat;
217
- };
218
- export type ProcessMemoryStat = {
217
+ }
218
+ export interface ProcessMemoryStat {
219
219
  readonly percent: number;
220
220
  readonly rss: number;
221
221
  readonly total: number;
@@ -223,8 +223,8 @@ export type ProcessMemoryStat = {
223
223
  readonly heapUsed: number;
224
224
  readonly heapTotal: number;
225
225
  readonly external: number;
226
- };
227
- export type ProcessStat = {
226
+ }
227
+ export interface ProcessStat {
228
228
  readonly timestamp: string;
229
229
  readonly cpu: number;
230
230
  readonly cpuThread: number;
@@ -232,8 +232,8 @@ export type ProcessStat = {
232
232
  readonly memory: ProcessMemoryStat;
233
233
  readonly delay: number;
234
234
  readonly runtime: number;
235
- };
236
- export type MeshStat = {
235
+ }
236
+ export interface MeshStat {
237
237
  readonly head: {
238
238
  readonly key: string;
239
239
  readonly length: number;
@@ -244,15 +244,15 @@ export type MeshStat = {
244
244
  };
245
245
  readonly flushes?: number;
246
246
  readonly writable: boolean;
247
- };
248
- export type MemoryBudgetStat = {
247
+ }
248
+ export interface MemoryBudgetStat {
249
249
  readonly totalBytes: number;
250
250
  readonly availableBytes: number;
251
251
  readonly source: string;
252
- };
252
+ }
253
253
  export type ModelEvictionPolicyId = 'single-active' | 'lru' | 'keep-during-turn';
254
- export type ModelLifecycleConfig = {
254
+ export interface ModelLifecycleConfig {
255
255
  readonly policy: ModelEvictionPolicyId;
256
256
  readonly cap: number;
257
257
  readonly unloadTimeoutMs?: number;
258
- };
258
+ }
@@ -7,8 +7,9 @@ export class LogBuffer {
7
7
  }
8
8
  push(item) {
9
9
  this._items.push(item);
10
- if (this._items.length > this._cap)
10
+ if (this._items.length > this._cap) {
11
11
  this._items.shift();
12
+ }
12
13
  }
13
14
  snapshot() {
14
15
  return [...this._items];
@@ -34,8 +34,9 @@ export class Logger {
34
34
  this._verbose = verbose;
35
35
  this._level = LEVELS[logLevel] ?? LEVELS.info;
36
36
  this._system = new SystemLog();
37
- if (logFile)
37
+ if (logFile) {
38
38
  fs.mkdirSync(dirname(logFile), { recursive: true });
39
+ }
39
40
  this._file = logFile
40
41
  ? new FileLog(logFile, {
41
42
  maxSize: logFileMaxSize || 100_000_000,
@@ -102,14 +103,16 @@ export class Logger {
102
103
  const rendered = renderRecord(record);
103
104
  if (this._verbose || (this._dev && this._level === LEVELS.debug)) {
104
105
  const log = console[record.level] || console.log;
105
- log(...rendered);
106
+ log(record.level.padEnd(5), ...rendered);
106
107
  }
107
108
  this._system[record.level](...rendered);
108
- if (this._file)
109
+ if (this._file) {
109
110
  this._file[record.level](...rendered);
111
+ }
110
112
  this._buffer.push(record);
111
- for (const listener of this._subscribers)
113
+ for (const listener of this._subscribers) {
112
114
  listener(record);
115
+ }
113
116
  }
114
117
  }
115
118
  function renderRecord(record) {
@@ -121,24 +124,31 @@ function renderRecord(record) {
121
124
  }
122
125
  function toParts(args) {
123
126
  const [rawScope, rawMessage, ...rest] = args;
124
- const scope = typeof rawScope === 'string'
125
- ? [rawScope]
126
- : Array.isArray(rawScope) && rawScope.every((s) => typeof s === 'string')
127
- ? [...rawScope]
128
- : [];
129
- const head = typeof rawMessage === 'string'
130
- ? rawMessage
131
- : rawMessage === undefined
132
- ? ''
133
- : formatArg(rawMessage);
127
+ const scope = scopeOf(rawScope);
128
+ const head = headOf(rawMessage);
134
129
  const tail = rest.map(formatArg).join(' ');
135
130
  return { scope, message: tail ? `${head} ${tail}`.trim() : head };
136
131
  }
132
+ function scopeOf(rawScope) {
133
+ if (typeof rawScope === 'string') {
134
+ return [rawScope];
135
+ }
136
+ if (Array.isArray(rawScope) && rawScope.every((s) => typeof s === 'string')) {
137
+ return [...rawScope];
138
+ }
139
+ return [];
140
+ }
141
+ function headOf(rawMessage) {
142
+ if (typeof rawMessage === 'string')
143
+ return rawMessage;
144
+ return rawMessage === undefined ? '' : formatArg(rawMessage);
145
+ }
137
146
  function formatArg(value) {
138
147
  if (typeof value === 'string')
139
148
  return value;
140
- if (value instanceof Error)
149
+ if (value instanceof Error) {
141
150
  return value.stack ?? value.message;
151
+ }
142
152
  try {
143
153
  return JSON.stringify(value) ?? String(value);
144
154
  }