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

package/dist/src/tools/read_line_range.js

@@ -0,0 +1,248 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable complexity, sonarjs/cognitive-complexity -- Phase 5: legacy core boundary retained while larger decomposition continues. */
+import path from 'path';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { processSingleFileContent, getSpecificMimeType, } from '../utils/fileUtils.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+import { getGitLineChanges } from '../utils/gitLineChanges.js';
+function formatWithLineNumbers(content, startLine) {
+    const lines = content.split('\n');
+    const maxLine = startLine + lines.length - 1;
+    const width = Math.max(4, String(maxLine).length);
+    return lines
+        .map((line, index) => {
+        const lineNo = startLine + index;
+        const padded = String(lineNo).padStart(width, ' ');
+        return `${padded}| ${line}`;
+    })
+        .join('\n');
+}
+function formatWithGitChanges(content, startLine, markers, deletionAfterLines, showLineNumbers) {
+    const lines = content.split('\n');
+    const maxLine = startLine + lines.length - 1;
+    const width = showLineNumbers ? Math.max(4, String(maxLine).length) : 0;
+    const formattedLines = [];
+    const hasDeletionBeforeRange = deletionAfterLines.has(startLine - 1) ||
+        deletionAfterLines.has(startLine) ||
+        (startLine === 1 && deletionAfterLines.has(0));
+    if (hasDeletionBeforeRange) {
+        if (showLineNumbers) {
+            const padded = ''.padStart(width, ' ');
+            formattedLines.push(`D${padded}|`);
+        }
+        else {
+            formattedLines.push('D');
+        }
+    }
+    formattedLines.push(...lines.map((line, index) => {
+        const lineNo = startLine + index;
+        const baseMarker = markers.get(lineNo) ?? '░';
+        const marker = deletionAfterLines.has(lineNo) ? 'D' : baseMarker;
+        if (showLineNumbers) {
+            const padded = String(lineNo).padStart(width, ' ');
+            return `${marker}${padded}| ${line}`;
+        }
+        return `${marker}${line}`;
+    }));
+    return formattedLines.join('\n');
+}
+class ReadLineRangeToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+    }
+    getDescription() {
+        const relativePath = makeRelative(this.params.absolute_path, this.host.getTargetDir());
+        return shortenPath(relativePath);
+    }
+    toolLocations() {
+        return [{ path: this.params.absolute_path, line: this.params.start_line }];
+    }
+    async fetchGitAnnotations(filePath) {
+        const gitResult = await getGitLineChanges(filePath);
+        return {
+            gitWarning: gitResult.warning,
+            markersByLine: gitResult.markersByLine,
+            deletionAfterLines: gitResult.deletionAfterLines,
+        };
+    }
+    applyTextFormatting(content, startLine, markersByLine, deletionAfterLines) {
+        if (this.params.showGitChanges === true &&
+            markersByLine &&
+            deletionAfterLines) {
+            return formatWithGitChanges(content, startLine, markersByLine, deletionAfterLines, this.params.showLineNumbers === true);
+        }
+        if (this.params.showLineNumbers === true) {
+            return formatWithLineNumbers(content, startLine);
+        }
+        return content;
+    }
+    prependGitHeader(llmContent, gitWarning) {
+        if (this.params.showGitChanges !== true) {
+            return llmContent;
+        }
+        const headerParts = [];
+        if (gitWarning) {
+            headerParts.push(`NOTE: Failed to read git change status: ${gitWarning}`);
+        }
+        headerParts.push('Git changes legend: ░ unchanged, N new, M modified, D deletion after line.');
+        return `${headerParts.join('\n')}\n\n${llmContent}`;
+    }
+    buildTruncatedLlmContent(result, gitWarning, markersByLine, deletionAfterLines) {
+        const [start, end] = result.linesShown;
+        const total = result.originalLineCount;
+        const formattedContent = this.applyTextFormatting(result.llmContent, this.params.start_line, markersByLine, deletionAfterLines);
+        const gitLegend = this.params.showGitChanges === true
+            ? `\nGit changes legend: ░ unchanged, N new, M modified, D deletion after line.\n`
+            : '';
+        const gitWarningText = this.params.showGitChanges === true && gitWarning !== undefined
+            ? `\nNOTE: Failed to read git change status: ${gitWarning}\n`
+            : '';
+        return `\nIMPORTANT: The file content has been truncated.${gitWarningText}${gitLegend}\nStatus: Showing lines ${start}-${end} of ${total} total lines.\nAction: To read more of the file, you can use the 'read_line_range' tool with adjusted 'start_line' and 'end_line' parameters.\n\n--- FILE CONTENT (truncated) ---\n${formattedContent}`;
+    }
+    buildFullLlmContent(result, gitWarning, markersByLine, deletionAfterLines) {
+        const formatted = this.applyTextFormatting(result.llmContent, this.params.start_line, markersByLine, deletionAfterLines);
+        return this.prependGitHeader(formatted, gitWarning);
+    }
+    recordReadMetric(llmContent, filePath) {
+        const lines = typeof llmContent === 'string'
+            ? llmContent.split('\n').length
+            : undefined;
+        const mimetype = getSpecificMimeType(filePath);
+        void lines;
+        void mimetype;
+        void filePath;
+    }
+    async execute() {
+        const offset = this.params.start_line - 1;
+        const limit = this.params.end_line - this.params.start_line + 1;
+        const result = await processSingleFileContent(this.params.absolute_path, this.host.getTargetDir(), offset, limit);
+        if (result.error) {
+            return {
+                llmContent: result.llmContent,
+                returnDisplay: result.returnDisplay || 'Error reading file',
+                error: { message: result.error, type: result.errorType },
+            };
+        }
+        let gitWarning;
+        let markersByLine;
+        let deletionAfterLines;
+        const shouldAnnotateGit = this.params.showGitChanges === true &&
+            typeof result.llmContent === 'string';
+        if (shouldAnnotateGit) {
+            ({ gitWarning, markersByLine, deletionAfterLines } =
+                await this.fetchGitAnnotations(this.params.absolute_path));
+        }
+        let llmContent;
+        if (typeof result.llmContent !== 'string') {
+            llmContent = result.llmContent;
+        }
+        else if (result.isTruncated === true) {
+            llmContent = this.buildTruncatedLlmContent(result, gitWarning, markersByLine, deletionAfterLines);
+        }
+        else {
+            llmContent = this.buildFullLlmContent(result, gitWarning, markersByLine, deletionAfterLines);
+        }
+        this.recordReadMetric(result.llmContent, this.params.absolute_path);
+        return {
+            llmContent,
+            returnDisplay: result.returnDisplay || '',
+        };
+    }
+}
+/**
+ * Implementation of the ReadLineRange tool logic
+ */
+export class ReadLineRangeTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'read_line_range';
+    constructor(host) {
+        super(ReadLineRangeTool.Name, 'ReadLineRange', `Reads a specific range of lines from a file. This is very useful for "copying" a function or class after finding its definition. The 'start_line' and 'end_line' parameters are 1-based and inclusive.
+
+Optional: when 'showGitChanges' is true, prefixes each returned text line with a single-character git-change marker column and includes a legend.
+Legend: '░' unchanged, 'N' new, 'M' modified, 'D' deletion after line.
+Column order: git marker first, then (optional) virtual line number column, then line content.
+The git marker column is virtual and not part of the file content.
+If git status cannot be read, the tool will still return file content and include a brief warning.`, Kind.Read, {
+            properties: {
+                absolute_path: {
+                    description: "The absolute path to the file to read (e.g., '/home/user/project/file.txt'). Relative paths are not supported. You must provide an absolute path.",
+                    type: 'string',
+                },
+                file_path: {
+                    description: 'Alternative parameter name for absolute_path (for backward compatibility). The absolute path to the file to read.',
+                    type: 'string',
+                },
+                start_line: {
+                    description: 'The 1-based line number to start reading from (inclusive).',
+                    type: 'number',
+                    minimum: 1,
+                },
+                end_line: {
+                    description: 'The 1-based line number to end reading at (inclusive). Must be >= start_line.',
+                    type: 'number',
+                    minimum: 1,
+                },
+                showLineNumbers: {
+                    description: 'Optional: When true, prefixes each returned line with its 1-based virtual line number and a separator bar (for example, " 294| const x = 1;"). This numbering is not part of the underlying file; it is only a visual aid. Recommended when you need to precisely understand line numbers in large files for follow-up editing operations.',
+                    type: 'boolean',
+                },
+                showGitChanges: {
+                    description: "Optional: When true (text files only), prefixes each returned line with a single-character git-change marker column computed relative to HEAD (includes both staged and unstaged changes). This marker column is virtual and not part of the file content. Legend: '░' unchanged, 'N' new, 'M' modified, 'D' deletion after line. Column order: git marker first, then (optional) the virtual line number column, then line content. If git status cannot be read, content is still returned and a brief warning is included.",
+                    type: 'boolean',
+                },
+            },
+            required: ['start_line', 'end_line'],
+            type: 'object',
+        });
+        this.host = host;
+    }
+    validateToolParamValues(params) {
+        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 ReadLineRangeToolInvocation(this.host, normalizedParams, messageBus);
+    }
+    async execute(params, signal = new AbortController().signal) {
+        const result = await this.build(params).execute(signal);
+        if (typeof result.llmContent === 'string') {
+            return { ...result, returnDisplay: result.llmContent };
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=read_line_range.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from './tools.js';
+import type { IToolHost, IToolMessageBus } from '../interfaces/index.js';
+export declare const ripGrepDebugLogger: {
+    error: (..._args: unknown[]) => void;
+    warn: (..._args: unknown[]) => void;
+    debug: (..._args: unknown[]) => void;
+    log: (..._args: unknown[]) => void;
+};
+/**
+ * Parameters for the GrepTool
+ */
+export interface RipGrepToolParams {
+    /**
+     * The regular expression pattern to search for in file contents
+     */
+    pattern: string;
+    /**
+     * The directory to search in (optional, defaults to current directory relative to root)
+     */
+    path?: string;
+    /**
+     * File pattern to include in the search (e.g. "*.js", "*.{ts,tsx}")
+     */
+    include?: string;
+}
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export declare class RipGrepTool extends BaseDeclarativeTool<RipGrepToolParams, ToolResult> {
+    private readonly host;
+    static readonly Name = "search_file_content";
+    constructor(host: IToolHost);
+    validateToolParams(params: RipGrepToolParams): string | null;
+    protected createInvocation(params: RipGrepToolParams, messageBus: IToolMessageBus): ToolInvocation<RipGrepToolParams, ToolResult>;
+    execute(params: RipGrepToolParams, signal?: AbortSignal): Promise<ToolResult>;
+}