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

package/dist/src/tools/ls.js

@@ -0,0 +1,238 @@
+/**
+ * @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 fs from 'fs';
+import path from 'path';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+class LSToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+    }
+    getDirPath() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: string fallback chain for optional params
+        return this.params.dir_path || this.params.path || '';
+    }
+    /**
+     * Checks whether a filename matches any of the ignore patterns.
+     * @param filename Filename to check
+     * @param patterns Array of glob patterns to check against
+     * @returns True when the filename matches an ignore pattern.
+     */
+    shouldIgnore(filename, patterns) {
+        if (!patterns || patterns.length === 0) {
+            return false;
+        }
+        for (const pattern of patterns) {
+            // Convert glob pattern to RegExp
+            const regexPattern = pattern
+                // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening; behavior preserved.
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*/g, '.*')
+                .replace(/\?/g, '.');
+            const regex = new RegExp(`^${regexPattern}$`);
+            if (regex.test(filename)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Gets a description of the file reading operation
+     * @returns A string describing the file being read
+     */
+    getDescription() {
+        const dirPath = this.getDirPath();
+        const relativePath = makeRelative(dirPath, this.host.getTargetDir());
+        return shortenPath(relativePath);
+    }
+    // Helper for consistent error formatting
+    errorResult(llmContent, returnDisplay, type) {
+        return {
+            llmContent,
+            // Keep returnDisplay simpler in core logic
+            returnDisplay: `Error: ${returnDisplay}`,
+            error: {
+                message: llmContent,
+                type,
+            },
+        };
+    }
+    /**
+     * Executes the LS operation with the given parameters
+     * @returns Result of the LS operation
+     */
+    async execute(_signal) {
+        try {
+            const dirPath = this.getDirPath();
+            const stats = fs.statSync(dirPath);
+            if (!stats.isDirectory()) {
+                return this.errorResult(`Error: Path is not a directory: ${dirPath}`, `Path is not a directory.`, ToolErrorType.PATH_IS_NOT_A_DIRECTORY);
+            }
+            const files = fs.readdirSync(dirPath);
+            if (files.length === 0) {
+                return {
+                    llmContent: `Directory ${dirPath} is empty.`,
+                    returnDisplay: `Directory is empty.`,
+                };
+            }
+            const { entries, ignoredCount } = this.collectEntries(dirPath, files);
+            return this.formatListingResult(dirPath, entries, ignoredCount);
+        }
+        catch (error) {
+            const errorMsg = `Error listing directory: ${error instanceof Error ? error.message : String(error)}`;
+            return this.errorResult(errorMsg, 'Failed to list directory.', ToolErrorType.LS_EXECUTION_ERROR);
+        }
+    }
+    collectEntries(dirPath, files) {
+        const defaultFileIgnores = this.host.getFileFilteringOptions();
+        const fileFilteringOptions = {
+            respectGitIgnore: this.params.file_filtering_options?.respect_git_ignore ??
+                defaultFileIgnores.respectGitIgnore,
+            respectLlxprtIgnore: this.params.file_filtering_options?.respect_llxprt_ignore ??
+                defaultFileIgnores.respectLlxprtIgnore,
+        };
+        const fileDiscovery = this.host.getFileService();
+        const entries = [];
+        let ignoredCount = 0;
+        // 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 file of files) {
+            if (this.shouldIgnore(file, this.params.ignore)) {
+                continue;
+            }
+            const fullPath = path.join(dirPath, file);
+            const relativePath = path.relative(this.host.getTargetDir(), fullPath);
+            if (fileFilteringOptions.respectGitIgnore &&
+                fileDiscovery.shouldGitIgnoreFile(relativePath)) {
+                ignoredCount++;
+                continue;
+            }
+            if (fileFilteringOptions.respectLlxprtIgnore &&
+                fileDiscovery.shouldLlxprtIgnoreFile(relativePath)) {
+                ignoredCount++;
+                continue;
+            }
+            try {
+                const stats = fs.statSync(fullPath);
+                const isDir = stats.isDirectory();
+                entries.push({
+                    name: file,
+                    path: fullPath,
+                    isDirectory: isDir,
+                    size: isDir ? 0 : stats.size,
+                    modifiedTime: stats.mtime,
+                });
+            }
+            catch (error) {
+                debugLogger.error(`Error accessing ${fullPath}: ${error}`);
+            }
+        }
+        return { entries, ignoredCount };
+    }
+    formatListingResult(dirPath, entries, ignoredCount) {
+        entries.sort((a, b) => {
+            if (a.isDirectory && !b.isDirectory)
+                return -1;
+            if (!a.isDirectory && b.isDirectory)
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        const directoryContent = entries
+            .map((entry) => `${entry.isDirectory ? '[DIR] ' : ''}${entry.name}`)
+            .join('\n');
+        let resultMessage = `Directory listing for ${dirPath}:\n${directoryContent}`;
+        if (ignoredCount > 0) {
+            resultMessage += `\n\n(${ignoredCount} ignored)`;
+        }
+        let displayMessage = `Listed ${entries.length} item(s).`;
+        if (ignoredCount > 0) {
+            displayMessage += ` (${ignoredCount} ignored)`;
+        }
+        return {
+            llmContent: resultMessage,
+            returnDisplay: displayMessage,
+        };
+    }
+}
+/**
+ * Implementation of the LS tool logic
+ */
+export class LSTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'list_directory';
+    constructor(host, messageBus) {
+        super(LSTool.Name, 'ReadFolder', 'Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.', Kind.Search, {
+            properties: {
+                dir_path: {
+                    description: 'The absolute path to the directory to list (must be absolute, not relative)',
+                    type: 'string',
+                },
+                path: {
+                    description: 'Alternative parameter name for dir_path (for backward compatibility).',
+                    type: 'string',
+                },
+                ignore: {
+                    description: 'List of glob patterns to ignore',
+                    items: {
+                        type: 'string',
+                    },
+                    type: 'array',
+                },
+                file_filtering_options: {
+                    description: 'Optional: Whether to respect ignore patterns from .gitignore or .llxprtignore',
+                    type: 'object',
+                    properties: {
+                        respect_git_ignore: {
+                            description: 'Optional: Whether to respect .gitignore patterns when listing files. Only available in git repositories. Defaults to true.',
+                            type: 'boolean',
+                        },
+                        respect_llxprt_ignore: {
+                            description: 'Optional: Whether to respect .llxprtignore patterns when listing files. Defaults to true.',
+                            type: 'boolean',
+                        },
+                    },
+                },
+            },
+            required: [],
+            type: 'object',
+        }, true, false, messageBus);
+        this.host = host;
+    }
+    createInvocation(params, messageBus) {
+        const normalizedParams = { ...params };
+        if (!normalizedParams.dir_path && normalizedParams.path) {
+            normalizedParams.dir_path = normalizedParams.path;
+        }
+        return new LSToolInvocation(this.host, normalizedParams, messageBus);
+    }
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    validateToolParamValues(params) {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string should fall through to validation
+        const dirPath = params.dir_path || params.path;
+        if (!dirPath || dirPath.trim() === '') {
+            return "Either 'dir_path' or 'path' parameter must be provided and non-empty.";
+        }
+        if (!path.isAbsolute(dirPath)) {
+            return `Path must be absolute: ${dirPath}`;
+        }
+        const pathError = validatePathWithinWorkspace(this.host.getWorkspaceRoots(), dirPath, 'Path');
+        if (pathError) {
+            return pathError;
+        }
+        const noValidationError = null;
+        return noValidationError;
+    }
+}
+//# sourceMappingURL=ls.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolEditConfirmationDetails, type ToolResult } from './tools.js';
+import type { ISettingsService, IStorageService, IToolMessageBus } from '../interfaces/index.js';
+import { type ModifiableDeclarativeTool, type ModifyContext } from './modifiable-tool.js';
+export declare const LLXPRT_CONFIG_DIR = ".llxprt";
+export declare const GEMINI_DIR = ".llxprt";
+export declare const DEFAULT_CONTEXT_FILENAME = "LLXPRT.md";
+export declare const CORE_MEMORY_FILENAME = ".LLXPRT_SYSTEM";
+export declare const MEMORY_SECTION_HEADER = "## LLxprt Code Added Memories";
+export declare function setLlxprtMdFilename(newFilename: string | string[]): void;
+export declare function getCurrentLlxprtMdFilename(): string;
+export declare function getAllLlxprtMdFilenames(): string[];
+type MemoryScope = 'global' | 'project' | 'core.global' | 'core.project';
+export interface SaveMemoryParams {
+    fact?: string;
+    content?: string;
+    read?: boolean;
+    scope?: MemoryScope;
+    modified_by_user?: boolean;
+    modified_content?: string;
+}
+export declare function getGlobalCoreMemoryFilePath(storageService?: Pick<IStorageService, 'getLLXPRTDir'>): string;
+export declare function getProjectCoreMemoryFilePath(workingDir: string): string;
+export interface MemoryToolDependencies {
+    storageService: IStorageService;
+    settingsService?: Pick<ISettingsService, 'getSetting'>;
+    getWorkingDir?: () => string;
+    messageBus?: IToolMessageBus;
+}
+declare class MemoryToolInvocation extends BaseToolInvocation<SaveMemoryParams, ToolResult> {
+    private readonly storageService;
+    private getWorkingDir?;
+    private static readonly allowlist;
+    constructor(params: SaveMemoryParams, messageBus: IToolMessageBus, storageService: IStorageService, getWorkingDir?: (() => string) | undefined);
+    setWorkingDir(workingDir: string): void;
+    private resolveWorkingDir;
+    getMemoryFilePath(): string;
+    readMemoryFileContent(): Promise<string>;
+    getToolName(): string;
+    getDescription(): string;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolEditConfirmationDetails | false>;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}
+export declare class MemoryTool extends BaseDeclarativeTool<SaveMemoryParams, ToolResult> implements ModifiableDeclarativeTool<SaveMemoryParams> {
+    static readonly Name: string;
+    private readonly storageService;
+    private readonly settingsService?;
+    private readonly getWorkingDir?;
+    constructor(dependencies?: MemoryToolDependencies | IStorageService);
+    protected validateToolParamValues(params: SaveMemoryParams): string | null;
+    protected createInvocation(params: SaveMemoryParams, messageBus: IToolMessageBus): MemoryToolInvocation;
+    execute(params: SaveMemoryParams): Promise<ToolResult>;
+    static performAddMemoryEntry(text: string, memoryFilePath: string, fsAdapter: {
+        readFile: (path: string, encoding: 'utf-8') => Promise<string>;
+        writeFile: (path: string, data: string, encoding: 'utf-8') => Promise<void>;
+        mkdir: (path: string, options: {
+            recursive: boolean;
+        }) => Promise<string | undefined>;
+    }): Promise<void>;
+    getModifyContext(_abortSignal: AbortSignal): ModifyContext<SaveMemoryParams>;
+}
+export {};