@zvec/zvec-grep 0.2.2 → 0.3.0-rc.1

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 (415) hide show
  1. package/README.md +87 -252
  2. package/bin/zg.exe +3 -0
  3. package/install.cjs +510 -0
  4. package/package.json +22 -72
  5. package/platforms.json +92 -0
  6. package/plugins.cjs +183 -0
  7. package/README_CN.md +0 -239
  8. package/dist/authorization/index.d.ts +0 -7
  9. package/dist/authorization/index.js +0 -7
  10. package/dist/authorization/index.js.map +0 -1
  11. package/dist/authorization/manager.d.ts +0 -8
  12. package/dist/authorization/manager.js +0 -19
  13. package/dist/authorization/manager.js.map +0 -1
  14. package/dist/authorization/operation.d.ts +0 -7
  15. package/dist/authorization/operation.js +0 -50
  16. package/dist/authorization/operation.js.map +0 -1
  17. package/dist/authorization/planner.d.ts +0 -21
  18. package/dist/authorization/planner.js +0 -97
  19. package/dist/authorization/planner.js.map +0 -1
  20. package/dist/authorization/prompt.d.ts +0 -12
  21. package/dist/authorization/prompt.js +0 -63
  22. package/dist/authorization/prompt.js.map +0 -1
  23. package/dist/authorization/store.d.ts +0 -20
  24. package/dist/authorization/store.js +0 -251
  25. package/dist/authorization/store.js.map +0 -1
  26. package/dist/authorization/target.d.ts +0 -15
  27. package/dist/authorization/target.js +0 -49
  28. package/dist/authorization/target.js.map +0 -1
  29. package/dist/authorization/types.d.ts +0 -61
  30. package/dist/authorization/types.js +0 -2
  31. package/dist/authorization/types.js.map +0 -1
  32. package/dist/cli/args.d.ts +0 -5
  33. package/dist/cli/args.js +0 -1210
  34. package/dist/cli/args.js.map +0 -1
  35. package/dist/cli/auth.d.ts +0 -21
  36. package/dist/cli/auth.js +0 -209
  37. package/dist/cli/auth.js.map +0 -1
  38. package/dist/cli/commands.d.ts +0 -4
  39. package/dist/cli/commands.js +0 -742
  40. package/dist/cli/commands.js.map +0 -1
  41. package/dist/cli/errors.d.ts +0 -9
  42. package/dist/cli/errors.js +0 -131
  43. package/dist/cli/errors.js.map +0 -1
  44. package/dist/cli/format/context.d.ts +0 -9
  45. package/dist/cli/format/context.js +0 -786
  46. package/dist/cli/format/context.js.map +0 -1
  47. package/dist/cli/format/debug.d.ts +0 -4
  48. package/dist/cli/format/debug.js +0 -60
  49. package/dist/cli/format/debug.js.map +0 -1
  50. package/dist/cli/format/highlight.d.ts +0 -3
  51. package/dist/cli/format/highlight.js +0 -106
  52. package/dist/cli/format/highlight.js.map +0 -1
  53. package/dist/cli/format/progress.d.ts +0 -13
  54. package/dist/cli/format/progress.js +0 -290
  55. package/dist/cli/format/progress.js.map +0 -1
  56. package/dist/cli/format/range.d.ts +0 -3
  57. package/dist/cli/format/range.js +0 -24
  58. package/dist/cli/format/range.js.map +0 -1
  59. package/dist/cli/format/status.d.ts +0 -83
  60. package/dist/cli/format/status.js +0 -530
  61. package/dist/cli/format/status.js.map +0 -1
  62. package/dist/cli/help.d.ts +0 -1
  63. package/dist/cli/help.js +0 -528
  64. package/dist/cli/help.js.map +0 -1
  65. package/dist/cli/index.d.ts +0 -2
  66. package/dist/cli/index.js +0 -34
  67. package/dist/cli/index.js.map +0 -1
  68. package/dist/cli/install.d.ts +0 -4
  69. package/dist/cli/install.js +0 -1661
  70. package/dist/cli/install.js.map +0 -1
  71. package/dist/cli/managed-rg.d.ts +0 -10
  72. package/dist/cli/managed-rg.js +0 -337
  73. package/dist/cli/managed-rg.js.map +0 -1
  74. package/dist/cli/server-search.d.ts +0 -3
  75. package/dist/cli/server-search.js +0 -12
  76. package/dist/cli/server-search.js.map +0 -1
  77. package/dist/cli/types.d.ts +0 -87
  78. package/dist/cli/types.js +0 -10
  79. package/dist/cli/types.js.map +0 -1
  80. package/dist/cli/version.d.ts +0 -1
  81. package/dist/cli/version.js +0 -13
  82. package/dist/cli/version.js.map +0 -1
  83. package/dist/client/daemon-client.d.ts +0 -31
  84. package/dist/client/daemon-client.js +0 -203
  85. package/dist/client/daemon-client.js.map +0 -1
  86. package/dist/client/mode-router.d.ts +0 -9
  87. package/dist/client/mode-router.js +0 -28
  88. package/dist/client/mode-router.js.map +0 -1
  89. package/dist/client/search-policy.d.ts +0 -11
  90. package/dist/client/search-policy.js +0 -15
  91. package/dist/client/search-policy.js.map +0 -1
  92. package/dist/daemon/backend.d.ts +0 -78
  93. package/dist/daemon/backend.js +0 -1089
  94. package/dist/daemon/backend.js.map +0 -1
  95. package/dist/daemon/change-set.d.ts +0 -30
  96. package/dist/daemon/change-set.js +0 -163
  97. package/dist/daemon/change-set.js.map +0 -1
  98. package/dist/daemon/config.d.ts +0 -27
  99. package/dist/daemon/config.js +0 -107
  100. package/dist/daemon/config.js.map +0 -1
  101. package/dist/daemon/errors.d.ts +0 -5
  102. package/dist/daemon/errors.js +0 -11
  103. package/dist/daemon/errors.js.map +0 -1
  104. package/dist/daemon/http-server.d.ts +0 -30
  105. package/dist/daemon/http-server.js +0 -288
  106. package/dist/daemon/http-server.js.map +0 -1
  107. package/dist/daemon/index-coordinator.d.ts +0 -22
  108. package/dist/daemon/index-coordinator.js +0 -55
  109. package/dist/daemon/index-coordinator.js.map +0 -1
  110. package/dist/daemon/job-scheduler.d.ts +0 -73
  111. package/dist/daemon/job-scheduler.js +0 -434
  112. package/dist/daemon/job-scheduler.js.map +0 -1
  113. package/dist/daemon/logger.d.ts +0 -9
  114. package/dist/daemon/logger.js +0 -53
  115. package/dist/daemon/logger.js.map +0 -1
  116. package/dist/daemon/model-pool.d.ts +0 -45
  117. package/dist/daemon/model-pool.js +0 -187
  118. package/dist/daemon/model-pool.js.map +0 -1
  119. package/dist/daemon/root-lease.d.ts +0 -14
  120. package/dist/daemon/root-lease.js +0 -197
  121. package/dist/daemon/root-lease.js.map +0 -1
  122. package/dist/daemon/root-runtime.d.ts +0 -80
  123. package/dist/daemon/root-runtime.js +0 -340
  124. package/dist/daemon/root-runtime.js.map +0 -1
  125. package/dist/daemon/runtime-manager.d.ts +0 -47
  126. package/dist/daemon/runtime-manager.js +0 -252
  127. package/dist/daemon/runtime-manager.js.map +0 -1
  128. package/dist/daemon/runtime.d.ts +0 -12
  129. package/dist/daemon/runtime.js +0 -104
  130. package/dist/daemon/runtime.js.map +0 -1
  131. package/dist/daemon/server-controller.d.ts +0 -38
  132. package/dist/daemon/server-controller.js +0 -327
  133. package/dist/daemon/server-controller.js.map +0 -1
  134. package/dist/daemon/watch-manager.d.ts +0 -55
  135. package/dist/daemon/watch-manager.js +0 -347
  136. package/dist/daemon/watch-manager.js.map +0 -1
  137. package/dist/daemon/workspace-read-session-cache.d.ts +0 -31
  138. package/dist/daemon/workspace-read-session-cache.js +0 -115
  139. package/dist/daemon/workspace-read-session-cache.js.map +0 -1
  140. package/dist/engine/code-formats.d.ts +0 -3
  141. package/dist/engine/code-formats.js +0 -14
  142. package/dist/engine/code-formats.js.map +0 -1
  143. package/dist/engine/config.d.ts +0 -50
  144. package/dist/engine/config.js +0 -321
  145. package/dist/engine/config.js.map +0 -1
  146. package/dist/engine/errors.d.ts +0 -20
  147. package/dist/engine/errors.js +0 -51
  148. package/dist/engine/errors.js.map +0 -1
  149. package/dist/engine/extraction/code/adapter.d.ts +0 -19
  150. package/dist/engine/extraction/code/adapter.js +0 -24
  151. package/dist/engine/extraction/code/adapter.js.map +0 -1
  152. package/dist/engine/extraction/code/extractor.d.ts +0 -13
  153. package/dist/engine/extraction/code/extractor.js +0 -696
  154. package/dist/engine/extraction/code/extractor.js.map +0 -1
  155. package/dist/engine/extraction/code/families/c-family.d.ts +0 -2
  156. package/dist/engine/extraction/code/families/c-family.js +0 -122
  157. package/dist/engine/extraction/code/families/c-family.js.map +0 -1
  158. package/dist/engine/extraction/code/families/js-ts.d.ts +0 -12
  159. package/dist/engine/extraction/code/families/js-ts.js +0 -118
  160. package/dist/engine/extraction/code/families/js-ts.js.map +0 -1
  161. package/dist/engine/extraction/code/families/metadata.d.ts +0 -8
  162. package/dist/engine/extraction/code/families/metadata.js +0 -86
  163. package/dist/engine/extraction/code/families/metadata.js.map +0 -1
  164. package/dist/engine/extraction/code/families/name-field.d.ts +0 -3
  165. package/dist/engine/extraction/code/families/name-field.js +0 -22
  166. package/dist/engine/extraction/code/families/name-field.js.map +0 -1
  167. package/dist/engine/extraction/code/languages/c.d.ts +0 -1
  168. package/dist/engine/extraction/code/languages/c.js +0 -12
  169. package/dist/engine/extraction/code/languages/c.js.map +0 -1
  170. package/dist/engine/extraction/code/languages/cpp.d.ts +0 -1
  171. package/dist/engine/extraction/code/languages/cpp.js +0 -18
  172. package/dist/engine/extraction/code/languages/cpp.js.map +0 -1
  173. package/dist/engine/extraction/code/languages/go.d.ts +0 -2
  174. package/dist/engine/extraction/code/languages/go.js +0 -70
  175. package/dist/engine/extraction/code/languages/go.js.map +0 -1
  176. package/dist/engine/extraction/code/languages/java.d.ts +0 -1
  177. package/dist/engine/extraction/code/languages/java.js +0 -17
  178. package/dist/engine/extraction/code/languages/java.js.map +0 -1
  179. package/dist/engine/extraction/code/languages/javascript.d.ts +0 -2
  180. package/dist/engine/extraction/code/languages/javascript.js +0 -23
  181. package/dist/engine/extraction/code/languages/javascript.js.map +0 -1
  182. package/dist/engine/extraction/code/languages/python.d.ts +0 -2
  183. package/dist/engine/extraction/code/languages/python.js +0 -52
  184. package/dist/engine/extraction/code/languages/python.js.map +0 -1
  185. package/dist/engine/extraction/code/languages/rust.d.ts +0 -2
  186. package/dist/engine/extraction/code/languages/rust.js +0 -25
  187. package/dist/engine/extraction/code/languages/rust.js.map +0 -1
  188. package/dist/engine/extraction/code/languages/typescript.d.ts +0 -2
  189. package/dist/engine/extraction/code/languages/typescript.js +0 -37
  190. package/dist/engine/extraction/code/languages/typescript.js.map +0 -1
  191. package/dist/engine/extraction/code/tree-sitter/grammar.d.ts +0 -4
  192. package/dist/engine/extraction/code/tree-sitter/grammar.js +0 -49
  193. package/dist/engine/extraction/code/tree-sitter/grammar.js.map +0 -1
  194. package/dist/engine/extraction/code/tree-sitter/nodes.d.ts +0 -3
  195. package/dist/engine/extraction/code/tree-sitter/nodes.js +0 -27
  196. package/dist/engine/extraction/code/tree-sitter/nodes.js.map +0 -1
  197. package/dist/engine/extraction/code/tree-sitter/parser.d.ts +0 -2
  198. package/dist/engine/extraction/code/tree-sitter/parser.js +0 -31
  199. package/dist/engine/extraction/code/tree-sitter/parser.js.map +0 -1
  200. package/dist/engine/extraction/ids.d.ts +0 -1
  201. package/dist/engine/extraction/ids.js +0 -5
  202. package/dist/engine/extraction/ids.js.map +0 -1
  203. package/dist/engine/extraction/image/extractor.d.ts +0 -5
  204. package/dist/engine/extraction/image/extractor.js +0 -35
  205. package/dist/engine/extraction/image/extractor.js.map +0 -1
  206. package/dist/engine/extraction/index.d.ts +0 -4
  207. package/dist/engine/extraction/index.js +0 -3
  208. package/dist/engine/extraction/index.js.map +0 -1
  209. package/dist/engine/extraction/markdown/extractor.d.ts +0 -7
  210. package/dist/engine/extraction/markdown/extractor.js +0 -362
  211. package/dist/engine/extraction/markdown/extractor.js.map +0 -1
  212. package/dist/engine/extraction/runtime.d.ts +0 -9
  213. package/dist/engine/extraction/runtime.js +0 -37
  214. package/dist/engine/extraction/runtime.js.map +0 -1
  215. package/dist/engine/extraction/source.d.ts +0 -18
  216. package/dist/engine/extraction/source.js +0 -22
  217. package/dist/engine/extraction/source.js.map +0 -1
  218. package/dist/engine/extraction/text/extractor.d.ts +0 -7
  219. package/dist/engine/extraction/text/extractor.js +0 -168
  220. package/dist/engine/extraction/text/extractor.js.map +0 -1
  221. package/dist/engine/extraction/types.d.ts +0 -4
  222. package/dist/engine/extraction/types.js +0 -2
  223. package/dist/engine/extraction/types.js.map +0 -1
  224. package/dist/engine/extraction/vector-content.d.ts +0 -5
  225. package/dist/engine/extraction/vector-content.js +0 -83
  226. package/dist/engine/extraction/vector-content.js.map +0 -1
  227. package/dist/engine/file-size-policy.d.ts +0 -6
  228. package/dist/engine/file-size-policy.js +0 -20
  229. package/dist/engine/file-size-policy.js.map +0 -1
  230. package/dist/engine/file-type.d.ts +0 -15
  231. package/dist/engine/file-type.js +0 -152
  232. package/dist/engine/file-type.js.map +0 -1
  233. package/dist/engine/index-status.d.ts +0 -9
  234. package/dist/engine/index-status.js +0 -38
  235. package/dist/engine/index-status.js.map +0 -1
  236. package/dist/engine/manifest.d.ts +0 -13
  237. package/dist/engine/manifest.js +0 -124
  238. package/dist/engine/manifest.js.map +0 -1
  239. package/dist/engine/models/artifact-cache-lock.d.ts +0 -16
  240. package/dist/engine/models/artifact-cache-lock.js +0 -228
  241. package/dist/engine/models/artifact-cache-lock.js.map +0 -1
  242. package/dist/engine/models/artifact-downloader.d.ts +0 -77
  243. package/dist/engine/models/artifact-downloader.js +0 -766
  244. package/dist/engine/models/artifact-downloader.js.map +0 -1
  245. package/dist/engine/models/backends/llama-cpp.d.ts +0 -99
  246. package/dist/engine/models/backends/llama-cpp.js +0 -573
  247. package/dist/engine/models/backends/llama-cpp.js.map +0 -1
  248. package/dist/engine/models/backends/model2vec-runtime.d.ts +0 -63
  249. package/dist/engine/models/backends/model2vec-runtime.js +0 -112
  250. package/dist/engine/models/backends/model2vec-runtime.js.map +0 -1
  251. package/dist/engine/models/backends/model2vec-tokenizer.d.ts +0 -2
  252. package/dist/engine/models/backends/model2vec-tokenizer.js +0 -42
  253. package/dist/engine/models/backends/model2vec-tokenizer.js.map +0 -1
  254. package/dist/engine/models/backends/model2vec-worker-pool.d.ts +0 -25
  255. package/dist/engine/models/backends/model2vec-worker-pool.js +0 -264
  256. package/dist/engine/models/backends/model2vec-worker-pool.js.map +0 -1
  257. package/dist/engine/models/backends/model2vec-worker.d.ts +0 -1
  258. package/dist/engine/models/backends/model2vec-worker.js +0 -41
  259. package/dist/engine/models/backends/model2vec-worker.js.map +0 -1
  260. package/dist/engine/models/backends/model2vec.d.ts +0 -38
  261. package/dist/engine/models/backends/model2vec.js +0 -344
  262. package/dist/engine/models/backends/model2vec.js.map +0 -1
  263. package/dist/engine/models/backends/qwen.d.ts +0 -44
  264. package/dist/engine/models/backends/qwen.js +0 -411
  265. package/dist/engine/models/backends/qwen.js.map +0 -1
  266. package/dist/engine/models/backends/transformers-js.d.ts +0 -87
  267. package/dist/engine/models/backends/transformers-js.js +0 -360
  268. package/dist/engine/models/backends/transformers-js.js.map +0 -1
  269. package/dist/engine/models/catalog.d.ts +0 -490
  270. package/dist/engine/models/catalog.js +0 -522
  271. package/dist/engine/models/catalog.js.map +0 -1
  272. package/dist/engine/models/download-progress.d.ts +0 -16
  273. package/dist/engine/models/download-progress.js +0 -47
  274. package/dist/engine/models/download-progress.js.map +0 -1
  275. package/dist/engine/models/embeddings.d.ts +0 -69
  276. package/dist/engine/models/embeddings.js +0 -125
  277. package/dist/engine/models/embeddings.js.map +0 -1
  278. package/dist/engine/models/factory.d.ts +0 -2
  279. package/dist/engine/models/factory.js +0 -51
  280. package/dist/engine/models/factory.js.map +0 -1
  281. package/dist/engine/models/index.d.ts +0 -4
  282. package/dist/engine/models/index.js +0 -5
  283. package/dist/engine/models/index.js.map +0 -1
  284. package/dist/engine/models/ranking.d.ts +0 -19
  285. package/dist/engine/models/ranking.js +0 -2
  286. package/dist/engine/models/ranking.js.map +0 -1
  287. package/dist/engine/models/resolution.d.ts +0 -8
  288. package/dist/engine/models/resolution.js +0 -22
  289. package/dist/engine/models/resolution.js.map +0 -1
  290. package/dist/engine/pipeline/indexing/index.d.ts +0 -14
  291. package/dist/engine/pipeline/indexing/index.js +0 -1217
  292. package/dist/engine/pipeline/indexing/index.js.map +0 -1
  293. package/dist/engine/pipeline/indexing/input-budget.d.ts +0 -2
  294. package/dist/engine/pipeline/indexing/input-budget.js +0 -51
  295. package/dist/engine/pipeline/indexing/input-budget.js.map +0 -1
  296. package/dist/engine/pipeline/indexing/root-paths.d.ts +0 -7
  297. package/dist/engine/pipeline/indexing/root-paths.js +0 -148
  298. package/dist/engine/pipeline/indexing/root-paths.js.map +0 -1
  299. package/dist/engine/pipeline/indexing/scanner/index.d.ts +0 -14
  300. package/dist/engine/pipeline/indexing/scanner/index.js +0 -776
  301. package/dist/engine/pipeline/indexing/scanner/index.js.map +0 -1
  302. package/dist/engine/pipeline/search/index.d.ts +0 -12
  303. package/dist/engine/pipeline/search/index.js +0 -811
  304. package/dist/engine/pipeline/search/index.js.map +0 -1
  305. package/dist/engine/service/index.d.ts +0 -3
  306. package/dist/engine/service/index.js +0 -2
  307. package/dist/engine/service/index.js.map +0 -1
  308. package/dist/engine/service/lexical.d.ts +0 -28
  309. package/dist/engine/service/lexical.js +0 -446
  310. package/dist/engine/service/lexical.js.map +0 -1
  311. package/dist/engine/service/root.d.ts +0 -15
  312. package/dist/engine/service/root.js +0 -57
  313. package/dist/engine/service/root.js.map +0 -1
  314. package/dist/engine/service/structure-enrichment.d.ts +0 -8
  315. package/dist/engine/service/structure-enrichment.js +0 -178
  316. package/dist/engine/service/structure-enrichment.js.map +0 -1
  317. package/dist/engine/service/types.d.ts +0 -210
  318. package/dist/engine/service/types.js +0 -2
  319. package/dist/engine/service/types.js.map +0 -1
  320. package/dist/engine/service/workspace-index.d.ts +0 -26
  321. package/dist/engine/service/workspace-index.js +0 -157
  322. package/dist/engine/service/workspace-index.js.map +0 -1
  323. package/dist/engine/service/zvec-grep.d.ts +0 -13
  324. package/dist/engine/service/zvec-grep.js +0 -1393
  325. package/dist/engine/service/zvec-grep.js.map +0 -1
  326. package/dist/engine/storage/index.d.ts +0 -53
  327. package/dist/engine/storage/index.js +0 -3
  328. package/dist/engine/storage/index.js.map +0 -1
  329. package/dist/engine/storage/layout.d.ts +0 -10
  330. package/dist/engine/storage/layout.js +0 -29
  331. package/dist/engine/storage/layout.js.map +0 -1
  332. package/dist/engine/storage/zvec.d.ts +0 -4
  333. package/dist/engine/storage/zvec.js +0 -976
  334. package/dist/engine/storage/zvec.js.map +0 -1
  335. package/dist/engine/types.d.ts +0 -303
  336. package/dist/engine/types.js +0 -14
  337. package/dist/engine/types.js.map +0 -1
  338. package/dist/engine/utils/atomic-file.d.ts +0 -3
  339. package/dist/engine/utils/atomic-file.js +0 -39
  340. package/dist/engine/utils/atomic-file.js.map +0 -1
  341. package/dist/engine/utils/daemon-lease.d.ts +0 -17
  342. package/dist/engine/utils/daemon-lease.js +0 -175
  343. package/dist/engine/utils/daemon-lease.js.map +0 -1
  344. package/dist/engine/utils/file-selection.d.ts +0 -10
  345. package/dist/engine/utils/file-selection.js +0 -157
  346. package/dist/engine/utils/file-selection.js.map +0 -1
  347. package/dist/engine/utils/glob.d.ts +0 -9
  348. package/dist/engine/utils/glob.js +0 -208
  349. package/dist/engine/utils/glob.js.map +0 -1
  350. package/dist/engine/utils/hash.d.ts +0 -2
  351. package/dist/engine/utils/hash.js +0 -8
  352. package/dist/engine/utils/hash.js.map +0 -1
  353. package/dist/engine/utils/json.d.ts +0 -8
  354. package/dist/engine/utils/json.js +0 -83
  355. package/dist/engine/utils/json.js.map +0 -1
  356. package/dist/engine/utils/lock.d.ts +0 -19
  357. package/dist/engine/utils/lock.js +0 -254
  358. package/dist/engine/utils/lock.js.map +0 -1
  359. package/dist/engine/utils/path.d.ts +0 -4
  360. package/dist/engine/utils/path.js +0 -18
  361. package/dist/engine/utils/path.js.map +0 -1
  362. package/dist/engine/utils/timing.d.ts +0 -19
  363. package/dist/engine/utils/timing.js +0 -87
  364. package/dist/engine/utils/timing.js.map +0 -1
  365. package/dist/index-progress.d.ts +0 -10
  366. package/dist/index-progress.js +0 -159
  367. package/dist/index-progress.js.map +0 -1
  368. package/dist/index.d.ts +0 -6
  369. package/dist/index.js +0 -4
  370. package/dist/index.js.map +0 -1
  371. package/dist/mcp/http-transport.d.ts +0 -27
  372. package/dist/mcp/http-transport.js +0 -182
  373. package/dist/mcp/http-transport.js.map +0 -1
  374. package/dist/mcp/input-normalization.d.ts +0 -38
  375. package/dist/mcp/input-normalization.js +0 -104
  376. package/dist/mcp/input-normalization.js.map +0 -1
  377. package/dist/mcp/progress-heartbeat.d.ts +0 -17
  378. package/dist/mcp/progress-heartbeat.js +0 -46
  379. package/dist/mcp/progress-heartbeat.js.map +0 -1
  380. package/dist/mcp/request-metadata.d.ts +0 -2
  381. package/dist/mcp/request-metadata.js +0 -11
  382. package/dist/mcp/request-metadata.js.map +0 -1
  383. package/dist/mcp/request-state.d.ts +0 -40
  384. package/dist/mcp/request-state.js +0 -210
  385. package/dist/mcp/request-state.js.map +0 -1
  386. package/dist/mcp/result-format.d.ts +0 -13
  387. package/dist/mcp/result-format.js +0 -75
  388. package/dist/mcp/result-format.js.map +0 -1
  389. package/dist/mcp/schemas.d.ts +0 -668
  390. package/dist/mcp/schemas.js +0 -512
  391. package/dist/mcp/schemas.js.map +0 -1
  392. package/dist/mcp/stdio-bridge.d.ts +0 -15
  393. package/dist/mcp/stdio-bridge.js +0 -190
  394. package/dist/mcp/stdio-bridge.js.map +0 -1
  395. package/dist/mcp/tools.d.ts +0 -153
  396. package/dist/mcp/tools.js +0 -488
  397. package/dist/mcp/tools.js.map +0 -1
  398. package/dist/mcp/toolset.d.ts +0 -5
  399. package/dist/mcp/toolset.js +0 -12
  400. package/dist/mcp/toolset.js.map +0 -1
  401. package/dist/observability/trace-context.d.ts +0 -11
  402. package/dist/observability/trace-context.js +0 -138
  403. package/dist/observability/trace-context.js.map +0 -1
  404. package/dist/prompts/zvec-grep-guidance.d.ts +0 -2
  405. package/dist/prompts/zvec-grep-guidance.js +0 -9
  406. package/dist/prompts/zvec-grep-guidance.js.map +0 -1
  407. package/docs/01-agents.md +0 -209
  408. package/docs/02-cli.md +0 -247
  409. package/docs/03-mcp.md +0 -185
  410. package/docs/04-pipeline.md +0 -226
  411. package/docs/05-architecture.md +0 -86
  412. package/docs/06-server.md +0 -233
  413. package/docs/07-embedding.md +0 -209
  414. package/docs/08-roadmap.md +0 -85
  415. package/docs/README.md +0 -53
@@ -1,742 +0,0 @@
1
- import { resolve } from "node:path";
2
- import { createInterface } from "node:readline/promises";
3
- import { createZvecGrep, } from "../index.js";
4
- import { globalConfigPath, updateGlobalConfig } from "../engine/config.js";
5
- import { ENGINE_ERROR_CODE_PREFIX, EngineError, } from "../engine/errors.js";
6
- import { listEmbeddingModels } from "../engine/models/index.js";
7
- import { DaemonClient } from "../client/daemon-client.js";
8
- import { resolveDirectSearchPolicy, resolveServerSearchPolicy, } from "../client/search-policy.js";
9
- import { resolveClientMode, resolveServerUrl, routeByMode, } from "../client/mode-router.js";
10
- import { serverStatus } from "../daemon/server-controller.js";
11
- import { findNearestWorkspace } from "../engine/service/root.js";
12
- import { contextWarningLines, printCliContextResult, } from "./format/context.js";
13
- import { printDebug } from "./format/debug.js";
14
- import { createIndexProgressReporter } from "./format/progress.js";
15
- import { formatContextLines } from "./errors.js";
16
- import { printWorkspaceInfo, printIndexPathFilterTip, printIndexResult, printIndexScanDiagnostics, printNoIndexableFilesTip, printServerIndexInfo, } from "./format/status.js";
17
- import { planRemoteIndexAuthorization, planRemoteSearchAuthorization, } from "../authorization/index.js";
18
- import { indexCompletionFromStatus, indexStatusNeedsRefresh, } from "../engine/index-status.js";
19
- import { indexProgressFromMessage } from "../index-progress.js";
20
- import { normalizeManagedRgInput } from "./managed-rg.js";
21
- import { INCOMPATIBLE_SERVER_SEARCH_MESSAGE, parseServerSearchResponse, } from "./server-search.js";
22
- import { runInstall, runUninstall } from "./install.js";
23
- import { runAuth, authorizationStore, authorizeCliPlan, resolveAuthorizationSchema, embeddingModelInfo, configuredEmbeddingReference, workspaceRuntimeFromInfo, assertEmbeddingModelCompatible, assertRequestedEndpointCompatible, requireEmbeddingModelCatalogEntry, unsupportedRemoteEmbeddingProvider, withRemoteEmbeddingOperationPermit, } from "./auth.js";
24
- export async function runParsedCommand(parsed) {
25
- switch (parsed.command) {
26
- case "query":
27
- await runQuery(parsed);
28
- return;
29
- case "index":
30
- await runIndex(parsed);
31
- return;
32
- case "status":
33
- await runStatus(parsed);
34
- return;
35
- case "install":
36
- await runInstall(parsed);
37
- return;
38
- case "uninstall":
39
- await runUninstall(parsed);
40
- return;
41
- case "config":
42
- await runConfig(parsed);
43
- return;
44
- case "auth":
45
- await runAuth(parsed);
46
- return;
47
- case "server":
48
- await runServer(parsed);
49
- return;
50
- case "help":
51
- case "version":
52
- throw new Error(`${parsed.command} must be handled before dispatch`);
53
- }
54
- }
55
- async function runConfig(parsed) {
56
- if (parsed.positionals.length !== 1) {
57
- throw new Error(`zg config ${parsed.options.configAction === "provider-set" ? "provider" : "model"} set requires exactly one reference`);
58
- }
59
- const reference = parsed.positionals[0];
60
- if (parsed.options.configAction === "provider-set") {
61
- if (!/^[a-z][a-z0-9_-]*$/.test(reference)) {
62
- throw unsupportedRemoteEmbeddingProvider(reference, "Invalid embedding provider");
63
- }
64
- if (reference === "local" ||
65
- !listEmbeddingModels().some((entry) => entry.provider === reference)) {
66
- throw unsupportedRemoteEmbeddingProvider(reference);
67
- }
68
- if (parsed.options.apiKey === undefined) {
69
- throw new Error("zg config provider set requires --api-key");
70
- }
71
- updateGlobalConfig({
72
- providers: {
73
- [reference]: {
74
- apiKey: parsed.options.apiKey,
75
- },
76
- },
77
- });
78
- console.log(`Provider config: ${reference}`);
79
- console.log(`Global config: ${globalConfigPath()}`);
80
- return;
81
- }
82
- if (parsed.options.configAction !== "model-set") {
83
- throw new Error("zg config requires provider set or model set");
84
- }
85
- const catalogEntry = requireEmbeddingModelCatalogEntry(reference);
86
- if (parsed.options.endpoint === undefined &&
87
- parsed.options.device === undefined &&
88
- !parsed.options.defaultModel) {
89
- throw new Error("zg config model set requires --endpoint, --device, or --default");
90
- }
91
- if (catalogEntry.provider === "local" &&
92
- parsed.options.endpoint !== undefined) {
93
- throw new Error("--endpoint is only supported for remote embedding models");
94
- }
95
- if (catalogEntry.provider !== "local" &&
96
- parsed.options.device !== undefined) {
97
- throw new Error("--device is only supported for local embedding models");
98
- }
99
- if (parsed.options.endpoint !== undefined) {
100
- assertHttpEndpoint(parsed.options.endpoint);
101
- }
102
- updateGlobalConfig({
103
- ...(parsed.options.endpoint !== undefined ||
104
- parsed.options.device !== undefined
105
- ? {
106
- models: {
107
- [reference]: {
108
- ...(parsed.options.endpoint !== undefined
109
- ? { endpoint: parsed.options.endpoint }
110
- : {}),
111
- ...(parsed.options.device !== undefined
112
- ? { device: parsed.options.device }
113
- : {}),
114
- },
115
- },
116
- }
117
- : {}),
118
- ...(parsed.options.defaultModel
119
- ? { defaults: { embedding: reference } }
120
- : {}),
121
- });
122
- console.log(`Model config: ${reference}`);
123
- console.log(`Global config: ${globalConfigPath()}`);
124
- }
125
- function assertHttpEndpoint(endpoint) {
126
- let parsed;
127
- try {
128
- parsed = new URL(endpoint);
129
- }
130
- catch {
131
- throw new Error("--endpoint must be a valid HTTP(S) URL");
132
- }
133
- if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
134
- throw new Error("--endpoint must be a valid HTTP(S) URL");
135
- }
136
- }
137
- async function runIndex(parsed) {
138
- const explicitRoot = parsed.positionals.length > 0;
139
- const root = resolveIndexRoot(parsed.positionals[0]);
140
- const rootPath = indexRootPath(root, parsed.options);
141
- if (parsed.positionals.length > 1) {
142
- throw new Error("zg index accepts at most one root path");
143
- }
144
- if (parsed.options.drop) {
145
- await runDropIndex(parsed, rootPath.absolutePath);
146
- return;
147
- }
148
- if (parsed.options.embedding) {
149
- requireEmbeddingModelCatalogEntry(parsed.options.embedding);
150
- }
151
- const mode = resolveClientMode(parsed.options.mode);
152
- await routeByMode({
153
- mode,
154
- serverAvailable: () => daemonIsReady(parsed.options.home),
155
- server: async () => {
156
- const client = daemonClient(parsed.options);
157
- const progress = createIndexProgressReporter({
158
- color: parsed.options.color,
159
- });
160
- let result;
161
- try {
162
- result = await client.callTool("zvec_grep_index", {
163
- root: rootPath.absolutePath,
164
- embedding: parsed.options.embedding,
165
- apiKey: parsed.options.apiKey,
166
- endpoint: parsed.options.endpoint,
167
- device: parsed.options.device,
168
- rebuild: parsed.options.rebuild,
169
- resetPaths: parsed.options.resetPaths,
170
- globs: parsed.options.globs,
171
- insensitiveGlobs: parsed.options.insensitiveGlobs,
172
- fileTypes: parsed.options.fileTypes,
173
- excludedFileTypes: parsed.options.excludedFileTypes,
174
- hidden: parsed.options.hidden,
175
- noIgnore: parsed.options.noIgnore,
176
- ignoreFiles: parsed.options.ignoreFiles,
177
- maxDepth: parsed.options.maxDepth,
178
- maxFileSizeBytes: parsed.options.maxFileSizeBytes,
179
- follow: parsed.options.follow,
180
- embeddingConcurrency: parsed.options.embeddingConcurrency,
181
- debug: parsed.options.debug,
182
- wait: true,
183
- }, {
184
- onProgress: (event) => {
185
- const update = indexProgressFromMessage(event.message);
186
- if (update) {
187
- progress.report(update.progress);
188
- }
189
- },
190
- embeddingEnvironment: process.env.ZVEC_GREP_EMBEDDING?.trim(),
191
- });
192
- }
193
- finally {
194
- progress.finish();
195
- }
196
- console.log(`Workspace index: ${String(result.state ?? "submitted")}`);
197
- console.log(`Root: ${String(result.root ?? rootPath.absolutePath)}`);
198
- console.log(`Job: ${String(result.job_id ?? "unknown")}`);
199
- if (parsed.options.debug) {
200
- printIndexScanDiagnostics(result.scan_diagnostics);
201
- }
202
- if (result.state === "failed") {
203
- throw serverIndexFailure(result);
204
- }
205
- if (result.state === "succeeded") {
206
- const status = (await client
207
- .callTool("zvec_grep_index_status", {
208
- root: rootPath.absolutePath,
209
- })
210
- .catch(() => undefined));
211
- if (status?.persistent.files?.scanned === 0) {
212
- printNoIndexableFilesTip(parsed.options);
213
- }
214
- }
215
- },
216
- direct: () => runDirectIndex(parsed, rootPath, explicitRoot),
217
- });
218
- }
219
- function serverIndexFailure(result) {
220
- const error = result.error;
221
- if (error && typeof error === "object") {
222
- const fields = error;
223
- const code = nonEmptyString(fields.code);
224
- if (code?.startsWith(`${ENGINE_ERROR_CODE_PREFIX}.`)) {
225
- const message = nonEmptyString(fields.message) ?? "Index job failed unexpectedly.";
226
- return new EngineError(stripErrorCode(message, code), {
227
- code: code,
228
- context: nonEmptyString(fields.context),
229
- cause: nonEmptyString(fields.cause),
230
- });
231
- }
232
- }
233
- const cause = error && typeof error === "object" && "cause" in error
234
- ? nonEmptyString(error.cause)
235
- : undefined;
236
- return new Error(serverIndexFailureMessage(result), { cause });
237
- }
238
- function serverIndexFailureMessage(result) {
239
- const error = result.error;
240
- const context = error && typeof error === "object" && "context" in error
241
- ? error.context
242
- : undefined;
243
- const details = typeof context === "string" ? formatContextLines(context) : [];
244
- return [
245
- serverIndexFailureSummary(result),
246
- ...(details.length > 0
247
- ? ["Details:", ...details.map((line) => ` ${line}`)]
248
- : []),
249
- ].join("\n");
250
- }
251
- function serverIndexFailureSummary(result) {
252
- const error = result.error;
253
- if (error && typeof error === "object") {
254
- const code = error.code;
255
- const message = error.message;
256
- if (typeof message === "string" && message.length > 0) {
257
- if (typeof code !== "string" ||
258
- code.length === 0 ||
259
- message.includes(`[${code}]`)) {
260
- return message;
261
- }
262
- return `[${code}] ${message}`;
263
- }
264
- if (typeof code === "string" && code.length > 0) {
265
- return `[${code}] Index job failed.`;
266
- }
267
- }
268
- return `Index job ${String(result.job_id ?? "unknown")} failed. Run zg status --mode server for details.`;
269
- }
270
- function nonEmptyString(value) {
271
- return typeof value === "string" && value.trim().length > 0
272
- ? value
273
- : undefined;
274
- }
275
- function stripErrorCode(message, code) {
276
- const prefix = `[${code}]`;
277
- return message.startsWith(prefix)
278
- ? message.slice(prefix.length).trimStart()
279
- : message;
280
- }
281
- async function runDirectIndex(parsed, rootPath, explicitRoot) {
282
- const serviceOptions = createServiceOptions(parsed.options, rootPath.absolutePath);
283
- const zvecGrep = await createZvecGrep(serviceOptions);
284
- const progress = createIndexProgressReporter({ color: parsed.options.color });
285
- try {
286
- const infoBefore = await zvecGrep.info({
287
- root: rootPath.absolutePath,
288
- includeStatus: parsed.options.rebuild !== true,
289
- });
290
- const schema = resolveAuthorizationSchema(configuredEmbeddingReference(parsed.options, infoBefore.workspaceIndex?.embedding), infoBefore.workspaceIndex?.embedding);
291
- assertEmbeddingModelCompatible(infoBefore.workspaceIndex?.embedding, schema, parsed.options.rebuild === true);
292
- const workspaceRuntime = workspaceRuntimeFromInfo(infoBefore);
293
- assertRequestedEndpointCompatible(infoBefore, workspaceRuntime, parsed.options.endpoint, parsed.options.rebuild === true);
294
- const modelInfo = schema?.provider === "qwen"
295
- ? await embeddingModelInfo(schema, serviceOptions, workspaceRuntime)
296
- : undefined;
297
- const plan = modelInfo
298
- ? await planRemoteIndexAuthorization({
299
- info: infoBefore,
300
- model: modelInfo,
301
- rebuild: parsed.options.rebuild,
302
- store: authorizationStore(parsed.options),
303
- })
304
- : undefined;
305
- const authorizationResolution = plan
306
- ? await authorizeCliPlan(plan, parsed.options)
307
- : {};
308
- printIndexPathFilterTip(parsed.options);
309
- const result = await withRemoteEmbeddingOperationPermit(authorizationResolution.authorization, () => zvecGrep.index({
310
- root: rootPath.absolutePath,
311
- rootPaths: explicitRoot ? [rootPath] : undefined,
312
- rebuild: parsed.options.rebuild,
313
- resetPaths: parsed.options.resetPaths,
314
- globs: parsed.options.globs,
315
- insensitiveGlobs: parsed.options.insensitiveGlobs,
316
- fileTypes: parsed.options.fileTypes,
317
- excludedFileTypes: parsed.options.excludedFileTypes,
318
- hidden: parsed.options.hidden,
319
- noIgnore: parsed.options.noIgnore,
320
- ignoreFiles: parsed.options.ignoreFiles,
321
- maxDepth: parsed.options.maxDepth,
322
- maxFileSizeBytes: parsed.options.maxFileSizeBytes,
323
- follow: parsed.options.follow,
324
- embeddingConcurrency: parsed.options.embeddingConcurrency,
325
- onProgress: progress.report,
326
- }));
327
- progress.finish();
328
- const info = await zvecGrep.info({ root: rootPath.absolutePath });
329
- printIndexResult("Workspace index", result, parsed.options, info.workspaceIndex?.rootPaths);
330
- }
331
- catch (error) {
332
- progress.finish();
333
- throw error;
334
- }
335
- finally {
336
- await zvecGrep.close();
337
- }
338
- }
339
- async function runDropIndex(parsed, root) {
340
- if (!(await confirmIndexDrop(root, parsed.options.yes === true))) {
341
- console.log("Index drop cancelled.");
342
- return;
343
- }
344
- const printResult = (removed) => {
345
- console.log(removed ? `Dropped index for ${root}` : `No index found for ${root}`);
346
- };
347
- await routeByMode({
348
- mode: resolveClientMode(parsed.options.mode),
349
- serverAvailable: () => daemonIsReady(parsed.options.home),
350
- server: async () => {
351
- const result = await daemonClient(parsed.options).callTool("zvec_grep_index_drop", { root });
352
- printResult(result.removed === true);
353
- },
354
- direct: async () => {
355
- const zvecGrep = await createZvecGrep(createServiceOptions(parsed.options, root));
356
- try {
357
- printResult(await zvecGrep.dropIndex({ root }));
358
- }
359
- finally {
360
- await zvecGrep.close();
361
- }
362
- },
363
- });
364
- }
365
- async function confirmIndexDrop(root, accepted) {
366
- if (accepted) {
367
- return true;
368
- }
369
- if (!process.stdin.isTTY || !process.stdout.isTTY) {
370
- throw new Error("zg index --drop requires --yes in a non-interactive shell");
371
- }
372
- const readline = createInterface({
373
- input: process.stdin,
374
- output: process.stdout,
375
- });
376
- try {
377
- const answer = await readline.question(`Drop the index for ${root}? [y/N] `);
378
- return ["y", "yes"].includes(answer.trim().toLowerCase());
379
- }
380
- finally {
381
- readline.close();
382
- }
383
- }
384
- async function runServer(parsed) {
385
- if (parsed.positionals.length > 0) {
386
- throw new Error(`zg server ${parsed.options.serverStdio ? "--stdio" : parsed.options.serverAction} does not accept positional arguments`);
387
- }
388
- const { readPackageVersion } = await import("./version.js");
389
- if (parsed.options.serverStdio) {
390
- const { runStdioBootstrapBridge } = await import("../mcp/stdio-bridge.js");
391
- await runStdioBootstrapBridge({
392
- cliPath: process.argv[1],
393
- version: readPackageVersion(),
394
- home: parsed.options.home,
395
- tokenFile: parsed.options.serverTokenFile,
396
- listen: parsed.options.listen,
397
- mcpToolset: parsed.options.mcpToolset,
398
- });
399
- return;
400
- }
401
- if (parsed.options.serverAction === "on") {
402
- const { startServer } = await import("../daemon/server-controller.js");
403
- const status = await startServer({
404
- cliPath: process.argv[1],
405
- listen: parsed.options.listen,
406
- tokenFile: parsed.options.serverTokenFile,
407
- home: parsed.options.home,
408
- mcpToolset: parsed.options.mcpToolset,
409
- });
410
- printServerControlStatus(status);
411
- return;
412
- }
413
- if (parsed.options.serverAction === "off") {
414
- const { stopServer } = await import("../daemon/server-controller.js");
415
- printServerControlStatus(await stopServer(parsed.options.home, 30_000, parsed.options.serverTokenFile));
416
- return;
417
- }
418
- if (parsed.options.serverAction === "status") {
419
- const status = await serverStatus(parsed.options.home);
420
- printServerControlStatus(status);
421
- if (parsed.options.checkReady && !status.ready) {
422
- throw new Error("zvec-grep server is not ready");
423
- }
424
- return;
425
- }
426
- const { runDaemonForeground } = await import("../daemon/runtime.js");
427
- await runDaemonForeground({
428
- version: readPackageVersion(),
429
- listen: parsed.options.listen,
430
- tokenFile: parsed.options.serverTokenFile,
431
- home: parsed.options.home,
432
- mcpToolset: parsed.options.mcpToolset,
433
- serviceOptions: createServiceOptions(parsed.options, process.cwd()),
434
- });
435
- }
436
- async function runStatus(parsed) {
437
- const root = parsed.positionals[0] ?? process.cwd();
438
- if (parsed.positionals.length > 1) {
439
- throw new Error("zg status accepts at most one root path");
440
- }
441
- const mode = resolveClientMode(parsed.options.mode);
442
- const state = await routeByMode({
443
- mode,
444
- serverAvailable: () => daemonIsReady(parsed.options.home),
445
- server: async () => {
446
- const result = await daemonClient(parsed.options).callTool("zvec_grep_index_status", { root: resolve(root) });
447
- return printServerIndexInfo(result, parsed.options);
448
- },
449
- direct: async () => {
450
- const zvecGrep = await createZvecGrep(createServiceOptions(parsed.options, root));
451
- try {
452
- return printWorkspaceInfo(await zvecGrep.info({ root }), parsed.options);
453
- }
454
- finally {
455
- await zvecGrep.close();
456
- }
457
- },
458
- });
459
- if (parsed.options.checkReady && state !== "ready") {
460
- throw new Error(`Workspace index is not ready (state: ${state})`);
461
- }
462
- }
463
- async function runQuery(parsed) {
464
- const rgInput = parsed.options.rg
465
- ? normalizeManagedRgInput(parsed)
466
- : undefined;
467
- const commandOptions = rgInput?.options ?? parsed.options;
468
- const queries = (rgInput?.queries ?? [
469
- ...parsed.positionals,
470
- ...(parsed.options.hybridQueries ?? []),
471
- ])
472
- .map((query) => query.trim())
473
- .filter((query) => query.length > 0);
474
- const routes = parsed.options.routes ?? [];
475
- if (queries.length === 0 &&
476
- routes.length === 0 &&
477
- (parsed.options.rgOptions?.patternFiles?.length ?? 0) === 0) {
478
- throw new Error(parsed.options.rg
479
- ? "zg query --rg requires a pattern. Use zg help query for examples."
480
- : "zg query requires text or --hybrid/--fts/--vector routes. Use zg help query for examples.");
481
- }
482
- if (commandOptions.rg) {
483
- await runDirectRgQuery(commandOptions, queries);
484
- return;
485
- }
486
- const mode = resolveClientMode(commandOptions.mode);
487
- if (mode !== "direct") {
488
- await routeByMode({
489
- mode,
490
- serverAvailable: () => daemonIsReady(commandOptions.home),
491
- server: () => runServerQuery(commandOptions, queries, routes),
492
- direct: () => runDirectQuery(commandOptions, queries),
493
- });
494
- return;
495
- }
496
- await runDirectQuery(commandOptions, queries);
497
- }
498
- async function runDirectRgQuery(commandOptions, queries) {
499
- const zvecGrep = await createZvecGrep(createServiceOptions(commandOptions, undefined));
500
- try {
501
- const result = await zvecGrep.context(contextOptions(commandOptions, queries));
502
- printCliContextResult(result, commandOptions);
503
- for (const line of contextWarningLines(result)) {
504
- console.error(line);
505
- }
506
- if (commandOptions.debug) {
507
- printDebug(result, { trace: false });
508
- }
509
- }
510
- finally {
511
- await zvecGrep.close();
512
- }
513
- }
514
- async function runDirectQuery(commandOptions, queries) {
515
- if (commandOptions.refresh === "background") {
516
- console.error("warning: --refresh background requires Server mode; Direct mode uses --refresh off");
517
- }
518
- const serviceOptions = createServiceOptions(commandOptions, undefined);
519
- const zvecGrep = await createZvecGrep(serviceOptions);
520
- const progress = createIndexProgressReporter({
521
- color: commandOptions.color,
522
- });
523
- try {
524
- const contextRequest = contextOptions(commandOptions, queries, (progressEvent) => {
525
- if (progressEvent.phase !== "done")
526
- progress.report(progressEvent);
527
- });
528
- const info = await directQueryInfo(zvecGrep);
529
- const schema = info.workspaceIndex?.embedding;
530
- const workspaceRuntime = workspaceRuntimeFromInfo(info);
531
- const modelInfo = !commandOptions.rg && schema?.provider === "qwen"
532
- ? await embeddingModelInfo(schema, createServiceOptions(commandOptions, info.root), workspaceRuntime)
533
- : undefined;
534
- const plan = modelInfo
535
- ? await planRemoteSearchAuthorization({
536
- info,
537
- model: modelInfo,
538
- search: normalizedDirectSearchInput(commandOptions, queries, info.root),
539
- store: authorizationStore(commandOptions),
540
- })
541
- : undefined;
542
- const authorizationResolution = plan
543
- ? await authorizeCliPlan(plan, commandOptions, "local_search")
544
- : {};
545
- const effectiveContextRequest = authorizationResolution.alternative === "local_search"
546
- ? ftsFallbackContextRequest(contextRequest)
547
- : contextRequest;
548
- const result = await withRemoteEmbeddingOperationPermit(authorizationResolution.authorization, () => zvecGrep.context(effectiveContextRequest));
549
- progress.finish();
550
- printCliContextResult(result, commandOptions);
551
- for (const line of contextWarningLines(result)) {
552
- console.error(line);
553
- }
554
- if (result.source === "index" &&
555
- effectiveContextRequest.autoUpdate !== true &&
556
- indexStatusNeedsRefresh(info.status)) {
557
- printStaleIndexStatus("idle", indexCompletionFromStatus(info.status));
558
- }
559
- if (commandOptions.debug) {
560
- printDebug(result, {
561
- trace: commandOptions.trace === true,
562
- });
563
- }
564
- }
565
- catch (error) {
566
- progress.finish();
567
- throw error;
568
- }
569
- finally {
570
- await zvecGrep.close();
571
- }
572
- }
573
- async function runServerQuery(options, queries, routes) {
574
- const searchPolicy = resolveServerSearchPolicy(options);
575
- const structuredContent = await daemonClient(options).callTool("zvec_grep_search", {
576
- root: resolve(process.cwd()),
577
- apiKey: options.apiKey,
578
- device: options.device,
579
- queries: queries.length ? queries : undefined,
580
- routes: routes.length ? routes : undefined,
581
- fuse: options.fuse,
582
- limit: options.limit,
583
- trace: options.trace,
584
- preferSymbol: options.preferSymbol,
585
- symbolTypes: options.symbolTypes,
586
- globs: options.globs,
587
- insensitiveGlobs: options.insensitiveGlobs,
588
- fileTypes: options.fileTypes,
589
- excludedFileTypes: options.excludedFileTypes,
590
- hidden: options.hidden,
591
- noIgnore: options.noIgnore,
592
- ignoreFiles: options.ignoreFiles,
593
- maxDepth: options.maxDepth,
594
- maxFileSizeBytes: options.maxFileSizeBytes,
595
- follow: options.follow,
596
- embeddingConcurrency: options.embeddingConcurrency,
597
- modifiedAfter: options.modifiedAfter,
598
- modifiedBefore: options.modifiedBefore,
599
- freshness: searchPolicy.freshness,
600
- autoUpdate: searchPolicy.autoUpdate,
601
- }, {
602
- toolContract: {
603
- inputProperties: ["routes"],
604
- outputProperties: ["result"],
605
- errorMessage: INCOMPATIBLE_SERVER_SEARCH_MESSAGE,
606
- },
607
- });
608
- const response = parseServerSearchResponse(structuredContent);
609
- printCliContextResult(response.result, options);
610
- for (const line of contextWarningLines(response.result)) {
611
- console.error(line);
612
- }
613
- if (response.freshness === "possibly_stale") {
614
- printStaleIndexStatus(response.indexing?.state, response.indexing);
615
- }
616
- if (options.debug) {
617
- printDebug(response.result, { trace: options.trace === true });
618
- }
619
- }
620
- function printStaleIndexStatus(state, completion) {
621
- console.error("status: possibly_stale");
622
- if (!state)
623
- return;
624
- const progress = completion?.completed === undefined || completion.total === undefined
625
- ? ""
626
- : ` (${completion.completed}/${completion.total})`;
627
- console.error("results: served_from_current_index");
628
- console.error(`background_refresh: ${state}${progress}`);
629
- }
630
- function daemonClient(options) {
631
- return new DaemonClient({
632
- serverUrl: resolveServerUrl(),
633
- home: options.home,
634
- tokenFile: options.serverTokenFile,
635
- allowRemote: options.allowRemote,
636
- });
637
- }
638
- function ftsFallbackContextRequest(request) {
639
- const queries = [
640
- ...(request.queries ?? []),
641
- ...(request.query ? [request.query] : []),
642
- ...(request.routes ?? []).map((route) => route.query),
643
- ];
644
- return {
645
- ...request,
646
- query: undefined,
647
- queries: undefined,
648
- routes: queries.map((query) => ({ mode: "fts", query })),
649
- autoUpdate: false,
650
- };
651
- }
652
- async function directQueryInfo(service) {
653
- return await service.info({ root: process.cwd() });
654
- }
655
- function normalizedDirectSearchInput(options, queries, root) {
656
- const policy = resolveDirectSearchPolicy(options);
657
- return {
658
- root,
659
- apiKey: options.apiKey,
660
- device: options.device,
661
- queries: !options.rg && queries.length > 0 ? [...queries] : undefined,
662
- routes: [...(options.routes ?? [])],
663
- ...policy,
664
- };
665
- }
666
- async function daemonIsReady(home) {
667
- return (await serverStatus(home)).ready;
668
- }
669
- function printServerControlStatus(status) {
670
- console.log(`Server: ${status.running ? (status.ready ? "ready" : "starting") : "stopped"}`);
671
- if (status.pid)
672
- console.log(`PID: ${status.pid}`);
673
- if (status.serverUrl)
674
- console.log(`URL: ${status.serverUrl}`);
675
- if (status.mcpToolset)
676
- console.log(`MCP toolset: ${status.mcpToolset}`);
677
- }
678
- function contextOptions(options, queries, onAutoUpdateProgress) {
679
- const policy = resolveDirectSearchPolicy(options);
680
- return {
681
- queries: queries.length > 0 ? queries : undefined,
682
- rg: options.rg,
683
- rgOptions: options.rgOptions,
684
- rgPaths: options.rgPaths,
685
- routes: options.routes,
686
- fuse: options.fuse,
687
- limit: options.limit,
688
- autoUpdate: policy.autoUpdate,
689
- onAutoUpdateProgress,
690
- trace: options.trace,
691
- preferSymbol: options.preferSymbol,
692
- globs: options.globs,
693
- insensitiveGlobs: options.insensitiveGlobs,
694
- fileTypes: options.fileTypes,
695
- excludedFileTypes: options.excludedFileTypes,
696
- hidden: options.hidden,
697
- noIgnore: options.noIgnore,
698
- ignoreFiles: options.ignoreFiles,
699
- maxDepth: options.maxDepth,
700
- maxFileSizeBytes: options.maxFileSizeBytes,
701
- follow: options.follow,
702
- modifiedAfter: options.modifiedAfter,
703
- modifiedBefore: options.modifiedBefore,
704
- symbolTypes: options.symbolTypes,
705
- embeddingConcurrency: options.embeddingConcurrency,
706
- };
707
- }
708
- export function createServiceOptions(options, root) {
709
- return {
710
- root,
711
- home: options.home ?? process.env.ZVEC_GREP_HOME,
712
- embedding: options.embedding,
713
- apiKey: options.apiKey,
714
- endpoint: options.endpoint,
715
- modelCacheDir: options.modelCacheDir,
716
- device: options.device,
717
- authorizationSigningKeyPath: process.env.ZVEC_GREP_AUTHORIZATION_KEY_FILE,
718
- };
719
- }
720
- function resolveIndexRoot(root) {
721
- if (root !== undefined) {
722
- return root;
723
- }
724
- return findNearestWorkspace(process.cwd())?.root ?? process.cwd();
725
- }
726
- function indexRootPath(path, options) {
727
- return {
728
- absolutePath: resolve(path),
729
- recursive: true,
730
- globs: options.globs,
731
- insensitiveGlobs: options.insensitiveGlobs,
732
- fileTypes: options.fileTypes,
733
- excludedFileTypes: options.excludedFileTypes,
734
- hidden: options.hidden,
735
- noIgnore: options.noIgnore,
736
- ignoreFiles: options.ignoreFiles,
737
- maxDepth: options.maxDepth,
738
- maxFileSizeBytes: options.maxFileSizeBytes,
739
- follow: options.follow,
740
- };
741
- }
742
- //# sourceMappingURL=commands.js.map