@qvac/core 1.0.0-rc.1 → 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
package/CHANGELOG.md CHANGED
@@ -13,6 +13,1186 @@ release.
13
13
 
14
14
  ## [Unreleased]
15
15
 
16
+ ### Added
17
+
18
+ - `continueRunHere({ meshId, chunkId })`: the device a run was sent from takes back a run another
19
+ of your devices holds, and picks it up from its last round. Refused with `RUN_REQUEST_OFFLINE`
20
+ while this device is offline. `examples/run-continue-here.mjs` shows it; see
21
+ [chunks](docs/api/chunks.md#continuerunhere).
22
+
23
+ - `workspaceUpgradeSummary` says what the upgrade from 0.20 converted on this device, so the app
24
+ can tell the person once: each workspace the mesh list shows that this device minted a project
25
+ for or merged chats into, whether one of its groups is still pending, whether it had chat-groups
26
+ at all, the project its ungrouped chats went to, and the workspace this device copied the 0.20
27
+ private chats into, with `privateChatsPending` until that copy finishes. See
28
+ [workspace](docs/api/workspace.md#workspaceupgradesummary).
29
+
30
+ ```js
31
+ const { workspaces, privateChatsWorkspaceId } = await engine.workspaceUpgradeSummary()
32
+ ```
33
+
34
+ - Image and music generation for a remote agent runs on the chat's model host. The tools stay on
35
+ the device driving the run and ask the host with a probe round; the host waits for its model,
36
+ generates, and names the output by blob (`putBlob`); the driver's attachment names that blob. An
37
+ edit's sources go by the chat's attachment ids and the host fits them. A host that will never hold
38
+ the model settles `model-missing` and the driver uses its own. An agent this device serves
39
+ generates in process, with its step progress. Needs harness 1.0.0-rc.20, and this Core on both
40
+ devices: a host on an earlier 1.0 prerelease never takes the round, so the tool waits until the run
41
+ is stopped or the host leaves. (#755)
42
+
43
+ - A vision model sees an image a tool attaches during a run, such as a PNG `http_request` downloads
44
+ from Google Drive. The assistant gives the harness the image from its own image cache, as it does
45
+ a user's image, and the harness shows it on the turn that closes the tool round. Later runs show
46
+ it again on the same turn. Video stays an attachment for now. Needs a harness with `showImage`.
47
+
48
+ - A completed run that primed the chat cache after Core deleted it says so on its
49
+ `run-status.metrics`: `cacheRebuild` carries Core's deletion reason and the prompt tokens of the
50
+ run's first round on the key, as its `metrics.rounds` counts them, null when that round has no
51
+ count. A run whose first round was taken on another device reports nothing, since that device
52
+ keeps its own cache. A run that reused the cache carries no key.
53
+
54
+ ```js
55
+ const { runStatus } = chunk
56
+ if (runStatus.state === 'completed' && runStatus.metrics?.cacheRebuild) {
57
+ const { reason, tokens } = runStatus.metrics.cacheRebuild
58
+ }
59
+ ```
60
+
61
+ - The last agent to stop running a loaded model on a device — deleted, moved to another device or
62
+ switched to another model — unloads it there, so the memory is freed without waiting for the idle
63
+ sweep. A model loaded by hand that no agent runs stays loaded.
64
+
65
+ - `@qvac/core/sidecar-entry` names the script a host spawns as Core's sidecar, so a host
66
+ resolves it by name instead of a path into the package. `test/basic/entry-weight.ts` holds
67
+ every named entry to a ceiling on the files importing it loads, so an app that imports a
68
+ constant never parses the engine.
69
+
70
+ - After a completed run, on a host that asks for it, the assistant suggests the user's likely next message
71
+ and stores it on the chat, so a client can offer it to accept with one key:
72
+
73
+ ```js
74
+ const chat = await engine.getChat({ meshId, chatId })
75
+ if (chat.suggestion?.runId === latestRunId) offer(chat.suggestion.text)
76
+ ```
77
+
78
+ It is one short tool-less call after the title, cancelled by the chat's next
79
+ run, and off until the model host sets the device config key
80
+ `assistant.suggestPrompts` to `on`.
81
+ ([chat.md](docs/api/chat.md#setchatsuggestion))
82
+
83
+ - A message sent while the chat's run is still going steers it: the model host
84
+ hands it to that run, which takes it at its next tool call and answers it there,
85
+ instead of queueing a separate run behind it. Its own run then ends at once:
86
+
87
+ ```js
88
+ // { state: 'completed', reason: 'steered', metrics: { steeredInto: runId } }
89
+ ```
90
+
91
+ A run that never takes it leaves the message its own run, as before, and a
92
+ harness without steering ignores the offer.
93
+ ([execution.md](docs/api/execution.md#sendmessage))
94
+
95
+ - `worker/assistant-sidecar.mjs` takes `autoDownloadModels` from the host and
96
+ passes it to `Core`. Unset keeps today's behaviour; `false` starts a host
97
+ without fetching the default models. A sidecar that fails to start also writes
98
+ the reason to stderr, since the host may not be listening yet.
99
+ - `duck plugins list|install|enable|disable` manages the userland harness
100
+ plugins in `~/.config/qv-ac` without booting an engine. Install clones a git
101
+ URL or copies a `hyper://` drive, and does not enable what it installs.
102
+ - `npm i -g bare @qvac/core` runs `duck`: the model addons the harness's stock entry loads are
103
+ optional dependencies of the package, so an install brings them, and `bare-thread` is pinned to
104
+ `~1.2.7` in `dependencies`, since 1.4 fails to load the stowed harness worker.
105
+
106
+ - `chatSkillAvailability` and `chatSkillAvailabilityWatch`: on a phone, which of a chat's skills
107
+ cannot run right now, `{ name, available, reason: 'platform' }`. (#733)
108
+ - `CoreOptions.onerror(err, { meshId })` receives every error caught on the autobee path. Without
109
+ one, Core logs it under the `errors` scope. (#785)
110
+
111
+ ### Changed
112
+
113
+ - **Breaking for a host:** `engines.bare` is `>=1.35.0`. Core runs on Bare 1.36 with the current
114
+ Holepunch packages, and `bare-worker` 4.5.3 and `bare-sidecar` 0.5.15 need Bare 1.35 to start a
115
+ worker or a sidecar. Core depends on `@qvac/harness` 1.0.0-rc.19, whose Python plugin has the
116
+ same floor.
117
+ ([decision](docs/decisions/2026-09-25-workers-run-on-bare-worker-and-bare-is-pinned.md))
118
+
119
+ - `uploadAttachment` and `uploadKnowledge` hold at most 16 MiB a stream is yet to read. A client
120
+ that keeps writing after `write` returns `false` past that is cut off with `STREAM_OVERFLOW`,
121
+ which ends its whole connection to Core. Wait for the stream to drain between frames, as the
122
+ example in [attachments](docs/api/attachments.md) does.
123
+
124
+ - A peer that sends nothing for 10 s is dropped, so a frozen device leaves `peerDeviceIds` in
125
+ seconds rather than staying listed. See [mesh](docs/api/mesh.md).
126
+
127
+ - A streaming reply lands in its chat about once a second instead of every 250 ms: `RunTranscript`
128
+ flushes buffered text on a 1 s tick (and still at 8,192 chars, on a type or round change and at the
129
+ end). A client watching the chat gets a quarter of the frames, so it should pace its own text
130
+ animation by how often text arrives rather than assume a fixed cadence. On a Pixel 8 this cut
131
+ app CPU per generated token by about 30% and skin heating per token by 20–40%, with decode speed
132
+ unchanged.
133
+ ([decision](docs/decisions/2026-11-05-a-streaming-reply-lands-once-a-second.md))
134
+
135
+ - A private chat linked to a project no longer reads the project's knowledge base: `ragSearch` and
136
+ the runs it feeds rank the knowledge base only for a chat in the project. ([rag.md](docs/api/rag.md))
137
+
138
+ - The KV cache retention sweep runs every 12 hours instead of every hour, besides when a mesh opens
139
+ and when `kvCache.retentionDays` changes, so a cache can outlive its retention by up to 12 hours
140
+ on a host that stays up. ([config.md](docs/api/config.md#kv-cache-retention))
141
+
142
+ - Core depends on `@qvac/harness` 1.0.0-rc.20 from npm instead of a git commit, so a consumer installs
143
+ the published harness with its named entries. Qwen3.6-27B left the harness catalog in rc.20, so it
144
+ leaves Core's context table too: an agent saved on it sizes its window as an uncurated model.
145
+
146
+ - Wipe a store written by 1.0.0-rc.0 to rc.2 before running this build. The collection, route and
147
+ field ids those prereleases gave the 1.0 additions moved up by one to keep 0.11.1's in place, so
148
+ this build misreads their rows without an error. A store from 0.11.1 or earlier upgrades as is.
149
+ Nor does the wipe carry over a mesh an rc wrote to, minted there or a 0.11 mesh an rc device
150
+ held writable, since an rc raises the rules on each: other peers and the blind peers still hold
151
+ its rc-numbered ops, so a device that rejoins it, by a recovery from the phrase too, misreads
152
+ them again. Start a new account on this build instead.
153
+
154
+ - The baked version floor is `>=0.22.0`: one build per mesh, since this release
155
+ changes what apply admits and app 0.22 is the first to ship it. Each mesh now
156
+ holds a rules row, `@qvac/mesh-rules`, first in a new mesh's genesis and
157
+ appended once when this build first holds an existing mesh writable, and apply
158
+ holds new rules to ops after it only. A 0.7.x or 0.11.x replica that applies
159
+ the row halts into its update prompt.
160
+
161
+ **Operator step:** publish `>=0.22.0` with `qvac-app → scripts/ota-config.mjs`
162
+ on each lane (dev, staging, prod) only once app 0.22 is live on that lane, and
163
+ never before: a floor above the installed release withholds every device on
164
+ the lane. Not `>=0.21.0`, which admits app 0.21 and its core 0.11.1, from
165
+ before the row. Until it is published, an old replica that fast-forwards past
166
+ the row applies later ops under the old rules.
167
+
168
+ - A rules row raised above the rules this build knows halts apply into its
169
+ update prompt with the code `MESH_RULES_FROM_A_NEWER_BUILD`, instead of being
170
+ applied.
171
+
172
+ - `harnessKnowledge` defaults to `true` in `worker/assistant-sidecar.mjs`: desktop and `duck` index
173
+ knowledge with the harness plugin, fed core's stored vectors on first start. Pass `false` to keep
174
+ core's index. (#806)
175
+ - Identical chunk text in a knowledge file is embedded once. (#804)
176
+
177
+ ### Removed
178
+
179
+ - `duck`'s `/agent borrow` and `/mesh new compute`, now that Core 1.0 retires
180
+ model loans and compute meshes.
181
+
182
+ ### Fixed
183
+
184
+ - A mesh still opening when Core closes is closed with it, and its open refuses with
185
+ `CORE_CLOSING`. It used to outlive the store it read.
186
+
187
+ - A generated file over 16 MiB uploads: the assistant waits for the upload stream to drain
188
+ instead of writing the whole file at once.
189
+
190
+ - An app that depends on Core installs the speech addon its harness asks for. `@qvac/asr-ggml` was
191
+ pinned to 0.4.2, outside the `^0.11.1` the harness's Speech plugin declares. It now follows the
192
+ harness range, and a test checks every optional peer of a plugin the harness entry loads against
193
+ Core's dependencies.
194
+ - `AssistantClient.close()` lets the sidecar close its Core before it returns. It used to
195
+ destroy the sidecar's pipe at once, which killed the child a few milliseconds into its close,
196
+ so every reopen recovered its meshes as after a crash. `close()` now asks the sidecar to stop,
197
+ waits for it to exit, and so takes a few seconds while Core's swarm closes.
198
+ - A video attachment with neither a video nor an audio stream is no longer sent to transcription
199
+ as a voice memo; the run's model is told it could not be read on this device.
200
+ - A reply served by another device no longer repeats parts of itself. The run owner skips the text
201
+ the host already wrote when its harness streams it back, but matched that text chunk by chunk,
202
+ and the harness wire joins chunks that arrive together, so a delta frame carrying two of the
203
+ host's chunks was written a second time by the owner. The echo is now matched as text.
204
+ - A run that restarts mid-reply no longer has its host write the abandoned round's answer a second
205
+ time beside the new attempt's: the run cancels the model rounds its earlier attempt left open
206
+ before it starts again.
207
+ - A resume whose announce reached no DHT node retries that topic within
208
+ seconds, instead of leaving the device unfindable for ten minutes.
209
+ - A chat cache whose workspace this device no longer sees is deleted: left while the device was
210
+ closed, before it heard of the leave, or a member's chats it served. The assistant records which
211
+ chats it built a cache for and, at boot and whenever a mesh leaves the list, deletes those no open
212
+ mesh lists. A host keeps that record beside the run replays, through the new `kvCacheChatsDir`
213
+ option, so a data reset takes both; retention Never turns the sweep off too.
214
+
215
+ ```js
216
+ assistantTree({ runReplayDir: `${root}/run-replay`, kvCacheChatsDir: `${root}/kv-cache-chats` })
217
+ ```
218
+
219
+ - A device that hosts another member's agent sweeps its chat caches too: KV cache retention and the
220
+ orphaned cache sweep read a hosted mesh through `listChats`, which the assistant's connection now
221
+ answers there with the chats it serves, instead of failing the whole sweep. A host restart keeps
222
+ the caches it serves until hosting resumes, instead of deleting them at boot.
223
+ - Upgrading from app 0.21 no longer reruns a send that was still unanswered in a private chat. The
224
+ private chats copied into your own workspace now end an open run as failed, as the chats copied
225
+ into a project already did, instead of leaving a request for the assistant to take. An approval
226
+ that run was holding is denied in the copy in both places, so none stays pending on a failed run.
227
+
228
+ - Mesh sync and close no longer wedge: a failed fast-forward warmup rejects, a failed sync pass is
229
+ delivered again, a close with unserved blocks finishes and flushes queued ops, a joined mesh
230
+ announces its own writer to every new peer, a workspace's name is kept on the device and answered
231
+ offline, and reads answer from what the device holds instead of waiting on a timeout or reporting
232
+ a caught read error as missing data. (#779, #791, #795, #796, #798, #800, #801, #802, #805, #814)
233
+ - The view walk reads 16 nodes at a time instead of 1024. (#782)
234
+ - A served round loads at its agent's window, survives another mesh's rounds changing, and stops
235
+ when its mesh closes or is left. (#783, #790, #793)
236
+ - A chat rename made while its title is generated is kept. (#780)
237
+ - Copying tool activity keeps the seq placeholder. (#810)
238
+
239
+ ## [0.11.4] - 2026-10-30
240
+
241
+ ### Changed
242
+
243
+ - A `mesh write` or `mesh drain` stall now keeps reporting while it lasts (#649). Each `… still pending`
244
+ line carries `reports` (1, 2, 3 …), and the wait doubles between reports. It also names:
245
+ - `fastForwarding`: the head a fast-forward is booting onto, with how much of that core this
246
+ device and its peers hold, or `null`.
247
+ - `peerLength` and `peerHeld` on every `missing` core: how far the furthest connected peer
248
+ knows that core, and how much of it that peer holds from block 0.
249
+ - `writers` on a mesh still joining: each writer it knows, with the same holdings.
250
+ - The logs now name the build and what an open did to an older mesh (#650):
251
+ - `core opening` is the first line of a launch. It names the app's `version`, `build` and
252
+ `channel`, and the mesh `schema` this core applies. A mesh's own `opening` line names the
253
+ `schema` too.
254
+ - `migrations ran` follows each pass on open. It lists the steps that wrote, each step's `ms`,
255
+ and the step that threw as `failed`. A pass still going after 15 s logs
256
+ `migrations still running` with its current step, again after 30 s, 60 s, and so on.
257
+ - `copied chats into chat-chunks` and `recorded the files the mesh already held` give each
258
+ backfill's count and `ms`.
259
+
260
+ ### Fixed
261
+
262
+ - The assistant no longer logs `saveDeviceCapabilities failed` while the account mesh is still
263
+ joining. Core refuses the report with `MESH_STILL_JOINING` until this device is a writer, and the
264
+ assistant already reports again once the account turns writable, so the refusal was never a
265
+ failure. (#648)
266
+
267
+ ## [0.11.3] - 2026-10-28
268
+
269
+ ### Added
270
+
271
+ - The first run to complete stores which pictures of a PDF it sent, as an attachment chunk whose
272
+ `sourceId` is the PDF's attachment id, so later turns and other devices send the same ones. Do
273
+ not render an attachment chunk that carries a `sourceId`. (#640)
274
+
275
+ ### Changed
276
+
277
+ - A PDF's pictures reach a vision model cut to each figure and its caption, named by page and
278
+ figure, instead of as whole pages, and white pages are no longer sent. The PDF's text and its
279
+ pictures now share half the context window, less what the chat already holds, where each took
280
+ half before: a PDF whose whole text fit filled the window and compacted on the next message.
281
+ (#640)
282
+ - `bare-pdfium` is required at `^1.8.0`, for `imageBounds` and `pageBox`; a host that packages the
283
+ addon ships that version. (#640)
284
+
285
+ ## [0.11.2] - 2026-10-28
286
+
287
+ ### Added
288
+
289
+ - A chat's KV cache is deleted once the chat has been idle for the retention, so a device no
290
+ longer keeps the cache of every chat it ever ran. The chat itself is untouched; its next message
291
+ primes from history. An app sets its default with `kvCacheRetentionMs` on `assistantChild` (14
292
+ days without it, `0` for Never), and a device overrides it with `kvCache.retentionDays`. (#589)
293
+
294
+ ```js
295
+ import { assistantChild } from '@qvac/core'
296
+ import { KV_CACHE_RETENTION_KEY } from '@qvac/core/constants'
297
+
298
+ assistantChild({ harness, kvCacheRetentionMs: 30 * 24 * 60 * 60_000 })
299
+ await engine.configSet({ key: KV_CACHE_RETENTION_KEY, value: 7 })
300
+ ```
301
+
302
+ - Every credential a skill declares is pushed to the harness, not only the built-in keys and
303
+ OAuth tokens, so a skill with its own key no longer reads needs-setup for good and needs no core
304
+ release. Where a value may be sent is unchanged, and an overlay skill gets no credential. (#596)
305
+ - A credential with no setup block and no token provider gets a one-field token route named after
306
+ its key, so any setup UI can set it. (#591)
307
+ - `duck` sets a skill up through one sheet, opened by `/skill <name>`. (#592)
308
+
309
+ ### Changed
310
+
311
+ - `toolResult.result` is required on the wire, so a tool result of `false`, `0` or `''` reads
312
+ back as written from `listChunks` and `chunksWatch` instead of `null`. A device on 0.11.0 or
313
+ earlier, and a result one of those releases wrote, still read `null`. (#559)
314
+
315
+ ```js
316
+ // 0.11.1
317
+ { type: 'tool-result', toolResult: { name } }
318
+ // 0.11.2
319
+ { type: 'tool-result', toolResult: { name, result: null } }
320
+ ```
321
+
322
+ ### Removed
323
+
324
+ - `duck`'s `/cred`: every value is set through its skill's sheet. (#593)
325
+
326
+ ### Fixed
327
+
328
+ - Chat activity no longer diffs across a fast-forward it has not counted yet. It
329
+ dropped its cached view head only once `fastForwards` moved, which can be
330
+ after the view has landed on another core, and a diff from the old head read
331
+ every node of the new view. It now drops the head whenever the view is on
332
+ another core, as `chunksDeltaWatch` does. (#623)
333
+ - A device that does not hold a mesh no longer downloads most of it to show chat
334
+ activity and notifications. Both read a few chunk types per chat, each through
335
+ its type index and then row by row from `@qvac/chunks`; they now read the
336
+ chat's range of `@qvac/chat-chunks` once and keep those types, where that
337
+ range is whole. A member joining a 170-chat mesh with both open downloaded
338
+ about 39,000 blocks (155 MB) instead of 258,000 (640 MB), and on a device that
339
+ holds the mesh their first frames take 2.2 s and 3.7 s instead of 5.8 s and
340
+ 9.8 s. (#624)
341
+ - `compactChat` folds whole turns, so a chat whose messages were queued no longer keeps answers
342
+ without their questions. (#607)
343
+ - A run whose injected excerpts overflow the model window, with no older turns to fold, is retried
344
+ with half the excerpts instead of failing. (#599)
345
+ - `ragSearch` on a remote agent host waits for an attached file still replicating to it instead of
346
+ answering that the file is still being indexed. (#562)
347
+ - A chat whose first message carries a document is titled from the words the user typed, not the
348
+ document text. (#516)
349
+ - A re-homed agent's skill values are retried until the new host takes them; a host that refused
350
+ before it replicated the re-home left them unset. (#478)
351
+
352
+ ## [0.11.1] - 2026-10-26
353
+
354
+ ### Added
355
+
356
+ - `deviceTree(transport, { core, assistant, office, logger })` boots Core and
357
+ the assistant under one supervisor, the way the app does. (#544)
358
+ - The `reindex-chat-chunks` op copies a chat written before this release into
359
+ `@qvac/chat-chunks`. A build older than this one halts on it, so a device
360
+ sends it only once the published version floor shuts out every app release
361
+ before 0.21.0, the first whose core applies it. A build under the floor opens
362
+ no mesh, so none can halt on it; publish `>=0.21.0` once that release is in
363
+ both stores. (#491)
364
+ - A device's row in the account carries `customModels`: the label, task type
365
+ and size of each custom model it has. A paired desktop showed a custom model
366
+ added on the phone by its `custom:…` id, as Other and of unknown size, and
367
+ counted it outside the phone's LLMs. `saveDeviceCapabilities` takes the field,
368
+ and the assistant reports it again when a custom model is renamed. (#556)
369
+
370
+ ### Changed
371
+
372
+ - `chunksDeltaWatch` reads only the rows that changed after its opening reset,
373
+ so an update no longer costs the whole chat. Frames are unchanged; a
374
+ selection with `limit` is still read whole. (#538)
375
+ - Injection-mode `ragSearch` sizes its excerpts to a quarter of the agent's
376
+ context window, capped at the 3072-token default, so a small window gets
377
+ fewer excerpts instead of overflowing. (#588)
378
+ - `hypercore` 11.39 and `hypercore-storage` 3.4, for a working purge. (#539)
379
+ - `hypercore-blob-server` 1.15.1 keeps its socket listening across a suspend,
380
+ so resume keeps the port and every minted link, and replaces the local patch.
381
+ (#561)
382
+
383
+ ### Fixed
384
+
385
+ - A member whose only device in a shared mesh comes back far behind
386
+ fast-forwards instead of replaying everything it missed (183 s to 3.9 s on a
387
+ mesh about 6,900 flushes ahead): a shared mesh trusts every member's live
388
+ devices, not only this member's own, and never a device admitted unlinked. A
389
+ compute mesh still trusts only its own member's devices. (#492)
390
+ - Opening a chat on a device that does not hold the mesh no longer downloads most
391
+ of the mesh. Each chunk is also kept in `@qvac/chat-chunks`, keyed by chat and
392
+ `seq`, and a chat read is one range of it: a 1,100-chunk chat fetched about
393
+ 1,000 blocks instead of 100,000. Once the published floor is at app 0.21.0 or
394
+ later, the chats written before this release are copied in the background, one
395
+ op per chat; until then, or while an older build still writes to a chat, it
396
+ reads the way it did before. A chat an older build purged also loses the rows
397
+ that build left in `@qvac/chat-chunks`. (#490, #491)
398
+ - `configGet` and `configWatch` return a stored `false`, `0` or `''` as written
399
+ instead of `null`. A device on 0.11.0 or earlier, a value one of those
400
+ releases wrote, and a downgrade to one still read them as `null`. (#546)
401
+ - A message's audio attachment is presented to the model as a transcript of its
402
+ speech only, so a tool that reads the audio itself, such as music
403
+ transcription, is used again. (#337)
404
+ - The assistant reports an agent it hosts in a shared mesh as soon as this
405
+ device has joined it. A device still joining had its report refused and never
406
+ reported again. (#324)
407
+ - `removeDevice` on the account revokes the device in a shared mesh whose row
408
+ for it arrives after the removal. Before, it stayed a writer there. (#547)
409
+ - `inferenceCalls` and the skill routes (`pushSkillSecret`,
410
+ `listManagedSkills`, `readSkillFile`, `writeSkillFile`, `copySkillForEdit`,
411
+ `deleteOverlaySkill`) from a device that has just paired no longer fail with
412
+ `PEER_SENDER_REVOKED`: the host waits up to 30 s for the new device's row.
413
+ (#544)
414
+ - Core no longer dies of an unhandled `REQUEST_CANCELLED` when a fast-forward
415
+ cancels the read that follows a joined mesh's shared meshes. (#474)
416
+ - A device restarted while its `joinMesh` is still `joining` boots the mesh
417
+ from the head its invite carried, instead of replaying it from its first
418
+ block, which on a big mesh took minutes. (#515)
419
+ - `meshInvite` on a device that just recovered with `recoverAccount` waits for
420
+ its member link instead of failing with "This device cannot reach its account
421
+ to check". (#540)
422
+ - A question sent while the previous run was still answering is shown to the
423
+ model after that answer, not before it, once compaction folds the earlier
424
+ turns. The run's reply and its file turns were sorted behind the new question,
425
+ and the model answered as if they came later (QVAC-24502). A file a run
426
+ produced is now replayed right behind that run's answer instead of at the end
427
+ of the chat; an existing chat with such a turn re-reads once after the update.
428
+ (#584)
429
+
430
+ ## [0.11.0] - 2026-10-23
431
+
432
+ ### Added
433
+
434
+ - `OAuthFlowDeps.onStage` reports `awaiting-callback` and `exchanging-code`, so a
435
+ host can log where a connect flow stopped. (#550)
436
+ - `deliverOAuthCallback(address)` in `@qvac/core/oauth` settles a waiting
437
+ sign-in from a callback address the user pastes, for a browser that cannot
438
+ reach the loopback. (#551)
439
+
440
+ ### Changed
441
+
442
+ - The OAuth loopback done page tells the user to return to QV.AC to finish
443
+ connecting. (#550)
444
+ - The PDF page-image cap scales with the run's context window, between 2 and
445
+ 32 pages, instead of a fixed 10. (#526)
446
+
447
+ ### Fixed
448
+
449
+ - An OAuth connect whose provider stops answering now fails after 30 s instead
450
+ of waiting forever: the code exchange after the browser hands back the code
451
+ with `OAUTH_TOKEN_EXCHANGE_TIMEOUT`, and dynamic client registration, before
452
+ the browser opens, with `OAUTH_REGISTRATION_TIMEOUT`.
453
+ `OAuthFlowDeps.requestTimeoutMs` sets the limit per request. (#555)
454
+ - A PDF cut at the page-image cap tells the model the last page shown. (#525)
455
+ - Each user turn renders the same bytes on every request, so the chat's KV
456
+ cache is reused. (#528)
457
+ - Two devices that take turns to leave the account and pair back can both still
458
+ `meshInvite`. Before, the fourth pairing left a device refused with
459
+ `DEVICE_INVITE_CHAIN_TOO_LONG`. (#513)
460
+ - `joinMesh` no longer hangs when a device pairs back right after it unpaired,
461
+ while the removal its leave left behind is still being delivered. (#513)
462
+
463
+ ## [0.10.4] - 2026-10-22
464
+
465
+ ### Added
466
+
467
+ - A video attachment reaches the chat's model as up to 32 frames, sized to the
468
+ context window, with their times and a transcript of its audio track. The
469
+ first run stores them as an attachment chunk carrying `sourceId`, the video's
470
+ attachment id, which later turns and other devices read instead of the video;
471
+ an app should not render a chunk with `sourceId`. `uploadAttachment` takes
472
+ `sourceId` on its first frame. Core now depends on `bare-ffmpeg`. See
473
+ [attachments](docs/api/attachments.md) and [chunks](docs/api/chunks.md).
474
+ (#496)
475
+ - A `ctxSize`, `kvCacheK` or `kvCacheV` change reloads the agent's model on its
476
+ host 2.5 seconds after the last edit, if it is loaded, instead of on the
477
+ agent's next message. (#495)
478
+
479
+ ### Changed
480
+
481
+ - `fileStatusWatch` reads only the chat's attachments, not every message in the
482
+ chat, on each refresh. (#518)
483
+
484
+ ### Fixed
485
+
486
+ - A device that unpairs itself hands the agents it hosted to its member's
487
+ earliest-paired live device, in the account and every shared mesh, instead of
488
+ leaving them orphaned. A leave from an earlier release is handed over on the
489
+ next boot. (#514)
490
+ - On a harness in its own process, an image sent to a model without a projector
491
+ is no longer dropped silently: the run asks the harness about the chat's
492
+ model, and the turn says the image is not visible to it. (#494)
493
+ - A token saved for an agent reaches `skills` and `skillCatalog` readiness as
494
+ soon as it is written, instead of after the ten-minute credential refresh.
495
+ (#523)
496
+ - `duck` reopens the meshes it had saved when it starts. (#519)
497
+
498
+ ## [0.10.3] - 2026-10-21
499
+
500
+ ### Added
501
+
502
+ - `listAgentFolders`, `addAgentFolder` and `removeAgentFolder` share a folder on
503
+ this device with an agent, read only or read and write, so its file tools have
504
+ somewhere to work. They keep the `fs.<agentId>.roots` and
505
+ `fs.<agentId>.writable` config keys the assistant already reads, so a grant
506
+ written before keeps working. See
507
+ [agent folders](docs/api/agent-folders.md). (#445)
508
+
509
+ ### Changed
510
+
511
+ - The runs a `deleteAgent` with `keepChats` cancels carry
512
+ `reason: 'agent-deleted'`, so an app can tell them from a run its user took
513
+ back and keep the message they answered. (#486)
514
+ - `deleteAgent` forgets the folders shared with the agent on this device. (#445)
515
+
516
+ ### Fixed
517
+
518
+ - A borrowed run (`lenderDeviceId`) no longer acts on the lender's machine. The
519
+ lender serves it with no shared folders, with the `files` and `exec` toolsets
520
+ off, as none of its own agents, and with its KV caches kept apart; a borrowed
521
+ run gets no image or attachment. (#477)
522
+ - A device-invite `joinMesh` no longer lists a mesh it is leaving as closed, so
523
+ the app no longer reopens it and reports `MESH_NOT_FOUND` after pairing.
524
+ (#489)
525
+
526
+ ## [0.10.2] - 2026-10-20
527
+
528
+ ### Added
529
+
530
+ - `deleteAgent` takes `keepChats`, so an app can take an agent off a space
531
+ without deleting the conversations it answered there. They stay readable, and
532
+ `setChatAgent` hands each to another agent. The agent's open runs in them are
533
+ canceled. (`AssistantDeleteAgentRequest`) (#469)
534
+
535
+ ### Changed
536
+
537
+ - `sendMessage` and `runAgent` refuse an agent that is deleted with
538
+ `AGENT_NOT_FOUND` instead of writing a run no device would claim. (#469)
539
+
540
+ ### Fixed
541
+
542
+ - A device that pairs onto another account no longer lists its old workspace
543
+ beside the new one. An `openMesh` sent during the pair waits for it and is
544
+ refused with `MESH_NOT_FOUND` for a workspace the pair left. (#482)
545
+ - A device that pairs onto another account no longer renames that account's user
546
+ to the name it had before; it takes the account's name. (#475)
547
+ - An edited or reverted skill reaches chats that had already loaded it. A
548
+ skill write or delete clears the hosting device's KV caches and run replay
549
+ records, so each chat's next turn reloads the skill from disk; that turn
550
+ prefills cold (QVAC-26561). (#473)
551
+ - `duck`: `/models add` keeps a vision model's projector, so its images are no
552
+ longer dropped. (#480)
553
+ - `duck`: `/models use <name>` refuses a name that is neither an added model's
554
+ label or id nor an exact catalog or registry name, instead of setting it and
555
+ letting the harness load whatever file the registry search hit first, which
556
+ could be a vision projector. A path or URL is still set as given. (#481)
557
+
558
+ ## [0.10.1] - 2026-10-19
559
+
560
+ ### Added
561
+
562
+ - `QvacAssistant` takes `runIdleTimeoutMs`, how long a run's harness may send
563
+ nothing before the run fails. It defaults to 15 minutes. (#468)
564
+
565
+ ### Changed
566
+
567
+ - `@qvac/harness` is now `^0.8.11` and `@qvac/skills` `^0.1.16`. (#468)
568
+
569
+ ### Fixed
570
+
571
+ - A run whose harness goes silent fails with "the agent stopped responding"
572
+ instead of showing busy forever. A run parked on an approval does not count
573
+ as silent. (#468)
574
+
575
+ ## [0.10.0] - 2026-10-16
576
+
577
+ ### Added
578
+
579
+ - Core's refusals carry a registered `@qvac/error` code, so a caller matches
580
+ them with `isCoreError` from `@qvac/core/errors` instead of their message,
581
+ which is unchanged. Every route family has its codes (`CHAT_*`, `MESH_*`,
582
+ `INVITE_*`, `MEMBER_*`, `DEVICE_*`, `AGENT_*`, `UPLOAD_*`, `MODEL_*`, `OAUTH_*`
583
+ and the rest, exported from `@qvac/core/errors`), and a refusal from a hosting device reaches the caller with
584
+ its code. An older host sends none, so its refusal arrives as its message
585
+ alone. Each module's codes are in its file under
586
+ [`docs/api/`](docs/api/README.md). (#382, #383, #384, #385, #386, #387, #388)
587
+ - `Logger` from `@qvac/core/log` implements `@qvac/logging`'s
588
+ `LoggerInterface`, has `getLevel()`, and takes `logLevel: 'off'`. `Client`,
589
+ `QvacAssistant`, the assistant children and the model pushers take any
590
+ `LoggerInterface`, so a `QvacLogger` can be passed. (#389)
591
+ - `duck` indexes office attachments with the harness extractor. (#457)
592
+
593
+ ### Changed
594
+
595
+ - **Breaking:** each `Core` writes only to the logger it is given, and one
596
+ created without a `logger` writes nothing, where it used to fall back to the
597
+ process-wide logger. Pass the logger to `Core`, `Client` and `QvacAssistant`.
598
+ (#389)
599
+ - `logSimilarityScores` from `@qvac/core/rag/similarity` writes only to the
600
+ logger passed as its third argument. (#389)
601
+
602
+ ```js
603
+ logSimilarityScores(candidates, kept) // 0.9
604
+ logSimilarityScores(candidates, kept, logger) // 0.10
605
+ ```
606
+
607
+ - **Breaking:** a compute mesh's dropped write is named
608
+ `COMPUTE_ROUTE_DROPPED`, where it was `ComputeRouteDropped`, and has no
609
+ `route` field. Match it by code. (#382)
610
+
611
+ ```js
612
+ err.name === 'ComputeRouteDropped' // 0.9
613
+ isCoreError(err, 'COMPUTE_ROUTE_DROPPED') // 0.10
614
+ ```
615
+
616
+ ### Removed
617
+
618
+ - **Breaking:** `setLogger` and the `globalThis.logger` it set. (#389)
619
+
620
+ ```js
621
+ setLogger(logger) // 0.9, then new Core(options)
622
+ new Core({ ...options, logger }) // 0.10
623
+ ```
624
+
625
+ - **Breaking:** `LEVELS` from `@qvac/core/log`. Use `LEVEL_PRIORITIES` from
626
+ `@qvac/logging/constants`, which ranks the other way round: `error` is 0.
627
+ (#389)
628
+
629
+ ```js
630
+ LEVELS[level] >= LEVELS.warn // 0.9
631
+ LEVEL_PRIORITIES[level] <= LEVEL_PRIORITIES.warn // 0.10
632
+ ```
633
+
634
+ ### Fixed
635
+
636
+ - An office file the agent host cannot decode reads `failed` with
637
+ `extractor unavailable on this device` in `fileStatusWatch`, and `ragSearch`
638
+ lists it in `failedFiles`, instead of staying pending forever and holding up
639
+ the run waiting on it. (#456)
640
+ - `updateMember` or `removeMember` called right after a join no longer fails
641
+ with `this device is in no member of its account`; it waits for the join to
642
+ land. (#391)
643
+ - A device that fast-forwards back onto a mesh lands without reading the view
644
+ in the update hook, as a joiner does. It used to scan every device, chat and
645
+ purged chat first. Chats deleted while it was away are found by the chat
646
+ order rebuild, purges by the device's own file index, and its own kick by
647
+ its own device row. (#465)
648
+ - A fast-forward no longer downloads every version of the view, and the
649
+ move-to sweep reads attachments only in the chats this device holds files
650
+ for, and knowledge rows whole, not every chat and attachment in the mesh. (#465)
651
+ - A linear update reads at most one old row per change. A revoked device or a
652
+ re-homed chat no longer scans every agent or a chat's whole history to find
653
+ its files, and the membership tally runs after the update instead of inside
654
+ it. (#465)
655
+ - A joiner no longer walks every chunk of the mesh it joined to backfill its
656
+ file index, and the backfill, the orphan sweep at every open and the purged
657
+ file reclaim read attachments chat by chat off an index instead of every
658
+ message. (#465)
659
+ - The view update hook only queues the update. A background pass syncs what
660
+ the device derives from the view, and folds updates that land while it runs
661
+ into one diff, so a streamed reply or a catch-up no longer walks once per
662
+ append, and the drain never waits on a peer for a block a side effect reads. (#465)
663
+ - The oldest view head a device has not synced is kept in the device-local
664
+ `@local/mesh-updates`, so a pass a close or crash cuts short resumes on the
665
+ next open instead of losing what it would have raised. (#465)
666
+
667
+ ## [0.9.0] - 2026-10-15
668
+
669
+ ### Changed
670
+
671
+ - **Breaking:** `meshInvite` mints a member invite as `qvac://workspace/…` and
672
+ a device invite as `qvac://device/…`, instead of `qvac://mesh/…`
673
+ (QVAC-26926). `joinMesh`, `previewMeshInvite` and `decodeMeshInvite` read all
674
+ three, so a link shared before still works, but a release before this one
675
+ refuses the new links with `Invalid mesh invite`: both sides of a join need
676
+ this version. An app that matches the prefix itself has to accept all three
677
+ before it takes this release, as tetherto/qvac-app#2535 does. (#394)
678
+
679
+ ```js
680
+ const { invite } = await engine.meshInvite({ meshId, member: true })
681
+ // 0.8: qvac://mesh/… 0.9: qvac://workspace/…
682
+ const { invite: pairing } = await engine.meshInvite({})
683
+ // 0.8: qvac://mesh/… 0.9: qvac://device/…
684
+ ```
685
+
686
+ ## [0.8.0] - 2026-10-15
687
+
688
+ ### Added
689
+
690
+ - `skillCatalog` entries carry `displayName`, the user-facing name and `@`
691
+ handle a skill's manifest declares, so an app can show Documents and
692
+ Spreadsheets for the `word` and `excel` skills without renaming them. (#392)
693
+
694
+ ```js
695
+ const { skills } = await engine.skillCatalog({ agentId: agent.id })
696
+ const handle = skills.map((skill) => skill.displayName ?? skill.name)
697
+ ```
698
+
699
+ - `meshStatusWatch` frames carry `blindPeersConnected` and `blindPeersTotal`,
700
+ the device's blind peers holding a connection of those it dials; a blind
701
+ peer connecting or dropping makes a frame. (#403)
702
+ - Every mesh lifecycle line carries where the mesh stood: `opening` names the
703
+ head it boots from (`null` is a replay from genesis), `autobee opened`,
704
+ `landed on the view`, `joined` and `closing` carry the local, system and
705
+ view lengths, the flushes, autobee's counters and the time since the open;
706
+ Core logs `mesh opened` with why (`route`, `follow`, `readmit`) and how long,
707
+ `followed the joined meshes` with its tally, and names the mesh it announces.
708
+ `diagnostics` returns the same counters under `stats.mesh.stats`. The two
709
+ seed lines (`seeded default agent`, `seeded first chat`) are debug: a rebuilt
710
+ view re-applies the genesis seed, and they read as a second seeding. (#403)
711
+
712
+ ### Changed
713
+
714
+ - Joining a mesh reports joined as soon as the fast-forward lands, instead of
715
+ after a read of the whole view over the network. On a mesh with a long
716
+ history that read took tens of seconds, whatever the invite's head. The
717
+ member tally, mesh name, chat order and file index fill in moments after the
718
+ landing; a chat list in that window waits for the rebuild. (#400)
719
+ - The mesh logs `landed on the view` and `joined` with their timings, applies
720
+ and undos, and `device admitted` is a debug line: a catch-up re-applies every
721
+ claim on each re-linearisation. (#400)
722
+ - The meshes an account names open once the account's own join has settled,
723
+ instead of the moment the account lands, so they no longer compete with the
724
+ account's catch-up for the same peers. (#407)
725
+
726
+ ### Fixed
727
+
728
+ - A mesh the account names on a sibling's behalf, opened with no head of its
729
+ own, fast-forwards onto the first head a sibling device offers, instead of
730
+ replaying from genesis until that device's row happened to land. The head's
731
+ own view carries the device's signed claim to the writer, and the account
732
+ says whose device that is. (#408)
733
+ - One blind-peering client per device, shared by every mesh and core. Each mesh
734
+ (and the config, recovery, departure and drive cores) built its own client,
735
+ all dialling under the device's one key, and a blind peer keeps one connection
736
+ per key: every connect by one mesh dropped another's, endlessly. A mesh's
737
+ invite still names the blind peers it is mirrored on; what is shared is the
738
+ connection to each. (#405)
739
+ - A device no longer dials every device in its account mesh directly on each
740
+ membership change; peers are found on the mesh topic. (#405)
741
+ - A device coming back after a long absence fast-forwards onto the new head
742
+ without diffing the whole view across cores: it reads the landed snapshot,
743
+ and the attachments deleted while it was away refresh on the sweep. On a mesh
744
+ with ~20k rows that jump took 110–150 s; it now takes a few seconds. (#399,
745
+ #402)
746
+
747
+ ## [0.7.6] - 2026-10-14
748
+
749
+ ### Added
750
+
751
+ - `duck`: `/tools` (and Menu ▸ Agent ▸ Tools) is back as the toolset switches, each
752
+ listing the tools it gates, read from the device the agent runs on. `/permissions`
753
+ keeps only the approval mode. (#380)
754
+
755
+ ### Fixed
756
+
757
+ - `duck`: copying (ctrl+y, or a drag selection) works with no clipboard command, in
758
+ a container or over ssh. It asks the terminal to set the clipboard with OSC 52,
759
+ which the terminal has to allow, and `xsel` is tried after `wl-copy` and
760
+ `xclip`. (#395)
761
+
762
+ ## [0.7.5] - 2026-10-13
763
+
764
+ ### Fixed
765
+
766
+ - A reply cut off by a phone lock now restarts on unlock instead of ending as
767
+ failed (QVAC-24690). Between `presuspend` and `suspend` iOS refuses GPU work,
768
+ so the harness ends the turn with an error event or an abort of its own.
769
+ While the assistant is in the background that ending now replays the run
770
+ under the same `runId`, for chat and capability runs alike, and a run that
771
+ arrives in that window waits. A `resume` from `presuspend` starts both again.
772
+ A thrown error still fails the run, and a context overflow reported during
773
+ that window folds after the resume instead. (#368)
774
+
775
+ ## [0.7.4] - 2026-10-13
776
+
777
+ ### Added
778
+
779
+ - A mesh write still pending after five seconds, or a mesh's first drain
780
+ still pending after fifteen, logs a warning once: the ops a write carries,
781
+ the drain's counters, and every core the views read through that this device
782
+ holds only in part, with how many peers could serve it, and which blind peers
783
+ it has reached. Writes queued behind
784
+ the same stall do not repeat it, and it logs again when the stall settles or
785
+ the write fails. A drain parked on data no connected peer holds used to say
786
+ nothing, so a hung send, stop, delete or leave left no trace in an exported
787
+ log.
788
+ - Leaving a mesh logs when it starts, so an exported log shows the attempt even
789
+ when the leave never finishes. (#352)
790
+
791
+ - Model routes reach another device of this account (QVAC-25101). `listModels`,
792
+ `modelsWatch`, `loadModel`, `unloadModel`, `deleteModel`, `retryModelDownload`,
793
+ `clearModelDownload`, `modelUsers`, the custom-model routes and the model
794
+ watches take an optional `deviceId`, and Core runs the call on that device over
795
+ the `qvac/device-control` peer channel, so fit, memory, disk and the download
796
+ queue are that device's. Only a live device of this account's own member is
797
+ served, and a custom model added from another device must come from a link.
798
+ While the device is away a call rejects with `the device is not reachable`;
799
+ `meshStatusWatch`'s `peerDeviceIds` says when it is connected again. (#280)
800
+
801
+ ```js
802
+ await engine.loadModel({ name: 'Qwen3.5-9B-Q4_K_M', deviceId: desktop.id })
803
+ ```
804
+
805
+ - A phone changes a paired desktop's own model settings and pauses its
806
+ downloads. `configGet`, `configSet` and `configWatch` take an optional
807
+ `deviceId` and reach `model.idleUnloadMinutes` and `model.memoryCapPercent` on
808
+ that device; any other key is refused there, since the same store holds
809
+ integration tokens. `setModelPaused` takes `deviceId` too, so a download on the
810
+ desktop pauses there rather than on the phone, until the desktop restarts. (#359)
811
+
812
+ ```js
813
+ import { MODEL_MEMORY_CAP_KEY } from '@qvac/core/constants'
814
+
815
+ await engine.configSet({ key: MODEL_MEMORY_CAP_KEY, value: 60, deviceId: desktop.id })
816
+ await engine.setModelPaused({ name: 'Qwen3.5-9B-Q4_K_M', paused: true, deviceId: desktop.id })
817
+ ```
818
+
819
+ - `duck`: `/device use <n|name>` points every `/models` command at another
820
+ device of this account, and `/device list` shows each one, whether it is
821
+ connected and how many models it has downloaded. `/models idle`,
822
+ `/models cap` and `/models settings` set and show a device's idle limit and
823
+ memory cap, and `/models pause` / `/models resume` hold a download. (#360)
824
+
825
+ ### Changed
826
+
827
+ - `loadModel`, `unloadModel`, `deleteModel`, `modelUsers`,
828
+ `clearModelDownload`, `retryModelDownload` and `removeCustomModel` had a
829
+ request of `name` alone; its new optional `deviceId` adds a flags byte, so
830
+ this Core cannot decode those calls from a `Client` of an earlier release
831
+ (`Out of bounds`). Upgrade the `Client` with the Core.
832
+ - `configGet`, `configWatch` and `configSet` gain the same flags byte with
833
+ their optional `deviceId`, so this Core cannot decode them from a `Client` of
834
+ an earlier release either. (#280, #359)
835
+ - `duck --join <invite>` now takes only a member invite, and the new `duck --device-join <invite>` takes only a device invite; each refuses the other's and names the right flag. `/join` previews say whether the current mesh is retired, and `/invite` says how the invitee joins. `/meshes` tags the account mesh as `home (your account)` and its footer says how to name a mesh. (#377)
836
+
837
+ ### Fixed
838
+
839
+ - Suspending no longer logs every watch it closes as `watch failed` with a
840
+ bare `Stream was destroyed`. The assistant ended those streams itself, so
841
+ none of them failed.
842
+ - A log line that carries an error in its details, such as
843
+ `{ op, err }`, prints the error's stack instead of `{}`. A destroyed stream's
844
+ error records the code that destroyed it, so the log now says why it ended.
845
+ - A device lending its compute no longer crashes when the borrower drops a call
846
+ while the lender is still accepting it. Before, the dropped stream's error
847
+ went unhandled and took the lender's whole process down. (#355)
848
+ - `updateAgent` and `deleteAgent` stamp their write after the row it replaces,
849
+ so an edit or a delete made on a device whose clock runs behind the last
850
+ writer's is applied instead of dropped as stale. A dropped delete had still
851
+ deleted the agent's chats. (#358)
852
+ - `duck` started with a device invite no longer fails with
853
+ `This device cannot reach its account to check`. It asked for its own invite
854
+ while the join was still under way; it now waits for the join to finish.
855
+
856
+ ## [0.7.3] - 2026-10-13
857
+
858
+ ### Changed
859
+
860
+ - `MAX_AUDIO_ATTACHMENT_BYTES` (`@qvac/core/audio-format`) rises from 25 MiB to 100 MiB, matching `MAX_ATTACHMENT_BYTES`, so a client no longer refuses audio the mesh accepts. (#375)
861
+
862
+ ## [0.7.2] - 2026-10-13
863
+
864
+ ### Added
865
+
866
+ - `duck --join <invite>` (`-j`) joins a mesh invite at boot, so a `--headless` peer, which has no prompt to `/join` from, can get onto an existing mesh. A device invite pairs it into your account; a member invite adds a shared mesh to its own. (#371)
867
+
868
+ ```sh
869
+ duck --headless --storage ~/duck-data --join qvac://mesh/…
870
+ ```
871
+
872
+ - `/rename device <name>` names this device and `/rename member <name>` names you in every mesh at once, so a roster of `duck-<pid>` devices can be told apart. (#372)
873
+
874
+ ## [0.7.1] - 2026-10-12
875
+
876
+ ### Added
877
+
878
+ - `forkChat` copies a chat into a new one, through a turn or just before it, in
879
+ the same mesh or another (QVAC-26722). The source stays as it was, the fork
880
+ lands on top of its list with ids of its own, and `AssistantChat` names where
881
+ it came from in `forkedFrom`. Its files are its own copies, so removing one
882
+ in either chat leaves the other's, and into another mesh it needs one of that
883
+ mesh's agents. (#346)
884
+
885
+ ```js
886
+ const fork = await engine.forkChat({ meshId, chatId, runId: reply.runId })
887
+ ```
888
+
889
+ - `setBlindPeering` and `blindPeeringWatch` turn every blind peering on this
890
+ device off or back on, kept across restarts, for reproducing sync with no
891
+ mirror in the middle. `diagnostics` reports it as `stats.mesh.blindPeering`,
892
+ and a `recoveryPublish` made while it is off does not mark the account
893
+ recoverable. (#334)
894
+
895
+ ```js
896
+ await engine.setBlindPeering({ enabled: false })
897
+ ```
898
+
899
+ ### Changed
900
+
901
+ - `@qvac/harness` is `^0.8.7` and `@qvac/skills` 0.1.14, which bring the
902
+ `browser` skill. Every run now hands the harness its chat as `session`, with
903
+ or without a cache key, so a skill whose manifest declares
904
+ `${session}` in its `env` keeps one resource per chat, such as the browser
905
+ the `browser` skill drives. (#369)
906
+ - `createAgent` and `updateAgent` ignore `toolsScope` and `enabledTools` and
907
+ always store `toolsScope: 'all'`, leaving `disabledToolsets` as the only
908
+ per-agent gate on tools. Each mesh rewrites its stored `selected` agents to
909
+ `all` once on open, so an agent saved with an empty list runs with its tools
910
+ again. (#363)
911
+
912
+ ### Fixed
913
+
914
+ - The harness is handed the turn as typed, so a skill mention or a search ask
915
+ is read from what the user wrote, not from attached documents, knowledge or
916
+ sender lines wrapped around it (QVAC-24963). Before,
917
+ `@pdf Summarize these docs` with a PDF attached could load
918
+ `image-generation`, and a document saying "search the web" went out as the
919
+ search query. (#347)
920
+ - The model downloader picks the text-to-speech model for the profile the
921
+ hardware probe found, the same one speaking asks for (QVAC-25679). Before, a
922
+ new device could plan its downloads while its row still held the host's seed
923
+ profile and keep that for the session, so a "mid" or higher device fetched
924
+ `Supertonic3-Q4_0` while read aloud waited for `Supertonic3-FP16` and stayed
925
+ disabled until a restart. If the probe fails, it plans for "low", the voice
926
+ the harness then speaks with. (#367)
927
+ - A device dials the other devices of its account by key as well as finding
928
+ them on the mesh topic, and dials them again on resume. Before, a topic
929
+ refresh that missed after a suspend or a network change left a phone without
930
+ its Mac for ten minutes or more, so a chat with an agent the Mac hosted sat
931
+ on "waiting to reconnect" though both were online. (#327)
932
+ - `removeDevice` on a device of our own member moves the agents it hosted to
933
+ the device that removed it, in that mesh and, for a removal from the account,
934
+ in every shared mesh of ours it is revoked in, so a run waiting on the removed
935
+ device runs there; a removal made on an earlier build is caught up on the
936
+ next boot. Before, the agents stayed orphaned and the chat waited forever.
937
+ (#327)
938
+
939
+ ## [0.7.0] - 2026-10-09
940
+
941
+ ### Added
942
+
943
+ - Model downloads can wait to be asked for, so a phone on cellular does not
944
+ fetch gigabytes on its own. Pass `autoDownloadModels: false` to the Core
945
+ constructor so it holds from the first boot, or toggle it later. A run that
946
+ needs a missing model then waits as `awaiting-download` instead of fetching it,
947
+ and so do image, music, transcription, speech and embedding loads in the
948
+ harness (#332, #333):
949
+
950
+ ```js
951
+ await engine.setAutoDownloadModels({ enabled: false })
952
+ for await (const { downloads } of engine.modelDownloadsWatch({})) {
953
+ const held = (downloads ?? []).find((row) => row.phase === 'held')
954
+ if (held) {
955
+ await engine.retryModelDownload({ name: held.name })
956
+ break
957
+ }
958
+ }
959
+ ```
960
+
961
+ - The OAuth loopback serves callbacks under Bare too, so a mobile worklet can
962
+ complete sign-in on the same `127.0.0.1` redirect desktop registers. (#329)
963
+ - `openOAuthLoopback` takes an optional `returnTo`: the callback redirects the
964
+ browser there instead of showing the done page. (#329)
965
+ - Several models stay loaded when memory allows (QVAC-25735). On desktop the
966
+ assistant pushes `model.memoryCapPercent` to the harness: loaded models may
967
+ fill that share of the memory usable for models, 85% by default, so two chat
968
+ models that fit stay loaded and switching chats between them loads neither
969
+ again. A load that would not fit unloads idle models one at a time, other
970
+ kinds before chat models and the least recently used first. It applies with
971
+ no restart; the minimum keeps one chat model loaded, and a mobile device
972
+ always does. `listModels` and `modelsWatch` carry the device's `memory`
973
+ (`usableBytes`, `capPercent`, `capBytes`, `usedBytes`, and `overCap` when a
974
+ model larger than the cap loaded anyway) and each loaded row its
975
+ `memoryBytes`, so a Models screen shows used against the cap. Needs the
976
+ `@qvac/harness` release with `setModelMemoryCap` and `memoryUsage`; an older
977
+ one keeps one chat model loaded and lists no `memory`. (#343)
978
+
979
+ ```js
980
+ import { MODEL_MEMORY_CAP_KEY } from '@qvac/core/constants'
981
+
982
+ await engine.configSet({ key: MODEL_MEMORY_CAP_KEY, value: 70 })
983
+ const { memory } = await engine.listModels({ cachedOnly: true })
984
+ ```
985
+
986
+ - A device pairs and follows its member with no other device online. A device
987
+ invite carries a keypair attested into the inviter's member, so the joiner
988
+ links itself, and the account holds every shared mesh's seed (the new
989
+ `@qvac/put-mesh-seed` route), so a new device opens them all from a blind
990
+ peer alone. A device invite minted by 0.6.6 still admits a device but no
991
+ longer links it into the member. `meshInvite` refuses a device invite from a
992
+ device whose proof chain is too long to extend, naming another device or the
993
+ phrase instead. (#342)
994
+ - `diagnostics` carries `backendUse`: per tool, the backends its recent runs
995
+ on this device reported, newest last. A run that asked for the gpu and ran
996
+ on the cpu is the fallback to look for. (#22)
997
+
998
+ ```js
999
+ const { stats } = await engine.diagnostics({})
1000
+ stats.backendUse.generate_music.at(-1)
1001
+ // { requestedGpu: true, device: 'cpu', backend: 'cpu' }
1002
+ ```
1003
+
1004
+ - `duck`: `/doctor` checks this device (hardware, engine, model backends, mesh,
1005
+ network) and `/doctor debug` shows the raw diagnostics frame behind it.
1006
+ `ctrl+y` copies either as plain text, with the mesh seed and any invite
1007
+ redacted and keys truncated. (#22)
1008
+
1009
+ ### Changed
1010
+
1011
+ - An invite is a password again, as it was before 0.5.0. A member invite mints
1012
+ no grant and a device invite no expiring token: either link is the mesh
1013
+ seed, reusable for good, and the joining device admits itself with the new
1014
+ `@qvac/open-join` route; `joinMesh` and `recoverAccount` return once the
1015
+ join is recorded, appending it in the background, with the account reporting
1016
+ `joining` until the mesh reaches it. A device invite pairs with the inviting
1017
+ device offline, and `recoverAccount` needs no other device online. A removed
1018
+ device comes back the next time it joins. Every route that shipped keeps its
1019
+ 0.6.6 meaning, and a 0.6.6 or 0.6.7 replica halts on the new one, so this
1020
+ raises the floor to `>=0.19.1`. (#342)
1021
+
1022
+ ```js
1023
+ const { invite } = await engine.meshInvite({ member: true })
1024
+ await engine.joinMesh({ invite }) // any number of times, by anyone holding it
1025
+ ```
1026
+
1027
+ - `joinMesh` and `recoverAccount` fail with "This device has no device
1028
+ details: pass `device` when creating Core" on a Core created without
1029
+ `device` and with none stored, and a `meshSeed` boot reports it as its
1030
+ status error: a mesh admits only a device it can list and remove. (#342)
1031
+
1032
+ - A mesh still `joining` refuses a write into it at once with "This mesh is
1033
+ still joining: it accepts writes once it is joined", since nothing written
1034
+ there reaches disk until a peer serves the mesh. Reads keep working; retry
1035
+ the write once the mesh lists `joined`. (#342)
1036
+
1037
+ - `listMeshes` and `meshesWatch` rows no longer set `reason` or
1038
+ `awaitingFrom`: no other device admits a joining one any more. Read
1039
+ `state: 'joining'` alone. (#342)
1040
+
1041
+ ### Deprecated
1042
+
1043
+ - `meshEntry.reason` and `meshEntry.awaitingFrom`, which are never set. (#342)
1044
+
1045
+ ### Removed
1046
+
1047
+ - The `grantWritableMs`, `grantVisibleMs` and `accountWritableMs` Core options.
1048
+ Nothing on a join, a mint or a logout waits for a mesh to go writable any
1049
+ more: a departure the mesh cannot take yet is revoked by the departures
1050
+ outbox once it can, and a mesh minted before the account can write is
1051
+ registered there once it can. (#342)
1052
+
1053
+ ### Fixed
1054
+
1055
+ - A chat's KV cache no longer grows by duplicated history: each run is replayed
1056
+ to the model exactly as it was sent. (#338)
1057
+ - A chat handed to another agent on the same device, by `setChatAgent` or a
1058
+ `sendMessage` naming another `agentId`, no longer leaves the old agent's KV
1059
+ cache file on disk until the chat is deleted. (#330)
1060
+ - Reopening the account mesh after its local database died clears "the local
1061
+ database died" error once the reopened mesh is healthy. (#340)
1062
+ - `duck`: `/agent new` gives the new agent a real model in a mesh with no agent
1063
+ yet, and `/agent use` hands the open chat to the agent it selects. (#348, #331)
1064
+
1065
+ ## [0.6.7] - 2026-10-06
1066
+
1067
+ ### Added
1068
+
1069
+ - A `quack` model for testing mesh, sync and chat flows without inference. An
1070
+ agent on it replies with `quack` repeated 1 to 500 times, counted from a hash
1071
+ of the last user turn, so the same prompt always gets the same reply. Every
1072
+ other model still runs on the real harness. The device-local
1073
+ `debug.fakeModels` key (`FAKE_MODELS_KEY` in `@qvac/core/constants`, beside the `QUACK_MODEL` name) turns it
1074
+ on and off live, which is what an app's Debug toggle writes. `assistantChild`
1075
+ and `assistantTree` take `fakeModels: true` to force it on, which is what duck
1076
+ does with its `--fake-models` flag or `QVAC_FAKE_MODELS=1`.
1077
+
1078
+ ```js
1079
+ await engine.configSet({ key: FAKE_MODELS_KEY, value: true })
1080
+ ```
1081
+
1082
+ ```sh
1083
+ QVAC_MODEL=quack duck --temp --fake-models
1084
+ ```
1085
+
1086
+ - `Core` accepts `store`, `swarm` and `wakeup`, so a host that is already a
1087
+ peer-to-peer application passes the ones it runs rather than having Core
1088
+ stand up a second of each. Core never closes, destroys or suspends what it
1089
+ was passed, takes the device identity from a passed swarm's keypair, and
1090
+ leaves replication and wakeup on a passed swarm to the host. `swarm`
1091
+ requires `store` and `wakeup`. The host suspends Core before its store, and
1092
+ resumes its store before resuming or closing Core. `storagePath` is
1093
+ unchanged and still holds the device-local database. See
1094
+ [the decision record](docs/decisions/2026-09-28-a-host-passes-core-its-corestore-and-swarm.md).
1095
+
1096
+ ```js
1097
+ const core = new Core(transport, {
1098
+ storagePath,
1099
+ store: host.rootCorestore.namespace('qvac'),
1100
+ swarm: host.swarm,
1101
+ wakeup: host.wakeup
1102
+ })
1103
+ ```
1104
+
1105
+ (#303)
1106
+
1107
+ ### Changed
1108
+
1109
+ - `@qvac/skills` is pinned at 0.1.11. 0.1.12 grants the `pptx`, `docx`, `xlsx`
1110
+ and `transcribe_music` tools, which `@qvac/harness` does not register yet, so
1111
+ a range would let a fresh install read presentations, word and excel as
1112
+ unsupported. (#321)
1113
+
1114
+ ### Fixed
1115
+
1116
+ - The assistant reports readiness for an agent newly hosted in the account as
1117
+ soon as it lands there, as it already did in a shared mesh, so a credential
1118
+ handed off to an agent created from another device no longer waits on it.
1119
+ (#320)
1120
+
1121
+ ## [0.6.6] - 2026-10-05
1122
+
1123
+ ### Changed
1124
+
1125
+ - The consensus floor, `VENDORED_MIN_SUPPORTED_VERSION`, is back to `>=0.19.0`.
1126
+ The app ships the #308 apply change in 0.19, so that release is the floor; at
1127
+ `>=0.20.0` a 0.19 build would withhold itself from its own meshes. (#317)
1128
+
1129
+ ## [0.6.5] - 2026-10-01
1130
+
1131
+ ### Added
1132
+
1133
+ - `setMeshName` names a mesh for every member in it. `setMeshLabel` only
1134
+ names it for the member who set it, so someone who joined a shared mesh read
1135
+ it unnamed. `listMeshes` and `meshesWatch` rows carry the shared name as
1136
+ `name`, and `meshesWatch` emits when another member renames the mesh. A build
1137
+ older than this one halts on the new `name-mesh` op, so every member's devices
1138
+ need this release before a mesh is named.
1139
+
1140
+ ```js
1141
+ await engine.setMeshName({ meshId, name: 'Design team' })
1142
+ const { meshes } = await engine.listMeshes({})
1143
+ meshes.find((mesh) => mesh.meshId === meshId).name // 'Design team', on every member
1144
+ ```
1145
+
1146
+ (#310)
1147
+
1148
+ - `moveChatToMesh` moves a chat to another mesh with its files and its running
1149
+ turn: the copy lands at once under `targetChatId`, the turn is retried there,
1150
+ and the source is purged once every file has arrived. `chatMoveWatch` reports
1151
+ the move, and `setChatAgent` hands a chat to another agent of its mesh. Until
1152
+ its bytes arrive, a moved attachment's `blobId` is `PENDING_BLOB_REFERENCE`,
1153
+ which `downloadAttachment` rejects with `blob unavailable`. (#312)
1154
+ - `chunksDeltaWatch` streams an open chat as changes: a `reset` with the whole
1155
+ selection first, then only the rows appended, edited or reordered, and the ids
1156
+ of rows that left. A transcript that re-rendered the whole chat on every
1157
+ streamed chunk pays for one row per chunk instead; `chunksWatch` is
1158
+ unchanged. (#314)
1159
+
1160
+ ### Changed
1161
+
1162
+ - The consensus floor, `VENDORED_MIN_SUPPORTED_VERSION`, is `>=0.20.0`. How a
1163
+ re-paired device's removal is weighed changed in apply, so a device on an
1164
+ older build would read a shared mesh differently. Ship the 0.20 app before
1165
+ publishing this floor to the lane cores. (#308)
1166
+ - `@qvac/harness` is `^0.7.2`. `web_fetch` attaches a plain-text file it
1167
+ fetched to the chat beside returning its text, and devices on the `mid`
1168
+ profile and up speak with `Supertonic3-FP16` at 16 steps instead of
1169
+ `Supertonic3-Q8_0` at 5, so a host that prefetches the infra models downloads
1170
+ the FP16 model once. (#311)
1171
+
1172
+ ### Fixed
1173
+
1174
+ - A device unpaired and paired back gets every project back, however its
1175
+ removal synced, and one that left a shared mesh on its own comes back as soon
1176
+ as it asks; only another member's removal still needs a grant. A re-paired
1177
+ device still live on its old writer is moved onto its new one instead of
1178
+ staying a reader, and a late leave no longer turns a kick into a leave. A
1179
+ consensus change, covered by the `>=0.20.0` floor. (#308)
1180
+ - A member re-invited to a mesh it left brings every device back, not only the
1181
+ one that redeemed the invite. A device asking its siblings to admit it asks
1182
+ again, about once a second for up to a minute, while they are mid-join,
1183
+ instead of waiting as a reader until the next restart. (#307)
1184
+ - `leaveMesh` on the account is no longer refused while this device holds
1185
+ another mesh: it departs each of them as this device alone, then leaves the
1186
+ account. Unpairing a device that held a project did nothing. (#306)
1187
+ - `chatActivityWatch` no longer fails on every tick after a fast-forward leaves
1188
+ its cached view head undiffable. It rebuilds from the current view instead;
1189
+ before, the error repeated until restart. (#301)
1190
+ - `modelCatalogWatch` bumps only when the custom-model set changed. It bumped on
1191
+ every device-local write, several times a second while a reply streamed. (#300)
1192
+ - A typed harness can ask `fetchAttachment` for the newest audio. (#309)
1193
+ - PDF extraction works on Android again: `bare-pdfium` 1.5.5 links its C++
1194
+ runtime into the addon, which 1.5.4's prebuilds left undefined. (#305)
1195
+
16
1196
  ## [0.6.4] - 2026-09-30
17
1197
 
18
1198
  ### Removed
@@ -1159,7 +2339,29 @@ Published under the `release-0.1` dist-tag.
1159
2339
  await assistant.ready()
1160
2340
  ```
1161
2341
 
1162
- [Unreleased]: https://github.com/tetherto/qvac-core/compare/v0.6.4...HEAD
2342
+ [Unreleased]: https://github.com/tetherto/qvac-core/compare/v0.11.4...HEAD
2343
+ [0.11.4]: https://github.com/tetherto/qvac-core/compare/v0.11.3...v0.11.4
2344
+ [0.11.3]: https://github.com/tetherto/qvac-core/compare/v0.11.2...v0.11.3
2345
+ [0.11.2]: https://github.com/tetherto/qvac-core/compare/v0.11.1...v0.11.2
2346
+ [0.11.1]: https://github.com/tetherto/qvac-core/compare/v0.11.0...v0.11.1
2347
+ [0.11.0]: https://github.com/tetherto/qvac-core/compare/v0.10.4...v0.11.0
2348
+ [0.10.4]: https://github.com/tetherto/qvac-core/compare/v0.10.3...v0.10.4
2349
+ [0.10.3]: https://github.com/tetherto/qvac-core/compare/v0.10.2...v0.10.3
2350
+ [0.10.2]: https://github.com/tetherto/qvac-core/compare/v0.10.1...v0.10.2
2351
+ [0.10.1]: https://github.com/tetherto/qvac-core/compare/v0.10.0...v0.10.1
2352
+ [0.10.0]: https://github.com/tetherto/qvac-core/compare/v0.9.0...v0.10.0
2353
+ [0.9.0]: https://github.com/tetherto/qvac-core/compare/v0.8.0...v0.9.0
2354
+ [0.8.0]: https://github.com/tetherto/qvac-core/compare/v0.7.6...v0.8.0
2355
+ [0.7.6]: https://github.com/tetherto/qvac-core/compare/v0.7.5...v0.7.6
2356
+ [0.7.5]: https://github.com/tetherto/qvac-core/compare/v0.7.4...v0.7.5
2357
+ [0.7.4]: https://github.com/tetherto/qvac-core/compare/v0.7.3...v0.7.4
2358
+ [0.7.3]: https://github.com/tetherto/qvac-core/compare/v0.7.2...v0.7.3
2359
+ [0.7.2]: https://github.com/tetherto/qvac-core/compare/v0.7.1...v0.7.2
2360
+ [0.7.1]: https://github.com/tetherto/qvac-core/compare/v0.7.0...v0.7.1
2361
+ [0.7.0]: https://github.com/tetherto/qvac-core/compare/v0.6.7...v0.7.0
2362
+ [0.6.7]: https://github.com/tetherto/qvac-core/compare/v0.6.6...v0.6.7
2363
+ [0.6.6]: https://github.com/tetherto/qvac-core/compare/v0.6.5...v0.6.6
2364
+ [0.6.5]: https://github.com/tetherto/qvac-core/compare/v0.6.4...v0.6.5
1163
2365
  [0.6.4]: https://github.com/tetherto/qvac-core/compare/v0.6.3...v0.6.4
1164
2366
  [0.6.3]: https://github.com/tetherto/qvac-core/compare/v0.6.2...v0.6.3
1165
2367
  [0.6.2]: https://github.com/tetherto/qvac-core/compare/v0.6.1...v0.6.2