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

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 (579) hide show
  1. package/CHANGELOG.md +1205 -1
  2. package/README.md +56 -45
  3. package/dist-lib/index.d.ts +3 -2
  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 +20 -2
  8. package/dist-lib/lib/api/agents.js +128 -24
  9. package/dist-lib/lib/api/app-config.d.ts +7 -1
  10. package/dist-lib/lib/api/app-config.js +37 -6
  11. package/dist-lib/lib/api/approval-rules.d.ts +1 -1
  12. package/dist-lib/lib/api/approval-rules.js +12 -5
  13. package/dist-lib/lib/api/attachments.d.ts +1 -1
  14. package/dist-lib/lib/api/attachments.js +14 -2
  15. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  16. package/dist-lib/lib/api/chat-move.js +7 -0
  17. package/dist-lib/lib/api/chat.d.ts +12 -2
  18. package/dist-lib/lib/api/chat.js +100 -9
  19. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  20. package/dist-lib/lib/api/chunk-delta.js +115 -0
  21. package/dist-lib/lib/api/chunks.d.ts +19 -2
  22. package/dist-lib/lib/api/chunks.js +73 -13
  23. package/dist-lib/lib/api/config.d.ts +11 -3
  24. package/dist-lib/lib/api/config.js +51 -5
  25. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  26. package/dist-lib/lib/api/current-mesh.js +15 -11
  27. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  28. package/dist-lib/lib/api/custom-models.js +12 -12
  29. package/dist-lib/lib/api/device-routes.d.ts +14 -0
  30. package/dist-lib/lib/api/device-routes.js +144 -0
  31. package/dist-lib/lib/api/devices.d.ts +3 -2
  32. package/dist-lib/lib/api/devices.js +28 -28
  33. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  34. package/dist-lib/lib/api/diagnostics.js +2 -2
  35. package/dist-lib/lib/api/execution.d.ts +16 -1
  36. package/dist-lib/lib/api/execution.js +72 -16
  37. package/dist-lib/lib/api/files.d.ts +1 -1
  38. package/dist-lib/lib/api/files.js +65 -8
  39. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  40. package/dist-lib/lib/api/host-run-log.js +35 -83
  41. package/dist-lib/lib/api/index.d.ts +39 -7
  42. package/dist-lib/lib/api/index.js +116 -36
  43. package/dist-lib/lib/api/instrument.d.ts +2 -2
  44. package/dist-lib/lib/api/instrument.js +24 -48
  45. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  46. package/dist-lib/lib/api/knowledge.js +25 -7
  47. package/dist-lib/lib/api/local-files.d.ts +5 -1
  48. package/dist-lib/lib/api/local-files.js +9 -5
  49. package/dist-lib/lib/api/logs.js +3 -3
  50. package/dist-lib/lib/api/members.d.ts +10 -1
  51. package/dist-lib/lib/api/members.js +69 -44
  52. package/dist-lib/lib/api/mesh.d.ts +15 -6
  53. package/dist-lib/lib/api/mesh.js +13 -9
  54. package/dist-lib/lib/api/model-download.d.ts +2 -1
  55. package/dist-lib/lib/api/model-download.js +2 -2
  56. package/dist-lib/lib/api/network.d.ts +10 -2
  57. package/dist-lib/lib/api/network.js +8 -2
  58. package/dist-lib/lib/api/notifications.d.ts +3 -1
  59. package/dist-lib/lib/api/notifications.js +14 -9
  60. package/dist-lib/lib/api/projects.d.ts +20 -0
  61. package/dist-lib/lib/api/projects.js +172 -0
  62. package/dist-lib/lib/api/rag-plugin.d.ts +17 -0
  63. package/dist-lib/lib/api/rag-plugin.js +44 -0
  64. package/dist-lib/lib/api/rag.d.ts +0 -1
  65. package/dist-lib/lib/api/rag.js +106 -33
  66. package/dist-lib/lib/api/served.d.ts +17 -0
  67. package/dist-lib/lib/api/served.js +65 -0
  68. package/dist-lib/lib/api/sync.d.ts +2 -1
  69. package/dist-lib/lib/api/sync.js +13 -3
  70. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  71. package/dist-lib/lib/api/tool-activity.js +4 -3
  72. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  73. package/dist-lib/lib/api/tool-configs.js +6 -9
  74. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  75. package/dist-lib/lib/api/upload-frames.js +0 -1
  76. package/dist-lib/lib/api/watchable.d.ts +3 -2
  77. package/dist-lib/lib/api/watchable.js +2 -3
  78. package/dist-lib/lib/api/workspace.d.ts +12 -0
  79. package/dist-lib/lib/api/workspace.js +61 -0
  80. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  81. package/dist-lib/lib/assistant/fake-models.js +112 -0
  82. package/dist-lib/lib/assistant/harness.d.ts +48 -31
  83. package/dist-lib/lib/assistant/harness.js +51 -10
  84. package/dist-lib/lib/assistant/history.d.ts +37 -17
  85. package/dist-lib/lib/assistant/history.js +212 -87
  86. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  87. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  88. package/dist-lib/lib/assistant/media-round.d.ts +61 -0
  89. package/dist-lib/lib/assistant/media-round.js +111 -0
  90. package/dist-lib/lib/assistant/message.d.ts +28 -1
  91. package/dist-lib/lib/assistant/message.js +65 -2
  92. package/dist-lib/lib/assistant/model-round.d.ts +118 -0
  93. package/dist-lib/lib/assistant/model-round.js +706 -0
  94. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  95. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  96. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  97. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  98. package/dist-lib/lib/assistant/round-host.d.ts +65 -0
  99. package/dist-lib/lib/assistant/round-host.js +332 -0
  100. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  101. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  102. package/dist-lib/lib/assistant/upload.d.ts +12 -0
  103. package/dist-lib/lib/assistant/upload.js +36 -0
  104. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  105. package/dist-lib/lib/assistant/video-budget.js +29 -0
  106. package/dist-lib/lib/assistant-client.d.ts +5 -1
  107. package/dist-lib/lib/assistant-client.js +54 -14
  108. package/dist-lib/lib/assistant-tree.d.ts +14 -3
  109. package/dist-lib/lib/assistant-tree.js +113 -21
  110. package/dist-lib/lib/assistant.d.ts +115 -25
  111. package/dist-lib/lib/assistant.js +2409 -1245
  112. package/dist-lib/lib/audio-format.js +1 -1
  113. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  114. package/dist-lib/lib/chat-suggestion.js +47 -0
  115. package/dist-lib/lib/client.d.ts +3 -2
  116. package/dist-lib/lib/client.js +18 -3
  117. package/dist-lib/lib/compaction.d.ts +3 -1
  118. package/dist-lib/lib/compaction.js +20 -6
  119. package/dist-lib/lib/constants.d.ts +10 -0
  120. package/dist-lib/lib/constants.js +10 -0
  121. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  122. package/dist-lib/lib/core/agent-copies.js +47 -0
  123. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  124. package/dist-lib/lib/core/agent-hosting.js +76 -0
  125. package/dist-lib/lib/core/agent.d.ts +9 -1
  126. package/dist-lib/lib/core/agent.js +58 -63
  127. package/dist-lib/lib/core/approval-rules.d.ts +5 -1
  128. package/dist-lib/lib/core/approval-rules.js +17 -9
  129. package/dist-lib/lib/core/archived-mesh.d.ts +14 -7
  130. package/dist-lib/lib/core/archived-mesh.js +75 -59
  131. package/dist-lib/lib/core/async-iterable.js +1 -1
  132. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  133. package/dist-lib/lib/core/blind-peers.js +1 -0
  134. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  135. package/dist-lib/lib/core/chat-activity.js +45 -34
  136. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  137. package/dist-lib/lib/core/chat-copy.js +404 -0
  138. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  139. package/dist-lib/lib/core/chat-fork.js +246 -0
  140. package/dist-lib/lib/core/chat-group.js +10 -22
  141. package/dist-lib/lib/core/chat-move.d.ts +77 -0
  142. package/dist-lib/lib/core/chat-move.js +601 -0
  143. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  144. package/dist-lib/lib/core/chat-order.js +28 -19
  145. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  146. package/dist-lib/lib/core/chat-read.js +49 -0
  147. package/dist-lib/lib/core/chat-search.js +14 -12
  148. package/dist-lib/lib/core/chat.d.ts +32 -4
  149. package/dist-lib/lib/core/chat.js +135 -61
  150. package/dist-lib/lib/core/chunk.d.ts +35 -7
  151. package/dist-lib/lib/core/chunk.js +271 -72
  152. package/dist-lib/lib/core/collections.d.ts +41 -1
  153. package/dist-lib/lib/core/collections.js +41 -1
  154. package/dist-lib/lib/core/config-value.d.ts +7 -0
  155. package/dist-lib/lib/core/config-value.js +15 -0
  156. package/dist-lib/lib/core/contract/activity.d.ts +7 -2
  157. package/dist-lib/lib/core/contract/activity.js +71 -23
  158. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  159. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  160. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  161. package/dist-lib/lib/core/contract/agents.js +142 -3
  162. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  163. package/dist-lib/lib/core/contract/chat.js +53 -3
  164. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  165. package/dist-lib/lib/core/contract/chunks.js +125 -38
  166. package/dist-lib/lib/core/contract/devices.js +6 -4
  167. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  168. package/dist-lib/lib/core/contract/index.js +38 -11
  169. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  170. package/dist-lib/lib/core/contract/indexing.js +51 -7
  171. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  172. package/dist-lib/lib/core/contract/invites.js +26 -36
  173. package/dist-lib/lib/core/contract/joined-meshes.js +4 -1
  174. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  175. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  176. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  177. package/dist-lib/lib/core/contract/members.js +48 -12
  178. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  179. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  180. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  181. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  182. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  183. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  184. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  185. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  186. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  187. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  188. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  189. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  190. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  191. package/dist-lib/lib/core/contract/open-join.js +77 -0
  192. package/dist-lib/lib/core/contract/project-device-keys.d.ts +9 -0
  193. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  194. package/dist-lib/lib/core/contract/project-host-keys.d.ts +9 -0
  195. package/dist-lib/lib/core/contract/project-host-keys.js +52 -0
  196. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  197. package/dist-lib/lib/core/contract/project-order.js +25 -0
  198. package/dist-lib/lib/core/contract/projects.d.ts +23 -0
  199. package/dist-lib/lib/core/contract/projects.js +339 -0
  200. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  201. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  202. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  203. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  204. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  205. package/dist-lib/lib/core/contract/roles.js +123 -0
  206. package/dist-lib/lib/core/contract/run-requests.d.ts +11 -0
  207. package/dist-lib/lib/core/contract/run-requests.js +114 -0
  208. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  209. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  210. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  211. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  212. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  213. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  214. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  215. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  216. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  217. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  218. package/dist-lib/lib/core/contract/workspace.js +311 -0
  219. package/dist-lib/lib/core/contract/writers.js +100 -16
  220. package/dist-lib/lib/core/deleted-agent-runs.d.ts +8 -0
  221. package/dist-lib/lib/core/deleted-agent-runs.js +57 -0
  222. package/dist-lib/lib/core/departures.d.ts +18 -5
  223. package/dist-lib/lib/core/departures.js +82 -6
  224. package/dist-lib/lib/core/device-control.d.ts +21 -0
  225. package/dist-lib/lib/core/device-control.js +91 -0
  226. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  227. package/dist-lib/lib/core/device-seal.js +22 -0
  228. package/dist-lib/lib/core/devices.d.ts +2 -1
  229. package/dist-lib/lib/core/devices.js +6 -11
  230. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  231. package/dist-lib/lib/core/document-attachment.js +14 -0
  232. package/dist-lib/lib/core/files/attachments.d.ts +2 -0
  233. package/dist-lib/lib/core/files/attachments.js +23 -7
  234. package/dist-lib/lib/core/files/index.d.ts +28 -15
  235. package/dist-lib/lib/core/files/index.js +222 -43
  236. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  237. package/dist-lib/lib/core/files/knowledge.js +77 -5
  238. package/dist-lib/lib/core/files/preview/index.js +6 -2
  239. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  240. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  241. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  242. package/dist-lib/lib/core/files/processing/document.js +26 -2
  243. package/dist-lib/lib/core/files/processing/index.d.ts +12 -3
  244. package/dist-lib/lib/core/files/processing/index.js +122 -73
  245. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  246. package/dist-lib/lib/core/files/processing/protocol.js +27 -37
  247. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  248. package/dist-lib/lib/core/files/processing/source.js +12 -4
  249. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  250. package/dist-lib/lib/core/files/processing/state.js +9 -1
  251. package/dist-lib/lib/core/files/rag/build.d.ts +15 -2
  252. package/dist-lib/lib/core/files/rag/build.js +119 -21
  253. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  254. package/dist-lib/lib/core/files/rag/failure.js +58 -0
  255. package/dist-lib/lib/core/files/rag/index.d.ts +21 -5
  256. package/dist-lib/lib/core/files/rag/index.js +38 -9
  257. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  258. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  259. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  260. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  261. package/dist-lib/lib/core/files/rag/load.d.ts +3 -3
  262. package/dist-lib/lib/core/files/rag/load.js +6 -3
  263. package/dist-lib/lib/core/files/rag/plugin-index.d.ts +32 -0
  264. package/dist-lib/lib/core/files/rag/plugin-index.js +120 -0
  265. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  266. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  267. package/dist-lib/lib/core/files/rag/produce.d.ts +3 -4
  268. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  269. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  270. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  271. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  272. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  273. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  274. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  275. package/dist-lib/lib/core/files/records/index.js +1 -1
  276. package/dist-lib/lib/core/files/records/knowledge.d.ts +12 -4
  277. package/dist-lib/lib/core/files/records/knowledge.js +34 -30
  278. package/dist-lib/lib/core/files/records/purge.js +13 -8
  279. package/dist-lib/lib/core/files/records/reclaim.js +21 -55
  280. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  281. package/dist-lib/lib/core/files/records/routing.js +6 -2
  282. package/dist-lib/lib/core/files/records/source.js +3 -5
  283. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  284. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  285. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  286. package/dist-lib/lib/core/files/store/blob.js +2 -2
  287. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  288. package/dist-lib/lib/core/files/store/index.js +4 -1
  289. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  290. package/dist-lib/lib/core/files/store/reference.js +12 -2
  291. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  292. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  293. package/dist-lib/lib/core/files/upload.js +117 -51
  294. package/dist-lib/lib/core/first-event.d.ts +6 -0
  295. package/dist-lib/lib/core/first-event.js +13 -0
  296. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  297. package/dist-lib/lib/core/fs-drives.js +35 -35
  298. package/dist-lib/lib/core/helpers/index.d.ts +1 -1
  299. package/dist-lib/lib/core/helpers/index.js +2 -2
  300. package/dist-lib/lib/core/id.d.ts +1 -0
  301. package/dist-lib/lib/core/id.js +3 -0
  302. package/dist-lib/lib/core/identity.d.ts +3 -1
  303. package/dist-lib/lib/core/identity.js +25 -4
  304. package/dist-lib/lib/core/invite.d.ts +6 -2
  305. package/dist-lib/lib/core/invite.js +22 -8
  306. package/dist-lib/lib/core/local/files.d.ts +2 -1
  307. package/dist-lib/lib/core/local/files.js +5 -7
  308. package/dist-lib/lib/core/local/index.d.ts +93 -8
  309. package/dist-lib/lib/core/local/index.js +327 -28
  310. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  311. package/dist-lib/lib/core/local/run-logs.js +132 -0
  312. package/dist-lib/lib/core/member-key.d.ts +7 -0
  313. package/dist-lib/lib/core/member-key.js +24 -0
  314. package/dist-lib/lib/core/membership.d.ts +3 -14
  315. package/dist-lib/lib/core/membership.js +3 -96
  316. package/dist-lib/lib/core/mesh.d.ts +132 -29
  317. package/dist-lib/lib/core/mesh.js +775 -215
  318. package/dist-lib/lib/core/migrations/agent-catalog.js +2 -8
  319. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  320. package/dist-lib/lib/core/migrations/agent-tools-scope.js +18 -0
  321. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  322. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  323. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  324. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  325. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  326. package/dist-lib/lib/core/migrations/index.js +69 -8
  327. package/dist-lib/lib/core/migrations/writer-links.d.ts +3 -0
  328. package/dist-lib/lib/core/migrations/writer-links.js +30 -0
  329. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  330. package/dist-lib/lib/core/model-requests.js +65 -0
  331. package/dist-lib/lib/core/next-frame.js +2 -1
  332. package/dist-lib/lib/core/notification.js +100 -25
  333. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  334. package/dist-lib/lib/core/pdf/figure.js +64 -0
  335. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  336. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  337. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  338. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  339. package/dist-lib/lib/core/project-keys.d.ts +16 -0
  340. package/dist-lib/lib/core/project-keys.js +65 -0
  341. package/dist-lib/lib/core/prompt-history.js +4 -4
  342. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  343. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  344. package/dist-lib/lib/core/public-mesh.d.ts +25 -0
  345. package/dist-lib/lib/core/public-mesh.js +81 -0
  346. package/dist-lib/lib/core/purge.d.ts +3 -0
  347. package/dist-lib/lib/core/purge.js +7 -0
  348. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  349. package/dist-lib/lib/core/run-driver.js +20 -0
  350. package/dist-lib/lib/core/run-requests.d.ts +14 -0
  351. package/dist-lib/lib/core/run-requests.js +78 -0
  352. package/dist-lib/lib/core/send.d.ts +2 -0
  353. package/dist-lib/lib/core/send.js +17 -4
  354. package/dist-lib/lib/core/senders.d.ts +19 -0
  355. package/dist-lib/lib/core/senders.js +45 -0
  356. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  357. package/dist-lib/lib/core/shared-agents.js +283 -0
  358. package/dist-lib/lib/core/skill-availability.d.ts +33 -0
  359. package/dist-lib/lib/core/skill-availability.js +67 -0
  360. package/dist-lib/lib/core/skill-secrets.d.ts +13 -18
  361. package/dist-lib/lib/core/skill-secrets.js +93 -72
  362. package/dist-lib/lib/core/sync/background.d.ts +34 -0
  363. package/dist-lib/lib/core/sync/background.js +86 -0
  364. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  365. package/dist-lib/lib/core/sync/changed.js +7 -0
  366. package/dist-lib/lib/core/sync/devices.js +6 -3
  367. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  368. package/dist-lib/lib/core/sync/files.js +50 -72
  369. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  370. package/dist-lib/lib/core/sync/index.js +193 -81
  371. package/dist-lib/lib/core/sync/view-updates.d.ts +39 -0
  372. package/dist-lib/lib/core/sync/view-updates.js +124 -0
  373. package/dist-lib/lib/core/sync-status.js +99 -43
  374. package/dist-lib/lib/core/system-info.d.ts +2 -2
  375. package/dist-lib/lib/core/system-info.js +10 -11
  376. package/dist-lib/lib/core/tool-activity.js +6 -12
  377. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  378. package/dist-lib/lib/core/tool-configs.js +27 -39
  379. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  380. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  381. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  382. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  383. package/dist-lib/lib/core/upgrade-summary.d.ts +19 -0
  384. package/dist-lib/lib/core/upgrade-summary.js +67 -0
  385. package/dist-lib/lib/core/vault-managed-skills.d.ts +18 -0
  386. package/dist-lib/lib/core/vault-managed-skills.js +105 -0
  387. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  388. package/dist-lib/lib/core/video/attachment.js +7 -0
  389. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  390. package/dist-lib/lib/core/video/digest.js +57 -0
  391. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  392. package/dist-lib/lib/core/video/frames.js +224 -0
  393. package/dist-lib/lib/core/view-read.d.ts +4 -0
  394. package/dist-lib/lib/core/view-read.js +23 -0
  395. package/dist-lib/lib/core/workspace-upgrade.d.ts +23 -0
  396. package/dist-lib/lib/core/workspace-upgrade.js +51 -0
  397. package/dist-lib/lib/core.d.ts +345 -88
  398. package/dist-lib/lib/core.js +4275 -1513
  399. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  400. package/dist-lib/lib/credential-pusher.js +111 -62
  401. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  402. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  403. package/dist-lib/lib/custom-model-task.js +2 -2
  404. package/dist-lib/lib/device-tree.d.ts +18 -0
  405. package/dist-lib/lib/device-tree.js +32 -0
  406. package/dist-lib/lib/diagnostics.d.ts +7 -0
  407. package/dist-lib/lib/diagnostics.js +22 -0
  408. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  409. package/dist-lib/lib/doctor/checks.js +272 -0
  410. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  411. package/dist-lib/lib/doctor/redact.js +31 -0
  412. package/dist-lib/lib/doctor/render.d.ts +8 -0
  413. package/dist-lib/lib/doctor/render.js +83 -0
  414. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  415. package/dist-lib/lib/doctor/tree.js +167 -0
  416. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  417. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  418. package/dist-lib/lib/errors.d.ts +814 -0
  419. package/dist-lib/lib/errors.js +748 -0
  420. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  421. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  422. package/dist-lib/lib/guards.d.ts +1 -0
  423. package/dist-lib/lib/guards.js +4 -0
  424. package/dist-lib/lib/inference-calls.d.ts +1 -2
  425. package/dist-lib/lib/inference-calls.js +2 -10
  426. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  427. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  428. package/dist-lib/lib/knowledge-search.js +5 -51
  429. package/dist-lib/lib/kv-cache-ledger.d.ts +22 -0
  430. package/dist-lib/lib/kv-cache-ledger.js +72 -0
  431. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  432. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  433. package/dist-lib/lib/kv-cache-retention.d.ts +36 -0
  434. package/dist-lib/lib/kv-cache-retention.js +101 -0
  435. package/dist-lib/lib/latest-frame.d.ts +10 -0
  436. package/dist-lib/lib/latest-frame.js +48 -0
  437. package/dist-lib/lib/llm-model-names.d.ts +1 -1
  438. package/dist-lib/lib/llm-model-names.js +1 -1
  439. package/dist-lib/lib/log.d.ts +7 -6
  440. package/dist-lib/lib/log.js +14 -7
  441. package/dist-lib/lib/logger-type.d.ts +2 -5
  442. package/dist-lib/lib/mesh-scoped-engine.js +47 -2
  443. package/dist-lib/lib/model-context.js +1 -2
  444. package/dist-lib/lib/model-download-status.d.ts +3 -3
  445. package/dist-lib/lib/model-download.d.ts +22 -13
  446. package/dist-lib/lib/model-download.js +106 -37
  447. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  448. package/dist-lib/lib/model-memory-cap.d.ts +30 -0
  449. package/dist-lib/lib/model-memory-cap.js +78 -0
  450. package/dist-lib/lib/models-watch.d.ts +1 -1
  451. package/dist-lib/lib/models-watch.js +4 -4
  452. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  453. package/dist-lib/lib/oauth/flow-core.js +5 -3
  454. package/dist-lib/lib/oauth/flow.js +1 -1
  455. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  456. package/dist-lib/lib/oauth/loopback.js +57 -12
  457. package/dist-lib/lib/oauth/providers.js +4 -2
  458. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  459. package/dist-lib/lib/oauth/register.js +35 -19
  460. package/dist-lib/lib/oauth/request.d.ts +10 -0
  461. package/dist-lib/lib/oauth/request.js +22 -0
  462. package/dist-lib/lib/oauth/resolve.js +42 -13
  463. package/dist-lib/lib/oauth/token-exchange-core.js +40 -31
  464. package/dist-lib/lib/oauth/types.d.ts +3 -0
  465. package/dist-lib/lib/oauth.d.ts +2 -1
  466. package/dist-lib/lib/oauth.js +1 -0
  467. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  468. package/dist-lib/lib/persistent-dir.js +9 -0
  469. package/dist-lib/lib/probe-rounds.d.ts +8 -0
  470. package/dist-lib/lib/probe-rounds.js +10 -0
  471. package/dist-lib/lib/reconnecting-watch.js +19 -11
  472. package/dist-lib/lib/run-input.d.ts +14 -0
  473. package/dist-lib/lib/run-input.js +33 -0
  474. package/dist-lib/lib/run-notices.d.ts +5 -0
  475. package/dist-lib/lib/run-notices.js +13 -2
  476. package/dist-lib/lib/run-replay.d.ts +45 -0
  477. package/dist-lib/lib/run-replay.js +169 -0
  478. package/dist-lib/lib/run-transcript.d.ts +13 -12
  479. package/dist-lib/lib/run-transcript.js +20 -19
  480. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  481. package/dist-lib/lib/task.js +6 -4
  482. package/dist-lib/lib/test-env.d.ts +1 -0
  483. package/dist-lib/lib/test-env.js +4 -0
  484. package/dist-lib/schema/build.js +66 -55
  485. package/dist-lib/schema/config.d.ts +1 -1
  486. package/dist-lib/schema/config.js +1 -1
  487. package/dist-lib/schema/content.d.ts +5 -1
  488. package/dist-lib/schema/content.js +60 -12
  489. package/dist-lib/schema/engine.d.ts +1 -0
  490. package/dist-lib/schema/engine.js +941 -152
  491. package/dist-lib/schema/field-order.js +8 -1
  492. package/dist-lib/schema/indexes.d.ts +10 -0
  493. package/dist-lib/schema/indexes.js +53 -3
  494. package/dist-lib/schema/local.js +83 -5
  495. package/dist-lib/schema/qvac.d.ts +4 -1
  496. package/dist-lib/schema/qvac.js +558 -16
  497. package/dist-lib/spec/bind.js +261 -48
  498. package/dist-lib/spec/calls.js +56 -5
  499. package/dist-lib/spec/capabilities.d.ts +129 -20
  500. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  501. package/dist-lib/spec/hrpc/hrpc.json +870 -207
  502. package/dist-lib/spec/hrpc/index.js +969 -347
  503. package/dist-lib/spec/hrpc/messages.js +7590 -4896
  504. package/dist-lib/spec/hyperschema/index.js +7590 -4896
  505. package/dist-lib/spec/hyperschema/schema.json +5316 -3224
  506. package/dist-lib/spec/hyperschema/types.d.ts +576 -62
  507. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  508. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  509. package/dist-lib/spec/local/hyperdb/messages.js +1588 -488
  510. package/dist-lib/spec/local/hyperschema/index.js +584 -16
  511. package/dist-lib/spec/local/hyperschema/schema.json +369 -1
  512. package/dist-lib/spec/local/hyperschema/types.d.ts +88 -2
  513. package/dist-lib/spec/mesh/hyperdb/db.json +711 -9
  514. package/dist-lib/spec/mesh/hyperdb/index.js +2769 -7
  515. package/dist-lib/spec/mesh/hyperdb/messages.js +7140 -1298
  516. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +205 -1
  517. package/dist-lib/spec/mesh/hyperdispatch/index.js +579 -1
  518. package/dist-lib/spec/mesh/hyperdispatch/messages.js +4017 -267
  519. package/dist-lib/spec/mesh/hyperschema/index.js +4017 -267
  520. package/dist-lib/spec/mesh/hyperschema/schema.json +2193 -19
  521. package/dist-lib/spec/mesh/hyperschema/types.d.ts +550 -6
  522. package/package.json +136 -90
  523. package/tui/README.md +119 -20
  524. package/tui/app.mjs +2000 -621
  525. package/tui/boot.mjs +76 -9
  526. package/tui/cli.mjs +93 -0
  527. package/tui/index.mjs +2 -51
  528. package/tui/lib/connect-sheet.mjs +350 -0
  529. package/tui/lib/device-target.mjs +64 -0
  530. package/tui/lib/folders-command.mjs +84 -0
  531. package/tui/lib/fork-command.mjs +43 -0
  532. package/tui/lib/knowledge-import.mjs +3 -21
  533. package/tui/lib/local-path.mjs +21 -0
  534. package/tui/lib/move-command.mjs +17 -0
  535. package/tui/lib/render.mjs +30 -1
  536. package/tui/lib/setup.mjs +59 -25
  537. package/tui/lib/skill-connect.mjs +145 -0
  538. package/tui/lib/updater.mjs +86 -0
  539. package/tui/main.mjs +44 -18
  540. package/tui/plugins.mjs +158 -0
  541. package/worker/assistant-sidecar.mjs +28 -4
  542. package/worker/stow-entry.mjs +3 -50
  543. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  544. package/dist-lib/lib/core/contract/compute.js +0 -48
  545. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  546. package/dist-lib/lib/core/device-invites.js +0 -63
  547. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  548. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  549. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  550. package/dist-lib/lib/core/grant-expiry.js +0 -66
  551. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  552. package/dist-lib/lib/core/handoff-channel.js +0 -123
  553. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  554. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  555. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  556. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  557. package/dist-lib/lib/core/hosted-agents.js +0 -140
  558. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  559. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  560. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  561. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  562. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  563. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  564. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  565. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  566. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  567. package/dist-lib/lib/core/secret-handoff.js +0 -29
  568. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  569. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  570. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  571. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  572. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  573. package/dist-lib/lib/image-cache-dir.js +0 -5
  574. package/dist-lib/lib/log-levels.d.ts +0 -7
  575. package/dist-lib/lib/log-levels.js +0 -1
  576. package/dist-lib/lib/logger.d.ts +0 -5
  577. package/dist-lib/lib/logger.js +0 -18
  578. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  579. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
package/tui/boot.mjs CHANGED
@@ -5,16 +5,35 @@ import process from 'bare-process'
5
5
  import { fileURLToPath } from 'bare-url'
6
6
  import path from 'path'
7
7
  import { Client } from '../dist-lib/lib/client.js'
8
+ import { decodeMeshInvite } from '../dist-lib/lib/core/invite.js'
8
9
  import { Logger, toLoggerOptions } from '../dist-lib/lib/log.js'
9
10
  import { configureSdkStorage } from '@qvac/harness/sdk-storage'
10
11
  import { MODEL_CACHE_PATH_ENV, releaseChannel, resolveStorage } from '@qvac/harness/storage'
11
12
  import sidecarRunner from 'bare-supervisor/runner/sidecar'
12
- import { skillsDir } from '@qvac/skills'
13
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}`)
14
+ async function resolvePaths(entries) {
15
+ if (entries) {
16
+ return {
17
+ // make stages the skills tree beside release.json
18
+ skillsDir: path.join(path.dirname(fileURLToPath(entries.release)), 'skills'),
19
+ harnessEntry: fileURLToPath(entries.harness),
20
+ sidecarEntry: fileURLToPath(entries.sidecar)
21
+ }
22
+ }
23
+
24
+ const harnessSpecifier = '@qvac/harness/worker/stow-entry.mjs'
25
+ const sidecarEntry = fileURLToPath(new URL('../worker/stow-entry.mjs', import.meta.url))
26
+ if (!fs.existsSync(sidecarEntry)) {
27
+ throw new Error(`assistant sidecar entry missing at ${sidecarEntry}`)
28
+ }
29
+
30
+ return {
31
+ // imported here, as at load it reads a path from import.meta.url, which a bundle does not have
32
+ skillsDir: (await import('@qvac/skills')).skillsDir,
33
+ // a variable, as bare-pack follows a literal and would bundle the harness graph into duck again
34
+ harnessEntry: fileURLToPath(import.meta.resolve(harnessSpecifier)),
35
+ sidecarEntry
36
+ }
18
37
  }
19
38
 
20
39
  // its stdout/stderr are pipes so native model logs reach the logger rather than this tty
@@ -35,13 +54,55 @@ async function startSidecar({ entry, config, logger }) {
35
54
  return {
36
55
  engine,
37
56
  close: () => engine.close(),
38
- skills: async (agentId, modelName, meshId) =>
39
- (await engine.skills({ agentId, modelName, meshId })).skills ?? []
57
+ skills: async (agentId, { modelName, meshId, refresh = false }) =>
58
+ (await engine.skills({ agentId, modelName, meshId, refresh })).skills ?? []
40
59
  }
41
60
  }
42
61
 
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) {
62
+ // --join adds a mesh as a new member, --device-join pairs this device into the inviter's account
63
+ function bootInvite({ join, deviceJoin }) {
64
+ if (join && deviceJoin) {
65
+ throw new Error('pass --join or --device-join, not both')
66
+ }
67
+
68
+ const raw = join || deviceJoin
69
+ if (!raw) {
70
+ return null
71
+ }
72
+
73
+ const invite = decodeMeshInvite(raw)
74
+ if (!invite) {
75
+ throw new Error('not a mesh invite: expected qvac://device/… or qvac://workspace/…')
76
+ }
77
+
78
+ if (join && !invite.memberInvite) {
79
+ throw new Error('that is a device invite: use --device-join, or ask for /invite member')
80
+ }
81
+
82
+ if (deviceJoin && invite.memberInvite) {
83
+ throw new Error('that is a member invite: use --join')
84
+ }
85
+
86
+ return raw
87
+ }
88
+
89
+ // joinMesh returns with the handshake under way, and the invite asked for next needs it done
90
+ async function joined(engine) {
91
+ for await (const { state, error } of engine.meshStatusWatch({})) {
92
+ if (state === 'joined') {
93
+ return
94
+ }
95
+
96
+ if (state === 'error' || state === 'kicked') {
97
+ throw new Error(error || `the join ended ${state}`)
98
+ }
99
+ }
100
+ }
101
+
102
+ // --join and --device-join are the headless way in, /join the interactive one
103
+ export async function boot(args, entries = null) {
104
+ const joining = bootInvite(args)
105
+ const { skillsDir, harnessEntry, sidecarEntry } = await resolvePaths(entries)
45
106
  const connectStart = Date.now()
46
107
  // only an explicit QVAC_MODEL overrides, or resuming a shared mesh rewrites the desktop's agent
47
108
  const modelOverride = process.env.QVAC_MODEL || null
@@ -80,6 +141,7 @@ export async function boot(args) {
80
141
  },
81
142
  skillsDir,
82
143
  harnessEntry,
144
+ fakeModels: args.fakeModels || process.env.QVAC_FAKE_MODELS === '1',
83
145
  // only the image keys cross: the arg is argv, readable by anything that can list processes
84
146
  imageEnv: Object.fromEntries(
85
147
  Object.entries(process.env).filter(([key]) => key.startsWith('QVAC_IMAGE_'))
@@ -94,6 +156,11 @@ export async function boot(args) {
94
156
  })
95
157
  // the device id is its public key: the raw 32-byte buffer end to end, never a hex string
96
158
  const deviceId = (await engine.deviceInfo({})).id
159
+ if (joining) {
160
+ await engine.joinMesh({ invite: joining })
161
+ await joined(engine)
162
+ }
163
+
97
164
  const meshInvite = (await engine.meshInvite({})).invite ?? null
98
165
 
99
166
  return {
package/tui/cli.mjs ADDED
@@ -0,0 +1,93 @@
1
+ import fs from 'bare-fs'
2
+ import path from 'path'
3
+ import { fileURLToPath } from 'bare-url'
4
+ import { arg, command, description, flag, summary } from 'paparam'
5
+
6
+ const pluginsCommand = (name, info, ...modifiers) =>
7
+ command(name, summary(info), ...modifiers, async ({ args }) => {
8
+ const api = await import('./plugins.mjs')
9
+ try {
10
+ await api[name](...Object.values(args))
11
+ } catch (err) {
12
+ console.error(err.message)
13
+ Bare.exitCode = 1
14
+ }
15
+ })
16
+
17
+ const plugins = command(
18
+ 'plugins',
19
+ summary('list, enable, disable and install userland plugins in ~/.config/qv-ac'),
20
+ pluginsCommand('list', 'installed plugins and whether config.json loads them'),
21
+ pluginsCommand('enable', 'list a plugin in config.json', arg('<name>', 'plugin folder name')),
22
+ pluginsCommand(
23
+ 'disable',
24
+ 'drop a plugin from config.json, keeping its options',
25
+ arg('<name>', 'plugin folder name')
26
+ ),
27
+ pluginsCommand(
28
+ 'install',
29
+ 'fetch a plugin folder from a git URL or a hyper:// drive key',
30
+ arg('<source>', 'git URL or hyper://<key>'),
31
+ arg('[name]', 'folder name; defaults to the repo name, required for hyper://')
32
+ )
33
+ )
34
+
35
+ const cmd = command(
36
+ 'duck',
37
+ summary('the qvac assistant in your terminal'),
38
+ description(
39
+ "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."
40
+ ),
41
+ flag('--storage|-s [dir]', 'a self-contained root, its own corestore and SDK home'),
42
+ flag('--temp', 'the same, in a throwaway dir'),
43
+ flag('--headless', 'no TUI: print the device invite and stream logs until ctrl+C'),
44
+ flag('--join|-j <invite>', 'join a mesh as a new member at boot (a member invite)'),
45
+ flag(
46
+ '--device-join <invite>',
47
+ 'pair this device into the inviter’s account at boot (a device invite)'
48
+ ),
49
+ flag('--fake-models', 'adds the quack model: a deterministic fake LLM for testing without AI'),
50
+ flag('--version|-v', 'versions of core, harness and the SDK'),
51
+ plugins
52
+ )
53
+
54
+ function versions(entries) {
55
+ const resolved = entries
56
+ ? Object.entries(JSON.parse(fs.readFileSync(fileURLToPath(entries.release), 'utf8')).versions)
57
+ : [
58
+ ['@qvac/core', packageVersion(fileURLToPath(new URL('../package.json', import.meta.url)))],
59
+ ['@qvac/harness', resolvedVersion('@qvac/harness')],
60
+ ['@qvac/sdk', resolvedVersion('@qvac/sdk')]
61
+ ]
62
+
63
+ return resolved.map(([name, version]) => `${name.padEnd(14)} ${version}`).join('\n')
64
+ }
65
+
66
+ function resolvedVersion(specifier) {
67
+ const entry = fileURLToPath(import.meta.resolve(specifier))
68
+ for (let dir = path.dirname(entry); dir !== path.dirname(dir); dir = path.dirname(dir)) {
69
+ const manifest = path.join(dir, 'package.json')
70
+ if (fs.existsSync(manifest)) {
71
+ return packageVersion(manifest)
72
+ }
73
+ }
74
+
75
+ return 'unknown'
76
+ }
77
+
78
+ function packageVersion(manifest) {
79
+ return JSON.parse(fs.readFileSync(manifest, 'utf8')).version
80
+ }
81
+
82
+ export async function cli({ argv, standalone = false, entries = null } = {}) {
83
+ const parsed = cmd.parse(argv)
84
+ if (parsed !== cmd) {
85
+ return
86
+ }
87
+
88
+ if (parsed.flags.version) {
89
+ console.log(versions(entries))
90
+ } else {
91
+ ;(await import('./main.mjs')).main(parsed.flags, { standalone, entries })
92
+ }
93
+ }
package/tui/index.mjs CHANGED
@@ -1,53 +1,4 @@
1
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'
2
+ import { cli } from './cli.mjs'
6
3
 
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
- }
4
+ await cli()
@@ -0,0 +1,350 @@
1
+ // the form a skill is set up through: its routes, the fields each asks for, and how it draws
2
+ import { isReady, statusLabel } from './setup.mjs'
3
+
4
+ const MASK_CAP = 24
5
+
6
+ const CONNECTED = {
7
+ oauth: 'connected — fill this in again to change it',
8
+ token: 'connected — fill this in again to change it',
9
+ picker: 'set — pick another folder to change it',
10
+ install: 'installed',
11
+ instructions: 'ready'
12
+ }
13
+
14
+ export function openSheet(skill, { routes, enable = false, field = null }) {
15
+ const sheet = {
16
+ skill,
17
+ routes,
18
+ route: firstRoute(routes, field),
19
+ cursor: Math.max(
20
+ 0,
21
+ routes.findIndex((route) => !route.satisfied && route.credentialKey)
22
+ ),
23
+ focus: 0,
24
+ values: {},
25
+ revealed: false,
26
+ enable,
27
+ phase: 'edit',
28
+ attempt: 0,
29
+ stage: null,
30
+ url: null,
31
+ error: null,
32
+ oauth: null
33
+ }
34
+ if (field) {
35
+ focusField(sheet, field)
36
+ }
37
+
38
+ return sheet
39
+ }
40
+
41
+ // a named field opens the route that holds it; several routes otherwise start on the picker
42
+ function firstRoute(routes, field) {
43
+ const holding = field ? routes.findIndex((route) => hasField(route, field)) : -1
44
+ if (holding >= 0) {
45
+ return holding
46
+ }
47
+
48
+ return routes.length === 1 ? 0 : null
49
+ }
50
+
51
+ export function hasField(route, key) {
52
+ return routeFields(route).some((field) => field.key === key)
53
+ }
54
+
55
+ export function currentRoute(sheet) {
56
+ return sheet.route === null ? null : sheet.routes[sheet.route]
57
+ }
58
+
59
+ export function pickRoute(sheet, index) {
60
+ sheet.route = index
61
+ sheet.focus = 0
62
+ sheet.values = {}
63
+ sheet.error = null
64
+ }
65
+
66
+ export function sheetFields(sheet) {
67
+ const route = currentRoute(sheet)
68
+ return route ? routeFields(route) : []
69
+ }
70
+
71
+ // a picker is one path; a token route without fields still takes its own key
72
+ export function routeFields(route) {
73
+ if (route.kind === 'picker') {
74
+ return [{ key: route.credentialKey, label: 'Folder', placeholder: '~/path/to/folder' }]
75
+ }
76
+
77
+ if (route.kind === 'token' && !route.fields?.length) {
78
+ return [{ key: route.credentialKey, label: route.credentialKey, secret: true }]
79
+ }
80
+
81
+ return route.kind === 'oauth' || route.kind === 'token' ? [...(route.fields ?? [])] : []
82
+ }
83
+
84
+ // every sheet can be left from its own buttons, not only by a key named in the header
85
+ export function sheetButtons(sheet) {
86
+ const route = currentRoute(sheet)
87
+ if (!route) {
88
+ return []
89
+ }
90
+
91
+ if (sheet.phase === 'waiting') {
92
+ return [{ id: 'cancel', label: 'Cancel sign-in' }]
93
+ }
94
+
95
+ return [...actionButtons(sheet, route), { id: 'cancel', label: 'Cancel' }]
96
+ }
97
+
98
+ function actionButtons(sheet, route) {
99
+ const connected = isConnected(sheet)
100
+ const remove = connected && route.credentialKey ? [{ id: 'disconnect', label: 'Disconnect' }] : []
101
+ if (route.kind === 'oauth') {
102
+ return [{ id: 'connect', label: connected ? 'Reconnect' : 'Connect' }, ...remove]
103
+ }
104
+
105
+ if (route.kind === 'token' || route.kind === 'picker') {
106
+ return [{ id: 'save', label: 'Save' }, ...remove]
107
+ }
108
+
109
+ return [{ id: 'check', label: route.kind === 'install' ? 'Check again' : 'Done' }]
110
+ }
111
+
112
+ // with several ways in, the skill being ready says nothing about the one on screen
113
+ export function isConnected(sheet) {
114
+ const route = currentRoute(sheet)
115
+ if (route?.satisfied === true) {
116
+ return true
117
+ }
118
+
119
+ return sheet.routes.length === 1 && isReady(sheet.skill)
120
+ }
121
+
122
+ export function focused(sheet) {
123
+ const fields = sheetFields(sheet)
124
+ if (sheet.focus < fields.length) {
125
+ return { field: fields[sheet.focus] }
126
+ }
127
+
128
+ return { button: sheetButtons(sheet)[sheet.focus - fields.length] ?? null }
129
+ }
130
+
131
+ export function moveFocus(sheet, delta) {
132
+ const count = sheetFields(sheet).length + sheetButtons(sheet).length
133
+ sheet.focus = Math.max(0, Math.min(count - 1, sheet.focus + delta))
134
+ }
135
+
136
+ export function focusField(sheet, key) {
137
+ sheet.focus = Math.max(
138
+ 0,
139
+ sheetFields(sheet).findIndex((entry) => entry.key === key)
140
+ )
141
+ }
142
+
143
+ // a pasted value arrives with the terminal's line breaks and padding, never meant as part of it
144
+ export function typeInto(sheet, text) {
145
+ const { field } = focused(sheet)
146
+ if (!field) {
147
+ return false
148
+ }
149
+
150
+ const value = (sheet.values[field.key] ?? '') + text.replace(/[\r\n]+/g, '')
151
+ sheet.values[field.key] = value.trimStart()
152
+ sheet.error = null
153
+
154
+ return true
155
+ }
156
+
157
+ export function backspace(sheet) {
158
+ const { field } = focused(sheet)
159
+ if (!field) {
160
+ return
161
+ }
162
+
163
+ sheet.values[field.key] = (sheet.values[field.key] ?? '').slice(0, -1)
164
+ }
165
+
166
+ export function enteredValues(sheet) {
167
+ return Object.fromEntries(
168
+ sheetFields(sheet).map((field) => [field.key, (sheet.values[field.key] ?? '').trim()])
169
+ )
170
+ }
171
+
172
+ // `at` is the line the focus sits on, so a long guide scrolls to the field being typed
173
+ export function formatSheet(sheet, fg) {
174
+ const { skill } = sheet
175
+ const route = currentRoute(sheet)
176
+ const title = `Set up ${skill.name}`
177
+ if (!route) {
178
+ return { lines: formatRoutePicker(sheet, fg, title), at: sheet.cursor + 2 }
179
+ }
180
+
181
+ const keys =
182
+ sheet.phase === 'waiting'
183
+ ? 'esc cancel · ctrl+y copy link'
184
+ : 'tab/↑↓ move · enter select · ctrl+r show secrets · esc back'
185
+ const lines = [fg.dim.render(`${title} — ${keys}`), '']
186
+ lines.push(fg.white.render(route.description ?? skill.setup?.summary ?? skill.description))
187
+ lines.push(stateLine(sheet, fg))
188
+ if (route.helpUrl) {
189
+ lines.push(fg.dim.render(route.helpUrl))
190
+ }
191
+
192
+ const fieldAt = pushForm(sheet, lines, fg)
193
+ lines.push('')
194
+ const footerAt = lines.length
195
+ lines.push(...footer(sheet, fg))
196
+ const onField = sheet.focus < sheetFields(sheet).length
197
+
198
+ return { lines, at: onField ? fieldAt + sheet.focus : footerAt }
199
+ }
200
+
201
+ // the guide, the fields, then the steps that follow them; returns the first field's line
202
+ function pushForm(sheet, lines, fg) {
203
+ const guide = guideSteps(sheet)
204
+ if (guide.length) {
205
+ lines.push('')
206
+ guide.forEach((step, i) =>
207
+ lines.push(`${fg.cyan.render(`${i + 1}.`)} ${stepText(sheet, step)}`)
208
+ )
209
+ }
210
+
211
+ const fields = sheetFields(sheet)
212
+ const fieldAt = lines.length + 1
213
+ if (fields.length) {
214
+ lines.push('')
215
+ const width = Math.max(...fields.map((field) => field.label.length))
216
+ fields.forEach((field, i) => lines.push(fieldLine(sheet, { field, i, width }, fg)))
217
+ }
218
+
219
+ const after = stepsAfterFields(sheet)
220
+ if (after.length) {
221
+ lines.push('', ...after.map((step) => fg.dim.render(`• ${stepText(sheet, step)}`)))
222
+ }
223
+
224
+ return fieldAt
225
+ }
226
+
227
+ function formatRoutePicker(sheet, fg, title) {
228
+ const lines = [fg.dim.render(`${title} — ↑/↓ move · enter choose · esc back`), '']
229
+ sheet.routes.forEach((route, i) => {
230
+ const point = i === sheet.cursor ? fg.magenta.render('❯ ') : ' '
231
+ const mark = route.satisfied ? fg.green.render('● ') : fg.dim.render('○ ')
232
+ lines.push(`${point}${mark}${fg.white.render(route.label)}`)
233
+ })
234
+
235
+ return lines
236
+ }
237
+
238
+ function stateLine(sheet, fg) {
239
+ if (isConnected(sheet)) {
240
+ return fg.green.render(`● ${CONNECTED[currentRoute(sheet).kind]}`)
241
+ }
242
+
243
+ if (isReady(sheet.skill)) {
244
+ return fg.dim.render(`○ not set — ${sheet.skill.name} already works another way`)
245
+ }
246
+
247
+ return fg.amber.render(`○ ${statusLabel(sheet.skill.status)}`)
248
+ }
249
+
250
+ // above the fields: what to do before filling them, so a guide's "the fields below" reads true
251
+ function guideSteps(sheet) {
252
+ const route = currentRoute(sheet)
253
+ if (route.kind === 'install') {
254
+ return installSteps(sheet.skill, route)
255
+ }
256
+
257
+ if (route.kind === 'oauth') {
258
+ return ownApp(sheet) ? [...(route.configSteps ?? []), ...redirectStep(sheet)] : []
259
+ }
260
+
261
+ return route.kind === 'token' ? [] : [...(route.steps ?? [])]
262
+ }
263
+
264
+ // below the fields, as desktop draws them: a token's guide and an OAuth consent say "above"
265
+ function stepsAfterFields(sheet) {
266
+ const route = currentRoute(sheet)
267
+ if (route.kind === 'token') {
268
+ return [...(route.steps ?? [])]
269
+ }
270
+
271
+ const guided = ownApp(sheet) && route.configSteps?.length
272
+
273
+ return route.kind === 'oauth' && !guided ? [...(route.steps ?? [])] : []
274
+ }
275
+
276
+ // the user's own app is set up in its console; a built-in client needs only the consent
277
+ function ownApp(sheet) {
278
+ const route = currentRoute(sheet)
279
+ return route.kind === 'oauth' && !!route.fields?.length && !sheet.oauth?.builtIn
280
+ }
281
+
282
+ // a pinned loopback port is the one redirect a provider console can be told in advance
283
+ function redirectStep(sheet) {
284
+ const uri = sheet.oauth?.redirectUri
285
+ return uri ? [`Register this redirect URI in your app: ${uri} (ctrl+y copies it)`] : []
286
+ }
287
+
288
+ // a brew step names a formula, not a command, so the command is spelled out to run by hand
289
+ function installSteps(skill, route) {
290
+ const steps = (skill.install ?? []).map((step) => {
291
+ const command = step.command ?? (step.formula ? `brew install ${step.formula}` : null)
292
+ return command ? `${step.label}: ${command}` : step.label
293
+ })
294
+
295
+ return steps.length ? steps : [...(route.steps ?? [])]
296
+ }
297
+
298
+ function fieldLine(sheet, { field, i, width }, fg) {
299
+ const active = sheet.focus === i && sheet.phase === 'edit'
300
+ const point = active ? fg.magenta.render('❯ ') : ' '
301
+ const value = sheet.values[field.key] ?? ''
302
+ const shown = field.secret && !sheet.revealed ? mask(value) : value
303
+ const cursor = active ? fg.magenta.render('▏') : ''
304
+ const hint = value ? '' : fg.dim.render(fieldHint(sheet, field))
305
+
306
+ return `${point}${field.label.padEnd(width)} ${shown}${cursor}${hint}`
307
+ }
308
+
309
+ // a saved app outranks the built-in one when connecting, so it outranks it here too
310
+ function fieldHint(sheet, field) {
311
+ if (field.secret && sheet.oauth?.savedSecret) {
312
+ return 'blank keeps the saved one'
313
+ }
314
+
315
+ if (sheet.oauth?.builtIn && !sheet.oauth.savedClientId && !sheet.oauth.savedSecret) {
316
+ return 'optional — blank uses the built-in client'
317
+ }
318
+
319
+ return field.placeholder ?? ''
320
+ }
321
+
322
+ function mask(value) {
323
+ return value ? `${'•'.repeat(Math.min(value.length, MASK_CAP))} ${value.length} chars` : ''
324
+ }
325
+
326
+ function footer(sheet, fg) {
327
+ const fields = sheetFields(sheet).length
328
+ const buttons = sheetButtons(sheet).map((button, i) => {
329
+ const label = `[ ${button.label} ]`
330
+ return sheet.focus === fields + i ? fg.magenta.render(label) : fg.white.render(label)
331
+ })
332
+ if (sheet.phase === 'waiting') {
333
+ const url = sheet.url ? [fg.dim.render(sheet.url)] : []
334
+ return [fg.amber.render(sheet.stage ?? 'waiting for the browser…'), ...url, '', buttons[0]]
335
+ }
336
+
337
+ const lines = [buttons.join(' ')]
338
+ if (sheet.error) {
339
+ lines.push('', fg.err.render(sheet.error))
340
+ }
341
+
342
+ return lines
343
+ }
344
+
345
+ // a link is shown with its address, and `{skill}` is the placeholder desktop fills in too
346
+ function stepText(sheet, step) {
347
+ return step
348
+ .replaceAll('{skill}', sheet.skill.name)
349
+ .replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, '$1 ($2)')
350
+ }
@@ -0,0 +1,64 @@
1
+ import b4a from 'b4a'
2
+ import { DEVICE_ROUTES } from '../../dist-lib/lib/api/device-routes.js'
3
+
4
+ // the routes /device points at another device of this account; every other route stays here
5
+ const ON_DEVICE = new Set(DEVICE_ROUTES)
6
+
7
+ export function onDevice(engine, deviceId) {
8
+ if (!deviceId) {
9
+ return engine
10
+ }
11
+
12
+ return new Proxy(engine, {
13
+ get(target, prop) {
14
+ const value = Reflect.get(target, prop)
15
+ if (typeof value !== 'function') {
16
+ return value
17
+ }
18
+
19
+ if (!ON_DEVICE.has(prop)) {
20
+ return value.bind(target)
21
+ }
22
+
23
+ return (input = {}) => value.call(target, { ...input, deviceId })
24
+ }
25
+ })
26
+ }
27
+
28
+ // by its number in /device list, its name, or a prefix of its id
29
+ export function pickDevice(devices, asked) {
30
+ const wanted = asked.trim().toLowerCase()
31
+ if (!wanted) {
32
+ return null
33
+ }
34
+
35
+ const index = Number(wanted)
36
+ if (Number.isInteger(index) && index >= 1 && index <= devices.length) {
37
+ return devices[index - 1]
38
+ }
39
+
40
+ const named = devices.filter((device) => device.name?.toLowerCase() === wanted)
41
+ if (named.length === 1) {
42
+ return named[0]
43
+ }
44
+
45
+ const prefixed = devices.filter((device) => b4a.toHex(device.id).startsWith(wanted))
46
+
47
+ return prefixed.length === 1 ? prefixed[0] : null
48
+ }
49
+
50
+ export function deviceLines(devices, { own, target, connected }) {
51
+ return devices.map((device, i) => {
52
+ const mark = target && b4a.equals(device.id, target) ? '*' : ' '
53
+ const facts = []
54
+ if (own && b4a.equals(device.id, own)) {
55
+ facts.push('this device')
56
+ } else {
57
+ facts.push(connected.has(b4a.toHex(device.id)) ? 'connected' : 'not connected')
58
+ }
59
+
60
+ facts.push(`${device.cachedModelNames?.length ?? 0} models downloaded`)
61
+
62
+ return `${mark}${i + 1}. ${device.name} (${b4a.toHex(device.id).slice(0, 8)}) — ${facts.join(' · ')}`
63
+ })
64
+ }