@terminai/core 0.21.0

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import type { FileFilteringOptions } from '../config/constants.js';
+/** Options for customizing folder structure retrieval. */
+interface FolderStructureOptions {
+    /** Maximum number of files and folders combined to display. Defaults to 200. */
+    maxItems?: number;
+    /** Set of folder names to ignore completely. Case-sensitive. */
+    ignoredFolders?: Set<string>;
+    /** Optional regex to filter included files by name. */
+    fileIncludePattern?: RegExp;
+    /** For filtering files. */
+    fileService?: FileDiscoveryService;
+    /** File filtering ignore options. */
+    fileFilteringOptions?: FileFilteringOptions;
+}
+/**
+ * Generates a string representation of a directory's structure,
+ * limiting the number of items displayed. Ignored folders are shown
+ * followed by '...' instead of their contents.
+ *
+ * @param directory The absolute or relative path to the directory.
+ * @param options Optional configuration settings.
+ * @returns A promise resolving to the formatted folder structure string.
+ */
+export declare function getFolderStructure(directory: string, options?: FolderStructureOptions): Promise<string>;
+export {};

package/dist/src/utils/getFolderStructure.js

@@ -0,0 +1,239 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getErrorMessage, isNodeError } from './errors.js';
+import { DEFAULT_FILE_FILTERING_OPTIONS } from '../config/constants.js';
+import { debugLogger } from './debugLogger.js';
+const MAX_ITEMS = 200;
+const TRUNCATION_INDICATOR = '...';
+const DEFAULT_IGNORED_FOLDERS = new Set(['node_modules', '.git', 'dist']);
+// --- Interfaces ---
+// --- Helper Functions ---
+async function readFullStructure(rootPath, options) {
+    const rootName = path.basename(rootPath);
+    const rootNode = {
+        name: rootName,
+        path: rootPath,
+        files: [],
+        subFolders: [],
+        totalChildren: 0,
+        totalFiles: 0,
+    };
+    const queue = [
+        { folderInfo: rootNode, currentPath: rootPath },
+    ];
+    let currentItemCount = 0;
+    // Count the root node itself as one item if we are not just listing its content
+    const processedPaths = new Set(); // To avoid processing same path if symlinks create loops
+    while (queue.length > 0) {
+        const { folderInfo, currentPath } = queue.shift();
+        if (processedPaths.has(currentPath)) {
+            continue;
+        }
+        processedPaths.add(currentPath);
+        if (currentItemCount >= options.maxItems) {
+            // If the root itself caused us to exceed, we can't really show anything.
+            // Otherwise, this folder won't be processed further.
+            // The parent that queued this would have set its own hasMoreSubfolders flag.
+            continue;
+        }
+        let entries;
+        try {
+            const rawEntries = await fs.readdir(currentPath, { withFileTypes: true });
+            // Sort entries alphabetically by name for consistent processing order
+            entries = rawEntries.sort((a, b) => a.name.localeCompare(b.name));
+        }
+        catch (error) {
+            if (isNodeError(error) &&
+                (error.code === 'EACCES' || error.code === 'ENOENT')) {
+                debugLogger.warn(`Warning: Could not read directory ${currentPath}: ${error.message}`);
+                if (currentPath === rootPath && error.code === 'ENOENT') {
+                    return null; // Root directory itself not found
+                }
+                // For other EACCES/ENOENT on subdirectories, just skip them.
+                continue;
+            }
+            throw error;
+        }
+        const filesInCurrentDir = [];
+        const subFoldersInCurrentDir = [];
+        const filterFileOptions = {
+            respectGitIgnore: options.fileFilteringOptions?.respectGitIgnore,
+            respectGeminiIgnore: options.fileFilteringOptions?.respectGeminiIgnore,
+        };
+        // Process files first in the current directory
+        for (const entry of entries) {
+            if (entry.isFile()) {
+                if (currentItemCount >= options.maxItems) {
+                    folderInfo.hasMoreFiles = true;
+                    break;
+                }
+                const fileName = entry.name;
+                const filePath = path.join(currentPath, fileName);
+                if (options.fileService?.shouldIgnoreFile(filePath, filterFileOptions)) {
+                    continue;
+                }
+                if (!options.fileIncludePattern ||
+                    options.fileIncludePattern.test(fileName)) {
+                    filesInCurrentDir.push(fileName);
+                    currentItemCount++;
+                    folderInfo.totalFiles++;
+                    folderInfo.totalChildren++;
+                }
+            }
+        }
+        folderInfo.files = filesInCurrentDir;
+        // Then process directories and queue them
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                // Check if adding this directory ITSELF would meet or exceed maxItems
+                // (currentItemCount refers to items *already* added before this one)
+                if (currentItemCount >= options.maxItems) {
+                    folderInfo.hasMoreSubfolders = true;
+                    break; // Already at limit, cannot add this folder or any more
+                }
+                // If adding THIS folder makes us hit the limit exactly, and it might have children,
+                // it's better to show '...' for the parent, unless this is the very last item slot.
+                // This logic is tricky. Let's try a simpler: if we can't add this item, mark and break.
+                const subFolderName = entry.name;
+                const subFolderPath = path.join(currentPath, subFolderName);
+                const isIgnored = options.fileService?.shouldIgnoreFile(subFolderPath, filterFileOptions) ?? false;
+                if (options.ignoredFolders.has(subFolderName) || isIgnored) {
+                    const ignoredSubFolder = {
+                        name: subFolderName,
+                        path: subFolderPath,
+                        files: [],
+                        subFolders: [],
+                        totalChildren: 0,
+                        totalFiles: 0,
+                        isIgnored: true,
+                    };
+                    subFoldersInCurrentDir.push(ignoredSubFolder);
+                    currentItemCount++; // Count the ignored folder itself
+                    folderInfo.totalChildren++; // Also counts towards parent's children
+                    continue;
+                }
+                const subFolderNode = {
+                    name: subFolderName,
+                    path: subFolderPath,
+                    files: [],
+                    subFolders: [],
+                    totalChildren: 0,
+                    totalFiles: 0,
+                };
+                subFoldersInCurrentDir.push(subFolderNode);
+                currentItemCount++;
+                folderInfo.totalChildren++; // Counts towards parent's children
+                // Add to queue for processing its children later
+                queue.push({ folderInfo: subFolderNode, currentPath: subFolderPath });
+            }
+        }
+        folderInfo.subFolders = subFoldersInCurrentDir;
+    }
+    return rootNode;
+}
+/**
+ * Reads the directory structure using BFS, respecting maxItems.
+ * @param node The current node in the reduced structure.
+ * @param indent The current indentation string.
+ * @param isLast Sibling indicator.
+ * @param builder Array to build the string lines.
+ */
+function formatStructure(node, currentIndent, isLastChildOfParent, isProcessingRootNode, builder) {
+    const connector = isLastChildOfParent ? '└───' : '├───';
+    // The root node of the structure (the one passed initially to getFolderStructure)
+    // is not printed with a connector line itself, only its name as a header.
+    // Its children are printed relative to that conceptual root.
+    // Ignored root nodes ARE printed with a connector.
+    if (!isProcessingRootNode || node.isIgnored) {
+        builder.push(`${currentIndent}${connector}${node.name}${path.sep}${node.isIgnored ? TRUNCATION_INDICATOR : ''}`);
+    }
+    // Determine the indent for the children of *this* node.
+    // If *this* node was the root of the whole structure, its children start with no indent before their connectors.
+    // Otherwise, children's indent extends from the current node's indent.
+    const indentForChildren = isProcessingRootNode
+        ? ''
+        : currentIndent + (isLastChildOfParent ? '    ' : '│   ');
+    // Render files of the current node
+    const fileCount = node.files.length;
+    for (let i = 0; i < fileCount; i++) {
+        const isLastFileAmongSiblings = i === fileCount - 1 &&
+            node.subFolders.length === 0 &&
+            !node.hasMoreSubfolders;
+        const fileConnector = isLastFileAmongSiblings ? '└───' : '├───';
+        builder.push(`${indentForChildren}${fileConnector}${node.files[i]}`);
+    }
+    if (node.hasMoreFiles) {
+        const isLastIndicatorAmongSiblings = node.subFolders.length === 0 && !node.hasMoreSubfolders;
+        const fileConnector = isLastIndicatorAmongSiblings ? '└───' : '├───';
+        builder.push(`${indentForChildren}${fileConnector}${TRUNCATION_INDICATOR}`);
+    }
+    // Render subfolders of the current node
+    const subFolderCount = node.subFolders.length;
+    for (let i = 0; i < subFolderCount; i++) {
+        const isLastSubfolderAmongSiblings = i === subFolderCount - 1 && !node.hasMoreSubfolders;
+        // Children are never the root node being processed initially.
+        formatStructure(node.subFolders[i], indentForChildren, isLastSubfolderAmongSiblings, false, builder);
+    }
+    if (node.hasMoreSubfolders) {
+        builder.push(`${indentForChildren}└───${TRUNCATION_INDICATOR}`);
+    }
+}
+// --- Main Exported Function ---
+/**
+ * Generates a string representation of a directory's structure,
+ * limiting the number of items displayed. Ignored folders are shown
+ * followed by '...' instead of their contents.
+ *
+ * @param directory The absolute or relative path to the directory.
+ * @param options Optional configuration settings.
+ * @returns A promise resolving to the formatted folder structure string.
+ */
+export async function getFolderStructure(directory, options) {
+    const resolvedPath = path.resolve(directory);
+    const mergedOptions = {
+        maxItems: options?.maxItems ?? MAX_ITEMS,
+        ignoredFolders: options?.ignoredFolders ?? DEFAULT_IGNORED_FOLDERS,
+        fileIncludePattern: options?.fileIncludePattern,
+        fileService: options?.fileService,
+        fileFilteringOptions: options?.fileFilteringOptions ?? DEFAULT_FILE_FILTERING_OPTIONS,
+    };
+    try {
+        // 1. Read the structure using BFS, respecting maxItems
+        const structureRoot = await readFullStructure(resolvedPath, mergedOptions);
+        if (!structureRoot) {
+            return `Error: Could not read directory "${resolvedPath}". Check path and permissions.`;
+        }
+        // 2. Format the structure into a string
+        const structureLines = [];
+        // Pass true for isRoot for the initial call
+        formatStructure(structureRoot, '', true, true, structureLines);
+        // 3. Build the final output string
+        function isTruncated(node) {
+            if (node.hasMoreFiles || node.hasMoreSubfolders || node.isIgnored) {
+                return true;
+            }
+            for (const sub of node.subFolders) {
+                if (isTruncated(sub)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        let summary = `Showing up to ${mergedOptions.maxItems} items (files + folders).`;
+        if (isTruncated(structureRoot)) {
+            summary += ` Folders or files indicated with ${TRUNCATION_INDICATOR} contain more items not shown, were ignored, or the display limit (${mergedOptions.maxItems} items) was reached.`;
+        }
+        return `${summary}\n\n${resolvedPath}${path.sep}\n${structureLines.join('\n')}`;
+    }
+    catch (error) {
+        console.error(`Error getting folder structure for ${resolvedPath}:`, error);
+        return `Error processing directory "${resolvedPath}": ${getErrorMessage(error)}`;
+    }
+}
+//# sourceMappingURL=getFolderStructure.js.map

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

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

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

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

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

@@ -0,0 +1,284 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fsPromises from 'node:fs/promises';
+import * as nodePath from 'node:path';
+import * as os from 'node:os';
+import { getFolderStructure } from './getFolderStructure.js';
+import { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import * as path from 'node:path';
+import { GEMINI_DIR } from './paths.js';
+describe('getFolderStructure', () => {
+    let testRootDir;
+    async function createEmptyDir(...pathSegments) {
+        const fullPath = path.join(testRootDir, ...pathSegments);
+        await fsPromises.mkdir(fullPath, { recursive: true });
+    }
+    async function createTestFile(...pathSegments) {
+        const fullPath = path.join(testRootDir, ...pathSegments);
+        await fsPromises.mkdir(path.dirname(fullPath), { recursive: true });
+        await fsPromises.writeFile(fullPath, '');
+        return fullPath;
+    }
+    beforeEach(async () => {
+        testRootDir = await fsPromises.mkdtemp(path.join(os.tmpdir(), 'folder-structure-test-'));
+    });
+    afterEach(async () => {
+        await fsPromises.rm(testRootDir, { recursive: true, force: true });
+    });
+    it('should return basic folder structure', async () => {
+        await createTestFile('fileA1.ts');
+        await createTestFile('fileA2.js');
+        await createTestFile('subfolderB', 'fileB1.md');
+        const structure = await getFolderStructure(testRootDir);
+        expect(structure.trim()).toBe(`
+Showing up to 200 items (files + folders).
+
+${testRootDir}${path.sep}
+├───fileA1.ts
+├───fileA2.js
+└───subfolderB${path.sep}
+    └───fileB1.md
+`.trim());
+    });
+    it('should handle an empty folder', async () => {
+        const structure = await getFolderStructure(testRootDir);
+        expect(structure.trim()).toBe(`
+Showing up to 200 items (files + folders).
+
+${testRootDir}${path.sep}
+`
+            .trim()
+            .trim());
+    });
+    it('should ignore folders specified in ignoredFolders (default)', async () => {
+        await createTestFile('.hiddenfile');
+        await createTestFile('file1.txt');
+        await createEmptyDir('emptyFolder');
+        await createTestFile('node_modules', 'somepackage', 'index.js');
+        await createTestFile('subfolderA', 'fileA1.ts');
+        await createTestFile('subfolderA', 'fileA2.js');
+        await createTestFile('subfolderA', 'subfolderB', 'fileB1.md');
+        const structure = await getFolderStructure(testRootDir);
+        expect(structure.trim()).toBe(`
+Showing up to 200 items (files + folders). Folders or files indicated with ... contain more items not shown, were ignored, or the display limit (200 items) was reached.
+
+${testRootDir}${path.sep}
+├───.hiddenfile
+├───file1.txt
+├───emptyFolder${path.sep}
+├───node_modules${path.sep}...
+└───subfolderA${path.sep}
+    ├───fileA1.ts
+    ├───fileA2.js
+    └───subfolderB${path.sep}
+        └───fileB1.md
+`.trim());
+    });
+    it('should ignore folders specified in custom ignoredFolders', async () => {
+        await createTestFile('.hiddenfile');
+        await createTestFile('file1.txt');
+        await createEmptyDir('emptyFolder');
+        await createTestFile('node_modules', 'somepackage', 'index.js');
+        await createTestFile('subfolderA', 'fileA1.ts');
+        const structure = await getFolderStructure(testRootDir, {
+            ignoredFolders: new Set(['subfolderA', 'node_modules']),
+        });
+        const expected = `
+Showing up to 200 items (files + folders). Folders or files indicated with ... contain more items not shown, were ignored, or the display limit (200 items) was reached.
+
+${testRootDir}${path.sep}
+├───.hiddenfile
+├───file1.txt
+├───emptyFolder${path.sep}
+├───node_modules${path.sep}...
+└───subfolderA${path.sep}...
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    it('should filter files by fileIncludePattern', async () => {
+        await createTestFile('fileA1.ts');
+        await createTestFile('fileA2.js');
+        await createTestFile('subfolderB', 'fileB1.md');
+        const structure = await getFolderStructure(testRootDir, {
+            fileIncludePattern: /\.ts$/,
+        });
+        const expected = `
+Showing up to 200 items (files + folders).
+
+${testRootDir}${path.sep}
+├───fileA1.ts
+└───subfolderB${path.sep}
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    it('should handle maxItems truncation for files within a folder', async () => {
+        await createTestFile('fileA1.ts');
+        await createTestFile('fileA2.js');
+        await createTestFile('subfolderB', 'fileB1.md');
+        const structure = await getFolderStructure(testRootDir, {
+            maxItems: 3,
+        });
+        const expected = `
+Showing up to 3 items (files + folders).
+
+${testRootDir}${path.sep}
+├───fileA1.ts
+├───fileA2.js
+└───subfolderB${path.sep}
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    it('should handle maxItems truncation for subfolders', async () => {
+        for (let i = 0; i < 5; i++) {
+            await createTestFile(`folder-${i}`, 'child.txt');
+        }
+        const structure = await getFolderStructure(testRootDir, {
+            maxItems: 4,
+        });
+        const expectedRevised = `
+Showing up to 4 items (files + folders). Folders or files indicated with ... contain more items not shown, were ignored, or the display limit (4 items) was reached.
+
+${testRootDir}${path.sep}
+├───folder-0${path.sep}
+├───folder-1${path.sep}
+├───folder-2${path.sep}
+├───folder-3${path.sep}
+└───...
+`.trim();
+        expect(structure.trim()).toBe(expectedRevised);
+    });
+    it('should handle maxItems that only allows the root folder itself', async () => {
+        await createTestFile('fileA1.ts');
+        await createTestFile('fileA2.ts');
+        await createTestFile('subfolderB', 'fileB1.ts');
+        const structure = await getFolderStructure(testRootDir, {
+            maxItems: 1,
+        });
+        const expected = `
+Showing up to 1 items (files + folders). Folders or files indicated with ... contain more items not shown, were ignored, or the display limit (1 items) was reached.
+
+${testRootDir}${path.sep}
+├───fileA1.ts
+├───...
+└───...
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    it('should handle non-existent directory', async () => {
+        const nonExistentPath = path.join(testRootDir, 'non-existent');
+        const structure = await getFolderStructure(nonExistentPath);
+        expect(structure).toContain(`Error: Could not read directory "${nonExistentPath}". Check path and permissions.`);
+    });
+    it('should handle deep folder structure within limits', async () => {
+        await createTestFile('level1', 'level2', 'level3', 'file.txt');
+        const structure = await getFolderStructure(testRootDir, {
+            maxItems: 10,
+        });
+        const expected = `
+Showing up to 10 items (files + folders).
+
+${testRootDir}${path.sep}
+└───level1${path.sep}
+    └───level2${path.sep}
+        └───level3${path.sep}
+            └───file.txt
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    it('should truncate deep folder structure if maxItems is small', async () => {
+        await createTestFile('level1', 'level2', 'level3', 'file.txt');
+        const structure = await getFolderStructure(testRootDir, {
+            maxItems: 3,
+        });
+        const expected = `
+Showing up to 3 items (files + folders).
+
+${testRootDir}${path.sep}
+└───level1${path.sep}
+    └───level2${path.sep}
+        └───level3${path.sep}
+`.trim();
+        expect(structure.trim()).toBe(expected);
+    });
+    describe('with gitignore', () => {
+        beforeEach(async () => {
+            await fsPromises.mkdir(path.join(testRootDir, '.git'), {
+                recursive: true,
+            });
+        });
+        it('should ignore files and folders specified in .gitignore', async () => {
+            await fsPromises.writeFile(nodePath.join(testRootDir, '.gitignore'), `ignored.txt\nnode_modules/\n${GEMINI_DIR}/*\n!/${GEMINI_DIR}/config.yaml`);
+            await createTestFile('file1.txt');
+            await createTestFile('node_modules', 'some-package', 'index.js');
+            await createTestFile('ignored.txt');
+            await createTestFile(GEMINI_DIR, 'config.yaml');
+            await createTestFile(GEMINI_DIR, 'logs.json');
+            const fileService = new FileDiscoveryService(testRootDir);
+            const structure = await getFolderStructure(testRootDir, {
+                fileService,
+            });
+            expect(structure).not.toContain('ignored.txt');
+            expect(structure).toContain(`node_modules${path.sep}...`);
+            expect(structure).not.toContain('logs.json');
+            expect(structure).toContain('config.yaml');
+            expect(structure).toContain('file1.txt');
+        });
+        it('should not ignore files if respectGitIgnore is false', async () => {
+            await fsPromises.writeFile(nodePath.join(testRootDir, '.gitignore'), 'ignored.txt');
+            await createTestFile('file1.txt');
+            await createTestFile('ignored.txt');
+            const fileService = new FileDiscoveryService(testRootDir);
+            const structure = await getFolderStructure(testRootDir, {
+                fileService,
+                fileFilteringOptions: {
+                    respectGeminiIgnore: false,
+                    respectGitIgnore: false,
+                },
+            });
+            expect(structure).toContain('ignored.txt');
+            expect(structure).toContain('file1.txt');
+        });
+    });
+    describe('with geminiignore', () => {
+        it('should ignore geminiignore files by default', async () => {
+            await fsPromises.writeFile(nodePath.join(testRootDir, '.geminiignore'), `ignored.txt\nnode_modules/\n${GEMINI_DIR}/\n!/${GEMINI_DIR}/config.yaml`);
+            await createTestFile('file1.txt');
+            await createTestFile('node_modules', 'some-package', 'index.js');
+            await createTestFile('ignored.txt');
+            await createTestFile(GEMINI_DIR, 'config.yaml');
+            await createTestFile(GEMINI_DIR, 'logs.json');
+            const fileService = new FileDiscoveryService(testRootDir);
+            const structure = await getFolderStructure(testRootDir, {
+                fileService,
+            });
+            expect(structure).not.toContain('ignored.txt');
+            expect(structure).toContain(`node_modules${path.sep}...`);
+            expect(structure).not.toContain('logs.json');
+        });
+        it('should not ignore files if respectGeminiIgnore is false', async () => {
+            await fsPromises.writeFile(nodePath.join(testRootDir, '.geminiignore'), `ignored.txt\nnode_modules/\n${GEMINI_DIR}/\n!/${GEMINI_DIR}/config.yaml`);
+            await createTestFile('file1.txt');
+            await createTestFile('node_modules', 'some-package', 'index.js');
+            await createTestFile('ignored.txt');
+            await createTestFile(GEMINI_DIR, 'config.yaml');
+            await createTestFile(GEMINI_DIR, 'logs.json');
+            const fileService = new FileDiscoveryService(testRootDir);
+            const structure = await getFolderStructure(testRootDir, {
+                fileService,
+                fileFilteringOptions: {
+                    respectGeminiIgnore: false,
+                    respectGitIgnore: true, // Explicitly disable gemini ignore only
+                },
+            });
+            expect(structure).toContain('ignored.txt');
+            // node_modules is still ignored by default
+            expect(structure).toContain(`node_modules${path.sep}...`);
+        });
+    });
+});
+//# sourceMappingURL=getFolderStructure.test.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type PtyImplementation = {
+    module: any;
+    name: 'lydell-node-pty' | 'node-pty';
+} | null;
+export interface PtyProcess {
+    readonly pid: number;
+    onData(callback: (data: string) => void): void;
+    onExit(callback: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    kill(signal?: string): void;
+}
+export declare const getPty: () => Promise<PtyImplementation>;

package/dist/src/utils/getPty.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const getPty = async () => {
+    try {
+        const lydell = '@lydell/node-pty';
+        const module = await import(lydell);
+        return { module, name: 'lydell-node-pty' };
+    }
+    catch (_e) {
+        try {
+            const nodePty = 'node-pty';
+            const module = await import(nodePty);
+            return { module, name: 'node-pty' };
+        }
+        catch (_e2) {
+            return null;
+        }
+    }
+};
+//# sourceMappingURL=getPty.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPty.js","sourceRoot":"","sources":["../../../src/utils/getPty.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,IAAgC,EAAE;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Checks if a file is tracked by git in the current workspace.
+ * Uses `git ls-files --error-unmatch` to check tracking status.
+ */
+export declare function isGitTracked(filePath: string, cwd?: string): boolean;