@jait/gateway 0.1.0

package/dist/tools/core/jait.js

@@ -0,0 +1,256 @@
+/**
+ * jait — Platform meta-tool for Jait-specific capabilities.
+ *
+ * Combines: memory management, cron/scheduler, network scanning,
+ * and gateway status into a single tool with an `action` dispatcher.
+ *
+ * This keeps the core tool count at 8 while still exposing
+ * platform-specific features that don't fit the generic tools.
+ */
+export function createJaitTool(deps) {
+    return {
+        name: "jait",
+        description: "Jait platform tool — access memory, scheduler, network, and gateway status.\n\n" +
+            "**Actions:**\n" +
+            "- `memory.save` — Save a memory entry for later retrieval. Provide `content`, `scope` (workspace/project/contact), " +
+            "`sourceType`, `sourceId`.\n" +
+            "- `memory.search` — Search saved memories using semantic similarity. Provide `query`, optional `limit` and `scope`.\n" +
+            "- `memory.forget` — Delete a memory by ID. Provide `memoryId`.\n" +
+            "- `cron.add` — Add a scheduled cron job. Provide `name`, `cron` (cron expression), `toolName`, optional `input`.\n" +
+            "- `cron.list` — List all configured cron jobs.\n" +
+            "- `cron.update` — Update a cron job. Provide `jobId`, plus any fields to change (`name`, `cron`, `enabled`, `input`).\n" +
+            "- `cron.remove` — Remove a cron job. Provide `jobId`.\n" +
+            "- `status` — Get gateway runtime health: uptime, sessions, surfaces, connected devices, scheduler stats.",
+        tier: "core",
+        category: "gateway",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    description: "The action to perform: memory.save, memory.search, memory.forget, " +
+                        "cron.add, cron.list, cron.update, cron.remove, status.",
+                    enum: [
+                        "memory.save", "memory.search", "memory.forget",
+                        "cron.add", "cron.list", "cron.update", "cron.remove",
+                        "status",
+                    ],
+                },
+                // Memory params
+                content: {
+                    type: "string",
+                    description: "Memory content to save (for memory.save).",
+                },
+                scope: {
+                    type: "string",
+                    description: 'Memory scope: "workspace", "project", or "contact" (for memory.save/search).',
+                    enum: ["workspace", "project", "contact"],
+                },
+                query: {
+                    type: "string",
+                    description: "Search query (for memory.search).",
+                },
+                memoryId: {
+                    type: "string",
+                    description: "Memory ID to forget (for memory.forget).",
+                },
+                sourceType: {
+                    type: "string",
+                    description: "Source type (for memory.save).",
+                },
+                sourceId: {
+                    type: "string",
+                    description: "Source ID (for memory.save).",
+                },
+                ttlSeconds: {
+                    type: "number",
+                    description: "TTL in seconds for memory expiry (for memory.save).",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (for memory.search, default: 5).",
+                },
+                // Cron params
+                name: {
+                    type: "string",
+                    description: "Cron job name (for cron.add).",
+                },
+                cron: {
+                    type: "string",
+                    description: 'Cron expression (for cron.add/update). E.g. "0 9 * * *" for daily at 9am.',
+                },
+                toolName: {
+                    type: "string",
+                    description: "Tool name to execute on schedule (for cron.add).",
+                },
+                input: {
+                    type: "object",
+                    description: "Tool input arguments (for cron.add/update).",
+                },
+                jobId: {
+                    type: "string",
+                    description: "Cron job ID (for cron.update/remove).",
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "Enable/disable toggle (for cron.update).",
+                },
+            },
+            required: ["action"],
+        },
+        async execute(input, context) {
+            try {
+                switch (input.action) {
+                    // ── Memory ──────────────────────────────────────────────
+                    case "memory.save": {
+                        if (!deps.memoryService) {
+                            return { ok: false, message: "Memory service not available." };
+                        }
+                        if (!input.content) {
+                            return { ok: false, message: "memory.save requires `content`." };
+                        }
+                        const expiresAt = input.ttlSeconds
+                            ? new Date(Date.now() + input.ttlSeconds * 1000).toISOString()
+                            : undefined;
+                        const entry = await deps.memoryService.save({
+                            scope: input.scope ?? "workspace",
+                            content: input.content,
+                            source: {
+                                type: input.sourceType ?? "agent",
+                                id: input.sourceId ?? context.actionId,
+                                surface: "chat",
+                            },
+                            expiresAt,
+                        });
+                        return { ok: true, message: `Saved memory ${entry.id}`, data: entry };
+                    }
+                    case "memory.search": {
+                        if (!deps.memoryService) {
+                            return { ok: false, message: "Memory service not available." };
+                        }
+                        if (!input.query) {
+                            return { ok: false, message: "memory.search requires `query`." };
+                        }
+                        const results = await deps.memoryService.search(input.query, input.limit ?? 5, input.scope);
+                        return { ok: true, message: `Found ${results.length} memories`, data: results };
+                    }
+                    case "memory.forget": {
+                        if (!deps.memoryService) {
+                            return { ok: false, message: "Memory service not available." };
+                        }
+                        if (!input.memoryId) {
+                            return { ok: false, message: "memory.forget requires `memoryId`." };
+                        }
+                        const removed = await deps.memoryService.forget(input.memoryId);
+                        return {
+                            ok: removed,
+                            message: removed ? `Forgot memory ${input.memoryId}` : `Memory ${input.memoryId} not found`,
+                        };
+                    }
+                    // ── Cron ────────────────────────────────────────────────
+                    case "cron.add": {
+                        if (!deps.scheduler) {
+                            return { ok: false, message: "Scheduler not available." };
+                        }
+                        if (!input.name || !input.cron || !input.toolName) {
+                            return { ok: false, message: "cron.add requires `name`, `cron`, and `toolName`." };
+                        }
+                        // Normalize tool name (underscore → dot)
+                        const toolNameNormalized = input.toolName.includes("_") && !input.toolName.includes(".")
+                            ? input.toolName.replace("_", ".")
+                            : input.toolName;
+                        const job = deps.scheduler.create({
+                            userId: context.userId,
+                            name: input.name,
+                            cron: input.cron,
+                            toolName: toolNameNormalized,
+                            input: input.input ?? {},
+                            sessionId: context.sessionId,
+                            workspaceRoot: process.cwd(),
+                        });
+                        return { ok: true, message: "Cron job created", data: job };
+                    }
+                    case "cron.list": {
+                        if (!deps.scheduler) {
+                            return { ok: false, message: "Scheduler not available." };
+                        }
+                        const jobs = deps.scheduler.list(context.userId);
+                        return { ok: true, message: `${jobs.length} cron jobs`, data: { jobs } };
+                    }
+                    case "cron.update": {
+                        if (!deps.scheduler) {
+                            return { ok: false, message: "Scheduler not available." };
+                        }
+                        if (!input.jobId) {
+                            return { ok: false, message: "cron.update requires `jobId`." };
+                        }
+                        const updated = deps.scheduler.update(input.jobId, {
+                            name: input.name,
+                            cron: input.cron,
+                            enabled: input.enabled,
+                            input: input.input,
+                        }, context.userId);
+                        return {
+                            ok: !!updated,
+                            message: updated ? "Cron job updated" : "Cron job not found",
+                            data: updated ?? { id: input.jobId },
+                        };
+                    }
+                    case "cron.remove": {
+                        if (!deps.scheduler) {
+                            return { ok: false, message: "Scheduler not available." };
+                        }
+                        if (!input.jobId) {
+                            return { ok: false, message: "cron.remove requires `jobId`." };
+                        }
+                        const removed = deps.scheduler.remove(input.jobId, context.userId);
+                        return {
+                            ok: removed,
+                            message: removed ? "Cron job removed" : "Cron job not found",
+                        };
+                    }
+                    // ── Gateway status ──────────────────────────────────────
+                    case "status": {
+                        const sessions = deps.sessionService?.list("active").length ?? 0;
+                        const surfaces = deps.surfaceRegistry?.listSurfaces().length ?? 0;
+                        const devices = deps.ws?.clientCount ?? 0;
+                        const jobs = deps.scheduler?.list() ?? [];
+                        const enabledJobs = jobs.filter((j) => j.enabled).length;
+                        const hookEventTypes = deps.hooks?.registeredEventTypes() ?? [];
+                        return {
+                            ok: true,
+                            message: "Gateway status",
+                            data: {
+                                healthy: true,
+                                uptime: Math.floor((Date.now() - (deps.startedAt ?? Date.now())) / 1000),
+                                sessions,
+                                surfaces,
+                                devices,
+                                scheduler: { totalJobs: jobs.length, enabledJobs },
+                                hooks: {
+                                    registeredEventTypes: hookEventTypes,
+                                    listeners: deps.hooks?.listenerCount() ?? 0,
+                                },
+                            },
+                        };
+                    }
+                    default:
+                        return {
+                            ok: false,
+                            message: `Unknown action: "${input.action}". ` +
+                                "Valid actions: memory.save, memory.search, memory.forget, " +
+                                "cron.add, cron.list, cron.update, cron.remove, status.",
+                        };
+                }
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    message: err instanceof Error ? err.message : "Jait tool failed",
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=jait.js.map

package/dist/tools/core/jait.js.map

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

package/dist/tools/core/read.d.ts

@@ -0,0 +1,26 @@
+/**
+ * read — Read file contents or list directory entries.
+ *
+ * Inspired by VS Code Copilot's read_file + list_dir, unified into one tool.
+ * Auto-detects whether the path is a file or directory.
+ *
+ * Key design decisions (learned from Copilot):
+ * - Hard cap at MAX_LINES_PER_READ to prevent context blowup
+ * - Truncation notice when file exceeds limit
+ * - Guidance to "prefer reading larger ranges over many small reads"
+ * - Line numbers in output for easy reference
+ * - Directory entries show trailing `/` for folders (like Copilot list_dir)
+ */
+import type { ToolDefinition } from "../contracts.js";
+import type { SurfaceRegistry } from "../../surfaces/registry.js";
+interface ReadInput {
+    /** File or directory path (relative to workspace root, or absolute) */
+    path: string;
+    /** Start line (1-based, optional — for reading a range of a file) */
+    startLine?: number;
+    /** End line (1-based inclusive, optional) */
+    endLine?: number;
+}
+export declare function createReadTool(registry: SurfaceRegistry): ToolDefinition<ReadInput>;
+export {};
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/core/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tools/core/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,UAAU,SAAS;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,CAuGnF"}

package/dist/tools/core/read.js

@@ -0,0 +1,118 @@
+/**
+ * read — Read file contents or list directory entries.
+ *
+ * Inspired by VS Code Copilot's read_file + list_dir, unified into one tool.
+ * Auto-detects whether the path is a file or directory.
+ *
+ * Key design decisions (learned from Copilot):
+ * - Hard cap at MAX_LINES_PER_READ to prevent context blowup
+ * - Truncation notice when file exceeds limit
+ * - Guidance to "prefer reading larger ranges over many small reads"
+ * - Line numbers in output for easy reference
+ * - Directory entries show trailing `/` for folders (like Copilot list_dir)
+ */
+import { getFs } from "./get-fs.js";
+/** Hard cap on lines returned in a single read (matches Copilot's limit). */
+const MAX_LINES_PER_READ = 2000;
+export function createReadTool(registry) {
+    return {
+        name: "read",
+        description: "Read the contents of a file, or list a directory.\n\n" +
+            "If the path points to a file, returns its content (optionally a specific line range). " +
+            "If the path points to a directory, returns the list of entries (names ending in `/` are folders).\n\n" +
+            "You must specify the line range you're interested in for large files. Line numbers are 1-indexed. " +
+            "This tool truncates output at " + MAX_LINES_PER_READ + " lines — call it again with an offset to read " +
+            "more. Prefer reading larger ranges over doing many small reads.\n\n" +
+            "Use this to understand code, check configs, explore project structure, or verify changes you made.",
+        tier: "core",
+        category: "filesystem",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The file or directory path (relative to workspace root, or absolute).",
+                },
+                startLine: {
+                    type: "number",
+                    description: "The 1-based line number to start reading from. Omit to start from the beginning.",
+                },
+                endLine: {
+                    type: "number",
+                    description: "The 1-based inclusive line number to stop reading at. Omit to read to the end (capped at " + MAX_LINES_PER_READ + " lines).",
+                },
+            },
+            required: ["path"],
+        },
+        async execute(input, context) {
+            try {
+                const fs = await getFs(registry, context, input.path);
+                // ── Directory path → list entries ──────────────────────────
+                let isDir = false;
+                try {
+                    const info = await fs.statFile(input.path);
+                    isDir = info.isDirectory;
+                }
+                catch {
+                    // stat failed — try reading as file (will throw its own error)
+                }
+                if (isDir) {
+                    const entries = await fs.list(input.path);
+                    // Append / to directory names (Copilot list_dir convention)
+                    const formatted = entries.map((e) => {
+                        if (typeof e === "string")
+                            return e;
+                        if (e.name && e.isDirectory)
+                            return e.name + "/";
+                        if (e.name)
+                            return e.name;
+                        return String(e);
+                    });
+                    return {
+                        ok: true,
+                        message: `Directory ${input.path} — ${formatted.length} entries`,
+                        data: { path: input.path, type: "directory", entries: formatted },
+                    };
+                }
+                // ── File path → read contents ──────────────────────────────
+                const content = await fs.read(input.path);
+                const allLines = content.split("\n");
+                const totalLines = allLines.length;
+                // Compute effective range
+                const start = Math.max(1, input.startLine ?? 1) - 1; // 0-indexed
+                const requestedEnd = input.endLine ?? totalLines;
+                const cappedEnd = Math.min(totalLines, start + MAX_LINES_PER_READ, requestedEnd);
+                const slice = allLines.slice(start, cappedEnd);
+                const truncated = cappedEnd < totalLines && !input.endLine;
+                // Build line-numbered content
+                const numbered = slice
+                    .map((line, i) => `${start + i + 1}\t${line}`)
+                    .join("\n");
+                const suffix = truncated
+                    ? `\n\n[File content truncated. Showing lines ${start + 1}-${cappedEnd} of ${totalLines}. Use startLine/endLine to read more.]`
+                    : "";
+                return {
+                    ok: true,
+                    message: `${input.path} — lines ${start + 1}-${cappedEnd} of ${totalLines}`,
+                    data: {
+                        path: input.path,
+                        type: "file",
+                        content: numbered + suffix,
+                        totalLines,
+                        startLine: start + 1,
+                        endLine: cappedEnd,
+                        truncated,
+                    },
+                };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    message: err instanceof Error ? err.message : "Read failed",
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/core/read.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * search — Search files in the workspace by content or name.
+ *
+ * Inspired by VS Code Copilot's grep_search + file_search:
+ * - `isRegexp` flag for explicit regex vs literal mode
+ * - Auto-retry with opposite mode if no results found
+ * - `includeIgnoredFiles` to search in gitignored dirs (node_modules, etc.)
+ * - Hard cap on max results (200)
+ * - Rich description with regex alternation tips
+ * - Timeout protection (20s)
+ */
+import type { ToolDefinition } from "../contracts.js";
+import type { SurfaceRegistry } from "../../surfaces/registry.js";
+interface SearchInput {
+    /** The search pattern (text or regex) */
+    pattern: string;
+    /** Whether the pattern is a regex (default: false = literal text search) */
+    isRegexp?: boolean;
+    /** Directory to search in (defaults to workspace root) */
+    path?: string;
+    /** Search mode: "content" (grep) or "files" (find by name). Default: "content" */
+    mode?: string;
+    /** Include file glob pattern (e.g. "*.ts", "src/**"). Default: all files */
+    include?: string;
+    /** Maximum number of results (default: 20, max: 200) */
+    limit?: number;
+    /** Whether to include files normally ignored by .gitignore (default: false).
+     *  Warning: this may be slower. Only set when you need to search in
+     *  node_modules, build outputs, or other ignored directories. */
+    includeIgnoredFiles?: boolean;
+}
+export declare function createSearchTool(registry: SurfaceRegistry): ToolDefinition<SearchInput>;
+export {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/core/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAelE,UAAU,WAAW;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;qEAEiE;IACjE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CAwGvF"}

package/dist/tools/core/search.js

@@ -0,0 +1,187 @@
+/**
+ * search — Search files in the workspace by content or name.
+ *
+ * Inspired by VS Code Copilot's grep_search + file_search:
+ * - `isRegexp` flag for explicit regex vs literal mode
+ * - Auto-retry with opposite mode if no results found
+ * - `includeIgnoredFiles` to search in gitignored dirs (node_modules, etc.)
+ * - Hard cap on max results (200)
+ * - Rich description with regex alternation tips
+ * - Timeout protection (20s)
+ */
+import { resolveWorkspaceRoot } from "./get-fs.js";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { platform } from "node:os";
+const execAsync = promisify(exec);
+/** Absolute maximum results to prevent context blowup. */
+const MAX_RESULTS_CAP = 200;
+/** Default number of results when not specified. */
+const DEFAULT_MAX_RESULTS = 20;
+/** Search timeout in ms. */
+const SEARCH_TIMEOUT = 20_000;
+export function createSearchTool(registry) {
+    return {
+        name: "search",
+        description: "Search for files or text in the workspace.\n\n" +
+            '**Content search** (default, mode="content"): Fast text/regex search through file contents. ' +
+            "Returns matching lines with file paths and line numbers. " +
+            "Use `isRegexp: true` when searching with regex patterns. " +
+            "If you are not sure what words will appear in the workspace, prefer using regex patterns with " +
+            'alternation (|) or character classes to search for multiple potential words at once instead of ' +
+            "making separate searches. For example, use `function|method|procedure` to find all of those " +
+            "at once. Use `include` to search within files matching a specific glob (e.g. \"*.ts\", \"src/**\").\n\n" +
+            '**File search** (mode="files"): Find files by name pattern (plain substring, not globs). ' +
+            "For example, use `readme` not `*readme*`. Returns only file paths.\n\n" +
+            "Use `includeIgnoredFiles: true` to search in normally-ignored directories like node_modules " +
+            "or build outputs — but be aware this may be slower.\n\n" +
+            "Use this tool when you want to see an overview of a file, instead of calling read many times.",
+        tier: "core",
+        category: "filesystem",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                pattern: {
+                    type: "string",
+                    description: "The pattern to search for. Use regex with alternation (e.g. 'word1|word2') or character " +
+                        "classes to find multiple words in a single search. Set `isRegexp` appropriately.",
+                },
+                isRegexp: {
+                    type: "boolean",
+                    description: "Whether the pattern is a regex (default: false). Search is case-insensitive by default.",
+                },
+                path: {
+                    type: "string",
+                    description: "Directory to search in (defaults to workspace root).",
+                },
+                mode: {
+                    type: "string",
+                    description: '"content" (grep, default) or "files" (find by name).',
+                    enum: ["content", "files"],
+                },
+                include: {
+                    type: "string",
+                    description: 'File glob to filter results (e.g. "*.ts", "src/**/*.py"). ' +
+                        "Applied to paths relative to the search directory.",
+                },
+                limit: {
+                    type: "number",
+                    description: `Maximum number of results (default: ${DEFAULT_MAX_RESULTS}, max: ${MAX_RESULTS_CAP}). ` +
+                        "Don't set this unless necessary — it can slow things down.",
+                },
+                includeIgnoredFiles: {
+                    type: "boolean",
+                    description: "Whether to include files normally ignored by .gitignore and search.exclude settings. " +
+                        "Warning: may be slower. Only set when searching in node_modules or build outputs.",
+                },
+            },
+            required: ["pattern"],
+        },
+        async execute(input, context) {
+            const effectiveRoot = resolveWorkspaceRoot(registry, context.sessionId);
+            const searchDir = input.path || effectiveRoot;
+            const limit = Math.min(input.limit ?? DEFAULT_MAX_RESULTS, MAX_RESULTS_CAP);
+            const mode = input.mode ?? "content";
+            try {
+                if (mode === "files") {
+                    return await searchFiles(searchDir, input.pattern, limit);
+                }
+                // Try content search with the given regex mode
+                const result = await searchContent(searchDir, input.pattern, input.include, limit, input.isRegexp ?? false, input.includeIgnoredFiles ?? false);
+                // Auto-retry with opposite mode if no results (Copilot pattern)
+                if (result.ok && result.data?.matches?.length === 0) {
+                    const retryResult = await searchContent(searchDir, input.pattern, input.include, limit, !(input.isRegexp ?? false), input.includeIgnoredFiles ?? false);
+                    if (retryResult.data?.matches?.length > 0) {
+                        return {
+                            ...retryResult,
+                            message: retryResult.message + ` (retried as ${!(input.isRegexp ?? false) ? "regex" : "literal"})`,
+                        };
+                    }
+                }
+                return result;
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    message: err instanceof Error ? err.message : "Search failed",
+                };
+            }
+        },
+    };
+}
+async function searchContent(dir, pattern, include, limit, isRegexp, includeIgnored) {
+    const isWin = platform() === "win32";
+    // Escape pattern for shell safety
+    const safePattern = pattern.replace(/"/g, '\\"');
+    const safeDir = dir.replace(/"/g, '\\"');
+    let cmd;
+    if (isWin) {
+        // Prefer ripgrep (fast, handles .gitignore)
+        const regexpFlag = isRegexp ? "" : "--fixed-strings";
+        const includeArg = include ? `--glob "${include}"` : "";
+        const ignoreArg = includeIgnored ? "--no-ignore" : "";
+        cmd = `rg --no-heading --line-number --max-count ${limit} --ignore-case ${regexpFlag} ${includeArg} ${ignoreArg} -- "${safePattern}" "${safeDir}" 2>nul`;
+        // Fallback to findstr if rg not installed
+        cmd += ` || findstr /s /n /i /c:"${safePattern}" "${safeDir}\\${include || "*"}" 2>nul`;
+    }
+    else {
+        const regexpFlag = isRegexp ? "" : "--fixed-strings";
+        const includeArg = include ? `--glob "${include}"` : "";
+        const ignoreArg = includeIgnored ? "--no-ignore" : "";
+        cmd = `rg --no-heading --line-number --max-count ${limit} --ignore-case ${regexpFlag} ${includeArg} ${ignoreArg} -- "${safePattern}" "${safeDir}" 2>/dev/null`;
+        // Fallback to grep
+        const grepInclude = include ? `--include="${include}"` : "";
+        const grepRegexp = isRegexp ? "-E" : "-F";
+        cmd += ` || grep -rn -i ${grepRegexp} --max-count=${limit} ${grepInclude} -- "${safePattern}" "${safeDir}" 2>/dev/null`;
+    }
+    const { stdout } = await execAsync(cmd, { timeout: SEARCH_TIMEOUT, maxBuffer: 2 * 1024 * 1024 });
+    const lines = stdout.trim().split("\n").filter(Boolean).slice(0, limit);
+    if (lines.length === 0) {
+        return { ok: true, message: `No matches for "${pattern}"`, data: { matches: [] } };
+    }
+    const matches = lines.map((line) => {
+        // Parse "file:line:content" format
+        const m = line.match(/^(.+?):(\d+):(.*)$/);
+        if (m) {
+            return { file: m[1], line: parseInt(m[2], 10), content: m[3].trim() };
+        }
+        return { file: "", line: 0, content: line.trim() };
+    });
+    return {
+        ok: true,
+        message: `Found ${matches.length} match${matches.length === 1 ? "" : "es"} for "${pattern}"`,
+        data: { pattern, matches },
+    };
+}
+async function searchFiles(dir, pattern, limit) {
+    const isWin = platform() === "win32";
+    const safeDir = dir.replace(/"/g, '\\"');
+    // Strip glob wildcards — the LLM sometimes passes "*readme*" instead of "readme".
+    // findstr and rg treat * as regex (0+ of prev char), which breaks matching.
+    const cleanedPattern = pattern.replace(/[*?[\]]/g, "");
+    if (!cleanedPattern) {
+        return { ok: true, message: `No files matching "${pattern}" (empty after cleaning)`, data: { files: [] } };
+    }
+    const safePattern = cleanedPattern.replace(/"/g, '\\"');
+    let cmd;
+    if (isWin) {
+        // Try ripgrep (respects .gitignore) then fall back to dir+findstr.
+        // The `|| (...)` ensures the fallback runs when rg is not installed.
+        cmd = `(rg --files "${safeDir}" 2>nul | findstr /i "${safePattern}") || (dir /s /b "${safeDir}" 2>nul | findstr /i "${safePattern}")`;
+    }
+    else {
+        cmd = `find "${safeDir}" -type f -iname "*${safePattern}*" 2>/dev/null | head -n ${limit}`;
+    }
+    const { stdout } = await execAsync(cmd, { timeout: SEARCH_TIMEOUT, maxBuffer: 2 * 1024 * 1024 });
+    const files = stdout.trim().split("\n").filter(Boolean).slice(0, limit);
+    if (files.length === 0) {
+        return { ok: true, message: `No files matching "${pattern}"`, data: { files: [] } };
+    }
+    return {
+        ok: true,
+        message: `Found ${files.length} file${files.length === 1 ? "" : "s"} matching "${pattern}"`,
+        data: { pattern, files },
+    };
+}
+//# sourceMappingURL=search.js.map