@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,13 @@
1
+ import { readFileSync } from "node:fs";
2
+ export function readPackageVersion() {
3
+ try {
4
+ const packageJson = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
5
+ return typeof packageJson.version === "string"
6
+ ? packageJson.version
7
+ : "0.0.0";
8
+ }
9
+ catch {
10
+ return "0.0.0";
11
+ }
12
+ }
13
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC5C,CAAC;QAE3B,OAAO,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;YAC5C,CAAC,CAAC,WAAW,CAAC,OAAO;YACrB,CAAC,CAAC,OAAO,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}
@@ -0,0 +1,31 @@
1
+ import type { Progress } from "@modelcontextprotocol/client";
2
+ type DaemonToolCallOptions = {
3
+ onProgress?: (progress: Progress) => void;
4
+ embeddingEnvironment?: string;
5
+ toolContract?: {
6
+ inputProperties?: readonly string[];
7
+ outputProperties?: readonly string[];
8
+ errorMessage: string;
9
+ };
10
+ };
11
+ export declare class DaemonClient {
12
+ private readonly options;
13
+ constructor(options: {
14
+ serverUrl: string;
15
+ home?: string;
16
+ tokenFile?: string;
17
+ allowRemote?: boolean;
18
+ });
19
+ callTool(name: string, args: Record<string, unknown>, callOptions?: DaemonToolCallOptions): Promise<Record<string, unknown>>;
20
+ callTextTool(name: string, args: Record<string, unknown>, callOptions?: DaemonToolCallOptions): Promise<string>;
21
+ private invokeTool;
22
+ }
23
+ export declare function toolSatisfiesContract(tool: {
24
+ inputSchema?: unknown;
25
+ outputSchema?: unknown;
26
+ } | null | undefined, contract: {
27
+ inputProperties?: readonly string[];
28
+ outputProperties?: readonly string[];
29
+ }): boolean;
30
+ export declare function daemonAdminServerUrl(serverUrl: string): URL;
31
+ export {};
@@ -0,0 +1,203 @@
1
+ import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
2
+ import { createInterface } from "node:readline/promises";
3
+ import { resolveClientToken } from "../daemon/config.js";
4
+ import { LONG_RUNNING_MCP_TIMEOUT_MS, withProgressHeartbeat, } from "../mcp/progress-heartbeat.js";
5
+ import { EMBEDDING_ENVIRONMENT_META_KEY } from "../mcp/request-metadata.js";
6
+ export class DaemonClient {
7
+ options;
8
+ constructor(options) {
9
+ this.options = options;
10
+ }
11
+ async callTool(name, args, callOptions = {}) {
12
+ return (await this.invokeTool(name, args, callOptions, "structured"));
13
+ }
14
+ async callTextTool(name, args, callOptions = {}) {
15
+ return (await this.invokeTool(name, args, callOptions, "text"));
16
+ }
17
+ async invokeTool(name, args, callOptions, resultKind) {
18
+ const abortController = new AbortController();
19
+ let cancelledByCtrlC = false;
20
+ const onInterrupt = () => {
21
+ abortController.abort(new Error("Operation cancelled by user."));
22
+ };
23
+ const token = await resolveClientToken({
24
+ home: this.options.home,
25
+ tokenFile: this.options.tokenFile,
26
+ });
27
+ process.once("SIGINT", onInterrupt);
28
+ const client = new Client({ name: "zvec-grep-cli", version: "1.0.0" }, {
29
+ capabilities: { elicitation: { form: {} } },
30
+ versionNegotiation: { mode: { pin: "2026-07-28" } },
31
+ });
32
+ client.setRequestHandler("elicitation/create", async (request, ctx) => {
33
+ if (this.options.allowRemote) {
34
+ return {
35
+ action: "accept",
36
+ content: { decision: "allow_once" },
37
+ };
38
+ }
39
+ if (!process.stdin.isTTY || !process.stdout.isTTY) {
40
+ return { action: "decline" };
41
+ }
42
+ console.error(request.params.message);
43
+ console.error("");
44
+ console.error("1. Allow once");
45
+ console.error("2. Allow for this workspace");
46
+ const requested = request.params.mode === "form"
47
+ ? JSON.stringify(request.params.requestedSchema)
48
+ : "";
49
+ const localDecision = requested.includes("use_local_search")
50
+ ? { value: "use_local_search", label: "Use FTS only" }
51
+ : undefined;
52
+ if (localDecision)
53
+ console.error(`3. ${localDecision.label}`);
54
+ const cancelChoice = localDecision ? 4 : 3;
55
+ console.error(`${cancelChoice}. Cancel`);
56
+ const readline = createInterface({
57
+ input: process.stdin,
58
+ output: process.stderr,
59
+ });
60
+ try {
61
+ let answer;
62
+ try {
63
+ answer = await withProgressHeartbeat(ctx, async () => await readline.question(`Choose [1-${cancelChoice}]: `, {
64
+ signal: AbortSignal.any([
65
+ abortController.signal,
66
+ ctx.mcpReq.signal,
67
+ ]),
68
+ }), { message: "Waiting for Remote Embedding authorization input." });
69
+ }
70
+ catch (error) {
71
+ if (isCtrlCError(error)) {
72
+ cancelledByCtrlC = true;
73
+ return { action: "cancel" };
74
+ }
75
+ throw error;
76
+ }
77
+ const decision = answer.trim();
78
+ if (decision === "1") {
79
+ return {
80
+ action: "accept",
81
+ content: { decision: "allow_once" },
82
+ };
83
+ }
84
+ if (decision === "2") {
85
+ return {
86
+ action: "accept",
87
+ content: { decision: "allow_workspace" },
88
+ };
89
+ }
90
+ if (decision === "3" && localDecision) {
91
+ return {
92
+ action: "accept",
93
+ content: { decision: localDecision.value },
94
+ };
95
+ }
96
+ return { action: "decline" };
97
+ }
98
+ finally {
99
+ readline.close();
100
+ }
101
+ });
102
+ const transport = new StreamableHTTPClientTransport(daemonAdminServerUrl(this.options.serverUrl), {
103
+ requestInit: {
104
+ headers: token ? { Authorization: `Bearer ${token}` } : {},
105
+ },
106
+ });
107
+ try {
108
+ await client.connect(transport);
109
+ if (callOptions.toolContract) {
110
+ const listed = await client.listTools();
111
+ const tool = listed.tools.find((candidate) => candidate.name === name);
112
+ if (!toolSatisfiesContract(tool, callOptions.toolContract)) {
113
+ throw new Error(callOptions.toolContract.errorMessage);
114
+ }
115
+ }
116
+ const result = await client.callTool({
117
+ name,
118
+ arguments: args,
119
+ ...(callOptions.embeddingEnvironment
120
+ ? {
121
+ _meta: {
122
+ [EMBEDDING_ENVIRONMENT_META_KEY]: callOptions.embeddingEnvironment,
123
+ },
124
+ }
125
+ : {}),
126
+ }, {
127
+ signal: abortController.signal,
128
+ timeout: LONG_RUNNING_MCP_TIMEOUT_MS,
129
+ onprogress: callOptions.onProgress ?? (() => undefined),
130
+ resetTimeoutOnProgress: true,
131
+ });
132
+ if (cancelledByCtrlC) {
133
+ throw new Error("Operation cancelled by user.");
134
+ }
135
+ if (result.isError) {
136
+ const text = toolResultText(result.content);
137
+ throw new Error(text ?? `${name} failed`);
138
+ }
139
+ if (resultKind === "text") {
140
+ const text = toolResultText(result.content);
141
+ if (text === undefined) {
142
+ throw new Error(`${name} returned no text content`);
143
+ }
144
+ return text;
145
+ }
146
+ return (result.structuredContent ?? {});
147
+ }
148
+ catch (error) {
149
+ if (abortController.signal.aborted || isCtrlCError(error)) {
150
+ throw new Error("Operation cancelled by user.", { cause: error });
151
+ }
152
+ throw error;
153
+ }
154
+ finally {
155
+ process.off("SIGINT", onInterrupt);
156
+ await client.close().catch(() => undefined);
157
+ }
158
+ }
159
+ }
160
+ export function toolSatisfiesContract(tool, contract) {
161
+ if (!tool)
162
+ return false;
163
+ return (hasSchemaProperties(tool.inputSchema, contract.inputProperties) &&
164
+ hasSchemaProperties(tool.outputSchema, contract.outputProperties));
165
+ }
166
+ function hasSchemaProperties(schema, required) {
167
+ if (!required || required.length === 0)
168
+ return true;
169
+ if (typeof schema !== "object" || schema === null)
170
+ return false;
171
+ const properties = schema.properties;
172
+ if (typeof properties !== "object" || properties === null)
173
+ return false;
174
+ return required.every((property) => property in properties);
175
+ }
176
+ export function daemonAdminServerUrl(serverUrl) {
177
+ const url = new URL(serverUrl);
178
+ const publicPath = url.pathname.replace(/\/+$/, "");
179
+ if (!publicPath.endsWith("/mcp")) {
180
+ throw new Error(`zvec-grep server URL must end with /mcp (received ${url.pathname})`);
181
+ }
182
+ url.pathname = `${publicPath}/admin`;
183
+ return url;
184
+ }
185
+ function toolResultText(content) {
186
+ if (!Array.isArray(content)) {
187
+ return undefined;
188
+ }
189
+ for (const value of content) {
190
+ if (typeof value !== "object" || value === null) {
191
+ continue;
192
+ }
193
+ const item = value;
194
+ if (item.type === "text" && typeof item.text === "string") {
195
+ return item.text;
196
+ }
197
+ }
198
+ return undefined;
199
+ }
200
+ function isCtrlCError(error) {
201
+ return error instanceof Error && /aborted with Ctrl\+C/i.test(error.message);
202
+ }
203
+ //# sourceMappingURL=daemon-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-client.js","sourceRoot":"","sources":["../../src/client/daemon-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { type ZvecGrepClientMode } from "../engine/config.js";
2
+ export declare function resolveClientMode(explicit?: ZvecGrepClientMode): ZvecGrepClientMode;
3
+ export declare function resolveServerUrl(): string;
4
+ export declare function routeByMode<T>(options: {
5
+ mode: ZvecGrepClientMode;
6
+ direct: () => Promise<T>;
7
+ server: () => Promise<T>;
8
+ serverAvailable: () => Promise<boolean>;
9
+ }): Promise<T>;
@@ -0,0 +1,28 @@
1
+ import { readGlobalConfig } from "../engine/config.js";
2
+ import { configuredServerUrl } from "../daemon/config.js";
3
+ export function resolveClientMode(explicit) {
4
+ const configured = explicit ??
5
+ parseMode(process.env.ZVEC_GREP_MODE) ??
6
+ readGlobalConfig().client?.mode;
7
+ return configured ?? "auto";
8
+ }
9
+ export function resolveServerUrl() {
10
+ return process.env.ZVEC_GREP_SERVER_URL ?? configuredServerUrl();
11
+ }
12
+ export async function routeByMode(options) {
13
+ if (options.mode === "direct")
14
+ return options.direct();
15
+ if (options.mode === "server")
16
+ return options.server();
17
+ return (await options.serverAvailable())
18
+ ? options.server()
19
+ : options.direct();
20
+ }
21
+ function parseMode(value) {
22
+ if (!value)
23
+ return undefined;
24
+ if (value === "direct" || value === "server" || value === "auto")
25
+ return value;
26
+ throw new Error("ZVEC_GREP_MODE must be direct, server, or auto");
27
+ }
28
+ //# sourceMappingURL=mode-router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mode-router.js","sourceRoot":"","sources":["../../src/client/mode-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA2B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAC/B,QAA6B;IAE7B,MAAM,UAAU,GACd,QAAQ;QACR,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;IAClC,OAAO,UAAU,IAAI,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,mBAAmB,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAKpC;IACC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IACvD,OAAO,CAAC,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QACtC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE;QAClB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM;QAC9D,OAAO,KAAK,CAAC;IACf,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AACpE,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { CliOptions } from "../cli/types.js";
2
+ export type ServerSearchPolicy = {
3
+ freshness: "eventual" | "wait_for_fresh";
4
+ autoUpdate: boolean;
5
+ };
6
+ export type DirectSearchPolicy = {
7
+ freshness: "eventual" | "wait_for_fresh";
8
+ autoUpdate: boolean;
9
+ };
10
+ export declare function resolveServerSearchPolicy(options: Pick<CliOptions, "refresh">): ServerSearchPolicy;
11
+ export declare function resolveDirectSearchPolicy(options: Pick<CliOptions, "refresh">): DirectSearchPolicy;
@@ -0,0 +1,15 @@
1
+ export function resolveServerSearchPolicy(options) {
2
+ const refresh = options.refresh ?? "background";
3
+ return {
4
+ freshness: refresh === "wait" ? "wait_for_fresh" : "eventual",
5
+ autoUpdate: refresh !== "off",
6
+ };
7
+ }
8
+ export function resolveDirectSearchPolicy(options) {
9
+ const wait = options.refresh === "wait";
10
+ return {
11
+ freshness: wait ? "wait_for_fresh" : "eventual",
12
+ autoUpdate: wait,
13
+ };
14
+ }
15
+ //# sourceMappingURL=search-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-policy.js","sourceRoot":"","sources":["../../src/client/search-policy.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,yBAAyB,CACvC,OAAoC;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC;IAChD,OAAO;QACL,SAAS,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QAC7D,UAAU,EAAE,OAAO,KAAK,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QAC/C,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,78 @@
1
+ import { createZvecGrep } from "../engine/service/index.js";
2
+ import type { CreateZvecGrepOptions } from "../engine/service/types.js";
3
+ import type { IndexProgress } from "../engine/types.js";
4
+ import { type NormalizedSearchInput } from "../mcp/input-normalization.js";
5
+ import type { ZvecGrepDaemonBackend, ZvecGrepIndexDropResult, ZvecGrepIndexResult, ZvecGrepIndexStatusResult, ZvecGrepRgResult, ZvecGrepSearchResult, ZvecGrepServerStatusResult } from "../mcp/tools.js";
6
+ import type { ZvecGrepIndexRequest, ZvecGrepIndexDropInput, ZvecGrepIndexStatusInput, ZvecGrepRgInput } from "../mcp/schemas.js";
7
+ import { JobScheduler, type JobSchedulerOptions } from "./job-scheduler.js";
8
+ import { EmbeddingModelPool, type EmbeddingModelPoolOptions } from "./model-pool.js";
9
+ import { inspectRoot, RuntimeManager } from "./runtime-manager.js";
10
+ import { WatchManager, type WatchManagerOptions } from "./watch-manager.js";
11
+ import { type DaemonLogger } from "./logger.js";
12
+ import { RemoteEmbeddingAuthorizationStore, type RemoteEmbeddingAuthorizationPlan, type RemoteEmbeddingAuthorizationScope, type RemoteEmbeddingOperationPermit } from "../authorization/index.js";
13
+ export type DaemonBackendOptions = {
14
+ version: string;
15
+ serviceOptions?: CreateZvecGrepOptions;
16
+ modelPoolOptions?: EmbeddingModelPoolOptions;
17
+ schedulerOptions?: JobSchedulerOptions;
18
+ readSessionIdleTtlMs?: number;
19
+ runtimeIdleTtlMs?: number;
20
+ createService?: typeof createZvecGrep;
21
+ watchManagerFactory?: (options: WatchManagerOptions) => WatchManager;
22
+ logger?: DaemonLogger;
23
+ authorizationStore?: RemoteEmbeddingAuthorizationStore;
24
+ inspectRoot?: typeof inspectRoot;
25
+ };
26
+ export declare class DaemonBackend implements ZvecGrepDaemonBackend {
27
+ private readonly options;
28
+ readonly modelPool: EmbeddingModelPool;
29
+ readonly runtimeManager: RuntimeManager;
30
+ readonly scheduler: JobScheduler;
31
+ private readonly startedAt;
32
+ private readonly statusCache;
33
+ private readonly lastScanDiagnostics;
34
+ private readonly workspaceRuntimeCache;
35
+ private readonly watchers;
36
+ private readonly indexCoordinators;
37
+ private readonly droppingRoots;
38
+ private readonly authorizationManager;
39
+ private shuttingDown;
40
+ private closePromise?;
41
+ constructor(options: DaemonBackendOptions);
42
+ planIndexAuthorization(input: ZvecGrepIndexRequest): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
43
+ planSearchAuthorization(input: NormalizedSearchInput): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
44
+ existingRemoteEmbeddingPermit(plan: RemoteEmbeddingAuthorizationPlan): Promise<RemoteEmbeddingOperationPermit | undefined>;
45
+ grantRemoteEmbedding(plan: RemoteEmbeddingAuthorizationPlan, scope: RemoteEmbeddingAuthorizationScope): Promise<RemoteEmbeddingOperationPermit>;
46
+ index(input: ZvecGrepIndexRequest, options?: {
47
+ authorization?: RemoteEmbeddingOperationPermit;
48
+ onProgress?: (progress: IndexProgress) => void;
49
+ }): Promise<ZvecGrepIndexResult>;
50
+ dropIndex(input: ZvecGrepIndexDropInput): Promise<ZvecGrepIndexDropResult>;
51
+ search(input: NormalizedSearchInput, options?: {
52
+ authorization?: RemoteEmbeddingOperationPermit;
53
+ }): Promise<ZvecGrepSearchResult>;
54
+ private currentIndexCompletion;
55
+ indexStatus(input: ZvecGrepIndexStatusInput): Promise<ZvecGrepIndexStatusResult>;
56
+ serverStatus(): Promise<ZvecGrepServerStatusResult>;
57
+ rg(input: ZvecGrepRgInput): Promise<ZvecGrepRgResult>;
58
+ close(): Promise<void>;
59
+ private runIndex;
60
+ private runIndexOperation;
61
+ private submitIndex;
62
+ private ensureWatcher;
63
+ private settleKnownChanges;
64
+ private automaticIndexAuthorization;
65
+ private waitForFresh;
66
+ private loadEmbeddingModelInfo;
67
+ private probeCurrentFreshness;
68
+ private closeWatcher;
69
+ private assertRootNotDropping;
70
+ private indexModel;
71
+ private indexModelLoadRequest;
72
+ private searchModelLoadRequest;
73
+ private resolveModelRuntime;
74
+ private overrideActiveModelLoadRequest;
75
+ private readWorkspaceEmbeddingRuntime;
76
+ private inspectRootWithCache;
77
+ private inspectRoot;
78
+ }