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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (579) hide show
  1. package/CHANGELOG.md +1205 -1
  2. package/README.md +56 -45
  3. package/dist-lib/index.d.ts +3 -2
  4. package/dist-lib/index.js +1 -1
  5. package/dist-lib/lib/api/agent-folders.d.ts +22 -0
  6. package/dist-lib/lib/api/agent-folders.js +115 -0
  7. package/dist-lib/lib/api/agents.d.ts +20 -2
  8. package/dist-lib/lib/api/agents.js +128 -24
  9. package/dist-lib/lib/api/app-config.d.ts +7 -1
  10. package/dist-lib/lib/api/app-config.js +37 -6
  11. package/dist-lib/lib/api/approval-rules.d.ts +1 -1
  12. package/dist-lib/lib/api/approval-rules.js +12 -5
  13. package/dist-lib/lib/api/attachments.d.ts +1 -1
  14. package/dist-lib/lib/api/attachments.js +14 -2
  15. package/dist-lib/lib/api/chat-move.d.ts +4 -0
  16. package/dist-lib/lib/api/chat-move.js +7 -0
  17. package/dist-lib/lib/api/chat.d.ts +12 -2
  18. package/dist-lib/lib/api/chat.js +100 -9
  19. package/dist-lib/lib/api/chunk-delta.d.ts +12 -0
  20. package/dist-lib/lib/api/chunk-delta.js +115 -0
  21. package/dist-lib/lib/api/chunks.d.ts +19 -2
  22. package/dist-lib/lib/api/chunks.js +73 -13
  23. package/dist-lib/lib/api/config.d.ts +11 -3
  24. package/dist-lib/lib/api/config.js +51 -5
  25. package/dist-lib/lib/api/current-mesh.d.ts +13 -5
  26. package/dist-lib/lib/api/current-mesh.js +15 -11
  27. package/dist-lib/lib/api/custom-models.d.ts +7 -1
  28. package/dist-lib/lib/api/custom-models.js +12 -12
  29. package/dist-lib/lib/api/device-routes.d.ts +14 -0
  30. package/dist-lib/lib/api/device-routes.js +144 -0
  31. package/dist-lib/lib/api/devices.d.ts +3 -2
  32. package/dist-lib/lib/api/devices.js +28 -28
  33. package/dist-lib/lib/api/diagnostics.d.ts +2 -1
  34. package/dist-lib/lib/api/diagnostics.js +2 -2
  35. package/dist-lib/lib/api/execution.d.ts +16 -1
  36. package/dist-lib/lib/api/execution.js +72 -16
  37. package/dist-lib/lib/api/files.d.ts +1 -1
  38. package/dist-lib/lib/api/files.js +65 -8
  39. package/dist-lib/lib/api/host-run-log.d.ts +2 -41
  40. package/dist-lib/lib/api/host-run-log.js +35 -83
  41. package/dist-lib/lib/api/index.d.ts +39 -7
  42. package/dist-lib/lib/api/index.js +116 -36
  43. package/dist-lib/lib/api/instrument.d.ts +2 -2
  44. package/dist-lib/lib/api/instrument.js +24 -48
  45. package/dist-lib/lib/api/knowledge.d.ts +4 -1
  46. package/dist-lib/lib/api/knowledge.js +25 -7
  47. package/dist-lib/lib/api/local-files.d.ts +5 -1
  48. package/dist-lib/lib/api/local-files.js +9 -5
  49. package/dist-lib/lib/api/logs.js +3 -3
  50. package/dist-lib/lib/api/members.d.ts +10 -1
  51. package/dist-lib/lib/api/members.js +69 -44
  52. package/dist-lib/lib/api/mesh.d.ts +15 -6
  53. package/dist-lib/lib/api/mesh.js +13 -9
  54. package/dist-lib/lib/api/model-download.d.ts +2 -1
  55. package/dist-lib/lib/api/model-download.js +2 -2
  56. package/dist-lib/lib/api/network.d.ts +10 -2
  57. package/dist-lib/lib/api/network.js +8 -2
  58. package/dist-lib/lib/api/notifications.d.ts +3 -1
  59. package/dist-lib/lib/api/notifications.js +14 -9
  60. package/dist-lib/lib/api/projects.d.ts +20 -0
  61. package/dist-lib/lib/api/projects.js +172 -0
  62. package/dist-lib/lib/api/rag-plugin.d.ts +17 -0
  63. package/dist-lib/lib/api/rag-plugin.js +44 -0
  64. package/dist-lib/lib/api/rag.d.ts +0 -1
  65. package/dist-lib/lib/api/rag.js +106 -33
  66. package/dist-lib/lib/api/served.d.ts +17 -0
  67. package/dist-lib/lib/api/served.js +65 -0
  68. package/dist-lib/lib/api/sync.d.ts +2 -1
  69. package/dist-lib/lib/api/sync.js +13 -3
  70. package/dist-lib/lib/api/tool-activity.d.ts +2 -1
  71. package/dist-lib/lib/api/tool-activity.js +4 -3
  72. package/dist-lib/lib/api/tool-configs.d.ts +2 -1
  73. package/dist-lib/lib/api/tool-configs.js +6 -9
  74. package/dist-lib/lib/api/upload-frames.d.ts +0 -1
  75. package/dist-lib/lib/api/upload-frames.js +0 -1
  76. package/dist-lib/lib/api/watchable.d.ts +3 -2
  77. package/dist-lib/lib/api/watchable.js +2 -3
  78. package/dist-lib/lib/api/workspace.d.ts +12 -0
  79. package/dist-lib/lib/api/workspace.js +61 -0
  80. package/dist-lib/lib/assistant/fake-models.d.ts +20 -0
  81. package/dist-lib/lib/assistant/fake-models.js +112 -0
  82. package/dist-lib/lib/assistant/harness.d.ts +48 -31
  83. package/dist-lib/lib/assistant/harness.js +51 -10
  84. package/dist-lib/lib/assistant/history.d.ts +37 -17
  85. package/dist-lib/lib/assistant/history.js +212 -87
  86. package/dist-lib/lib/assistant/host-run-log.d.ts +6 -1
  87. package/dist-lib/lib/assistant/host-run-log.js +24 -36
  88. package/dist-lib/lib/assistant/media-round.d.ts +61 -0
  89. package/dist-lib/lib/assistant/media-round.js +111 -0
  90. package/dist-lib/lib/assistant/message.d.ts +28 -1
  91. package/dist-lib/lib/assistant/message.js +65 -2
  92. package/dist-lib/lib/assistant/model-round.d.ts +118 -0
  93. package/dist-lib/lib/assistant/model-round.js +706 -0
  94. package/dist-lib/lib/assistant/pdf-budget.d.ts +11 -0
  95. package/dist-lib/lib/assistant/pdf-budget.js +12 -0
  96. package/dist-lib/lib/assistant/pdf-pages.d.ts +25 -0
  97. package/dist-lib/lib/assistant/pdf-pages.js +75 -0
  98. package/dist-lib/lib/assistant/round-host.d.ts +65 -0
  99. package/dist-lib/lib/assistant/round-host.js +332 -0
  100. package/dist-lib/lib/assistant/skill-encode.d.ts +2 -1
  101. package/dist-lib/lib/assistant/skill-encode.js +2 -1
  102. package/dist-lib/lib/assistant/upload.d.ts +12 -0
  103. package/dist-lib/lib/assistant/upload.js +36 -0
  104. package/dist-lib/lib/assistant/video-budget.d.ts +13 -0
  105. package/dist-lib/lib/assistant/video-budget.js +29 -0
  106. package/dist-lib/lib/assistant-client.d.ts +5 -1
  107. package/dist-lib/lib/assistant-client.js +54 -14
  108. package/dist-lib/lib/assistant-tree.d.ts +14 -3
  109. package/dist-lib/lib/assistant-tree.js +113 -21
  110. package/dist-lib/lib/assistant.d.ts +115 -25
  111. package/dist-lib/lib/assistant.js +2409 -1245
  112. package/dist-lib/lib/audio-format.js +1 -1
  113. package/dist-lib/lib/chat-suggestion.d.ts +3 -0
  114. package/dist-lib/lib/chat-suggestion.js +47 -0
  115. package/dist-lib/lib/client.d.ts +3 -2
  116. package/dist-lib/lib/client.js +18 -3
  117. package/dist-lib/lib/compaction.d.ts +3 -1
  118. package/dist-lib/lib/compaction.js +20 -6
  119. package/dist-lib/lib/constants.d.ts +10 -0
  120. package/dist-lib/lib/constants.js +10 -0
  121. package/dist-lib/lib/core/agent-copies.d.ts +9 -0
  122. package/dist-lib/lib/core/agent-copies.js +47 -0
  123. package/dist-lib/lib/core/agent-hosting.d.ts +25 -0
  124. package/dist-lib/lib/core/agent-hosting.js +76 -0
  125. package/dist-lib/lib/core/agent.d.ts +9 -1
  126. package/dist-lib/lib/core/agent.js +58 -63
  127. package/dist-lib/lib/core/approval-rules.d.ts +5 -1
  128. package/dist-lib/lib/core/approval-rules.js +17 -9
  129. package/dist-lib/lib/core/archived-mesh.d.ts +14 -7
  130. package/dist-lib/lib/core/archived-mesh.js +75 -59
  131. package/dist-lib/lib/core/async-iterable.js +1 -1
  132. package/dist-lib/lib/core/blind-peers.d.ts +1 -0
  133. package/dist-lib/lib/core/blind-peers.js +1 -0
  134. package/dist-lib/lib/core/chat-activity.d.ts +1 -1
  135. package/dist-lib/lib/core/chat-activity.js +45 -34
  136. package/dist-lib/lib/core/chat-copy.d.ts +42 -0
  137. package/dist-lib/lib/core/chat-copy.js +404 -0
  138. package/dist-lib/lib/core/chat-fork.d.ts +16 -0
  139. package/dist-lib/lib/core/chat-fork.js +246 -0
  140. package/dist-lib/lib/core/chat-group.js +10 -22
  141. package/dist-lib/lib/core/chat-move.d.ts +77 -0
  142. package/dist-lib/lib/core/chat-move.js +601 -0
  143. package/dist-lib/lib/core/chat-order.d.ts +2 -1
  144. package/dist-lib/lib/core/chat-order.js +28 -19
  145. package/dist-lib/lib/core/chat-read.d.ts +4 -0
  146. package/dist-lib/lib/core/chat-read.js +49 -0
  147. package/dist-lib/lib/core/chat-search.js +14 -12
  148. package/dist-lib/lib/core/chat.d.ts +32 -4
  149. package/dist-lib/lib/core/chat.js +135 -61
  150. package/dist-lib/lib/core/chunk.d.ts +35 -7
  151. package/dist-lib/lib/core/chunk.js +271 -72
  152. package/dist-lib/lib/core/collections.d.ts +41 -1
  153. package/dist-lib/lib/core/collections.js +41 -1
  154. package/dist-lib/lib/core/config-value.d.ts +7 -0
  155. package/dist-lib/lib/core/config-value.js +15 -0
  156. package/dist-lib/lib/core/contract/activity.d.ts +7 -2
  157. package/dist-lib/lib/core/contract/activity.js +71 -23
  158. package/dist-lib/lib/core/contract/agent-join.d.ts +10 -0
  159. package/dist-lib/lib/core/contract/agent-join.js +104 -0
  160. package/dist-lib/lib/core/contract/agents.d.ts +5 -0
  161. package/dist-lib/lib/core/contract/agents.js +142 -3
  162. package/dist-lib/lib/core/contract/chat.d.ts +4 -0
  163. package/dist-lib/lib/core/contract/chat.js +53 -3
  164. package/dist-lib/lib/core/contract/chunks.d.ts +7 -0
  165. package/dist-lib/lib/core/contract/chunks.js +125 -38
  166. package/dist-lib/lib/core/contract/devices.js +6 -4
  167. package/dist-lib/lib/core/contract/index.d.ts +2 -3
  168. package/dist-lib/lib/core/contract/index.js +38 -11
  169. package/dist-lib/lib/core/contract/indexing.d.ts +1 -0
  170. package/dist-lib/lib/core/contract/indexing.js +51 -7
  171. package/dist-lib/lib/core/contract/invites.d.ts +3 -14
  172. package/dist-lib/lib/core/contract/invites.js +26 -36
  173. package/dist-lib/lib/core/contract/joined-meshes.js +4 -1
  174. package/dist-lib/lib/core/contract/knowledge.d.ts +1 -0
  175. package/dist-lib/lib/core/contract/knowledge.js +57 -6
  176. package/dist-lib/lib/core/contract/members.d.ts +3 -1
  177. package/dist-lib/lib/core/contract/members.js +48 -12
  178. package/dist-lib/lib/core/contract/mesh-kind.d.ts +3 -3
  179. package/dist-lib/lib/core/contract/mesh-kind.js +20 -16
  180. package/dist-lib/lib/core/contract/mesh-name.d.ts +3 -0
  181. package/dist-lib/lib/core/contract/mesh-name.js +31 -0
  182. package/dist-lib/lib/core/contract/mesh-rules.d.ts +8 -0
  183. package/dist-lib/lib/core/contract/mesh-rules.js +35 -0
  184. package/dist-lib/lib/core/contract/mesh-seeds.d.ts +2 -0
  185. package/dist-lib/lib/core/contract/mesh-seeds.js +26 -0
  186. package/dist-lib/lib/core/contract/model-requests.d.ts +26 -0
  187. package/dist-lib/lib/core/contract/model-requests.js +280 -0
  188. package/dist-lib/lib/core/contract/oldest-version.d.ts +9 -0
  189. package/dist-lib/lib/core/contract/oldest-version.js +20 -0
  190. package/dist-lib/lib/core/contract/open-join.d.ts +2 -0
  191. package/dist-lib/lib/core/contract/open-join.js +77 -0
  192. package/dist-lib/lib/core/contract/project-device-keys.d.ts +9 -0
  193. package/dist-lib/lib/core/contract/project-device-keys.js +38 -0
  194. package/dist-lib/lib/core/contract/project-host-keys.d.ts +9 -0
  195. package/dist-lib/lib/core/contract/project-host-keys.js +52 -0
  196. package/dist-lib/lib/core/contract/project-order.d.ts +2 -0
  197. package/dist-lib/lib/core/contract/project-order.js +25 -0
  198. package/dist-lib/lib/core/contract/projects.d.ts +23 -0
  199. package/dist-lib/lib/core/contract/projects.js +339 -0
  200. package/dist-lib/lib/core/contract/public-mesh.d.ts +3 -0
  201. package/dist-lib/lib/core/contract/public-mesh.js +31 -0
  202. package/dist-lib/lib/core/contract/public-seeds.d.ts +9 -0
  203. package/dist-lib/lib/core/contract/public-seeds.js +43 -0
  204. package/dist-lib/lib/core/contract/roles.d.ts +10 -0
  205. package/dist-lib/lib/core/contract/roles.js +123 -0
  206. package/dist-lib/lib/core/contract/run-requests.d.ts +11 -0
  207. package/dist-lib/lib/core/contract/run-requests.js +114 -0
  208. package/dist-lib/lib/core/contract/seed-defaults.d.ts +3 -1
  209. package/dist-lib/lib/core/contract/seed-defaults.js +17 -4
  210. package/dist-lib/lib/core/contract/shipped-rows.d.ts +2 -0
  211. package/dist-lib/lib/core/contract/shipped-rows.js +22 -0
  212. package/dist-lib/lib/core/contract/skill-secrets.d.ts +3 -0
  213. package/dist-lib/lib/core/contract/skill-secrets.js +32 -0
  214. package/dist-lib/lib/core/contract/tool-activity.js +12 -1
  215. package/dist-lib/lib/core/contract/tool-configs.js +2 -1
  216. package/dist-lib/lib/core/contract/types.d.ts +2 -2
  217. package/dist-lib/lib/core/contract/workspace.d.ts +31 -0
  218. package/dist-lib/lib/core/contract/workspace.js +311 -0
  219. package/dist-lib/lib/core/contract/writers.js +100 -16
  220. package/dist-lib/lib/core/deleted-agent-runs.d.ts +8 -0
  221. package/dist-lib/lib/core/deleted-agent-runs.js +57 -0
  222. package/dist-lib/lib/core/departures.d.ts +18 -5
  223. package/dist-lib/lib/core/departures.js +82 -6
  224. package/dist-lib/lib/core/device-control.d.ts +21 -0
  225. package/dist-lib/lib/core/device-control.js +91 -0
  226. package/dist-lib/lib/core/device-seal.d.ts +4 -0
  227. package/dist-lib/lib/core/device-seal.js +22 -0
  228. package/dist-lib/lib/core/devices.d.ts +2 -1
  229. package/dist-lib/lib/core/devices.js +6 -11
  230. package/dist-lib/lib/core/document-attachment.d.ts +10 -0
  231. package/dist-lib/lib/core/document-attachment.js +14 -0
  232. package/dist-lib/lib/core/files/attachments.d.ts +2 -0
  233. package/dist-lib/lib/core/files/attachments.js +23 -7
  234. package/dist-lib/lib/core/files/index.d.ts +28 -15
  235. package/dist-lib/lib/core/files/index.js +222 -43
  236. package/dist-lib/lib/core/files/knowledge.d.ts +10 -1
  237. package/dist-lib/lib/core/files/knowledge.js +77 -5
  238. package/dist-lib/lib/core/files/preview/index.js +6 -2
  239. package/dist-lib/lib/core/files/processing/claims.d.ts +7 -0
  240. package/dist-lib/lib/core/files/processing/claims.js +33 -7
  241. package/dist-lib/lib/core/files/processing/document.d.ts +8 -0
  242. package/dist-lib/lib/core/files/processing/document.js +26 -2
  243. package/dist-lib/lib/core/files/processing/index.d.ts +12 -3
  244. package/dist-lib/lib/core/files/processing/index.js +122 -73
  245. package/dist-lib/lib/core/files/processing/protocol.d.ts +7 -1
  246. package/dist-lib/lib/core/files/processing/protocol.js +27 -37
  247. package/dist-lib/lib/core/files/processing/source.d.ts +4 -0
  248. package/dist-lib/lib/core/files/processing/source.js +12 -4
  249. package/dist-lib/lib/core/files/processing/state.d.ts +5 -1
  250. package/dist-lib/lib/core/files/processing/state.js +9 -1
  251. package/dist-lib/lib/core/files/rag/build.d.ts +15 -2
  252. package/dist-lib/lib/core/files/rag/build.js +119 -21
  253. package/dist-lib/lib/core/files/rag/failure.d.ts +20 -0
  254. package/dist-lib/lib/core/files/rag/failure.js +58 -0
  255. package/dist-lib/lib/core/files/rag/index.d.ts +21 -5
  256. package/dist-lib/lib/core/files/rag/index.js +38 -9
  257. package/dist-lib/lib/core/files/rag/joined-index.d.ts +6 -0
  258. package/dist-lib/lib/core/files/rag/joined-index.js +35 -0
  259. package/dist-lib/lib/core/files/rag/limits.d.ts +1 -0
  260. package/dist-lib/lib/core/files/rag/limits.js +1 -0
  261. package/dist-lib/lib/core/files/rag/load.d.ts +3 -3
  262. package/dist-lib/lib/core/files/rag/load.js +6 -3
  263. package/dist-lib/lib/core/files/rag/plugin-index.d.ts +32 -0
  264. package/dist-lib/lib/core/files/rag/plugin-index.js +120 -0
  265. package/dist-lib/lib/core/files/rag/policy.d.ts +10 -1
  266. package/dist-lib/lib/core/files/rag/policy.js +23 -2
  267. package/dist-lib/lib/core/files/rag/produce.d.ts +3 -4
  268. package/dist-lib/lib/core/files/rag/produce.js +31 -18
  269. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +2 -0
  270. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +8 -2
  271. package/dist-lib/lib/core/files/rag/similarity.d.ts +2 -2
  272. package/dist-lib/lib/core/files/rag/similarity.js +2 -3
  273. package/dist-lib/lib/core/files/records/chunks.js +22 -1
  274. package/dist-lib/lib/core/files/records/index.d.ts +1 -1
  275. package/dist-lib/lib/core/files/records/index.js +1 -1
  276. package/dist-lib/lib/core/files/records/knowledge.d.ts +12 -4
  277. package/dist-lib/lib/core/files/records/knowledge.js +34 -30
  278. package/dist-lib/lib/core/files/records/purge.js +13 -8
  279. package/dist-lib/lib/core/files/records/reclaim.js +21 -55
  280. package/dist-lib/lib/core/files/records/routing.d.ts +1 -1
  281. package/dist-lib/lib/core/files/records/routing.js +6 -2
  282. package/dist-lib/lib/core/files/records/source.js +3 -5
  283. package/dist-lib/lib/core/files/records/sweep.d.ts +3 -0
  284. package/dist-lib/lib/core/files/records/sweep.js +9 -3
  285. package/dist-lib/lib/core/files/store/blob.d.ts +2 -0
  286. package/dist-lib/lib/core/files/store/blob.js +2 -2
  287. package/dist-lib/lib/core/files/store/index.d.ts +3 -1
  288. package/dist-lib/lib/core/files/store/index.js +4 -1
  289. package/dist-lib/lib/core/files/store/reference.d.ts +3 -0
  290. package/dist-lib/lib/core/files/store/reference.js +12 -2
  291. package/dist-lib/lib/core/files/store/sweep.js +3 -1
  292. package/dist-lib/lib/core/files/upload.d.ts +5 -1
  293. package/dist-lib/lib/core/files/upload.js +117 -51
  294. package/dist-lib/lib/core/first-event.d.ts +6 -0
  295. package/dist-lib/lib/core/first-event.js +13 -0
  296. package/dist-lib/lib/core/fs-drives.d.ts +6 -3
  297. package/dist-lib/lib/core/fs-drives.js +35 -35
  298. package/dist-lib/lib/core/helpers/index.d.ts +1 -1
  299. package/dist-lib/lib/core/helpers/index.js +2 -2
  300. package/dist-lib/lib/core/id.d.ts +1 -0
  301. package/dist-lib/lib/core/id.js +3 -0
  302. package/dist-lib/lib/core/identity.d.ts +3 -1
  303. package/dist-lib/lib/core/identity.js +25 -4
  304. package/dist-lib/lib/core/invite.d.ts +6 -2
  305. package/dist-lib/lib/core/invite.js +22 -8
  306. package/dist-lib/lib/core/local/files.d.ts +2 -1
  307. package/dist-lib/lib/core/local/files.js +5 -7
  308. package/dist-lib/lib/core/local/index.d.ts +93 -8
  309. package/dist-lib/lib/core/local/index.js +327 -28
  310. package/dist-lib/lib/core/local/run-logs.d.ts +38 -0
  311. package/dist-lib/lib/core/local/run-logs.js +132 -0
  312. package/dist-lib/lib/core/member-key.d.ts +7 -0
  313. package/dist-lib/lib/core/member-key.js +24 -0
  314. package/dist-lib/lib/core/membership.d.ts +3 -14
  315. package/dist-lib/lib/core/membership.js +3 -96
  316. package/dist-lib/lib/core/mesh.d.ts +132 -29
  317. package/dist-lib/lib/core/mesh.js +775 -215
  318. package/dist-lib/lib/core/migrations/agent-catalog.js +2 -8
  319. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  320. package/dist-lib/lib/core/migrations/agent-tools-scope.js +18 -0
  321. package/dist-lib/lib/core/migrations/chat-chunks.d.ts +4 -0
  322. package/dist-lib/lib/core/migrations/chat-chunks.js +47 -0
  323. package/dist-lib/lib/core/migrations/file-index.d.ts +1 -1
  324. package/dist-lib/lib/core/migrations/file-index.js +8 -6
  325. package/dist-lib/lib/core/migrations/index.d.ts +2 -1
  326. package/dist-lib/lib/core/migrations/index.js +69 -8
  327. package/dist-lib/lib/core/migrations/writer-links.d.ts +3 -0
  328. package/dist-lib/lib/core/migrations/writer-links.js +30 -0
  329. package/dist-lib/lib/core/model-requests.d.ts +13 -0
  330. package/dist-lib/lib/core/model-requests.js +65 -0
  331. package/dist-lib/lib/core/next-frame.js +2 -1
  332. package/dist-lib/lib/core/notification.js +100 -25
  333. package/dist-lib/lib/core/pdf/figure.d.ts +22 -0
  334. package/dist-lib/lib/core/pdf/figure.js +64 -0
  335. package/dist-lib/lib/core/pdf/rasterize.d.ts +12 -3
  336. package/dist-lib/lib/core/pdf/rasterize.js +77 -28
  337. package/dist-lib/lib/core/peer-duplex.d.ts +34 -0
  338. package/dist-lib/lib/core/{harness-loan.js → peer-duplex.js} +104 -45
  339. package/dist-lib/lib/core/project-keys.d.ts +16 -0
  340. package/dist-lib/lib/core/project-keys.js +65 -0
  341. package/dist-lib/lib/core/prompt-history.js +4 -4
  342. package/dist-lib/lib/core/protocol-pairing.d.ts +11 -0
  343. package/dist-lib/lib/core/protocol-pairing.js +22 -0
  344. package/dist-lib/lib/core/public-mesh.d.ts +25 -0
  345. package/dist-lib/lib/core/public-mesh.js +81 -0
  346. package/dist-lib/lib/core/purge.d.ts +3 -0
  347. package/dist-lib/lib/core/purge.js +7 -0
  348. package/dist-lib/lib/core/run-driver.d.ts +17 -0
  349. package/dist-lib/lib/core/run-driver.js +20 -0
  350. package/dist-lib/lib/core/run-requests.d.ts +14 -0
  351. package/dist-lib/lib/core/run-requests.js +78 -0
  352. package/dist-lib/lib/core/send.d.ts +2 -0
  353. package/dist-lib/lib/core/send.js +17 -4
  354. package/dist-lib/lib/core/senders.d.ts +19 -0
  355. package/dist-lib/lib/core/senders.js +45 -0
  356. package/dist-lib/lib/core/shared-agents.d.ts +40 -0
  357. package/dist-lib/lib/core/shared-agents.js +283 -0
  358. package/dist-lib/lib/core/skill-availability.d.ts +33 -0
  359. package/dist-lib/lib/core/skill-availability.js +67 -0
  360. package/dist-lib/lib/core/skill-secrets.d.ts +13 -18
  361. package/dist-lib/lib/core/skill-secrets.js +93 -72
  362. package/dist-lib/lib/core/sync/background.d.ts +34 -0
  363. package/dist-lib/lib/core/sync/background.js +86 -0
  364. package/dist-lib/lib/core/sync/changed.d.ts +20 -0
  365. package/dist-lib/lib/core/sync/changed.js +7 -0
  366. package/dist-lib/lib/core/sync/devices.js +6 -3
  367. package/dist-lib/lib/core/sync/files.d.ts +1 -0
  368. package/dist-lib/lib/core/sync/files.js +50 -72
  369. package/dist-lib/lib/core/sync/index.d.ts +1 -1
  370. package/dist-lib/lib/core/sync/index.js +193 -81
  371. package/dist-lib/lib/core/sync/view-updates.d.ts +39 -0
  372. package/dist-lib/lib/core/sync/view-updates.js +124 -0
  373. package/dist-lib/lib/core/sync-status.js +99 -43
  374. package/dist-lib/lib/core/system-info.d.ts +2 -2
  375. package/dist-lib/lib/core/system-info.js +10 -11
  376. package/dist-lib/lib/core/tool-activity.js +6 -12
  377. package/dist-lib/lib/core/tool-configs.d.ts +5 -3
  378. package/dist-lib/lib/core/tool-configs.js +27 -39
  379. package/dist-lib/lib/core/transcript-visibility.d.ts +5 -5
  380. package/dist-lib/lib/core/transcript-visibility.js +27 -31
  381. package/dist-lib/lib/core/upgrade-agents.d.ts +11 -0
  382. package/dist-lib/lib/core/upgrade-agents.js +78 -0
  383. package/dist-lib/lib/core/upgrade-summary.d.ts +19 -0
  384. package/dist-lib/lib/core/upgrade-summary.js +67 -0
  385. package/dist-lib/lib/core/vault-managed-skills.d.ts +18 -0
  386. package/dist-lib/lib/core/vault-managed-skills.js +105 -0
  387. package/dist-lib/lib/core/video/attachment.d.ts +1 -0
  388. package/dist-lib/lib/core/video/attachment.js +7 -0
  389. package/dist-lib/lib/core/video/digest.d.ts +16 -0
  390. package/dist-lib/lib/core/video/digest.js +57 -0
  391. package/dist-lib/lib/core/video/frames.d.ts +32 -0
  392. package/dist-lib/lib/core/video/frames.js +224 -0
  393. package/dist-lib/lib/core/view-read.d.ts +4 -0
  394. package/dist-lib/lib/core/view-read.js +23 -0
  395. package/dist-lib/lib/core/workspace-upgrade.d.ts +23 -0
  396. package/dist-lib/lib/core/workspace-upgrade.js +51 -0
  397. package/dist-lib/lib/core.d.ts +345 -88
  398. package/dist-lib/lib/core.js +4275 -1513
  399. package/dist-lib/lib/credential-pusher.d.ts +17 -7
  400. package/dist-lib/lib/credential-pusher.js +111 -62
  401. package/dist-lib/lib/custom-model-pusher.d.ts +2 -4
  402. package/dist-lib/lib/custom-model-task.d.ts +2 -1
  403. package/dist-lib/lib/custom-model-task.js +2 -2
  404. package/dist-lib/lib/device-tree.d.ts +18 -0
  405. package/dist-lib/lib/device-tree.js +32 -0
  406. package/dist-lib/lib/diagnostics.d.ts +7 -0
  407. package/dist-lib/lib/diagnostics.js +22 -0
  408. package/dist-lib/lib/doctor/checks.d.ts +15 -0
  409. package/dist-lib/lib/doctor/checks.js +272 -0
  410. package/dist-lib/lib/doctor/redact.d.ts +4 -0
  411. package/dist-lib/lib/doctor/redact.js +31 -0
  412. package/dist-lib/lib/doctor/render.d.ts +8 -0
  413. package/dist-lib/lib/doctor/render.js +83 -0
  414. package/dist-lib/lib/doctor/tree.d.ts +5 -0
  415. package/dist-lib/lib/doctor/tree.js +167 -0
  416. package/dist-lib/lib/downloads-allowed-pusher.d.ts +8 -0
  417. package/dist-lib/lib/downloads-allowed-pusher.js +37 -0
  418. package/dist-lib/lib/errors.d.ts +814 -0
  419. package/dist-lib/lib/errors.js +748 -0
  420. package/dist-lib/lib/fs-drive-bridge.d.ts +8 -1
  421. package/dist-lib/lib/fs-drive-bridge.js +312 -31
  422. package/dist-lib/lib/guards.d.ts +1 -0
  423. package/dist-lib/lib/guards.js +4 -0
  424. package/dist-lib/lib/inference-calls.d.ts +1 -2
  425. package/dist-lib/lib/inference-calls.js +2 -10
  426. package/dist-lib/lib/integrations/setup-routes.js +7 -5
  427. package/dist-lib/lib/knowledge-search.d.ts +1 -1
  428. package/dist-lib/lib/knowledge-search.js +5 -51
  429. package/dist-lib/lib/kv-cache-ledger.d.ts +22 -0
  430. package/dist-lib/lib/kv-cache-ledger.js +72 -0
  431. package/dist-lib/lib/kv-cache-reclaim.d.ts +2 -1
  432. package/dist-lib/lib/kv-cache-reclaim.js +30 -0
  433. package/dist-lib/lib/kv-cache-retention.d.ts +36 -0
  434. package/dist-lib/lib/kv-cache-retention.js +101 -0
  435. package/dist-lib/lib/latest-frame.d.ts +10 -0
  436. package/dist-lib/lib/latest-frame.js +48 -0
  437. package/dist-lib/lib/llm-model-names.d.ts +1 -1
  438. package/dist-lib/lib/llm-model-names.js +1 -1
  439. package/dist-lib/lib/log.d.ts +7 -6
  440. package/dist-lib/lib/log.js +14 -7
  441. package/dist-lib/lib/logger-type.d.ts +2 -5
  442. package/dist-lib/lib/mesh-scoped-engine.js +47 -2
  443. package/dist-lib/lib/model-context.js +1 -2
  444. package/dist-lib/lib/model-download-status.d.ts +3 -3
  445. package/dist-lib/lib/model-download.d.ts +22 -13
  446. package/dist-lib/lib/model-download.js +106 -37
  447. package/dist-lib/lib/model-idle-pusher.d.ts +2 -4
  448. package/dist-lib/lib/model-memory-cap.d.ts +30 -0
  449. package/dist-lib/lib/model-memory-cap.js +78 -0
  450. package/dist-lib/lib/models-watch.d.ts +1 -1
  451. package/dist-lib/lib/models-watch.js +4 -4
  452. package/dist-lib/lib/oauth/browser-connect.js +3 -2
  453. package/dist-lib/lib/oauth/flow-core.js +5 -3
  454. package/dist-lib/lib/oauth/flow.js +1 -1
  455. package/dist-lib/lib/oauth/loopback.d.ts +1 -0
  456. package/dist-lib/lib/oauth/loopback.js +57 -12
  457. package/dist-lib/lib/oauth/providers.js +4 -2
  458. package/dist-lib/lib/oauth/redirect-types.d.ts +1 -0
  459. package/dist-lib/lib/oauth/register.js +35 -19
  460. package/dist-lib/lib/oauth/request.d.ts +10 -0
  461. package/dist-lib/lib/oauth/request.js +22 -0
  462. package/dist-lib/lib/oauth/resolve.js +42 -13
  463. package/dist-lib/lib/oauth/token-exchange-core.js +40 -31
  464. package/dist-lib/lib/oauth/types.d.ts +3 -0
  465. package/dist-lib/lib/oauth.d.ts +2 -1
  466. package/dist-lib/lib/oauth.js +1 -0
  467. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  468. package/dist-lib/lib/persistent-dir.js +9 -0
  469. package/dist-lib/lib/probe-rounds.d.ts +8 -0
  470. package/dist-lib/lib/probe-rounds.js +10 -0
  471. package/dist-lib/lib/reconnecting-watch.js +19 -11
  472. package/dist-lib/lib/run-input.d.ts +14 -0
  473. package/dist-lib/lib/run-input.js +33 -0
  474. package/dist-lib/lib/run-notices.d.ts +5 -0
  475. package/dist-lib/lib/run-notices.js +13 -2
  476. package/dist-lib/lib/run-replay.d.ts +45 -0
  477. package/dist-lib/lib/run-replay.js +169 -0
  478. package/dist-lib/lib/run-transcript.d.ts +13 -12
  479. package/dist-lib/lib/run-transcript.js +20 -19
  480. package/dist-lib/lib/suspend-lifecycle.js +15 -5
  481. package/dist-lib/lib/task.js +6 -4
  482. package/dist-lib/lib/test-env.d.ts +1 -0
  483. package/dist-lib/lib/test-env.js +4 -0
  484. package/dist-lib/schema/build.js +66 -55
  485. package/dist-lib/schema/config.d.ts +1 -1
  486. package/dist-lib/schema/config.js +1 -1
  487. package/dist-lib/schema/content.d.ts +5 -1
  488. package/dist-lib/schema/content.js +60 -12
  489. package/dist-lib/schema/engine.d.ts +1 -0
  490. package/dist-lib/schema/engine.js +941 -152
  491. package/dist-lib/schema/field-order.js +8 -1
  492. package/dist-lib/schema/indexes.d.ts +10 -0
  493. package/dist-lib/schema/indexes.js +53 -3
  494. package/dist-lib/schema/local.js +83 -5
  495. package/dist-lib/schema/qvac.d.ts +4 -1
  496. package/dist-lib/schema/qvac.js +558 -16
  497. package/dist-lib/spec/bind.js +261 -48
  498. package/dist-lib/spec/calls.js +56 -5
  499. package/dist-lib/spec/capabilities.d.ts +129 -20
  500. package/dist-lib/spec/config/hyperconf/index.js +1 -1
  501. package/dist-lib/spec/hrpc/hrpc.json +870 -207
  502. package/dist-lib/spec/hrpc/index.js +969 -347
  503. package/dist-lib/spec/hrpc/messages.js +7590 -4896
  504. package/dist-lib/spec/hyperschema/index.js +7590 -4896
  505. package/dist-lib/spec/hyperschema/schema.json +5316 -3224
  506. package/dist-lib/spec/hyperschema/types.d.ts +576 -62
  507. package/dist-lib/spec/local/hyperdb/db.json +95 -1
  508. package/dist-lib/spec/local/hyperdb/index.js +459 -2
  509. package/dist-lib/spec/local/hyperdb/messages.js +1588 -488
  510. package/dist-lib/spec/local/hyperschema/index.js +584 -16
  511. package/dist-lib/spec/local/hyperschema/schema.json +369 -1
  512. package/dist-lib/spec/local/hyperschema/types.d.ts +88 -2
  513. package/dist-lib/spec/mesh/hyperdb/db.json +711 -9
  514. package/dist-lib/spec/mesh/hyperdb/index.js +2769 -7
  515. package/dist-lib/spec/mesh/hyperdb/messages.js +7140 -1298
  516. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +205 -1
  517. package/dist-lib/spec/mesh/hyperdispatch/index.js +579 -1
  518. package/dist-lib/spec/mesh/hyperdispatch/messages.js +4017 -267
  519. package/dist-lib/spec/mesh/hyperschema/index.js +4017 -267
  520. package/dist-lib/spec/mesh/hyperschema/schema.json +2193 -19
  521. package/dist-lib/spec/mesh/hyperschema/types.d.ts +550 -6
  522. package/package.json +136 -90
  523. package/tui/README.md +119 -20
  524. package/tui/app.mjs +2000 -621
  525. package/tui/boot.mjs +76 -9
  526. package/tui/cli.mjs +93 -0
  527. package/tui/index.mjs +2 -51
  528. package/tui/lib/connect-sheet.mjs +350 -0
  529. package/tui/lib/device-target.mjs +64 -0
  530. package/tui/lib/folders-command.mjs +84 -0
  531. package/tui/lib/fork-command.mjs +43 -0
  532. package/tui/lib/knowledge-import.mjs +3 -21
  533. package/tui/lib/local-path.mjs +21 -0
  534. package/tui/lib/move-command.mjs +17 -0
  535. package/tui/lib/render.mjs +30 -1
  536. package/tui/lib/setup.mjs +59 -25
  537. package/tui/lib/skill-connect.mjs +145 -0
  538. package/tui/lib/updater.mjs +86 -0
  539. package/tui/main.mjs +44 -18
  540. package/tui/plugins.mjs +158 -0
  541. package/worker/assistant-sidecar.mjs +28 -4
  542. package/worker/stow-entry.mjs +3 -50
  543. package/dist-lib/lib/core/contract/compute.d.ts +0 -11
  544. package/dist-lib/lib/core/contract/compute.js +0 -48
  545. package/dist-lib/lib/core/device-invites.d.ts +0 -11
  546. package/dist-lib/lib/core/device-invites.js +0 -63
  547. package/dist-lib/lib/core/files/processing/settle.d.ts +0 -13
  548. package/dist-lib/lib/core/files/processing/settle.js +0 -86
  549. package/dist-lib/lib/core/grant-expiry.d.ts +0 -11
  550. package/dist-lib/lib/core/grant-expiry.js +0 -66
  551. package/dist-lib/lib/core/handoff-channel.d.ts +0 -47
  552. package/dist-lib/lib/core/handoff-channel.js +0 -123
  553. package/dist-lib/lib/core/harness-loan.d.ts +0 -29
  554. package/dist-lib/lib/core/host-run-log-store.d.ts +0 -114
  555. package/dist-lib/lib/core/host-run-log-store.js +0 -976
  556. package/dist-lib/lib/core/hosted-agents.d.ts +0 -38
  557. package/dist-lib/lib/core/hosted-agents.js +0 -140
  558. package/dist-lib/lib/core/inference-calls-handoff.d.ts +0 -20
  559. package/dist-lib/lib/core/inference-calls-handoff.js +0 -37
  560. package/dist-lib/lib/core/inference-calls-receiver.d.ts +0 -14
  561. package/dist-lib/lib/core/inference-calls-receiver.js +0 -42
  562. package/dist-lib/lib/core/mesh-seed-handoff.d.ts +0 -25
  563. package/dist-lib/lib/core/mesh-seed-handoff.js +0 -52
  564. package/dist-lib/lib/core/migrations/device-indexes.d.ts +0 -2
  565. package/dist-lib/lib/core/migrations/device-indexes.js +0 -7
  566. package/dist-lib/lib/core/secret-handoff.d.ts +0 -17
  567. package/dist-lib/lib/core/secret-handoff.js +0 -29
  568. package/dist-lib/lib/core/skill-overlay-handoff.d.ts +0 -25
  569. package/dist-lib/lib/core/skill-overlay-handoff.js +0 -50
  570. package/dist-lib/lib/core/skill-overlay-receiver.d.ts +0 -8
  571. package/dist-lib/lib/core/skill-overlay-receiver.js +0 -23
  572. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  573. package/dist-lib/lib/image-cache-dir.js +0 -5
  574. package/dist-lib/lib/log-levels.d.ts +0 -7
  575. package/dist-lib/lib/log-levels.js +0 -1
  576. package/dist-lib/lib/logger.d.ts +0 -5
  577. package/dist-lib/lib/logger.js +0 -18
  578. package/dist-lib/lib/oauth/loopback.stub.d.ts +0 -3
  579. package/dist-lib/lib/oauth/loopback.stub.js +0 -6
@@ -1,23 +1,63 @@
1
- import { devicesByWriterKey, trackActivity } from './activity.js';
2
- import { isPurged } from './chat.js';
1
+ import { devicesByWriterKey, liveDeviceForWriter, trackActivity } from './activity.js';
2
+ import { deleteChatChunks, foreignChat, isPurged, putChunk } from './chat.js';
3
+ import { appendRow, asModelRequest, closeRounds, hostOutputRefusal, openRound, outputRefusal, roundChunkRefusal, served } from './model-requests.js';
4
+ import { outsideProject, projectRules, signerMember } from './projects.js';
5
+ import { runHasTerminalStatus, runnerRefusal, TERMINAL_RUN_STATES } from './run-requests.js';
3
6
  import { CHUNK_PAYLOAD_FIELDS, ragSourcesWithinBounds } from '../../../schema/qvac.js';
4
- import { chunkTypeOrdinal } from '../../../schema/indexes.js';
5
7
  import b4a from 'b4a';
6
- import { CHUNKS, CHUNKS_BY_TYPE, CHUNK_COUNTERS, DEVICES } from '../collections.js';
7
- const TERMINAL_RUN_STATES = new Set(['completed', 'failed', 'canceled']);
8
+ import { CHAT_CHUNKS, CHUNKS, CHUNKS_BY_CHAT, DEVICES, RUN_REQUEST_BY_RUN } from '../collections.js';
9
+ import { isProbeRound } from '../../probe-rounds.js';
8
10
  const CREDITED_CHUNK_TYPES = new Set(['run-request', 'run-status']);
9
- async function runHasTerminalStatus(tx, chatId, runId) {
10
- const type = chunkTypeOrdinal('run-status');
11
- const statuses = tx.find(CHUNKS_BY_TYPE, {
12
- gte: { chatId, type },
13
- lte: { chatId, type }
14
- });
15
- for await (const chunk of statuses) {
16
- if (chunk.runId === runId && TERMINAL_RUN_STATES.has(chunk.runStatus?.state ?? '')) {
17
- return true;
18
- }
11
+ export function runRequestOf(db, chatId, runId) {
12
+ const run = { chatId, runId };
13
+ return db.findOne(RUN_REQUEST_BY_RUN, { gte: run, lte: run });
14
+ }
15
+ async function asksFor(context, chunk) {
16
+ const signer = await signerMember(context);
17
+ const asker = chunk.requesterMemberId;
18
+ return !!signer && !!asker && b4a.equals(signer, asker);
19
+ }
20
+ export async function ownRunRequest(context, chatId, runId) {
21
+ const request = chatId ? await runRequestOf(context.tx, chatId, runId) : null;
22
+ return request && (await asksFor(context, request)) ? request : null;
23
+ }
24
+ async function requesterFor(op, context, round) {
25
+ if (!(await projectRules(context.tx))) {
26
+ return undefined;
19
27
  }
20
- return false;
28
+ if (round) {
29
+ return round.requesterMemberId ?? null;
30
+ }
31
+ if (op.type === 'run-request' && op.runId) {
32
+ const taken = await runRequestOf(context.tx, op.chatId, op.runId);
33
+ return taken ? null : signerMember(context);
34
+ }
35
+ if (!op.runId) {
36
+ return signerMember(context);
37
+ }
38
+ if (op.type === 'run-status' && op.runStatus?.state === 'canceled') {
39
+ const request = await runRequestOf(context.tx, op.chatId, op.runId);
40
+ const member = await signerMember(context);
41
+ return request && !(await outsideProject(context.tx, member)) ? request.requesterMemberId : null;
42
+ }
43
+ return (await ownRunRequest(context, op.chatId, op.runId))?.requesterMemberId ?? null;
44
+ }
45
+ async function driverRefusal(op, { tx, node }) {
46
+ if (!op.runId || op.type === 'run-request') {
47
+ return null;
48
+ }
49
+ if (op.type === 'run-status' && op.runStatus?.state === 'canceled') {
50
+ return null;
51
+ }
52
+ const request = await runRequestOf(tx, op.chatId, op.runId);
53
+ if (!request?.runnerDeviceId || request.capability) {
54
+ return null;
55
+ }
56
+ const signer = await liveDeviceForWriter(tx, node.key);
57
+ const driver = request.runTakenBy;
58
+ return signer && driver && b4a.equals(signer.id, driver)
59
+ ? null
60
+ : 'a handed-off run is written by the device that took it';
21
61
  }
22
62
  async function isOriginWriter(tx, chunk, writerKey) {
23
63
  const device = await tx.get(DEVICES, { id: chunk.originDeviceId });
@@ -40,7 +80,8 @@ function payloadMatchesType(op) {
40
80
  return true;
41
81
  }
42
82
  export function registerChunkRoutes(router) {
43
- router.add('@qvac/append-chunk', trackActivity(async (op, { tx, log }) => {
83
+ router.add('@qvac/append-chunk', trackActivity(async (op, context) => {
84
+ const { tx, log } = context;
44
85
  const chunk = await tx.get(CHUNKS, { id: op.id });
45
86
  if (chunk) {
46
87
  return;
@@ -49,6 +90,12 @@ export function registerChunkRoutes(router) {
49
90
  log?.debug('contract', 'append-chunk dropped: chat is purged', { id: op.id });
50
91
  return;
51
92
  }
93
+ if (await foreignChat(tx, op.chatId)) {
94
+ log?.warn('contract', 'append-chunk dropped: the chat is not in this project', {
95
+ id: op.id
96
+ });
97
+ return;
98
+ }
52
99
  if (!payloadMatchesType(op)) {
53
100
  log?.warn('contract', 'append-chunk dropped: payload does not match its type', {
54
101
  id: op.id
@@ -73,7 +120,18 @@ export function registerChunkRoutes(router) {
73
120
  });
74
121
  return;
75
122
  }
76
- if (op.type === 'run-status' &&
123
+ const runner = await runnerRefusal(op, context);
124
+ if (runner) {
125
+ log?.warn('contract', `append-chunk dropped: ${runner}`, { id: op.id });
126
+ return;
127
+ }
128
+ const roundRefusal = await roundChunkRefusal(op, context);
129
+ if (roundRefusal) {
130
+ log?.warn('contract', `append-chunk dropped: ${roundRefusal}`, { id: op.id });
131
+ return;
132
+ }
133
+ if ((op.type === 'run-status' ||
134
+ (op.type === 'model-request' && !isProbeRound(op.modelRequest?.options))) &&
77
135
  op.runId !== null &&
78
136
  op.runId !== undefined &&
79
137
  (await runHasTerminalStatus(tx, op.chatId, op.runId))) {
@@ -82,24 +140,43 @@ export function registerChunkRoutes(router) {
82
140
  });
83
141
  return;
84
142
  }
85
- if (op.parentId !== null && op.parentId !== undefined) {
86
- const parent = await tx.get(CHUNKS, { id: op.parentId });
87
- if (!parent || parent.chatId !== op.chatId) {
88
- log?.warn('contract', 'append-chunk dropped: parentId is not a chunk in this chat', {
89
- id: op.id
90
- });
91
- return;
92
- }
143
+ const parent = op.parentId !== null && op.parentId !== undefined
144
+ ? await tx.get(CHUNKS, { id: op.parentId })
145
+ : null;
146
+ if (op.parentId && (!parent || parent.chatId !== op.chatId)) {
147
+ log?.warn('contract', 'append-chunk dropped: parentId is not a chunk in this chat', {
148
+ id: op.id
149
+ });
150
+ return;
151
+ }
152
+ const round = asModelRequest(parent);
153
+ const outputRefused = (await hostOutputRefusal(op, round, context)) ??
154
+ (round ? await outputRefusal(op, round, context) : null);
155
+ if (outputRefused) {
156
+ log?.warn('contract', `append-chunk dropped: ${outputRefused}`, { id: op.id });
157
+ return;
158
+ }
159
+ const undriven = round ? null : await driverRefusal(op, context);
160
+ if (undriven) {
161
+ log?.warn('contract', `append-chunk dropped: ${undriven}`, { id: op.id });
162
+ return;
163
+ }
164
+ const requesterMemberId = await requesterFor(op, context, round);
165
+ if (requesterMemberId === null) {
166
+ log?.warn('contract', "append-chunk dropped: a project's run is written by its owner", {
167
+ id: op.id
168
+ });
169
+ return;
170
+ }
171
+ const appended = await appendRow(tx, { ...openRound(op), requesterMemberId });
172
+ if (round) {
173
+ await putChunk(tx, served(round, op.createdAt));
174
+ }
175
+ if (op.type === 'run-status' &&
176
+ TERMINAL_RUN_STATES.has(op.runStatus?.state ?? '') &&
177
+ op.runId) {
178
+ await closeRounds(tx, { chatId: op.chatId, runId: op.runId, at: op.createdAt });
93
179
  }
94
- const counter = await tx.get(CHUNK_COUNTERS, { chatId: op.chatId });
95
- const prevCount = counter?.count ?? 0;
96
- const appended = { ...op, seq: prevCount };
97
- await tx.insert(CHUNK_COUNTERS, {
98
- chatId: op.chatId,
99
- count: prevCount + 1,
100
- lastActivityAt: Math.max(counter?.lastActivityAt ?? 0, op.createdAt)
101
- });
102
- await tx.insert(CHUNKS, appended);
103
180
  return CREDITED_CHUNK_TYPES.has(op.type) ? appended : undefined;
104
181
  }));
105
182
  router.add('@qvac/update-chunk', trackActivity(async (op, { tx, node, log }) => {
@@ -122,7 +199,7 @@ export function registerChunkRoutes(router) {
122
199
  return;
123
200
  }
124
201
  const next = { ...chunk, runStatus: op.runStatus, updatedAt: op.updatedAt };
125
- await tx.insert(CHUNKS, next);
202
+ await putChunk(tx, next);
126
203
  return next;
127
204
  }
128
205
  if (chunk.type === 'attachment' && op.attachment !== null && op.attachment !== undefined) {
@@ -131,7 +208,7 @@ export function registerChunkRoutes(router) {
131
208
  return;
132
209
  }
133
210
  const next = { ...chunk, attachment: op.attachment, updatedAt: op.updatedAt };
134
- await tx.insert(CHUNKS, next);
211
+ await putChunk(tx, next);
135
212
  return next;
136
213
  }
137
214
  log?.warn('contract', 'update-chunk dropped: only a run-status (runStatus) or attachment (attachment) edits', { id: op.id });
@@ -161,8 +238,18 @@ export function registerChunkRoutes(router) {
161
238
  },
162
239
  updatedAt: op.resolvedAt
163
240
  };
164
- await tx.insert(CHUNKS, resolved);
241
+ await putChunk(tx, resolved);
165
242
  log?.info('contract', `approval ${op.approved ? 'approved' : 'denied'}`, { id: op.id });
166
243
  return resolved;
167
244
  }));
245
+ router.add('@qvac/reindex-chat-chunks', async ({ chatId }, { tx }) => {
246
+ if (await isPurged(tx, chatId)) {
247
+ await deleteChatChunks(tx, chatId);
248
+ return;
249
+ }
250
+ const inChat = { gte: { chatId }, lte: { chatId } };
251
+ for (const chunk of await tx.find(CHUNKS_BY_CHAT, inChat).toArray()) {
252
+ await tx.insert(CHAT_CHUNKS, chunk);
253
+ }
254
+ });
168
255
  }
@@ -1,5 +1,6 @@
1
1
  import { capDeviceName } from '../../../schema/qvac.js';
2
- import { backfillLiveDevices, trackActivity } from './activity.js';
2
+ import { trackActivity } from './activity.js';
3
+ import { reindexShippedRows } from './shipped-rows.js';
3
4
  import { sealed } from './seal.js';
4
5
  import { verifyWriterClaim } from '../device-attestation.js';
5
6
  import b4a from 'b4a';
@@ -82,7 +83,7 @@ export function registerDeviceRoutes(router) {
82
83
  await tx.insert(DEVICES, next);
83
84
  return next;
84
85
  }));
85
- router.add('@qvac/report-device-capabilities', trackActivity(async ({ deviceId, installedToolNames, installedSkillNames, installedModelNames, cachedModelNames, readySkillNames, toolCatalog }, { tx, node, log }) => {
86
+ router.add('@qvac/report-device-capabilities', trackActivity(async ({ deviceId, installedToolNames, installedSkillNames, installedModelNames, cachedModelNames, readySkillNames, toolCatalog, customModels }, { tx, node, log }) => {
86
87
  const existing = await tx.get(DEVICES, { id: deviceId });
87
88
  if (!existing) {
88
89
  log?.debug('contract', 'report-device-capabilities dropped: unknown device');
@@ -101,7 +102,8 @@ export function registerDeviceRoutes(router) {
101
102
  installedModelNames: installedModelNames ?? [],
102
103
  cachedModelNames: cachedModelNames ?? [],
103
104
  readySkillNames: readySkillNames ?? existing.readySkillNames,
104
- toolCatalog: toolCatalog ?? existing.toolCatalog
105
+ toolCatalog: toolCatalog ?? existing.toolCatalog,
106
+ customModels: customModels ?? existing.customModels
105
107
  };
106
108
  await tx.insert(DEVICES, next);
107
109
  return next;
@@ -123,6 +125,6 @@ export function registerDeviceRoutes(router) {
123
125
  return next;
124
126
  }));
125
127
  router.add('@qvac/reindex-devices', async (_op, { tx }) => {
126
- await backfillLiveDevices(tx);
128
+ await reindexShippedRows(tx);
127
129
  });
128
130
  }
@@ -1,4 +1,3 @@
1
1
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
- export declare function registerRoutes(target: Router, { compute }?: {
3
- compute?: boolean | undefined;
4
- }): void;
2
+ import { type RoleOptions } from './roles.ts';
3
+ export declare function registerRoutes(target: Router, { role }?: RoleOptions): void;
@@ -1,8 +1,9 @@
1
+ import { registerActivityRoutes } from './activity.js';
2
+ import { registerAgentJoinRoutes } from './agent-join.js';
1
3
  import { registerAgentRoutes } from './agents.js';
2
4
  import { registerApprovalRuleRoutes } from './approval-rules.js';
3
5
  import { registerAttestationRoutes } from './attestations.js';
4
6
  import { registerChatRoutes } from './chat.js';
5
- import { registerComputeDrops } from './compute.js';
6
7
  import { registerChatGroupRoutes } from './chat-group.js';
7
8
  import { registerChunkRoutes } from './chunks.js';
8
9
  import { registerDeviceRoutes } from './devices.js';
@@ -11,17 +12,32 @@ import { registerInviteRoutes } from './invites.js';
11
12
  import { registerKnowledgeRoutes } from './knowledge.js';
12
13
  import { registerJoinedMeshRoutes } from './joined-meshes.js';
13
14
  import { registerMemberRoutes } from './members.js';
15
+ import { modelOutputOnly, registerModelRequestRoutes } from './model-requests.js';
14
16
  import { registerMeshKindRoutes } from './mesh-kind.js';
15
- import { registerSeedDefaultsRoutes } from './seed-defaults.js';
17
+ import { registerMeshNameRoutes } from './mesh-name.js';
18
+ import { registerMeshRulesRoutes } from './mesh-rules.js';
19
+ import { registerMeshSeedRoutes } from './mesh-seeds.js';
20
+ import { registerOpenJoinRoutes } from './open-join.js';
21
+ import { registerProjectOrderRoutes } from './project-order.js';
22
+ import { registerProjectRoutes } from './projects.js';
23
+ import { registerPublicMeshRoutes } from './public-mesh.js';
24
+ import { registerRunRequestRoutes } from './run-requests.js';
25
+ import { roleDrops } from './roles.js';
26
+ import { registerMeshBlindPeerRoutes, registerSeedDefaultsRoutes } from './seed-defaults.js';
27
+ import { registerSkillSecretRoutes } from './skill-secrets.js';
16
28
  import { registerToolActivityRoutes } from './tool-activity.js';
17
29
  import { registerToolConfigsRoutes } from './tool-configs.js';
30
+ import { registerWorkspaceRoutes } from './workspace.js';
18
31
  import { registerWriterRoutes } from './writers.js';
19
32
  const OPTIMISTIC_ROUTES = new Set([
20
33
  '@qvac/join',
21
34
  '@qvac/claim-invite',
22
35
  '@qvac/recover-device',
23
36
  '@qvac/attest-device',
24
- '@qvac/join-member'
37
+ '@qvac/join-member',
38
+ '@qvac/open-join',
39
+ '@qvac/agent-join',
40
+ '@qvac/remove-writer'
25
41
  ]);
26
42
  function writersOnly(router) {
27
43
  return {
@@ -35,26 +51,37 @@ function writersOnly(router) {
35
51
  })
36
52
  };
37
53
  }
38
- export function registerRoutes(target, { compute = false } = {}) {
39
- const router = writersOnly(target);
54
+ export function registerRoutes(target, { role = 'account' } = {}) {
55
+ const router = modelOutputOnly(writersOnly(roleDrops(target, role)));
40
56
  registerWriterRoutes(router);
57
+ registerActivityRoutes(router);
41
58
  registerChunkRoutes(router);
59
+ registerModelRequestRoutes(router);
60
+ registerRunRequestRoutes(router);
42
61
  registerAgentRoutes(router);
62
+ registerAgentJoinRoutes(router);
43
63
  registerChatRoutes(router);
44
64
  registerChatGroupRoutes(router);
45
65
  registerApprovalRuleRoutes(router);
46
66
  registerDeviceRoutes(router);
47
67
  registerKnowledgeRoutes(router);
48
68
  registerIndexingRoutes(router);
49
- registerSeedDefaultsRoutes(router);
69
+ registerSeedDefaultsRoutes(router, { role });
70
+ registerMeshBlindPeerRoutes(router);
50
71
  registerToolConfigsRoutes(router);
51
72
  registerToolActivityRoutes(router);
52
73
  registerAttestationRoutes(router);
53
74
  registerJoinedMeshRoutes(router);
54
75
  registerMemberRoutes(router);
55
- registerInviteRoutes(router, { compute });
56
- registerMeshKindRoutes(router, { compute });
57
- if (compute) {
58
- registerComputeDrops(router);
59
- }
76
+ registerInviteRoutes(router);
77
+ registerMeshKindRoutes(router);
78
+ registerMeshNameRoutes(router);
79
+ registerOpenJoinRoutes(router);
80
+ registerMeshSeedRoutes(router);
81
+ registerMeshRulesRoutes(router);
82
+ registerPublicMeshRoutes(router);
83
+ registerWorkspaceRoutes(router);
84
+ registerProjectRoutes(router);
85
+ registerProjectOrderRoutes(router);
86
+ registerSkillSecretRoutes(router);
60
87
  }
@@ -1,4 +1,5 @@
1
1
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
2
  export declare const INDEXING_CLAIM_TTL_MS: number;
3
+ export declare const INDEXING_STALE_MS: number;
3
4
  export declare const INDEXING_MAX_CLOCK_SKEW_MS: number;
4
5
  export declare function registerIndexingRoutes(router: Router): void;
@@ -1,8 +1,11 @@
1
1
  import { trackActivity } from './activity.js';
2
+ import { oldestVersion } from './oldest-version.js';
2
3
  import { claimSource } from '../files/index.js';
4
+ import { WORKSPACES_RULES, rulesVersion } from './mesh-rules.js';
3
5
  import b4a from 'b4a';
4
- import { INDEXING_STATUS, KNOWLEDGE_ARTIFACTS } from '../collections.js';
6
+ import { INDEXING_STATUS, INDEXING_STATUS_BY_KNOWLEDGE, KNOWLEDGE, KNOWLEDGE_ARTIFACTS } from '../collections.js';
5
7
  export const INDEXING_CLAIM_TTL_MS = 10 * 60 * 1000;
8
+ export const INDEXING_STALE_MS = 2 * 60 * 1000;
6
9
  export const INDEXING_MAX_CLOCK_SKEW_MS = 60 * 60 * 1000;
7
10
  export function registerIndexingRoutes(router) {
8
11
  router.add('@qvac/claim-indexing', trackActivity(async (op, { tx, node, log }) => {
@@ -17,7 +20,8 @@ export function registerIndexingRoutes(router) {
17
20
  log?.debug('contract', 'claim-indexing dropped: already ready', { id: op.id });
18
21
  return;
19
22
  }
20
- const poisoned = existing.at > op.at + INDEXING_MAX_CLOCK_SKEW_MS;
23
+ const poisoned = existing.at > op.at + INDEXING_MAX_CLOCK_SKEW_MS ||
24
+ existing.expiresAt > op.at + INDEXING_MAX_CLOCK_SKEW_MS + INDEXING_CLAIM_TTL_MS;
21
25
  if (!poisoned) {
22
26
  if (existing.status === 'indexing' && existing.expiresAt > op.at) {
23
27
  log?.debug('contract', 'claim-indexing dropped: live claim', { id: op.id });
@@ -29,7 +33,7 @@ export function registerIndexingRoutes(router) {
29
33
  }
30
34
  }
31
35
  }
32
- const claimed = {
36
+ const claimed = oldestVersion({
33
37
  id: op.id,
34
38
  knowledgeId: op.knowledgeId,
35
39
  chatId: knowledge.chatId,
@@ -37,8 +41,8 @@ export function registerIndexingRoutes(router) {
37
41
  claimId: op.claimId,
38
42
  claimedBy: node.key,
39
43
  at: op.at,
40
- expiresAt: op.at + INDEXING_CLAIM_TTL_MS
41
- };
44
+ expiresAt: op.at + (await claimLeaseMs(tx))
45
+ });
42
46
  await tx.insert(INDEXING_STATUS, claimed);
43
47
  return claimed;
44
48
  }));
@@ -70,13 +74,53 @@ export function registerIndexingRoutes(router) {
70
74
  return;
71
75
  }
72
76
  }
73
- const settled = {
77
+ const settled = oldestVersion({
74
78
  ...existing,
75
79
  status: op.status,
76
80
  at: existing.at + 1,
77
81
  error: op.status === 'failed' ? (op.error ?? null) : null
78
- };
82
+ });
79
83
  await tx.insert(INDEXING_STATUS, settled);
80
84
  return settled;
81
85
  }));
86
+ router.add('@qvac/progress-indexing', trackActivity(async (op, { tx, node, log }) => {
87
+ const existing = await tx.get(INDEXING_STATUS, { id: op.id });
88
+ if (!existing ||
89
+ existing.status !== 'indexing' ||
90
+ existing.claimId !== op.claimId ||
91
+ !b4a.equals(existing.claimedBy, node.key)) {
92
+ log?.debug('contract', 'progress-indexing dropped: not the claim holder', { id: op.id });
93
+ return;
94
+ }
95
+ const expiresAt = Math.max(existing.expiresAt, op.at + INDEXING_STALE_MS);
96
+ if (expiresAt === existing.expiresAt) {
97
+ return existing;
98
+ }
99
+ const progressed = oldestVersion({ ...existing, expiresAt });
100
+ await tx.insert(INDEXING_STATUS, progressed);
101
+ return progressed;
102
+ }));
103
+ router.add('@qvac/retry-indexing', trackActivity(async (op, { tx, log }) => {
104
+ const knowledge = await tx.get(KNOWLEDGE, { id: op.knowledgeId });
105
+ if (!knowledge || knowledge.deletedAt) {
106
+ log?.debug('contract', 'retry-indexing dropped: no live knowledge', {
107
+ knowledgeId: op.knowledgeId
108
+ });
109
+ return;
110
+ }
111
+ const rows = await tx
112
+ .find(INDEXING_STATUS_BY_KNOWLEDGE, {
113
+ gte: { knowledgeId: op.knowledgeId },
114
+ lte: { knowledgeId: op.knowledgeId }
115
+ })
116
+ .toArray();
117
+ const cleared = rows.filter((row) => row.status === 'failed' && row.at < op.at);
118
+ for (const row of cleared) {
119
+ await tx.delete(INDEXING_STATUS, { id: row.id });
120
+ }
121
+ return cleared.length > 0;
122
+ }));
123
+ }
124
+ async function claimLeaseMs(tx) {
125
+ return (await rulesVersion(tx)) >= WORKSPACES_RULES ? INDEXING_STALE_MS : INDEXING_CLAIM_TTL_MS;
82
126
  }
@@ -1,16 +1,5 @@
1
1
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
2
  import type HyperDB from 'hyperdb';
3
- import type { QvacDevice, QvacMeshInviteGrant } from '../../../spec/mesh/hyperschema/types.d.ts';
4
- export declare function memberStanding(tx: HyperDB, memberId: Buffer, grant: QvacMeshInviteGrant): Promise<'present' | 'removed' | null>;
5
- interface InviteStandingOptions {
6
- readonly device: QvacDevice | null;
7
- readonly memberId: Buffer;
8
- readonly grant: QvacMeshInviteGrant;
9
- readonly compute?: boolean;
10
- }
11
- export declare function inviteStanding(tx: HyperDB, { device, memberId, grant, compute }: InviteStandingOptions): Promise<'present' | 'removed' | null>;
12
- export declare function belongsToAnotherMember(tx: HyperDB, device: QvacDevice | null, memberId: Buffer): Promise<boolean>;
13
- export declare function registerInviteRoutes(router: Router, { compute }?: {
14
- compute?: boolean | undefined;
15
- }): void;
16
- export {};
3
+ import type { QvacDevice } from '../../../spec/mesh/hyperschema/types.d.ts';
4
+ export declare function removedBy(tx: HyperDB, device: QvacDevice): Promise<'itself' | 'own-member' | 'another-member'>;
5
+ export declare function registerInviteRoutes(router: Router): void;
@@ -1,11 +1,12 @@
1
1
  import crypto from 'hypercore-crypto';
2
- import { liveDeviceForWriter, trackActivity } from './activity.js';
2
+ import { liveDeviceForWriter, liveDevicesOf, trackActivity } from './activity.js';
3
3
  import { nextGrantSequence, removedSinceMint } from './grant-order.js';
4
- import { meshKind } from './mesh-kind.js';
4
+ import { meshKind, sharedKind } from './mesh-kind.js';
5
5
  import { isKickedRow } from '../helpers/index.js';
6
6
  import { inviteGrantTermsRefusal, verifyInviteClaim } from '../invite-grants.js';
7
7
  import { admitDevice } from './writers.js';
8
- import { linkMember, provenMember } from './members.js';
8
+ import { linkMember, outsideAccount, provenMember } from './members.js';
9
+ import { outsideProject } from './projects.js';
9
10
  import b4a from 'b4a';
10
11
  import { DEVICES, MESH_INVITE_GRANTS, MESH_INVITE_SPENDS, WRITER_ACTIVITY } from '../collections.js';
11
12
  function hex(buffer) {
@@ -24,38 +25,25 @@ async function kickedFromOutside(tx, device, memberId) {
24
25
  const kickerMember = kicker.memberId ?? kicker.claimedMemberId;
25
26
  return !kickerMember || !b4a.equals(kickerMember, memberId);
26
27
  }
27
- export async function memberStanding(tx, memberId, grant) {
28
- if (await removedSinceMint(tx, memberId, grant))
29
- return 'removed';
30
- for await (const device of tx.find(DEVICES)) {
31
- if (device.revoked)
32
- continue;
33
- const member = device.memberId ?? device.claimedMemberId;
34
- if (member && b4a.equals(member, memberId)) {
35
- return 'present';
36
- }
37
- }
38
- return null;
39
- }
40
- export async function inviteStanding(tx, { device, memberId, grant, compute = false }) {
41
- const standing = await memberStanding(tx, memberId, grant);
42
- if (standing !== 'present') {
43
- return standing;
28
+ async function inviteRefusal(tx, { device, memberId, grant }) {
29
+ if (await removedSinceMint(tx, memberId, grant)) {
30
+ return 'the member was removed after the mint';
44
31
  }
45
- if (compute || (await meshKind(tx)) !== 'shared') {
32
+ const present = (await liveDevicesOf(tx, memberId)).length > 0;
33
+ if (!present || !(await sharedKind(tx))) {
46
34
  return null;
47
35
  }
48
- if (!device?.revoked) {
49
- return 'present';
36
+ if (device?.revoked && (await removedBy(tx, device)) !== 'own-member') {
37
+ return null;
50
38
  }
51
- return (await removedBy(tx, device)) === 'own-member' ? 'present' : null;
39
+ return 'the member is still present';
52
40
  }
53
- export async function belongsToAnotherMember(tx, device, memberId) {
41
+ async function belongsToAnotherMember(tx, device, memberId) {
54
42
  if (!device?.memberId || b4a.equals(device.memberId, memberId))
55
43
  return false;
56
44
  return !device.revoked || (await removedBy(tx, device)) === 'another-member';
57
45
  }
58
- async function removedBy(tx, device) {
46
+ export async function removedBy(tx, device) {
59
47
  if (!isKickedRow(device))
60
48
  return 'itself';
61
49
  const owner = device.memberId ?? device.claimedMemberId;
@@ -64,7 +52,7 @@ async function removedBy(tx, device) {
64
52
  }
65
53
  return (await kickedFromOutside(tx, device, owner)) ? 'another-member' : 'own-member';
66
54
  }
67
- export function registerInviteRoutes(router, { compute = false } = {}) {
55
+ export function registerInviteRoutes(router) {
68
56
  router.add('@qvac/put-mesh-invite-grant', trackActivity(async ({ grant }, { tx, node, log }) => {
69
57
  if ((await meshKind(tx)) === 'account') {
70
58
  log?.warn('contract', 'put-mesh-invite-grant dropped: an account takes no grant');
@@ -132,6 +120,14 @@ export function registerInviteRoutes(router, { compute = false } = {}) {
132
120
  log?.warn('contract', 'claim-invite dropped: an account takes no grant');
133
121
  return;
134
122
  }
123
+ if (await outsideAccount(tx, payload.member?.id)) {
124
+ log?.warn('contract', "claim-invite dropped: it names another member than the account's");
125
+ return;
126
+ }
127
+ if (await outsideProject(tx, payload.member?.id)) {
128
+ log?.warn('contract', "claim-invite dropped: it names no member on the project's list");
129
+ return;
130
+ }
135
131
  let valid = false;
136
132
  try {
137
133
  valid = crypto.verify(node.key, payload.signature, meshPublicKey);
@@ -214,15 +210,9 @@ export function registerInviteRoutes(router, { compute = false } = {}) {
214
210
  log?.warn('contract', 'claim-invite dropped: the device belongs to another member', ids);
215
211
  return;
216
212
  }
217
- const standing = spent
218
- ? null
219
- : await inviteStanding(tx, { device: existing, memberId, grant, compute });
220
- if (standing === 'present') {
221
- log?.warn('contract', 'claim-invite dropped: the member is still present', ids);
222
- return;
223
- }
224
- if (standing === 'removed') {
225
- log?.warn('contract', 'claim-invite dropped: the member was removed after the mint', ids);
213
+ const refusal = spent ? null : await inviteRefusal(tx, { device: existing, memberId, grant });
214
+ if (refusal) {
215
+ log?.warn('contract', `claim-invite dropped: ${refusal}`, ids);
226
216
  return;
227
217
  }
228
218
  const admission = await admitDevice(context, payload.device, {
@@ -37,6 +37,9 @@ function merge(mesh, existing, rejoin) {
37
37
  label: relabels ? mesh.label : existing.label,
38
38
  labeledAt: relabels ? mesh.labeledAt : existing.labeledAt,
39
39
  shared: remarks ? mesh.shared : existing.shared,
40
- sharedAt: remarks ? mesh.sharedAt : existing.sharedAt
40
+ sharedAt: remarks ? mesh.sharedAt : existing.sharedAt,
41
+ workspace: existing.workspace || mesh.workspace,
42
+ kicked: rejoin ? mesh.kicked : mesh.kicked || existing.kicked,
43
+ initial: existing.initial || mesh.initial
41
44
  };
42
45
  }
@@ -1,2 +1,3 @@
1
1
  import type { Router } from '../../../spec/mesh/hyperdispatch/index.js';
2
+ export declare const KNOWLEDGE_CAP_ROW = "mesh";
2
3
  export declare function registerKnowledgeRoutes(router: Router): void;