@vybestack/llxprt-code-core 0.1.12

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

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { reportError } from './errorReporting.js';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+// Mock dependencies
+vi.mock('node:fs/promises');
+vi.mock('node:os');
+describe('reportError', () => {
+    let consoleErrorSpy;
+    const MOCK_TMP_DIR = '/tmp';
+    const MOCK_TIMESTAMP = '2025-01-01T00-00-00-000Z';
+    beforeEach(() => {
+        vi.resetAllMocks();
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        os.tmpdir.mockReturnValue(MOCK_TMP_DIR);
+        vi.spyOn(Date.prototype, 'toISOString').mockReturnValue(MOCK_TIMESTAMP);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    const getExpectedReportPath = (type) => `${MOCK_TMP_DIR}/gemini-client-error-${type}-${MOCK_TIMESTAMP}.json`;
+    it('should generate a report and log the path', async () => {
+        const error = new Error('Test error');
+        error.stack = 'Test stack';
+        const baseMessage = 'An error occurred.';
+        const context = { data: 'test context' };
+        const type = 'test-type';
+        const expectedReportPath = getExpectedReportPath(type);
+        fs.writeFile.mockResolvedValue(undefined);
+        await reportError(error, baseMessage, context, type);
+        expect(os.tmpdir).toHaveBeenCalledTimes(1);
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedReportPath, JSON.stringify({
+            error: { message: 'Test error', stack: error.stack },
+            context,
+        }, null, 2));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Full report available at: ${expectedReportPath}`);
+    });
+    it('should handle errors that are plain objects with a message property', async () => {
+        const error = { message: 'Test plain object error' };
+        const baseMessage = 'Another error.';
+        const type = 'general';
+        const expectedReportPath = getExpectedReportPath(type);
+        fs.writeFile.mockResolvedValue(undefined);
+        await reportError(error, baseMessage);
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedReportPath, JSON.stringify({
+            error: { message: 'Test plain object error' },
+        }, null, 2));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Full report available at: ${expectedReportPath}`);
+    });
+    it('should handle string errors', async () => {
+        const error = 'Just a string error';
+        const baseMessage = 'String error occurred.';
+        const type = 'general';
+        const expectedReportPath = getExpectedReportPath(type);
+        fs.writeFile.mockResolvedValue(undefined);
+        await reportError(error, baseMessage);
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedReportPath, JSON.stringify({
+            error: { message: 'Just a string error' },
+        }, null, 2));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Full report available at: ${expectedReportPath}`);
+    });
+    it('should log fallback message if writing report fails', async () => {
+        const error = new Error('Main error');
+        const baseMessage = 'Failed operation.';
+        const writeError = new Error('Failed to write file');
+        const context = ['some context'];
+        const type = 'general';
+        const expectedReportPath = getExpectedReportPath(type);
+        fs.writeFile.mockRejectedValue(writeError);
+        await reportError(error, baseMessage, context, type);
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedReportPath, expect.any(String)); // It still tries to write
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Additionally, failed to write detailed error report:`, writeError);
+        expect(consoleErrorSpy).toHaveBeenCalledWith('Original error that triggered report generation:', error);
+        expect(consoleErrorSpy).toHaveBeenCalledWith('Original context:', context);
+    });
+    it('should handle stringification failure of report content (e.g. BigInt in context)', async () => {
+        const error = new Error('Main error');
+        error.stack = 'Main stack';
+        const baseMessage = 'Failed operation with BigInt.';
+        const context = { a: BigInt(1) }; // BigInt cannot be stringified by JSON.stringify
+        const type = 'bigint-fail';
+        const stringifyError = new TypeError('Do not know how to serialize a BigInt');
+        const expectedMinimalReportPath = getExpectedReportPath(type);
+        // Simulate JSON.stringify throwing an error for the full report
+        const originalJsonStringify = JSON.stringify;
+        let callCount = 0;
+        vi.spyOn(JSON, 'stringify').mockImplementation((value, replacer, space) => {
+            callCount++;
+            if (callCount === 1) {
+                // First call is for the full report content
+                throw stringifyError;
+            }
+            // Subsequent calls (for minimal report) should succeed
+            return originalJsonStringify(value, replacer, space);
+        });
+        fs.writeFile.mockResolvedValue(undefined); // Mock for the minimal report write
+        await reportError(error, baseMessage, context, type);
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Could not stringify report content (likely due to context):`, stringifyError);
+        expect(consoleErrorSpy).toHaveBeenCalledWith('Original error that triggered report generation:', error);
+        expect(consoleErrorSpy).toHaveBeenCalledWith('Original context could not be stringified or included in report.');
+        // Check that it attempts to write a minimal report
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedMinimalReportPath, originalJsonStringify({ error: { message: error.message, stack: error.stack } }, null, 2));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Partial report (excluding context) available at: ${expectedMinimalReportPath}`);
+    });
+    it('should generate a report without context if context is not provided', async () => {
+        const error = new Error('Error without context');
+        error.stack = 'No context stack';
+        const baseMessage = 'Simple error.';
+        const type = 'general';
+        const expectedReportPath = getExpectedReportPath(type);
+        fs.writeFile.mockResolvedValue(undefined);
+        await reportError(error, baseMessage, undefined, type);
+        expect(fs.writeFile).toHaveBeenCalledWith(expectedReportPath, JSON.stringify({
+            error: { message: 'Error without context', stack: error.stack },
+        }, null, 2));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(`${baseMessage} Full report available at: ${expectedReportPath}`);
+    });
+});
+//# sourceMappingURL=errorReporting.test.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;
+export declare function getErrorMessage(error: unknown): string;
+export declare class ForbiddenError extends Error {
+}
+export declare class UnauthorizedError extends Error {
+}
+export declare class BadRequestError extends Error {
+}
+export declare function toFriendlyError(error: unknown): unknown;

package/dist/src/utils/errors.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GaxiosError } from 'gaxios';
+export function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'Failed to get error details';
+    }
+}
+export class ForbiddenError extends Error {
+}
+export class UnauthorizedError extends Error {
+}
+export class BadRequestError extends Error {
+}
+export function toFriendlyError(error) {
+    if (error instanceof GaxiosError) {
+        const data = parseResponseData(error);
+        if (data.error && data.error.message && data.error.code) {
+            switch (data.error.code) {
+                case 400:
+                    return new BadRequestError(data.error.message);
+                case 401:
+                    return new UnauthorizedError(data.error.message);
+                case 403:
+                    // It's import to pass the message here since it might
+                    // explain the cause like "the cloud project you're
+                    // using doesn't have code assist enabled".
+                    return new ForbiddenError(data.error.message);
+                default:
+            }
+        }
+    }
+    return error;
+}
+function parseResponseData(error) {
+    // Inexplicably, Gaxios sometimes doesn't JSONify the response data.
+    if (typeof error.response?.data === 'string') {
+        return JSON.parse(error.response?.data);
+    }
+    return typeof error.response?.data;
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6BAA6B,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAC5C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAS7C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxD,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACxB,KAAK,GAAG;oBACN,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjD,KAAK,GAAG;oBACN,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnD,KAAK,GAAG;oBACN,sDAAsD;oBACtD,mDAAmD;oBACnD,2CAA2C;oBAC3C,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChD,QAAQ;YACV,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,oEAAoE;IACpE,IAAI,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAiB,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAoB,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class FetchError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare function isPrivateIp(url: string): boolean;
+export declare function fetchWithTimeout(url: string, timeout: number): Promise<Response>;

package/dist/src/utils/fetch.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage, isNodeError } from './errors.js';
+import { URL } from 'url';
+const PRIVATE_IP_RANGES = [
+    /^10\./,
+    /^127\./,
+    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+    /^192\.168\./,
+    /^::1$/,
+    /^fc00:/,
+    /^fe80:/,
+];
+export class FetchError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'FetchError';
+    }
+}
+export function isPrivateIp(url) {
+    try {
+        const hostname = new URL(url).hostname;
+        return PRIVATE_IP_RANGES.some((range) => range.test(hostname));
+    }
+    catch (_e) {
+        return false;
+    }
+}
+export async function fetchWithTimeout(url, timeout) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ABORT_ERR') {
+            throw new FetchError(`Request timed out after ${timeout}ms`, 'ETIMEDOUT');
+        }
+        throw new FetchError(getErrorMessage(error));
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,iBAAiB,GAAG;IACxB,OAAO;IACP,QAAQ;IACR,gCAAgC;IAChC,aAAa;IACb,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IAFT,YACE,OAAe,EACR,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,OAAe;IAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAAC,2BAA2B,OAAO,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PartUnion } from '@google/genai';
+export declare const DEFAULT_ENCODING: BufferEncoding;
+/**
+ * Looks up the specific MIME type for a file path.
+ * @param filePath Path to the file.
+ * @returns The specific MIME type string (e.g., 'text/python', 'application/javascript') or undefined if not found or ambiguous.
+ */
+export declare function getSpecificMimeType(filePath: string): string | undefined;
+/**
+ * Checks if a path is within a given root directory.
+ * @param pathToCheck The absolute path to check.
+ * @param rootDirectory The absolute root directory.
+ * @returns True if the path is within the root directory, false otherwise.
+ */
+export declare function isWithinRoot(pathToCheck: string, rootDirectory: string): boolean;
+/**
+ * Determines if a file is likely binary based on content sampling.
+ * @param filePath Path to the file.
+ * @returns True if the file appears to be binary.
+ */
+export declare function isBinaryFile(filePath: string): boolean;
+/**
+ * Detects the type of file based on extension and content.
+ * @param filePath Path to the file.
+ * @returns 'text', 'image', 'pdf', 'audio', 'video', 'binary', or 'svg'.
+ */
+export declare function detectFileType(filePath: string): 'text' | 'image' | 'pdf' | 'audio' | 'video' | 'binary' | 'svg';
+export interface ProcessedFileReadResult {
+    llmContent: PartUnion;
+    returnDisplay: string;
+    error?: string;
+    isTruncated?: boolean;
+    originalLineCount?: number;
+    linesShown?: [number, number];
+}
+/**
+ * Reads and processes a single file, handling text, images, and PDFs.
+ * @param filePath Absolute path to the file.
+ * @param rootDirectory Absolute path to the project root for relative path display.
+ * @param offset Optional offset for text files (0-based line number).
+ * @param limit Optional limit for text files (number of lines to read).
+ * @returns ProcessedFileReadResult object.
+ */
+export declare function processSingleFileContent(filePath: string, rootDirectory: string, offset?: number, limit?: number): Promise<ProcessedFileReadResult>;

package/dist/src/utils/fileUtils.js

@@ -0,0 +1,286 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import path from 'path';
+import mime from 'mime-types';
+// Constants for text file processing
+const DEFAULT_MAX_LINES_TEXT_FILE = 2000;
+const MAX_LINE_LENGTH_TEXT_FILE = 2000;
+// Default values for encoding and separator format
+export const DEFAULT_ENCODING = 'utf-8';
+/**
+ * Looks up the specific MIME type for a file path.
+ * @param filePath Path to the file.
+ * @returns The specific MIME type string (e.g., 'text/python', 'application/javascript') or undefined if not found or ambiguous.
+ */
+export function getSpecificMimeType(filePath) {
+    const lookedUpMime = mime.lookup(filePath);
+    return typeof lookedUpMime === 'string' ? lookedUpMime : undefined;
+}
+/**
+ * Checks if a path is within a given root directory.
+ * @param pathToCheck The absolute path to check.
+ * @param rootDirectory The absolute root directory.
+ * @returns True if the path is within the root directory, false otherwise.
+ */
+export function isWithinRoot(pathToCheck, rootDirectory) {
+    const normalizedPathToCheck = path.resolve(pathToCheck);
+    const normalizedRootDirectory = path.resolve(rootDirectory);
+    // Ensure the rootDirectory path ends with a separator for correct startsWith comparison,
+    // unless it's the root path itself (e.g., '/' or 'C:\').
+    const rootWithSeparator = normalizedRootDirectory === path.sep ||
+        normalizedRootDirectory.endsWith(path.sep)
+        ? normalizedRootDirectory
+        : normalizedRootDirectory + path.sep;
+    return (normalizedPathToCheck === normalizedRootDirectory ||
+        normalizedPathToCheck.startsWith(rootWithSeparator));
+}
+/**
+ * Determines if a file is likely binary based on content sampling.
+ * @param filePath Path to the file.
+ * @returns True if the file appears to be binary.
+ */
+export function isBinaryFile(filePath) {
+    try {
+        const fd = fs.openSync(filePath, 'r');
+        // Read up to 4KB or file size, whichever is smaller
+        const fileSize = fs.fstatSync(fd).size;
+        if (fileSize === 0) {
+            // Empty file is not considered binary for content checking
+            fs.closeSync(fd);
+            return false;
+        }
+        const bufferSize = Math.min(4096, fileSize);
+        const buffer = Buffer.alloc(bufferSize);
+        const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, 0);
+        fs.closeSync(fd);
+        if (bytesRead === 0)
+            return false;
+        let nonPrintableCount = 0;
+        for (let i = 0; i < bytesRead; i++) {
+            if (buffer[i] === 0)
+                return true; // Null byte is a strong indicator
+            if (buffer[i] < 9 || (buffer[i] > 13 && buffer[i] < 32)) {
+                nonPrintableCount++;
+            }
+        }
+        // If >30% non-printable characters, consider it binary
+        return nonPrintableCount / bytesRead > 0.3;
+    }
+    catch {
+        // If any error occurs (e.g. file not found, permissions),
+        // treat as not binary here; let higher-level functions handle existence/access errors.
+        return false;
+    }
+}
+/**
+ * Detects the type of file based on extension and content.
+ * @param filePath Path to the file.
+ * @returns 'text', 'image', 'pdf', 'audio', 'video', 'binary', or 'svg'.
+ */
+export function detectFileType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    // The mimetype for "ts" is MPEG transport stream (a video format) but we want
+    // to assume these are typescript files instead.
+    if (ext === '.ts') {
+        return 'text';
+    }
+    if (ext === '.svg') {
+        return 'svg';
+    }
+    const lookedUpMimeType = mime.lookup(filePath); // Returns false if not found, or the mime type string
+    if (lookedUpMimeType) {
+        if (lookedUpMimeType.startsWith('image/')) {
+            return 'image';
+        }
+        if (lookedUpMimeType.startsWith('audio/')) {
+            return 'audio';
+        }
+        if (lookedUpMimeType.startsWith('video/')) {
+            return 'video';
+        }
+        if (lookedUpMimeType === 'application/pdf') {
+            return 'pdf';
+        }
+    }
+    // Stricter binary check for common non-text extensions before content check
+    // These are often not well-covered by mime-types or might be misidentified.
+    if ([
+        '.zip',
+        '.tar',
+        '.gz',
+        '.exe',
+        '.dll',
+        '.so',
+        '.class',
+        '.jar',
+        '.war',
+        '.7z',
+        '.doc',
+        '.docx',
+        '.xls',
+        '.xlsx',
+        '.ppt',
+        '.pptx',
+        '.odt',
+        '.ods',
+        '.odp',
+        '.bin',
+        '.dat',
+        '.obj',
+        '.o',
+        '.a',
+        '.lib',
+        '.wasm',
+        '.pyc',
+        '.pyo',
+    ].includes(ext)) {
+        return 'binary';
+    }
+    // Fallback to content-based check if mime type wasn't conclusive for image/pdf
+    // and it's not a known binary extension.
+    if (isBinaryFile(filePath)) {
+        return 'binary';
+    }
+    return 'text';
+}
+/**
+ * Reads and processes a single file, handling text, images, and PDFs.
+ * @param filePath Absolute path to the file.
+ * @param rootDirectory Absolute path to the project root for relative path display.
+ * @param offset Optional offset for text files (0-based line number).
+ * @param limit Optional limit for text files (number of lines to read).
+ * @returns ProcessedFileReadResult object.
+ */
+export async function processSingleFileContent(filePath, rootDirectory, offset, limit) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            // Sync check is acceptable before async read
+            return {
+                llmContent: '',
+                returnDisplay: 'File not found.',
+                error: `File not found: ${filePath}`,
+            };
+        }
+        const stats = await fs.promises.stat(filePath);
+        if (stats.isDirectory()) {
+            return {
+                llmContent: '',
+                returnDisplay: 'Path is a directory.',
+                error: `Path is a directory, not a file: ${filePath}`,
+            };
+        }
+        const fileSizeInBytes = stats.size;
+        // 20MB limit
+        const maxFileSize = 20 * 1024 * 1024;
+        if (fileSizeInBytes > maxFileSize) {
+            throw new Error(`File size exceeds the 20MB limit: ${filePath} (${(fileSizeInBytes /
+                (1024 * 1024)).toFixed(2)}MB)`);
+        }
+        const fileType = detectFileType(filePath);
+        const relativePathForDisplay = path
+            .relative(rootDirectory, filePath)
+            .replace(/\\/g, '/');
+        switch (fileType) {
+            case 'binary': {
+                return {
+                    llmContent: `Cannot display content of binary file: ${relativePathForDisplay}`,
+                    returnDisplay: `Skipped binary file: ${relativePathForDisplay}`,
+                };
+            }
+            case 'svg': {
+                const SVG_MAX_SIZE_BYTES = 1 * 1024 * 1024;
+                if (stats.size > SVG_MAX_SIZE_BYTES) {
+                    return {
+                        llmContent: `Cannot display content of SVG file larger than 1MB: ${relativePathForDisplay}`,
+                        returnDisplay: `Skipped large SVG file (>1MB): ${relativePathForDisplay}`,
+                    };
+                }
+                const content = await fs.promises.readFile(filePath, 'utf8');
+                return {
+                    llmContent: content,
+                    returnDisplay: `Read SVG as text: ${relativePathForDisplay}`,
+                };
+            }
+            case 'text': {
+                const content = await fs.promises.readFile(filePath, 'utf8');
+                const lines = content.split('\n');
+                const originalLineCount = lines.length;
+                const startLine = offset || 0;
+                const effectiveLimit = limit === undefined ? DEFAULT_MAX_LINES_TEXT_FILE : limit;
+                // Ensure endLine does not exceed originalLineCount
+                const endLine = Math.min(startLine + effectiveLimit, originalLineCount);
+                // Ensure selectedLines doesn't try to slice beyond array bounds if startLine is too high
+                const actualStartLine = Math.min(startLine, originalLineCount);
+                const selectedLines = lines.slice(actualStartLine, endLine);
+                let linesWereTruncatedInLength = false;
+                const formattedLines = selectedLines.map((line) => {
+                    if (line.length > MAX_LINE_LENGTH_TEXT_FILE) {
+                        linesWereTruncatedInLength = true;
+                        return (line.substring(0, MAX_LINE_LENGTH_TEXT_FILE) + '... [truncated]');
+                    }
+                    return line;
+                });
+                const contentRangeTruncated = endLine < originalLineCount;
+                const isTruncated = contentRangeTruncated || linesWereTruncatedInLength;
+                let llmTextContent = '';
+                if (contentRangeTruncated) {
+                    const nextOffset = endLine;
+                    llmTextContent += `[File content truncated. Showing lines ${actualStartLine + 1}-${endLine} of ${originalLineCount}. To read the next chunk, use offset: ${nextOffset}, limit: ${effectiveLimit}.]\n`;
+                }
+                else if (linesWereTruncatedInLength) {
+                    llmTextContent += `[File content partially truncated: some lines exceeded maximum length of ${MAX_LINE_LENGTH_TEXT_FILE} characters.]\n`;
+                }
+                llmTextContent += formattedLines.join('\n');
+                return {
+                    llmContent: llmTextContent,
+                    returnDisplay: isTruncated ? '(truncated)' : '',
+                    isTruncated,
+                    originalLineCount,
+                    linesShown: [actualStartLine + 1, endLine],
+                };
+            }
+            case 'image':
+            case 'pdf':
+            case 'audio':
+            case 'video': {
+                const contentBuffer = await fs.promises.readFile(filePath);
+                const base64Data = contentBuffer.toString('base64');
+                const mimeType = mime.lookup(filePath) || 'application/octet-stream';
+                return {
+                    llmContent: {
+                        inlineData: {
+                            data: base64Data,
+                            mimeType,
+                        },
+                    },
+                    returnDisplay: `Read ${fileType} file: ${relativePathForDisplay}`,
+                };
+            }
+            default: {
+                // Should not happen with current detectFileType logic
+                const exhaustiveCheck = fileType;
+                return {
+                    llmContent: `Unhandled file type: ${exhaustiveCheck}`,
+                    returnDisplay: `Skipped unhandled file type: ${relativePathForDisplay}`,
+                    error: `Unhandled file type for ${filePath}`,
+                };
+            }
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const displayPath = path
+            .relative(rootDirectory, filePath)
+            .replace(/\\/g, '/');
+        return {
+            llmContent: `Error reading file ${displayPath}: ${errorMessage}`,
+            returnDisplay: `Error reading file ${displayPath}: ${errorMessage}`,
+            error: `Error reading file ${filePath}: ${errorMessage}`,
+        };
+    }
+}
+//# sourceMappingURL=fileUtils.js.map

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

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

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

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