@qvac/core 1.0.0-rc.0 → 1.0.0-rc.10

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 +1203 -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 +18 -4
  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 +74 -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
@@ -0,0 +1,84 @@
1
+ import { resolveLocalPath } from './local-path.mjs'
2
+
3
+ const USAGE = 'usage: /folders [list] · /folders add <path> [ro|rw] · /folders remove <path>'
4
+ const ACCESS = new Map([
5
+ ['ro', 'read'],
6
+ ['rw', 'write']
7
+ ])
8
+ const LABEL = { read: 'ro', write: 'rw' }
9
+
10
+ // host: the agent runs elsewhere
11
+ export async function foldersCommand(engine, { agent, host = null }, input) {
12
+ if (host) {
13
+ return {
14
+ type: 'notice',
15
+ text: `${agent.name} runs on ${host}, so its folders are shared there · run /folders on that device`
16
+ }
17
+ }
18
+
19
+ try {
20
+ return { type: 'notice', text: await execute(engine, agent, input) }
21
+ } catch (error) {
22
+ return { type: 'run.error', error }
23
+ }
24
+ }
25
+
26
+ async function execute(engine, agent, input) {
27
+ const agentId = agent.id
28
+ const { action, argument } = parseInput(input)
29
+ if (!action || action === 'list') {
30
+ const { folders } = await engine.listAgentFolders({ agentId })
31
+
32
+ return folders?.length ? formatFolders(agent, folders) : empty(agent)
33
+ }
34
+
35
+ if (action === 'add' && argument) {
36
+ // the access is the last word, so a path with spaces needs no quotes
37
+ const [, given, flag = 'ro'] = argument.match(/^(.*?)(?:\s+(ro|rw))?$/)
38
+ const access = ACCESS.get(flag)
39
+ const path = resolveLocalPath(unquote(given))
40
+ const { folders } = await engine.addAgentFolder({ agentId, path, access })
41
+ const can = access === 'write' ? 'read and edit' : 'read'
42
+
43
+ return [`${agent.name} can ${can} ${path} from its next message`, ...rows(folders)].join('\n')
44
+ }
45
+
46
+ if (action === 'remove' && argument) {
47
+ const path = resolveLocalPath(unquote(argument))
48
+ await engine.removeAgentFolder({ agentId, path })
49
+
50
+ return `stopped sharing ${path} with ${agent.name}`
51
+ }
52
+
53
+ return USAGE
54
+ }
55
+
56
+ function empty(agent) {
57
+ return `no folders shared with ${agent.name} on this device · /folders add <path> [ro|rw]`
58
+ }
59
+
60
+ function formatFolders(agent, folders) {
61
+ return [
62
+ `folders ${agent.name} can use on this device (relative paths start in the first):`,
63
+ ...rows(folders)
64
+ ].join('\n')
65
+ }
66
+
67
+ function rows(folders) {
68
+ return folders.map((folder) => ` ${LABEL[folder.access]} ${folder.path}`)
69
+ }
70
+
71
+ function parseInput(input) {
72
+ const value = input.trim()
73
+ const separator = value.search(/\s/)
74
+ if (separator === -1) {
75
+ return { action: value, argument: '' }
76
+ }
77
+
78
+ return { action: value.slice(0, separator), argument: value.slice(separator).trim() }
79
+ }
80
+
81
+ function unquote(value) {
82
+ const match = value.match(/^(["'])(.*)\1$/)
83
+ return match ? match[2] : value
84
+ }
@@ -0,0 +1,43 @@
1
+ export const FORK_USAGE = 'usage: /chat fork [turn] [before] · /mesh fork <n|id> [turn] [before]'
2
+
3
+ // `[turn] [before]` to a forkChat cut: turn n is the n-th message, through its answer or before it
4
+ export function forkCut(chunks, args) {
5
+ const [turn, mode, ...extra] = args
6
+ if (!turn) {
7
+ return { request: {}, label: 'every finished turn' }
8
+ }
9
+
10
+ const n = Number(turn)
11
+ if (!Number.isInteger(n) || n < 1 || (mode && mode !== 'before') || extra.length > 0) {
12
+ return { miss: FORK_USAGE }
13
+ }
14
+
15
+ const before = mode === 'before'
16
+ const runId = turnRunId(chunks, { n, before })
17
+ if (!runId) {
18
+ return { miss: `turn ${n} has no answer to fork at` }
19
+ }
20
+
21
+ return {
22
+ request: { runId, exclusive: before },
23
+ label: before ? `everything before turn ${n}` : `through turn ${n}`
24
+ }
25
+ }
26
+
27
+ // a retry answers the same message again, so `through` takes its last answer and `before` its first
28
+ function turnRunId(chunks, { n, before }) {
29
+ const messages = chunks.filter((chunk) => chunk.type === 'user-message' && !chunk.runId)
30
+ const message = messages[n - 1]
31
+ if (!message) {
32
+ return null
33
+ }
34
+
35
+ const next = messages[n]?.seq ?? Infinity
36
+ const answers = chunks.filter(
37
+ (chunk) =>
38
+ chunk.type === 'run-request' && chunk.seq > message.seq && chunk.seq < next && chunk.runId
39
+ )
40
+ const answer = before ? answers[0] : answers.at(-1)
41
+
42
+ return answer?.runId ?? null
43
+ }
@@ -1,8 +1,7 @@
1
1
  import fs from 'fs'
2
- import os from 'os'
3
2
  import path from 'path'
4
- import { fileURLToPath } from 'url'
5
3
  import { RAG_ACCEPT_EXTENSIONS } from 'rag-extract'
4
+ import { resolveLocalPath } from './local-path.mjs'
6
5
  import { UPLOAD_FRAME_BYTES, writeFrame } from './upload-frames.mjs'
7
6
  import { errorMessage } from '../../dist-lib/lib/guards.js'
8
7
  const ACCEPTED = new Set(RAG_ACCEPT_EXTENSIONS)
@@ -30,7 +29,7 @@ const MIME_TYPES = new Map([
30
29
  ])
31
30
 
32
31
  export async function importKnowledgeFile(engine, scope, inputPath) {
33
- const file = resolvePath(inputPath)
32
+ const file = resolveLocalPath(inputPath)
34
33
  const stat = await fs.promises.stat(file)
35
34
  if (!stat.isFile()) {
36
35
  throw new Error(`not a file: ${file}`)
@@ -44,7 +43,7 @@ export async function importKnowledgeFile(engine, scope, inputPath) {
44
43
  }
45
44
 
46
45
  export async function importKnowledgeDirectory(engine, scope, inputPath) {
47
- const directory = resolvePath(inputPath)
46
+ const directory = resolveLocalPath(inputPath)
48
47
  const stat = await fs.promises.stat(directory)
49
48
  if (!stat.isDirectory()) {
50
49
  throw new Error(`not a directory: ${directory}`)
@@ -79,23 +78,6 @@ export async function importKnowledgeDirectory(engine, scope, inputPath) {
79
78
  return { directory, added, failed, skipped }
80
79
  }
81
80
 
82
- function resolvePath(input) {
83
- const value = input.trim()
84
- if (value.startsWith('file://')) {
85
- return fileURLToPath(value)
86
- }
87
-
88
- if (value === '~') {
89
- return os.homedir()
90
- }
91
-
92
- if (value.startsWith('~/')) {
93
- return path.join(os.homedir(), value.slice(2))
94
- }
95
-
96
- return path.resolve(value)
97
- }
98
-
99
81
  function supported(file) {
100
82
  return ACCEPTED.has(path.extname(file).toLowerCase())
101
83
  }
@@ -0,0 +1,21 @@
1
+ import os from 'os'
2
+ import path from 'path'
3
+ import { fileURLToPath } from 'url'
4
+
5
+ // a path as a person types it: a file:// url, ~ for home, or relative to where duck started
6
+ export function resolveLocalPath(input) {
7
+ const value = input.trim()
8
+ if (value.startsWith('file://')) {
9
+ return fileURLToPath(value)
10
+ }
11
+
12
+ if (value === '~') {
13
+ return os.homedir()
14
+ }
15
+
16
+ if (value.startsWith('~/')) {
17
+ return path.join(os.homedir(), value.slice(2))
18
+ }
19
+
20
+ return path.resolve(value)
21
+ }
@@ -0,0 +1,17 @@
1
+ // what one chatMoveWatch frame tells the person who typed /mesh move
2
+ export function describeMove(move, { title, where }) {
3
+ const short = move.targetMeshId.slice(0, 8)
4
+ if (move.state === 'failed') {
5
+ return `move of "${title}" failed: ${move.failure}`
6
+ }
7
+
8
+ if (move.state === 'carrying') {
9
+ const files = move.waiting?.length ? move.waiting.join(', ') : `${move.files - move.carried}`
10
+ return `"${title}" is in ${short} - waiting on ${files}; the source stays until they arrive, /mesh moved shows progress`
11
+ }
12
+
13
+ const retried = move.restarted ? ' - its running turn is answered again there' : ''
14
+ const settled = move.state === 'complete' ? 'moved' : 'moving'
15
+
16
+ return `${settled} "${title}" to ${short}${retried} - ${where}`
17
+ }
@@ -36,6 +36,11 @@ export function turnsFromChunks(chunks) {
36
36
  const turns = []
37
37
  const byRun = new Map()
38
38
  for (const chunk of chunks) {
39
+ // a video's sampled frames belong to the video, not to the reply that stored them
40
+ if (chunk.sourceId) {
41
+ continue
42
+ }
43
+
39
44
  // purely presentational: lets a renderer label the human side per device
40
45
  if (chunk.type === 'user-message') {
41
46
  turns.push({
@@ -155,7 +160,24 @@ export function runInFlight(turns) {
155
160
  return false
156
161
  }
157
162
 
158
- export function busyStatus(modelState, runTurn, elapsed) {
163
+ function awaitingDownloadText(model, runTurn, { selfId, downloads }) {
164
+ const row = selfId !== '' && runTurn.statusDeviceId === selfId ? downloads.get(model) : null
165
+ if (row?.phase === 'held') {
166
+ return `waiting for ${model} - /models download ${model}`
167
+ }
168
+
169
+ if (row?.phase === 'downloading') {
170
+ return `downloading ${model}: ${row.percentage ?? 0}%`
171
+ }
172
+
173
+ return `waiting for ${model} to be downloaded`
174
+ }
175
+
176
+ export function busyStatus(
177
+ modelState,
178
+ runTurn,
179
+ { elapsed = Infinity, selfId = '', downloads = new Map() } = {}
180
+ ) {
159
181
  if (modelState?.status === 'loading') {
160
182
  return { text: `loading ${modelState.model}…`, on: 'local' }
161
183
  }
@@ -188,6 +210,13 @@ export function busyStatus(modelState, runTurn, elapsed) {
188
210
  return { text: `queued - agent busy in ${progress.busyChatId}`, on: 'host' }
189
211
  }
190
212
 
213
+ if (progress?.phase === 'awaiting-download') {
214
+ return {
215
+ text: awaitingDownloadText(progress.model, runTurn, { selfId, downloads }),
216
+ on: 'host'
217
+ }
218
+ }
219
+
191
220
  if (progress?.phase === 'compacting') {
192
221
  return { text: 'compacting conversation…', on: 'host' }
193
222
  }
package/tui/lib/setup.mjs CHANGED
@@ -27,18 +27,20 @@ export function connectSlug(credentialKey) {
27
27
  .replaceAll('_', '-')
28
28
  }
29
29
 
30
- // the routes that carry a credential key are also how a skill is reconfigured later
30
+ // every route opens the skill's sheet; one that stores a value is also how it is changed later
31
31
  export function setupActions(skill) {
32
- return (deriveSetupRoutes(skillEntry(skill)).routes ?? []).map((route) =>
33
- routeAction(route, skill)
34
- )
32
+ return skillRoutes(skill).map((route) => routeAction(route, skill))
33
+ }
34
+
35
+ export function skillRoutes(skill) {
36
+ return [...(deriveSetupRoutes(skillEntry(skill)).routes ?? [])]
35
37
  }
36
38
 
37
- // prefers a route the TUI can run over one that only prints instructions
39
+ // prefers a route the sheet can finish over one that only prints instructions
38
40
  export function setupPlan(skill) {
39
41
  const actions = setupActions(skill)
40
42
  const open = actions.filter((action) => !action.satisfied)
41
- const primary = open.find((action) => action.command || action.prefill) ?? open[0] ?? null
43
+ const primary = open.find((action) => action.configurable) ?? open[0] ?? null
42
44
  const others = actions.filter((action) => action !== primary)
43
45
 
44
46
  return { primary, others }
@@ -48,32 +50,22 @@ export function setupAction(skill) {
48
50
  return setupPlan(skill).primary
49
51
  }
50
52
 
51
- // a connected skill keeps these: a route with a credential key is configuration, not a one-off
52
53
  export function configureActions(skill) {
53
54
  const { primary, others } = setupPlan(skill)
54
- return [primary, ...others].filter((action) => action?.command || action?.prefill)
55
+ return [primary, ...others].filter((action) => action?.configurable)
55
56
  }
56
57
 
57
58
  function routeAction(route, skill) {
58
- const action = {
59
- kind: 'steps',
59
+ return {
60
+ kind: route.kind,
60
61
  label: route.label,
61
62
  description: route.description ?? null,
62
63
  helpUrl: route.helpUrl ?? null,
63
64
  satisfied: route.satisfied === true,
64
65
  steps: route.kind === 'install' ? installSteps(skill) : [...(route.steps ?? [])],
65
- command: undefined,
66
- prefill: undefined
67
- }
68
- if (!route.credentialKey) {
69
- return action
70
- }
71
-
72
- if (route.kind === 'oauth') {
73
- return { ...action, kind: 'connect', command: `/connect ${connectSlug(route.credentialKey)}` }
66
+ configurable: Boolean(route.credentialKey),
67
+ command: `/skill ${skill.name}`
74
68
  }
75
-
76
- return { ...action, kind: 'cred', prefill: `/cred ${route.credentialKey} ` }
77
69
  }
78
70
 
79
71
  function installSteps(skill) {
@@ -82,16 +74,14 @@ function installSteps(skill) {
82
74
 
83
75
  // `a|b` credential slots list interchangeable keys, each its own candidate route
84
76
  function skillEntry(skill) {
85
- const credentials = (skill.requires?.credentials ?? skill.credentials ?? []).flatMap((slot) =>
86
- slot.split('|')
87
- )
77
+ const credentials = declaredCredentials(skill)
88
78
  return {
89
79
  metadata: {
90
80
  name: skill.name,
91
81
  description: skill.description,
92
82
  setup: skill.setup,
93
83
  transports: skill.transports,
94
- requires: { ...skill.requires, credentials },
84
+ requires: { credentials },
95
85
  install: skill.install
96
86
  },
97
87
  content: '',
@@ -99,3 +89,47 @@ function skillEntry(skill) {
99
89
  state: skill.status
100
90
  }
101
91
  }
92
+
93
+ // both authoring forms count, as the harness unions them; on the wire `requires` is `requirements`
94
+ export function declaredCredentials(skill) {
95
+ const slots = [...(skill.credentials ?? []), ...(skill.requirements?.credentials ?? [])]
96
+ const keys = slots.flatMap((slot) => slot.split('|')).map((key) => key.trim())
97
+
98
+ return [...new Set(keys.filter(Boolean))]
99
+ }
100
+
101
+ // a skill is named by its name, or by the slug its credential once gave /connect
102
+ export function findSkill(skills, name) {
103
+ return (
104
+ skills.find((skill) => skill.name === name) ??
105
+ skills.find((skill) =>
106
+ skillRoutes(skill).some(
107
+ (route) => route.credentialKey && connectSlug(route.credentialKey) === name
108
+ )
109
+ ) ??
110
+ null
111
+ )
112
+ }
113
+
114
+ export function closestSkill(skills, name) {
115
+ const near = skills
116
+ .map((skill) => ({ name: skill.name, distance: editDistance(skill.name, name) }))
117
+ .filter((entry) => entry.distance <= 2 || entry.name.startsWith(name))
118
+ .sort((a, b) => a.distance - b.distance)
119
+
120
+ return near[0]?.name ?? null
121
+ }
122
+
123
+ function editDistance(a, b) {
124
+ let row = Array.from({ length: b.length + 1 }, (_, i) => i)
125
+ for (let i = 1; i <= a.length; i++) {
126
+ const next = [i]
127
+ for (let j = 1; j <= b.length; j++) {
128
+ next[j] = Math.min(row[j] + 1, next[j - 1] + 1, row[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1))
129
+ }
130
+
131
+ row = next
132
+ }
133
+
134
+ return row[b.length]
135
+ }
@@ -0,0 +1,145 @@
1
+ // where a skill's setup values are stored, and the OAuth connect that fills its token
2
+ import process from 'process'
3
+ import { isDeviceSharedCredentialKey } from '@qvac/harness/skill-state'
4
+ import { settingConfigKey } from '../../dist-lib/lib/credential-pusher.js'
5
+ import { scopedKey } from '../../dist-lib/lib/oauth/keys.js'
6
+
7
+ export function credentialKey(agentId, key) {
8
+ return scopedKey(isDeviceSharedCredentialKey(key) ? undefined : agentId, key)
9
+ }
10
+
11
+ // the client app lives in the skill's own state row, beside the refresh token it minted
12
+ export async function savedClient(engine, { agentId, stateKey }) {
13
+ const state = await readState(engine, scopedKey(agentId, stateKey))
14
+
15
+ return { clientId: state.clientId ?? '', clientSecret: state.clientSecret ?? '' }
16
+ }
17
+
18
+ export function envClient(provider) {
19
+ const env = provider.toUpperCase().replaceAll('-', '_')
20
+
21
+ return {
22
+ clientId: process.env[`${env}_OAUTH_CLIENT_ID`] ?? '',
23
+ clientSecret: process.env[`${env}_OAUTH_CLIENT_SECRET`] ?? ''
24
+ }
25
+ }
26
+
27
+ // one app's id and secret, typed or saved, else the built-in pair: a mix is invalid_client
28
+ export function resolveClient(spec, { entered, saved, env }) {
29
+ if (spec.registrationEndpoint) {
30
+ return { clientId: '' }
31
+ }
32
+
33
+ const needsSecret = spec.tokenAuth !== 'pkce-only'
34
+ const own = !!(entered.clientId || entered.clientSecret || saved.clientId || saved.clientSecret)
35
+ const otherApp = !!entered.clientId && entered.clientId !== saved.clientId
36
+ const clientId = own ? entered.clientId || saved.clientId : env.clientId
37
+ const savedSecret = otherApp ? '' : saved.clientSecret
38
+ const clientSecret = own ? entered.clientSecret || savedSecret : env.clientSecret
39
+ const need = { clientId: !clientId, clientSecret: needsSecret && !clientSecret }
40
+ if (need.clientId || need.clientSecret) {
41
+ return { need }
42
+ }
43
+
44
+ return { clientId, clientSecret: needsSecret ? clientSecret : undefined }
45
+ }
46
+
47
+ // the typed values decide the client app; a missing piece comes back as `need`, not as an error
48
+ export async function connectSkill(engine, { agentId, spec, entered, openUrl, onStage }) {
49
+ const client = resolveClient(spec, {
50
+ entered: { clientId: entered.clientId ?? '', clientSecret: entered.clientSecret ?? '' },
51
+ saved: await savedClient(engine, { agentId, stateKey: spec.stateKey }),
52
+ env: envClient(spec.provider)
53
+ })
54
+ if (client.need) {
55
+ return client
56
+ }
57
+
58
+ await connectOAuth(engine, { agentId, spec, client, openUrl, onStage })
59
+
60
+ return null
61
+ }
62
+
63
+ export async function connectOAuth(engine, { agentId, spec, client, openUrl, onStage }) {
64
+ const { buildProviderConfig, runOAuthFlow } = await import('../../dist-lib/lib/oauth.js')
65
+ const stateKey = scopedKey(agentId, spec.stateKey)
66
+ // the client this run signs in with, whether a prior run registered it or this one does
67
+ let registered = ''
68
+ const tokens = await runOAuthFlow(buildProviderConfig(spec, client), {
69
+ openUrl,
70
+ onStage,
71
+ getClientId: async () => {
72
+ registered = (await readState(engine, stateKey)).clientId || ''
73
+ return registered || undefined
74
+ },
75
+ saveClientId: (id) => {
76
+ registered = id
77
+ }
78
+ })
79
+
80
+ await engine.configSet({ key: scopedKey(agentId, spec.credentialKey), value: tokens.accessToken })
81
+ await engine.configSet({
82
+ key: stateKey,
83
+ value: JSON.stringify({
84
+ refreshToken: tokens.refreshToken,
85
+ expiresAt: tokens.expiresAt,
86
+ clientId: client.clientId || registered,
87
+ clientSecret: client.clientSecret
88
+ })
89
+ })
90
+ }
91
+
92
+ export async function cancelOAuth(spec) {
93
+ const { cancelOAuthFlow } = await import('../../dist-lib/lib/oauth.js')
94
+
95
+ return cancelOAuthFlow({ credentialKey: spec.credentialKey })
96
+ }
97
+
98
+ // an oauth route's fields describe its client app, so they are filed in its state row
99
+ export async function saveFields(engine, { agentId, skillName, route, values }) {
100
+ const entries = Object.entries(values).filter(([, value]) => value !== '')
101
+ if (route.kind === 'oauth') {
102
+ const key = scopedKey(agentId, route.oauth.stateKey)
103
+ const state = await readState(engine, key)
104
+ const typed = Object.fromEntries(entries)
105
+ // a new client id is a new app: the old one's secret and refresh token would pair with it
106
+ const kept = !typed.clientId || typed.clientId === state.clientId ? state : {}
107
+ await engine.configSet({ key, value: JSON.stringify({ ...kept, ...typed }) })
108
+
109
+ return
110
+ }
111
+
112
+ for (const [name, value] of entries) {
113
+ await engine.configSet({ key: fieldStorageKey({ agentId, skillName, route, name }), value })
114
+ }
115
+ }
116
+
117
+ // a disconnected skill keeps its client app, so connecting again needs no retyping
118
+ export async function disconnect(engine, { agentId, route }) {
119
+ await engine.configSet({ key: credentialKey(agentId, route.credentialKey), value: '' })
120
+ if (route.kind !== 'oauth') {
121
+ return
122
+ }
123
+
124
+ const key = scopedKey(agentId, route.oauth.stateKey)
125
+ const { clientId, clientSecret } = await readState(engine, key)
126
+ await engine.configSet({ key, value: clientId ? JSON.stringify({ clientId, clientSecret }) : '' })
127
+ }
128
+
129
+ function fieldStorageKey({ agentId, skillName, route, name }) {
130
+ const field = (route.fields ?? []).find((entry) => entry.key === name)
131
+ if (name === route.credentialKey || field?.secret === true) {
132
+ return credentialKey(agentId, name)
133
+ }
134
+
135
+ return settingConfigKey(undefined, skillName, name)
136
+ }
137
+
138
+ async function readState(engine, key) {
139
+ const { value } = await engine.configGet({ key })
140
+ try {
141
+ return (typeof value === 'string' && value ? JSON.parse(value) : null) ?? {}
142
+ } catch {
143
+ return {}
144
+ }
145
+ }
@@ -0,0 +1,86 @@
1
+ import fs from 'bare-fs'
2
+ import os from 'bare-os'
3
+ import path from 'path'
4
+ import Corestore from 'corestore'
5
+ import Hyperswarm from 'hyperswarm'
6
+ import PearRuntimeUpdater from 'pear-runtime-updater'
7
+
8
+ export async function startUpdater(entries) {
9
+ const { version, upgrade } = JSON.parse(fs.readFileSync(new URL(entries.release), 'utf8'))
10
+ if (!upgrade) {
11
+ return null
12
+ }
13
+
14
+ const dir = appDir()
15
+ fs.mkdirSync(dir, { recursive: true })
16
+
17
+ const { default: LockFile } = await import('fs-native-lock')
18
+ const lock = new LockFile(path.join(dir, 'duck.lock'))
19
+ try {
20
+ await lock.lock()
21
+ } catch {
22
+ return null
23
+ }
24
+
25
+ const store = new Corestore(path.join(dir, 'pear-runtime', 'corestore'))
26
+ const swarm = new Hyperswarm()
27
+ swarm.on('connection', (connection) => store.replicate(connection))
28
+
29
+ const app = os.execPath()
30
+ const updater = new PearRuntimeUpdater({
31
+ // the next build is swapped in by rename, so it downloads onto the executable's own volume
32
+ dir: path.join(path.dirname(app), '.duck-update'),
33
+ store,
34
+ version,
35
+ upgrade,
36
+ app,
37
+ name: os.platform() === 'win32' ? 'duck.exe' : 'duck'
38
+ })
39
+ updater.on('error', () => {})
40
+
41
+ // updater.close() waits out a download that can no longer finish once the swarm is gone
42
+ const close = async () => {
43
+ await swarm.destroy()
44
+ await store.close()
45
+ await lock.unlock()
46
+ }
47
+
48
+ try {
49
+ await updater.ready()
50
+ } catch (err) {
51
+ await close()
52
+ throw err
53
+ }
54
+
55
+ swarm.join(updater.drive.core.discoveryKey)
56
+
57
+ return { updater, close }
58
+ }
59
+
60
+ export function applyUnattended(updater, log, onInstalled) {
61
+ // closing the store on shutdown cancels a download in flight, which is not a failed update
62
+ const fail = (err) => err.code === 'REQUEST_CANCELLED' || log(`update failed: ${err.message}`)
63
+ const apply = () =>
64
+ updater.applyUpdate().then(() => {
65
+ log(`update v${updater.nextVersion} installed, exiting for the supervisor to restart`)
66
+ onInstalled()
67
+ }, fail)
68
+
69
+ updater.on('updated', apply)
70
+ updater.on('error', fail)
71
+ if (updater.updated) {
72
+ apply()
73
+ }
74
+ }
75
+
76
+ function appDir() {
77
+ const home = os.homedir()
78
+ switch (os.platform()) {
79
+ case 'win32':
80
+ return path.join(home, 'AppData', 'Roaming', 'duck')
81
+ case 'darwin':
82
+ return path.join(home, 'Library', 'Application Support', 'duck')
83
+ default:
84
+ return path.join(home, '.config', 'duck')
85
+ }
86
+ }