@paretools/search 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dave London
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAllTools } from "./tools/index.js";
+const server = new McpServer({ name: "@paretools/search", version: "0.7.0" }, {
+    instructions: "Structured code search operations (ripgrep + fd). Returns typed JSON with match locations, file lists, and match counts. Use instead of running rg/fd/grep/find in the terminal.",
+});
+registerAllTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC/C;IACE,YAAY,EACV,kLAAkL;CACrL,CACF,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,31 @@
+import type { SearchResult, FindResult, CountResult } from "../schemas/index.js";
+/** Formats structured search results into a human-readable match listing. */
+export declare function formatSearch(data: SearchResult): string;
+/** Formats structured find results into a human-readable file listing. */
+export declare function formatFind(data: FindResult): string;
+/** Formats structured count results into a human-readable per-file count listing. */
+export declare function formatCount(data: CountResult): string;
+/** Compact search: totals only, drop individual matches. */
+export interface SearchCompact {
+    [key: string]: unknown;
+    totalMatches: number;
+    filesSearched: number;
+}
+export declare function compactSearchMap(data: SearchResult): SearchCompact;
+export declare function formatSearchCompact(data: SearchCompact): string;
+/** Compact find: total count only, drop individual file entries. */
+export interface FindCompact {
+    [key: string]: unknown;
+    total: number;
+}
+export declare function compactFindMap(data: FindResult): FindCompact;
+export declare function formatFindCompact(data: FindCompact): string;
+/** Compact count: totals only, drop per-file breakdown. */
+export interface CountCompact {
+    [key: string]: unknown;
+    totalMatches: number;
+    totalFiles: number;
+}
+export declare function compactCountMap(data: CountResult): CountCompact;
+export declare function formatCountCompact(data: CountCompact): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/lib/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIjF,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAQvD;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQnD;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQrD;AAID,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAKlE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAG/D;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAI5D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAG3D;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAK/D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAG7D"}

package/dist/lib/formatters.js

@@ -0,0 +1,64 @@
+// ── Full formatters ─────────────────────────────────────────────────
+/** Formats structured search results into a human-readable match listing. */
+export function formatSearch(data) {
+    if (data.totalMatches === 0)
+        return "search: no matches found.";
+    const lines = [`search: ${data.totalMatches} matches in ${data.filesSearched} files`];
+    for (const m of data.matches) {
+        lines.push(`  ${m.file}:${m.line}:${m.column}: ${m.lineContent}`);
+    }
+    return lines.join("\n");
+}
+/** Formats structured find results into a human-readable file listing. */
+export function formatFind(data) {
+    if (data.total === 0)
+        return "find: no files found.";
+    const lines = [`find: ${data.total} files`];
+    for (const f of data.files) {
+        lines.push(`  ${f.path}`);
+    }
+    return lines.join("\n");
+}
+/** Formats structured count results into a human-readable per-file count listing. */
+export function formatCount(data) {
+    if (data.totalFiles === 0)
+        return "count: no matches found.";
+    const lines = [`count: ${data.totalMatches} matches in ${data.totalFiles} files`];
+    for (const f of data.files) {
+        lines.push(`  ${f.file}: ${f.count}`);
+    }
+    return lines.join("\n");
+}
+export function compactSearchMap(data) {
+    return {
+        totalMatches: data.totalMatches,
+        filesSearched: data.filesSearched,
+    };
+}
+export function formatSearchCompact(data) {
+    if (data.totalMatches === 0)
+        return "search: no matches found.";
+    return `search: ${data.totalMatches} matches in ${data.filesSearched} files`;
+}
+export function compactFindMap(data) {
+    return {
+        total: data.total,
+    };
+}
+export function formatFindCompact(data) {
+    if (data.total === 0)
+        return "find: no files found.";
+    return `find: ${data.total} files`;
+}
+export function compactCountMap(data) {
+    return {
+        totalMatches: data.totalMatches,
+        totalFiles: data.totalFiles,
+    };
+}
+export function formatCountCompact(data) {
+    if (data.totalFiles === 0)
+        return "count: no matches found.";
+    return `count: ${data.totalMatches} matches in ${data.totalFiles} files`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/lib/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAEA,uEAAuE;AAEvE,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,IAAkB;IAC7C,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC;QAAE,OAAO,2BAA2B,CAAC;IAEhE,MAAM,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,aAAa,QAAQ,CAAC,CAAC;IACtF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,uBAAuB,CAAC;IAErD,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IAE7D,MAAM,KAAK,GAAG,CAAC,UAAU,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,UAAU,QAAQ,CAAC,CAAC;IAClF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAWD,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IACjD,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC;QAAE,OAAO,2BAA2B,CAAC;IAChE,OAAO,WAAW,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,aAAa,QAAQ,CAAC;AAC/E,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,uBAAuB,CAAC;IACrD,OAAO,SAAS,IAAI,CAAC,KAAK,QAAQ,CAAC;AACrC,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,IAAiB;IAC/C,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IAC7D,OAAO,UAAU,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,UAAU,QAAQ,CAAC;AAC3E,CAAC"}

package/dist/lib/parsers.d.ts

@@ -0,0 +1,21 @@
+import type { SearchResult, FindResult, CountResult } from "../schemas/index.js";
+/**
+ * Parses `rg --json` JSONL output into a structured SearchResult.
+ *
+ * Each line of stdout is a JSON object. We filter for type="match" events
+ * and extract the file, line number, column (from submatches[0].start),
+ * match text, and full line content (trimmed).
+ */
+export declare function parseRgJsonOutput(stdout: string, maxResults: number): SearchResult;
+/**
+ * Parses `fd` output (one file path per line) into a structured FindResult.
+ * Extracts basename and extension for each entry.
+ */
+export declare function parseFdOutput(stdout: string, maxResults: number): FindResult;
+/**
+ * Parses `rg --count` output into a structured CountResult.
+ * Each line has the format `file:count`. We split on the LAST colon
+ * to handle file paths that may contain colons (e.g., Windows drive letters).
+ */
+export declare function parseRgCountOutput(stdout: string): CountResult;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/lib/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/lib/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAoCjF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CA6ClF;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAwB5E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAwB9D"}

package/dist/lib/parsers.js

@@ -0,0 +1,107 @@
+import * as path from "node:path";
+/**
+ * Parses `rg --json` JSONL output into a structured SearchResult.
+ *
+ * Each line of stdout is a JSON object. We filter for type="match" events
+ * and extract the file, line number, column (from submatches[0].start),
+ * match text, and full line content (trimmed).
+ */
+export function parseRgJsonOutput(stdout, maxResults) {
+    const lines = stdout.split("\n").filter(Boolean);
+    const matches = [];
+    let filesSearched = 0;
+    const seenFiles = new Set();
+    for (const line of lines) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (parsed.type === "match") {
+            const data = parsed.data;
+            const file = data.path.text;
+            seenFiles.add(file);
+            if (matches.length < maxResults) {
+                const submatch = data.submatches[0];
+                matches.push({
+                    file,
+                    line: data.line_number,
+                    column: submatch ? submatch.start + 1 : 1, // 1-based column
+                    matchText: submatch ? submatch.match.text : "",
+                    lineContent: data.lines.text.trimEnd(),
+                });
+            }
+        }
+        else if (parsed.type === "summary") {
+            const stats = parsed.data.stats;
+            filesSearched = stats.searches_with_match;
+        }
+    }
+    // If no summary line was emitted, use the count of unique files with matches
+    if (filesSearched === 0) {
+        filesSearched = seenFiles.size;
+    }
+    return {
+        matches,
+        totalMatches: matches.length,
+        filesSearched,
+    };
+}
+// ── fd parser ───────────────────────────────────────────────────────
+/**
+ * Parses `fd` output (one file path per line) into a structured FindResult.
+ * Extracts basename and extension for each entry.
+ */
+export function parseFdOutput(stdout, maxResults) {
+    const lines = stdout.split("\n").filter(Boolean);
+    const files = [];
+    for (const line of lines) {
+        if (files.length >= maxResults)
+            break;
+        const filePath = line.trim();
+        if (!filePath)
+            continue;
+        const name = path.basename(filePath);
+        const ext = path.extname(filePath);
+        files.push({
+            path: filePath,
+            name,
+            ext,
+        });
+    }
+    return {
+        files,
+        total: files.length,
+    };
+}
+// ── rg --count parser ───────────────────────────────────────────────
+/**
+ * Parses `rg --count` output into a structured CountResult.
+ * Each line has the format `file:count`. We split on the LAST colon
+ * to handle file paths that may contain colons (e.g., Windows drive letters).
+ */
+export function parseRgCountOutput(stdout) {
+    const lines = stdout.split("\n").filter(Boolean);
+    const files = [];
+    let totalMatches = 0;
+    for (const line of lines) {
+        const lastColon = line.lastIndexOf(":");
+        if (lastColon === -1)
+            continue;
+        const file = line.slice(0, lastColon);
+        const countStr = line.slice(lastColon + 1).trim();
+        const count = parseInt(countStr, 10);
+        if (isNaN(count))
+            continue;
+        files.push({ file, count });
+        totalMatches += count;
+    }
+    return {
+        files,
+        totalMatches,
+        totalFiles: files.length,
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/lib/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/lib/parsers.ts"],"names":[],"mappings":"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"}

package/dist/lib/search-runner.d.ts

@@ -0,0 +1,4 @@
+import { type RunResult } from "@paretools/shared";
+export declare function rgCmd(args: string[], cwd?: string): Promise<RunResult>;
+export declare function fdCmd(args: string[], cwd?: string): Promise<RunResult>;
+//# sourceMappingURL=search-runner.d.ts.map

package/dist/lib/search-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-runner.d.ts","sourceRoot":"","sources":["../../src/lib/search-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE5E;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE5E"}

package/dist/lib/search-runner.js

@@ -0,0 +1,8 @@
+import { run } from "@paretools/shared";
+export async function rgCmd(args, cwd) {
+    return run("rg", args, { cwd, timeout: 120_000 });
+}
+export async function fdCmd(args, cwd) {
+    return run("fd", args, { cwd, timeout: 120_000 });
+}
+//# sourceMappingURL=search-runner.js.map

package/dist/lib/search-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-runner.js","sourceRoot":"","sources":["../../src/lib/search-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAkB,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc,EAAE,GAAY;IACtD,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc,EAAE,GAAY;IACtD,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+/** Zod schema for a single search match with file location and matched text. */
+export declare const SearchMatchSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    matchText: z.ZodString;
+    lineContent: z.ZodString;
+}, z.core.$strip>;
+/** Zod schema for structured ripgrep search output with match list and totals. */
+export declare const SearchResultSchema: z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        matchText: z.ZodString;
+        lineContent: z.ZodString;
+    }, z.core.$strip>>;
+    totalMatches: z.ZodNumber;
+    filesSearched: z.ZodNumber;
+}, z.core.$strip>;
+export type SearchResult = z.infer<typeof SearchResultSchema>;
+/** Zod schema for a single file entry with path, name, and extension. */
+export declare const FindFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    name: z.ZodString;
+    ext: z.ZodString;
+}, z.core.$strip>;
+/** Zod schema for structured fd output with file list and total count. */
+export declare const FindResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        name: z.ZodString;
+        ext: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type FindResult = z.infer<typeof FindResultSchema>;
+/** Zod schema for a single file match count entry. */
+export declare const CountFileSchema: z.ZodObject<{
+    file: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/** Zod schema for structured rg --count output with per-file counts and totals. */
+export declare const CountResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    totalMatches: z.ZodNumber;
+    totalFiles: z.ZodNumber;
+}, z.core.$strip>;
+export type CountResult = z.infer<typeof CountResultSchema>;
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gFAAgF;AAChF,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAI7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,yEAAyE;AACzE,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,sDAAsD;AACtD,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+// ── Search (rg --json) ───────────────────────────────────────────────
+/** Zod schema for a single search match with file location and matched text. */
+export const SearchMatchSchema = z.object({
+    file: z.string(),
+    line: z.number(),
+    column: z.number(),
+    matchText: z.string(),
+    lineContent: z.string(),
+});
+/** Zod schema for structured ripgrep search output with match list and totals. */
+export const SearchResultSchema = z.object({
+    matches: z.array(SearchMatchSchema),
+    totalMatches: z.number(),
+    filesSearched: z.number(),
+});
+// ── Find (fd) ────────────────────────────────────────────────────────
+/** Zod schema for a single file entry with path, name, and extension. */
+export const FindFileSchema = z.object({
+    path: z.string(),
+    name: z.string(),
+    ext: z.string(),
+});
+/** Zod schema for structured fd output with file list and total count. */
+export const FindResultSchema = z.object({
+    files: z.array(FindFileSchema),
+    total: z.number(),
+});
+// ── Count (rg --count) ──────────────────────────────────────────────
+/** Zod schema for a single file match count entry. */
+export const CountFileSchema = z.object({
+    file: z.string(),
+    count: z.number(),
+});
+/** Zod schema for structured rg --count output with per-file counts and totals. */
+export const CountResultSchema = z.object({
+    files: z.array(CountFileSchema),
+    totalMatches: z.number(),
+    totalFiles: z.number(),
+});
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAIH,wEAAwE;AAExE,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAIH,uEAAuE;AAEvE,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}

package/dist/tools/count.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCountTool(server: McpServer): void;
+//# sourceMappingURL=count.d.ts.map

package/dist/tools/count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.d.ts","sourceRoot":"","sources":["../../src/tools/count.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAuElD"}

package/dist/tools/count.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS } from "@paretools/shared";
+import { rgCmd } from "../lib/search-runner.js";
+import { parseRgCountOutput } from "../lib/parsers.js";
+import { formatCount, compactCountMap, formatCountCompact } from "../lib/formatters.js";
+import { CountResultSchema } from "../schemas/index.js";
+export function registerCountTool(server) {
+    server.registerTool("count", {
+        title: "Match Count",
+        description: "Counts pattern matches per file using ripgrep. Returns per-file match counts and totals. Use instead of running `rg --count` or `grep -c` in the terminal.",
+        inputSchema: {
+            pattern: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("Regular expression pattern to count matches for"),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Directory or file to search in (default: cwd)"),
+            glob: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("Glob pattern to filter files (e.g., '*.ts', '*.{js,jsx}')"),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Case-sensitive search (default: true)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+        },
+        outputSchema: CountResultSchema,
+    }, async ({ pattern, path, glob, caseSensitive, compact }) => {
+        assertNoFlagInjection(pattern, "pattern");
+        if (path)
+            assertNoFlagInjection(path, "path");
+        if (glob)
+            assertNoFlagInjection(glob, "glob");
+        const cwd = path || process.cwd();
+        const args = ["--count"];
+        if (!caseSensitive) {
+            args.push("--ignore-case");
+        }
+        if (glob) {
+            args.push("--glob", glob);
+        }
+        args.push(pattern);
+        const result = await rgCmd(args, cwd);
+        // rg exits with code 1 when no matches are found — that's not an error
+        const data = parseRgCountOutput(result.stdout);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatCount, compactCountMap, formatCountCompact, compact === false);
+    });
+}
+//# sourceMappingURL=count.js.map

package/dist/tools/count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.js","sourceRoot":"","sources":["../../src/tools/count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,OAAO,EACP;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,4JAA4J;QAC9J,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC;iBAC5B,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC;iBAC1B,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC;iBAClC,QAAQ,EAAE;iBACV,QAAQ,CAAC,2DAA2D,CAAC;YACxE,aAAa,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,uCAAuC,CAAC;YACpD,OAAO,EAAE,CAAC;iBACP,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CACP,kGAAkG,CACnG;SACJ;QACD,YAAY,EAAE,iBAAiB;KAChC,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE;QACxD,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1C,IAAI,IAAI;YAAE,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,IAAI;YAAE,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE9C,MAAM,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzB,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAEtC,uEAAuE;QACvE,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhE,OAAO,iBAAiB,CACtB,IAAI,EACJ,SAAS,EACT,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,OAAO,KAAK,KAAK,CAClB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFindTool(server: McpServer): void;
+//# sourceMappingURL=find.d.ts.map

package/dist/tools/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/tools/find.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAiFjD"}

package/dist/tools/find.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS } from "@paretools/shared";
+import { fdCmd } from "../lib/search-runner.js";
+import { parseFdOutput } from "../lib/parsers.js";
+import { formatFind, compactFindMap, formatFindCompact } from "../lib/formatters.js";
+import { FindResultSchema } from "../schemas/index.js";
+export function registerFindTool(server) {
+    server.registerTool("find", {
+        title: "Find Files",
+        description: "Finds files and directories using fd with structured output. Returns file paths, names, and extensions. Use instead of running `fd` or `find` in the terminal.",
+        inputSchema: {
+            pattern: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .optional()
+                .describe("Regex pattern to match file/directory names"),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Directory to search in (default: cwd)"),
+            type: z
+                .enum(["file", "directory", "symlink"])
+                .optional()
+                .describe("Filter by entry type: file, directory, or symlink"),
+            extension: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("Filter by file extension (e.g., 'ts', 'js')"),
+            maxResults: z
+                .number()
+                .optional()
+                .default(1000)
+                .describe("Maximum number of results to return (default: 1000)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+        },
+        outputSchema: FindResultSchema,
+    }, async ({ pattern, path, type, extension, maxResults, compact }) => {
+        if (pattern)
+            assertNoFlagInjection(pattern, "pattern");
+        if (path)
+            assertNoFlagInjection(path, "path");
+        if (extension)
+            assertNoFlagInjection(extension, "extension");
+        const cwd = path || process.cwd();
+        const args = ["--color", "never"];
+        if (type) {
+            const typeMap = { file: "f", directory: "d", symlink: "l" };
+            args.push("--type", typeMap[type]);
+        }
+        if (extension) {
+            args.push("--extension", extension);
+        }
+        if (maxResults) {
+            args.push("--max-results", String(maxResults));
+        }
+        if (pattern) {
+            args.push(pattern);
+        }
+        const result = await fdCmd(args, cwd);
+        const data = parseFdOutput(result.stdout, maxResults ?? 1000);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatFind, compactFindMap, formatFindCompact, compact === false);
+    });
+}
+//# sourceMappingURL=find.js.map

package/dist/tools/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../src/tools/find.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAKjD"}

package/dist/tools/index.js

@@ -0,0 +1,14 @@
+import { shouldRegisterTool } from "@paretools/shared";
+import { registerSearchTool } from "./search.js";
+import { registerFindTool } from "./find.js";
+import { registerCountTool } from "./count.js";
+export function registerAllTools(server) {
+    const s = (name) => shouldRegisterTool("search", name);
+    if (s("search"))
+        registerSearchTool(server);
+    if (s("find"))
+        registerFindTool(server);
+    if (s("count"))
+        registerCountTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC,QAAQ,CAAC;QAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,CAAC;QAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC,OAAO,CAAC;QAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchTool(server: McpServer): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA8EnD"}

package/dist/tools/search.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS } from "@paretools/shared";
+import { rgCmd } from "../lib/search-runner.js";
+import { parseRgJsonOutput } from "../lib/parsers.js";
+import { formatSearch, compactSearchMap, formatSearchCompact } from "../lib/formatters.js";
+import { SearchResultSchema } from "../schemas/index.js";
+export function registerSearchTool(server) {
+    server.registerTool("search", {
+        title: "Code Search",
+        description: "Searches file contents using ripgrep with structured JSON output. Returns match locations with file, line, column, matched text, and line content. Use instead of running `rg` or `grep` in the terminal.",
+        inputSchema: {
+            pattern: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("Regular expression pattern to search for"),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Directory or file to search in (default: cwd)"),
+            glob: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("Glob pattern to filter files (e.g., '*.ts', '*.{js,jsx}')"),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Case-sensitive search (default: true)"),
+            maxResults: z
+                .number()
+                .optional()
+                .default(1000)
+                .describe("Maximum number of matches to return (default: 1000)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+        },
+        outputSchema: SearchResultSchema,
+    }, async ({ pattern, path, glob, caseSensitive, maxResults, compact }) => {
+        assertNoFlagInjection(pattern, "pattern");
+        if (path)
+            assertNoFlagInjection(path, "path");
+        if (glob)
+            assertNoFlagInjection(glob, "glob");
+        const cwd = path || process.cwd();
+        const args = ["--json"];
+        if (!caseSensitive) {
+            args.push("--ignore-case");
+        }
+        if (glob) {
+            args.push("--glob", glob);
+        }
+        args.push(pattern);
+        // When path is provided, pass it as the search path argument to rg
+        // (not as cwd, since cwd is already set to it for relative paths)
+        const result = await rgCmd(args, cwd);
+        // rg exits with code 1 when no matches are found — that's not an error
+        const data = parseRgJsonOutput(result.stdout, maxResults ?? 1000);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatSearch, compactSearchMap, formatSearchCompact, compact === false);
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@paretools/search",
+  "version": "0.7.0",
+  "mcpName": "io.github.Dave-London/search",
+  "description": "MCP server for code search (ripgrep + fd) with structured, token-efficient output",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "structured-output",
+    "ai",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "copilot",
+    "token-efficient",
+    "devtools",
+    "cli",
+    "ripgrep",
+    "rg",
+    "fd",
+    "search",
+    "find",
+    "grep"
+  ],
+  "homepage": "https://github.com/Dave-London/Pare/tree/main/packages/server-search",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "bin": {
+    "pare-search": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Dave-London/Pare.git",
+    "directory": "packages/server-search"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6",
+    "@paretools/shared": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18",
+    "@paretools/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/"
+  }
+}