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

package/dist/src/tools/ripGrep.js

@@ -0,0 +1,395 @@
+/**
+ * @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 fsPromises from 'fs/promises';
+import path from 'path';
+import { EOL } from 'os';
+import { spawn } from 'child_process';
+// import { rgPath } from '@lvce-editor/ripgrep'; // Now using getRipgrepPath() instead
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { getRipgrepPath } from '../utils/ripgrepPathResolver.js';
+import { resolveTextSearchTarget, } from '../utils/resolveTextSearchTarget.js';
+import { debugLogger } from '../utils/debugLogger.js';
+export const ripGrepDebugLogger = debugLogger;
+const DEFAULT_TOTAL_MAX_MATCHES = 20000;
+class GrepToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+    }
+    resolveTarget(relativePath) {
+        return resolveTextSearchTarget(this.host.getTargetDir(), this.host.getWorkspaceRoots(), relativePath);
+    }
+    async handleFileSearch(resolved, searchDirDisplay, signal) {
+        const fileResult = await this.performSingleFileSearch(this.params.pattern, resolved.filePath, signal);
+        let includeNote = '';
+        if (this.params.include) {
+            includeNote =
+                '\nNote: include filter ignored because a specific file path was provided.';
+        }
+        if (fileResult.length === 0) {
+            const noMatchMsg = `No matches found for pattern "${this.params.pattern}" in file "${searchDirDisplay}".${includeNote}`;
+            return { llmContent: noMatchMsg, returnDisplay: 'No matches found' };
+        }
+        const matchTerm = fileResult.length === 1 ? 'match' : 'matches';
+        let llmContent = `Found ${fileResult.length} ${matchTerm} for pattern "${this.params.pattern}" in file "${searchDirDisplay}":${includeNote}
+---
+File: ${resolved.basename}
+`;
+        for (const match of fileResult) {
+            llmContent += `L${match.lineNumber}: ${match.line.trim()}
+`;
+        }
+        llmContent += '---';
+        return {
+            llmContent: llmContent.trim(),
+            returnDisplay: `Found ${fileResult.length} ${matchTerm}`,
+        };
+    }
+    resolveSearchDirectories(searchDirAbs, workspaceContext) {
+        if (searchDirAbs === null) {
+            return workspaceContext.getDirectories();
+        }
+        return [searchDirAbs];
+    }
+    collectDirectoryMatches(searchDirectories, signal) {
+        return this.collectDirectoryMatchesImpl(searchDirectories, signal, DEFAULT_TOTAL_MAX_MATCHES);
+    }
+    async collectDirectoryMatchesImpl(searchDirectories, signal, totalMaxMatches) {
+        let allMatches = [];
+        if (this.host.getDebugMode()) {
+            debugLogger.debug(`[GrepTool] Total result limit: ${totalMaxMatches}`);
+        }
+        for (const searchDir of searchDirectories) {
+            const searchResult = await this.performRipgrepSearch({
+                pattern: this.params.pattern,
+                path: searchDir,
+                include: this.params.include,
+                signal,
+            });
+            if (searchDirectories.length > 1) {
+                const dirName = path.basename(searchDir);
+                searchResult.forEach((match) => {
+                    match.filePath = path.join(dirName, match.filePath);
+                });
+            }
+            allMatches = allMatches.concat(searchResult);
+            if (allMatches.length >= totalMaxMatches) {
+                allMatches = allMatches.slice(0, totalMaxMatches);
+                break;
+            }
+        }
+        return allMatches;
+    }
+    buildSearchLocationDescription(searchDirAbs, searchDirDisplay, workspaceContext) {
+        if (searchDirAbs === null) {
+            const numDirs = workspaceContext.getDirectories().length;
+            return numDirs > 1
+                ? `across ${numDirs} workspace directories`
+                : `in the workspace directory`;
+        }
+        return `in path "${searchDirDisplay}"`;
+    }
+    formatDirectoryResults(allMatches, searchLocationDescription) {
+        const totalMaxMatches = DEFAULT_TOTAL_MAX_MATCHES;
+        if (allMatches.length === 0) {
+            const noMatchMsg = `No matches found for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}.`;
+            return { llmContent: noMatchMsg, returnDisplay: `No matches found` };
+        }
+        const wasTruncated = allMatches.length >= totalMaxMatches;
+        const matchesByFile = allMatches.reduce((acc, match) => {
+            const fileKey = match.filePath;
+            acc[fileKey] ??= [];
+            const fileMatches = acc[fileKey];
+            fileMatches.push(match);
+            fileMatches.sort((a, b) => a.lineNumber - b.lineNumber);
+            return acc;
+        }, {});
+        const matchCount = allMatches.length;
+        const matchTerm = matchCount === 1 ? 'match' : 'matches';
+        let llmContent = `Found ${matchCount} ${matchTerm} for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}`;
+        if (wasTruncated) {
+            llmContent += ` (results limited to ${totalMaxMatches} matches for performance)`;
+        }
+        llmContent += `:\n---\n`;
+        for (const filePath in matchesByFile) {
+            llmContent += `File: ${filePath}\n`;
+            matchesByFile[filePath].forEach((match) => {
+                const trimmedLine = match.line.trim();
+                llmContent += `L${match.lineNumber}: ${trimmedLine}\n`;
+            });
+            llmContent += '---\n';
+        }
+        let displayMessage = `Found ${matchCount} ${matchTerm}`;
+        if (wasTruncated) {
+            displayMessage += ` (limited)`;
+        }
+        return {
+            llmContent: llmContent.trim(),
+            returnDisplay: displayMessage,
+        };
+    }
+    async execute(signal) {
+        try {
+            const workspaceContext = {
+                getDirectories: () => this.host.getWorkspaceRoots(),
+            };
+            const resolved = this.resolveTarget(this.params.path);
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: path param may be empty string, display '.' instead
+            const searchDirDisplay = this.params.path || '.';
+            if (resolved.kind === 'file') {
+                return await this.handleFileSearch(resolved, searchDirDisplay, signal);
+            }
+            const searchDirAbs = resolved.kind === 'directory' ? resolved.searchDir : null;
+            const searchDirectories = this.resolveSearchDirectories(searchDirAbs, workspaceContext);
+            const allMatches = await this.collectDirectoryMatches(searchDirectories, signal);
+            const searchLocationDescription = this.buildSearchLocationDescription(searchDirAbs, searchDirDisplay, workspaceContext);
+            return this.formatDirectoryResults(allMatches, searchLocationDescription);
+        }
+        catch (error) {
+            debugLogger.warn(`Error during GrepLogic execution: ${error}`);
+            const errorMessage = getErrorMessage(error);
+            return {
+                llmContent: `Error during grep search operation: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+            };
+        }
+    }
+    parseRipgrepOutput(output, basePath) {
+        const results = [];
+        if (!output)
+            return results;
+        const lines = output.split(EOL);
+        // eslint-disable-next-line sonarjs/too-many-break-or-continue-in-loop -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            const firstColonIndex = line.indexOf(':');
+            if (firstColonIndex === -1)
+                continue;
+            const secondColonIndex = line.indexOf(':', firstColonIndex + 1);
+            if (secondColonIndex === -1)
+                continue;
+            const filePathRaw = line.substring(0, firstColonIndex);
+            const lineNumberStr = line.substring(firstColonIndex + 1, secondColonIndex);
+            const lineContent = line.substring(secondColonIndex + 1);
+            const lineNumber = parseInt(lineNumberStr, 10);
+            if (!isNaN(lineNumber)) {
+                const absoluteFilePath = path.resolve(basePath, filePathRaw);
+                const relativeFilePath = path.relative(basePath, absoluteFilePath);
+                results.push({
+                    filePath: relativeFilePath || path.basename(absoluteFilePath),
+                    lineNumber,
+                    line: lineContent,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns the path to .llxprtignore file if it exists and has patterns.
+     * Only returns path if patterns are non-empty (excluding comments/blank lines).
+     */
+    getLlxprtIgnorePath() {
+        return this.host.getLlxprtIgnoreFilePath();
+    }
+    async runRipgrepProcess(rgArgs, signal) {
+        const resolvedRgPath = await getRipgrepPath();
+        return new Promise((resolve, reject) => {
+            const child = spawn(resolvedRgPath, rgArgs, {
+                windowsHide: true,
+            });
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            const cleanup = () => {
+                if (signal.aborted) {
+                    child.kill();
+                }
+            };
+            signal.addEventListener('abort', cleanup, { once: true });
+            child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+            child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+            child.on('error', (err) => {
+                signal.removeEventListener('abort', cleanup);
+                reject(new Error(`Failed to start ripgrep: ${err.message}. Please ensure @lvce-editor/ripgrep is properly installed.`));
+            });
+            child.on('close', (code) => {
+                signal.removeEventListener('abort', cleanup);
+                const stdoutData = Buffer.concat(stdoutChunks).toString('utf8');
+                const stderrData = Buffer.concat(stderrChunks).toString('utf8');
+                if (code === 0) {
+                    resolve(stdoutData);
+                }
+                else if (code === 1) {
+                    resolve(''); // No matches found
+                }
+                else {
+                    reject(new Error(`ripgrep exited with code ${code}: ${stderrData}`));
+                }
+            });
+        });
+    }
+    buildRipgrepArgs(pattern, absolutePath, include) {
+        const rgArgs = [
+            '--line-number',
+            '--no-heading',
+            '--with-filename',
+            '--ignore-case',
+            '--regexp',
+            pattern,
+        ];
+        if (include) {
+            rgArgs.push('--glob', include);
+        }
+        const excludes = [
+            '.git',
+            'node_modules',
+            'bower_components',
+            '*.log',
+            '*.tmp',
+            'build',
+            'dist',
+            'coverage',
+        ];
+        excludes.forEach((exclude) => {
+            rgArgs.push('--glob', `!${exclude}`);
+        });
+        if (this.host.getFileFilteringRespectLlxprtIgnore()) {
+            const llxprtIgnorePath = this.getLlxprtIgnorePath();
+            if (llxprtIgnorePath) {
+                rgArgs.push('--ignore-file', llxprtIgnorePath);
+            }
+        }
+        rgArgs.push('--threads', '4');
+        rgArgs.push(absolutePath);
+        return rgArgs;
+    }
+    async performRipgrepSearch(options) {
+        const { pattern, path: absolutePath, include, signal } = options;
+        const rgArgs = this.buildRipgrepArgs(pattern, absolutePath, include);
+        try {
+            const output = await this.runRipgrepProcess(rgArgs, signal);
+            return this.parseRipgrepOutput(output, absolutePath);
+        }
+        catch (error) {
+            debugLogger.debug(`GrepLogic: ripgrep failed: ${getErrorMessage(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Gets a description of the grep operation
+     * @param params Parameters for the grep operation
+     * @returns A string describing the grep
+     */
+    getDescription() {
+        let description = `'${this.params.pattern}'`;
+        if (this.params.include) {
+            description += ` in ${this.params.include}`;
+        }
+        if (this.params.path) {
+            try {
+                const resolved = this.resolveTarget(this.params.path);
+                if (resolved.kind === 'file') {
+                    const relativePath = makeRelative(resolved.filePath, this.host.getTargetDir());
+                    description += ` in file ${shortenPath(relativePath)}`;
+                    return description;
+                }
+            }
+            catch {
+                // Fall through to default path display on validation errors
+            }
+            const resolvedPath = path.resolve(this.host.getTargetDir(), this.params.path);
+            if (resolvedPath === this.host.getTargetDir() ||
+                this.params.path === '.') {
+                description += ` within ./`;
+            }
+            else {
+                const relativePath = makeRelative(resolvedPath, this.host.getTargetDir());
+                description += ` within ${shortenPath(relativePath)}`;
+            }
+        }
+        else {
+            const directories = this.host.getWorkspaceRoots();
+            if (directories.length > 1) {
+                description += ` across all workspace directories`;
+            }
+        }
+        return description;
+    }
+    async performSingleFileSearch(pattern, filePath, signal) {
+        if (signal.aborted) {
+            return [];
+        }
+        const regex = new RegExp(pattern, 'i');
+        const content = await fsPromises.readFile(filePath, 'utf8');
+        const lines = content.split(/\r?\n/);
+        const matches = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (regex.test(lines[i])) {
+                matches.push({
+                    filePath: path.basename(filePath),
+                    lineNumber: i + 1,
+                    line: lines[i],
+                });
+            }
+        }
+        return matches;
+    }
+}
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export class RipGrepTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'search_file_content';
+    constructor(host) {
+        super(RipGrepTool.Name, 'SearchText', 'Searches for a regular expression pattern within the content of files in a specified directory (or current working directory). Can filter files by a glob pattern. Returns the lines containing matches, along with their file paths and line numbers. Total results limited to 20,000 matches like VSCode.', Kind.Search, {
+            properties: {
+                pattern: {
+                    description: "The regular expression (regex) pattern to search for within file contents (e.g., 'function\\s+myFunction', 'import\\s+\\{.*\\}\\s+from\\s+.*').",
+                    type: 'string',
+                },
+                path: {
+                    description: 'Optional: The absolute path to the directory to search within. If omitted, searches the current working directory. Can also be a path to a specific file (will search only that file).',
+                    type: 'string',
+                },
+                include: {
+                    description: "Optional: A glob pattern to filter which files are searched (e.g., '*.js', '*.{ts,tsx}', 'src/**'). If omitted, searches all files (respecting potential global ignores).",
+                    type: 'string',
+                },
+            },
+            required: ['pattern'],
+            type: 'object',
+        });
+        this.host = host;
+    }
+    validateToolParams(params) {
+        const errors = SchemaValidator.validate(this.schema.parametersJsonSchema, params);
+        if (errors) {
+            return errors;
+        }
+        if (params.path) {
+            try {
+                resolveTextSearchTarget(this.host.getTargetDir(), this.host.getWorkspaceRoots(), params.path);
+            }
+            catch (error) {
+                return getErrorMessage(error);
+            }
+        }
+        return null;
+    }
+    createInvocation(params, messageBus) {
+        return new GrepToolInvocation(this.host, params, messageBus);
+    }
+    async execute(params, signal = new AbortController().signal) {
+        return this.build(params).execute(signal);
+    }
+}
+//# sourceMappingURL=ripGrep.js.map

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

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

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

@@ -0,0 +1,60 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-INTERFACE-OWNERSHIP, REQ-API-001
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolInvocation, ToolConfirmationOutcome, type ToolCallConfirmationDetails, type PolicyUpdateOptions } from './tools.js';
+import type { IToolMessageBus } from '../interfaces/IToolMessageBus.js';
+import type { IShellExecutionService } from '../interfaces/IShellExecutionService.js';
+import type { IShellToolHost } from '../interfaces/IShellToolHost.js';
+/** Throttle interval for shell output updates. */
+export declare const OUTPUT_UPDATE_INTERVAL_MS = 100;
+export interface ShellToolParams {
+    /** The shell command to execute. */
+    command: string;
+    /** Optional description of what this command does. */
+    description?: string;
+    /** Optional directory to execute the command in. */
+    dir_path?: string;
+    /** @deprecated Use dir_path instead. */
+    directory?: string;
+    /** Optional number of lines to show from the beginning of output. */
+    head_lines?: number;
+    /** Optional number of lines to show from the end of output. */
+    tail_lines?: number;
+    /** Optional grep pattern to filter output lines. */
+    grep_pattern?: string;
+    /** Optional grep flags (e.g., -i for case-insensitive, -v for inverted). */
+    grep_flags?: string[];
+    /** Optional timeout in seconds (-1 for unlimited). */
+    timeout_seconds?: number;
+}
+export declare class ShellToolInvocation extends BaseToolInvocation<ShellToolParams, ToolResult> {
+    private readonly host;
+    private allowlist;
+    constructor(host: IShellToolHost, params: ShellToolParams, allowlist: Set<string>, messageBus: IToolMessageBus);
+    getToolName(): string;
+    private getDirPath;
+    getDescription(): string;
+    protected getPolicyUpdateOptions(outcome: ToolConfirmationOutcome): PolicyUpdateOptions | undefined;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    execute(signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    private executeShell;
+    private validateFilterParams;
+    private resolveCwd;
+    private resolveDirPath;
+    private formatOutputContent;
+    private applyFilterDescription;
+    private buildExecutionError;
+    private createPreCancelledResult;
+    private resolveTimeoutSeconds;
+    private isInvocationAllowlisted;
+}
+export declare class ShellTool extends BaseDeclarativeTool<ShellToolParams, ToolResult> {
+    static readonly Name: string;
+    private allowlist;
+    private readonly host;
+    constructor(host: IShellToolHost | IShellExecutionService, messageBus?: IToolMessageBus);
+    protected validateToolParamValues(params: ShellToolParams): string | null;
+    execute(params: ShellToolParams, signal?: AbortSignal): Promise<ToolResult>;
+    protected createInvocation(params: ShellToolParams, messageBus: IToolMessageBus): ToolInvocation<ShellToolParams, ToolResult>;
+}