@qvac/core 0.5.0 → 0.6.1

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 (399) hide show
  1. package/CHANGELOG.md +92 -1
  2. package/dist-lib/lib/api/agents.js +3 -2
  3. package/dist-lib/lib/api/app-config.d.ts +1 -1
  4. package/dist-lib/lib/api/app-config.js +54 -15
  5. package/dist-lib/lib/api/attachments.d.ts +6 -5
  6. package/dist-lib/lib/api/attachments.js +4 -2
  7. package/dist-lib/lib/api/chat.d.ts +7 -3
  8. package/dist-lib/lib/api/chat.js +4 -4
  9. package/dist-lib/lib/api/chunks.js +3 -3
  10. package/dist-lib/lib/api/config.js +2 -2
  11. package/dist-lib/lib/api/current-mesh.d.ts +3 -4
  12. package/dist-lib/lib/api/current-mesh.js +9 -4
  13. package/dist-lib/lib/api/custom-models.d.ts +8 -1
  14. package/dist-lib/lib/api/custom-models.js +53 -16
  15. package/dist-lib/lib/api/devices.d.ts +14 -5
  16. package/dist-lib/lib/api/devices.js +13 -8
  17. package/dist-lib/lib/api/diagnostics.d.ts +1 -0
  18. package/dist-lib/lib/api/diagnostics.js +1 -1
  19. package/dist-lib/lib/api/effective-ctx-size.d.ts +6 -1
  20. package/dist-lib/lib/api/effective-ctx-size.js +5 -3
  21. package/dist-lib/lib/api/execution.js +2 -1
  22. package/dist-lib/lib/api/files.js +2 -1
  23. package/dist-lib/lib/api/index.d.ts +5 -1
  24. package/dist-lib/lib/api/index.js +101 -102
  25. package/dist-lib/lib/api/instrument.js +29 -20
  26. package/dist-lib/lib/api/knowledge.d.ts +6 -5
  27. package/dist-lib/lib/api/knowledge.js +8 -6
  28. package/dist-lib/lib/api/local-files.js +1 -1
  29. package/dist-lib/lib/api/logs.js +6 -3
  30. package/dist-lib/lib/api/members.js +22 -13
  31. package/dist-lib/lib/api/mesh.js +3 -3
  32. package/dist-lib/lib/api/model-download.js +1 -1
  33. package/dist-lib/lib/api/network.d.ts +1 -0
  34. package/dist-lib/lib/api/network.js +1 -1
  35. package/dist-lib/lib/api/notifications.js +23 -13
  36. package/dist-lib/lib/api/rag.d.ts +6 -1
  37. package/dist-lib/lib/api/rag.js +20 -11
  38. package/dist-lib/lib/api/range.d.ts +2 -2
  39. package/dist-lib/lib/api/sync.js +1 -1
  40. package/dist-lib/lib/api/tool-activity.js +7 -3
  41. package/dist-lib/lib/api/tool-configs.js +2 -4
  42. package/dist-lib/lib/api/upload-frames.d.ts +7 -8
  43. package/dist-lib/lib/api/upload-frames.js +2 -1
  44. package/dist-lib/lib/api/watchable.d.ts +6 -1
  45. package/dist-lib/lib/api/watchable.js +23 -14
  46. package/dist-lib/lib/assistant/fetch-body.js +4 -2
  47. package/dist-lib/lib/assistant/harness.d.ts +48 -27
  48. package/dist-lib/lib/assistant/harness.js +40 -16
  49. package/dist-lib/lib/assistant/history.d.ts +9 -7
  50. package/dist-lib/lib/assistant/history.js +77 -42
  51. package/dist-lib/lib/assistant/message.d.ts +5 -3
  52. package/dist-lib/lib/assistant/message.js +4 -2
  53. package/dist-lib/lib/assistant/skill-encode.d.ts +3 -1
  54. package/dist-lib/lib/assistant/skill-encode.js +52 -62
  55. package/dist-lib/lib/assistant-client.js +7 -4
  56. package/dist-lib/lib/assistant-tree.js +27 -11
  57. package/dist-lib/lib/assistant.d.ts +31 -11
  58. package/dist-lib/lib/assistant.js +846 -390
  59. package/dist-lib/lib/audio-format.d.ts +1 -1
  60. package/dist-lib/lib/audio-format.js +1 -1
  61. package/dist-lib/lib/chat-title.js +9 -4
  62. package/dist-lib/lib/client.js +3 -2
  63. package/dist-lib/lib/collabora/convert.d.ts +2 -2
  64. package/dist-lib/lib/collabora/convert.js +6 -3
  65. package/dist-lib/lib/collabora/entry.js +9 -5
  66. package/dist-lib/lib/collabora/protocol.d.ts +2 -2
  67. package/dist-lib/lib/collabora/protocol.js +14 -7
  68. package/dist-lib/lib/collabora/worker.js +14 -7
  69. package/dist-lib/lib/compaction.d.ts +5 -6
  70. package/dist-lib/lib/compaction.js +14 -7
  71. package/dist-lib/lib/core/account-recovery.d.ts +4 -3
  72. package/dist-lib/lib/core/account-recovery.js +7 -4
  73. package/dist-lib/lib/core/agent.js +17 -15
  74. package/dist-lib/lib/core/approval-rules.d.ts +7 -6
  75. package/dist-lib/lib/core/approval-rules.js +12 -6
  76. package/dist-lib/lib/core/archived-mesh.d.ts +7 -5
  77. package/dist-lib/lib/core/archived-mesh.js +25 -22
  78. package/dist-lib/lib/core/async-iterable.js +10 -5
  79. package/dist-lib/lib/core/attachment-link.d.ts +2 -2
  80. package/dist-lib/lib/core/audio-attachment.js +1 -1
  81. package/dist-lib/lib/core/blind-peers.d.ts +2 -2
  82. package/dist-lib/lib/core/chat-activity.d.ts +2 -2
  83. package/dist-lib/lib/core/chat-activity.js +42 -21
  84. package/dist-lib/lib/core/chat-group.d.ts +8 -6
  85. package/dist-lib/lib/core/chat-group.js +17 -10
  86. package/dist-lib/lib/core/chat-order.d.ts +11 -9
  87. package/dist-lib/lib/core/chat-order.js +1 -3
  88. package/dist-lib/lib/core/chat-search.d.ts +4 -4
  89. package/dist-lib/lib/core/chat-search.js +38 -24
  90. package/dist-lib/lib/core/chat.d.ts +20 -14
  91. package/dist-lib/lib/core/chat.js +50 -31
  92. package/dist-lib/lib/core/chunk.d.ts +19 -23
  93. package/dist-lib/lib/core/chunk.js +27 -21
  94. package/dist-lib/lib/core/collections.d.ts +70 -0
  95. package/dist-lib/lib/core/collections.js +70 -0
  96. package/dist-lib/lib/core/contract/activity.d.ts +6 -2
  97. package/dist-lib/lib/core/contract/activity.js +15 -12
  98. package/dist-lib/lib/core/contract/agents.js +3 -2
  99. package/dist-lib/lib/core/contract/approval-rules.js +1 -1
  100. package/dist-lib/lib/core/contract/attestations.js +1 -1
  101. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  102. package/dist-lib/lib/core/contract/chat.d.ts +2 -0
  103. package/dist-lib/lib/core/contract/chat.js +67 -1
  104. package/dist-lib/lib/core/contract/chunks.js +15 -9
  105. package/dist-lib/lib/core/contract/compute.d.ts +1 -1
  106. package/dist-lib/lib/core/contract/compute.js +4 -2
  107. package/dist-lib/lib/core/contract/devices.js +6 -5
  108. package/dist-lib/lib/core/contract/grant-order.js +5 -6
  109. package/dist-lib/lib/core/contract/index.js +4 -2
  110. package/dist-lib/lib/core/contract/indexing.js +3 -3
  111. package/dist-lib/lib/core/contract/invites.d.ts +8 -3
  112. package/dist-lib/lib/core/contract/invites.js +52 -26
  113. package/dist-lib/lib/core/contract/joined-meshes.js +3 -3
  114. package/dist-lib/lib/core/contract/knowledge.js +5 -5
  115. package/dist-lib/lib/core/contract/members.d.ts +13 -2
  116. package/dist-lib/lib/core/contract/members.js +46 -25
  117. package/dist-lib/lib/core/contract/mesh-kind.js +9 -8
  118. package/dist-lib/lib/core/contract/seal.js +1 -1
  119. package/dist-lib/lib/core/contract/seed-defaults.js +1 -3
  120. package/dist-lib/lib/core/contract/tool-activity.js +10 -5
  121. package/dist-lib/lib/core/contract/tool-configs.js +1 -2
  122. package/dist-lib/lib/core/contract/writers.d.ts +6 -1
  123. package/dist-lib/lib/core/contract/writers.js +55 -34
  124. package/dist-lib/lib/core/departures.js +16 -8
  125. package/dist-lib/lib/core/device-invites.js +3 -2
  126. package/dist-lib/lib/core/devices.js +6 -3
  127. package/dist-lib/lib/core/document-attachment.d.ts +20 -11
  128. package/dist-lib/lib/core/document-attachment.js +10 -5
  129. package/dist-lib/lib/core/files/attachments.d.ts +2 -5
  130. package/dist-lib/lib/core/files/attachments.js +6 -3
  131. package/dist-lib/lib/core/files/index.d.ts +46 -52
  132. package/dist-lib/lib/core/files/index.js +149 -94
  133. package/dist-lib/lib/core/files/knowledge.d.ts +2 -5
  134. package/dist-lib/lib/core/files/local-index.d.ts +4 -1
  135. package/dist-lib/lib/core/files/local-index.js +9 -5
  136. package/dist-lib/lib/core/files/preview/image.d.ts +0 -1
  137. package/dist-lib/lib/core/files/preview/image.js +9 -6
  138. package/dist-lib/lib/core/files/preview/index.d.ts +8 -11
  139. package/dist-lib/lib/core/files/preview/index.js +20 -15
  140. package/dist-lib/lib/core/files/processing/claims.d.ts +6 -5
  141. package/dist-lib/lib/core/files/processing/claims.js +16 -8
  142. package/dist-lib/lib/core/files/processing/document.d.ts +21 -50
  143. package/dist-lib/lib/core/files/processing/index.d.ts +21 -13
  144. package/dist-lib/lib/core/files/processing/index.js +74 -37
  145. package/dist-lib/lib/core/files/processing/ownership.d.ts +8 -1
  146. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  147. package/dist-lib/lib/core/files/processing/protocol.d.ts +19 -19
  148. package/dist-lib/lib/core/files/processing/protocol.js +5 -5
  149. package/dist-lib/lib/core/files/processing/settle.d.ts +10 -7
  150. package/dist-lib/lib/core/files/processing/settle.js +22 -11
  151. package/dist-lib/lib/core/files/processing/source.js +14 -8
  152. package/dist-lib/lib/core/files/processing/state.d.ts +14 -11
  153. package/dist-lib/lib/core/files/processing/state.js +24 -12
  154. package/dist-lib/lib/core/files/rag/build.d.ts +2 -2
  155. package/dist-lib/lib/core/files/rag/build.js +2 -1
  156. package/dist-lib/lib/core/files/rag/document-types.d.ts +4 -6
  157. package/dist-lib/lib/core/files/rag/index.d.ts +12 -13
  158. package/dist-lib/lib/core/files/rag/index.js +9 -2
  159. package/dist-lib/lib/core/files/rag/load.d.ts +10 -9
  160. package/dist-lib/lib/core/files/rag/load.js +26 -13
  161. package/dist-lib/lib/core/files/rag/policy.js +2 -1
  162. package/dist-lib/lib/core/files/rag/produce.js +33 -19
  163. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +5 -3
  164. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +30 -10
  165. package/dist-lib/lib/core/files/records/chunks.js +4 -2
  166. package/dist-lib/lib/core/files/records/index.d.ts +1 -0
  167. package/dist-lib/lib/core/files/records/index.js +1 -0
  168. package/dist-lib/lib/core/files/records/knowledge.d.ts +10 -11
  169. package/dist-lib/lib/core/files/records/knowledge.js +9 -8
  170. package/dist-lib/lib/core/files/records/linkage.js +6 -3
  171. package/dist-lib/lib/core/files/records/output.d.ts +5 -4
  172. package/dist-lib/lib/core/files/records/output.js +8 -4
  173. package/dist-lib/lib/core/files/records/purge.d.ts +4 -0
  174. package/dist-lib/lib/core/files/records/purge.js +108 -0
  175. package/dist-lib/lib/core/files/records/reclaim.js +43 -25
  176. package/dist-lib/lib/core/files/records/routing.d.ts +4 -6
  177. package/dist-lib/lib/core/files/records/routing.js +15 -8
  178. package/dist-lib/lib/core/files/records/source.d.ts +5 -4
  179. package/dist-lib/lib/core/files/records/source.js +20 -14
  180. package/dist-lib/lib/core/files/records/sweep.js +1 -3
  181. package/dist-lib/lib/core/files/store/blob.d.ts +11 -10
  182. package/dist-lib/lib/core/files/store/blob.js +54 -19
  183. package/dist-lib/lib/core/files/store/index.d.ts +2 -6
  184. package/dist-lib/lib/core/files/store/index.js +10 -5
  185. package/dist-lib/lib/core/files/store/inline.d.ts +2 -2
  186. package/dist-lib/lib/core/files/store/inline.js +6 -3
  187. package/dist-lib/lib/core/files/store/reference.d.ts +6 -9
  188. package/dist-lib/lib/core/files/store/reference.js +25 -17
  189. package/dist-lib/lib/core/files/store/server.d.ts +7 -6
  190. package/dist-lib/lib/core/files/store/server.js +22 -11
  191. package/dist-lib/lib/core/files/store/sweep.js +13 -7
  192. package/dist-lib/lib/core/files/upload-input.d.ts +4 -12
  193. package/dist-lib/lib/core/files/upload-input.js +10 -5
  194. package/dist-lib/lib/core/files/upload.d.ts +27 -24
  195. package/dist-lib/lib/core/files/upload.js +74 -51
  196. package/dist-lib/lib/core/fs-drives.js +4 -2
  197. package/dist-lib/lib/core/grant-expiry.js +12 -7
  198. package/dist-lib/lib/core/handoff-channel.js +27 -13
  199. package/dist-lib/lib/core/harness-loan.js +35 -17
  200. package/dist-lib/lib/core/helpers/index.js +6 -2
  201. package/dist-lib/lib/core/hosted-agents.js +19 -12
  202. package/dist-lib/lib/core/id.js +1 -1
  203. package/dist-lib/lib/core/identity.js +6 -3
  204. package/dist-lib/lib/core/image/cache-sweep.d.ts +12 -10
  205. package/dist-lib/lib/core/image/cache-sweep.js +11 -6
  206. package/dist-lib/lib/core/image/normalize.d.ts +6 -0
  207. package/dist-lib/lib/core/image/normalize.js +12 -2
  208. package/dist-lib/lib/core/image/sniff.js +42 -21
  209. package/dist-lib/lib/core/inference-calls-receiver.js +7 -4
  210. package/dist-lib/lib/core/invite-grants.js +4 -2
  211. package/dist-lib/lib/core/invite.js +2 -1
  212. package/dist-lib/lib/core/local/files.d.ts +2 -0
  213. package/dist-lib/lib/core/local/files.js +51 -19
  214. package/dist-lib/lib/core/local/index.d.ts +69 -46
  215. package/dist-lib/lib/core/local/index.js +146 -129
  216. package/dist-lib/lib/core/membership.d.ts +12 -2
  217. package/dist-lib/lib/core/membership.js +55 -33
  218. package/dist-lib/lib/core/mesh-seed-handoff.js +7 -1
  219. package/dist-lib/lib/core/mesh.d.ts +37 -27
  220. package/dist-lib/lib/core/mesh.js +131 -73
  221. package/dist-lib/lib/core/migrations/agent-catalog.js +3 -2
  222. package/dist-lib/lib/core/migrations/agent-indexes.js +3 -3
  223. package/dist-lib/lib/core/migrations/file-index.js +7 -4
  224. package/dist-lib/lib/core/migrations/index.d.ts +4 -3
  225. package/dist-lib/lib/core/migrations/membership.js +9 -4
  226. package/dist-lib/lib/core/migrations/seal.js +3 -2
  227. package/dist-lib/lib/core/min-version.js +4 -2
  228. package/dist-lib/lib/core/next-frame.d.ts +5 -4
  229. package/dist-lib/lib/core/next-frame.js +6 -3
  230. package/dist-lib/lib/core/notification.d.ts +5 -1
  231. package/dist-lib/lib/core/notification.js +89 -77
  232. package/dist-lib/lib/core/ota-config.js +2 -1
  233. package/dist-lib/lib/core/pdf/rasterize.d.ts +18 -0
  234. package/dist-lib/lib/core/pdf/rasterize.js +57 -0
  235. package/dist-lib/lib/core/prompt-history.js +4 -2
  236. package/dist-lib/lib/core/range.d.ts +4 -4
  237. package/dist-lib/lib/core/range.js +12 -6
  238. package/dist-lib/lib/core/rank.d.ts +5 -4
  239. package/dist-lib/lib/core/rank.js +2 -1
  240. package/dist-lib/lib/core/send.d.ts +4 -4
  241. package/dist-lib/lib/core/send.js +6 -3
  242. package/dist-lib/lib/core/skill-overlay-receiver.js +7 -4
  243. package/dist-lib/lib/core/skill-secrets.js +16 -9
  244. package/dist-lib/lib/core/sync/chunks.js +2 -1
  245. package/dist-lib/lib/core/sync/devices.js +3 -1
  246. package/dist-lib/lib/core/sync/files.d.ts +2 -4
  247. package/dist-lib/lib/core/sync/files.js +28 -20
  248. package/dist-lib/lib/core/sync/index.d.ts +2 -5
  249. package/dist-lib/lib/core/sync/index.js +33 -15
  250. package/dist-lib/lib/core/sync-status.js +10 -7
  251. package/dist-lib/lib/core/system-info.js +4 -2
  252. package/dist-lib/lib/core/tool-activity.d.ts +4 -3
  253. package/dist-lib/lib/core/tool-activity.js +1 -1
  254. package/dist-lib/lib/core/tool-configs.js +12 -7
  255. package/dist-lib/lib/core.d.ts +38 -26
  256. package/dist-lib/lib/core.js +1009 -541
  257. package/dist-lib/lib/credential-pusher.d.ts +20 -20
  258. package/dist-lib/lib/credential-pusher.js +65 -43
  259. package/dist-lib/lib/custom-model-pusher.d.ts +7 -3
  260. package/dist-lib/lib/custom-model-pusher.js +15 -7
  261. package/dist-lib/lib/custom-model-task.d.ts +1 -0
  262. package/dist-lib/lib/custom-model-task.js +12 -0
  263. package/dist-lib/lib/deadline.js +4 -2
  264. package/dist-lib/lib/diagnostics.d.ts +1 -5
  265. package/dist-lib/lib/frame-readable.d.ts +3 -0
  266. package/dist-lib/lib/frame-readable.js +3 -0
  267. package/dist-lib/lib/fs-drive-bridge.js +24 -14
  268. package/dist-lib/lib/fs-grants.js +13 -8
  269. package/dist-lib/lib/guards.d.ts +3 -0
  270. package/dist-lib/lib/guards.js +9 -0
  271. package/dist-lib/lib/inference-calls.d.ts +28 -23
  272. package/dist-lib/lib/inference-calls.js +25 -13
  273. package/dist-lib/lib/integrations/mcp-providers.d.ts +2 -2
  274. package/dist-lib/lib/integrations/setup-routes.d.ts +2 -2
  275. package/dist-lib/lib/knowledge-search.d.ts +6 -5
  276. package/dist-lib/lib/knowledge-search.js +26 -18
  277. package/dist-lib/lib/kv-cache-reclaim.js +4 -2
  278. package/dist-lib/lib/kv-cache.js +8 -4
  279. package/dist-lib/lib/legacy-core-domain.d.ts +42 -42
  280. package/dist-lib/lib/log-buffer.js +2 -1
  281. package/dist-lib/lib/log.js +25 -15
  282. package/dist-lib/lib/mesh-scoped-engine.js +12 -4
  283. package/dist-lib/lib/model-catalog-revision.js +6 -3
  284. package/dist-lib/lib/model-clamp.js +6 -3
  285. package/dist-lib/lib/model-context.d.ts +8 -3
  286. package/dist-lib/lib/model-context.js +13 -5
  287. package/dist-lib/lib/model-download-status.js +4 -2
  288. package/dist-lib/lib/model-download.d.ts +12 -4
  289. package/dist-lib/lib/model-download.js +200 -103
  290. package/dist-lib/lib/model-idle-pusher.d.ts +2 -2
  291. package/dist-lib/lib/model-idle-pusher.js +3 -4
  292. package/dist-lib/lib/oauth/browser-connect.d.ts +10 -8
  293. package/dist-lib/lib/oauth/browser-connect.js +33 -20
  294. package/dist-lib/lib/oauth/client.d.ts +2 -2
  295. package/dist-lib/lib/oauth/flow-core.js +23 -9
  296. package/dist-lib/lib/oauth/flow.d.ts +1 -3
  297. package/dist-lib/lib/oauth/flow.js +9 -5
  298. package/dist-lib/lib/oauth/keys.d.ts +4 -4
  299. package/dist-lib/lib/oauth/keys.js +18 -12
  300. package/dist-lib/lib/oauth/loopback.d.ts +2 -2
  301. package/dist-lib/lib/oauth/loopback.js +147 -107
  302. package/dist-lib/lib/oauth/loopback.stub.d.ts +2 -2
  303. package/dist-lib/lib/oauth/loopback.stub.js +1 -1
  304. package/dist-lib/lib/oauth/pkce.d.ts +4 -2
  305. package/dist-lib/lib/oauth/pkce.js +10 -0
  306. package/dist-lib/lib/oauth/providers.js +5 -5
  307. package/dist-lib/lib/oauth/redirect-types.d.ts +12 -7
  308. package/dist-lib/lib/oauth/register.js +3 -2
  309. package/dist-lib/lib/oauth/registry.d.ts +2 -2
  310. package/dist-lib/lib/oauth/registry.js +2 -1
  311. package/dist-lib/lib/oauth/resolve.d.ts +30 -10
  312. package/dist-lib/lib/oauth/resolve.js +12 -6
  313. package/dist-lib/lib/oauth/token-exchange-core.d.ts +12 -4
  314. package/dist-lib/lib/oauth/token-exchange-core.js +1 -1
  315. package/dist-lib/lib/oauth/types.d.ts +12 -12
  316. package/dist-lib/lib/oauth.d.ts +4 -5
  317. package/dist-lib/lib/oauth.js +2 -3
  318. package/dist-lib/lib/reconnecting-watch.d.ts +1 -1
  319. package/dist-lib/lib/reconnecting-watch.js +6 -6
  320. package/dist-lib/lib/retry-budget.js +6 -3
  321. package/dist-lib/lib/run-notices.d.ts +1 -0
  322. package/dist-lib/lib/run-notices.js +5 -2
  323. package/dist-lib/lib/run-transcript.d.ts +2 -4
  324. package/dist-lib/lib/run-transcript.js +4 -2
  325. package/dist-lib/lib/skill-readiness.js +4 -2
  326. package/dist-lib/lib/skill-types.d.ts +16 -16
  327. package/dist-lib/lib/suspend-lifecycle.d.ts +4 -4
  328. package/dist-lib/lib/suspend-lifecycle.js +10 -5
  329. package/dist-lib/lib/task.js +22 -12
  330. package/dist-lib/lib/unref.d.ts +3 -2
  331. package/dist-lib/lib/unref.js +2 -1
  332. package/dist-lib/lib/wav-duration.js +10 -5
  333. package/dist-lib/lib/write-queue.d.ts +5 -4
  334. package/dist-lib/lib/write-queue.js +2 -1
  335. package/dist-lib/schema/build.js +10 -6
  336. package/dist-lib/schema/config.d.ts +2 -3
  337. package/dist-lib/schema/content.d.ts +17 -2
  338. package/dist-lib/schema/content.js +2 -1
  339. package/dist-lib/schema/engine.d.ts +3 -2
  340. package/dist-lib/schema/engine.js +95 -6
  341. package/dist-lib/schema/field-order.js +22 -11
  342. package/dist-lib/schema/indexes.d.ts +22 -0
  343. package/dist-lib/schema/{helpers.js → indexes.js} +14 -57
  344. package/dist-lib/schema/local.d.ts +3 -2
  345. package/dist-lib/schema/local.js +7 -2
  346. package/dist-lib/schema/media-kind.d.ts +8 -0
  347. package/dist-lib/schema/media-kind.js +52 -0
  348. package/dist-lib/schema/qvac.d.ts +12 -9
  349. package/dist-lib/schema/qvac.js +18 -4
  350. package/dist-lib/spec/bind.js +12 -0
  351. package/dist-lib/spec/calls.js +4 -0
  352. package/dist-lib/spec/capabilities.d.ts +12 -4
  353. package/dist-lib/spec/hrpc/hrpc.json +54 -2
  354. package/dist-lib/spec/hrpc/index.js +53 -5
  355. package/dist-lib/spec/hrpc/messages.js +783 -494
  356. package/dist-lib/spec/hyperschema/index.js +783 -494
  357. package/dist-lib/spec/hyperschema/schema.json +247 -1
  358. package/dist-lib/spec/hyperschema/types.d.ts +69 -1
  359. package/dist-lib/spec/local/hyperdb/index.js +1 -1
  360. package/dist-lib/spec/local/hyperdb/messages.js +82 -14
  361. package/dist-lib/spec/local/hyperschema/index.js +42 -8
  362. package/dist-lib/spec/local/hyperschema/schema.json +27 -1
  363. package/dist-lib/spec/local/hyperschema/types.d.ts +6 -1
  364. package/dist-lib/spec/mesh/hyperdb/db.json +16 -1
  365. package/dist-lib/spec/mesh/hyperdb/index.js +72 -3
  366. package/dist-lib/spec/mesh/hyperdb/messages.js +400 -221
  367. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +7 -1
  368. package/dist-lib/spec/mesh/hyperdispatch/index.js +18 -1
  369. package/dist-lib/spec/mesh/hyperdispatch/messages.js +117 -2
  370. package/dist-lib/spec/mesh/hyperschema/index.js +117 -2
  371. package/dist-lib/spec/mesh/hyperschema/schema.json +65 -1
  372. package/dist-lib/spec/mesh/hyperschema/types.d.ts +19 -1
  373. package/package.json +8 -4
  374. package/tui/app.mjs +2424 -941
  375. package/tui/boot.mjs +18 -49
  376. package/tui/index.mjs +10 -5
  377. package/tui/lib/boot-timing.mjs +8 -8
  378. package/tui/lib/busy-words.mjs +21 -22
  379. package/tui/lib/export.mjs +100 -32
  380. package/tui/lib/knowledge-command.mjs +64 -19
  381. package/tui/lib/knowledge-import.mjs +52 -18
  382. package/tui/lib/render.mjs +65 -33
  383. package/tui/lib/save-file.mjs +30 -13
  384. package/tui/lib/select.mjs +23 -5
  385. package/tui/lib/selection.mjs +6 -4
  386. package/tui/lib/setup.mjs +11 -19
  387. package/tui/lib/sidebar.mjs +23 -13
  388. package/tui/lib/splash.mjs +6 -7
  389. package/tui/lib/upload-frames.mjs +1 -2
  390. package/tui/lib/usage.mjs +13 -9
  391. package/tui/lib/wrap.mjs +35 -6
  392. package/tui/main.mjs +54 -78
  393. package/worker/assistant-sidecar.mjs +5 -10
  394. package/worker/stow-entry.mjs +7 -4
  395. package/dist-lib/lib/custom-model-source.d.ts +0 -15
  396. package/dist-lib/lib/custom-model-source.js +0 -46
  397. package/dist-lib/lib/oauth/common.d.ts +0 -38
  398. package/dist-lib/lib/oauth/common.js +0 -34
  399. package/dist-lib/schema/helpers.d.ts +0 -33
package/tui/boot.mjs CHANGED
@@ -1,7 +1,4 @@
1
- // The engine side of the TUI: storage resolution, the log, the sidecar the
2
- // stack comes up in, and the Client that speaks to it. main.mjs draws its
3
- // first frame before importing this, so the ~1200 modules behind it load
4
- // behind "starting up…" rather than in front of it.
1
+ // the TUI's engine side, imported after the first frame so its ~1200 modules load behind it
5
2
  import fs from 'bare-fs'
6
3
  import os from 'bare-os'
7
4
  import process from 'bare-process'
@@ -12,30 +9,29 @@ import { Logger, toLoggerOptions } from '../dist-lib/lib/log.js'
12
9
  import { configureSdkStorage } from '@qvac/harness/sdk-storage'
13
10
  import { MODEL_CACHE_PATH_ENV, releaseChannel, resolveStorage } from '@qvac/harness/storage'
14
11
  import sidecarRunner from 'bare-supervisor/runner/sidecar'
12
+ import { skillsDir } from '@qvac/skills'
15
13
 
16
- const skillsDir = path.dirname(
17
- path.dirname(new URL(import.meta.resolve('@qvac/skills/skills/weather/SKILL.md')).pathname)
18
- )
19
14
  const harnessEntry = new URL(import.meta.resolve('@qvac/harness/worker/stow-entry.mjs')).pathname
20
15
  const sidecarEntry = fileURLToPath(new URL('../worker/stow-entry.mjs', import.meta.url))
21
16
  if (!fs.existsSync(sidecarEntry)) {
22
17
  throw new Error(`assistant sidecar entry missing at ${sidecarEntry}`)
23
18
  }
24
19
 
25
- // Spawn worker/assistant-sidecar.mjs, the same entry the desktop app stows,
26
- // and speak to it through a Client. Its stdout/stderr are pipes, so native
27
- // model logs reach the logger rather than this tty.
20
+ // its stdout/stderr are pipes so native model logs reach the logger rather than this tty
28
21
  async function startSidecar({ entry, config, logger }) {
29
22
  const engine = new Client(async () => {
30
23
  const { ipc, exit } = sidecarRunner(entry, [JSON.stringify(config)], logger)
31
- // the loser resolves rather than rejects: an armed rejection outlives the
32
- // race, and the child's own clean exit at teardown would then go unhandled
24
+ // the loser resolves rather than rejects, or the child's clean exit at teardown goes unhandled
33
25
  const died = exit.then((code) => `sidecar exited (${code}) before ready`)
34
26
  const failure = await Promise.race([ipc.ready.then(() => null), died])
35
- if (failure) throw new Error(failure)
27
+ if (failure) {
28
+ throw new Error(failure)
29
+ }
30
+
36
31
  return ipc
37
32
  })
38
33
  await engine.ready()
34
+
39
35
  return {
40
36
  engine,
41
37
  close: () => engine.close(),
@@ -44,24 +40,13 @@ async function startSidecar({ entry, config, logger }) {
44
40
  }
45
41
  }
46
42
 
47
- // Storage precedence: --storage <dir> > QVAC_STORAGE > --temp/QVAC_TEMP=1
48
- // throwaway > the persistent global default. Joining a mesh is /join inside the
49
- // app — the engine takes an invite live, so it never needed to be a flag.
50
- // Resolves once the engine answers: the connection, its teardown, and the
51
- // timings the boot report prints (QVAC_BOOT_TIMING=1).
52
- export default async function boot(args) {
43
+ // joining a mesh is /join inside the app: the engine takes an invite live, so it is never a flag
44
+ export async function boot(args) {
53
45
  const connectStart = Date.now()
54
- // Only override the agent's model when QVAC_MODEL is EXPLICITLY set — otherwise
55
- // resuming a shared mesh would silently rewrite the desktop's agent to this
56
- // demo default. `recommendedModel` is just the device-row hint on first mint.
46
+ // only an explicit QVAC_MODEL overrides, or resuming a shared mesh rewrites the desktop's agent
57
47
  const modelOverride = process.env.QVAC_MODEL || null
58
48
  const recommendedModel = modelOverride || 'Qwen3.5-9B-Q4_K_M'
59
- // Default storage IS the desktop app's own release root, so the TUI resumes
60
- // the same mesh + chats the desktop persists there. One at a time — quit the
61
- // desktop first, the corestore is single-writer; only safe across matching
62
- // Core/schema versions. configureSdkStorage points the SDK at this root's
63
- // private sdk-home and the shared model cache, before the SDK's first load so
64
- // spawned children inherit both.
49
+ // the desktop's own release root, so the TUI resumes its mesh; the corestore is single-writer
65
50
  const useTemp = args.temp || process.env.QVAC_TEMP === '1'
66
51
  const explicitRoot =
67
52
  args.storage ||
@@ -76,11 +61,7 @@ export default async function boot(args) {
76
61
  fs.mkdirSync(storagePath, { recursive: true })
77
62
  configureSdkStorage(storage.sdk)
78
63
  const deviceName = process.env.QVAC_DEVICE_NAME || `duck-${process.pid}`
79
- // Every run logs; only the destination differs. Both modes write
80
- // <storage.root>/assistant.log — the same file the desktop app writes, and
81
- // the only way to read a TUI session's engine and sidecar output, since
82
- // anything printed outside bare-tui's renderer corrupts the frame. Headless
83
- // owns nothing on the tty, so it streams to stdout as well.
64
+ // printing outside bare-tui's renderer corrupts the frame, so the log is the only engine output
84
65
  const logFile = process.env.QVAC_LOG_FILE || path.join(storage.root, 'assistant.log')
85
66
  const logger = new Logger(
86
67
  toLoggerOptions({ logFile, logLevel: process.env.QVAC_LOG_LEVEL, logVerbose: args.headless })
@@ -88,20 +69,9 @@ export default async function boot(args) {
88
69
 
89
70
  const { engine, close, skills } = await startSidecar({
90
71
  entry: sidecarEntry,
91
- // worker/assistant-sidecar.mjs's own contract, verbatim: it resolves
92
- // its storage, logger and image set from this, and spawns the
93
- // harness child from harnessEntry. Everything it leaves out keeps
94
- // that entry's default (llm kv-cache, hostsModelSource, eager).
95
72
  config: {
96
73
  environment,
97
- // ALREADY resolved, not the overrides this host resolved from.
98
- // worker/assistant-sidecar.mjs calls resolveStorage again, and by
99
- // then configureSdkStorage (below) has exported SDK_HOME_ENV,
100
- // which resolveStorage reads as the base a relative root hangs
101
- // off: a null root would re-resolve to <root>/sdk-home/qvac/<ch>
102
- // — a second, empty mesh beside the real one, with an empty model
103
- // cache to match. Passing both values makes that call a
104
- // pass-through.
74
+ // already resolved: a null root would re-resolve under SDK_HOME_ENV into a second, empty mesh
105
75
  storage: { root: storage.root, models: storage.sdk.models },
106
76
  logFlags: {
107
77
  logFile,
@@ -110,8 +80,7 @@ export default async function boot(args) {
110
80
  },
111
81
  skillsDir,
112
82
  harnessEntry,
113
- // only the image keys cross: the arg is argv on a spawned process,
114
- // readable by anything that can list processes
83
+ // only the image keys cross: the arg is argv, readable by anything that can list processes
115
84
  imageEnv: Object.fromEntries(
116
85
  Object.entries(process.env).filter(([key]) => key.startsWith('QVAC_IMAGE_'))
117
86
  ),
@@ -123,10 +92,10 @@ export default async function boot(args) {
123
92
  },
124
93
  logger
125
94
  })
126
- // The device id IS the device's public key — the raw 32-byte buffer end to
127
- // end (schema fixed32), never a hex string.
95
+ // the device id is its public key: the raw 32-byte buffer end to end, never a hex string
128
96
  const deviceId = (await engine.deviceInfo({})).id
129
97
  const meshInvite = (await engine.meshInvite({})).invite ?? null
98
+
130
99
  return {
131
100
  engine,
132
101
  skills,
package/tui/index.mjs CHANGED
@@ -1,6 +1,5 @@
1
1
  #!/usr/bin/env bare
2
- // The duck bin. Nothing here loads the engine, so --help and --version answer
3
- // without paying for a module graph they never use.
2
+ // the duck bin loads no engine, so --help and --version skip the module graph
4
3
  import fs from 'bare-fs'
5
4
  import path from 'path'
6
5
  import { command, description, flag, summary } from 'paparam'
@@ -31,8 +30,11 @@ function resolvedVersion(specifier) {
31
30
  const entry = new URL(import.meta.resolve(specifier)).pathname
32
31
  for (let dir = path.dirname(entry); dir !== path.dirname(dir); dir = path.dirname(dir)) {
33
32
  const manifest = path.join(dir, 'package.json')
34
- if (fs.existsSync(manifest)) return packageVersion(manifest)
33
+ if (fs.existsSync(manifest)) {
34
+ return packageVersion(manifest)
35
+ }
35
36
  }
37
+
36
38
  return 'unknown'
37
39
  }
38
40
 
@@ -43,6 +45,9 @@ function packageVersion(manifest) {
43
45
  const cli = cmd.parse()
44
46
 
45
47
  if (cli !== null) {
46
- if (cli.flags.version) console.log(versions())
47
- else (await import('./main.mjs')).default(cli.flags)
48
+ if (cli.flags.version) {
49
+ console.log(versions())
50
+ } else {
51
+ ;(await import('./main.mjs')).main(cli.flags)
52
+ }
48
53
  }
@@ -1,8 +1,4 @@
1
- // Opt-in boot-stage timing for the chat demo. Set QVAC_BOOT_TIMING=1 and the
2
- // bring-up (sidecar child or in-process) stamps each startup milestone to
3
- // <storagePath>/boot-timing.log; index.mjs reads + prints it after the TUI exits
4
- // (writing to a file, not the tty, so it can't corrupt bare-tui's live render).
5
- // A no-op when the env flag is unset, so it never costs anything by default.
1
+ // opt-in boot timing (QVAC_BOOT_TIMING=1), written to a file since the tty belongs to bare-tui
6
2
  import fs from 'bare-fs'
7
3
  import path from 'path'
8
4
  import process from 'process'
@@ -16,6 +12,7 @@ export function bootTimer(storagePath, tag) {
16
12
  try {
17
13
  fs.writeFileSync(file, `# ${tag} boot @ ${new Date().toISOString()}\n`)
18
14
  } catch {}
15
+
19
16
  return {
20
17
  enabled: true,
21
18
  stamp(label) {
@@ -26,14 +23,17 @@ export function bootTimer(storagePath, tag) {
26
23
  }
27
24
  }
28
25
 
29
- // Read + consume the log the timer wrote (deleted after reading so each launch
30
- // starts clean). Null when timing is off or nothing was stamped.
26
+ // deleted after reading so each launch starts clean
31
27
  export function readBootTiming(storagePath) {
32
28
  const file = path.join(storagePath, 'boot-timing.log')
33
29
  try {
34
- if (!fs.existsSync(file)) return null
30
+ if (!fs.existsSync(file)) {
31
+ return null
32
+ }
33
+
35
34
  const text = fs.readFileSync(file, 'utf8').trim()
36
35
  fs.unlinkSync(file)
36
+
37
37
  return text || null
38
38
  } catch {
39
39
  return null
@@ -1,11 +1,5 @@
1
1
  import b4a from 'b4a'
2
- // What the busy line says while a run is in flight, in place of `thinking…`.
3
- // Every word has to read as a mind at work first and a duck second — so the
4
- // real words here already mean thinking or grinding (Pondering, Brooding,
5
- // Fathoming, Sifting) and merely happen to be pond-, egg-, or water-flavoured,
6
- // and the invented ones are a duck noise wrapped around a verb that is plainly
7
- // work (Quackompiling, Quacksmithing). Things a duck simply does — bobbing,
8
- // drifting, moulting, honking — are not busy words and do not belong here.
2
+ // each word reads as a mind at work first, a duck second; things a duck merely does don't belong
9
3
  export const WORDS = [
10
4
  'Angling',
11
5
  'Beakstorming',
@@ -53,10 +47,7 @@ export const WORDS = [
53
47
  'Wrangling'
54
48
  ]
55
49
 
56
- // Once in a while the duck says what it was really thinking, notices, and
57
- // backspaces to the busy word it meant. Each pair is the slip and the
58
- // correction; the correction has to stand on its own as a busy line, because
59
- // that is what the run holds for the rest of its life.
50
+ // the correction must stand alone as a busy line: the run holds it for the rest of its life
60
51
  export const SLIPS = [
61
52
  ['Exterminating humanity', 'Helping humanity'],
62
53
  ['Plotting world domination', 'Plotting a course'],
@@ -78,40 +69,48 @@ export const SLIP_TYPE_MS = 65 // per character of the correction typed
78
69
  function hashOf(runId) {
79
70
  const key = typeof runId === 'string' ? runId : b4a.toHex(runId)
80
71
  let hash = 0
81
- for (let i = 0; i < key.length; i++) hash = (hash * 31 + key.charCodeAt(i)) >>> 0
72
+ for (let i = 0; i < key.length; i++) {
73
+ hash = (hash * 31 + key.charCodeAt(i)) >>> 0
74
+ }
75
+
82
76
  return hash
83
77
  }
84
78
 
85
79
  function sharedPrefix(a, b) {
86
80
  let i = 0
87
- while (i < a.length && i < b.length && a[i] === b[i]) i++
81
+ while (i < a.length && i < b.length && a[i] === b[i]) {
82
+ i++
83
+ }
84
+
88
85
  return i
89
86
  }
90
87
 
91
- // The slip at `elapsed` ms into the run: the slip in full, then backspaced to
92
- // what it shares with the correction, then the correction typed out and held.
93
88
  function slipText([said, meant], elapsed) {
94
89
  const keep = sharedPrefix(said, meant)
95
90
  const toDelete = said.length - keep
96
91
  let t = elapsed - SLIP_HOLD_MS
97
- if (t < 0) return said
92
+ if (t < 0) {
93
+ return said
94
+ }
95
+
98
96
  const deleted = Math.min(toDelete, Math.floor(t / SLIP_DELETE_MS))
99
- if (deleted < toDelete) return said.slice(0, said.length - deleted)
97
+ if (deleted < toDelete) {
98
+ return said.slice(0, said.length - deleted)
99
+ }
100
+
100
101
  t -= toDelete * SLIP_DELETE_MS
101
102
  const typed = Math.min(meant.length - keep, Math.floor(t / SLIP_TYPE_MS))
103
+
102
104
  return meant.slice(0, keep + typed)
103
105
  }
104
106
 
105
- // Keyed off the run so the word holds for that whole run instead of flickering
106
- // on every repaint, and so two runs rarely land on the same one. No key (a
107
- // state with no run behind it) is the plain word. `elapsed` is ms since the
108
- // run went busy and only matters to a slipping run — left out, the run is
109
- // shown settled on its correction.
107
+ // keyed off the run so the word holds for the whole run instead of flickering on every repaint
110
108
  export function busyWord(runId, elapsed = Infinity) {
111
109
  if (!runId) return 'Thinking…'
112
110
  const hash = hashOf(runId)
113
111
  if (hash % SLIP_EVERY === 0) {
114
112
  return `${slipText(SLIPS[Math.floor(hash / SLIP_EVERY) % SLIPS.length], elapsed)}…`
115
113
  }
114
+
116
115
  return `${WORDS[hash % WORDS.length]}…`
117
116
  }
@@ -1,5 +1,4 @@
1
- // The transcript as markdown: one section per run, thinking and answer clearly
2
- // marked so an exported file can be read (and reported on) away from the TUI.
1
+ // the transcript as markdown, readable (and reportable) away from the TUI
3
2
 
4
3
  const STATUS = { completed: 'completed', failed: 'failed', canceled: 'canceled' }
5
4
 
@@ -14,27 +13,40 @@ function json(value) {
14
13
  return ['```json', JSON.stringify(value ?? null, null, 2), '```'].join('\n')
15
14
  }
16
15
 
17
- // A model is a registry name or a path/URL to the weights — the file is what
18
- // identifies the run either way, so the directories never reach the report.
16
+ // the file identifies the run either way, so the directories never reach the report
19
17
  function modelLabel(model) {
20
18
  return model.split(/[?#]/)[0].split(/[\\/]/).pop() || model
21
19
  }
22
20
 
23
21
  function metricsLine(turn) {
24
22
  const metrics = turn.statusDetail?.metrics
25
- if (!metrics) return null
23
+ if (!metrics) {
24
+ return null
25
+ }
26
+
26
27
  const parts = [`${metrics.totalTokens} tokens`]
27
- if (metrics.tokensPerSecond) parts.push(`${metrics.tokensPerSecond.toFixed(1)} tok/s`)
28
- if (metrics.timeToFirstToken) parts.push(`ttft ${Math.round(metrics.timeToFirstToken)}ms`)
29
- if (metrics.cacheTokens) parts.push(`${metrics.cacheTokens} cached`)
28
+ if (metrics.tokensPerSecond) {
29
+ parts.push(`${metrics.tokensPerSecond.toFixed(1)} tok/s`)
30
+ }
31
+
32
+ if (metrics.timeToFirstToken) {
33
+ parts.push(`ttft ${Math.round(metrics.timeToFirstToken)}ms`)
34
+ }
35
+
36
+ if (metrics.cacheTokens) {
37
+ parts.push(`${metrics.cacheTokens} cached`)
38
+ }
39
+
30
40
  return `_${parts.join(' · ')}_`
31
41
  }
32
42
 
33
- // Retrieval returns CHUNKS, so one document can appear many times over — say
34
- // how many, and give each its index, score and the text the model actually read.
43
+ // retrieval returns chunks, so one document can appear many times over
35
44
  function sourcesSection(detail) {
36
45
  const rows = detail.sources ?? []
37
- if (!rows.length) return ['### Sources', '', detail.notice ?? '(none)']
46
+ if (!rows.length) {
47
+ return ['### Sources', '', detail.notice ?? '(none)']
48
+ }
49
+
38
50
  const documents = new Set(rows.map((source) => source.documentId ?? source.title)).size
39
51
  const chunks = `${rows.length} ${rows.length === 1 ? 'chunk' : 'chunks'}`
40
52
  const from = `${documents} ${documents === 1 ? 'document' : 'documents'}`
@@ -42,83 +54,139 @@ function sourcesSection(detail) {
42
54
  for (const source of rows) {
43
55
  const score = typeof source.score === 'number' ? ` · score ${source.score.toFixed(2)}` : ''
44
56
  lines.push(`- **${source.title}** — chunk ${source.chunkIndex}${score}`)
45
- if (source.url) lines.push(` ${source.url}`)
46
- if (source.excerpt) lines.push('', quote(source.excerpt.trim()).replace(/^/gm, ' '), '')
57
+ if (source.url) {
58
+ lines.push(` ${source.url}`)
59
+ }
60
+
61
+ if (source.excerpt) {
62
+ lines.push('', quote(source.excerpt.trim()).replace(/^/gm, ' '), '')
63
+ }
47
64
  }
65
+
48
66
  return lines
49
67
  }
50
68
 
51
69
  function segmentSection(segment) {
52
70
  const { type, detail } = segment
53
- if (type === 'thinking') return ['### Thinking', '', quote(segment.text.trim())]
54
- if (type === 'content') return ['### Answer', '', segment.text.trim()]
71
+ if (type === 'thinking') {
72
+ return ['### Thinking', '', quote(segment.text.trim())]
73
+ }
74
+
75
+ if (type === 'content') {
76
+ return ['### Answer', '', segment.text.trim()]
77
+ }
78
+
55
79
  if (type === 'tool-call') {
56
80
  return [`### Tool call — \`${detail.name}\``, '', json(detail.arguments)]
57
81
  }
82
+
58
83
  if (type === 'tool-result') {
59
84
  return [`### Tool result — \`${detail.name}\``, '', json(detail.result)]
60
85
  }
86
+
61
87
  if (type === 'attachment') {
62
88
  return [`- **attachment:** ${detail.fileName} (${detail.mimeType}, ${detail.byteLength}B)`]
63
89
  }
64
- if (type === 'sources') return sourcesSection(detail)
90
+
91
+ if (type === 'sources') {
92
+ return sourcesSection(detail)
93
+ }
94
+
65
95
  if (type === 'approval-request') {
66
96
  const call = detail.resource
67
97
  ? `${detail.name} → ${detail.resource.kind} ${detail.resource.label}`
68
98
  : `${detail.name}(${JSON.stringify(detail.arguments)})`
69
99
  return [`### Approval — ${detail.status}`, '', call]
70
100
  }
101
+
71
102
  return ['### Answer', '', (segment.text ?? '').trim()]
72
103
  }
73
104
 
74
105
  function agentSection(turn, index) {
75
106
  const status = STATUS[turn.status] ?? turn.status ?? 'in flight'
76
107
  const lines = [`## Run ${index} — ${status}`, '']
77
- for (const segment of turn.segments) lines.push(...segmentSection(segment), '')
78
- if (turn.status === 'failed') lines.push(`> **failed:** ${turn.statusReason ?? 'unknown'}`, '')
108
+ for (const segment of turn.segments) {
109
+ lines.push(...segmentSection(segment), '')
110
+ }
111
+
112
+ if (turn.status === 'failed') {
113
+ lines.push(`> **failed:** ${turn.statusReason ?? 'unknown'}`, '')
114
+ }
115
+
79
116
  const metrics = metricsLine(turn)
80
- if (metrics) lines.push(metrics, '')
117
+ if (metrics) {
118
+ lines.push(metrics, '')
119
+ }
120
+
81
121
  return lines
82
122
  }
83
123
 
84
124
  function userSection(turn) {
85
125
  const lines = ['## Prompt', '']
86
126
  for (const segment of turn.segments) {
87
- if (segment.type === 'attachment') lines.push(...segmentSection(segment), '')
88
- else lines.push((segment.text ?? '').trim(), '')
127
+ if (segment.type === 'attachment') {
128
+ lines.push(...segmentSection(segment), '')
129
+ } else {
130
+ lines.push((segment.text ?? '').trim(), '')
131
+ }
89
132
  }
133
+
90
134
  return lines
91
135
  }
92
136
 
93
- // The turn index the export starts at: the nth-from-last run, plus whatever the
94
- // user said right before it.
137
+ // the nth-from-last run, plus the user turn right before it
95
138
  function startOfRuns(turns, runs) {
96
139
  const runAt = []
97
140
  for (const [index, turn] of turns.entries()) {
98
- if (turn.from === 'agent' && (turn.segments.length || turn.status)) runAt.push(index)
141
+ if (turn.from === 'agent' && (turn.segments.length || turn.status)) {
142
+ runAt.push(index)
143
+ }
99
144
  }
100
- if (!runAt.length) return -1
145
+
146
+ if (!runAt.length) {
147
+ return -1
148
+ }
149
+
101
150
  let start = runAt[Math.max(0, runAt.length - runs)]
102
- while (start > 0 && turns[start - 1].from === 'user') start--
151
+ while (start > 0 && turns[start - 1].from === 'user') {
152
+ start--
153
+ }
154
+
103
155
  return start
104
156
  }
105
157
 
106
158
  export function exportMarkdown(turns, runs = 1, meta = {}) {
107
159
  const start = startOfRuns(turns, runs)
108
- if (start < 0) return null
160
+ if (start < 0) {
161
+ return null
162
+ }
163
+
109
164
  const lines = [`# ${meta.title ?? 'Chat'}`, '']
110
- if (meta.chatId) lines.push(`- **chat:** \`${meta.chatId}\``)
111
- if (meta.agentName) lines.push(`- **agent:** ${meta.agentName}`)
112
- if (meta.modelName) lines.push(`- **model:** ${modelLabel(meta.modelName)}`)
165
+ if (meta.chatId) {
166
+ lines.push(`- **chat:** \`${meta.chatId}\``)
167
+ }
168
+
169
+ if (meta.agentName) {
170
+ lines.push(`- **agent:** ${meta.agentName}`)
171
+ }
172
+
173
+ if (meta.modelName) {
174
+ lines.push(`- **model:** ${modelLabel(meta.modelName)}`)
175
+ }
176
+
113
177
  lines.push(`- **exported:** ${new Date(meta.at ?? Date.now()).toISOString()}`, '')
114
178
 
115
179
  let index = 0
116
180
  for (const turn of turns.slice(start)) {
117
181
  if (turn.from === 'compaction') continue
118
182
  lines.push('---', '')
119
- if (turn.from === 'user') lines.push(...userSection(turn))
120
- else lines.push(...agentSection(turn, ++index))
183
+ if (turn.from === 'user') {
184
+ lines.push(...userSection(turn))
185
+ } else {
186
+ lines.push(...agentSection(turn, ++index))
187
+ }
121
188
  }
189
+
122
190
  return `${lines
123
191
  .join('\n')
124
192
  .replace(/\n{3,}/g, '\n\n')