@zvec/zvec-grep 0.1.5 → 0.1.6

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 (317) hide show
  1. package/README.md +88 -249
  2. package/README_CN.md +82 -246
  3. package/dist/authorization/index.d.ts +7 -0
  4. package/dist/authorization/index.js +7 -0
  5. package/dist/authorization/index.js.map +1 -0
  6. package/dist/authorization/manager.d.ts +8 -0
  7. package/dist/authorization/manager.js +19 -0
  8. package/dist/authorization/manager.js.map +1 -0
  9. package/dist/authorization/operation.d.ts +7 -0
  10. package/dist/authorization/operation.js +50 -0
  11. package/dist/authorization/operation.js.map +1 -0
  12. package/dist/authorization/planner.d.ts +21 -0
  13. package/dist/authorization/planner.js +97 -0
  14. package/dist/authorization/planner.js.map +1 -0
  15. package/dist/authorization/prompt.d.ts +11 -0
  16. package/dist/authorization/prompt.js +62 -0
  17. package/dist/authorization/prompt.js.map +1 -0
  18. package/dist/authorization/store.d.ts +20 -0
  19. package/dist/authorization/store.js +251 -0
  20. package/dist/authorization/store.js.map +1 -0
  21. package/dist/authorization/target.d.ts +15 -0
  22. package/dist/authorization/target.js +49 -0
  23. package/dist/authorization/target.js.map +1 -0
  24. package/dist/authorization/types.d.ts +61 -0
  25. package/dist/authorization/types.js +2 -0
  26. package/dist/authorization/types.js.map +1 -0
  27. package/dist/cli/args.d.ts +1 -1
  28. package/dist/cli/args.js +304 -54
  29. package/dist/cli/args.js.map +1 -1
  30. package/dist/cli/auth.d.ts +21 -0
  31. package/dist/cli/auth.js +212 -0
  32. package/dist/cli/auth.js.map +1 -0
  33. package/dist/cli/commands.js +433 -618
  34. package/dist/cli/commands.js.map +1 -1
  35. package/dist/cli/errors.js +2 -2
  36. package/dist/cli/errors.js.map +1 -1
  37. package/dist/cli/format/context.d.ts +1 -0
  38. package/dist/cli/format/context.js +241 -45
  39. package/dist/cli/format/context.js.map +1 -1
  40. package/dist/cli/format/debug.js +2 -2
  41. package/dist/cli/format/debug.js.map +1 -1
  42. package/dist/cli/format/progress.d.ts +4 -0
  43. package/dist/cli/format/progress.js +219 -46
  44. package/dist/cli/format/progress.js.map +1 -1
  45. package/dist/cli/format/status.d.ts +77 -6
  46. package/dist/cli/format/status.js +302 -106
  47. package/dist/cli/format/status.js.map +1 -1
  48. package/dist/cli/help.js +258 -59
  49. package/dist/cli/help.js.map +1 -1
  50. package/dist/cli/index.js +0 -0
  51. package/dist/cli/install.d.ts +4 -0
  52. package/dist/cli/install.js +845 -0
  53. package/dist/cli/install.js.map +1 -0
  54. package/dist/cli/managed-rg.d.ts +10 -0
  55. package/dist/cli/managed-rg.js +329 -0
  56. package/dist/cli/managed-rg.js.map +1 -0
  57. package/dist/cli/types.d.ts +20 -6
  58. package/dist/cli/types.js.map +1 -1
  59. package/dist/client/daemon-client.d.ts +19 -0
  60. package/dist/client/daemon-client.js +180 -0
  61. package/dist/client/daemon-client.js.map +1 -0
  62. package/dist/client/mode-router.d.ts +9 -0
  63. package/dist/client/mode-router.js +28 -0
  64. package/dist/client/mode-router.js.map +1 -0
  65. package/dist/client/search-policy.d.ts +11 -0
  66. package/dist/client/search-policy.js +15 -0
  67. package/dist/client/search-policy.js.map +1 -0
  68. package/dist/daemon/backend.d.ts +76 -0
  69. package/dist/daemon/backend.js +1049 -0
  70. package/dist/daemon/backend.js.map +1 -0
  71. package/dist/daemon/change-set.d.ts +25 -0
  72. package/dist/daemon/change-set.js +101 -0
  73. package/dist/daemon/change-set.js.map +1 -0
  74. package/dist/daemon/config.d.ts +24 -0
  75. package/dist/daemon/config.js +88 -0
  76. package/dist/daemon/config.js.map +1 -0
  77. package/dist/daemon/errors.d.ts +5 -0
  78. package/dist/daemon/errors.js +11 -0
  79. package/dist/daemon/errors.js.map +1 -0
  80. package/dist/daemon/http-server.d.ts +30 -0
  81. package/dist/daemon/http-server.js +287 -0
  82. package/dist/daemon/http-server.js.map +1 -0
  83. package/dist/daemon/index-coordinator.d.ts +23 -0
  84. package/dist/daemon/index-coordinator.js +68 -0
  85. package/dist/daemon/index-coordinator.js.map +1 -0
  86. package/dist/daemon/job-scheduler.d.ts +70 -0
  87. package/dist/daemon/job-scheduler.js +366 -0
  88. package/dist/daemon/job-scheduler.js.map +1 -0
  89. package/dist/daemon/logger.d.ts +9 -0
  90. package/dist/daemon/logger.js +53 -0
  91. package/dist/daemon/logger.js.map +1 -0
  92. package/dist/daemon/model-pool.d.ts +45 -0
  93. package/dist/daemon/model-pool.js +187 -0
  94. package/dist/daemon/model-pool.js.map +1 -0
  95. package/dist/daemon/root-lease.d.ts +14 -0
  96. package/dist/daemon/root-lease.js +188 -0
  97. package/dist/daemon/root-lease.js.map +1 -0
  98. package/dist/daemon/root-runtime.d.ts +78 -0
  99. package/dist/daemon/root-runtime.js +333 -0
  100. package/dist/daemon/root-runtime.js.map +1 -0
  101. package/dist/daemon/runtime-manager.d.ts +45 -0
  102. package/dist/daemon/runtime-manager.js +243 -0
  103. package/dist/daemon/runtime-manager.js.map +1 -0
  104. package/dist/daemon/runtime.d.ts +12 -0
  105. package/dist/daemon/runtime.js +102 -0
  106. package/dist/daemon/runtime.js.map +1 -0
  107. package/dist/daemon/server-controller.d.ts +39 -0
  108. package/dist/daemon/server-controller.js +203 -0
  109. package/dist/daemon/server-controller.js.map +1 -0
  110. package/dist/daemon/watch-manager.d.ts +50 -0
  111. package/dist/daemon/watch-manager.js +293 -0
  112. package/dist/daemon/watch-manager.js.map +1 -0
  113. package/dist/daemon/workspace-read-session-cache.d.ts +31 -0
  114. package/dist/daemon/workspace-read-session-cache.js +115 -0
  115. package/dist/daemon/workspace-read-session-cache.js.map +1 -0
  116. package/dist/engine/config.d.ts +30 -8
  117. package/dist/engine/config.js +171 -45
  118. package/dist/engine/config.js.map +1 -1
  119. package/dist/engine/{errors/index.d.ts → errors.d.ts} +6 -1
  120. package/dist/engine/{errors/details.js → errors.js} +17 -4
  121. package/dist/engine/errors.js.map +1 -0
  122. package/dist/engine/extraction/code/adapter.d.ts +1 -1
  123. package/dist/engine/extraction/code/extractor.d.ts +5 -11
  124. package/dist/engine/extraction/code/extractor.js +105 -44
  125. package/dist/engine/extraction/code/extractor.js.map +1 -1
  126. package/dist/engine/extraction/code/families/c-family.js +1 -1
  127. package/dist/engine/extraction/code/families/c-family.js.map +1 -1
  128. package/dist/engine/extraction/code/families/js-ts.d.ts +1 -1
  129. package/dist/engine/extraction/code/families/metadata.d.ts +1 -1
  130. package/dist/engine/extraction/code/tree-sitter/grammar.js.map +1 -0
  131. package/dist/engine/extraction/code/tree-sitter/nodes.js.map +1 -0
  132. package/dist/engine/extraction/code/tree-sitter/parser.js.map +1 -0
  133. package/dist/engine/extraction/image/extractor.d.ts +5 -0
  134. package/dist/engine/extraction/image/extractor.js +35 -0
  135. package/dist/engine/extraction/image/extractor.js.map +1 -0
  136. package/dist/engine/extraction/index.d.ts +3 -44
  137. package/dist/engine/extraction/index.js +1 -280
  138. package/dist/engine/extraction/index.js.map +1 -1
  139. package/dist/engine/extraction/markdown/extractor.d.ts +5 -11
  140. package/dist/engine/extraction/markdown/extractor.js +35 -16
  141. package/dist/engine/extraction/markdown/extractor.js.map +1 -1
  142. package/dist/engine/extraction/runtime.d.ts +4 -0
  143. package/dist/engine/extraction/runtime.js +26 -0
  144. package/dist/engine/extraction/runtime.js.map +1 -0
  145. package/dist/engine/extraction/source.d.ts +18 -0
  146. package/dist/engine/extraction/source.js +22 -0
  147. package/dist/engine/extraction/source.js.map +1 -0
  148. package/dist/engine/extraction/text/extractor.d.ts +7 -0
  149. package/dist/engine/extraction/text/extractor.js +168 -0
  150. package/dist/engine/extraction/text/extractor.js.map +1 -0
  151. package/dist/engine/extraction/types.d.ts +4 -0
  152. package/dist/engine/{models → extraction}/types.js.map +1 -1
  153. package/dist/engine/{files/file-type.d.ts → file-type.d.ts} +1 -1
  154. package/dist/engine/file-type.js.map +1 -0
  155. package/dist/engine/index-status.d.ts +9 -0
  156. package/dist/engine/index-status.js +38 -0
  157. package/dist/engine/index-status.js.map +1 -0
  158. package/dist/engine/manifest.d.ts +12 -0
  159. package/dist/engine/manifest.js +120 -0
  160. package/dist/engine/manifest.js.map +1 -0
  161. package/dist/engine/models/{providers/llama-cpp/embedding.d.ts → backends/llama-cpp.d.ts} +25 -20
  162. package/dist/engine/models/{providers/llama-cpp/embedding.js → backends/llama-cpp.js} +127 -106
  163. package/dist/engine/models/backends/llama-cpp.js.map +1 -0
  164. package/dist/engine/models/backends/model2vec.d.ts +57 -0
  165. package/dist/engine/models/backends/model2vec.js +332 -0
  166. package/dist/engine/models/backends/model2vec.js.map +1 -0
  167. package/dist/engine/models/backends/qwen.d.ts +44 -0
  168. package/dist/engine/models/{providers/qwen/embedding.js → backends/qwen.js} +155 -94
  169. package/dist/engine/models/backends/qwen.js.map +1 -0
  170. package/dist/engine/models/backends/transformers-js.d.ts +87 -0
  171. package/dist/engine/models/backends/transformers-js.js +316 -0
  172. package/dist/engine/models/backends/transformers-js.js.map +1 -0
  173. package/dist/engine/models/catalog.d.ts +188 -23
  174. package/dist/engine/models/catalog.js +172 -25
  175. package/dist/engine/models/catalog.js.map +1 -1
  176. package/dist/engine/models/download-progress.d.ts +15 -0
  177. package/dist/engine/models/download-progress.js +48 -0
  178. package/dist/engine/models/download-progress.js.map +1 -0
  179. package/dist/engine/models/embeddings.d.ts +58 -18
  180. package/dist/engine/models/embeddings.js +52 -28
  181. package/dist/engine/models/embeddings.js.map +1 -1
  182. package/dist/engine/models/factory.d.ts +2 -5
  183. package/dist/engine/models/factory.js +41 -56
  184. package/dist/engine/models/factory.js.map +1 -1
  185. package/dist/engine/models/index.d.ts +4 -6
  186. package/dist/engine/models/index.js +4 -4
  187. package/dist/engine/models/index.js.map +1 -1
  188. package/dist/engine/models/ranking.d.ts +7 -3
  189. package/dist/engine/models/resolution.d.ts +8 -0
  190. package/dist/engine/models/resolution.js +22 -0
  191. package/dist/engine/models/resolution.js.map +1 -0
  192. package/dist/engine/pipeline/indexing/index.d.ts +9 -7
  193. package/dist/engine/pipeline/indexing/index.js +360 -121
  194. package/dist/engine/pipeline/indexing/index.js.map +1 -1
  195. package/dist/engine/pipeline/indexing/root-paths.js +6 -6
  196. package/dist/engine/pipeline/indexing/root-paths.js.map +1 -1
  197. package/dist/engine/pipeline/indexing/scanner/index.d.ts +6 -1
  198. package/dist/engine/pipeline/indexing/scanner/index.js +233 -29
  199. package/dist/engine/pipeline/indexing/scanner/index.js.map +1 -1
  200. package/dist/engine/pipeline/search/index.d.ts +6 -6
  201. package/dist/engine/pipeline/search/index.js +8 -10
  202. package/dist/engine/pipeline/search/index.js.map +1 -1
  203. package/dist/engine/service/index.d.ts +3 -2
  204. package/dist/engine/service/index.js +1 -1
  205. package/dist/engine/service/index.js.map +1 -1
  206. package/dist/engine/service/root.d.ts +13 -12
  207. package/dist/engine/service/root.js +35 -24
  208. package/dist/engine/service/root.js.map +1 -1
  209. package/dist/engine/service/structure-enrichment.js +12 -14
  210. package/dist/engine/service/structure-enrichment.js.map +1 -1
  211. package/dist/engine/service/types.d.ts +32 -37
  212. package/dist/engine/service/workspace-index.d.ts +24 -0
  213. package/dist/engine/service/workspace-index.js +151 -0
  214. package/dist/engine/service/workspace-index.js.map +1 -0
  215. package/dist/engine/service/zvec-grep.d.ts +12 -1
  216. package/dist/engine/service/zvec-grep.js +677 -486
  217. package/dist/engine/service/zvec-grep.js.map +1 -1
  218. package/dist/engine/storage/index.d.ts +8 -4
  219. package/dist/engine/storage/index.js +1 -1
  220. package/dist/engine/storage/index.js.map +1 -1
  221. package/dist/engine/storage/zvec.d.ts +10 -33
  222. package/dist/engine/storage/zvec.js +95 -38
  223. package/dist/engine/storage/zvec.js.map +1 -1
  224. package/dist/engine/types.d.ts +15 -23
  225. package/dist/engine/types.js +1 -1
  226. package/dist/engine/types.js.map +1 -1
  227. package/dist/engine/utils/daemon-lease.d.ts +17 -0
  228. package/dist/engine/utils/daemon-lease.js +175 -0
  229. package/dist/engine/utils/daemon-lease.js.map +1 -0
  230. package/dist/engine/utils/file-selection.js +38 -1
  231. package/dist/engine/utils/file-selection.js.map +1 -1
  232. package/dist/engine/utils/lock.js +1 -1
  233. package/dist/engine/utils/lock.js.map +1 -1
  234. package/dist/index-progress.d.ts +10 -0
  235. package/dist/index-progress.js +159 -0
  236. package/dist/index-progress.js.map +1 -0
  237. package/dist/index.d.ts +4 -4
  238. package/dist/index.js +1 -1
  239. package/dist/index.js.map +1 -1
  240. package/dist/mcp/http-transport.d.ts +27 -0
  241. package/dist/mcp/http-transport.js +182 -0
  242. package/dist/mcp/http-transport.js.map +1 -0
  243. package/dist/mcp/input-normalization.d.ts +38 -0
  244. package/dist/mcp/input-normalization.js +95 -0
  245. package/dist/mcp/input-normalization.js.map +1 -0
  246. package/dist/mcp/progress-heartbeat.d.ts +17 -0
  247. package/dist/mcp/progress-heartbeat.js +46 -0
  248. package/dist/mcp/progress-heartbeat.js.map +1 -0
  249. package/dist/mcp/request-metadata.d.ts +2 -0
  250. package/dist/mcp/request-metadata.js +11 -0
  251. package/dist/mcp/request-metadata.js.map +1 -0
  252. package/dist/mcp/request-state.d.ts +40 -0
  253. package/dist/mcp/request-state.js +210 -0
  254. package/dist/mcp/request-state.js.map +1 -0
  255. package/dist/mcp/result-format.d.ts +13 -0
  256. package/dist/mcp/result-format.js +75 -0
  257. package/dist/mcp/result-format.js.map +1 -0
  258. package/dist/mcp/schemas.d.ts +430 -0
  259. package/dist/mcp/schemas.js +447 -0
  260. package/dist/mcp/schemas.js.map +1 -0
  261. package/dist/mcp/tools.d.ts +150 -0
  262. package/dist/mcp/tools.js +448 -0
  263. package/dist/mcp/tools.js.map +1 -0
  264. package/dist/mcp/toolset.d.ts +5 -0
  265. package/dist/mcp/toolset.js +12 -0
  266. package/dist/mcp/toolset.js.map +1 -0
  267. package/dist/observability/trace-context.d.ts +11 -0
  268. package/dist/observability/trace-context.js +138 -0
  269. package/dist/observability/trace-context.js.map +1 -0
  270. package/docs/01-agents.md +111 -0
  271. package/docs/02-cli.md +229 -0
  272. package/docs/03-mcp.md +167 -0
  273. package/docs/04-pipeline.md +218 -0
  274. package/docs/05-architecture.md +86 -0
  275. package/docs/06-server.md +210 -0
  276. package/docs/07-embedding.md +179 -0
  277. package/docs/08-roadmap.md +85 -0
  278. package/docs/README.md +53 -0
  279. package/package.json +17 -8
  280. package/skills/zvec-grep/SKILL.md +43 -133
  281. package/skills/zvec-grep/agents/openai.yaml +2 -2
  282. package/skills/zvec-grep/references/cli-fallback.md +85 -0
  283. package/dist/cli/mcp.d.ts +0 -2
  284. package/dist/cli/mcp.js +0 -354
  285. package/dist/cli/mcp.js.map +0 -1
  286. package/dist/engine/collection/index.d.ts +0 -55
  287. package/dist/engine/collection/index.js +0 -710
  288. package/dist/engine/collection/index.js.map +0 -1
  289. package/dist/engine/errors/details.d.ts +0 -6
  290. package/dist/engine/errors/details.js.map +0 -1
  291. package/dist/engine/errors/index.js +0 -16
  292. package/dist/engine/errors/index.js.map +0 -1
  293. package/dist/engine/extraction/tree-sitter/grammar.js.map +0 -1
  294. package/dist/engine/extraction/tree-sitter/nodes.js.map +0 -1
  295. package/dist/engine/extraction/tree-sitter/parser.js.map +0 -1
  296. package/dist/engine/files/file-type.js.map +0 -1
  297. package/dist/engine/models/providers/index.d.ts +0 -2
  298. package/dist/engine/models/providers/index.js +0 -3
  299. package/dist/engine/models/providers/index.js.map +0 -1
  300. package/dist/engine/models/providers/llama-cpp/embedding.js.map +0 -1
  301. package/dist/engine/models/providers/llama-cpp/index.d.ts +0 -1
  302. package/dist/engine/models/providers/llama-cpp/index.js +0 -2
  303. package/dist/engine/models/providers/llama-cpp/index.js.map +0 -1
  304. package/dist/engine/models/providers/qwen/embedding.d.ts +0 -42
  305. package/dist/engine/models/providers/qwen/embedding.js.map +0 -1
  306. package/dist/engine/models/providers/qwen/index.d.ts +0 -1
  307. package/dist/engine/models/providers/qwen/index.js +0 -2
  308. package/dist/engine/models/providers/qwen/index.js.map +0 -1
  309. package/dist/engine/models/types.d.ts +0 -30
  310. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/grammar.d.ts +0 -0
  311. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/grammar.js +0 -0
  312. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/nodes.d.ts +0 -0
  313. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/nodes.js +0 -0
  314. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/parser.d.ts +0 -0
  315. /package/dist/engine/extraction/{tree-sitter → code/tree-sitter}/parser.js +0 -0
  316. /package/dist/engine/{models → extraction}/types.js +0 -0
  317. /package/dist/engine/{files/file-type.js → file-type.js} +0 -0
package/dist/cli/mcp.js DELETED
@@ -1,354 +0,0 @@
1
- import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
- import { z } from "zod";
4
- import { createZvecGrep, } from "../index.js";
5
- import { parseModifiedTime, splitPathFilters } from "./args.js";
6
- import { readPackageVersion } from "./version.js";
7
- const stringListInputSchema = z
8
- .union([z.string(), z.array(z.string())])
9
- .optional();
10
- const timeInputSchema = z
11
- .union([z.number().int().nonnegative(), z.string()])
12
- .optional();
13
- const codeSymbolTypeSchema = z.enum([
14
- "module",
15
- "class",
16
- "interface",
17
- "function",
18
- "value",
19
- "alias",
20
- ]);
21
- export async function runMcpServer(options) {
22
- const zvecGrep = await createZvecGrep(options);
23
- const server = createMcpServer(zvecGrep);
24
- const transport = new StdioServerTransport();
25
- const close = async () => {
26
- await zvecGrep.close();
27
- await server.close();
28
- };
29
- process.once("SIGINT", () => {
30
- void close().finally(() => process.exit(130));
31
- });
32
- process.once("SIGTERM", () => {
33
- void close().finally(() => process.exit(143));
34
- });
35
- await server.connect(transport);
36
- }
37
- function createMcpServer(zvecGrep) {
38
- const server = new McpServer({
39
- name: "zvec-grep",
40
- version: readPackageVersion(),
41
- }, {
42
- instructions: [
43
- "Use zvec-grep for repository code search before grep, rg, or broad file reads.",
44
- "Use zvec_grep_search for indexed semantic and lexical retrieval, and zvec_grep_rg for explicit no-index lexical search.",
45
- "Index management and status inspection are CLI-only operations.",
46
- ].join(" "),
47
- });
48
- server.registerTool("zvec_grep_search", {
49
- title: "zvec-grep indexed search",
50
- description: "Search an indexed repository with zvec-grep hybrid semantic and lexical retrieval. Like the CLI, this may refresh a stale anonymous index unless autoUpdate is false.",
51
- inputSchema: {
52
- query: z
53
- .string()
54
- .optional()
55
- .describe("Natural-language or exact search query."),
56
- queries: stringListInputSchema.describe("Multiple query groups. Use this for related concepts."),
57
- fts: stringListInputSchema.describe("Exact lexical anchors, such as symbols, flags, or error messages."),
58
- vector: stringListInputSchema.describe("Explicit semantic/vector-only queries."),
59
- root: z
60
- .string()
61
- .optional()
62
- .describe("Repository root. Defaults to the MCP server working directory."),
63
- collection: z
64
- .string()
65
- .optional()
66
- .describe("Named collection to query instead of the anonymous repository index."),
67
- limit: z
68
- .number()
69
- .int()
70
- .positive()
71
- .max(50)
72
- .optional()
73
- .describe("Maximum returned items per query/group."),
74
- include: stringListInputSchema.describe("Path filters to include. Accepts an array or comma-separated string."),
75
- exclude: stringListInputSchema.describe("Path filters to exclude. Accepts an array or comma-separated string."),
76
- preferSymbol: z
77
- .boolean()
78
- .optional()
79
- .describe("Prefer exact indexed symbols when query names a symbol."),
80
- symbolTypes: z
81
- .array(codeSymbolTypeSchema)
82
- .default([])
83
- .describe("Restrict indexed results to symbol types."),
84
- modifiedAfter: timeInputSchema.describe("Only query files modified after this time. Accepts epoch milliseconds or a parseable date string."),
85
- modifiedBefore: timeInputSchema.describe("Only query files modified before this time. Accepts epoch milliseconds or a parseable date string."),
86
- autoUpdate: z
87
- .boolean()
88
- .optional()
89
- .describe("Refresh an existing stale anonymous index before query. Defaults to CLI behavior: true."),
90
- embeddingConcurrency: z
91
- .number()
92
- .int()
93
- .positive()
94
- .max(64)
95
- .optional()
96
- .describe("Embedding task concurrency for automatic index refresh."),
97
- trace: z
98
- .boolean()
99
- .optional()
100
- .describe("Include per-hit search trace in structured output."),
101
- maxContentChars: z
102
- .number()
103
- .int()
104
- .positive()
105
- .max(6000)
106
- .default(1200)
107
- .describe("Maximum source characters to include per hit."),
108
- },
109
- annotations: {
110
- readOnlyHint: false,
111
- destructiveHint: false,
112
- idempotentHint: true,
113
- openWorldHint: true,
114
- },
115
- }, async (input) => {
116
- const result = await zvecGrep.context(contextOptionsFromSearchInput(input));
117
- return toolResult(contextText(result, input.maxContentChars), {
118
- result: simplifyContextResult(result, input.maxContentChars),
119
- });
120
- });
121
- server.registerTool("zvec_grep_rg", {
122
- title: "zvec-grep no-index lexical search",
123
- description: "Run explicit no-index lexical search through zvec-grep managed ripgrep output.",
124
- inputSchema: {
125
- pattern: z
126
- .string()
127
- .optional()
128
- .describe("Regex or literal pattern to search for."),
129
- patterns: stringListInputSchema.describe("Multiple regex or literal patterns to search for."),
130
- root: z
131
- .string()
132
- .optional()
133
- .describe("Repository root. Defaults to the MCP server working directory."),
134
- paths: stringListInputSchema.describe("Optional paths to search within the root."),
135
- fixedStrings: z
136
- .boolean()
137
- .optional()
138
- .describe("Treat pattern as a literal string."),
139
- ignoreCase: z
140
- .boolean()
141
- .optional()
142
- .describe("Search case-insensitively."),
143
- wordRegexp: z.boolean().optional().describe("Only match whole words."),
144
- context: z
145
- .number()
146
- .int()
147
- .nonnegative()
148
- .max(20)
149
- .optional()
150
- .describe("Context lines before and after each match."),
151
- beforeContext: z
152
- .number()
153
- .int()
154
- .nonnegative()
155
- .max(20)
156
- .optional()
157
- .describe("Context lines before each match."),
158
- afterContext: z
159
- .number()
160
- .int()
161
- .nonnegative()
162
- .max(20)
163
- .optional()
164
- .describe("Context lines after each match."),
165
- hidden: z
166
- .boolean()
167
- .optional()
168
- .describe("Search hidden files and directories."),
169
- glob: stringListInputSchema.describe("ripgrep glob filters, for example '*.ts' or '!dist/**'. Accepts an array or comma-separated string."),
170
- limit: z
171
- .number()
172
- .int()
173
- .positive()
174
- .max(200)
175
- .optional()
176
- .describe("Maximum returned matches."),
177
- maxContentChars: z
178
- .number()
179
- .int()
180
- .positive()
181
- .max(6000)
182
- .default(1200)
183
- .describe("Maximum source characters to include per hit."),
184
- },
185
- annotations: {
186
- readOnlyHint: true,
187
- destructiveHint: false,
188
- idempotentHint: true,
189
- openWorldHint: false,
190
- },
191
- }, async (input) => {
192
- const result = await zvecGrep.context(contextOptionsFromRgInput(input));
193
- return toolResult(contextText(result, input.maxContentChars), {
194
- result: simplifyContextResult(result, input.maxContentChars),
195
- });
196
- });
197
- return server;
198
- }
199
- function contextOptionsFromSearchInput(input) {
200
- const queries = [
201
- ...normalizeQueryList(input.query),
202
- ...normalizeQueryList(input.queries),
203
- ];
204
- const fts = normalizeQueryList(input.fts);
205
- const vector = normalizeQueryList(input.vector);
206
- if (queries.length === 0 && fts.length === 0 && vector.length === 0) {
207
- throw new Error("zvec_grep_search requires query, queries, fts, or vector.");
208
- }
209
- const includePaths = normalizePathFilters(input.include);
210
- const excludePaths = normalizePathFilters(input.exclude);
211
- return {
212
- queries: queries.length > 0 ? queries : undefined,
213
- routes: [
214
- ...fts.map((query) => ({ mode: "fts", query })),
215
- ...vector.map((query) => ({ mode: "vector", query })),
216
- ],
217
- root: normalizeOptionalString(input.root),
218
- collection: normalizeOptionalString(input.collection),
219
- limit: input.limit,
220
- autoUpdate: input.autoUpdate ?? true,
221
- trace: input.trace,
222
- preferSymbol: input.preferSymbol,
223
- symbolTypes: input.symbolTypes.length > 0 ? input.symbolTypes : undefined,
224
- includePaths: includePaths.length > 0 ? includePaths : undefined,
225
- excludePaths: excludePaths.length > 0 ? excludePaths : undefined,
226
- modifiedAfter: normalizeModifiedTime(input.modifiedAfter, "modifiedAfter"),
227
- modifiedBefore: normalizeModifiedTime(input.modifiedBefore, "modifiedBefore"),
228
- embeddingConcurrency: input.embeddingConcurrency,
229
- };
230
- }
231
- function contextOptionsFromRgInput(input) {
232
- const queries = [
233
- ...normalizeQueryList(input.pattern),
234
- ...normalizeQueryList(input.patterns),
235
- ];
236
- if (queries.length === 0) {
237
- throw new Error("zvec_grep_rg requires pattern or patterns.");
238
- }
239
- const globs = normalizePathFilters(input.glob);
240
- const rgOptions = {
241
- fixedStrings: input.fixedStrings,
242
- ignoreCase: input.ignoreCase,
243
- wordRegexp: input.wordRegexp,
244
- beforeContext: input.beforeContext ?? input.context,
245
- afterContext: input.afterContext ?? input.context,
246
- hidden: input.hidden,
247
- };
248
- return {
249
- queries,
250
- rg: true,
251
- rgOptions,
252
- rgPaths: normalizePlainStringList(input.paths),
253
- root: normalizeOptionalString(input.root),
254
- limit: input.limit,
255
- globs: globs.length > 0 ? globs : undefined,
256
- };
257
- }
258
- function normalizeQueryList(value) {
259
- return normalizePlainStringList(value) ?? [];
260
- }
261
- function normalizePlainStringList(value) {
262
- const items = value === undefined ? [] : Array.isArray(value) ? value : [value];
263
- const normalized = items
264
- .map((item) => item.trim())
265
- .filter((item) => item.length > 0);
266
- return normalized.length > 0 ? normalized : undefined;
267
- }
268
- function normalizePathFilters(value) {
269
- const items = value === undefined ? [] : Array.isArray(value) ? value : [value];
270
- return items.flatMap(splitPathFilters);
271
- }
272
- function normalizeModifiedTime(value, option) {
273
- if (value === undefined) {
274
- return undefined;
275
- }
276
- return typeof value === "number" ? value : parseModifiedTime(value, option);
277
- }
278
- function normalizeOptionalString(value) {
279
- const normalized = value?.trim() ?? "";
280
- return normalized.length > 0 ? normalized : undefined;
281
- }
282
- function toolResult(text, structuredContent) {
283
- return {
284
- content: [{ type: "text", text }],
285
- structuredContent,
286
- };
287
- }
288
- function contextText(result, maxContentChars) {
289
- const lines = [
290
- `query: ${result.query}`,
291
- `root: ${result.root}`,
292
- `source: ${result.source}`,
293
- `coverage: ${result.coverage}`,
294
- `hits: ${result.items.length}`,
295
- ];
296
- for (const item of result.items) {
297
- lines.push("");
298
- lines.push(`${item.file.relativePath}:${rangeLabel(item.range)} rank=${item.rank} matchedBy=${item.matchedBy}`);
299
- if (item.outline) {
300
- lines.push(`outline: ${truncate(item.outline, maxContentChars)}`);
301
- }
302
- lines.push("source:");
303
- lines.push(truncate(item.content, maxContentChars));
304
- }
305
- return lines.join("\n");
306
- }
307
- function simplifyContextResult(result, maxContentChars) {
308
- return {
309
- query: result.query,
310
- root: result.root,
311
- source: result.source,
312
- coverage: result.coverage,
313
- collection: result.collection,
314
- diagnostics: result.diagnostics,
315
- items: result.items.map((item) => ({
316
- kind: item.kind,
317
- rank: item.rank,
318
- file: item.file,
319
- range: item.range,
320
- excerptRange: item.excerptRange,
321
- outline: item.outline
322
- ? truncate(item.outline, maxContentChars)
323
- : undefined,
324
- content: truncate(item.content, maxContentChars),
325
- contentRole: item.contentRole,
326
- status: item.status,
327
- score: item.score,
328
- matchedBy: item.matchedBy,
329
- metadata: item.metadata,
330
- entityId: item.entityId,
331
- container: item.container,
332
- trace: item.trace,
333
- })),
334
- };
335
- }
336
- function rangeLabel(range) {
337
- if (range.kind === "text" &&
338
- typeof range.startLine === "number" &&
339
- typeof range.endLine === "number") {
340
- return `${range.startLine}-${range.endLine}`;
341
- }
342
- if (typeof range.startOffset === "number" &&
343
- typeof range.endOffset === "number") {
344
- return `${range.startOffset}-${range.endOffset}`;
345
- }
346
- return range.kind;
347
- }
348
- function truncate(value, maxChars) {
349
- if (value.length <= maxChars) {
350
- return value;
351
- }
352
- return `${value.slice(0, maxChars)}\n...[truncated ${value.length - maxChars} chars]`;
353
- }
354
- //# sourceMappingURL=mcp.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"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"}
@@ -1,55 +0,0 @@
1
- import type { EmbeddingModel } from "../models/embeddings.js";
2
- import type { StoredEntity } from "../storage/index.js";
3
- import type { CollectionEmbeddingSchema, CollectionIndexStatus, CollectionInfo, EntitySearchDiagnosis, FileDiagnosis, FileInfo, IndexOptions, IndexResult, RootPath, SearchPlan, SearchPlanResult } from "../types.js";
4
- export declare class Collection {
5
- readonly info: CollectionInfo;
6
- private readonly embeddingModel?;
7
- private readonly readOnly;
8
- private readonly fileStorePath;
9
- private readonly storage;
10
- private readonly embedding;
11
- constructor(info: CollectionInfo, embeddingModel?: EmbeddingModel | undefined, readOnly?: boolean, fileStorePath?: string);
12
- get id(): string;
13
- get name(): string;
14
- index(options?: IndexOptions): Promise<IndexResult>;
15
- status(): Promise<CollectionIndexStatus>;
16
- searchPlan(plan: SearchPlan): Promise<SearchPlanResult>;
17
- diagnoseFile(absolutePath: string): FileDiagnosis;
18
- diagnoseEntitySearch(query: string, entityId: string): Promise<EntitySearchDiagnosis>;
19
- diagnoseFileSearch(query: string, absolutePath: string): Promise<EntitySearchDiagnosis | null>;
20
- getFile(absolutePath: string): FileInfo | null;
21
- listEntitiesByFile(fileId: string, options?: {
22
- limit?: number;
23
- offset?: number;
24
- }): StoredEntity[];
25
- getEntity(entityId: string): StoredEntity | null;
26
- close(): void;
27
- private validateIndexVersion;
28
- private validateEmbeddingSchema;
29
- private requireEmbeddingModel;
30
- }
31
- export declare function isCollectionIndexed(info: CollectionInfo | null | undefined): info is CollectionInfo & {
32
- embedding: CollectionEmbeddingSchema;
33
- indexVersion: number;
34
- };
35
- export declare class CollectionRegistry {
36
- readonly home: string;
37
- private readonly embeddingModel?;
38
- private readonly readOnly;
39
- private readonly meta;
40
- private readonly collections;
41
- constructor(home?: string, embeddingModel?: EmbeddingModel | undefined, readOnly?: boolean);
42
- list(): CollectionInfo[];
43
- get(name: string): CollectionInfo | null;
44
- has(name: string): boolean;
45
- remove(name: string): boolean;
46
- rename(name: string, nextName: string): CollectionInfo | null;
47
- status(name: string): Promise<CollectionIndexStatus | null>;
48
- create(name: string, rootPaths: readonly (string | RootPath)[], path?: string): CollectionInfo;
49
- prepareIndex(name: string, rootPaths: readonly (string | RootPath)[], path?: string): CollectionInfo;
50
- disableIndex(name: string, rootPaths: readonly (string | RootPath)[], path?: string): CollectionInfo;
51
- updateRootPaths(name: string, rootPaths: readonly (string | RootPath)[]): CollectionInfo | null;
52
- open(name: string): Collection;
53
- close(): void;
54
- }
55
- export declare function defaultCollectionName(path: string): string;