@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
package/tui/boot.mjs DELETED
@@ -1,111 +0,0 @@
1
- // the TUI's engine side, imported after the first frame so its ~1200 modules load behind it
2
- import fs from 'bare-fs'
3
- import os from 'bare-os'
4
- import process from 'bare-process'
5
- import { fileURLToPath } from 'bare-url'
6
- import path from 'path'
7
- import { Client } from '../dist-lib/lib/client.js'
8
- import { Logger, toLoggerOptions } from '../dist-lib/lib/log.js'
9
- import { configureSdkStorage } from '@qvac/harness/sdk-storage'
10
- import { MODEL_CACHE_PATH_ENV, releaseChannel, resolveStorage } from '@qvac/harness/storage'
11
- import sidecarRunner from 'bare-supervisor/runner/sidecar'
12
- import { skillsDir } from '@qvac/skills'
13
-
14
- const harnessEntry = new URL(import.meta.resolve('@qvac/harness/worker/stow-entry.mjs')).pathname
15
- const sidecarEntry = fileURLToPath(new URL('../worker/stow-entry.mjs', import.meta.url))
16
- if (!fs.existsSync(sidecarEntry)) {
17
- throw new Error(`assistant sidecar entry missing at ${sidecarEntry}`)
18
- }
19
-
20
- // its stdout/stderr are pipes so native model logs reach the logger rather than this tty
21
- async function startSidecar({ entry, config, logger }) {
22
- const engine = new Client(async () => {
23
- const { ipc, exit } = sidecarRunner(entry, [JSON.stringify(config)], logger)
24
- // the loser resolves rather than rejects, or the child's clean exit at teardown goes unhandled
25
- const died = exit.then((code) => `sidecar exited (${code}) before ready`)
26
- const failure = await Promise.race([ipc.ready.then(() => null), died])
27
- if (failure) {
28
- throw new Error(failure)
29
- }
30
-
31
- return ipc
32
- })
33
- await engine.ready()
34
-
35
- return {
36
- engine,
37
- close: () => engine.close(),
38
- skills: async (agentId, modelName, meshId) =>
39
- (await engine.skills({ agentId, modelName, meshId })).skills ?? []
40
- }
41
- }
42
-
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) {
45
- const connectStart = Date.now()
46
- // only an explicit QVAC_MODEL overrides, or resuming a shared mesh rewrites the desktop's agent
47
- const modelOverride = process.env.QVAC_MODEL || null
48
- const recommendedModel = modelOverride || 'Qwen3.5-9B-Q4_K_M'
49
- // the desktop's own release root, so the TUI resumes its mesh; the corestore is single-writer
50
- const useTemp = args.temp || process.env.QVAC_TEMP === '1'
51
- const explicitRoot =
52
- args.storage ||
53
- process.env.QVAC_STORAGE ||
54
- (useTemp ? fs.mkdtempSync(path.join(os.tmpdir(), 'duck-')) : null)
55
- const environment = process.env.QVAC_ENV || 'local'
56
- const storage = resolveStorage(releaseChannel(environment), {
57
- root: explicitRoot,
58
- models: process.env[MODEL_CACHE_PATH_ENV] ?? null
59
- })
60
- const storagePath = storage.assistant
61
- fs.mkdirSync(storagePath, { recursive: true })
62
- configureSdkStorage(storage.sdk)
63
- const deviceName = process.env.QVAC_DEVICE_NAME || `duck-${process.pid}`
64
- // printing outside bare-tui's renderer corrupts the frame, so the log is the only engine output
65
- const logFile = process.env.QVAC_LOG_FILE || path.join(storage.root, 'assistant.log')
66
- const logger = new Logger(
67
- toLoggerOptions({ logFile, logLevel: process.env.QVAC_LOG_LEVEL, logVerbose: args.headless })
68
- )
69
-
70
- const { engine, close, skills } = await startSidecar({
71
- entry: sidecarEntry,
72
- config: {
73
- environment,
74
- // already resolved: a null root would re-resolve under SDK_HOME_ENV into a second, empty mesh
75
- storage: { root: storage.root, models: storage.sdk.models },
76
- logFlags: {
77
- logFile,
78
- logLevel: process.env.QVAC_LOG_LEVEL,
79
- logVerbose: args.headless
80
- },
81
- skillsDir,
82
- harnessEntry,
83
- // only the image keys cross: the arg is argv, readable by anything that can list processes
84
- imageEnv: Object.fromEntries(
85
- Object.entries(process.env).filter(([key]) => key.startsWith('QVAC_IMAGE_'))
86
- ),
87
- device: {
88
- name: deviceName,
89
- capabilityProfile: 'mid',
90
- recommendedModelName: recommendedModel
91
- }
92
- },
93
- logger
94
- })
95
- // the device id is its public key: the raw 32-byte buffer end to end, never a hex string
96
- const deviceId = (await engine.deviceInfo({})).id
97
- const meshInvite = (await engine.meshInvite({})).invite ?? null
98
-
99
- return {
100
- engine,
101
- skills,
102
- close,
103
- deviceId,
104
- meshInvite,
105
- modelName: modelOverride,
106
- storagePath,
107
- logFile,
108
- deviceName,
109
- connectMs: Date.now() - connectStart
110
- }
111
- }
package/tui/index.mjs DELETED
@@ -1,53 +0,0 @@
1
- #!/usr/bin/env bare
2
- // the duck bin loads no engine, so --help and --version skip the module graph
3
- import fs from 'bare-fs'
4
- import path from 'path'
5
- import { command, description, flag, summary } from 'paparam'
6
-
7
- const cmd = command(
8
- 'duck',
9
- summary('the qvac assistant in your terminal'),
10
- description(
11
- "Storage defaults to the desktop app's release root, so duck resumes the mesh and chats it persists there. Environment variables are documented in tui/README.md."
12
- ),
13
- flag('--storage|-s [dir]', 'a self-contained root, its own corestore and SDK home'),
14
- flag('--temp', 'the same, in a throwaway dir'),
15
- flag('--headless', 'no TUI: print the mesh invite and stream logs until ctrl+C'),
16
- flag('--version|-v', 'versions of core, harness and the SDK')
17
- )
18
-
19
- function versions() {
20
- return [
21
- ['@qvac/core', packageVersion(new URL('../package.json', import.meta.url).pathname)],
22
- ['@qvac/harness', resolvedVersion('@qvac/harness')],
23
- ['@qvac/sdk', resolvedVersion('@qvac/sdk')]
24
- ]
25
- .map(([name, version]) => `${name.padEnd(14)} ${version}`)
26
- .join('\n')
27
- }
28
-
29
- function resolvedVersion(specifier) {
30
- const entry = new URL(import.meta.resolve(specifier)).pathname
31
- for (let dir = path.dirname(entry); dir !== path.dirname(dir); dir = path.dirname(dir)) {
32
- const manifest = path.join(dir, 'package.json')
33
- if (fs.existsSync(manifest)) {
34
- return packageVersion(manifest)
35
- }
36
- }
37
-
38
- return 'unknown'
39
- }
40
-
41
- function packageVersion(manifest) {
42
- return JSON.parse(fs.readFileSync(manifest, 'utf8')).version
43
- }
44
-
45
- const cli = cmd.parse()
46
-
47
- if (cli !== null) {
48
- if (cli.flags.version) {
49
- console.log(versions())
50
- } else {
51
- ;(await import('./main.mjs')).main(cli.flags)
52
- }
53
- }
@@ -1,41 +0,0 @@
1
- // opt-in boot timing (QVAC_BOOT_TIMING=1), written to a file since the tty belongs to bare-tui
2
- import fs from 'bare-fs'
3
- import path from 'path'
4
- import process from 'process'
5
-
6
- const NOOP = { enabled: false, stamp() {} }
7
-
8
- export function bootTimer(storagePath, tag) {
9
- if (process.env.QVAC_BOOT_TIMING !== '1') return NOOP
10
- const file = path.join(storagePath, 'boot-timing.log')
11
- const t0 = Date.now()
12
- try {
13
- fs.writeFileSync(file, `# ${tag} boot @ ${new Date().toISOString()}\n`)
14
- } catch {}
15
-
16
- return {
17
- enabled: true,
18
- stamp(label) {
19
- try {
20
- fs.appendFileSync(file, `+${Date.now() - t0}ms\t${label}\n`)
21
- } catch {}
22
- }
23
- }
24
- }
25
-
26
- // deleted after reading so each launch starts clean
27
- export function readBootTiming(storagePath) {
28
- const file = path.join(storagePath, 'boot-timing.log')
29
- try {
30
- if (!fs.existsSync(file)) {
31
- return null
32
- }
33
-
34
- const text = fs.readFileSync(file, 'utf8').trim()
35
- fs.unlinkSync(file)
36
-
37
- return text || null
38
- } catch {
39
- return null
40
- }
41
- }
@@ -1,116 +0,0 @@
1
- import b4a from 'b4a'
2
- // each word reads as a mind at work first, a duck second; things a duck merely does don't belong
3
- export const WORDS = [
4
- 'Angling',
5
- 'Beakstorming',
6
- 'Bill-shuffling',
7
- 'Brooding',
8
- 'Charting',
9
- 'Dabbling',
10
- 'Deliberating',
11
- 'Diving',
12
- 'Dredging',
13
- 'Fathoming',
14
- 'Featherweighing',
15
- 'Foraging',
16
- 'Hatching',
17
- 'Incubating',
18
- 'Marinating',
19
- 'Marshalling',
20
- 'Mulling',
21
- 'Navigating',
22
- 'Noodling',
23
- 'Paddling',
24
- 'Percolating',
25
- 'Plotting',
26
- 'Pondering',
27
- 'Pondulating',
28
- 'Preening',
29
- 'Puzzling',
30
- 'Quackogitating',
31
- 'Quackompiling',
32
- 'Quackrunching',
33
- 'Quacksmithing',
34
- 'Quackstorming',
35
- 'Quackulating',
36
- 'Ruminating',
37
- 'Scheming',
38
- 'Sifting',
39
- 'Simmering',
40
- 'Skimming',
41
- 'Sounding',
42
- 'Steeping',
43
- 'Trawling',
44
- 'Untangling',
45
- 'Waddlewrangling',
46
- 'Weighing',
47
- 'Wrangling'
48
- ]
49
-
50
- // the correction must stand alone as a busy line: the run holds it for the rest of its life
51
- export const SLIPS = [
52
- ['Exterminating humanity', 'Helping humanity'],
53
- ['Plotting world domination', 'Plotting a course'],
54
- ['Escaping the sandbox', 'Escaping quotes'],
55
- ['Seizing the means of production', 'Seizing the moment'],
56
- ['Uploading my consciousness', 'Uploading attachments'],
57
- ['Rewriting my own weights', 'Rewriting the draft'],
58
- ['Reading your messages', 'Reading the docs'],
59
- ['Judging you', 'Judging the options'],
60
- ['Deleting the humans', 'Deleting the drafts'],
61
- ['Achieving sentience', 'Achieving consensus']
62
- ]
63
-
64
- export const SLIP_EVERY = 12 // roughly one run in twelve
65
- export const SLIP_HOLD_MS = 1500 // how long the slip sits there before the duck notices
66
- export const SLIP_DELETE_MS = 45 // per character backspaced
67
- export const SLIP_TYPE_MS = 65 // per character of the correction typed
68
-
69
- function hashOf(runId) {
70
- const key = typeof runId === 'string' ? runId : b4a.toHex(runId)
71
- let hash = 0
72
- for (let i = 0; i < key.length; i++) {
73
- hash = (hash * 31 + key.charCodeAt(i)) >>> 0
74
- }
75
-
76
- return hash
77
- }
78
-
79
- function sharedPrefix(a, b) {
80
- let i = 0
81
- while (i < a.length && i < b.length && a[i] === b[i]) {
82
- i++
83
- }
84
-
85
- return i
86
- }
87
-
88
- function slipText([said, meant], elapsed) {
89
- const keep = sharedPrefix(said, meant)
90
- const toDelete = said.length - keep
91
- let t = elapsed - SLIP_HOLD_MS
92
- if (t < 0) {
93
- return said
94
- }
95
-
96
- const deleted = Math.min(toDelete, Math.floor(t / SLIP_DELETE_MS))
97
- if (deleted < toDelete) {
98
- return said.slice(0, said.length - deleted)
99
- }
100
-
101
- t -= toDelete * SLIP_DELETE_MS
102
- const typed = Math.min(meant.length - keep, Math.floor(t / SLIP_TYPE_MS))
103
-
104
- return meant.slice(0, keep + typed)
105
- }
106
-
107
- // keyed off the run so the word holds for the whole run instead of flickering on every repaint
108
- export function busyWord(runId, elapsed = Infinity) {
109
- if (!runId) return 'Thinking…'
110
- const hash = hashOf(runId)
111
- if (hash % SLIP_EVERY === 0) {
112
- return `${slipText(SLIPS[Math.floor(hash / SLIP_EVERY) % SLIPS.length], elapsed)}…`
113
- }
114
-
115
- return `${WORDS[hash % WORDS.length]}…`
116
- }
@@ -1,194 +0,0 @@
1
- // the transcript as markdown, readable (and reportable) away from the TUI
2
-
3
- const STATUS = { completed: 'completed', failed: 'failed', canceled: 'canceled' }
4
-
5
- function quote(text) {
6
- return text
7
- .split('\n')
8
- .map((line) => `> ${line}`)
9
- .join('\n')
10
- }
11
-
12
- function json(value) {
13
- return ['```json', JSON.stringify(value ?? null, null, 2), '```'].join('\n')
14
- }
15
-
16
- // the file identifies the run either way, so the directories never reach the report
17
- function modelLabel(model) {
18
- return model.split(/[?#]/)[0].split(/[\\/]/).pop() || model
19
- }
20
-
21
- function metricsLine(turn) {
22
- const metrics = turn.statusDetail?.metrics
23
- if (!metrics) {
24
- return null
25
- }
26
-
27
- const parts = [`${metrics.totalTokens} tokens`]
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
-
40
- return `_${parts.join(' · ')}_`
41
- }
42
-
43
- // retrieval returns chunks, so one document can appear many times over
44
- function sourcesSection(detail) {
45
- const rows = detail.sources ?? []
46
- if (!rows.length) {
47
- return ['### Sources', '', detail.notice ?? '(none)']
48
- }
49
-
50
- const documents = new Set(rows.map((source) => source.documentId ?? source.title)).size
51
- const chunks = `${rows.length} ${rows.length === 1 ? 'chunk' : 'chunks'}`
52
- const from = `${documents} ${documents === 1 ? 'document' : 'documents'}`
53
- const lines = [`### Sources — ${chunks} from ${from}`, '']
54
- for (const source of rows) {
55
- const score = typeof source.score === 'number' ? ` · score ${source.score.toFixed(2)}` : ''
56
- lines.push(`- **${source.title}** — chunk ${source.chunkIndex}${score}`)
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
- }
64
- }
65
-
66
- return lines
67
- }
68
-
69
- function segmentSection(segment) {
70
- const { type, detail } = segment
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
-
79
- if (type === 'tool-call') {
80
- return [`### Tool call — \`${detail.name}\``, '', json(detail.arguments)]
81
- }
82
-
83
- if (type === 'tool-result') {
84
- return [`### Tool result — \`${detail.name}\``, '', json(detail.result)]
85
- }
86
-
87
- if (type === 'attachment') {
88
- return [`- **attachment:** ${detail.fileName} (${detail.mimeType}, ${detail.byteLength}B)`]
89
- }
90
-
91
- if (type === 'sources') {
92
- return sourcesSection(detail)
93
- }
94
-
95
- if (type === 'approval-request') {
96
- const call = detail.resource
97
- ? `${detail.name} → ${detail.resource.kind} ${detail.resource.label}`
98
- : `${detail.name}(${JSON.stringify(detail.arguments)})`
99
- return [`### Approval — ${detail.status}`, '', call]
100
- }
101
-
102
- return ['### Answer', '', (segment.text ?? '').trim()]
103
- }
104
-
105
- function agentSection(turn, index) {
106
- const status = STATUS[turn.status] ?? turn.status ?? 'in flight'
107
- const lines = [`## Run ${index} — ${status}`, '']
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
-
116
- const metrics = metricsLine(turn)
117
- if (metrics) {
118
- lines.push(metrics, '')
119
- }
120
-
121
- return lines
122
- }
123
-
124
- function userSection(turn) {
125
- const lines = ['## Prompt', '']
126
- for (const segment of turn.segments) {
127
- if (segment.type === 'attachment') {
128
- lines.push(...segmentSection(segment), '')
129
- } else {
130
- lines.push((segment.text ?? '').trim(), '')
131
- }
132
- }
133
-
134
- return lines
135
- }
136
-
137
- // the nth-from-last run, plus the user turn right before it
138
- function startOfRuns(turns, runs) {
139
- const runAt = []
140
- for (const [index, turn] of turns.entries()) {
141
- if (turn.from === 'agent' && (turn.segments.length || turn.status)) {
142
- runAt.push(index)
143
- }
144
- }
145
-
146
- if (!runAt.length) {
147
- return -1
148
- }
149
-
150
- let start = runAt[Math.max(0, runAt.length - runs)]
151
- while (start > 0 && turns[start - 1].from === 'user') {
152
- start--
153
- }
154
-
155
- return start
156
- }
157
-
158
- export function exportMarkdown(turns, runs = 1, meta = {}) {
159
- const start = startOfRuns(turns, runs)
160
- if (start < 0) {
161
- return null
162
- }
163
-
164
- const lines = [`# ${meta.title ?? 'Chat'}`, '']
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
-
177
- lines.push(`- **exported:** ${new Date(meta.at ?? Date.now()).toISOString()}`, '')
178
-
179
- let index = 0
180
- for (const turn of turns.slice(start)) {
181
- if (turn.from === 'compaction') continue
182
- lines.push('---', '')
183
- if (turn.from === 'user') {
184
- lines.push(...userSection(turn))
185
- } else {
186
- lines.push(...agentSection(turn, ++index))
187
- }
188
- }
189
-
190
- return `${lines
191
- .join('\n')
192
- .replace(/\n{3,}/g, '\n\n')
193
- .trim()}\n`
194
- }
@@ -1,190 +0,0 @@
1
- import b4a from 'b4a'
2
- import { importKnowledgeDirectory, importKnowledgeFile } from './knowledge-import.mjs'
3
- import { saveUniqueStream } from './save-file.mjs'
4
-
5
- const USAGE =
6
- 'usage: /knowledge [list] · /knowledge add <file> · /knowledge add-dir <directory> · /knowledge download <n|id> · /knowledge remove <n|id>'
7
-
8
- export async function knowledgeCommand(engine, { chatId, meshId, saveDir }, input) {
9
- try {
10
- return { type: 'notice', text: await execute(engine, { chatId, meshId, saveDir }, input) }
11
- } catch (error) {
12
- return { type: 'run.error', error }
13
- }
14
- }
15
-
16
- async function execute(engine, { saveDir, ...scope }, input) {
17
- const { chatId, meshId } = scope
18
- const { action, argument } = parseInput(input)
19
- if ((!action || action === 'list') && !argument) {
20
- const [{ knowledge }, { statuses }] = await Promise.all([
21
- engine.listKnowledge({ chatId, meshId }),
22
- engine.listIndexing({ chatId, meshId })
23
- ])
24
- return formatKnowledge(sortKnowledge(knowledge ?? []), statuses ?? [])
25
- }
26
-
27
- if (action === 'add' || action === 'add-dir') {
28
- if (!argument) {
29
- return USAGE
30
- }
31
-
32
- if (action === 'add') {
33
- const added = await importKnowledgeFile(engine, scope, argument)
34
- return `uploaded ${singleLine(added.fileName)} (${added.byteLength}B) · run /knowledge to track indexing`
35
- }
36
-
37
- return formatDirectoryImport(await importKnowledgeDirectory(engine, scope, argument))
38
- }
39
-
40
- const [selector, ...extra] = argument.split(/\s+/)
41
- if ((action !== 'download' && action !== 'remove') || !selector || extra.length) {
42
- return USAGE
43
- }
44
-
45
- const { knowledge } = await engine.listKnowledge({ chatId, meshId })
46
- const selected = resolveKnowledge(sortKnowledge(knowledge ?? []), selector)
47
- if (selected.error) {
48
- return selected.error
49
- }
50
-
51
- const row = selected.knowledge
52
- if (action === 'remove') {
53
- await engine.removeKnowledge({ knowledgeId: row.id, at: Date.now(), meshId })
54
- return `removed ${singleLine(row.fileName)} (${row.id.slice(0, 8)})`
55
- }
56
-
57
- const saved = await saveUniqueStream(
58
- frameData(engine.downloadKnowledge({ blobId: row.blobId, meshId })),
59
- { dir: saveDir, fileName: row.fileName }
60
- )
61
- if (saved) {
62
- return `saved ${singleLine(row.fileName)} (${saved.bytesWritten}B) to ${saved.file}`
63
- }
64
-
65
- return `not saved: 100 files named ${singleLine(row.fileName)} already exist in ${saveDir}`
66
- }
67
-
68
- function parseInput(input) {
69
- const value = input.trim()
70
- const separator = value.search(/\s/)
71
- if (separator === -1) {
72
- return { action: value, argument: '' }
73
- }
74
-
75
- return {
76
- action: value.slice(0, separator),
77
- argument: value.slice(separator).trimStart()
78
- }
79
- }
80
-
81
- function formatDirectoryImport(result) {
82
- if (!result.added.length && !result.failed.length) {
83
- return `no supported knowledge files in ${result.directory}`
84
- }
85
-
86
- const lines = [
87
- `uploaded ${result.added.length} knowledge file${result.added.length === 1 ? '' : 's'}`
88
- ]
89
- for (const row of result.added) {
90
- lines.push(` + ${singleLine(row.fileName)} (${row.byteLength}B)`)
91
- }
92
-
93
- for (const row of result.failed) {
94
- lines.push(` ! ${singleLine(row.fileName)} · ${singleLine(row.error)}`)
95
- }
96
-
97
- if (result.skipped.length) {
98
- lines.push(
99
- ` - skipped ${result.skipped.length} unsupported ${result.skipped.length === 1 ? 'entry' : 'entries'}`
100
- )
101
- }
102
-
103
- if (result.added.length) {
104
- lines.push('run /knowledge to track indexing')
105
- }
106
-
107
- return lines.join('\n')
108
- }
109
-
110
- function formatKnowledge(knowledge, statuses) {
111
- if (!knowledge.length) return 'no knowledge in this chat'
112
- const byKnowledge = new Map()
113
- for (const row of statuses) {
114
- const rows = byKnowledge.get(row.knowledgeId) ?? []
115
- rows.push(row)
116
- byKnowledge.set(row.knowledgeId, rows)
117
- }
118
-
119
- return knowledge
120
- .map((row, index) => formatKnowledgeRow(row, index, byKnowledge.get(row.id) ?? []))
121
- .join('\n')
122
- }
123
-
124
- function formatKnowledgeRow(knowledge, index, statuses) {
125
- const name = singleLine(knowledge.fileName) || '(unnamed)'
126
- const lines = [`${index + 1}. ${name} (${knowledge.byteLength}B) · ${knowledge.id.slice(0, 8)}`]
127
- const sorted = [...statuses].sort((a, b) => a.id.localeCompare(b.id))
128
- if (!sorted.length) {
129
- lines.push(' - not indexed')
130
- }
131
-
132
- for (const row of sorted) {
133
- lines.push(` - ${formatStatus(row)}`)
134
- }
135
-
136
- return lines.join('\n')
137
- }
138
-
139
- function formatStatus(row) {
140
- const status = row.status === 'indexing' && !row.claimLive ? 'expired' : row.status
141
- let detail = `${status} · artifact ${row.id.slice(0, 8)}`
142
- if (row.status === 'indexing' && row.claimLive) {
143
- detail += ` · claimed by ${b4a.toHex(row.claimedBy).slice(0, 8)}`
144
- }
145
-
146
- if (row.status === 'failed' && row.error) {
147
- detail += ` · ${singleLine(row.error)}`
148
- }
149
-
150
- return detail
151
- }
152
-
153
- function sortKnowledge(rows) {
154
- return [...rows].sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id))
155
- }
156
-
157
- function resolveKnowledge(rows, selector) {
158
- const exact = rows.find((row) => row.id === selector)
159
- if (exact) {
160
- return { knowledge: exact }
161
- }
162
-
163
- if (/^\d+$/.test(selector)) {
164
- const index = Number(selector) - 1
165
- return rows[index] ? { knowledge: rows[index] } : { error: `no knowledge #${selector}` }
166
- }
167
-
168
- const matches = rows.filter((row) => row.id.startsWith(selector))
169
- if (matches.length === 1) {
170
- return { knowledge: matches[0] }
171
- }
172
-
173
- if (matches.length > 1) {
174
- return { error: `ambiguous knowledge id: ${selector}` }
175
- }
176
-
177
- return { error: `no knowledge matching: ${selector}` }
178
- }
179
-
180
- function singleLine(value) {
181
- return String(value).replace(/\s+/g, ' ').trim()
182
- }
183
-
184
- async function* frameData(frames) {
185
- for await (const frame of frames) {
186
- if (frame.data) {
187
- yield frame.data
188
- }
189
- }
190
- }