@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/main.mjs CHANGED
@@ -1,15 +1,18 @@
1
1
  // the TUI itself: draws the first frame, then imports boot.mjs, the engine side, behind it
2
2
  import fs from 'bare-fs'
3
- import os from 'bare-os'
4
3
  import process from 'bare-process'
5
4
  import tui from 'bare-tui'
5
+ import pear from 'bare-tui-updater/pear'
6
6
  import { spawn } from 'child_process'
7
7
  import path from 'path'
8
8
  import { readBootTiming } from './lib/boot-timing.mjs'
9
+ import { resolveLocalPath } from './lib/local-path.mjs'
10
+ import { applyUnattended, startUpdater } from './lib/updater.mjs'
9
11
  import { ChatApp } from './app.mjs'
10
12
  import b4a from 'b4a'
11
13
 
12
14
  const { Program } = tui
15
+ const { wire } = pear
13
16
 
14
17
  // the terminal writes a real sequence in one read, so this only has to beat human perception
15
18
  const ESCAPE_TIMEOUT_MS = 50
@@ -55,7 +58,8 @@ const CLIPBOARD_COMMANDS = {
55
58
  win32: [['clip', []]],
56
59
  linux: [
57
60
  ['wl-copy', []],
58
- ['xclip', ['-selection', 'clipboard']]
61
+ ['xclip', ['-selection', 'clipboard']],
62
+ ['xsel', ['--clipboard', '--input']]
59
63
  ]
60
64
  }
61
65
 
@@ -87,13 +91,19 @@ function copyToClipboard(text) {
87
91
  })
88
92
  }
89
93
 
94
+ // no display (a container, ssh): ask the host terminal to set its clipboard instead
95
+ function copyViaTerminal(program, text) {
96
+ program.output.write(`\x1b]52;c;${b4a.toString(b4a.from(text), 'base64')}\x07`)
97
+ }
98
+
90
99
  function readClipboard() {
91
100
  const commands =
92
101
  process.platform === 'darwin'
93
102
  ? [['pbpaste', []]]
94
103
  : [
95
104
  ['wl-paste', ['--no-newline']],
96
- ['xclip', ['-o', '-selection', 'clipboard']]
105
+ ['xclip', ['-o', '-selection', 'clipboard']],
106
+ ['xsel', ['--clipboard', '--output']]
97
107
  ]
98
108
  return new Promise((resolve, reject) => {
99
109
  const attempt = (i) => {
@@ -131,6 +141,14 @@ const MIME_TYPES = new Map([
131
141
  ['.heic', 'image/heic'],
132
142
  ['.heif', 'image/heif'],
133
143
  ['.pdf', 'application/pdf'],
144
+ ['.mov', 'video/quicktime'],
145
+ ['.mp4', 'video/mp4'],
146
+ ['.m4v', 'video/x-m4v'],
147
+ ['.webm', 'video/webm'],
148
+ ['.mkv', 'video/x-matroska'],
149
+ ['.m4a', 'audio/mp4'],
150
+ ['.mp3', 'audio/mpeg'],
151
+ ['.wav', 'audio/wav'],
134
152
  ['.txt', 'text/plain'],
135
153
  ['.md', 'text/markdown'],
136
154
  ['.json', 'application/json']
@@ -145,7 +163,7 @@ async function resolvePastedFile() {
145
163
  return null
146
164
  }
147
165
 
148
- const file = expandFilePath(text)
166
+ const file = resolveLocalPath(text)
149
167
  let stat
150
168
  try {
151
169
  stat = fs.statSync(file)
@@ -162,12 +180,7 @@ async function resolvePastedFile() {
162
180
 
163
181
  // `/attach` resolver: a named path -> attachment; throws on a bad path.
164
182
  function resolveFileAttachment(pathString) {
165
- return fileToAttachment(expandFilePath(pathString))
166
- }
167
-
168
- function expandFilePath(text) {
169
- const file = text.startsWith('file://') ? decodeURI(text.slice('file://'.length)) : text
170
- return file.startsWith('~/') ? path.join(os.homedir(), file.slice(2)) : file
183
+ return fileToAttachment(resolveLocalPath(pathString))
171
184
  }
172
185
 
173
186
  function fileToAttachment(file, stat = fs.statSync(file)) {
@@ -193,21 +206,22 @@ function printBootTiming(booted) {
193
206
  console.log(`\nboot timing:\n${lines.join('\n')}`)
194
207
  }
195
208
 
196
- export function main(args) {
197
- run(args).catch((err) => {
209
+ export function main(args, { standalone = false, entries = null } = {}) {
210
+ run(args, standalone, entries).catch((err) => {
198
211
  console.error(err)
199
212
  Bare.exit(1)
200
213
  })
201
214
  }
202
215
 
203
- async function run(args) {
216
+ async function run(args, standalone, entries) {
217
+ const updates = standalone ? await startUpdater(entries) : null
204
218
  let program
205
219
  // the engine side, once it is up: its teardown, and what the boot report prints
206
220
  let booted = null
207
221
  // bring-up runs inside the TUI so its "starting up…" frame shows while ~1200 modules load
208
222
  const connect = async () => {
209
223
  const { boot } = await import('./boot.mjs')
210
- booted = await boot(args)
224
+ booted = await boot(args, entries)
211
225
  const { engine, skills, deviceId, meshInvite, modelName } = booted
212
226
 
213
227
  return { engine, skills, deviceId, meshInvite, modelName }
@@ -216,12 +230,18 @@ async function run(args) {
216
230
  // the engine's own handles hold the loop open until a signal arrives
217
231
  if (args.headless) {
218
232
  // armed before connect so a ctrl+C during a first-run model download still unwinds cleanly
219
- const shutdown = async () => {
233
+ const shutdown = async (code = 0) => {
234
+ await updates?.close()
220
235
  await booted?.close()
221
- Bare.exit(0)
236
+ Bare.exit(code)
222
237
  }
223
238
  process.on('SIGINT', () => void shutdown())
224
239
  process.on('SIGTERM', () => void shutdown())
240
+ if (updates) {
241
+ // 75 (EX_TEMPFAIL): non-zero, so Restart=on-failure brings the new build up too
242
+ applyUnattended(updates.updater, console.log, () => void shutdown(75))
243
+ }
244
+
225
245
  const { deviceId, meshInvite } = await connect()
226
246
  console.log(`storage ${booted.storagePath}`)
227
247
  console.log(`log ${booted.logFile}`)
@@ -235,12 +255,17 @@ async function run(args) {
235
255
  const app = new ChatApp({
236
256
  connect,
237
257
  requestRepaint: () => requestRepaint(() => program),
238
- copyToClipboard,
258
+ copyToClipboard: (text) => copyToClipboard(text).catch(() => copyViaTerminal(program, text)),
239
259
  resolvePastedFile,
240
- resolveFileAttachment
260
+ resolveFileAttachment,
261
+ applyUpdate: updates ? () => updates.updater.applyUpdate() : null
241
262
  })
242
263
  // the transcript selects its own text, since the terminal can't while mouse tracking is on
243
264
  program = new Program(app, { mouse: 'drag' })
265
+ if (updates) {
266
+ wire(app.updateBanner, { updater: updates.updater, send: (msg) => program.send(msg) })
267
+ }
268
+
244
269
  // bracketed paste, or each pasted line arrives as keys and submits itself
245
270
  program.output.write('\x1b[?2004h')
246
271
  try {
@@ -257,6 +282,7 @@ async function run(args) {
257
282
  program.output.write('\x1b[?2004l')
258
283
  }
259
284
 
285
+ await updates?.close()
260
286
  await booted?.close()
261
287
  printBootTiming(booted)
262
288
  // don't wait for the child to unwind a blocking native call; close() already tore the sidecar down
@@ -0,0 +1,158 @@
1
+ // userland plugins: folders under ~/.config/qv-ac/plugins, loaded only when config.json lists them
2
+ import fs from 'bare-fs'
3
+ import os from 'bare-os'
4
+ import process from 'bare-process'
5
+ import { spawn } from 'child_process'
6
+ import path from 'path'
7
+ import Corestore from 'corestore'
8
+ import Hyperdrive from 'hyperdrive'
9
+ import HypercoreId from 'hypercore-id-encoding'
10
+ import Hyperswarm from 'hyperswarm'
11
+
12
+ const DIR = path.join(
13
+ process.env.HOME ?? process.env.USERPROFILE ?? os.homedir(),
14
+ '.config',
15
+ 'qv-ac'
16
+ )
17
+ const PLUGINS = path.join(DIR, 'plugins')
18
+ const CONFIG = path.join(DIR, 'config.json')
19
+
20
+ function readConfig() {
21
+ if (!fs.existsSync(CONFIG)) {
22
+ return { plugins: [] }
23
+ }
24
+
25
+ const config = JSON.parse(fs.readFileSync(CONFIG, 'utf8'))
26
+ config.plugins ??= []
27
+
28
+ return config
29
+ }
30
+
31
+ function writeConfig(config) {
32
+ fs.mkdirSync(DIR, { recursive: true })
33
+ fs.writeFileSync(CONFIG, JSON.stringify(config, null, 2) + '\n')
34
+ }
35
+
36
+ const nameOf = (entry) => (typeof entry === 'string' ? entry : entry.name)
37
+
38
+ export function list() {
39
+ const enabled = readConfig().plugins.map(nameOf)
40
+ const installed = fs.existsSync(PLUGINS)
41
+ ? fs.readdirSync(PLUGINS).filter((name) => fs.statSync(path.join(PLUGINS, name)).isDirectory())
42
+ : []
43
+ const names = [...new Set([...installed, ...enabled])].sort()
44
+ if (names.length === 0) {
45
+ console.log(`no plugins in ${PLUGINS}`)
46
+ }
47
+
48
+ for (const name of names) {
49
+ let state = enabled.includes(name) ? 'enabled' : 'disabled'
50
+ if (!installed.includes(name)) {
51
+ state = 'missing'
52
+ }
53
+
54
+ console.log(`${name.padEnd(24)} ${state}`)
55
+ }
56
+ }
57
+
58
+ // a disabled entry keeps its options and read list under `disabled`, which the harness ignores
59
+ export function enable(name) {
60
+ if (!fs.existsSync(path.join(PLUGINS, name))) {
61
+ throw new Error(`${name} is not installed in ${PLUGINS}`)
62
+ }
63
+
64
+ const config = readConfig()
65
+ if (config.plugins.some((entry) => nameOf(entry) === name)) {
66
+ return
67
+ }
68
+
69
+ const stashed = (config.disabled ?? []).find((entry) => nameOf(entry) === name)
70
+ config.disabled = (config.disabled ?? []).filter((entry) => entry !== stashed)
71
+ config.plugins.push(stashed ?? name)
72
+ writeConfig(config)
73
+ }
74
+
75
+ export function disable(name) {
76
+ const config = readConfig()
77
+ const entry = config.plugins.find((entry) => nameOf(entry) === name)
78
+ if (entry === undefined) {
79
+ return
80
+ }
81
+
82
+ config.plugins = config.plugins.filter((other) => other !== entry)
83
+ config.disabled = [...(config.disabled ?? []), entry]
84
+ writeConfig(config)
85
+ }
86
+
87
+ export async function install(source, name) {
88
+ const hyper = source.startsWith('hyper://')
89
+ name ??= hyper ? undefined : path.basename(source).replace(/\.git$/, '')
90
+ if (!name || path.basename(name) !== name) {
91
+ throw new Error('give the plugin a folder name: duck plugins install <source> <name>')
92
+ }
93
+
94
+ const dest = path.join(PLUGINS, name)
95
+ if (fs.existsSync(dest)) {
96
+ throw new Error(`${name} is already installed in ${PLUGINS}`)
97
+ }
98
+
99
+ fs.mkdirSync(PLUGINS, { recursive: true })
100
+ if (hyper) {
101
+ await fromDrive(source.slice('hyper://'.length).replace(/\/$/, ''), dest)
102
+ } else {
103
+ await gitClone(source, dest)
104
+ }
105
+
106
+ console.log(`installed ${name}; run duck plugins enable ${name} to load it`)
107
+ }
108
+
109
+ function gitClone(url, dest) {
110
+ return new Promise((resolve, reject) => {
111
+ spawn('git', ['clone', '--depth', '1', url, dest], { stdio: 'inherit' })
112
+ .on('error', reject)
113
+ .on('exit', (code) =>
114
+ code === 0 ? resolve() : reject(new Error(`git clone exited ${code}`))
115
+ )
116
+ })
117
+ }
118
+
119
+ async function fromDrive(key, dest) {
120
+ const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'duck-plugin-'))
121
+ const store = new Corestore(tmp)
122
+ const swarm = new Hyperswarm()
123
+ swarm.on('connection', (socket) => store.replicate(socket))
124
+ const drive = new Hyperdrive(store, HypercoreId.decode(key))
125
+ try {
126
+ await drive.ready()
127
+ const donePeering = drive.findingPeers()
128
+ swarm
129
+ .join(drive.discoveryKey, { server: false, client: true })
130
+ .flushed()
131
+ .then(donePeering, donePeering)
132
+ await drive.update({ wait: true })
133
+ for await (const entry of drive.list('/', { recursive: true })) {
134
+ const file = path.resolve(dest, '.' + entry.key)
135
+ if (!file.startsWith(dest + path.sep)) {
136
+ throw new Error(`drive entry ${entry.key} escapes the plugin folder`)
137
+ }
138
+
139
+ const data = await drive.get(entry.key, { wait: true })
140
+ if (data !== null) {
141
+ fs.mkdirSync(path.dirname(file), { recursive: true })
142
+ fs.writeFileSync(file, data)
143
+ }
144
+ }
145
+
146
+ if (!fs.existsSync(dest)) {
147
+ throw new Error(`no peer served any file from hyper://${key}`)
148
+ }
149
+ } catch (err) {
150
+ fs.rmSync(dest, { recursive: true, force: true })
151
+ throw err
152
+ } finally {
153
+ await swarm.destroy()
154
+ await drive.close()
155
+ await store.close()
156
+ fs.rmSync(tmp, { recursive: true, force: true })
157
+ }
158
+ }
@@ -6,6 +6,7 @@ import { Core, assistantChild, clientSessions } from '../dist-lib/index.js'
6
6
  import { DEFAULT_RAG_MODEL } from '../dist-lib/lib/core/files/rag/models.js'
7
7
  import { Logger, toLoggerOptions } from '../dist-lib/lib/log.js'
8
8
  import { releaseChannel, resolveStorage } from '@qvac/harness/storage'
9
+ import { closeOfficeWorker, extractOfficeText } from '@qvac/harness/office'
9
10
  import {
10
11
  DEFAULT_IMAGE_MODEL_CHOICE,
11
12
  DEFAULT_MUSIC_MODEL_CHOICE,
@@ -33,7 +34,12 @@ export default stowEntry((ipc) => {
33
34
  app = undefined,
34
35
  llm = DEFAULT_KV_CACHE,
35
36
  hostsModelSource = true,
36
- eager = true
37
+ eager = true,
38
+ // undefined keeps Core's own choice; false lets a host start without fetching default models
39
+ autoDownloadModels = undefined,
40
+ fakeModels = false,
41
+ // the harness's knowledge plugin holds the index; false keeps core's own, rebuilt each start
42
+ harnessKnowledge = true
37
43
  } = JSON.parse(Bare.argv[2] || '{}')
38
44
 
39
45
  const bootstrapNodes = bootstrapJson ? JSON.parse(bootstrapJson) : undefined
@@ -74,6 +80,7 @@ export default stowEntry((ipc) => {
74
80
  bootstrapNodes,
75
81
  app: app ? { ...app, channel } : undefined,
76
82
  hostsModelSource,
83
+ autoDownloadModels,
77
84
  apiLifecycle: {
78
85
  suspend: () => sup.suspend(),
79
86
  resume: () => sup.resume()
@@ -82,12 +89,19 @@ export default stowEntry((ipc) => {
82
89
 
83
90
  // the host resets the session when its renderer reloads: same Core, a fresh client over one pipe
84
91
  ipc.on('session-reset', () => {
85
- core
86
- .connect(sessions.reset())
92
+ const stream = sessions.reset()
93
+ ipc
94
+ .send('session-reset')
95
+ .then(() => core.connect(stream))
87
96
  .catch((err) => logger.warn('assistant-sidecar', 'session reset failed', err?.message))
88
97
  })
89
98
 
99
+ sup.add('office', {
100
+ start: () => ({ close: closeOfficeWorker })
101
+ })
102
+
90
103
  sup.add('core', {
104
+ deps: ['office'],
91
105
  start: () => core,
92
106
  presuspend: (handle) => handle.presuspend(),
93
107
  suspend: (handle) => handle.suspend(),
@@ -98,6 +112,7 @@ export default stowEntry((ipc) => {
98
112
  sup.add(
99
113
  'assistant',
100
114
  assistantChild({
115
+ extractors: { office: extractOfficeText },
101
116
  // knowledge indexing volunteers this device; rebuilt against each harness incarnation
102
117
  embedder: (harness) => ({
103
118
  model: DEFAULT_RAG_MODEL,
@@ -112,11 +127,20 @@ export default stowEntry((ipc) => {
112
127
  imageClamps,
113
128
  musicModel,
114
129
  llm: { ...llm },
130
+ knowledge: harnessKnowledge
131
+ ? { dir: `${storage.root}/knowledge`, model: DEFAULT_RAG_MODEL }
132
+ : undefined,
115
133
  logger,
116
134
  eager
117
135
  }),
118
136
  onHarness: (harness, { engine }) => startCredentialPusher(harness, engine, logger),
119
- logger
137
+ // the sweep drops what this mesh does not reference, so a shared dir loses other instances' pages
138
+ imageCacheDir: `${storage.root}/image-cache`,
139
+ inferenceCallsDir: `${storage.root}/inspector`,
140
+ runReplayDir: `${storage.root}/run-replay`,
141
+ kvCacheChatsDir: `${storage.root}/kv-cache-chats`,
142
+ logger,
143
+ fakeModels
120
144
  })
121
145
  )
122
146
 
@@ -1,54 +1,7 @@
1
1
  /* global Bare */
2
2
  // bare-stow's bundle shim as a plain file, so the sidecar can be spawned without stowing
3
- import protocol from 'bare-stow/protocol'
3
+ import runtime from 'bare-stow-runtime/process'
4
4
 
5
- const ipc = protocol.attach(Bare.IPC)
5
+ const ipc = runtime.attach(Bare.IPC)
6
6
 
7
- let stop = null
8
- let readied = false
9
- let exited = false
10
-
11
- function ready() {
12
- if (readied) return
13
- readied = true
14
-
15
- ipc.send('ready')
16
- }
17
-
18
- async function shutdown(code, err = null) {
19
- if (exited) return
20
- exited = true
21
-
22
- try {
23
- if (stop) {
24
- await stop()
25
- }
26
- } catch (e) {
27
- err = err || e
28
- }
29
-
30
- if (err) {
31
- ipc.send('error', { message: err.message, stack: err.stack })
32
- }
33
-
34
- await ipc.send('exit', { code })
35
-
36
- Bare.exit(code)
37
- }
38
-
39
- ipc.on('terminate', () => shutdown(0))
40
-
41
- Bare.on('beforeExit', (exitCode) => shutdown(exitCode))
42
- .on('uncaughtException', (err) => shutdown(1, err))
43
- .on('unhandledRejection', (err) => shutdown(1, err))
44
-
45
- try {
46
- const entry = await import('./assistant-sidecar.mjs')
47
- const start = entry.default
48
-
49
- stop = (await start(ipc, ready)) || null
50
-
51
- ready()
52
- } catch (err) {
53
- shutdown(1, err)
54
- }
7
+ ipc.run(() => import('./assistant-sidecar.mjs'), ipc)
@@ -1,11 +0,0 @@
1
- import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
- declare const DROPPED: readonly ['@qvac/append-chunk', '@qvac/update-chunk', '@qvac/resolve-approval', '@qvac/put-agent', '@qvac/put-approval-rule', '@qvac/seed-defaults', '@qvac/add-knowledge', '@qvac/remove-knowledge', '@qvac/add-knowledge-artifact', '@qvac/claim-indexing', '@qvac/resolve-indexing', '@qvac/put-chat', '@qvac/put-tool-configs', '@qvac/append-tool-activity', '@qvac/migrate-agent-catalog', '@qvac/reindex-agents', '@qvac/put-chat-group', '@qvac/put-joined-mesh', '@qvac/purge-chat'];
3
- export type DroppedComputeRoute = (typeof DROPPED)[number];
4
- export declare function droppedComputeRoutes(): ReadonlyArray<DroppedComputeRoute>;
5
- export declare class ComputeRouteDropped extends Error {
6
- readonly route: string;
7
- constructor(route: string);
8
- }
9
- export declare function assertComputeRoute(compute: boolean, name: string): void;
10
- export declare function registerComputeDrops(router: Router): void;
11
- export {};
@@ -1,48 +0,0 @@
1
- const DROPPED = [
2
- '@qvac/append-chunk',
3
- '@qvac/update-chunk',
4
- '@qvac/resolve-approval',
5
- '@qvac/put-agent',
6
- '@qvac/put-approval-rule',
7
- '@qvac/seed-defaults',
8
- '@qvac/add-knowledge',
9
- '@qvac/remove-knowledge',
10
- '@qvac/add-knowledge-artifact',
11
- '@qvac/claim-indexing',
12
- '@qvac/resolve-indexing',
13
- '@qvac/put-chat',
14
- '@qvac/put-tool-configs',
15
- '@qvac/append-tool-activity',
16
- '@qvac/migrate-agent-catalog',
17
- '@qvac/reindex-agents',
18
- '@qvac/put-chat-group',
19
- '@qvac/put-joined-mesh',
20
- '@qvac/purge-chat'
21
- ];
22
- const DROPPED_ROUTES = new Set(DROPPED);
23
- export function droppedComputeRoutes() {
24
- return DROPPED;
25
- }
26
- export class ComputeRouteDropped extends Error {
27
- route;
28
- constructor(route) {
29
- super(`${route} is dropped on a compute mesh: it carries only delegated work`);
30
- this.name = 'ComputeRouteDropped';
31
- this.route = route;
32
- }
33
- }
34
- export function assertComputeRoute(compute, name) {
35
- if (!compute)
36
- return;
37
- const route = `@qvac/${name}`;
38
- if (DROPPED_ROUTES.has(route)) {
39
- throw new ComputeRouteDropped(route);
40
- }
41
- }
42
- export function registerComputeDrops(router) {
43
- for (const name of DROPPED) {
44
- router.add(name, async (_op, { log }) => {
45
- log?.debug('contract', `${name} dropped: this mesh carries only delegated work`);
46
- });
47
- }
48
- }
@@ -1,11 +0,0 @@
1
- export declare const DEVICE_INVITE_SPENT = "This device invite has already been used";
2
- export interface DeviceInvites {
3
- issue(): Promise<Buffer>;
4
- redeem(token: Buffer | null | undefined, deviceId: Buffer): Promise<boolean>;
5
- spent(token: Buffer | null | undefined, deviceId: Buffer): Promise<boolean>;
6
- }
7
- export interface DeviceInviteStore {
8
- get(key: string): Promise<unknown>;
9
- set(key: string, value: unknown): Promise<void>;
10
- }
11
- export declare function openDeviceInvites(store: DeviceInviteStore): DeviceInvites;
@@ -1,63 +0,0 @@
1
- import crypto from 'hypercore-crypto';
2
- import ScopeLock from 'scope-lock';
3
- import { deviceInviteToken } from './identity.js';
4
- import b4a from 'b4a';
5
- const NONCES_KEY = 'device-invite-nonces';
6
- const INVITE_TTL_MS = 48 * 60 * 60 * 1000;
7
- const MAX_OUTSTANDING = 5;
8
- export const DEVICE_INVITE_SPENT = 'This device invite has already been used';
9
- export function openDeviceInvites(store) {
10
- const lock = new ScopeLock();
11
- async function outstanding() {
12
- const value = await store.get(NONCES_KEY);
13
- const now = Date.now();
14
- return (Array.isArray(value) ? value : []).filter((entry) => typeof entry?.nonce === 'string' && now - entry.issuedAt < INVITE_TTL_MS);
15
- }
16
- function matching(issued, token, deviceId) {
17
- return issued.findIndex(({ nonce }) => b4a.equals(deviceInviteToken(b4a.from(nonce, 'hex'), deviceId), token));
18
- }
19
- return {
20
- async issue() {
21
- const nonce = crypto.randomBytes(32);
22
- await lock.lock();
23
- try {
24
- const issued = await outstanding();
25
- const spent = issued.filter((entry) => entry.spent);
26
- const kept = issued.filter((entry) => !entry.spent).slice(-(MAX_OUTSTANDING - 1));
27
- await store.set(NONCES_KEY, [
28
- ...spent,
29
- ...kept,
30
- { nonce: b4a.toHex(nonce), issuedAt: Date.now() }
31
- ]);
32
- }
33
- finally {
34
- lock.unlock();
35
- }
36
- return nonce;
37
- },
38
- async redeem(token, deviceId) {
39
- if (!token)
40
- return false;
41
- await lock.lock();
42
- try {
43
- const issued = await outstanding();
44
- const index = matching(issued, token, deviceId);
45
- if (index === -1 || issued[index].spent) {
46
- return false;
47
- }
48
- await store.set(NONCES_KEY, issued.map((entry, i) => (i === index ? { ...entry, spent: true } : entry)));
49
- return true;
50
- }
51
- finally {
52
- lock.unlock();
53
- }
54
- },
55
- async spent(token, deviceId) {
56
- if (!token)
57
- return false;
58
- const issued = await outstanding();
59
- const index = matching(issued, token, deviceId);
60
- return index !== -1 && issued[index].spent === true;
61
- }
62
- };
63
- }
@@ -1,13 +0,0 @@
1
- import type { AbortSignal } from 'bare-abort-controller';
2
- import type { Files } from '../index.ts';
3
- import type { FileProcessing } from './index.ts';
4
- export interface SettleOptions {
5
- readonly timeoutMs?: number;
6
- readonly signal?: AbortSignal;
7
- }
8
- export interface SettleFilesOptions extends SettleOptions {
9
- readonly ids: string[];
10
- readonly processing: FileProcessing;
11
- readonly chatIds: () => Promise<string[]>;
12
- }
13
- export declare function settleFiles(files: Files, options: SettleFilesOptions): Promise<void>;