beth-copilot 1.0.15 → 1.0.16

package/dist/tools/cli/editFile.test.js

@@ -0,0 +1,177 @@
+/**
+ * EditFile Tool Tests
+ *
+ * Tests for the editFile tool implementation.
+ * Uses node:test and node:assert with real file I/O via tmpdir.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { mkdtempSync, writeFileSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { editFileTool } from './editFile.js';
+import { ToolError } from '../types.js';
+/** Create a ToolContext with sensible defaults */
+function createContext(overrides) {
+    return {
+        workingDir: overrides?.workingDir ?? '/tmp',
+        permissions: overrides?.permissions ?? {
+            allowFileRead: true,
+            allowFileWrite: true,
+            allowTerminal: false,
+            allowNetwork: false,
+        },
+        signal: overrides?.signal,
+    };
+}
+describe('editFile tool', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'beth-editfile-'));
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe('metadata', () => {
+        it('should have name "editFile"', () => {
+            assert.strictEqual(editFileTool.name, 'editFile');
+        });
+        it('should have a description', () => {
+            assert.ok(editFileTool.description.length > 0);
+        });
+        it('should have an inputSchema with required fields', () => {
+            assert.strictEqual(editFileTool.inputSchema.type, 'object');
+            const required = editFileTool.inputSchema.required;
+            assert.ok(required.includes('filePath'));
+            assert.ok(required.includes('oldString'));
+            assert.ok(required.includes('newString'));
+        });
+    });
+    describe('successful edits', () => {
+        it('should replace a string successfully', async () => {
+            const filePath = join(tempDir, 'test.txt');
+            writeFileSync(filePath, 'hello world');
+            const result = await editFileTool.execute({ filePath, oldString: 'hello', newString: 'goodbye' }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'goodbye world');
+        });
+        it('should handle multi-line replacements', async () => {
+            const filePath = join(tempDir, 'multi.txt');
+            writeFileSync(filePath, 'line 1\nline 2\nline 3');
+            const result = await editFileTool.execute({ filePath, oldString: 'line 2', newString: 'replaced line' }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'line 1\nreplaced line\nline 3');
+        });
+        it('should handle empty newString (deletion)', async () => {
+            const filePath = join(tempDir, 'delete.txt');
+            writeFileSync(filePath, 'keep this remove this keep that');
+            const result = await editFileTool.execute({ filePath, oldString: 'remove this ', newString: '' }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'keep this keep that');
+        });
+        it('should return filePath and replacement count in metadata', async () => {
+            const filePath = join(tempDir, 'meta.txt');
+            writeFileSync(filePath, 'content');
+            const result = await editFileTool.execute({ filePath, oldString: 'content', newString: 'new content' }, createContext());
+            assert.strictEqual(result.metadata?.filePath, filePath);
+            assert.strictEqual(result.metadata?.replacements, 1);
+        });
+        it('should preserve file encoding (UTF-8 with special chars)', async () => {
+            const filePath = join(tempDir, 'unicode.txt');
+            const content = 'Hello 世界 🌍 café naïve';
+            writeFileSync(filePath, content, 'utf-8');
+            const result = await editFileTool.execute({ filePath, oldString: '世界', newString: 'World' }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'Hello World 🌍 café naïve');
+        });
+    });
+    describe('match validation', () => {
+        it('should reject when oldString not found', async () => {
+            const filePath = join(tempDir, 'notfound.txt');
+            writeFileSync(filePath, 'hello world');
+            await assert.rejects(() => editFileTool.execute({ filePath, oldString: 'goodbye', newString: 'hi' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'EXECUTION_FAILED');
+                assert.ok(err.message.includes('not found'));
+                return true;
+            });
+            // File should be unchanged
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'hello world');
+        });
+        it('should reject when oldString matches multiple times', async () => {
+            const filePath = join(tempDir, 'ambiguous.txt');
+            writeFileSync(filePath, 'foo bar foo baz foo');
+            await assert.rejects(() => editFileTool.execute({ filePath, oldString: 'foo', newString: 'qux' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'EXECUTION_FAILED');
+                assert.ok(err.message.includes('ambiguous'));
+                return true;
+            });
+            // File should be unchanged
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'foo bar foo baz foo');
+        });
+        it('should reject empty oldString', async () => {
+            const filePath = join(tempDir, 'empty.txt');
+            writeFileSync(filePath, 'content');
+            await assert.rejects(() => editFileTool.execute({ filePath, oldString: '', newString: 'x' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                return true;
+            });
+        });
+    });
+    describe('path validation', () => {
+        it('should reject path traversal attempts', async () => {
+            await assert.rejects(() => editFileTool.execute({ filePath: '/tmp/../../../etc/passwd', oldString: 'a', newString: 'b' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('traversal'));
+                return true;
+            });
+        });
+        it('should reject shell injection in paths', async () => {
+            await assert.rejects(() => editFileTool.execute({ filePath: '/tmp/file; rm -rf /', oldString: 'a', newString: 'b' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                return true;
+            });
+        });
+        it('should reject relative paths', async () => {
+            await assert.rejects(() => editFileTool.execute({ filePath: 'relative/path.txt', oldString: 'a', newString: 'b' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('absolute'));
+                return true;
+            });
+        });
+    });
+    describe('error handling', () => {
+        it('should return NOT_FOUND for missing files', async () => {
+            await assert.rejects(() => editFileTool.execute({ filePath: join(tempDir, 'nonexistent.txt'), oldString: 'a', newString: 'b' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'NOT_FOUND');
+                return true;
+            });
+        });
+        it('should return PERMISSION_DENIED when allowFileWrite is false', async () => {
+            const filePath = join(tempDir, 'readonly.txt');
+            writeFileSync(filePath, 'content');
+            const ctx = createContext({
+                permissions: {
+                    allowFileRead: true,
+                    allowFileWrite: false,
+                    allowTerminal: false,
+                    allowNetwork: false,
+                },
+            });
+            await assert.rejects(() => editFileTool.execute({ filePath, oldString: 'content', newString: 'new' }, ctx), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'PERMISSION_DENIED');
+                return true;
+            });
+            // File should be unchanged
+            assert.strictEqual(readFileSync(filePath, 'utf-8'), 'content');
+        });
+    });
+});
+//# sourceMappingURL=editFile.test.js.map

package/dist/tools/cli/editFile.test.js.map

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

package/dist/tools/cli/readFile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ReadFile Tool
+ *
+ * Reads the contents of a file with optional line-range selection.
+ * Validates paths against traversal and injection attacks using
+ * the shared path validation utilities.
+ */
+import type { Tool } from '../interface.js';
+/**
+ * Validate a file path for read/write operations.
+ * Checks for empty paths, null bytes, traversal sequences, and shell injection.
+ *
+ * @param filePath - The file path to validate
+ * @param toolName - Name of the calling tool (for error reporting)
+ * @throws {ToolError} If the path is invalid
+ */
+export declare function validateFilePath(filePath: unknown, toolName: string): string;
+/**
+ * ReadFile tool implementation.
+ *
+ * Reads file contents with optional line-range selection (offset/limit).
+ * Validates paths and checks permissions before reading.
+ */
+export declare const readFileTool: Tool;
+//# sourceMappingURL=readFile.d.ts.map

package/dist/tools/cli/readFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readFile.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/readFile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAwB5C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4B5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,IA+D1B,CAAC"}

package/dist/tools/cli/readFile.js

@@ -0,0 +1,118 @@
+/**
+ * ReadFile Tool
+ *
+ * Reads the contents of a file with optional line-range selection.
+ * Validates paths against traversal and injection attacks using
+ * the shared path validation utilities.
+ */
+import { readFile } from 'node:fs/promises';
+import { resolve, isAbsolute } from 'node:path';
+import { containsTraversal, containsShellInjection } from '../../lib/pathValidation.js';
+import { ToolError } from '../types.js';
+/** Input schema for the readFile tool */
+const inputSchema = {
+    type: 'object',
+    properties: {
+        filePath: {
+            type: 'string',
+            description: 'Absolute path to the file to read',
+        },
+        offset: {
+            type: 'number',
+            description: '1-based starting line number',
+        },
+        limit: {
+            type: 'number',
+            description: 'Maximum number of lines to read',
+        },
+    },
+    required: ['filePath'],
+};
+/**
+ * Validate a file path for read/write operations.
+ * Checks for empty paths, null bytes, traversal sequences, and shell injection.
+ *
+ * @param filePath - The file path to validate
+ * @param toolName - Name of the calling tool (for error reporting)
+ * @throws {ToolError} If the path is invalid
+ */
+export function validateFilePath(filePath, toolName) {
+    if (typeof filePath !== 'string' || filePath.trim().length === 0) {
+        throw new ToolError('filePath is required and must be a non-empty string', 'INVALID_INPUT', toolName);
+    }
+    const trimmed = filePath.trim();
+    if (trimmed.length > 4096) {
+        throw new ToolError('filePath exceeds maximum length (4096 characters)', 'INVALID_INPUT', toolName);
+    }
+    if (trimmed.includes('\0')) {
+        throw new ToolError('filePath contains invalid characters (null byte)', 'INVALID_INPUT', toolName);
+    }
+    if (containsTraversal(trimmed)) {
+        throw new ToolError('filePath contains directory traversal sequences', 'INVALID_INPUT', toolName);
+    }
+    if (containsShellInjection(trimmed)) {
+        throw new ToolError('filePath contains potentially dangerous characters', 'INVALID_INPUT', toolName);
+    }
+    if (!isAbsolute(trimmed)) {
+        throw new ToolError('filePath must be an absolute path', 'INVALID_INPUT', toolName);
+    }
+    return resolve(trimmed);
+}
+/**
+ * ReadFile tool implementation.
+ *
+ * Reads file contents with optional line-range selection (offset/limit).
+ * Validates paths and checks permissions before reading.
+ */
+export const readFileTool = {
+    name: 'readFile',
+    description: 'Read the contents of a file, optionally selecting a range of lines',
+    inputSchema,
+    async execute(input, context) {
+        // Check permission
+        if (!context.permissions.allowFileRead) {
+            throw new ToolError('File read permission denied', 'PERMISSION_DENIED', 'readFile');
+        }
+        // Validate path
+        const resolvedPath = validateFilePath(input.filePath, 'readFile');
+        // Read file
+        let contents;
+        try {
+            contents = await readFile(resolvedPath, 'utf-8');
+        }
+        catch (err) {
+            const nodeErr = err;
+            if (nodeErr.code === 'ENOENT') {
+                throw new ToolError(`File not found: ${resolvedPath}`, 'NOT_FOUND', 'readFile', { cause: nodeErr });
+            }
+            if (nodeErr.code === 'EACCES') {
+                throw new ToolError(`Permission denied: ${resolvedPath}`, 'PERMISSION_DENIED', 'readFile', { cause: nodeErr });
+            }
+            throw new ToolError(`Failed to read file: ${nodeErr.message}`, 'EXECUTION_FAILED', 'readFile', { cause: nodeErr });
+        }
+        // Apply offset/limit for line-range reading
+        const offset = typeof input.offset === 'number' ? input.offset : undefined;
+        const limit = typeof input.limit === 'number' ? input.limit : undefined;
+        let output = contents;
+        let totalLines = contents.split('\n').length;
+        if (offset !== undefined || limit !== undefined) {
+            const lines = contents.split('\n');
+            totalLines = lines.length;
+            // offset is 1-based
+            const startIndex = offset !== undefined ? Math.max(0, offset - 1) : 0;
+            const endIndex = limit !== undefined ? startIndex + limit : lines.length;
+            output = lines.slice(startIndex, endIndex).join('\n');
+        }
+        return {
+            success: true,
+            output,
+            metadata: {
+                filePath: resolvedPath,
+                totalLines,
+                ...(offset !== undefined && { offset }),
+                ...(limit !== undefined && { limit }),
+            },
+        };
+    },
+};
+//# sourceMappingURL=readFile.js.map

package/dist/tools/cli/readFile.js.map

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

package/dist/tools/cli/readFile.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ReadFile Tool Tests
+ *
+ * Tests for the readFile tool implementation.
+ * Uses node:test and node:assert with real file I/O via tmpdir.
+ */
+export {};
+//# sourceMappingURL=readFile.test.d.ts.map

package/dist/tools/cli/readFile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readFile.test.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/readFile.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/cli/readFile.test.js

@@ -0,0 +1,194 @@
+/**
+ * ReadFile Tool Tests
+ *
+ * Tests for the readFile tool implementation.
+ * Uses node:test and node:assert with real file I/O via tmpdir.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { mkdtempSync, writeFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { readFileTool } from './readFile.js';
+import { ToolError } from '../types.js';
+/** Create a ToolContext with sensible defaults */
+function createContext(overrides) {
+    return {
+        workingDir: overrides?.workingDir ?? '/tmp',
+        permissions: overrides?.permissions ?? {
+            allowFileRead: true,
+            allowFileWrite: false,
+            allowTerminal: false,
+            allowNetwork: false,
+        },
+        signal: overrides?.signal,
+    };
+}
+describe('readFile tool', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'beth-readfile-'));
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe('metadata', () => {
+        it('should have name "readFile"', () => {
+            assert.strictEqual(readFileTool.name, 'readFile');
+        });
+        it('should have a description', () => {
+            assert.ok(readFileTool.description.length > 0);
+        });
+        it('should have an inputSchema with filePath required', () => {
+            assert.strictEqual(readFileTool.inputSchema.type, 'object');
+            assert.ok(Array.isArray(readFileTool.inputSchema.required));
+            assert.ok(readFileTool.inputSchema.required.includes('filePath'));
+        });
+    });
+    describe('successful reads', () => {
+        it('should read a file successfully', async () => {
+            const filePath = join(tempDir, 'test.txt');
+            writeFileSync(filePath, 'hello world');
+            const result = await readFileTool.execute({ filePath }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, 'hello world');
+        });
+        it('should read a multi-line file', async () => {
+            const filePath = join(tempDir, 'multi.txt');
+            const content = 'line 1\nline 2\nline 3\nline 4\nline 5';
+            writeFileSync(filePath, content);
+            const result = await readFileTool.execute({ filePath }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, content);
+            assert.strictEqual(result.metadata?.totalLines, 5);
+        });
+        it('should handle empty files', async () => {
+            const filePath = join(tempDir, 'empty.txt');
+            writeFileSync(filePath, '');
+            const result = await readFileTool.execute({ filePath }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, '');
+        });
+        it('should return filePath in metadata', async () => {
+            const filePath = join(tempDir, 'meta.txt');
+            writeFileSync(filePath, 'content');
+            const result = await readFileTool.execute({ filePath }, createContext());
+            assert.strictEqual(result.metadata?.filePath, filePath);
+        });
+    });
+    describe('offset and limit', () => {
+        it('should read from offset (1-based)', async () => {
+            const filePath = join(tempDir, 'offset.txt');
+            writeFileSync(filePath, 'line 1\nline 2\nline 3\nline 4\nline 5');
+            const result = await readFileTool.execute({ filePath, offset: 3 }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, 'line 3\nline 4\nline 5');
+        });
+        it('should read with limit', async () => {
+            const filePath = join(tempDir, 'limit.txt');
+            writeFileSync(filePath, 'line 1\nline 2\nline 3\nline 4\nline 5');
+            const result = await readFileTool.execute({ filePath, limit: 2 }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, 'line 1\nline 2');
+        });
+        it('should read with both offset and limit', async () => {
+            const filePath = join(tempDir, 'range.txt');
+            writeFileSync(filePath, 'line 1\nline 2\nline 3\nline 4\nline 5');
+            const result = await readFileTool.execute({ filePath, offset: 2, limit: 2 }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, 'line 2\nline 3');
+        });
+        it('should handle offset beyond file length', async () => {
+            const filePath = join(tempDir, 'short.txt');
+            writeFileSync(filePath, 'line 1\nline 2');
+            const result = await readFileTool.execute({ filePath, offset: 100 }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, '');
+        });
+        it('should include offset and limit in metadata', async () => {
+            const filePath = join(tempDir, 'meta2.txt');
+            writeFileSync(filePath, 'line 1\nline 2\nline 3');
+            const result = await readFileTool.execute({ filePath, offset: 2, limit: 1 }, createContext());
+            assert.strictEqual(result.metadata?.offset, 2);
+            assert.strictEqual(result.metadata?.limit, 1);
+        });
+    });
+    describe('path validation', () => {
+        it('should reject path traversal attempts', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: '/tmp/../../../etc/passwd' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('traversal'));
+                return true;
+            });
+        });
+        it('should reject shell injection in paths', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: '/tmp/file; rm -rf /' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('dangerous'));
+                return true;
+            });
+        });
+        it('should reject relative paths', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: 'relative/path.txt' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('absolute'));
+                return true;
+            });
+        });
+        it('should reject empty filePath', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: '' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                return true;
+            });
+        });
+        it('should reject null byte in path', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: '/tmp/file\0evil' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('null'));
+                return true;
+            });
+        });
+    });
+    describe('error handling', () => {
+        it('should return NOT_FOUND for missing files', async () => {
+            await assert.rejects(() => readFileTool.execute({ filePath: join(tempDir, 'nonexistent.txt') }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'NOT_FOUND');
+                return true;
+            });
+        });
+        it('should return PERMISSION_DENIED when allowFileRead is false', async () => {
+            const filePath = join(tempDir, 'test.txt');
+            writeFileSync(filePath, 'content');
+            const ctx = createContext({
+                permissions: {
+                    allowFileRead: false,
+                    allowFileWrite: false,
+                    allowTerminal: false,
+                    allowNetwork: false,
+                },
+            });
+            await assert.rejects(() => readFileTool.execute({ filePath }, ctx), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'PERMISSION_DENIED');
+                return true;
+            });
+        });
+    });
+    describe('binary file handling', () => {
+        it('should not crash on binary content', async () => {
+            const filePath = join(tempDir, 'binary.bin');
+            const buf = Buffer.from([0x00, 0x01, 0x02, 0xFF, 0xFE, 0xFD]);
+            writeFileSync(filePath, buf);
+            // Should not throw — reads as utf-8 (may produce replacement chars)
+            const result = await readFileTool.execute({ filePath }, createContext());
+            assert.strictEqual(result.success, true);
+        });
+    });
+});
+//# sourceMappingURL=readFile.test.js.map

package/dist/tools/cli/readFile.test.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Search Tool
+ *
+ * Searches file contents using ripgrep (preferred) or a Node.js fallback.
+ * Validates search paths against traversal attacks and checks permissions
+ * before reading any files.
+ */
+import type { Tool } from '../interface.js';
+/**
+ * Search tool implementation.
+ *
+ * Searches file contents using ripgrep when available, falling back to
+ * a recursive Node.js search. Results are returned in `filepath:line:content` format.
+ */
+export declare const searchTool: Tool;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AA8N5C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,IA6DxB,CAAC"}