@angri450/zvec-grep 0.2.2

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 (418) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +319 -0
  3. package/README_CN.md +297 -0
  4. package/dist/authorization/index.d.ts +7 -0
  5. package/dist/authorization/index.js +7 -0
  6. package/dist/authorization/index.js.map +1 -0
  7. package/dist/authorization/manager.d.ts +8 -0
  8. package/dist/authorization/manager.js +19 -0
  9. package/dist/authorization/manager.js.map +1 -0
  10. package/dist/authorization/operation.d.ts +7 -0
  11. package/dist/authorization/operation.js +50 -0
  12. package/dist/authorization/operation.js.map +1 -0
  13. package/dist/authorization/planner.d.ts +21 -0
  14. package/dist/authorization/planner.js +97 -0
  15. package/dist/authorization/planner.js.map +1 -0
  16. package/dist/authorization/prompt.d.ts +12 -0
  17. package/dist/authorization/prompt.js +63 -0
  18. package/dist/authorization/prompt.js.map +1 -0
  19. package/dist/authorization/store.d.ts +20 -0
  20. package/dist/authorization/store.js +251 -0
  21. package/dist/authorization/store.js.map +1 -0
  22. package/dist/authorization/target.d.ts +15 -0
  23. package/dist/authorization/target.js +49 -0
  24. package/dist/authorization/target.js.map +1 -0
  25. package/dist/authorization/types.d.ts +61 -0
  26. package/dist/authorization/types.js +2 -0
  27. package/dist/authorization/types.js.map +1 -0
  28. package/dist/cli/args.d.ts +6 -0
  29. package/dist/cli/args.js +1255 -0
  30. package/dist/cli/args.js.map +1 -0
  31. package/dist/cli/auth.d.ts +21 -0
  32. package/dist/cli/auth.js +209 -0
  33. package/dist/cli/auth.js.map +1 -0
  34. package/dist/cli/commands.d.ts +4 -0
  35. package/dist/cli/commands.js +801 -0
  36. package/dist/cli/commands.js.map +1 -0
  37. package/dist/cli/errors.d.ts +9 -0
  38. package/dist/cli/errors.js +131 -0
  39. package/dist/cli/errors.js.map +1 -0
  40. package/dist/cli/format/context.d.ts +9 -0
  41. package/dist/cli/format/context.js +786 -0
  42. package/dist/cli/format/context.js.map +1 -0
  43. package/dist/cli/format/debug.d.ts +4 -0
  44. package/dist/cli/format/debug.js +60 -0
  45. package/dist/cli/format/debug.js.map +1 -0
  46. package/dist/cli/format/highlight.d.ts +3 -0
  47. package/dist/cli/format/highlight.js +106 -0
  48. package/dist/cli/format/highlight.js.map +1 -0
  49. package/dist/cli/format/progress.d.ts +13 -0
  50. package/dist/cli/format/progress.js +290 -0
  51. package/dist/cli/format/progress.js.map +1 -0
  52. package/dist/cli/format/range.d.ts +3 -0
  53. package/dist/cli/format/range.js +24 -0
  54. package/dist/cli/format/range.js.map +1 -0
  55. package/dist/cli/format/status.d.ts +83 -0
  56. package/dist/cli/format/status.js +530 -0
  57. package/dist/cli/format/status.js.map +1 -0
  58. package/dist/cli/help.d.ts +1 -0
  59. package/dist/cli/help.js +546 -0
  60. package/dist/cli/help.js.map +1 -0
  61. package/dist/cli/index.d.ts +2 -0
  62. package/dist/cli/index.js +40 -0
  63. package/dist/cli/index.js.map +1 -0
  64. package/dist/cli/install.d.ts +4 -0
  65. package/dist/cli/install.js +1735 -0
  66. package/dist/cli/install.js.map +1 -0
  67. package/dist/cli/managed-rg.d.ts +10 -0
  68. package/dist/cli/managed-rg.js +337 -0
  69. package/dist/cli/managed-rg.js.map +1 -0
  70. package/dist/cli/server-search.d.ts +3 -0
  71. package/dist/cli/server-search.js +12 -0
  72. package/dist/cli/server-search.js.map +1 -0
  73. package/dist/cli/types.d.ts +87 -0
  74. package/dist/cli/types.js +10 -0
  75. package/dist/cli/types.js.map +1 -0
  76. package/dist/cli/version.d.ts +1 -0
  77. package/dist/cli/version.js +13 -0
  78. package/dist/cli/version.js.map +1 -0
  79. package/dist/client/daemon-client.d.ts +31 -0
  80. package/dist/client/daemon-client.js +203 -0
  81. package/dist/client/daemon-client.js.map +1 -0
  82. package/dist/client/mode-router.d.ts +9 -0
  83. package/dist/client/mode-router.js +28 -0
  84. package/dist/client/mode-router.js.map +1 -0
  85. package/dist/client/search-policy.d.ts +11 -0
  86. package/dist/client/search-policy.js +15 -0
  87. package/dist/client/search-policy.js.map +1 -0
  88. package/dist/daemon/backend.d.ts +78 -0
  89. package/dist/daemon/backend.js +1118 -0
  90. package/dist/daemon/backend.js.map +1 -0
  91. package/dist/daemon/change-set.d.ts +30 -0
  92. package/dist/daemon/change-set.js +163 -0
  93. package/dist/daemon/change-set.js.map +1 -0
  94. package/dist/daemon/config.d.ts +27 -0
  95. package/dist/daemon/config.js +107 -0
  96. package/dist/daemon/config.js.map +1 -0
  97. package/dist/daemon/errors.d.ts +5 -0
  98. package/dist/daemon/errors.js +11 -0
  99. package/dist/daemon/errors.js.map +1 -0
  100. package/dist/daemon/http-server.d.ts +30 -0
  101. package/dist/daemon/http-server.js +307 -0
  102. package/dist/daemon/http-server.js.map +1 -0
  103. package/dist/daemon/index-coordinator.d.ts +22 -0
  104. package/dist/daemon/index-coordinator.js +55 -0
  105. package/dist/daemon/index-coordinator.js.map +1 -0
  106. package/dist/daemon/job-scheduler.d.ts +85 -0
  107. package/dist/daemon/job-scheduler.js +492 -0
  108. package/dist/daemon/job-scheduler.js.map +1 -0
  109. package/dist/daemon/logger.d.ts +10 -0
  110. package/dist/daemon/logger.js +101 -0
  111. package/dist/daemon/logger.js.map +1 -0
  112. package/dist/daemon/model-pool.d.ts +48 -0
  113. package/dist/daemon/model-pool.js +190 -0
  114. package/dist/daemon/model-pool.js.map +1 -0
  115. package/dist/daemon/root-lease.d.ts +14 -0
  116. package/dist/daemon/root-lease.js +197 -0
  117. package/dist/daemon/root-lease.js.map +1 -0
  118. package/dist/daemon/root-runtime.d.ts +80 -0
  119. package/dist/daemon/root-runtime.js +340 -0
  120. package/dist/daemon/root-runtime.js.map +1 -0
  121. package/dist/daemon/runtime-manager.d.ts +47 -0
  122. package/dist/daemon/runtime-manager.js +252 -0
  123. package/dist/daemon/runtime-manager.js.map +1 -0
  124. package/dist/daemon/runtime.d.ts +12 -0
  125. package/dist/daemon/runtime.js +105 -0
  126. package/dist/daemon/runtime.js.map +1 -0
  127. package/dist/daemon/server-controller.d.ts +38 -0
  128. package/dist/daemon/server-controller.js +327 -0
  129. package/dist/daemon/server-controller.js.map +1 -0
  130. package/dist/daemon/watch-manager.d.ts +62 -0
  131. package/dist/daemon/watch-manager.js +415 -0
  132. package/dist/daemon/watch-manager.js.map +1 -0
  133. package/dist/daemon/workspace-read-session-cache.d.ts +31 -0
  134. package/dist/daemon/workspace-read-session-cache.js +115 -0
  135. package/dist/daemon/workspace-read-session-cache.js.map +1 -0
  136. package/dist/engine/code-formats.d.ts +3 -0
  137. package/dist/engine/code-formats.js +14 -0
  138. package/dist/engine/code-formats.js.map +1 -0
  139. package/dist/engine/config.d.ts +57 -0
  140. package/dist/engine/config.js +351 -0
  141. package/dist/engine/config.js.map +1 -0
  142. package/dist/engine/errors.d.ts +20 -0
  143. package/dist/engine/errors.js +51 -0
  144. package/dist/engine/errors.js.map +1 -0
  145. package/dist/engine/extraction/code/adapter.d.ts +19 -0
  146. package/dist/engine/extraction/code/adapter.js +24 -0
  147. package/dist/engine/extraction/code/adapter.js.map +1 -0
  148. package/dist/engine/extraction/code/extractor.d.ts +13 -0
  149. package/dist/engine/extraction/code/extractor.js +696 -0
  150. package/dist/engine/extraction/code/extractor.js.map +1 -0
  151. package/dist/engine/extraction/code/families/c-family.d.ts +2 -0
  152. package/dist/engine/extraction/code/families/c-family.js +122 -0
  153. package/dist/engine/extraction/code/families/c-family.js.map +1 -0
  154. package/dist/engine/extraction/code/families/js-ts.d.ts +12 -0
  155. package/dist/engine/extraction/code/families/js-ts.js +118 -0
  156. package/dist/engine/extraction/code/families/js-ts.js.map +1 -0
  157. package/dist/engine/extraction/code/families/metadata.d.ts +8 -0
  158. package/dist/engine/extraction/code/families/metadata.js +86 -0
  159. package/dist/engine/extraction/code/families/metadata.js.map +1 -0
  160. package/dist/engine/extraction/code/families/name-field.d.ts +3 -0
  161. package/dist/engine/extraction/code/families/name-field.js +22 -0
  162. package/dist/engine/extraction/code/families/name-field.js.map +1 -0
  163. package/dist/engine/extraction/code/languages/c.d.ts +1 -0
  164. package/dist/engine/extraction/code/languages/c.js +12 -0
  165. package/dist/engine/extraction/code/languages/c.js.map +1 -0
  166. package/dist/engine/extraction/code/languages/cpp.d.ts +1 -0
  167. package/dist/engine/extraction/code/languages/cpp.js +18 -0
  168. package/dist/engine/extraction/code/languages/cpp.js.map +1 -0
  169. package/dist/engine/extraction/code/languages/go.d.ts +2 -0
  170. package/dist/engine/extraction/code/languages/go.js +70 -0
  171. package/dist/engine/extraction/code/languages/go.js.map +1 -0
  172. package/dist/engine/extraction/code/languages/java.d.ts +1 -0
  173. package/dist/engine/extraction/code/languages/java.js +17 -0
  174. package/dist/engine/extraction/code/languages/java.js.map +1 -0
  175. package/dist/engine/extraction/code/languages/javascript.d.ts +2 -0
  176. package/dist/engine/extraction/code/languages/javascript.js +23 -0
  177. package/dist/engine/extraction/code/languages/javascript.js.map +1 -0
  178. package/dist/engine/extraction/code/languages/python.d.ts +2 -0
  179. package/dist/engine/extraction/code/languages/python.js +52 -0
  180. package/dist/engine/extraction/code/languages/python.js.map +1 -0
  181. package/dist/engine/extraction/code/languages/rust.d.ts +2 -0
  182. package/dist/engine/extraction/code/languages/rust.js +25 -0
  183. package/dist/engine/extraction/code/languages/rust.js.map +1 -0
  184. package/dist/engine/extraction/code/languages/typescript.d.ts +2 -0
  185. package/dist/engine/extraction/code/languages/typescript.js +37 -0
  186. package/dist/engine/extraction/code/languages/typescript.js.map +1 -0
  187. package/dist/engine/extraction/code/tree-sitter/grammar.d.ts +4 -0
  188. package/dist/engine/extraction/code/tree-sitter/grammar.js +49 -0
  189. package/dist/engine/extraction/code/tree-sitter/grammar.js.map +1 -0
  190. package/dist/engine/extraction/code/tree-sitter/nodes.d.ts +3 -0
  191. package/dist/engine/extraction/code/tree-sitter/nodes.js +27 -0
  192. package/dist/engine/extraction/code/tree-sitter/nodes.js.map +1 -0
  193. package/dist/engine/extraction/code/tree-sitter/parser.d.ts +2 -0
  194. package/dist/engine/extraction/code/tree-sitter/parser.js +31 -0
  195. package/dist/engine/extraction/code/tree-sitter/parser.js.map +1 -0
  196. package/dist/engine/extraction/ids.d.ts +1 -0
  197. package/dist/engine/extraction/ids.js +5 -0
  198. package/dist/engine/extraction/ids.js.map +1 -0
  199. package/dist/engine/extraction/image/extractor.d.ts +5 -0
  200. package/dist/engine/extraction/image/extractor.js +35 -0
  201. package/dist/engine/extraction/image/extractor.js.map +1 -0
  202. package/dist/engine/extraction/index.d.ts +4 -0
  203. package/dist/engine/extraction/index.js +3 -0
  204. package/dist/engine/extraction/index.js.map +1 -0
  205. package/dist/engine/extraction/markdown/extractor.d.ts +7 -0
  206. package/dist/engine/extraction/markdown/extractor.js +362 -0
  207. package/dist/engine/extraction/markdown/extractor.js.map +1 -0
  208. package/dist/engine/extraction/runtime.d.ts +9 -0
  209. package/dist/engine/extraction/runtime.js +37 -0
  210. package/dist/engine/extraction/runtime.js.map +1 -0
  211. package/dist/engine/extraction/source.d.ts +18 -0
  212. package/dist/engine/extraction/source.js +22 -0
  213. package/dist/engine/extraction/source.js.map +1 -0
  214. package/dist/engine/extraction/text/extractor.d.ts +7 -0
  215. package/dist/engine/extraction/text/extractor.js +168 -0
  216. package/dist/engine/extraction/text/extractor.js.map +1 -0
  217. package/dist/engine/extraction/types.d.ts +4 -0
  218. package/dist/engine/extraction/types.js +2 -0
  219. package/dist/engine/extraction/types.js.map +1 -0
  220. package/dist/engine/extraction/vector-content.d.ts +5 -0
  221. package/dist/engine/extraction/vector-content.js +83 -0
  222. package/dist/engine/extraction/vector-content.js.map +1 -0
  223. package/dist/engine/file-size-policy.d.ts +6 -0
  224. package/dist/engine/file-size-policy.js +20 -0
  225. package/dist/engine/file-size-policy.js.map +1 -0
  226. package/dist/engine/file-type.d.ts +15 -0
  227. package/dist/engine/file-type.js +152 -0
  228. package/dist/engine/file-type.js.map +1 -0
  229. package/dist/engine/index-status.d.ts +9 -0
  230. package/dist/engine/index-status.js +38 -0
  231. package/dist/engine/index-status.js.map +1 -0
  232. package/dist/engine/manifest.d.ts +13 -0
  233. package/dist/engine/manifest.js +124 -0
  234. package/dist/engine/manifest.js.map +1 -0
  235. package/dist/engine/models/artifact-cache-lock.d.ts +16 -0
  236. package/dist/engine/models/artifact-cache-lock.js +228 -0
  237. package/dist/engine/models/artifact-cache-lock.js.map +1 -0
  238. package/dist/engine/models/artifact-downloader.d.ts +77 -0
  239. package/dist/engine/models/artifact-downloader.js +766 -0
  240. package/dist/engine/models/artifact-downloader.js.map +1 -0
  241. package/dist/engine/models/backends/llama-cpp.d.ts +100 -0
  242. package/dist/engine/models/backends/llama-cpp.js +567 -0
  243. package/dist/engine/models/backends/llama-cpp.js.map +1 -0
  244. package/dist/engine/models/backends/model2vec-runtime.d.ts +63 -0
  245. package/dist/engine/models/backends/model2vec-runtime.js +112 -0
  246. package/dist/engine/models/backends/model2vec-runtime.js.map +1 -0
  247. package/dist/engine/models/backends/model2vec-tokenizer.d.ts +2 -0
  248. package/dist/engine/models/backends/model2vec-tokenizer.js +42 -0
  249. package/dist/engine/models/backends/model2vec-tokenizer.js.map +1 -0
  250. package/dist/engine/models/backends/model2vec-worker-pool.d.ts +25 -0
  251. package/dist/engine/models/backends/model2vec-worker-pool.js +264 -0
  252. package/dist/engine/models/backends/model2vec-worker-pool.js.map +1 -0
  253. package/dist/engine/models/backends/model2vec-worker.d.ts +1 -0
  254. package/dist/engine/models/backends/model2vec-worker.js +41 -0
  255. package/dist/engine/models/backends/model2vec-worker.js.map +1 -0
  256. package/dist/engine/models/backends/model2vec.d.ts +38 -0
  257. package/dist/engine/models/backends/model2vec.js +344 -0
  258. package/dist/engine/models/backends/model2vec.js.map +1 -0
  259. package/dist/engine/models/backends/qwen.d.ts +44 -0
  260. package/dist/engine/models/backends/qwen.js +411 -0
  261. package/dist/engine/models/backends/qwen.js.map +1 -0
  262. package/dist/engine/models/backends/transformers-js.d.ts +90 -0
  263. package/dist/engine/models/backends/transformers-js.js +411 -0
  264. package/dist/engine/models/backends/transformers-js.js.map +1 -0
  265. package/dist/engine/models/catalog.d.ts +490 -0
  266. package/dist/engine/models/catalog.js +522 -0
  267. package/dist/engine/models/catalog.js.map +1 -0
  268. package/dist/engine/models/download-progress.d.ts +16 -0
  269. package/dist/engine/models/download-progress.js +47 -0
  270. package/dist/engine/models/download-progress.js.map +1 -0
  271. package/dist/engine/models/embeddings.d.ts +73 -0
  272. package/dist/engine/models/embeddings.js +125 -0
  273. package/dist/engine/models/embeddings.js.map +1 -0
  274. package/dist/engine/models/factory.d.ts +2 -0
  275. package/dist/engine/models/factory.js +51 -0
  276. package/dist/engine/models/factory.js.map +1 -0
  277. package/dist/engine/models/index.d.ts +5 -0
  278. package/dist/engine/models/index.js +6 -0
  279. package/dist/engine/models/index.js.map +1 -0
  280. package/dist/engine/models/local-embedding-parallelism.d.ts +15 -0
  281. package/dist/engine/models/local-embedding-parallelism.js +63 -0
  282. package/dist/engine/models/local-embedding-parallelism.js.map +1 -0
  283. package/dist/engine/models/local-embedding-queue.d.ts +12 -0
  284. package/dist/engine/models/local-embedding-queue.js +65 -0
  285. package/dist/engine/models/local-embedding-queue.js.map +1 -0
  286. package/dist/engine/models/ranking.d.ts +19 -0
  287. package/dist/engine/models/ranking.js +2 -0
  288. package/dist/engine/models/ranking.js.map +1 -0
  289. package/dist/engine/models/resolution.d.ts +8 -0
  290. package/dist/engine/models/resolution.js +22 -0
  291. package/dist/engine/models/resolution.js.map +1 -0
  292. package/dist/engine/pipeline/indexing/index.d.ts +14 -0
  293. package/dist/engine/pipeline/indexing/index.js +1219 -0
  294. package/dist/engine/pipeline/indexing/index.js.map +1 -0
  295. package/dist/engine/pipeline/indexing/input-budget.d.ts +2 -0
  296. package/dist/engine/pipeline/indexing/input-budget.js +51 -0
  297. package/dist/engine/pipeline/indexing/input-budget.js.map +1 -0
  298. package/dist/engine/pipeline/indexing/root-paths.d.ts +7 -0
  299. package/dist/engine/pipeline/indexing/root-paths.js +148 -0
  300. package/dist/engine/pipeline/indexing/root-paths.js.map +1 -0
  301. package/dist/engine/pipeline/indexing/scanner/index.d.ts +14 -0
  302. package/dist/engine/pipeline/indexing/scanner/index.js +776 -0
  303. package/dist/engine/pipeline/indexing/scanner/index.js.map +1 -0
  304. package/dist/engine/pipeline/search/index.d.ts +12 -0
  305. package/dist/engine/pipeline/search/index.js +811 -0
  306. package/dist/engine/pipeline/search/index.js.map +1 -0
  307. package/dist/engine/service/index.d.ts +3 -0
  308. package/dist/engine/service/index.js +2 -0
  309. package/dist/engine/service/index.js.map +1 -0
  310. package/dist/engine/service/lexical.d.ts +28 -0
  311. package/dist/engine/service/lexical.js +446 -0
  312. package/dist/engine/service/lexical.js.map +1 -0
  313. package/dist/engine/service/root.d.ts +15 -0
  314. package/dist/engine/service/root.js +57 -0
  315. package/dist/engine/service/root.js.map +1 -0
  316. package/dist/engine/service/structure-enrichment.d.ts +8 -0
  317. package/dist/engine/service/structure-enrichment.js +178 -0
  318. package/dist/engine/service/structure-enrichment.js.map +1 -0
  319. package/dist/engine/service/types.d.ts +212 -0
  320. package/dist/engine/service/types.js +2 -0
  321. package/dist/engine/service/types.js.map +1 -0
  322. package/dist/engine/service/workspace-index.d.ts +26 -0
  323. package/dist/engine/service/workspace-index.js +157 -0
  324. package/dist/engine/service/workspace-index.js.map +1 -0
  325. package/dist/engine/service/zvec-grep.d.ts +15 -0
  326. package/dist/engine/service/zvec-grep.js +1520 -0
  327. package/dist/engine/service/zvec-grep.js.map +1 -0
  328. package/dist/engine/storage/index.d.ts +53 -0
  329. package/dist/engine/storage/index.js +3 -0
  330. package/dist/engine/storage/index.js.map +1 -0
  331. package/dist/engine/storage/layout.d.ts +10 -0
  332. package/dist/engine/storage/layout.js +29 -0
  333. package/dist/engine/storage/layout.js.map +1 -0
  334. package/dist/engine/storage/zvec.d.ts +4 -0
  335. package/dist/engine/storage/zvec.js +976 -0
  336. package/dist/engine/storage/zvec.js.map +1 -0
  337. package/dist/engine/types.d.ts +303 -0
  338. package/dist/engine/types.js +14 -0
  339. package/dist/engine/types.js.map +1 -0
  340. package/dist/engine/utils/atomic-file.d.ts +3 -0
  341. package/dist/engine/utils/atomic-file.js +39 -0
  342. package/dist/engine/utils/atomic-file.js.map +1 -0
  343. package/dist/engine/utils/daemon-lease.d.ts +17 -0
  344. package/dist/engine/utils/daemon-lease.js +175 -0
  345. package/dist/engine/utils/daemon-lease.js.map +1 -0
  346. package/dist/engine/utils/file-selection.d.ts +10 -0
  347. package/dist/engine/utils/file-selection.js +157 -0
  348. package/dist/engine/utils/file-selection.js.map +1 -0
  349. package/dist/engine/utils/glob.d.ts +9 -0
  350. package/dist/engine/utils/glob.js +208 -0
  351. package/dist/engine/utils/glob.js.map +1 -0
  352. package/dist/engine/utils/hash.d.ts +2 -0
  353. package/dist/engine/utils/hash.js +8 -0
  354. package/dist/engine/utils/hash.js.map +1 -0
  355. package/dist/engine/utils/json.d.ts +8 -0
  356. package/dist/engine/utils/json.js +83 -0
  357. package/dist/engine/utils/json.js.map +1 -0
  358. package/dist/engine/utils/lock.d.ts +19 -0
  359. package/dist/engine/utils/lock.js +254 -0
  360. package/dist/engine/utils/lock.js.map +1 -0
  361. package/dist/engine/utils/path.d.ts +4 -0
  362. package/dist/engine/utils/path.js +18 -0
  363. package/dist/engine/utils/path.js.map +1 -0
  364. package/dist/engine/utils/timing.d.ts +19 -0
  365. package/dist/engine/utils/timing.js +87 -0
  366. package/dist/engine/utils/timing.js.map +1 -0
  367. package/dist/index-progress.d.ts +10 -0
  368. package/dist/index-progress.js +159 -0
  369. package/dist/index-progress.js.map +1 -0
  370. package/dist/index.d.ts +6 -0
  371. package/dist/index.js +4 -0
  372. package/dist/index.js.map +1 -0
  373. package/dist/mcp/http-transport.d.ts +27 -0
  374. package/dist/mcp/http-transport.js +182 -0
  375. package/dist/mcp/http-transport.js.map +1 -0
  376. package/dist/mcp/input-normalization.d.ts +38 -0
  377. package/dist/mcp/input-normalization.js +104 -0
  378. package/dist/mcp/input-normalization.js.map +1 -0
  379. package/dist/mcp/progress-heartbeat.d.ts +17 -0
  380. package/dist/mcp/progress-heartbeat.js +46 -0
  381. package/dist/mcp/progress-heartbeat.js.map +1 -0
  382. package/dist/mcp/request-metadata.d.ts +2 -0
  383. package/dist/mcp/request-metadata.js +11 -0
  384. package/dist/mcp/request-metadata.js.map +1 -0
  385. package/dist/mcp/request-state.d.ts +40 -0
  386. package/dist/mcp/request-state.js +210 -0
  387. package/dist/mcp/request-state.js.map +1 -0
  388. package/dist/mcp/result-format.d.ts +13 -0
  389. package/dist/mcp/result-format.js +75 -0
  390. package/dist/mcp/result-format.js.map +1 -0
  391. package/dist/mcp/schemas.d.ts +668 -0
  392. package/dist/mcp/schemas.js +512 -0
  393. package/dist/mcp/schemas.js.map +1 -0
  394. package/dist/mcp/stdio-bridge.d.ts +15 -0
  395. package/dist/mcp/stdio-bridge.js +190 -0
  396. package/dist/mcp/stdio-bridge.js.map +1 -0
  397. package/dist/mcp/tools.d.ts +153 -0
  398. package/dist/mcp/tools.js +488 -0
  399. package/dist/mcp/tools.js.map +1 -0
  400. package/dist/mcp/toolset.d.ts +5 -0
  401. package/dist/mcp/toolset.js +12 -0
  402. package/dist/mcp/toolset.js.map +1 -0
  403. package/dist/observability/trace-context.d.ts +11 -0
  404. package/dist/observability/trace-context.js +138 -0
  405. package/dist/observability/trace-context.js.map +1 -0
  406. package/dist/prompts/zvec-grep-guidance.d.ts +2 -0
  407. package/dist/prompts/zvec-grep-guidance.js +9 -0
  408. package/dist/prompts/zvec-grep-guidance.js.map +1 -0
  409. package/docs/01-agents.md +217 -0
  410. package/docs/02-cli.md +259 -0
  411. package/docs/03-mcp.md +185 -0
  412. package/docs/04-pipeline.md +234 -0
  413. package/docs/05-architecture.md +86 -0
  414. package/docs/06-server.md +279 -0
  415. package/docs/07-embedding.md +227 -0
  416. package/docs/08-roadmap.md +85 -0
  417. package/docs/README.md +53 -0
  418. package/package.json +87 -0
@@ -0,0 +1,340 @@
1
+ import { openWorkspaceReadSession } from "../engine/service/zvec-grep.js";
2
+ import { WorkspaceReadSessionCache } from "./workspace-read-session-cache.js";
3
+ export class RootRuntime {
4
+ options;
5
+ canonicalRoot;
6
+ generation;
7
+ generationTail = Promise.resolve();
8
+ modelLoadRequest;
9
+ dirtyRevision = 0;
10
+ indexedRevision = 0;
11
+ fullReconciliationEpoch = 0;
12
+ reconciledFullEpoch = -1;
13
+ nonProbeableFullEpoch = 0;
14
+ initialFreshnessProbe;
15
+ watcherActive = false;
16
+ watcherPending = false;
17
+ watcherEpoch = 0;
18
+ writerPending = false;
19
+ writerReady;
20
+ writerReadyResolve;
21
+ writerContext;
22
+ writerModelKey;
23
+ activeWriterSearches = 0;
24
+ writerSearchesDrained;
25
+ writerSearchesDrainedResolve;
26
+ activeOperations = 0;
27
+ closed = false;
28
+ constructor(options) {
29
+ this.options = options;
30
+ this.canonicalRoot = options.canonicalRoot;
31
+ this.modelLoadRequest = options.modelLoadRequest;
32
+ }
33
+ updateModelLoadRequest(request) {
34
+ this.modelLoadRequest = request;
35
+ }
36
+ embeddingProvider() {
37
+ return this.modelLoadRequest?.model.provider;
38
+ }
39
+ currentModelLoadRequest() {
40
+ return this.modelLoadRequest;
41
+ }
42
+ beginActivity() {
43
+ if (this.closed) {
44
+ throw new Error("Root runtime is closed.");
45
+ }
46
+ this.activeOperations += 1;
47
+ this.options.onActivity?.();
48
+ let released = false;
49
+ return () => {
50
+ if (released) {
51
+ return;
52
+ }
53
+ released = true;
54
+ this.activeOperations = Math.max(0, this.activeOperations - 1);
55
+ this.options.onActivity?.();
56
+ };
57
+ }
58
+ async search(options, modelLoadRequest) {
59
+ this.options.onActivity?.();
60
+ if (this.closed) {
61
+ throw new Error("Root runtime is closed.");
62
+ }
63
+ const overrideModelKey = modelLoadRequest
64
+ ? this.options.modelPool.keyFor(modelLoadRequest)
65
+ : undefined;
66
+ while (true) {
67
+ const writerContext = this.writerContext;
68
+ if (writerContext &&
69
+ (overrideModelKey === undefined ||
70
+ overrideModelKey === this.writerModelKey)) {
71
+ return await this.withWriterContext(writerContext, options);
72
+ }
73
+ if (!this.writerPending || !this.writerReady) {
74
+ break;
75
+ }
76
+ await this.writerReady;
77
+ }
78
+ return this.runGenerationSerial(async () => {
79
+ if (this.closed) {
80
+ throw new Error("Root runtime is closed.");
81
+ }
82
+ const request = modelLoadRequest ?? this.modelLoadRequest;
83
+ if (!request) {
84
+ throw new Error("Root runtime does not have an embedding model.");
85
+ }
86
+ const desiredKey = this.options.modelPool.keyFor(request);
87
+ if (this.generation?.key !== desiredKey) {
88
+ await this.generation?.cache.close();
89
+ this.generation = {
90
+ key: desiredKey,
91
+ cache: new WorkspaceReadSessionCache({
92
+ open: () => this.openLeasedSession(request),
93
+ idleTtlMs: this.options.readSessionIdleTtlMs,
94
+ serializeOperations: true,
95
+ }),
96
+ };
97
+ }
98
+ return this.generation.cache.withRead((session) => session.context({
99
+ ...options,
100
+ root: this.canonicalRoot,
101
+ autoUpdate: false,
102
+ }));
103
+ });
104
+ }
105
+ setWriterPending(pending) {
106
+ if (pending === this.writerPending) {
107
+ return;
108
+ }
109
+ this.writerPending = pending;
110
+ if (pending) {
111
+ this.armWriterReady();
112
+ }
113
+ else {
114
+ this.notifyWriterStateChanged();
115
+ }
116
+ }
117
+ setWriterContext(context, modelKey) {
118
+ this.writerContext = context;
119
+ this.writerModelKey = modelKey;
120
+ this.notifyWriterStateChanged();
121
+ this.armWriterReady();
122
+ return async () => {
123
+ if (this.writerContext !== context) {
124
+ return;
125
+ }
126
+ this.writerContext = undefined;
127
+ this.writerModelKey = undefined;
128
+ this.notifyWriterStateChanged();
129
+ this.armWriterReady();
130
+ if (this.activeWriterSearches > 0) {
131
+ this.writerSearchesDrained ??= new Promise((resolve) => {
132
+ this.writerSearchesDrainedResolve = resolve;
133
+ });
134
+ await this.writerSearchesDrained;
135
+ }
136
+ };
137
+ }
138
+ markDirty() {
139
+ this.dirtyRevision += 1;
140
+ return this.dirtyRevision;
141
+ }
142
+ markIndexed(revision = this.dirtyRevision) {
143
+ this.indexedRevision = Math.max(this.indexedRevision, revision);
144
+ }
145
+ requireFullReconciliation(probeAllowed = false) {
146
+ this.fullReconciliationEpoch += 1;
147
+ if (!probeAllowed) {
148
+ this.nonProbeableFullEpoch = this.fullReconciliationEpoch;
149
+ }
150
+ }
151
+ armWriterReady() {
152
+ if (!this.writerPending || this.writerReady) {
153
+ return;
154
+ }
155
+ this.writerReady = new Promise((resolve) => {
156
+ this.writerReadyResolve = resolve;
157
+ });
158
+ }
159
+ notifyWriterStateChanged() {
160
+ const resolve = this.writerReadyResolve;
161
+ this.writerReadyResolve = undefined;
162
+ this.writerReady = undefined;
163
+ resolve?.();
164
+ }
165
+ reconciliationEpoch() {
166
+ return this.fullReconciliationEpoch;
167
+ }
168
+ markReconciled(revision = this.dirtyRevision, reconciliationEpoch = this.fullReconciliationEpoch) {
169
+ this.markIndexed(revision);
170
+ this.reconciledFullEpoch = Math.max(this.reconciledFullEpoch, reconciliationEpoch);
171
+ }
172
+ requiresFullReconciliation() {
173
+ return this.reconciledFullEpoch < this.fullReconciliationEpoch;
174
+ }
175
+ canProbeFullReconciliation() {
176
+ return this.nonProbeableFullEpoch <= this.reconciledFullEpoch;
177
+ }
178
+ needsReconciliation() {
179
+ return (this.requiresFullReconciliation() ||
180
+ this.indexedRevision < this.dirtyRevision);
181
+ }
182
+ hasKnownChanges() {
183
+ return (this.indexedRevision < this.dirtyRevision ||
184
+ (this.requiresFullReconciliation() && !this.canProbeFullReconciliation()));
185
+ }
186
+ probeInitialFreshness(probe, onResult) {
187
+ this.initialFreshnessProbe ??= this.probeFreshness(probe).then((result) => {
188
+ onResult?.(result);
189
+ return result;
190
+ });
191
+ return this.initialFreshnessProbe;
192
+ }
193
+ probeFreshness(probe) {
194
+ return this.runFreshnessProbe(probe);
195
+ }
196
+ setWatcherActive(active) {
197
+ this.watcherActive = active;
198
+ }
199
+ recordWatcherActivity() {
200
+ if (!this.closed)
201
+ this.options.onActivity?.();
202
+ }
203
+ setWatcherPending(pending) {
204
+ if (pending) {
205
+ this.watcherEpoch += 1;
206
+ }
207
+ this.watcherPending = pending;
208
+ }
209
+ async withWrite(operation) {
210
+ this.setWriterPending(true);
211
+ try {
212
+ return await this.runGenerationSerial(async () => {
213
+ const generation = this.generation;
214
+ this.generation = undefined;
215
+ await generation?.cache.close();
216
+ return operation();
217
+ });
218
+ }
219
+ finally {
220
+ this.setWriterPending(false);
221
+ }
222
+ }
223
+ snapshot() {
224
+ const read = this.generation?.cache.snapshot();
225
+ return {
226
+ readSessionOpen: read?.open ?? false,
227
+ activeReaders: read?.activeReaders ?? 0,
228
+ activeOperations: this.activeOperations,
229
+ writerPending: this.writerPending,
230
+ dirtyRevision: this.dirtyRevision,
231
+ indexedRevision: this.indexedRevision,
232
+ watcherActive: this.watcherActive,
233
+ watcherPending: this.watcherPending,
234
+ watcherEpoch: this.watcherEpoch,
235
+ };
236
+ }
237
+ async close() {
238
+ if (this.closed) {
239
+ return;
240
+ }
241
+ this.closed = true;
242
+ this.watcherActive = false;
243
+ this.watcherPending = false;
244
+ this.setWriterPending(false);
245
+ await this.runGenerationSerial(async () => {
246
+ const generation = this.generation;
247
+ this.generation = undefined;
248
+ try {
249
+ await generation?.cache.close();
250
+ }
251
+ finally {
252
+ await this.options.rootLease?.release();
253
+ }
254
+ });
255
+ }
256
+ async openLeasedSession(request) {
257
+ const lease = await this.options.modelPool.acquire(request);
258
+ let session;
259
+ try {
260
+ session = this.options.openSession
261
+ ? await this.options.openSession(lease)
262
+ : openWorkspaceReadSession(this.options.canonicalRoot, lease.model);
263
+ }
264
+ catch (error) {
265
+ lease.release();
266
+ throw error;
267
+ }
268
+ let closed = false;
269
+ return {
270
+ root: session.root,
271
+ modelKey: lease.key,
272
+ context: (contextOptions) => session.context(contextOptions),
273
+ async close() {
274
+ if (closed) {
275
+ return;
276
+ }
277
+ closed = true;
278
+ try {
279
+ await session.close();
280
+ }
281
+ finally {
282
+ lease.release();
283
+ }
284
+ },
285
+ };
286
+ }
287
+ async withWriterContext(context, options) {
288
+ this.activeWriterSearches += 1;
289
+ try {
290
+ return await context({
291
+ ...options,
292
+ root: this.canonicalRoot,
293
+ autoUpdate: false,
294
+ });
295
+ }
296
+ finally {
297
+ this.activeWriterSearches -= 1;
298
+ if (this.activeWriterSearches === 0) {
299
+ this.writerSearchesDrainedResolve?.();
300
+ this.writerSearchesDrainedResolve = undefined;
301
+ this.writerSearchesDrained = undefined;
302
+ }
303
+ }
304
+ }
305
+ async runFreshnessProbe(probe) {
306
+ const revision = this.dirtyRevision;
307
+ const watcherEpoch = this.watcherEpoch;
308
+ const reconciliationEpoch = this.fullReconciliationEpoch;
309
+ let fresh = false;
310
+ try {
311
+ fresh = await probe();
312
+ }
313
+ catch {
314
+ return "stale";
315
+ }
316
+ if (!fresh ||
317
+ this.dirtyRevision !== revision ||
318
+ this.watcherEpoch !== watcherEpoch ||
319
+ this.fullReconciliationEpoch !== reconciliationEpoch) {
320
+ return "stale";
321
+ }
322
+ this.markReconciled(revision, reconciliationEpoch);
323
+ return "fresh";
324
+ }
325
+ async runGenerationSerial(operation) {
326
+ const previous = this.generationTail;
327
+ let release;
328
+ this.generationTail = new Promise((resolve) => {
329
+ release = resolve;
330
+ });
331
+ await previous;
332
+ try {
333
+ return await operation();
334
+ }
335
+ finally {
336
+ release();
337
+ }
338
+ }
339
+ }
340
+ //# sourceMappingURL=root-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"root-runtime.js","sourceRoot":"","sources":["../../src/daemon/root-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAU1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAwB9E,MAAM,OAAO,WAAW;IA2BO;IA1BpB,aAAa,CAAS;IACvB,UAAU,CAAkB;IAC5B,cAAc,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAClD,gBAAgB,CAA6B;IAC7C,aAAa,GAAG,CAAC,CAAC;IAClB,eAAe,GAAG,CAAC,CAAC;IACpB,uBAAuB,GAAG,CAAC,CAAC;IAC5B,mBAAmB,GAAG,CAAC,CAAC,CAAC;IACzB,qBAAqB,GAAG,CAAC,CAAC;IAC1B,qBAAqB,CAA8B;IACnD,aAAa,GAAG,KAAK,CAAC;IACtB,cAAc,GAAG,KAAK,CAAC;IACvB,YAAY,GAAG,CAAC,CAAC;IACjB,aAAa,GAAG,KAAK,CAAC;IACtB,WAAW,CAAiB;IAC5B,kBAAkB,CAAc;IAChC,aAAa,CAEe;IAC5B,cAAc,CAAU;IACxB,oBAAoB,GAAG,CAAC,CAAC;IACzB,qBAAqB,CAAiB;IACtC,4BAA4B,CAAc;IAC1C,gBAAgB,GAAG,CAAC,CAAC;IACrB,MAAM,GAAG,KAAK,CAAC;IAEvB,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;QACtD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,sBAAsB,CAAC,OAAkC;QACvD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC;IAC/C,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC9B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAA+B,EAC/B,gBAA4C;QAE5C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,gBAAgB,GAAG,gBAAgB;YACvC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YACzC,IACE,aAAa;gBACb,CAAC,gBAAgB,KAAK,SAAS;oBAC7B,gBAAgB,KAAK,IAAI,CAAC,cAAc,CAAC,EAC3C,CAAC;gBACD,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM;YACR,CAAC;YACD,MAAM,IAAI,CAAC,WAAW,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,OAAO,GAAG,gBAAgB,IAAI,IAAI,CAAC,gBAAgB,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrC,IAAI,CAAC,UAAU,GAAG;oBAChB,GAAG,EAAE,UAAU;oBACf,KAAK,EAAE,IAAI,yBAAyB,CAAC;wBACnC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;wBAC3C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB;wBAC5C,mBAAmB,EAAE,IAAI;qBAC1B,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAChD,OAAO,CAAC,OAAO,CAAC;gBACd,GAAG,OAAO;gBACV,IAAI,EAAE,IAAI,CAAC,aAAa;gBACxB,UAAU,EAAE,KAAK;aAClB,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,OAAO,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED,gBAAgB,CACd,OAEmC,EACnC,QAAgB;QAEhB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,KAAK,IAAI,EAAE;YAChB,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAChC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,qBAAqB,KAAK,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAC3D,IAAI,CAAC,4BAA4B,GAAG,OAAO,CAAC;gBAC9C,CAAC,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,qBAAqB,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,SAAS;QACP,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa;QACvC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,yBAAyB,CAAC,YAAY,GAAG,KAAK;QAC5C,IAAI,CAAC,uBAAuB,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,uBAAuB,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC/C,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,wBAAwB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACxC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACtC,CAAC;IAED,cAAc,CACZ,QAAQ,GAAG,IAAI,CAAC,aAAa,EAC7B,mBAAmB,GAAG,IAAI,CAAC,uBAAuB;QAElD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,CACjC,IAAI,CAAC,mBAAmB,EACxB,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,uBAAuB,CAAC;IACjE,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,mBAAmB,CAAC;IAChE,CAAC;IAED,mBAAmB;QACjB,OAAO,CACL,IAAI,CAAC,0BAA0B,EAAE;YACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa,CAC1C,CAAC;IACJ,CAAC;IAED,eAAe;QACb,OAAO,CACL,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa;YACzC,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,qBAAqB,CACnB,KAA6B,EAC7B,QAA8C;QAE9C,IAAI,CAAC,qBAAqB,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACxE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,KAA6B;QAC1C,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,gBAAgB,CAAC,MAAe;QAC9B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED,qBAAqB;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,iBAAiB,CAAC,OAAgB;QAChC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,SAA2B;QAC5C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,IAAI,EAAE;gBAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;gBACnC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC5B,MAAM,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,OAAO,SAAS,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,QAAQ;QAWN,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAO;YACL,eAAe,EAAE,IAAI,EAAE,IAAI,IAAI,KAAK;YACpC,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC;YACvC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,IAAI,EAAE;YACxC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,OAAkC;QAElC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,OAA6B,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW;gBAChC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,KAAK,CAAC,GAAG;YACnB,OAAO,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;YAC5D,KAAK,CAAC,KAAK;gBACT,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO;gBACT,CAAC;gBACD,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,OAEmC,EACnC,OAA+B;QAE/B,IAAI,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC;gBACnB,GAAG,OAAO;gBACV,IAAI,EAAE,IAAI,CAAC,aAAa;gBACxB,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,oBAAoB,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,oBAAoB,KAAK,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,4BAA4B,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC,4BAA4B,GAAG,SAAS,CAAC;gBAC9C,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,KAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACvC,MAAM,mBAAmB,GAAG,IAAI,CAAC,uBAAuB,CAAC;QACzD,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IACE,CAAC,KAAK;YACN,IAAI,CAAC,aAAa,KAAK,QAAQ;YAC/B,IAAI,CAAC,YAAY,KAAK,YAAY;YAClC,IAAI,CAAC,uBAAuB,KAAK,mBAAmB,EACpD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,SAA2B;QAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACrC,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClD,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,47 @@
1
+ import { type ZvecGrepInfoResult } from "../engine/service/index.js";
2
+ import type { CreateZvecGrepOptions } from "../engine/service/types.js";
3
+ import type { EmbeddingModelLoadRequest, EmbeddingModelPool } from "./model-pool.js";
4
+ import { RootRuntime } from "./root-runtime.js";
5
+ import { RootLeaseManager } from "./root-lease.js";
6
+ export type RuntimeManagerOptions = {
7
+ modelPool: EmbeddingModelPool;
8
+ serviceOptions?: CreateZvecGrepOptions;
9
+ readSessionIdleTtlMs?: number;
10
+ runtimeIdleTtlMs?: number;
11
+ onRuntimeEvicted?: (canonicalRoot: string) => void | Promise<void>;
12
+ rootLeaseManager?: RootLeaseManager;
13
+ createRuntime?: (input: {
14
+ canonicalRoot: string;
15
+ modelLoadRequest?: EmbeddingModelLoadRequest;
16
+ modelPool: EmbeddingModelPool;
17
+ }) => RootRuntime | Promise<RootRuntime>;
18
+ };
19
+ export type RuntimeManagerSnapshot = {
20
+ activeRuntimes: number;
21
+ };
22
+ export declare class RuntimeManager {
23
+ private readonly options;
24
+ private readonly runtimes;
25
+ private readonly creating;
26
+ private readonly aliases;
27
+ private readonly rootLeaseManager;
28
+ private readonly idleTimers;
29
+ private closed;
30
+ constructor(options: RuntimeManagerOptions);
31
+ get instanceToken(): string;
32
+ activate(requestedRoot: string): Promise<RootRuntime>;
33
+ activateForIndex(requestedRoot: string): Promise<RootRuntime>;
34
+ peek(requestedRoot: string): Promise<RootRuntime | undefined>;
35
+ getByCanonicalRoot(canonicalRoot: string): RootRuntime | undefined;
36
+ getByRequestedRoot(requestedRoot: string): RootRuntime | undefined;
37
+ snapshot(): RuntimeManagerSnapshot;
38
+ evict(canonicalRoot: string): Promise<boolean>;
39
+ close(): Promise<void>;
40
+ private getOrCreate;
41
+ private createRuntime;
42
+ private touchRuntime;
43
+ private scheduleIdleCheck;
44
+ private evictIfIdle;
45
+ }
46
+ export declare function inspectRoot(requestedRoot: string, serviceOptions?: CreateZvecGrepOptions, includeStatus?: boolean): Promise<ZvecGrepInfoResult>;
47
+ export declare function resolveRequestedRoot(requestedRoot: string, writable: boolean): Promise<string>;
@@ -0,0 +1,252 @@
1
+ import { access, realpath, stat } from "node:fs/promises";
2
+ import { constants as fsConstants } from "node:fs";
3
+ import { isAbsolute } from "node:path";
4
+ import { createZvecGrep, } from "../engine/service/index.js";
5
+ import { DaemonError } from "./errors.js";
6
+ import { DEFAULT_WATCHER_IDLE_TIMEOUT_MS } from "./config.js";
7
+ import { RootRuntime } from "./root-runtime.js";
8
+ import { RootLeaseManager } from "./root-lease.js";
9
+ const BUSY_RUNTIME_IDLE_RETRY_MS = 1_000;
10
+ export class RuntimeManager {
11
+ options;
12
+ runtimes = new Map();
13
+ creating = new Map();
14
+ aliases = new Map();
15
+ rootLeaseManager;
16
+ idleTimers = new Map();
17
+ closed = false;
18
+ constructor(options) {
19
+ this.options = options;
20
+ this.rootLeaseManager = options.rootLeaseManager ?? new RootLeaseManager();
21
+ }
22
+ get instanceToken() {
23
+ return this.rootLeaseManager.instanceToken;
24
+ }
25
+ async activate(requestedRoot) {
26
+ if (this.closed) {
27
+ throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
28
+ }
29
+ const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, false);
30
+ const activeRequestedRoot = this.runtimes.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
31
+ if (activeRequestedRoot &&
32
+ (activeRequestedRoot.snapshot().writerPending ||
33
+ activeRequestedRoot.needsReconciliation())) {
34
+ return activeRequestedRoot;
35
+ }
36
+ const creatingRequestedRoot = this.creating.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
37
+ if (creatingRequestedRoot) {
38
+ return creatingRequestedRoot;
39
+ }
40
+ const info = await inspectRoot(requestedRoot, this.options.serviceOptions, false);
41
+ if (!info.indexed || !info.workspaceIndex?.embedding) {
42
+ throw new DaemonError("INDEX_MISSING", `Indexed search requires a built zvec-grep index for ${info.root}. Use an available exact-search fallback when it is sufficient. Creating or rebuilding a persistent index requires explicit user authorization.`);
43
+ }
44
+ const canonicalRoot = await realpath(info.root);
45
+ this.aliases.set(canonicalRequestedRoot, canonicalRoot);
46
+ return this.getOrCreate(canonicalRoot, {
47
+ model: {
48
+ provider: info.workspaceIndex.embedding.provider,
49
+ name: info.workspaceIndex.embedding.model,
50
+ },
51
+ });
52
+ }
53
+ async activateForIndex(requestedRoot) {
54
+ if (this.closed) {
55
+ throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
56
+ }
57
+ const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, true);
58
+ const activeRequestedRoot = this.runtimes.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
59
+ if (activeRequestedRoot) {
60
+ return activeRequestedRoot;
61
+ }
62
+ const creatingRequestedRoot = this.creating.get(this.aliases.get(canonicalRequestedRoot) ?? canonicalRequestedRoot);
63
+ if (creatingRequestedRoot) {
64
+ return creatingRequestedRoot;
65
+ }
66
+ const info = await inspectRoot(canonicalRequestedRoot, this.options.serviceOptions, false);
67
+ const canonicalRoot = await resolveRequestedRoot(info.root, true);
68
+ this.aliases.set(canonicalRequestedRoot, canonicalRoot);
69
+ return this.getOrCreate(canonicalRoot);
70
+ }
71
+ async peek(requestedRoot) {
72
+ const info = await inspectRoot(requestedRoot, this.options.serviceOptions, false);
73
+ const canonicalRoot = await realpath(info.root);
74
+ return this.runtimes.get(canonicalRoot);
75
+ }
76
+ getByCanonicalRoot(canonicalRoot) {
77
+ return this.runtimes.get(canonicalRoot);
78
+ }
79
+ getByRequestedRoot(requestedRoot) {
80
+ return this.runtimes.get(this.aliases.get(requestedRoot) ?? requestedRoot);
81
+ }
82
+ snapshot() {
83
+ return { activeRuntimes: this.runtimes.size };
84
+ }
85
+ async evict(canonicalRoot) {
86
+ const creating = this.creating.get(canonicalRoot);
87
+ if (creating) {
88
+ await creating;
89
+ }
90
+ const timer = this.idleTimers.get(canonicalRoot);
91
+ if (timer)
92
+ clearTimeout(timer);
93
+ this.idleTimers.delete(canonicalRoot);
94
+ const runtime = this.runtimes.get(canonicalRoot);
95
+ this.runtimes.delete(canonicalRoot);
96
+ for (const [alias, target] of this.aliases) {
97
+ if (alias === canonicalRoot || target === canonicalRoot) {
98
+ this.aliases.delete(alias);
99
+ }
100
+ }
101
+ if (!runtime)
102
+ return false;
103
+ try {
104
+ await this.options.onRuntimeEvicted?.(canonicalRoot);
105
+ }
106
+ finally {
107
+ await runtime.close();
108
+ }
109
+ return true;
110
+ }
111
+ async close() {
112
+ if (this.closed) {
113
+ return;
114
+ }
115
+ this.closed = true;
116
+ await Promise.allSettled(this.creating.values());
117
+ const runtimes = [...this.runtimes.values()];
118
+ for (const timer of this.idleTimers.values())
119
+ clearTimeout(timer);
120
+ this.idleTimers.clear();
121
+ this.runtimes.clear();
122
+ this.aliases.clear();
123
+ await Promise.all(runtimes.map((runtime) => runtime.close()));
124
+ await this.rootLeaseManager.close();
125
+ }
126
+ async getOrCreate(canonicalRoot, modelLoadRequest) {
127
+ const existing = this.runtimes.get(canonicalRoot);
128
+ if (existing) {
129
+ if (modelLoadRequest) {
130
+ existing.updateModelLoadRequest(modelLoadRequest);
131
+ }
132
+ this.touchRuntime(canonicalRoot);
133
+ return existing;
134
+ }
135
+ let pending = this.creating.get(canonicalRoot);
136
+ if (!pending) {
137
+ pending = this.createRuntime(canonicalRoot, modelLoadRequest);
138
+ this.creating.set(canonicalRoot, pending);
139
+ }
140
+ try {
141
+ const runtime = await pending;
142
+ if (modelLoadRequest) {
143
+ runtime.updateModelLoadRequest(modelLoadRequest);
144
+ }
145
+ this.touchRuntime(canonicalRoot);
146
+ return runtime;
147
+ }
148
+ finally {
149
+ this.creating.delete(canonicalRoot);
150
+ }
151
+ }
152
+ async createRuntime(canonicalRoot, modelLoadRequest) {
153
+ let runtime;
154
+ if (this.options.createRuntime) {
155
+ runtime = await this.options.createRuntime({
156
+ canonicalRoot,
157
+ modelLoadRequest,
158
+ modelPool: this.options.modelPool,
159
+ });
160
+ }
161
+ else {
162
+ const rootLease = await this.rootLeaseManager.acquire(canonicalRoot);
163
+ runtime = new RootRuntime({
164
+ canonicalRoot,
165
+ modelPool: this.options.modelPool,
166
+ modelLoadRequest,
167
+ rootLease,
168
+ readSessionIdleTtlMs: this.options.readSessionIdleTtlMs,
169
+ onActivity: () => this.touchRuntime(canonicalRoot),
170
+ });
171
+ }
172
+ if (this.closed) {
173
+ await runtime.close();
174
+ throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
175
+ }
176
+ this.runtimes.set(canonicalRoot, runtime);
177
+ this.touchRuntime(canonicalRoot);
178
+ return runtime;
179
+ }
180
+ touchRuntime(canonicalRoot) {
181
+ const idleTtlMs = this.options.runtimeIdleTtlMs ?? DEFAULT_WATCHER_IDLE_TIMEOUT_MS;
182
+ this.scheduleIdleCheck(canonicalRoot, idleTtlMs);
183
+ }
184
+ scheduleIdleCheck(canonicalRoot, delayMs) {
185
+ const existing = this.idleTimers.get(canonicalRoot);
186
+ if (existing)
187
+ clearTimeout(existing);
188
+ if (delayMs <= 0 || this.closed) {
189
+ return;
190
+ }
191
+ const timer = setTimeout(() => void this.evictIfIdle(canonicalRoot), delayMs);
192
+ timer.unref?.();
193
+ this.idleTimers.set(canonicalRoot, timer);
194
+ }
195
+ async evictIfIdle(canonicalRoot) {
196
+ this.idleTimers.delete(canonicalRoot);
197
+ const runtime = this.runtimes.get(canonicalRoot);
198
+ if (!runtime) {
199
+ return;
200
+ }
201
+ const snapshot = runtime.snapshot();
202
+ if (snapshot.activeReaders > 0 ||
203
+ snapshot.activeOperations > 0 ||
204
+ snapshot.writerPending ||
205
+ snapshot.watcherPending) {
206
+ const idleTtlMs = this.options.runtimeIdleTtlMs ?? DEFAULT_WATCHER_IDLE_TIMEOUT_MS;
207
+ this.scheduleIdleCheck(canonicalRoot, Math.min(idleTtlMs, BUSY_RUNTIME_IDLE_RETRY_MS));
208
+ return;
209
+ }
210
+ await this.evict(canonicalRoot);
211
+ }
212
+ }
213
+ export async function inspectRoot(requestedRoot, serviceOptions = {}, includeStatus = true) {
214
+ const canonicalRequestedRoot = await resolveRequestedRoot(requestedRoot, false);
215
+ const service = await createZvecGrep({
216
+ ...serviceOptions,
217
+ root: canonicalRequestedRoot,
218
+ });
219
+ try {
220
+ return await service.info({ root: canonicalRequestedRoot, includeStatus });
221
+ }
222
+ finally {
223
+ await service.close();
224
+ }
225
+ }
226
+ export async function resolveRequestedRoot(requestedRoot, writable) {
227
+ if (!isAbsolute(requestedRoot)) {
228
+ throw new DaemonError("ROOT_NOT_ABSOLUTE", "root must be an absolute path.");
229
+ }
230
+ let rootStat;
231
+ try {
232
+ rootStat = await stat(requestedRoot);
233
+ }
234
+ catch (error) {
235
+ const code = error.code;
236
+ if (code === "EACCES" || code === "EPERM") {
237
+ throw new DaemonError("ROOT_PERMISSION_DENIED", "root is not readable.");
238
+ }
239
+ throw new DaemonError("ROOT_NOT_FOUND", "root does not exist.");
240
+ }
241
+ if (!rootStat.isDirectory()) {
242
+ throw new DaemonError("ROOT_NOT_FOUND", "root is not a directory.");
243
+ }
244
+ try {
245
+ await access(requestedRoot, writable ? fsConstants.R_OK | fsConstants.W_OK : fsConstants.R_OK);
246
+ }
247
+ catch {
248
+ throw new DaemonError("ROOT_PERMISSION_DENIED", writable ? "root is not writable." : "root is not readable.");
249
+ }
250
+ return realpath(requestedRoot);
251
+ }
252
+ //# sourceMappingURL=runtime-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-manager.js","sourceRoot":"","sources":["../../src/daemon/runtime-manager.ts"],"names":[],"mappings":"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"}