@office-ai/aioncli-core 0.2.3 → 0.18.4

package/dist/src/utils/extensionLoader.js

@@ -0,0 +1,208 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { refreshServerHierarchicalMemory } from './memoryDiscovery.js';
+export class ExtensionLoader {
+    eventEmitter;
+    // Assigned in `start`.
+    config;
+    // Used to track the count of currently starting and stopping extensions and
+    // fire appropriate events.
+    startingCount = 0;
+    startCompletedCount = 0;
+    stoppingCount = 0;
+    stopCompletedCount = 0;
+    // Whether or not we are currently executing `start`
+    isStarting = false;
+    constructor(eventEmitter) {
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Fully initializes all active extensions.
+     *
+     * Called within `Config.initialize`, which must already have an
+     * McpClientManager, PromptRegistry, and GeminiChat set up.
+     */
+    async start(config) {
+        this.isStarting = true;
+        try {
+            if (!this.config) {
+                this.config = config;
+            }
+            else {
+                throw new Error('Already started, you may only call `start` once.');
+            }
+            await Promise.all(this.getExtensions()
+                .filter((e) => e.isActive)
+                .map(this.startExtension.bind(this)));
+        }
+        finally {
+            this.isStarting = false;
+        }
+    }
+    /**
+     * Unconditionally starts an `extension` and loads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * This should typically only be called from `start`, most other calls should
+     * go through `maybeStartExtension` which will only start the extension if
+     * extension reloading is enabled and the `config` object is initialized.
+     */
+    async startExtension(extension) {
+        if (!this.config) {
+            throw new Error('Cannot call `startExtension` prior to calling `start`.');
+        }
+        this.startingCount++;
+        this.eventEmitter?.emit('extensionsStarting', {
+            total: this.startingCount,
+            completed: this.startCompletedCount,
+        });
+        try {
+            await this.config.getMcpClientManager().startExtension(extension);
+            await this.maybeRefreshGeminiTools(extension);
+            // Note: Context files are loaded only once all extensions are done
+            // loading/unloading to reduce churn, see the `maybeRefreshMemories` call
+            // below.
+            // TODO: Update custom command updating away from the event based system
+            // and call directly into a custom command manager here. See the
+            // useSlashCommandProcessor hook which responds to events fired here today.
+        }
+        finally {
+            this.startCompletedCount++;
+            this.eventEmitter?.emit('extensionsStarting', {
+                total: this.startingCount,
+                completed: this.startCompletedCount,
+            });
+            if (this.startingCount === this.startCompletedCount) {
+                this.startingCount = 0;
+                this.startCompletedCount = 0;
+            }
+            await this.maybeRefreshMemories();
+        }
+    }
+    async maybeRefreshMemories() {
+        if (!this.config) {
+            throw new Error('Cannot refresh gemini memories prior to calling `start`.');
+        }
+        if (!this.isStarting && // Don't refresh memories on the first call to `start`.
+            this.startingCount === this.startCompletedCount &&
+            this.stoppingCount === this.stopCompletedCount) {
+            // Wait until all extensions are done starting and stopping before we
+            // reload memory, this is somewhat expensive and also busts the context
+            // cache, we want to only do it once.
+            await refreshServerHierarchicalMemory(this.config);
+        }
+    }
+    /**
+     * Refreshes the gemini tools list if it is initialized and the extension has
+     * any excludeTools settings.
+     */
+    async maybeRefreshGeminiTools(extension) {
+        if (extension.excludeTools && extension.excludeTools.length > 0) {
+            const geminiClient = this.config?.getGeminiClient();
+            if (geminiClient?.isInitialized()) {
+                await geminiClient.setTools();
+            }
+        }
+    }
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then calls `startExtension` to include all extension features into the
+     * program.
+     */
+    maybeStartExtension(extension) {
+        if (this.config && this.config.getEnableExtensionReloading()) {
+            return this.startExtension(extension);
+        }
+        return;
+    }
+    /**
+     * Unconditionally stops an `extension` and unloads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * Most calls should go through `maybeStopExtension` which will only stop the
+     * extension if extension reloading is enabled and the `config` object is
+     * initialized.
+     */
+    async stopExtension(extension) {
+        if (!this.config) {
+            throw new Error('Cannot call `stopExtension` prior to calling `start`.');
+        }
+        this.stoppingCount++;
+        this.eventEmitter?.emit('extensionsStopping', {
+            total: this.stoppingCount,
+            completed: this.stopCompletedCount,
+        });
+        try {
+            await this.config.getMcpClientManager().stopExtension(extension);
+            await this.maybeRefreshGeminiTools(extension);
+            // Note: Context files are loaded only once all extensions are done
+            // loading/unloading to reduce churn, see the `maybeRefreshMemories` call
+            // below.
+            // TODO: Update custom command updating away from the event based system
+            // and call directly into a custom command manager here. See the
+            // useSlashCommandProcessor hook which responds to events fired here today.
+        }
+        finally {
+            this.stopCompletedCount++;
+            this.eventEmitter?.emit('extensionsStopping', {
+                total: this.stoppingCount,
+                completed: this.stopCompletedCount,
+            });
+            if (this.stoppingCount === this.stopCompletedCount) {
+                this.stoppingCount = 0;
+                this.stopCompletedCount = 0;
+            }
+            await this.maybeRefreshMemories();
+        }
+    }
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then this also performs all necessary steps to remove all extension
+     * features from the rest of the system.
+     */
+    maybeStopExtension(extension) {
+        if (this.config && this.config.getEnableExtensionReloading()) {
+            return this.stopExtension(extension);
+        }
+        return;
+    }
+    async restartExtension(extension) {
+        await this.stopExtension(extension);
+        await this.startExtension(extension);
+    }
+}
+export class SimpleExtensionLoader extends ExtensionLoader {
+    extensions;
+    constructor(extensions, eventEmitter) {
+        super(eventEmitter);
+        this.extensions = extensions;
+    }
+    getExtensions() {
+        return this.extensions;
+    }
+    /// Adds `extension` to the list of extensions and calls
+    /// `maybeStartExtension`.
+    ///
+    /// This is intended for dynamic loading of extensions after calling `start`.
+    async loadExtension(extension) {
+        this.extensions.push(extension);
+        await this.maybeStartExtension(extension);
+    }
+    /// Removes `extension` from the list of extensions and calls
+    // `maybeStopExtension` if it was found.
+    ///
+    /// This is intended for dynamic unloading of extensions after calling `start`.
+    async unloadExtension(extension) {
+        const index = this.extensions.indexOf(extension);
+        if (index === -1)
+            return;
+        this.extensions.splice(index, 1);
+        await this.maybeStopExtension(extension);
+    }
+}
+//# sourceMappingURL=extensionLoader.js.map

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

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

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

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

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

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, expect, it, vi, beforeEach, afterEach, } from 'vitest';
+import { SimpleExtensionLoader } from './extensionLoader.js';
+import {} from '../tools/mcp-client-manager.js';
+const mockRefreshServerHierarchicalMemory = vi.hoisted(() => vi.fn());
+vi.mock('./memoryDiscovery.js', async (importActual) => {
+    const actual = await importActual();
+    return {
+        ...actual,
+        refreshServerHierarchicalMemory: mockRefreshServerHierarchicalMemory,
+    };
+});
+describe('SimpleExtensionLoader', () => {
+    let mockConfig;
+    let extensionReloadingEnabled;
+    let mockMcpClientManager;
+    let mockGeminiClientSetTools;
+    const activeExtension = {
+        name: 'test-extension',
+        isActive: true,
+        version: '1.0.0',
+        path: '/path/to/extension',
+        contextFiles: [],
+        excludeTools: ['some-tool'],
+        id: '123',
+    };
+    const inactiveExtension = {
+        name: 'test-extension',
+        isActive: false,
+        version: '1.0.0',
+        path: '/path/to/extension',
+        contextFiles: [],
+        id: '123',
+    };
+    beforeEach(() => {
+        mockMcpClientManager = {
+            startExtension: vi.fn(),
+            stopExtension: vi.fn(),
+        };
+        extensionReloadingEnabled = false;
+        mockGeminiClientSetTools = vi.fn();
+        mockConfig = {
+            getMcpClientManager: () => mockMcpClientManager,
+            getEnableExtensionReloading: () => extensionReloadingEnabled,
+            getGeminiClient: vi.fn(() => ({
+                isInitialized: () => true,
+                setTools: mockGeminiClientSetTools,
+            })),
+        };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should start active extensions', async () => {
+        const loader = new SimpleExtensionLoader([activeExtension]);
+        await loader.start(mockConfig);
+        expect(mockMcpClientManager.startExtension).toHaveBeenCalledExactlyOnceWith(activeExtension);
+    });
+    it('should not start inactive extensions', async () => {
+        const loader = new SimpleExtensionLoader([inactiveExtension]);
+        await loader.start(mockConfig);
+        expect(mockMcpClientManager.startExtension).not.toHaveBeenCalled();
+    });
+    describe('interactive extension loading and unloading', () => {
+        it('should not call `start` or `stop` if the loader is not already started', async () => {
+            const loader = new SimpleExtensionLoader([]);
+            await loader.loadExtension(activeExtension);
+            expect(mockMcpClientManager.startExtension).not.toHaveBeenCalled();
+            await loader.unloadExtension(activeExtension);
+            expect(mockMcpClientManager.stopExtension).not.toHaveBeenCalled();
+        });
+        it('should start extensions that were explicitly loaded prior to initializing the loader', async () => {
+            const loader = new SimpleExtensionLoader([]);
+            await loader.loadExtension(activeExtension);
+            expect(mockMcpClientManager.startExtension).not.toHaveBeenCalled();
+            await loader.start(mockConfig);
+            expect(mockMcpClientManager.startExtension).toHaveBeenCalledExactlyOnceWith(activeExtension);
+        });
+        describe.each([true, false])('when enableExtensionReloading === $i', (reloadingEnabled) => {
+            beforeEach(() => {
+                extensionReloadingEnabled = reloadingEnabled;
+            });
+            it(`should ${reloadingEnabled ? '' : 'not '}reload extension features`, async () => {
+                const loader = new SimpleExtensionLoader([]);
+                await loader.start(mockConfig);
+                expect(mockMcpClientManager.startExtension).not.toHaveBeenCalled();
+                await loader.loadExtension(activeExtension);
+                if (reloadingEnabled) {
+                    expect(mockMcpClientManager.startExtension).toHaveBeenCalledExactlyOnceWith(activeExtension);
+                    expect(mockRefreshServerHierarchicalMemory).toHaveBeenCalledOnce();
+                    expect(mockGeminiClientSetTools).toHaveBeenCalledOnce();
+                }
+                else {
+                    expect(mockMcpClientManager.startExtension).not.toHaveBeenCalled();
+                    expect(mockRefreshServerHierarchicalMemory).not.toHaveBeenCalled();
+                    expect(mockGeminiClientSetTools).not.toHaveBeenCalledOnce();
+                }
+                mockRefreshServerHierarchicalMemory.mockClear();
+                mockGeminiClientSetTools.mockClear();
+                await loader.unloadExtension(activeExtension);
+                if (reloadingEnabled) {
+                    expect(mockMcpClientManager.stopExtension).toHaveBeenCalledExactlyOnceWith(activeExtension);
+                    expect(mockRefreshServerHierarchicalMemory).toHaveBeenCalledOnce();
+                    expect(mockGeminiClientSetTools).toHaveBeenCalledOnce();
+                }
+                else {
+                    expect(mockMcpClientManager.stopExtension).not.toHaveBeenCalled();
+                    expect(mockRefreshServerHierarchicalMemory).not.toHaveBeenCalled();
+                    expect(mockGeminiClientSetTools).not.toHaveBeenCalledOnce();
+                }
+            });
+            it.runIf(reloadingEnabled)('Should only reload memory once all extensions are done', async () => {
+                const anotherExtension = {
+                    ...activeExtension,
+                    name: 'another-extension',
+                };
+                const loader = new SimpleExtensionLoader([]);
+                await loader.loadExtension(activeExtension);
+                await loader.start(mockConfig);
+                expect(mockRefreshServerHierarchicalMemory).not.toHaveBeenCalled();
+                await Promise.all([
+                    loader.unloadExtension(activeExtension),
+                    loader.loadExtension(anotherExtension),
+                ]);
+                expect(mockRefreshServerHierarchicalMemory).toHaveBeenCalledOnce();
+            });
+        });
+    });
+    describe('restartExtension', () => {
+        it('should stop and then start the extension', async () => {
+            const loader = new TestingSimpleExtensionLoader([activeExtension]);
+            vi.spyOn(loader, 'stopExtension');
+            vi.spyOn(loader, 'startExtension');
+            await loader.start(mockConfig);
+            await loader.restartExtension(activeExtension);
+            expect(loader.stopExtension).toHaveBeenCalledWith(activeExtension);
+            expect(loader.startExtension).toHaveBeenCalledWith(activeExtension);
+        });
+    });
+});
+// Adding these overrides allows us to access the protected members.
+class TestingSimpleExtensionLoader extends SimpleExtensionLoader {
+    async startExtension(extension) {
+        await super.startExtension(extension);
+    }
+    async stopExtension(extension) {
+        await super.stopExtension(extension);
+    }
+}
+//# sourceMappingURL=extensionLoader.test.js.map

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

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

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

@@ -9,3 +9,4 @@ export declare class FetchError extends Error {
 }
 export declare function isPrivateIp(url: string): boolean;
 export declare function fetchWithTimeout(url: string, timeout: number): Promise<Response>;
+export declare function setGlobalProxy(proxy: string): void;

package/dist/src/utils/fetch.js

@@ -4,7 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { getErrorMessage, isNodeError } from './errors.js';
-import { URL } from 'url';
+import { URL } from 'node:url';
+import { ProxyAgent, setGlobalDispatcher } from 'undici';
 const PRIVATE_IP_RANGES = [
     /^10\./,
     /^127\./,
@@ -48,4 +49,7 @@ export async function fetchWithTimeout(url, timeout) {
         clearTimeout(timeoutId);
     }
 }
+export function setGlobalProxy(proxy) {
+    setGlobalDispatcher(new ProxyAgent(proxy));
+}
 //# sourceMappingURL=fetch.js.map

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

@@ -1 +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"}
+{"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,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAEzD,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;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,mBAAmB,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -3,9 +3,29 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { PartUnion } from '@google/genai';
-import { FileSystemService } from '../services/fileSystemService.js';
+import type { PartUnion } from '@google/genai';
+import type { FileSystemService } from '../services/fileSystemService.js';
+import { ToolErrorType } from '../tools/tool-error.js';
+export declare function readWasmBinaryFromDisk(specifier: string): Promise<Uint8Array>;
+export declare function loadWasmBinary(dynamicImport: () => Promise<{
+    default: Uint8Array;
+}>, fallbackSpecifier: string): Promise<Uint8Array>;
 export declare const DEFAULT_ENCODING: BufferEncoding;
+type UnicodeEncoding = 'utf8' | 'utf16le' | 'utf16be' | 'utf32le' | 'utf32be';
+interface BOMInfo {
+    encoding: UnicodeEncoding;
+    bomLength: number;
+}
+/**
+ * Detect a Unicode BOM (Byte Order Mark) if present.
+ * Reads up to the first 4 bytes and returns encoding + BOM length, else null.
+ */
+export declare function detectBOM(buf: Buffer): BOMInfo | null;
+/**
+ * Read a file as text, honoring BOM encodings (UTF‑8/16/32) and stripping the BOM.
+ * Falls back to utf8 when no BOM is present.
+ */
+export declare function readFileWithEncoding(filePath: string): Promise<string>;
 /**
  * Looks up the specific MIME type for a file path.
  * @param filePath Path to the file.
@@ -20,9 +40,9 @@ export declare function getSpecificMimeType(filePath: string): string | undefine
  */
 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 Promise that resolves to true if the file appears to be binary.
+ * Heuristic: determine if a file is likely binary.
+ * Now BOM-aware: if a Unicode BOM is detected, we treat it as text.
+ * For non-BOM files, retain the existing null-byte and non-printable ratio checks.
  */
 export declare function isBinaryFile(filePath: string): Promise<boolean>;
 /**
@@ -31,17 +51,11 @@ export declare function isBinaryFile(filePath: string): Promise<boolean>;
  * @returns Promise that resolves to 'text', 'image', 'pdf', 'audio', 'video', 'binary' or 'svg'.
  */
 export declare function detectFileType(filePath: string): Promise<'text' | 'image' | 'pdf' | 'audio' | 'video' | 'binary' | 'svg'>;
-export declare enum FileErrorType {
-    FILE_NOT_FOUND = "FILE_NOT_FOUND",
-    IS_DIRECTORY = "IS_DIRECTORY",
-    FILE_TOO_LARGE = "FILE_TOO_LARGE",
-    READ_ERROR = "READ_ERROR"
-}
 export interface ProcessedFileReadResult {
     llmContent: PartUnion;
     returnDisplay: string;
     error?: string;
-    errorType?: FileErrorType;
+    errorType?: ToolErrorType;
     isTruncated?: boolean;
     originalLineCount?: number;
     linesShown?: [number, number];
@@ -55,3 +69,5 @@ export interface ProcessedFileReadResult {
  * @returns ProcessedFileReadResult object.
  */
 export declare function processSingleFileContent(filePath: string, rootDirectory: string, fileSystemService: FileSystemService, offset?: number, limit?: number): Promise<ProcessedFileReadResult>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export {};