@office-ai/aioncli-core 0.2.3 → 0.18.4

package/dist/src/utils/ignorePatterns.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+/**
+ * Common ignore patterns used across multiple tools for basic exclusions.
+ * These are the most commonly ignored directories in development projects.
+ */
+export declare const COMMON_IGNORE_PATTERNS: string[];
+/**
+ * Binary file extension patterns that are typically excluded from text processing.
+ */
+export declare const BINARY_FILE_PATTERNS: string[];
+/**
+ * Media file patterns that require special handling in tools like read-many-files.
+ * These files can be processed as inlineData when explicitly requested.
+ */
+export declare const MEDIA_FILE_PATTERNS: string[];
+/**
+ * Common directory patterns that are typically ignored in development projects.
+ */
+export declare const COMMON_DIRECTORY_EXCLUDES: string[];
+/**
+ * Python-specific patterns.
+ */
+export declare const PYTHON_EXCLUDES: string[];
+/**
+ * System and environment file patterns.
+ */
+export declare const SYSTEM_FILE_EXCLUDES: string[];
+/**
+ * Comprehensive file exclusion patterns combining all common ignore patterns.
+ * These patterns are compatible with glob ignore patterns.
+ * Note: Media files (PDF, images) are not excluded here as they need special handling in read-many-files.
+ */
+export declare const DEFAULT_FILE_EXCLUDES: string[];
+/**
+ * Options for configuring file exclusion patterns.
+ */
+export interface ExcludeOptions {
+    /**
+     * Whether to include default exclusion patterns. Defaults to true.
+     */
+    includeDefaults?: boolean;
+    /**
+     * Additional custom patterns from configuration.
+     */
+    customPatterns?: string[];
+    /**
+     * Additional patterns provided at runtime (e.g., from CLI arguments).
+     */
+    runtimePatterns?: string[];
+    /**
+     * Whether to include dynamic patterns like the current Gemini MD filename. Defaults to true.
+     */
+    includeDynamicPatterns?: boolean;
+}
+/**
+ * Centralized file exclusion utility that provides configurable and extensible
+ * file exclusion patterns for different tools and use cases.
+ */
+export declare class FileExclusions {
+    private config?;
+    constructor(config?: Config | undefined);
+    /**
+     * Gets core ignore patterns for basic file operations like glob.
+     * These are the minimal essential patterns that should almost always be excluded.
+     */
+    getCoreIgnorePatterns(): string[];
+    /**
+     * Gets comprehensive default exclusion patterns for operations like read-many-files.
+     * Includes all standard exclusions: directories, binary files, system files, etc.
+     */
+    getDefaultExcludePatterns(options?: ExcludeOptions): string[];
+    /**
+     * Gets exclude patterns for read-many-files tool with legacy compatibility.
+     * This maintains the same behavior as the previous getDefaultExcludes() function.
+     */
+    getReadManyFilesExcludes(additionalExcludes?: string[]): string[];
+    /**
+     * Gets exclude patterns for glob tool operations.
+     * Uses core patterns by default but can be extended with additional patterns.
+     */
+    getGlobExcludes(additionalExcludes?: string[]): string[];
+    /**
+     * Builds exclude patterns with full customization options.
+     * This is the most flexible method for advanced use cases.
+     */
+    buildExcludePatterns(options: ExcludeOptions): string[];
+}
+/**
+ * Extracts file extensions from glob patterns.
+ * Converts patterns like glob/*.exe to .exe
+ * Handles brace expansion like glob/*.{js,ts} to .js and .ts
+ */
+export declare function extractExtensionsFromPatterns(patterns: string[]): string[];
+/**
+ * Binary file extensions extracted from BINARY_FILE_PATTERNS for quick lookup.
+ * Additional extensions not covered by the patterns are included for completeness.
+ */
+export declare const BINARY_EXTENSIONS: string[];

package/dist/src/utils/ignorePatterns.js

@@ -0,0 +1,220 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import { getCurrentGeminiMdFilename } from '../tools/memoryTool.js';
+/**
+ * Common ignore patterns used across multiple tools for basic exclusions.
+ * These are the most commonly ignored directories in development projects.
+ */
+export const COMMON_IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/bower_components/**',
+    '**/.svn/**',
+    '**/.hg/**',
+];
+/**
+ * Binary file extension patterns that are typically excluded from text processing.
+ */
+export const BINARY_FILE_PATTERNS = [
+    '**/*.bin',
+    '**/*.exe',
+    '**/*.dll',
+    '**/*.so',
+    '**/*.dylib',
+    '**/*.class',
+    '**/*.jar',
+    '**/*.war',
+    '**/*.zip',
+    '**/*.tar',
+    '**/*.gz',
+    '**/*.bz2',
+    '**/*.rar',
+    '**/*.7z',
+    '**/*.doc',
+    '**/*.docx',
+    '**/*.xls',
+    '**/*.xlsx',
+    '**/*.ppt',
+    '**/*.pptx',
+    '**/*.odt',
+    '**/*.ods',
+    '**/*.odp',
+];
+/**
+ * Media file patterns that require special handling in tools like read-many-files.
+ * These files can be processed as inlineData when explicitly requested.
+ */
+export const MEDIA_FILE_PATTERNS = [
+    '**/*.pdf',
+    '**/*.png',
+    '**/*.jpg',
+    '**/*.jpeg',
+    '**/*.gif',
+    '**/*.webp',
+    '**/*.bmp',
+    '**/*.svg',
+];
+/**
+ * Common directory patterns that are typically ignored in development projects.
+ */
+export const COMMON_DIRECTORY_EXCLUDES = [
+    '**/.vscode/**',
+    '**/.idea/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/__pycache__/**',
+];
+/**
+ * Python-specific patterns.
+ */
+export const PYTHON_EXCLUDES = ['**/*.pyc', '**/*.pyo'];
+/**
+ * System and environment file patterns.
+ */
+export const SYSTEM_FILE_EXCLUDES = ['**/.DS_Store', '**/.env'];
+/**
+ * Comprehensive file exclusion patterns combining all common ignore patterns.
+ * These patterns are compatible with glob ignore patterns.
+ * Note: Media files (PDF, images) are not excluded here as they need special handling in read-many-files.
+ */
+export const DEFAULT_FILE_EXCLUDES = [
+    ...COMMON_IGNORE_PATTERNS,
+    ...COMMON_DIRECTORY_EXCLUDES,
+    ...BINARY_FILE_PATTERNS,
+    ...PYTHON_EXCLUDES,
+    ...SYSTEM_FILE_EXCLUDES,
+];
+/**
+ * Centralized file exclusion utility that provides configurable and extensible
+ * file exclusion patterns for different tools and use cases.
+ */
+export class FileExclusions {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Gets core ignore patterns for basic file operations like glob.
+     * These are the minimal essential patterns that should almost always be excluded.
+     */
+    getCoreIgnorePatterns() {
+        return [...COMMON_IGNORE_PATTERNS];
+    }
+    /**
+     * Gets comprehensive default exclusion patterns for operations like read-many-files.
+     * Includes all standard exclusions: directories, binary files, system files, etc.
+     */
+    getDefaultExcludePatterns(options = {}) {
+        const { includeDefaults = true, customPatterns = [], runtimePatterns = [], includeDynamicPatterns = true, } = options;
+        const patterns = [];
+        // Add base defaults if requested
+        if (includeDefaults) {
+            patterns.push(...DEFAULT_FILE_EXCLUDES);
+        }
+        // Add dynamic patterns (like current Gemini MD filename)
+        if (includeDynamicPatterns) {
+            patterns.push(`**/${getCurrentGeminiMdFilename()}`);
+        }
+        // Add custom patterns from configuration
+        // TODO: getCustomExcludes method needs to be implemented in Config interface
+        if (this.config) {
+            const configCustomExcludes = this.config.getCustomExcludes?.() ?? [];
+            patterns.push(...configCustomExcludes);
+        }
+        // Add user-provided custom patterns
+        patterns.push(...customPatterns);
+        // Add runtime patterns (e.g., from CLI)
+        patterns.push(...runtimePatterns);
+        return patterns;
+    }
+    /**
+     * Gets exclude patterns for read-many-files tool with legacy compatibility.
+     * This maintains the same behavior as the previous getDefaultExcludes() function.
+     */
+    getReadManyFilesExcludes(additionalExcludes = []) {
+        return this.getDefaultExcludePatterns({
+            includeDefaults: true,
+            runtimePatterns: additionalExcludes,
+            includeDynamicPatterns: true,
+        });
+    }
+    /**
+     * Gets exclude patterns for glob tool operations.
+     * Uses core patterns by default but can be extended with additional patterns.
+     */
+    getGlobExcludes(additionalExcludes = []) {
+        const corePatterns = this.getCoreIgnorePatterns();
+        // Add any custom patterns from config if available
+        // TODO: getCustomExcludes method needs to be implemented in Config interface
+        const configPatterns = this.config?.getCustomExcludes?.() ?? [];
+        return [...corePatterns, ...configPatterns, ...additionalExcludes];
+    }
+    /**
+     * Builds exclude patterns with full customization options.
+     * This is the most flexible method for advanced use cases.
+     */
+    buildExcludePatterns(options) {
+        return this.getDefaultExcludePatterns(options);
+    }
+}
+/**
+ * Extracts file extensions from glob patterns.
+ * Converts patterns like glob/*.exe to .exe
+ * Handles brace expansion like glob/*.{js,ts} to .js and .ts
+ */
+export function extractExtensionsFromPatterns(patterns) {
+    const extensions = new Set(patterns
+        .filter((pattern) => pattern.includes('*.'))
+        .flatMap((pattern) => {
+        const extPart = pattern.substring(pattern.lastIndexOf('*.') + 1);
+        // Handle brace expansion e.g. `**/*.{jpg,png}`
+        if (extPart.startsWith('.{') && extPart.endsWith('}')) {
+            const inner = extPart.slice(2, -1); // get 'jpg,png'
+            return inner
+                .split(',')
+                .map((ext) => `.${ext.trim()}`)
+                .filter((ext) => ext !== '.');
+        }
+        // Handle simple/compound/dotfile extensions
+        if (extPart.startsWith('.') &&
+            !extPart.includes('/') &&
+            !extPart.includes('{') &&
+            !extPart.includes('}')) {
+            // Using path.extname on a dummy file handles various cases like
+            // '.tar.gz' -> '.gz' and '.profile' -> '.profile' correctly.
+            const extracted = path.extname(`dummy${extPart}`);
+            // If extname returns empty (e.g. for '.'), use the original part.
+            // Then filter out empty or '.' results and invalid double dot patterns.
+            const result = extracted || extPart;
+            return result && result !== '.' && !result.substring(1).includes('.')
+                ? [result]
+                : [];
+        }
+        return [];
+    }));
+    return Array.from(extensions).sort();
+}
+/**
+ * Binary file extensions extracted from BINARY_FILE_PATTERNS for quick lookup.
+ * Additional extensions not covered by the patterns are included for completeness.
+ */
+export const BINARY_EXTENSIONS = [
+    ...extractExtensionsFromPatterns([
+        ...BINARY_FILE_PATTERNS,
+        ...MEDIA_FILE_PATTERNS,
+        ...PYTHON_EXCLUDES,
+    ]),
+    // Additional binary extensions not in the main patterns
+    '.dat',
+    '.obj',
+    '.o',
+    '.a',
+    '.lib',
+    '.wasm',
+].sort();
+//# sourceMappingURL=ignorePatterns.js.map

package/dist/src/utils/ignorePatterns.js.map

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

package/dist/src/utils/ignorePatterns.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/ignorePatterns.test.js

@@ -0,0 +1,246 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { FileExclusions, BINARY_EXTENSIONS, extractExtensionsFromPatterns, } from './ignorePatterns.js';
+// Mock the memoryTool module
+vi.mock('../tools/memoryTool.js', () => ({
+    getCurrentGeminiMdFilename: vi.fn(() => 'GEMINI.md'),
+}));
+describe('FileExclusions', () => {
+    describe('getCoreIgnorePatterns', () => {
+        it('should return basic ignore patterns', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getCoreIgnorePatterns();
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            expect(patterns).toContain('**/bower_components/**');
+            expect(patterns).toContain('**/.svn/**');
+            expect(patterns).toContain('**/.hg/**');
+            expect(patterns).toHaveLength(5);
+        });
+    });
+    describe('getDefaultExcludePatterns', () => {
+        it('should return comprehensive patterns by default', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getDefaultExcludePatterns();
+            // Should include core patterns
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            // Should include directory excludes
+            expect(patterns).toContain('**/.vscode/**');
+            expect(patterns).toContain('**/dist/**');
+            expect(patterns).toContain('**/build/**');
+            // Should include binary patterns
+            expect(patterns).toContain('**/*.exe');
+            expect(patterns).toContain('**/*.jar');
+            // Should include system files
+            expect(patterns).toContain('**/.DS_Store');
+            expect(patterns).toContain('**/.env');
+            // Should include dynamic patterns
+            expect(patterns).toContain('**/GEMINI.md');
+        });
+        it('should respect includeDefaults option', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getDefaultExcludePatterns({
+                includeDefaults: false,
+                includeDynamicPatterns: false,
+            });
+            expect(patterns).not.toContain('**/node_modules/**');
+            expect(patterns).not.toContain('**/.git/**');
+            expect(patterns).not.toContain('**/GEMINI.md');
+            expect(patterns).toHaveLength(0);
+        });
+        it('should include custom patterns', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getDefaultExcludePatterns({
+                customPatterns: ['**/custom/**', '**/*.custom'],
+            });
+            expect(patterns).toContain('**/custom/**');
+            expect(patterns).toContain('**/*.custom');
+        });
+        it('should include runtime patterns', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getDefaultExcludePatterns({
+                runtimePatterns: ['**/temp/**', '**/*.tmp'],
+            });
+            expect(patterns).toContain('**/temp/**');
+            expect(patterns).toContain('**/*.tmp');
+        });
+        it('should respect includeDynamicPatterns option', () => {
+            const excluder = new FileExclusions();
+            const patternsWithDynamic = excluder.getDefaultExcludePatterns({
+                includeDynamicPatterns: true,
+            });
+            const patternsWithoutDynamic = excluder.getDefaultExcludePatterns({
+                includeDynamicPatterns: false,
+            });
+            expect(patternsWithDynamic).toContain('**/GEMINI.md');
+            expect(patternsWithoutDynamic).not.toContain('**/GEMINI.md');
+        });
+    });
+    describe('getReadManyFilesExcludes', () => {
+        it('should provide legacy compatibility', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getReadManyFilesExcludes(['**/*.log']);
+            // Should include all default patterns
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            expect(patterns).toContain('**/GEMINI.md');
+            // Should include additional excludes
+            expect(patterns).toContain('**/*.log');
+        });
+    });
+    describe('getGlobExcludes', () => {
+        it('should return core patterns for glob operations', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getGlobExcludes();
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            expect(patterns).toContain('**/bower_components/**');
+            expect(patterns).toContain('**/.svn/**');
+            expect(patterns).toContain('**/.hg/**');
+            // Should not include comprehensive patterns by default
+            expect(patterns).toHaveLength(5);
+        });
+        it('should include additional excludes', () => {
+            const excluder = new FileExclusions();
+            const patterns = excluder.getGlobExcludes(['**/temp/**']);
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            expect(patterns).toContain('**/temp/**');
+        });
+    });
+    describe('with Config', () => {
+        it('should use config custom excludes when available', () => {
+            const mockConfig = {
+                getCustomExcludes: vi.fn(() => ['**/config-exclude/**']),
+            };
+            const excluder = new FileExclusions(mockConfig);
+            const patterns = excluder.getDefaultExcludePatterns();
+            expect(patterns).toContain('**/config-exclude/**');
+            expect(mockConfig.getCustomExcludes).toHaveBeenCalled();
+        });
+        it('should handle config without getCustomExcludes method', () => {
+            const mockConfig = {};
+            const excluder = new FileExclusions(mockConfig);
+            const patterns = excluder.getDefaultExcludePatterns();
+            // Should not throw and should include default patterns
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns.length).toBeGreaterThan(0);
+        });
+        it('should include config custom excludes in glob patterns', () => {
+            const mockConfig = {
+                getCustomExcludes: vi.fn(() => ['**/config-glob/**']),
+            };
+            const excluder = new FileExclusions(mockConfig);
+            const patterns = excluder.getGlobExcludes();
+            expect(patterns).toContain('**/node_modules/**');
+            expect(patterns).toContain('**/.git/**');
+            expect(patterns).toContain('**/config-glob/**');
+        });
+    });
+    describe('buildExcludePatterns', () => {
+        it('should be an alias for getDefaultExcludePatterns', () => {
+            const excluder = new FileExclusions();
+            const options = {
+                includeDefaults: true,
+                customPatterns: ['**/test/**'],
+                runtimePatterns: ['**/runtime/**'],
+            };
+            const defaultPatterns = excluder.getDefaultExcludePatterns(options);
+            const buildPatterns = excluder.buildExcludePatterns(options);
+            expect(buildPatterns).toEqual(defaultPatterns);
+        });
+    });
+});
+describe('BINARY_EXTENSIONS', () => {
+    it.each([
+        ['common binary file extensions', ['.exe', '.dll', '.jar', '.zip']],
+        ['additional binary extensions', ['.dat', '.obj', '.wasm']],
+        ['media file extensions', ['.pdf', '.png', '.jpg']],
+    ])('should include %s', (_, extensions) => {
+        extensions.forEach((ext) => {
+            expect(BINARY_EXTENSIONS).toContain(ext);
+        });
+    });
+    it('should be sorted', () => {
+        const sortedExtensions = [...BINARY_EXTENSIONS].sort();
+        expect(BINARY_EXTENSIONS).toEqual(sortedExtensions);
+    });
+    it('should not contain invalid extensions from brace patterns', () => {
+        // If brace expansion was not handled correctly, we would see invalid extensions like '.{jpg,png}'
+        const invalidExtensions = BINARY_EXTENSIONS.filter((ext) => ext.includes('{') || ext.includes('}'));
+        expect(invalidExtensions).toHaveLength(0);
+    });
+});
+describe('extractExtensionsFromPatterns', () => {
+    it.each([
+        [
+            'simple extensions',
+            ['**/*.exe', '**/*.jar', '**/*.zip'],
+            ['.exe', '.jar', '.zip'],
+        ],
+        [
+            'compound extensions',
+            ['**/*.tar.gz', '**/*.min.js', '**/*.d.ts'],
+            ['.gz', '.js', '.ts'],
+        ],
+        [
+            'dotfiles',
+            ['**/*.gitignore', '**/*.profile', '**/*.bashrc'],
+            ['.bashrc', '.gitignore', '.profile'],
+        ],
+    ])('should extract %s', (_, patterns, expected) => {
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toEqual(expected);
+    });
+    it('should handle brace expansion patterns', () => {
+        const patterns = ['**/*.{js,ts}', '**/*.{jpg,png}'];
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toContain('.js');
+        expect(result).toContain('.ts');
+        expect(result).toContain('.jpg');
+        expect(result).toContain('.png');
+        expect(result).not.toContain('.{js,ts}');
+        expect(result).not.toContain('.{jpg,png}');
+    });
+    it('should combine simple and brace expansion patterns', () => {
+        const patterns = ['**/*.exe', '**/*.{js,ts}', '**/*.pdf'];
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toContain('.exe');
+        expect(result).toContain('.js');
+        expect(result).toContain('.ts');
+        expect(result).toContain('.pdf');
+    });
+    it('should handle empty brace expansion', () => {
+        const patterns = ['**/*.{}', '**/*.{,}'];
+        const result = extractExtensionsFromPatterns(patterns);
+        // Empty extensions should be filtered out
+        expect(result).toHaveLength(0);
+    });
+    it('should ignore invalid patterns', () => {
+        const patterns = ['no-asterisk.exe', '**/*no-dot', '**/*.{unclosed'];
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toHaveLength(0);
+    });
+    it('should remove duplicates and sort results', () => {
+        const patterns = ['**/*.js', '**/*.{js,ts}', '**/*.ts'];
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toEqual(['.js', '.ts']);
+    });
+    it('should handle complex brace patterns with multiple extensions', () => {
+        const patterns = ['**/*.{html,css,js,jsx,ts,tsx}'];
+        const result = extractExtensionsFromPatterns(patterns);
+        expect(result).toEqual(['.css', '.html', '.js', '.jsx', '.ts', '.tsx']);
+    });
+    it('should handle edge cases with path.extname', () => {
+        const patterns = ['**/*.hidden.', '**/*.config.json'];
+        const result = extractExtensionsFromPatterns(patterns);
+        // Should handle edge cases properly (trailing dots are filtered out)
+        expect(result).toEqual(['.json']);
+    });
+});
+//# sourceMappingURL=ignorePatterns.test.js.map

package/dist/src/utils/ignorePatterns.test.js.map

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

package/dist/src/utils/installationManager.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class InstallationManager {
+    private getInstallationIdPath;
+    private readInstallationIdFromFile;
+    private writeInstallationIdToFile;
+    /**
+     * Retrieves the installation ID from a file, creating it if it doesn't exist.
+     * This ID is used for unique user installation tracking.
+     * @returns A UUID string for the user.
+     */
+    getInstallationId(): string;
+}