@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/tools/edit-utils.js

@@ -0,0 +1,250 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EmojiFilter } from '../utils/EmojiFilter.js';
+import { ReadFileTool } from './read-file.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import { fuzzyReplace } from '../utils/fuzzy-replacer.js';
+/**
+ * Computes the character offset for the start of a 1-based line number
+ * within content split by newlines.
+ */
+function getOffsetForLine(lines, lineNumber) {
+    let offset = 0;
+    for (let i = 0; i < lineNumber - 1; i++) {
+        offset += lines[i].length + 1;
+    }
+    return offset;
+}
+/**
+ * Counts occurrences of oldString that start within the line range
+ * [replaceLine, replaceLine+1) — i.e., occurrences whose start position
+ * falls on the specified 1-based line number.
+ * Returns 0 if replaceLine is out of range.
+ */
+export function countLineGuardedOccurrences(currentContent, oldString, replaceLine) {
+    if (oldString === '') {
+        return 0;
+    }
+    const lines = currentContent.split('\n');
+    if (replaceLine > lines.length) {
+        return 0;
+    }
+    const lineStartOffset = getOffsetForLine(lines, replaceLine);
+    const nextLineStartOffset = replaceLine < lines.length
+        ? getOffsetForLine(lines, replaceLine + 1)
+        : currentContent.length;
+    let count = 0;
+    let searchStart = lineStartOffset;
+    while (searchStart < nextLineStartOffset) {
+        const foundAt = currentContent.indexOf(oldString, searchStart);
+        if (foundAt === -1 || foundAt >= nextLineStartOffset) {
+            break;
+        }
+        count++;
+        searchStart = foundAt + oldString.length;
+    }
+    return count;
+}
+/**
+ * Applies replacement of oldString with newString, but only for occurrences
+ * whose start position falls within the line range [replaceLine, replaceLine+1).
+ * Replaces up to expectedReplacements eligible occurrences.
+ * Returns the resulting content string.
+ *
+ * Deterministic approach: collect all eligible match offsets from the original
+ * content first, then build the output string from original content slices.
+ * This avoids the stale-bounds bug that arises when searching a mutated result
+ * string with offsets computed from the original content.
+ */
+export function applyLineGuardedReplacement(currentContent, oldString, newString, expectedReplacements, replaceLine) {
+    if (oldString === '') {
+        return currentContent;
+    }
+    const lines = currentContent.split('\n');
+    if (replaceLine > lines.length) {
+        return currentContent;
+    }
+    const lineStartOffset = getOffsetForLine(lines, replaceLine);
+    const nextLineStartOffset = replaceLine < lines.length
+        ? getOffsetForLine(lines, replaceLine + 1)
+        : currentContent.length;
+    // Collect eligible match start offsets from the original content.
+    const matchOffsets = [];
+    let searchStart = lineStartOffset;
+    while (matchOffsets.length < expectedReplacements &&
+        searchStart < nextLineStartOffset) {
+        const foundAt = currentContent.indexOf(oldString, searchStart);
+        if (foundAt === -1 || foundAt >= nextLineStartOffset) {
+            break;
+        }
+        matchOffsets.push(foundAt);
+        searchStart = foundAt + oldString.length;
+    }
+    if (matchOffsets.length === 0) {
+        return currentContent;
+    }
+    // Build result from original content slices, replacing at collected offsets.
+    let result = '';
+    let prevEnd = 0;
+    for (const offset of matchOffsets) {
+        result += currentContent.substring(prevEnd, offset);
+        result += newString;
+        prevEnd = offset + oldString.length;
+    }
+    result += currentContent.substring(prevEnd);
+    return result;
+}
+/**
+ * Gets emoji filter instance based on configuration
+ */
+export function getEmojiFilter(host) {
+    // Get emojifilter from ephemeral settings or default to 'auto'
+    const mode = host.getEphemeralSettings?.().emojifilter;
+    // Map auto to warn for file operations (we want warnings when filtering files)
+    let filterMode;
+    if (mode === 'allowed') {
+        filterMode = 'allowed';
+    }
+    else if (mode === 'auto' || mode === 'warn') {
+        filterMode = 'warn';
+    }
+    else {
+        filterMode = 'error';
+    }
+    return new EmojiFilter({ mode: filterMode });
+}
+/**
+ * Applies a replacement to content.
+ */
+export function applyReplacement(currentContent, oldString, newString, isNewFile, expectedReplacements = 1) {
+    if (isNewFile) {
+        return newString;
+    }
+    if (currentContent === null) {
+        // Should not happen if not a new file, but defensively return empty or newString if oldString is also empty
+        return oldString === '' ? newString : '';
+    }
+    if (oldString === '' && expectedReplacements > 1) {
+        throw new Error('Cannot perform multiple replacements with empty old_string');
+    }
+    if (oldString === '') {
+        return currentContent;
+    }
+    const preserveTrailingNewline = currentContent.endsWith('\n');
+    const fuzzyResult = fuzzyReplace(currentContent, oldString, newString, expectedReplacements > 1);
+    if (fuzzyResult && fuzzyResult.occurrences === expectedReplacements) {
+        return preserveTrailingNewlineForResult(fuzzyResult.result, preserveTrailingNewline);
+    }
+    const result = expectedReplacements === 1
+        ? replaceSingleOccurrence(currentContent, oldString, newString)
+        : replaceExpectedOccurrences(currentContent, oldString, newString, expectedReplacements);
+    return preserveTrailingNewlineForResult(result, preserveTrailingNewline);
+}
+function preserveTrailingNewlineForResult(result, preserveTrailingNewline) {
+    if (preserveTrailingNewline && result.length > 0 && !result.endsWith('\n')) {
+        return `${result}\n`;
+    }
+    return result;
+}
+function replaceSingleOccurrence(currentContent, oldString, newString) {
+    // Use a replacer function so `$` in `newString` is treated literally.
+    return currentContent.replace(oldString, () => newString);
+}
+function replaceExpectedOccurrences(currentContent, oldString, newString, expectedReplacements) {
+    let result = currentContent;
+    let replacementCount = 0;
+    let searchIndex = 0;
+    while (replacementCount < expectedReplacements) {
+        const foundIndex = result.indexOf(oldString, searchIndex);
+        if (foundIndex === -1) {
+            break;
+        }
+        result = replaceAtIndex(result, foundIndex, oldString, newString);
+        replacementCount++;
+        searchIndex = foundIndex + newString.length;
+    }
+    return result;
+}
+function replaceAtIndex(content, foundIndex, oldString, newString) {
+    return (content.substring(0, foundIndex) +
+        newString +
+        content.substring(foundIndex + oldString.length));
+}
+/**
+ * Builds the error object when zero occurrences are found.
+ */
+export function buildNoOccurrenceError(filteredParams, currentContent, filePath) {
+    const replaceLine = filteredParams.replaceBeginLineNumber;
+    if (replaceLine !== undefined && replaceLine > 0 && currentContent !== null) {
+        const lines = currentContent.split('\n');
+        if (replaceLine > lines.length) {
+            return {
+                display: `Failed to edit: replaceBeginLineNumber is out of range.`,
+                raw: `Failed to edit: replaceBeginLineNumber=${replaceLine} is out of range for ${filePath} (total lines: ${lines.length}). No edits made.`,
+                type: ToolErrorType.INVALID_TOOL_PARAMS,
+            };
+        }
+        const lineIndex = replaceLine - 1;
+        const startContext = Math.max(0, lineIndex - 2);
+        const endContext = Math.min(lines.length - 1, lineIndex + 2);
+        let preview = 'Context around requested line:';
+        for (let i = startContext; i <= endContext; i++) {
+            const lineNumber = i + 1;
+            const prefix = lineNumber === replaceLine ? '->' : '  ';
+            preview += `\n${prefix} ${lineNumber.toString().padStart(4, ' ')} | ${lines[i]}`;
+        }
+        return {
+            display: `Failed to edit: no occurrences of old_string found starting at the specified line ${replaceLine}.`,
+            raw: `Failed to edit, 0 occurrences found for old_string starting at line ${replaceLine} in ${filePath}. No edits made. The exact text in old_string was not found starting at that line.\n\n${preview}`,
+            type: ToolErrorType.EDIT_NO_OCCURRENCE_FOUND,
+        };
+    }
+    return {
+        display: `Failed to edit, could not find the string to replace.`,
+        raw: `Failed to edit, 0 occurrences found for old_string in ${filePath}. No edits made. The exact text in old_string was not found. Ensure you're not escaping content incorrectly and check whitespace, indentation, and context. Use ${ReadFileTool.Name} tool to verify.`,
+        type: ToolErrorType.EDIT_NO_OCCURRENCE_FOUND,
+    };
+}
+/**
+ * Validates the edit parameters after reading file content and builds the
+ * appropriate error object if any validation fails.
+ */
+export function validateEditState(filteredParams, currentContent, fileExists, filePath, occurrences, expectedReplacements, finalOldString, finalNewString) {
+    if (filteredParams.old_string === '' && expectedReplacements > 1) {
+        return {
+            display: `Failed to edit. Cannot perform multiple replacements with empty old_string.`,
+            raw: `Invalid parameters: empty old_string with expected_replacements=${expectedReplacements} would cause infinite loop`,
+            type: ToolErrorType.INVALID_TOOL_PARAMS,
+        };
+    }
+    if (filteredParams.old_string === '') {
+        return {
+            display: `Failed to edit. Attempted to create a file that already exists.`,
+            raw: `File already exists, cannot create: ${filePath}`,
+            type: ToolErrorType.ATTEMPT_TO_CREATE_EXISTING_FILE,
+        };
+    }
+    if (occurrences === 0) {
+        return buildNoOccurrenceError(filteredParams, currentContent, filePath);
+    }
+    if (occurrences !== expectedReplacements) {
+        const occurrenceTerm = expectedReplacements === 1 ? 'occurrence' : 'occurrences';
+        return {
+            display: `Failed to edit, expected ${expectedReplacements} ${occurrenceTerm} but found ${occurrences}.`,
+            raw: `Failed to edit, Expected ${expectedReplacements} ${occurrenceTerm} but found ${occurrences} for old_string in file: ${filePath}`,
+            type: ToolErrorType.EDIT_EXPECTED_OCCURRENCE_MISMATCH,
+        };
+    }
+    if (finalOldString === finalNewString) {
+        return {
+            display: `No changes to apply. The old_string and new_string are identical.`,
+            raw: `No changes to apply. The old_string and new_string are identical in file: ${filePath}`,
+            type: ToolErrorType.EDIT_NO_CHANGE,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=edit-utils.js.map

package/dist/src/tools/edit-utils.js.map

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

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from './tools.js';
+import type { IIdeService, ILspService, IToolHost, IToolMessageBus } from '../interfaces/index.js';
+import { type ModifiableDeclarativeTool, type ModifyContext } from './modifiable-tool.js';
+export { applyReplacement, countLineGuardedOccurrences, applyLineGuardedReplacement, } from './edit-utils.js';
+/**
+ * Parameters for the Edit tool
+ */
+export interface EditToolParams {
+    /**
+     * The absolute path to the file to modify
+     */
+    absolute_path?: string;
+    /**
+     * Alternative parameter name for absolute_path (for compatibility)
+     * Not shown in schema - internal use only
+     */
+    file_path?: string;
+    /**
+     * The text to replace
+     */
+    old_string: string;
+    /**
+     * The text to replace it with
+     */
+    new_string: string;
+    /**
+     * Number of replacements expected. Defaults to 1 if not specified.
+     * Use when you want to replace multiple occurrences.
+     */
+    expected_replacements?: number;
+    /**
+     * Optional 1-based line number where the replacement should begin.
+     * Strongly recommended to always set this to guard against misinterpreting
+     * the file structure, especially when similar text appears multiple times.
+     */
+    replaceBeginLineNumber?: number;
+    /**
+     * Whether the edit was modified manually by the user.
+     */
+    modified_by_user?: boolean;
+    /**
+     * Initially proposed content.
+     */
+    ai_proposed_content?: string;
+}
+/**
+ * Implementation of the Edit tool logic
+ */
+export declare class EditTool extends BaseDeclarativeTool<EditToolParams, ToolResult> implements ModifiableDeclarativeTool<EditToolParams> {
+    private readonly host;
+    static readonly Name = "replace";
+    private readonly ideService?;
+    private readonly lspService?;
+    constructor(host?: IToolHost, messageBusOrIdeService?: IToolMessageBus | IIdeService, ideServiceOrLspService?: IIdeService | ILspService, lspService?: ILspService);
+    /**
+     * Validates the parameters for the Edit tool
+     * @param params Parameters to validate
+     * @returns Error message string or null if valid
+     */
+    protected validateToolParamValues(params: EditToolParams): string | null;
+    protected createInvocation(params: EditToolParams, messageBus: IToolMessageBus, toolName?: string, displayName?: string): ToolInvocation<EditToolParams, ToolResult>;
+    private readTextFile;
+    execute(params: EditToolParams, signal?: AbortSignal): Promise<ToolResult>;
+    getModifyContext(_: AbortSignal): ModifyContext<EditToolParams>;
+}