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

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

@@ -0,0 +1,49 @@
+/**
+ * @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';
+/**
+ * Parameters for the ReadFile tool
+ */
+export interface ReadFileToolParams {
+    /**
+     * The absolute path to the file to read
+     */
+    absolute_path?: string;
+    /**
+     * Alternative parameter name for absolute_path (for compatibility)
+     * Not shown in schema - internal use only
+     */
+    file_path?: string;
+    /**
+     * The line number to start reading from (optional)
+     */
+    offset?: number;
+    /**
+     * The number of lines to read (optional)
+     */
+    limit?: number;
+    /**
+     * When true, prefixes each text line with a virtual line number.
+     */
+    showLineNumbers?: boolean;
+    /**
+     * When true, prefixes each text line with a git-change marker column.
+     */
+    showGitChanges?: boolean;
+}
+/**
+ * Implementation of the ReadFile tool logic
+ */
+export declare class ReadFileTool extends BaseDeclarativeTool<ReadFileToolParams, ToolResult> {
+    private host;
+    static readonly Name: string;
+    constructor(host: IToolHost);
+    protected validateToolParamValues(params: ReadFileToolParams): string | null;
+    protected createInvocation(params: ReadFileToolParams, messageBus: IToolMessageBus): ToolInvocation<ReadFileToolParams, ToolResult>;
+    execute(params: ReadFileToolParams, signal?: AbortSignal): Promise<ToolResult>;
+    private normalizeLegacyExecutableResult;
+}

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

@@ -0,0 +1,279 @@
+/**
+ * @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 'node:path';
+import process from 'node:process';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { processSingleFileContent, getSpecificMimeType, DEFAULT_MAX_LINES_TEXT_FILE, } from '../utils/fileUtils.js';
+import { getGitLineChanges } from '../utils/gitLineChanges.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.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 ReadFileToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+    }
+    getFilePath() {
+        // Use absolute_path if provided, otherwise fall back to file_path
+        /* eslint-disable @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: multi-line || chain with terminator, absolute_path/file_path are optional strings with fallthrough intent */
+        return this.params.absolute_path || this.params.file_path || '';
+        /* eslint-enable @typescript-eslint/prefer-nullish-coalescing */
+    }
+    getDescription() {
+        const relativePath = makeRelative(this.getFilePath(), this.host.getTargetDir());
+        return shortenPath(relativePath);
+    }
+    toolLocations() {
+        return [{ path: this.getFilePath(), line: this.params.offset }];
+    }
+    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 != null &&
+            deletionAfterLines != null) {
+            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 != null) {
+            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 nextOffset = this.params.offset != null ? this.params.offset + end - start + 1 : end;
+        const startLine = this.params.offset != null ? this.params.offset + 1 : start;
+        const formattedContent = this.applyTextFormatting(result.llmContent, startLine, 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 != null
+            ? `\nNOTE: Failed to read git change status: ${gitWarning}\n`
+            : '';
+        return `
+IMPORTANT: The file content has been truncated.${gitWarningText}${gitLegend}
+Status: Showing lines ${start}-${end} of ${total} total lines.
+Action: To read more of the file, you can use the 'offset' and 'limit' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use offset: ${nextOffset}.
+
+--- FILE CONTENT (truncated) ---
+${formattedContent}`;
+    }
+    buildFullLlmContent(result, gitWarning, markersByLine, deletionAfterLines) {
+        const startLine = this.params.offset != null ? this.params.offset + 1 : 1;
+        const formatted = this.applyTextFormatting(result.llmContent, startLine, 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 ephemeralSettings = this.host.getEphemeralSettings();
+        const effectiveLimit = this.params.limit ??
+            ephemeralSettings['file-read-max-lines'] ??
+            DEFAULT_MAX_LINES_TEXT_FILE;
+        const result = await processSingleFileContent(this.getFilePath(), this.host.getTargetDir(), this.params.offset, effectiveLimit);
+        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.getFilePath()));
+        }
+        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.getFilePath());
+        return {
+            llmContent,
+            returnDisplay: result.returnDisplay || '',
+        };
+    }
+}
+/**
+ * Implementation of the ReadFile tool logic
+ */
+export class ReadFileTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'read_file';
+    constructor(host) {
+        super(ReadFileTool.Name, 'ReadFile', `Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'offset' and 'limit' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), audio files (MP3, WAV, AIFF, AAC, OGG, FLAC), and PDF files. For text files, it can read specific line ranges.
+
+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 underlying 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: process.platform === 'win32'
+                        ? "The absolute path to the file to read (e.g., 'C:\\Users\\project\\file.txt'). Relative paths are not supported. You must provide an absolute path."
+                        : "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',
+                },
+                offset: {
+                    description: "Optional: For text files, the 0-based line number to start reading from. Requires 'limit' to be set. Use for paginating through large files.",
+                    type: 'number',
+                },
+                limit: {
+                    description: "Optional: For text files, maximum number of lines to read. Use with 'offset' to paginate through large files. If omitted, reads the entire file (if feasible, up to a default limit).",
+                    type: 'number',
+                },
+                showLineNumbers: {
+                    description: 'Optional: When true, prefixes each line of the returned text with a left-padded 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 subsequent 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 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',
+                },
+            },
+            // Don't require either in schema - validation handles this
+            type: 'object',
+        });
+        this.host = host;
+    }
+    validateToolParamValues(params) {
+        // Accept either absolute_path or file_path
+        /* eslint-disable @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: multi-line || chain with terminator, absolute_path/file_path are optional strings with fallthrough intent */
+        const filePath = params.absolute_path || params.file_path || '';
+        /* eslint-enable @typescript-eslint/prefer-nullish-coalescing */
+        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, but was relative: ${filePath}. You must provide an absolute path.`;
+        }
+        const pathError = validatePathWithinWorkspace(this.host.getWorkspaceRoots(), filePath);
+        if (pathError) {
+            return pathError;
+        }
+        if (params.offset !== undefined && params.offset < 0) {
+            return 'Offset must be a non-negative number';
+        }
+        if (params.limit !== undefined && params.limit <= 0) {
+            return 'Limit must be a positive number';
+        }
+        const fileService = this.host.getFileService();
+        if (fileService.shouldLlxprtIgnoreFile(filePath)) {
+            return `File path '${filePath}' is ignored by .llxprtignore pattern(s).`;
+        }
+        return null;
+    }
+    createInvocation(params, messageBus) {
+        // Normalize parameters: if file_path is provided but not absolute_path, copy it over
+        const normalizedParams = { ...params };
+        if (!normalizedParams.absolute_path && normalizedParams.file_path) {
+            normalizedParams.absolute_path = normalizedParams.file_path;
+        }
+        return new ReadFileToolInvocation(this.host, normalizedParams, messageBus);
+    }
+    async execute(params, signal = new AbortController().signal) {
+        const result = await this.build(params).execute(signal);
+        return this.normalizeLegacyExecutableResult(result);
+    }
+    normalizeLegacyExecutableResult(result) {
+        const normalized = { ...result };
+        if (normalized.returnDisplay === '' &&
+            typeof normalized.llmContent === 'string') {
+            normalized.returnDisplay = normalized.llmContent;
+        }
+        if (normalized.error != null) {
+            return {
+                ...normalized,
+                llmContent: normalized.error.message,
+                error: normalized.error.message,
+            };
+        }
+        return normalized;
+    }
+}
+//# sourceMappingURL=read-file.js.map

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

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

package/dist/src/tools/read-many-files.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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';
+/**
+ * Parameters for the ReadManyFilesTool.
+ */
+export interface ReadManyFilesParams {
+    /**
+     * An array of file paths or directory paths to search within.
+     * Paths are relative to the tool's configured target directory.
+     * Glob patterns can be used directly in these paths.
+     */
+    paths: string[];
+    /**
+     * Optional. Glob patterns for files to include.
+     * These are effectively combined with the `paths`.
+     * Example: ["*.ts", "src/** /*.md"]
+     */
+    include?: string[];
+    /**
+     * Optional. Glob patterns for files/directories to exclude.
+     * Applied as ignore patterns.
+     * Example: ["*.log", "dist/**"]
+     */
+    exclude?: string[];
+    /**
+     * Optional. Search directories recursively.
+     * This is generally controlled by glob patterns (e.g., `**`).
+     * The glob implementation is recursive by default for `**`.
+     * For simplicity, we'll rely on `**` for recursion.
+     */
+    recursive?: boolean;
+    /**
+     * Optional. Apply default exclusion patterns. Defaults to true.
+     */
+    useDefaultExcludes?: boolean;
+    /**
+     * Whether to respect .gitignore and .llxprtignore patterns (optional, defaults to true)
+     */
+    file_filtering_options?: {
+        respect_git_ignore?: boolean;
+        respect_llxprt_ignore?: boolean;
+    };
+}
+/**
+ * Tool implementation for finding and reading multiple text files from the local filesystem
+ * within a specified target directory. The content is concatenated.
+ * It is intended to run in an environment with access to the local file system (e.g., a Node.js backend).
+ */
+export declare class ReadManyFilesTool extends BaseDeclarativeTool<ReadManyFilesParams, ToolResult> {
+    private host;
+    static readonly Name: string;
+    constructor(host: IToolHost);
+    protected createInvocation(params: ReadManyFilesParams, messageBus: IToolMessageBus): ToolInvocation<ReadManyFilesParams, ToolResult>;
+    execute(params: ReadManyFilesParams, signal?: AbortSignal): Promise<ToolResult>;
+}