@luckydraw/cumulus 0.27.41 → 0.28.1

package/dist/lib/provider.js

@@ -0,0 +1,90 @@
+/**
+ * LLM Provider abstraction.
+ *
+ * Normalizes the interface across different LLM APIs so the agentic loop
+ * doesn't care who generates the response.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+// ─── Anthropic Provider ──────────────────────────────────────────────────────
+const DEFAULT_MAX_TOKENS = 16384;
+const MAX_RETRIES = 3;
+const RETRY_DELAYS = [1000, 2000, 4000]; // exponential backoff
+export class AnthropicProvider {
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey || process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    async chat(options) {
+        const { model, system, messages, tools, maxTokens, onEvent, signal } = options;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                return await this._streamChat(model, system, messages, tools, maxTokens, onEvent, signal);
+            }
+            catch (err) {
+                const status = err.status;
+                const isRetryable = status === 429 || status === 529 || status === 500;
+                const isOversize = status === 413;
+                if (isOversize) {
+                    // Context too large — caller should trim messages and retry
+                    throw Object.assign(new Error('Context too large (413)'), { status: 413 });
+                }
+                if (isRetryable && attempt < MAX_RETRIES) {
+                    const delay = RETRY_DELAYS[attempt] || 4000;
+                    console.warn(`[AnthropicProvider] ${status} error, retrying in ${delay}ms (attempt ${attempt + 1}/${MAX_RETRIES})`);
+                    await sleep(delay);
+                    continue;
+                }
+                throw err;
+            }
+        }
+        // Should not reach here
+        throw new Error('Max retries exceeded');
+    }
+    async _streamChat(model, system, messages, tools, maxTokens, onEvent, signal) {
+        const stream = this.client.messages.stream({
+            model,
+            max_tokens: maxTokens || DEFAULT_MAX_TOKENS,
+            system: system,
+            messages,
+            tools: tools.length > 0 ? tools : undefined,
+        }, signal ? { signal } : undefined);
+        stream.on('text', (text) => {
+            onEvent?.({ type: 'text', text });
+        });
+        stream.on('contentBlock', (block) => {
+            if (block.type === 'tool_use') {
+                const toolCall = {
+                    id: block.id,
+                    name: block.name,
+                    input: block.input,
+                };
+                onEvent?.({ type: 'tool_use_complete', toolCall });
+            }
+        });
+        const finalMessage = await stream.finalMessage();
+        const usage = {
+            input_tokens: finalMessage.usage.input_tokens,
+            output_tokens: finalMessage.usage.output_tokens,
+            cache_read_input_tokens: finalMessage.usage
+                .cache_read_input_tokens,
+            cache_creation_input_tokens: finalMessage.usage
+                .cache_creation_input_tokens,
+        };
+        onEvent?.({
+            type: 'done',
+            stopReason: finalMessage.stop_reason || 'end_turn',
+            usage,
+        });
+        return {
+            content: finalMessage.content,
+            stopReason: finalMessage.stop_reason || 'end_turn',
+            usage,
+        };
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=provider.js.map

package/dist/lib/provider.js.map

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

package/dist/lib/tools/ask-user-question.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AskUserQuestion tool — pauses the agentic loop to ask the user a question.
+ *
+ * This tool is intercepted by the agentic loop before execution. When the LLM
+ * calls it, the loop yields a `needsInput` result instead of executing the tool
+ * locally. The caller (gateway) sends the question to the user, waits for a
+ * response, then resumes the loop with the user's answer as the tool_result.
+ *
+ * Renders as blex:poll (multiple options) or blex:confirm (yes/no) in webchat.
+ */
+import type { Tool } from './index.js';
+export declare const ASK_USER_QUESTION_TOOL = "AskUserQuestion";
+export declare const askUserQuestionTool: Tool;
+//# sourceMappingURL=ask-user-question.d.ts.map

package/dist/lib/tools/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/ask-user-question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,eAAO,MAAM,mBAAmB,EAAE,IAkEjC,CAAC"}

package/dist/lib/tools/ask-user-question.js

@@ -0,0 +1,74 @@
+/**
+ * AskUserQuestion tool — pauses the agentic loop to ask the user a question.
+ *
+ * This tool is intercepted by the agentic loop before execution. When the LLM
+ * calls it, the loop yields a `needsInput` result instead of executing the tool
+ * locally. The caller (gateway) sends the question to the user, waits for a
+ * response, then resumes the loop with the user's answer as the tool_result.
+ *
+ * Renders as blex:poll (multiple options) or blex:confirm (yes/no) in webchat.
+ */
+export const ASK_USER_QUESTION_TOOL = 'AskUserQuestion';
+export const askUserQuestionTool = {
+    definition: {
+        name: ASK_USER_QUESTION_TOOL,
+        description: 'Ask the user one or more questions and wait for their response. Use this when you need ' +
+            'clarification, confirmation, or choices from the user before proceeding. ' +
+            'The agentic loop pauses until the user responds.\n\n' +
+            'For a SINGLE question: provide `question` + optional `options`.\n' +
+            'For MULTIPLE questions: provide `questions` array (renders as a multi-question carousel).\n' +
+            'If no options are provided and allowFreeform is false, it becomes a yes/no confirm.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The question to ask the user (for single-question mode).',
+                },
+                options: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional list of choices for a single question. ' +
+                        'If omitted and allowFreeform is false, renders as a yes/no confirmation.',
+                },
+                allowFreeform: {
+                    type: 'boolean',
+                    description: 'If true, the user can type a free-text answer in addition to (or instead of) picking an option. ' +
+                        'Default: false.',
+                },
+                questions: {
+                    type: 'array',
+                    description: 'For multi-question carousels. Each item has question, options, and optional multiSelect/writeIn. ' +
+                        'When provided, `question` and `options` are ignored.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            question: { type: 'string', description: 'The question text.' },
+                            options: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Choices for this question.',
+                            },
+                            multiSelect: {
+                                type: 'boolean',
+                                description: 'Allow selecting multiple options. Default: false.',
+                            },
+                            writeIn: {
+                                type: 'boolean',
+                                description: 'Allow a free-text write-in answer. Default: false.',
+                            },
+                        },
+                        required: ['question', 'options'],
+                    },
+                },
+            },
+            required: [],
+        },
+    },
+    // This executor should never actually run — the agentic loop intercepts this
+    // tool before execution. If it somehow executes, return a sensible fallback.
+    async execute(input, _cwd) {
+        return `[AskUserQuestion was not intercepted by the loop. Question: ${input.question}]`;
+    },
+};
+//# sourceMappingURL=ask-user-question.js.map

package/dist/lib/tools/ask-user-question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.js","sourceRoot":"","sources":["../../../src/lib/tools/ask-user-question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,UAAU,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,yFAAyF;YACzF,2EAA2E;YAC3E,sDAAsD;YACtD,mEAAmE;YACnE,6FAA6F;YAC7F,qFAAqF;QACvF,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,kDAAkD;wBAClD,0EAA0E;iBAC7E;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,kGAAkG;wBAClG,iBAAiB;iBACpB;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,mGAAmG;wBACnG,sDAAsD;oBACxD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;4BAC/D,OAAO,EAAE;gCACP,IAAI,EAAE,OAAO;gCACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACzB,WAAW,EAAE,4BAA4B;6BAC1C;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,mDAAmD;6BACjE;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,oDAAoD;6BAClE;yBACF;wBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;qBAClC;iBACF;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,6EAA6E;IAC7E,6EAA6E;IAC7E,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,IAAY;QACxD,OAAO,+DAA+D,KAAK,CAAC,QAAQ,GAAG,CAAC;IAC1F,CAAC;CACF,CAAC"}

package/dist/lib/tools/bash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Bash tool — execute shell commands with timeout.
+ */
+import type { Tool } from './index.js';
+export declare const bashTool: Tool;
+//# sourceMappingURL=bash.d.ts.map

package/dist/lib/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/bash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,eAAO,MAAM,QAAQ,EAAE,IAqFtB,CAAC"}

package/dist/lib/tools/bash.js

@@ -0,0 +1,85 @@
+/**
+ * Bash tool — execute shell commands with timeout.
+ */
+import { spawn } from 'child_process';
+const DEFAULT_TIMEOUT = 120_000; // 2 minutes
+const MAX_TIMEOUT = 600_000; // 10 minutes
+const MAX_OUTPUT = 100_000; // 100KB output cap
+export const bashTool = {
+    definition: {
+        name: 'Bash',
+        description: 'Execute a shell command and return its output. ' +
+            'The working directory is the project directory. ' +
+            'Commands time out after 2 minutes by default (configurable up to 10 minutes).',
+        input_schema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'The bash command to execute',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Timeout in milliseconds (default: 120000, max: 600000)',
+                },
+            },
+            required: ['command'],
+        },
+    },
+    async execute(input, cwd) {
+        const command = input.command;
+        const timeout = Math.min(input.timeout || DEFAULT_TIMEOUT, MAX_TIMEOUT);
+        return new Promise(resolve => {
+            let stdout = '';
+            let stderr = '';
+            let killed = false;
+            const proc = spawn('bash', ['-c', command], {
+                cwd,
+                env: { ...process.env, TERM: 'dumb' },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            const timer = setTimeout(() => {
+                killed = true;
+                proc.kill('SIGTERM');
+                setTimeout(() => proc.kill('SIGKILL'), 5000);
+            }, timeout);
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+                if (stdout.length > MAX_OUTPUT) {
+                    stdout = stdout.slice(0, MAX_OUTPUT) + '\n\n[Output truncated at 100KB]';
+                    killed = true;
+                    proc.kill('SIGTERM');
+                }
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+                if (stderr.length > MAX_OUTPUT) {
+                    stderr = stderr.slice(0, MAX_OUTPUT);
+                }
+            });
+            proc.on('close', code => {
+                clearTimeout(timer);
+                let result = '';
+                if (stdout)
+                    result += stdout;
+                if (stderr) {
+                    if (result)
+                        result += '\n';
+                    result += `STDERR:\n${stderr}`;
+                }
+                if (killed) {
+                    result += `\n\n[Command timed out after ${timeout}ms]`;
+                }
+                else if (code !== 0 && code !== null) {
+                    result += `\nExit code: ${code}`;
+                }
+                resolve(result || `(no output, exit code ${code})`);
+            });
+            proc.on('error', err => {
+                clearTimeout(timer);
+                resolve(`Error executing command: ${err.message}`);
+            });
+        });
+    },
+};
+//# sourceMappingURL=bash.js.map

package/dist/lib/tools/bash.js.map

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

package/dist/lib/tools/edit.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Edit tool — exact string replacement in files.
+ */
+import type { Tool } from './index.js';
+export declare const editTool: Tool;
+//# sourceMappingURL=edit.d.ts.map

package/dist/lib/tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/edit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,QAAQ,EAAE,IA8EtB,CAAC"}

package/dist/lib/tools/edit.js

@@ -0,0 +1,79 @@
+/**
+ * Edit tool — exact string replacement in files.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export const editTool = {
+    definition: {
+        name: 'Edit',
+        description: 'Perform exact string replacements in files. The old_string must be unique in the file ' +
+            'unless replace_all is true. Use this for surgical edits — prefer over Write for modifying existing files.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute path to the file to modify',
+                },
+                old_string: {
+                    type: 'string',
+                    description: 'The exact text to find and replace',
+                },
+                new_string: {
+                    type: 'string',
+                    description: 'The replacement text',
+                },
+                replace_all: {
+                    type: 'boolean',
+                    description: 'If true, replace all occurrences. Default: false.',
+                },
+            },
+            required: ['file_path', 'old_string', 'new_string'],
+        },
+    },
+    async execute(input, cwd) {
+        const filePath = resolvePath(input.file_path, cwd);
+        const oldString = input.old_string;
+        const newString = input.new_string;
+        const replaceAll = input.replace_all || false;
+        if (!fs.existsSync(filePath)) {
+            return `Error: File not found: ${filePath}`;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        if (oldString === newString) {
+            return 'Error: old_string and new_string are identical';
+        }
+        if (!content.includes(oldString)) {
+            // Provide context: show similar lines
+            const lines = content.split('\n');
+            const needle = oldString.trim().split('\n')[0].trim();
+            const similar = lines
+                .filter(l => l.includes(needle.slice(0, 20)))
+                .slice(0, 3)
+                .map(l => `  ${l.trim()}`);
+            let msg = `Error: old_string not found in ${filePath}`;
+            if (similar.length > 0) {
+                msg += `\nSimilar lines found:\n${similar.join('\n')}`;
+            }
+            return msg;
+        }
+        if (!replaceAll) {
+            const count = content.split(oldString).length - 1;
+            if (count > 1) {
+                return `Error: old_string appears ${count} times in ${filePath}. Use replace_all: true to replace all, or provide more context to make old_string unique.`;
+            }
+        }
+        const updated = replaceAll
+            ? content.split(oldString).join(newString)
+            : content.replace(oldString, newString);
+        fs.writeFileSync(filePath, updated, 'utf-8');
+        const replacements = replaceAll ? content.split(oldString).length - 1 : 1;
+        return `Edited ${filePath}: ${replacements} replacement(s) made`;
+    },
+};
+function resolvePath(filePath, cwd) {
+    if (path.isAbsolute(filePath))
+        return filePath;
+    return path.resolve(cwd, filePath);
+}
+//# sourceMappingURL=edit.js.map

package/dist/lib/tools/edit.js.map

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

package/dist/lib/tools/glob.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Glob tool — find files by pattern.
+ */
+import type { Tool } from './index.js';
+export declare const globTool: Tool;
+//# sourceMappingURL=glob.d.ts.map

package/dist/lib/tools/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/glob.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,eAAO,MAAM,QAAQ,EAAE,IAqDtB,CAAC"}

package/dist/lib/tools/glob.js

@@ -0,0 +1,91 @@
+/**
+ * Glob tool — find files by pattern.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const MAX_RESULTS = 500;
+export const globTool = {
+    definition: {
+        name: 'Glob',
+        description: 'Find files matching a glob pattern. Returns file paths sorted by modification time (newest first).',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'Glob pattern to match (e.g., "**/*.ts", "src/**/*.test.ts")',
+                },
+                path: {
+                    type: 'string',
+                    description: 'Directory to search in. Defaults to current working directory.',
+                },
+            },
+            required: ['pattern'],
+        },
+    },
+    async execute(input, cwd) {
+        const pattern = input.pattern;
+        const searchPath = input.path || cwd;
+        try {
+            const files = await globMatch(pattern, searchPath);
+            if (files.length === 0) {
+                return '(no matching files)';
+            }
+            // Sort by mtime (newest first)
+            const withStats = files.map(f => {
+                try {
+                    const stat = fs.statSync(f);
+                    return { path: f, mtime: stat.mtimeMs };
+                }
+                catch {
+                    return { path: f, mtime: 0 };
+                }
+            });
+            withStats.sort((a, b) => b.mtime - a.mtime);
+            const result = withStats.slice(0, MAX_RESULTS).map(f => f.path);
+            let output = result.join('\n');
+            if (files.length > MAX_RESULTS) {
+                output += `\n\n(${files.length - MAX_RESULTS} more files not shown)`;
+            }
+            return output;
+        }
+        catch (err) {
+            return `Error: ${err.message}`;
+        }
+    },
+};
+/**
+ * Simple glob matching using Node's fs.
+ * Handles **, *, and ? patterns.
+ */
+async function globMatch(pattern, baseDir) {
+    // Use node:fs with recursive readdir + minimatch-style filtering
+    // For simplicity, use a shell glob via find or bash
+    const { execFileSync } = await import('child_process');
+    try {
+        // Use bash globbing (simplest, most reliable)
+        const result = execFileSync('bash', ['-c', `shopt -s globstar nullglob; printf '%s\\n' ${pattern}`], {
+            cwd: baseDir,
+            encoding: 'utf-8',
+            maxBuffer: 1024 * 1024,
+            timeout: 10_000,
+        });
+        return result
+            .trim()
+            .split('\n')
+            .filter(line => line.length > 0)
+            .map(f => path.resolve(baseDir, f))
+            .filter(f => {
+            try {
+                return fs.statSync(f).isFile();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=glob.js.map

package/dist/lib/tools/glob.js.map

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

package/dist/lib/tools/grep.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Grep tool — search file contents using ripgrep.
+ */
+import type { Tool } from './index.js';
+export declare const grepTool: Tool;
+//# sourceMappingURL=grep.d.ts.map

package/dist/lib/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/grep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,eAAO,MAAM,QAAQ,EAAE,IAwFtB,CAAC"}

package/dist/lib/tools/grep.js

@@ -0,0 +1,110 @@
+/**
+ * Grep tool — search file contents using ripgrep.
+ */
+import { execFileSync } from 'child_process';
+const MAX_RESULTS = 200;
+export const grepTool = {
+    definition: {
+        name: 'Grep',
+        description: 'Search file contents using regular expressions (powered by ripgrep). ' +
+            'Returns matching file paths by default, or matching lines with content mode.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'Regular expression pattern to search for',
+                },
+                path: {
+                    type: 'string',
+                    description: 'File or directory to search in. Defaults to current working directory.',
+                },
+                output_mode: {
+                    type: 'string',
+                    enum: ['files_with_matches', 'content', 'count'],
+                    description: 'Output mode. Default: files_with_matches.',
+                },
+                glob: {
+                    type: 'string',
+                    description: 'Glob pattern to filter files (e.g., "*.ts", "*.{js,jsx}")',
+                },
+                type: {
+                    type: 'string',
+                    description: 'File type to search (e.g., "ts", "py", "js")',
+                },
+                context: {
+                    type: 'number',
+                    description: 'Number of context lines before and after each match',
+                },
+                '-i': {
+                    type: 'boolean',
+                    description: 'Case insensitive search',
+                },
+            },
+            required: ['pattern'],
+        },
+    },
+    async execute(input, cwd) {
+        const pattern = input.pattern;
+        const searchPath = input.path || cwd;
+        const outputMode = input.output_mode || 'files_with_matches';
+        const globPattern = input.glob;
+        const fileType = input.type;
+        const context = input.context;
+        const caseInsensitive = input['-i'];
+        // Build rg args
+        const args = ['--no-heading'];
+        if (outputMode === 'files_with_matches') {
+            args.push('-l');
+        }
+        else if (outputMode === 'count') {
+            args.push('-c');
+        }
+        else {
+            args.push('-n'); // line numbers for content mode
+        }
+        if (caseInsensitive)
+            args.push('-i');
+        if (globPattern)
+            args.push('--glob', globPattern);
+        if (fileType)
+            args.push('--type', fileType);
+        if (context && outputMode === 'content')
+            args.push('-C', String(context));
+        args.push('--max-count', String(MAX_RESULTS));
+        args.push('--', pattern, searchPath);
+        try {
+            const rgPath = findRg();
+            const result = execFileSync(rgPath, args, {
+                cwd,
+                encoding: 'utf-8',
+                maxBuffer: 1024 * 1024, // 1MB
+                timeout: 30_000,
+            });
+            return result.trim() || '(no matches)';
+        }
+        catch (err) {
+            const execErr = err;
+            if (execErr.status === 1) {
+                return '(no matches)';
+            }
+            return `Error: ${execErr.stderr || 'grep failed'}`;
+        }
+    },
+};
+function findRg() {
+    // Try common locations
+    const candidates = ['rg', '/usr/bin/rg', '/usr/local/bin/rg'];
+    for (const candidate of candidates) {
+        try {
+            execFileSync('which', [candidate], { encoding: 'utf-8', stdio: 'pipe' });
+            return candidate;
+        }
+        catch {
+            // continue
+        }
+    }
+    // Fallback to PATH
+    return 'rg';
+}
+//# sourceMappingURL=grep.js.map

package/dist/lib/tools/grep.js.map

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