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