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

package/dist/src/tools/delete_line_range.js

@@ -0,0 +1,238 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import * as Diff from 'diff';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import { getSpecificMimeType } from '../utils/fileUtils.js';
+import { DEFAULT_CREATE_PATCH_OPTIONS } from '../utils/diffOptions.js';
+import { collectLspDiagnosticsBlock } from '../utils/lsp-diagnostics-helper.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+class DeleteLineRangeToolInvocation extends BaseToolInvocation {
+    host;
+    ideService;
+    lspService;
+    constructor(host, ideService, lspService, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+        this.ideService = ideService;
+        this.lspService = lspService;
+    }
+    getFilePath() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+        return this.params.absolute_path || this.params.file_path || '';
+    }
+    getDescription() {
+        const relativePath = makeRelative(this.getFilePath(), this.host.getTargetDir());
+        return `Delete lines ${this.params.start_line}-${this.params.end_line} from ${shortenPath(relativePath)}`;
+    }
+    toolLocations() {
+        return [{ path: this.getFilePath(), line: this.params.start_line }];
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        const approvalMode = this.host.getApprovalMode();
+        if (approvalMode === 'auto' || approvalMode === 'yolo') {
+            return false;
+        }
+        const filePath = this.getFilePath();
+        let originalContent;
+        try {
+            originalContent = await fs.readFile(filePath, 'utf8');
+        }
+        catch {
+            return false;
+        }
+        const lines = originalContent.split('\n');
+        const totalLines = lines.length;
+        if (this.params.start_line > totalLines) {
+            return false;
+        }
+        const startIndex = this.params.start_line - 1;
+        const count = this.params.end_line - this.params.start_line + 1;
+        const newLines = [...lines];
+        newLines.splice(startIndex, count);
+        const newContent = newLines.join('\n');
+        const relativePath = makeRelative(filePath, this.host.getTargetDir());
+        const fileName = path.basename(filePath);
+        const fileDiff = Diff.createPatch(fileName, originalContent, newContent, 'Current', 'Proposed', DEFAULT_CREATE_PATCH_OPTIONS);
+        const ideConfirmation = this.ideService?.getConnectionStatus() === 'connected'
+            ? this.ideService.applyDiff({ filePath, diff: newContent })
+            : undefined;
+        const confirmationDetails = {
+            type: 'edit',
+            title: `Confirm Delete: ${shortenPath(relativePath)} (lines ${this.params.start_line}-${this.params.end_line})`,
+            fileName,
+            filePath,
+            fileDiff,
+            originalContent,
+            newContent,
+            onConfirm: async (outcome) => {
+                if (outcome === ToolConfirmationOutcome.ProceedAlways) {
+                    this.host.setApprovalMode('auto');
+                }
+            },
+            ideConfirmation,
+        };
+        return confirmationDetails;
+    }
+    async execute() {
+        const filePath = this.getFilePath();
+        let content;
+        try {
+            content = await fs.readFile(filePath, 'utf8');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error reading file: ${message}`,
+                returnDisplay: `Error reading file: ${message}`,
+                error: {
+                    message,
+                    type: ToolErrorType.FILE_NOT_FOUND,
+                },
+            };
+        }
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        if (this.params.start_line > totalLines) {
+            return {
+                llmContent: `Cannot delete lines: start_line ${this.params.start_line} is beyond the total number of lines (${totalLines})`,
+                returnDisplay: `Cannot delete lines: start_line ${this.params.start_line} is beyond the total number of lines (${totalLines})`,
+                error: {
+                    message: `start_line ${this.params.start_line} exceeds file length (${totalLines})`,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        const startIndex = this.params.start_line - 1;
+        const count = this.params.end_line - this.params.start_line + 1;
+        const deletedContent = lines
+            .slice(startIndex, startIndex + count)
+            .join('\n');
+        lines.splice(startIndex, count);
+        const newContent = lines.join('\n');
+        try {
+            await fs.writeFile(filePath, newContent, 'utf8');
+            this.recordMetrics(filePath, count);
+            const llmSuccessMessageParts = [
+                `Successfully deleted lines ${this.params.start_line}-${this.params.end_line} from ${filePath}`,
+                deletedContent,
+            ];
+            try {
+                const diagBlock = this.lspService === undefined
+                    ? null
+                    : await collectLspDiagnosticsBlock(this.lspService, this.host, filePath);
+                if (diagBlock) {
+                    llmSuccessMessageParts.push(diagBlock);
+                }
+            }
+            catch {
+                // LSP failure must never fail the edit (REQ-GRACE-050, REQ-GRACE-055)
+            }
+            return {
+                llmContent: llmSuccessMessageParts.join('\n\n'),
+                returnDisplay: `Deleted ${count} lines (${this.params.start_line}-${this.params.end_line})`,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error writing file: ${message}`,
+                returnDisplay: `Error writing file: ${message}`,
+                error: {
+                    message,
+                    type: ToolErrorType.FILE_WRITE_FAILURE,
+                },
+            };
+        }
+    }
+    recordMetrics(filePath, linesDeleted) {
+        const mimetype = getSpecificMimeType(filePath);
+        const extension = path.extname(filePath);
+        void linesDeleted;
+        void mimetype;
+        void extension;
+    }
+}
+/**
+ * Implementation of the DeleteLineRange tool logic
+ */
+export class DeleteLineRangeTool extends BaseDeclarativeTool {
+    host;
+    ideService;
+    lspService;
+    static Name = 'delete_line_range';
+    constructor(host, ideService, lspService) {
+        super(DeleteLineRangeTool.Name, 'DeleteLineRange', `Deletes a specific range of lines from a file. This is the preferred way to delete large blocks, as it avoids using a massive, brittle 'old_string' in the 'replace' tool. Always read the file or use 'get_file_outline' first to get the exact line numbers before deleting.`, Kind.Edit, {
+            properties: {
+                absolute_path: {
+                    description: "The absolute path to the file to modify. Must start with '/' and be within the workspace.",
+                    type: 'string',
+                },
+                file_path: {
+                    description: 'Alternative parameter name for absolute_path (for backward compatibility). The absolute path to the file to modify.',
+                    type: 'string',
+                },
+                start_line: {
+                    description: 'The 1-based line number to start deleting from (inclusive).',
+                    type: 'number',
+                    minimum: 1,
+                },
+                end_line: {
+                    description: 'The 1-based line number to end deleting at (inclusive). Must be >= start_line.',
+                    type: 'number',
+                    minimum: 1,
+                },
+            },
+            required: ['start_line', 'end_line'],
+            type: 'object',
+        });
+        this.host = host;
+        this.ideService = ideService;
+        this.lspService = lspService;
+    }
+    validateToolParamValues(params) {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid
+        const filePath = params.absolute_path || params.file_path || '';
+        if (filePath.trim() === '') {
+            return "Either 'absolute_path' or 'file_path' parameter must be provided and non-empty.";
+        }
+        if (!path.isAbsolute(filePath)) {
+            return `File path must be absolute: ${filePath}`;
+        }
+        const pathError = validatePathWithinWorkspace(this.host.getWorkspaceRoots(), filePath);
+        if (pathError) {
+            return pathError;
+        }
+        if (params.start_line < 1) {
+            return 'start_line must be a positive integer (>= 1)';
+        }
+        if (params.end_line < 1) {
+            return 'end_line must be a positive integer (>= 1)';
+        }
+        if (params.end_line < params.start_line) {
+            return 'end_line must be greater than or equal to start_line';
+        }
+        const fileService = this.host.getFileService();
+        if (fileService.shouldLlxprtIgnoreFile(filePath)) {
+            return `File path '${filePath}' is ignored by .llxprtignore pattern(s).`;
+        }
+        return null;
+    }
+    createInvocation(params, messageBus) {
+        const normalizedParams = { ...params };
+        if (!normalizedParams.absolute_path && normalizedParams.file_path) {
+            normalizedParams.absolute_path = normalizedParams.file_path;
+        }
+        return new DeleteLineRangeToolInvocation(this.host, this.ideService, this.lspService, normalizedParams, messageBus);
+    }
+    async execute(params, signal = new AbortController().signal) {
+        return this.build(params).execute(signal);
+    }
+}
+//# sourceMappingURL=delete_line_range.js.map

package/dist/src/tools/delete_line_range.js.map

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

package/dist/src/tools/direct-web-fetch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from './tools.js';
+import type { IToolHost, IToolMessageBus } from '../interfaces/index.js';
+export interface DirectWebFetchToolParams {
+    url: string;
+    format: 'text' | 'markdown' | 'html';
+    timeout?: number;
+}
+export declare class DirectWebFetchTool extends BaseDeclarativeTool<DirectWebFetchToolParams, ToolResult> {
+    private readonly host;
+    static readonly Name = "direct_web_fetch";
+    constructor(host: IToolHost);
+    protected createInvocation(params: DirectWebFetchToolParams, messageBus: IToolMessageBus): ToolInvocation<DirectWebFetchToolParams, ToolResult>;
+}

package/dist/src/tools/direct-web-fetch.js

@@ -0,0 +1,215 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { DIRECT_WEB_FETCH_TOOL } from '../types/tool-names.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import fetch from 'node-fetch';
+import TurndownService from 'turndown';
+import * as cheerio from 'cheerio';
+import { retryWithBackoff } from '../utils/retry.js';
+import { ensureJsonSafe } from '../utils/unicodeUtils.js';
+const MAX_RESPONSE_SIZE = 5 * 1024 * 1024; // 5MB
+const DEFAULT_TIMEOUT = 30 * 1000; // 30 seconds
+const MAX_TIMEOUT = 120 * 1000; // 2 minutes
+const ACCEPT_HEADERS = {
+    markdown: 'text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1',
+    text: 'text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1',
+    html: 'text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1',
+};
+export class DirectWebFetchTool extends BaseDeclarativeTool {
+    host;
+    static Name = DIRECT_WEB_FETCH_TOOL;
+    constructor(host) {
+        super(DirectWebFetchTool.Name, 'DirectWebFetch', 'Fetches content from a specified URL and converts it to the requested format (text, markdown, or html).', Kind.Search, {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The URL to fetch content from',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['text', 'markdown', 'html'],
+                    description: 'The format to return the content in (text, markdown, or html)',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Optional timeout in seconds (max 120)',
+                },
+            },
+            required: ['url', 'format'],
+        });
+        this.host = host;
+    }
+    createInvocation(params, messageBus) {
+        return new DirectWebFetchToolInvocation(this.host, params, messageBus);
+    }
+}
+class DirectWebFetchToolInvocation extends BaseToolInvocation {
+    constructor(_host, params, messageBus) {
+        super(params, messageBus);
+    }
+    getDescription() {
+        return `Fetch content from ${this.params.url}`;
+    }
+    async execute(signal, _updateOutput) {
+        const protocolError = this.validateUrlProtocol();
+        if (protocolError)
+            return protocolError;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.getTimeoutMs());
+        const onAbort = () => controller.abort();
+        signal.addEventListener('abort', onAbort);
+        try {
+            if (signal.aborted)
+                return this.createAbortResult();
+            const response = await this.fetchResponse(controller.signal);
+            const arrayBuffer = await this.readBoundedResponse(response);
+            const content = new TextDecoder().decode(arrayBuffer);
+            const output = this.convertContent(content, 
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- Preserve prior empty-string fallback for missing/blank content-type.
+            response.headers.get('content-type') || '');
+            return {
+                llmContent: ensureJsonSafe(output),
+                returnDisplay: `Fetched ${this.params.url} as ${this.params.format}`,
+            };
+        }
+        catch (error) {
+            return this.createFetchErrorResult(error);
+        }
+        finally {
+            clearTimeout(timeoutId);
+            signal.removeEventListener('abort', onAbort);
+        }
+    }
+    validateUrlProtocol() {
+        if (this.params.url.startsWith('http://') ||
+            this.params.url.startsWith('https://')) {
+            return undefined;
+        }
+        return {
+            llmContent: 'URL must start with http:// or https://',
+            returnDisplay: 'Invalid URL',
+            error: {
+                message: 'Invalid URL protocol',
+                type: ToolErrorType.INVALID_ARGUMENT,
+            },
+        };
+    }
+    getTimeoutMs() {
+        return Math.min((this.params.timeout ?? DEFAULT_TIMEOUT / 1000) * 1000, MAX_TIMEOUT);
+    }
+    createAbortResult() {
+        return {
+            llmContent: 'Request was aborted before it could start',
+            returnDisplay: 'Request aborted',
+            error: {
+                message: 'Request was aborted before it could start',
+                type: ToolErrorType.FETCH_ERROR,
+            },
+        };
+    }
+    async fetchResponse(signal) {
+        return retryWithBackoff(async () => {
+            const resp = await fetch(this.params.url, {
+                signal,
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                    Accept: ACCEPT_HEADERS[this.params.format],
+                    'Accept-Language': 'en-US,en;q=0.9',
+                },
+            });
+            if (!resp.ok) {
+                const error = new Error(`Request failed with status code: ${resp.status}`);
+                error.status = resp.status;
+                throw error;
+            }
+            return resp;
+        }, {
+            maxAttempts: 3,
+            initialDelayMs: 500,
+            retryFetchErrors: true,
+            signal,
+        });
+    }
+    async readBoundedResponse(response) {
+        const contentLength = response.headers.get('content-length');
+        if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_SIZE) {
+            throw new Error('Response too large (exceeds 5MB limit)');
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        if (arrayBuffer.byteLength > MAX_RESPONSE_SIZE) {
+            throw new Error('Response too large (exceeds 5MB limit)');
+        }
+        return arrayBuffer;
+    }
+    convertContent(content, contentType) {
+        if (this.params.format === 'markdown' &&
+            contentType.includes('text/html')) {
+            return this.convertHTMLToMarkdown(content);
+        }
+        if (this.params.format === 'text' && contentType.includes('text/html')) {
+            return this.extractTextFromHTML(content);
+        }
+        return content;
+    }
+    createFetchErrorResult(error) {
+        const errorMessage = this.formatErrorMessage(error);
+        return {
+            llmContent: `Error fetching URL: ${errorMessage}`,
+            returnDisplay: `Error: ${errorMessage}`,
+            error: {
+                message: errorMessage,
+                type: ToolErrorType.FETCH_ERROR,
+            },
+        };
+    }
+    formatErrorMessage(error) {
+        if (!(error instanceof Error))
+            return String(error);
+        let errorMessage = error.message;
+        const err = error;
+        if (this.hasTruthyCause(err)) {
+            const causeMessage = err.cause instanceof Error ? err.cause.message : String(err.cause);
+            errorMessage += `: ${causeMessage}`;
+        }
+        return errorMessage;
+    }
+    hasTruthyCause(error) {
+        if (!('cause' in error))
+            return false;
+        return this.isTruthyCause(error.cause);
+    }
+    isTruthyCause(cause) {
+        if (cause === undefined || cause === null)
+            return false;
+        if (cause === false || cause === 0 || cause === '')
+            return false;
+        return !Number.isNaN(cause);
+    }
+    extractTextFromHTML(html) {
+        const $ = cheerio.load(html);
+        // Remove scripts, styles, etc.
+        $('script, style, noscript, iframe, object, embed').remove();
+        return $.text().trim();
+    }
+    convertHTMLToMarkdown(html) {
+        const turndownService = new TurndownService({
+            headingStyle: 'atx',
+            hr: '---',
+            bulletListMarker: '-',
+            codeBlockStyle: 'fenced',
+            emDelimiter: '*',
+        });
+        turndownService.remove(['script', 'style', 'meta', 'link']);
+        return turndownService.turndown(html);
+    }
+}
+//# sourceMappingURL=direct-web-fetch.js.map

package/dist/src/tools/direct-web-fetch.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IToolHost } from '../interfaces/index.js';
+import { EmojiFilter } from '../utils/EmojiFilter.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import type { EditToolParams } from './edit.js';
+/**
+ * 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 declare function countLineGuardedOccurrences(currentContent: string, oldString: string, replaceLine: number): number;
+/**
+ * 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 declare function applyLineGuardedReplacement(currentContent: string, oldString: string, newString: string, expectedReplacements: number, replaceLine: number): string;
+/**
+ * Gets emoji filter instance based on configuration
+ */
+export declare function getEmojiFilter(host: IToolHost): EmojiFilter;
+/**
+ * Applies a replacement to content.
+ */
+export declare function applyReplacement(currentContent: string | null, oldString: string, newString: string, isNewFile: boolean, expectedReplacements?: number): string;
+/**
+ * Error information for edit operations.
+ */
+export interface EditErrorInfo {
+    display: string;
+    raw: string;
+    type: ToolErrorType;
+}
+/**
+ * Builds the error object when zero occurrences are found.
+ */
+export declare function buildNoOccurrenceError(filteredParams: EditToolParams, currentContent: string | null, filePath: string): EditErrorInfo;
+/**
+ * Validates the edit parameters after reading file content and builds the
+ * appropriate error object if any validation fails.
+ */
+export declare function validateEditState(filteredParams: EditToolParams, currentContent: string | null, fileExists: boolean, filePath: string, occurrences: number, expectedReplacements: number, finalOldString: string, finalNewString: string): EditErrorInfo | undefined;