@project-ava-supernova/core 0.2.71

package/dist/tools/file-edit.js

@@ -0,0 +1,166 @@
+import { readFile, writeFile, stat } from 'node:fs/promises';
+import { basename, relative } from 'node:path';
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { validatePath } from './security.js';
+const MAX_EDIT_FILE_BYTES = 10 * 1024 * 1024; // 10 MB
+const MAX_PREVIEW_LINES = 10;
+export class FileEditTool {
+    name = 'file_edit';
+    description = 'Replace an exact string in a file with new content';
+    riskLevel = 'write';
+    requiresConfirmation = true;
+    schema = {
+        name: 'file_edit',
+        description: 'Perform an exact string replacement in a file. The old_string must appear exactly once ' +
+            'in the file (unless replace_all is true). Use this for precise edits to existing files.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute or relative path to the file to edit',
+                },
+                old_string: {
+                    type: 'string',
+                    description: 'The exact text to find and replace',
+                },
+                new_string: {
+                    type: 'string',
+                    description: 'The text to replace it with',
+                },
+                replace_all: {
+                    type: 'boolean',
+                    description: 'Replace all occurrences instead of requiring exactly one. Default: false',
+                },
+            },
+            required: ['file_path', 'old_string', 'new_string'],
+        },
+    };
+    async execute(args, context) {
+        const filePath = args.file_path;
+        if (!filePath) {
+            return { success: false, output: 'file_path is required and cannot be null. Provide the absolute or relative path to the file.' };
+        }
+        const oldString = args.old_string;
+        const newString = args.new_string;
+        const replaceAll = args.replace_all ?? false;
+        let absolutePath;
+        try {
+            absolutePath = validatePath(filePath, context.cwd);
+        }
+        catch (err) {
+            return { success: false, output: err.message };
+        }
+        const emit = context.onOutput;
+        const relPath = (() => {
+            try {
+                return relative(context.cwd, absolutePath) || basename(absolutePath);
+            }
+            catch {
+                return absolutePath;
+            }
+        })();
+        try {
+            const fileStat = await stat(absolutePath);
+            if (fileStat.size > MAX_EDIT_FILE_BYTES) {
+                return { success: false, output: `File is ${Math.round(fileStat.size / (1024 * 1024))} MB — exceeds the ${MAX_EDIT_FILE_BYTES / (1024 * 1024)} MB edit limit.` };
+            }
+            const content = await readFile(absolutePath, 'utf-8');
+            // Editing presumes reading — populate the same read-set file_read does
+            // so a follow-up file_write on this path doesn't trip the blind-
+            // clobber guard. Match exact-string requirement already prevents
+            // blind edits, but tracking is for downstream tools.
+            try {
+                const ss = context.sharedState;
+                if (ss) {
+                    if (!ss.readFiles)
+                        ss.readFiles = new Set();
+                    ss.readFiles.add(absolutePath);
+                }
+            }
+            catch { /* sharedState not available — non-fatal */ }
+            const occurrences = content.split(oldString).length - 1;
+            if (occurrences === 0) {
+                if (emit)
+                    emit(`✗ old_string not found in ${relPath}\n`);
+                return {
+                    success: false,
+                    output: `old_string not found in "${absolutePath}". Make sure the string matches exactly, including whitespace and indentation.`,
+                };
+            }
+            if (!replaceAll && occurrences > 1) {
+                if (emit)
+                    emit(`✗ old_string matched ${occurrences} times in ${relPath} — need more context or replace_all\n`);
+                return {
+                    success: false,
+                    output: `old_string found ${occurrences} times in "${absolutePath}". Provide more context to make it unique, or set replace_all to true.`,
+                };
+            }
+            if (emit) {
+                const label = replaceAll && occurrences > 1
+                    ? `Editing ${relPath} · ${occurrences} occurrences`
+                    : `Editing ${relPath}`;
+                emit(`${label}\n\n`);
+                emitDiff(emit, oldString, newString);
+            }
+            const updated = replaceAll
+                ? content.split(oldString).join(newString)
+                : content.replace(oldString, newString);
+            // Audit metadata: capture pre/post hashes + git SHA so a future
+            // incident can verify what changed without parsing the truncated
+            // result. content was just read above; the post-state is `updated`.
+            const sha256Before = createHash('sha256').update(content, 'utf-8').digest('hex');
+            const sha256After = createHash('sha256').update(updated, 'utf-8').digest('hex');
+            let gitSha;
+            try {
+                gitSha = execFileSync('git', ['rev-parse', '--short', 'HEAD'], {
+                    cwd: context.cwd, timeout: 1500, stdio: ['ignore', 'pipe', 'ignore'],
+                }).toString().trim() || undefined;
+            }
+            catch { /* not a git repo */ }
+            await writeFile(absolutePath, updated, 'utf-8');
+            if (emit) {
+                emit(`\n✓ Replaced ${replaceAll ? `${occurrences} occurrences` : '1 occurrence'} in ${relPath}\n`);
+            }
+            return {
+                success: true,
+                output: `Edited ${absolutePath}: replaced ${replaceAll ? `all ${occurrences} occurrences` : '1 occurrence'}`,
+                metadata: {
+                    path: absolutePath, occurrences, oldString, newString,
+                    fileMutation: {
+                        path: absolutePath, gitSha,
+                        bytesBefore: Buffer.byteLength(content, 'utf-8'),
+                        bytesAfter: Buffer.byteLength(updated, 'utf-8'),
+                        sha256Before, sha256After,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (emit)
+                emit(`\n✗ Failed: ${message}\n`);
+            return { success: false, output: `Failed to edit file "${absolutePath}": ${message}` };
+        }
+    }
+}
+function emitDiff(emit, oldString, newString) {
+    const oldLines = oldString.split('\n');
+    const newLines = newString.split('\n');
+    const oldPreview = oldLines.slice(0, MAX_PREVIEW_LINES);
+    for (const line of oldPreview) {
+        emit(`- ${line}\n`);
+    }
+    if (oldLines.length > MAX_PREVIEW_LINES) {
+        emit(`- … +${oldLines.length - MAX_PREVIEW_LINES} more lines\n`);
+    }
+    const newPreview = newLines.slice(0, MAX_PREVIEW_LINES);
+    for (const line of newPreview) {
+        emit(`+ ${line}\n`);
+    }
+    if (newLines.length > MAX_PREVIEW_LINES) {
+        emit(`+ … +${newLines.length - MAX_PREVIEW_LINES} more lines\n`);
+    }
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/tools/file-edit.js.map

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

package/dist/tools/file-read.d.ts

@@ -0,0 +1,12 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class FileReadTool implements Tool {
+    readonly name = "file_read";
+    readonly description = "Read the contents of a file with line numbers";
+    readonly riskLevel: ToolRiskLevel;
+    readonly outputTrust: "untrusted";
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-read.d.ts.map

package/dist/tools/file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../src/tools/file-read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,YAAa,YAAW,IAAI;IACvC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,mDAAmD;IACvE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAI3C,QAAQ,CAAC,WAAW,EAAG,WAAW,CAAU;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAwB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA+DjG"}

package/dist/tools/file-read.js

@@ -0,0 +1,98 @@
+import { readFile } from 'node:fs/promises';
+import { validatePath } from './security.js';
+export class FileReadTool {
+    name = 'file_read';
+    description = 'Read the contents of a file with line numbers';
+    riskLevel = 'safe';
+    // File contents can carry prompt-injection payloads — a downloaded README,
+    // a copied-in code sample, an LLM-generated config file. Treat as
+    // untrusted by default so the registry wraps the result in trust tags.
+    outputTrust = 'untrusted';
+    requiresConfirmation = false;
+    schema = {
+        name: 'file_read',
+        description: 'Read a file from the filesystem. Returns the file contents with line numbers. ' +
+            'Default limit is 500 lines — raise it explicitly with `limit` if you genuinely need more, ' +
+            'or use `offset` to page through large files.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute or relative path to the file to read',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Line number to start reading from (1-based). Default: 1',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of lines to read. Default: 500. Set higher only when you need more.',
+                },
+            },
+            required: ['file_path'],
+        },
+    };
+    async execute(args, context) {
+        const filePath = args.file_path;
+        const offset = args.offset ?? 1;
+        // Default dropped from 2000 → 500 lines. Most reads want a specific
+        // region; the old default was wide enough to routinely pull 8K+ tokens
+        // of file content the model didn't end up needing. Callers can still
+        // pass limit:2000 explicitly when the whole file is warranted.
+        const limit = args.limit ?? 500;
+        let absolutePath;
+        try {
+            absolutePath = validatePath(filePath, context.cwd);
+        }
+        catch (err) {
+            return { success: false, output: err.message };
+        }
+        try {
+            const content = await readFile(absolutePath, 'utf-8');
+            const lines = content.split('\n');
+            const startIdx = Math.max(0, offset - 1);
+            const endIdx = Math.min(lines.length, startIdx + limit);
+            const selectedLines = lines.slice(startIdx, endIdx);
+            const numbered = selectedLines
+                .map((line, i) => `${String(startIdx + i + 1).padStart(6, ' ')}  ${line}`)
+                .join('\n');
+            // When the returned slice isn't the whole file, tell the model
+            // explicitly so it knows to re-call with an offset if it needs more.
+            // Quieter than leaving the caller to compare metadata counts.
+            const shownEnd = startIdx + selectedLines.length;
+            const hasMore = shownEnd < lines.length;
+            const output = hasMore
+                ? `${numbered}\n\n[file_read: showing lines ${startIdx + 1}–${shownEnd} of ${lines.length}. Call again with offset:${shownEnd + 1} for more.]`
+                : numbered;
+            // Record the read in sharedState so file_write can later detect
+            // blind-clobber attempts (overwriting a file Ava never opened).
+            // Per-session set — keyed by absolute path. file_edit also populates
+            // this, since editing a file implies you've read enough of it.
+            try {
+                const ss = context.sharedState;
+                if (ss) {
+                    if (!ss.readFiles)
+                        ss.readFiles = new Set();
+                    ss.readFiles.add(absolutePath);
+                }
+            }
+            catch { /* sharedState not available — non-fatal */ }
+            return {
+                success: true,
+                output,
+                metadata: {
+                    totalLines: lines.length,
+                    shownLines: selectedLines.length,
+                    path: absolutePath,
+                    truncated: hasMore,
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, output: `Failed to read file "${absolutePath}": ${message}` };
+        }
+    }
+}
+//# sourceMappingURL=file-read.js.map

package/dist/tools/file-read.js.map

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

package/dist/tools/file-write.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class FileWriteTool implements Tool {
+    readonly name = "file_write";
+    readonly description = "Create or overwrite a file with the given content";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    private static readonly MAX_WRITE_BYTES;
+    private static readonly PREVIEW_LINES;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-write.d.ts.map

package/dist/tools/file-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../../src/tools/file-write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,uDAAuD;IAC3E,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAmB7B;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAoB;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAK;IAEpC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA4HjG"}

package/dist/tools/file-write.js

@@ -0,0 +1,163 @@
+import { writeFile, mkdir, stat, readFile } from 'node:fs/promises';
+import { dirname, basename, relative } from 'node:path';
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { validatePath } from './security.js';
+export class FileWriteTool {
+    name = 'file_write';
+    description = 'Create or overwrite a file with the given content';
+    riskLevel = 'write';
+    requiresConfirmation = true;
+    schema = {
+        name: 'file_write',
+        description: 'Write content to a file. Creates parent directories if they do not exist. ' +
+            'Overwrites the file if it already exists.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute or relative path to the file to write',
+                },
+                content: {
+                    type: 'string',
+                    description: 'The content to write to the file',
+                },
+            },
+            required: ['file_path', 'content'],
+        },
+    };
+    static MAX_WRITE_BYTES = 10 * 1024 * 1024; // 10 MB
+    static PREVIEW_LINES = 8;
+    async execute(args, context) {
+        const filePath = args.file_path;
+        if (!filePath) {
+            return { success: false, output: 'file_path is required and cannot be null. Provide the absolute or relative path to the file.' };
+        }
+        const content = args.content ?? '';
+        if (content.length > FileWriteTool.MAX_WRITE_BYTES) {
+            return { success: false, output: `Content exceeds maximum write size of ${FileWriteTool.MAX_WRITE_BYTES / (1024 * 1024)} MB.` };
+        }
+        let absolutePath;
+        try {
+            absolutePath = validatePath(filePath, context.cwd);
+        }
+        catch (err) {
+            return { success: false, output: err.message };
+        }
+        const emit = context.onOutput;
+        const relPath = (() => {
+            try {
+                return relative(context.cwd, absolutePath) || basename(absolutePath);
+            }
+            catch {
+                return absolutePath;
+            }
+        })();
+        let isOverwrite = false;
+        let prevSize = 0;
+        try {
+            const existing = await stat(absolutePath);
+            if (existing.isFile()) {
+                isOverwrite = true;
+                prevSize = existing.size;
+            }
+        }
+        catch { /* file doesn't exist — create */ }
+        // Blind-clobber guard. If we're about to overwrite an existing file
+        // that Ava has not read this session (file_read or file_edit), refuse
+        // and tell the agent to read first. Common failure mode otherwise:
+        // model "remembers" file contents from training data or an earlier
+        // turn, decides to rewrite, silently discards content it never saw.
+        // Especially bad for config files, lock files, .env files, migrations.
+        //
+        // The model self-corrects from this error — next turn calls file_read
+        // and then comes back with a properly-informed write. No user friction
+        // for the common case (new files, files the agent legitimately read);
+        // hard stop only on the actual foot-gun pattern.
+        if (isOverwrite) {
+            const ss = context.sharedState;
+            const hasRead = ss?.readFiles?.has(absolutePath) ?? false;
+            if (!hasRead) {
+                return {
+                    success: false,
+                    output: `file_write refused: "${relPath}" exists (${formatBytes(prevSize)}) but you have not read it this session. Call file_read on this path first to see the current contents, then file_write with the version you actually mean. This guard prevents blind-clobber regressions where remembered contents diverge from what's on disk.`,
+                };
+            }
+        }
+        const lines = content.split('\n');
+        const lineCount = lines.length;
+        const byteSize = Buffer.byteLength(content, 'utf-8');
+        const humanSize = formatBytes(byteSize);
+        if (emit) {
+            const verb = isOverwrite ? 'Overwriting' : 'Creating';
+            emit(`${verb} ${relPath}\n`);
+            emit(`${lineCount} ${lineCount === 1 ? 'line' : 'lines'} · ${humanSize}`);
+            if (isOverwrite && prevSize > 0) {
+                emit(` (was ${formatBytes(prevSize)})`);
+            }
+            emit('\n\n');
+            const previewLines = lines.slice(0, FileWriteTool.PREVIEW_LINES);
+            for (const line of previewLines) {
+                emit(`  ${line}\n`);
+            }
+            if (lineCount > FileWriteTool.PREVIEW_LINES) {
+                emit(`  … +${lineCount - FileWriteTool.PREVIEW_LINES} more lines\n`);
+            }
+        }
+        // Compute pre-state for the audit log so a future incident can verify
+        // exactly what changed. Cheap (sha256 over a small file is sub-ms);
+        // only runs on overwrites since new-file writes have no "before" state.
+        let sha256Before;
+        if (isOverwrite) {
+            try {
+                const prev = await readFile(absolutePath);
+                sha256Before = createHash('sha256').update(prev).digest('hex');
+            }
+            catch { /* unreadable — leave undefined */ }
+        }
+        let gitSha;
+        try {
+            gitSha = execFileSync('git', ['rev-parse', '--short', 'HEAD'], {
+                cwd: context.cwd, timeout: 1500, stdio: ['ignore', 'pipe', 'ignore'],
+            }).toString().trim() || undefined;
+        }
+        catch { /* not a git repo or git unavailable */ }
+        try {
+            await mkdir(dirname(absolutePath), { recursive: true });
+            await writeFile(absolutePath, content, 'utf-8');
+            const sha256After = createHash('sha256').update(content, 'utf-8').digest('hex');
+            if (emit) {
+                emit(`\n✓ ${isOverwrite ? 'Updated' : 'Created'} ${relPath}\n`);
+            }
+            return {
+                success: true,
+                output: `File written: ${absolutePath} (${lineCount} lines, ${humanSize})`,
+                metadata: {
+                    path: absolutePath, lineCount, bytes: byteSize, overwrite: isOverwrite,
+                    fileMutation: {
+                        path: absolutePath, gitSha,
+                        bytesBefore: isOverwrite ? prevSize : 0,
+                        bytesAfter: byteSize,
+                        sha256Before,
+                        sha256After,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (emit)
+                emit(`\n✗ Failed: ${message}\n`);
+            return { success: false, output: `Failed to write file "${absolutePath}": ${message}` };
+        }
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+//# sourceMappingURL=file-write.js.map

package/dist/tools/file-write.js.map

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

package/dist/tools/find-symbol.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class FindSymbolTool implements Tool {
+    readonly name = "find_symbol";
+    readonly description = "Find where functions, classes, types, and other symbols are defined or referenced";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private formatDefinitions;
+    private formatFileSymbols;
+}
+//# sourceMappingURL=find-symbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-symbol.d.ts","sourceRoot":"","sources":["../../src/tools/find-symbol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,qBAAa,cAAe,YAAW,IAAI;IACzC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,uFAAuF;IAC3G,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA2B7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0FhG,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,iBAAiB;CAqB1B"}