@hibanacloud/core 0.3.15

package/dist/src/fallback/handler.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AuthType } from '../core/contentGenerator.js';
+import { DEFAULT_GEMINI_FLASH_MODEL } from '../config/models.js';
+import { logFlashFallback, FlashFallbackEvent } from '../telemetry/index.js';
+export async function handleFallback(config, failedModel, authType, error) {
+    // Handle different auth types
+    if (authType === AuthType.QWEN_OAUTH) {
+        return handleQwenOAuthError(error);
+    }
+    // Applicability Checks
+    if (authType !== AuthType.LOGIN_WITH_GOOGLE)
+        return null;
+    const fallbackModel = DEFAULT_GEMINI_FLASH_MODEL;
+    if (failedModel === fallbackModel)
+        return null;
+    // Consult UI Handler for Intent
+    const fallbackModelHandler = config.fallbackModelHandler;
+    if (typeof fallbackModelHandler !== 'function')
+        return null;
+    try {
+        // Pass the specific failed model to the UI handler.
+        const intent = await fallbackModelHandler(failedModel, fallbackModel, error);
+        // Process Intent and Update State
+        switch (intent) {
+            case 'retry':
+                // Activate fallback mode. The NEXT retry attempt will pick this up.
+                activateFallbackMode(config, authType);
+                return true; // Signal retryWithBackoff to continue.
+            case 'stop':
+                activateFallbackMode(config, authType);
+                return false;
+            case 'auth':
+                return false;
+            default:
+                throw new Error(`Unexpected fallback intent received from fallbackModelHandler: "${intent}"`);
+        }
+    }
+    catch (handlerError) {
+        console.error('Fallback UI handler failed:', handlerError);
+        return null;
+    }
+}
+/**
+ * Handles Qwen OAuth authentication errors and rate limiting
+ */
+async function handleQwenOAuthError(error) {
+    if (!error) {
+        return null;
+    }
+    const errorMessage = error instanceof Error
+        ? error.message.toLowerCase()
+        : String(error).toLowerCase();
+    const errorCode = error?.status ||
+        error?.code;
+    // Check if this is an authentication/authorization error
+    const isAuthError = errorCode === 401 ||
+        errorCode === 403 ||
+        errorMessage.includes('unauthorized') ||
+        errorMessage.includes('forbidden') ||
+        errorMessage.includes('invalid api key') ||
+        errorMessage.includes('authentication') ||
+        errorMessage.includes('access denied') ||
+        (errorMessage.includes('token') && errorMessage.includes('expired'));
+    // Check if this is a rate limiting error
+    const isRateLimitError = errorCode === 429 ||
+        errorMessage.includes('429') ||
+        errorMessage.includes('rate limit') ||
+        errorMessage.includes('too many requests');
+    if (isAuthError) {
+        console.warn('Qwen OAuth authentication error detected:', errorMessage);
+        // The QwenContentGenerator should automatically handle token refresh
+        // If it still fails, it likely means the refresh token is also expired
+        console.log('Note: If this persists, you may need to re-authenticate with Qwen OAuth');
+        return null;
+    }
+    if (isRateLimitError) {
+        console.warn('Qwen API rate limit encountered:', errorMessage);
+        // For rate limiting, we don't need to do anything special
+        // The retry mechanism will handle the backoff
+        return null;
+    }
+    // For other errors, don't handle them specially
+    return null;
+}
+function activateFallbackMode(config, authType) {
+    if (!config.isInFallbackMode()) {
+        config.setFallbackMode(true);
+        if (authType) {
+            logFlashFallback(config, new FlashFallbackEvent(authType));
+        }
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/src/fallback/handler.js.map

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

package/dist/src/fallback/handler.test.d.ts

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

package/dist/src/fallback/handler.test.js

@@ -0,0 +1,130 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { handleFallback } from './handler.js';
+import { AuthType } from '../core/contentGenerator.js';
+import { DEFAULT_GEMINI_FLASH_MODEL, DEFAULT_GEMINI_MODEL, } from '../config/models.js';
+import { logFlashFallback } from '../telemetry/index.js';
+// Mock the telemetry logger and event class
+vi.mock('../telemetry/index.js', () => ({
+    logFlashFallback: vi.fn(),
+    FlashFallbackEvent: class {
+    },
+}));
+const MOCK_PRO_MODEL = DEFAULT_GEMINI_MODEL;
+const FALLBACK_MODEL = DEFAULT_GEMINI_FLASH_MODEL;
+const AUTH_OAUTH = AuthType.LOGIN_WITH_GOOGLE;
+const AUTH_API_KEY = AuthType.USE_GEMINI;
+const createMockConfig = (overrides = {}) => ({
+    isInFallbackMode: vi.fn(() => false),
+    setFallbackMode: vi.fn(),
+    fallbackHandler: undefined,
+    ...overrides,
+});
+describe('handleFallback', () => {
+    let mockConfig;
+    let mockHandler;
+    let consoleErrorSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockHandler = vi.fn();
+        // Default setup: OAuth user, Pro model failed, handler injected
+        mockConfig = createMockConfig({
+            fallbackModelHandler: mockHandler,
+        });
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleErrorSpy.mockRestore();
+    });
+    it('should return null immediately if authType is not OAuth', async () => {
+        const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_API_KEY);
+        expect(result).toBeNull();
+        expect(mockHandler).not.toHaveBeenCalled();
+        expect(mockConfig.setFallbackMode).not.toHaveBeenCalled();
+    });
+    it('should return null if the failed model is already the fallback model', async () => {
+        const result = await handleFallback(mockConfig, FALLBACK_MODEL, // Failed model is Flash
+        AUTH_OAUTH);
+        expect(result).toBeNull();
+        expect(mockHandler).not.toHaveBeenCalled();
+    });
+    it('should return null if no fallbackHandler is injected in config', async () => {
+        const configWithoutHandler = createMockConfig({
+            fallbackModelHandler: undefined,
+        });
+        const result = await handleFallback(configWithoutHandler, MOCK_PRO_MODEL, AUTH_OAUTH);
+        expect(result).toBeNull();
+    });
+    describe('when handler returns "retry"', () => {
+        it('should activate fallback mode, log telemetry, and return true', async () => {
+            mockHandler.mockResolvedValue('retry');
+            const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+            expect(result).toBe(true);
+            expect(mockConfig.setFallbackMode).toHaveBeenCalledWith(true);
+            expect(logFlashFallback).toHaveBeenCalled();
+        });
+    });
+    describe('when handler returns "stop"', () => {
+        it('should activate fallback mode, log telemetry, and return false', async () => {
+            mockHandler.mockResolvedValue('stop');
+            const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+            expect(result).toBe(false);
+            expect(mockConfig.setFallbackMode).toHaveBeenCalledWith(true);
+            expect(logFlashFallback).toHaveBeenCalled();
+        });
+    });
+    describe('when handler returns "auth"', () => {
+        it('should NOT activate fallback mode and return false', async () => {
+            mockHandler.mockResolvedValue('auth');
+            const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+            expect(result).toBe(false);
+            expect(mockConfig.setFallbackMode).not.toHaveBeenCalled();
+            expect(logFlashFallback).not.toHaveBeenCalled();
+        });
+    });
+    describe('when handler returns an unexpected value', () => {
+        it('should log an error and return null', async () => {
+            mockHandler.mockResolvedValue(null);
+            const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+            expect(result).toBeNull();
+            expect(consoleErrorSpy).toHaveBeenCalledWith('Fallback UI handler failed:', new Error('Unexpected fallback intent received from fallbackModelHandler: "null"'));
+            expect(mockConfig.setFallbackMode).not.toHaveBeenCalled();
+        });
+    });
+    it('should pass the correct context (failedModel, fallbackModel, error) to the handler', async () => {
+        const mockError = new Error('Quota Exceeded');
+        mockHandler.mockResolvedValue('retry');
+        await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH, mockError);
+        expect(mockHandler).toHaveBeenCalledWith(MOCK_PRO_MODEL, FALLBACK_MODEL, mockError);
+    });
+    it('should not call setFallbackMode or log telemetry if already in fallback mode', async () => {
+        // Setup config where fallback mode is already active
+        const activeFallbackConfig = createMockConfig({
+            fallbackModelHandler: mockHandler,
+            isInFallbackMode: vi.fn(() => true), // Already active
+            setFallbackMode: vi.fn(),
+        });
+        mockHandler.mockResolvedValue('retry');
+        const result = await handleFallback(activeFallbackConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+        // Should still return true to allow the retry (which will use the active fallback mode)
+        expect(result).toBe(true);
+        // Should still consult the handler
+        expect(mockHandler).toHaveBeenCalled();
+        // But should not mutate state or log telemetry again
+        expect(activeFallbackConfig.setFallbackMode).not.toHaveBeenCalled();
+        expect(logFlashFallback).not.toHaveBeenCalled();
+    });
+    it('should catch errors from the handler, log an error, and return null', async () => {
+        const handlerError = new Error('UI interaction failed');
+        mockHandler.mockRejectedValue(handlerError);
+        const result = await handleFallback(mockConfig, MOCK_PRO_MODEL, AUTH_OAUTH);
+        expect(result).toBeNull();
+        expect(consoleErrorSpy).toHaveBeenCalledWith('Fallback UI handler failed:', handlerError);
+        expect(mockConfig.setFallbackMode).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=handler.test.js.map

package/dist/src/fallback/handler.test.js.map

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

package/dist/src/fallback/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Defines the intent returned by the UI layer during a fallback scenario.
+ */
+export type FallbackIntent = 'retry' | 'stop' | 'auth';
+/**
+ * The interface for the handler provided by the UI layer (e.g., the CLI)
+ * to interact with the user during a fallback scenario.
+ */
+export type FallbackModelHandler = (failedModel: string, fallbackModel: string, error?: unknown) => Promise<FallbackIntent | null>;

package/dist/src/fallback/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/fallback/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/fallback/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/generated/git-commit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const GIT_COMMIT_INFO = "2181f86";
+export declare const CLI_VERSION = "0.3.15";

package/dist/src/generated/git-commit.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// This file is auto-generated by the build script (scripts\generate-git-commit-info.js)
+// Do not edit this file manually.
+export const GIT_COMMIT_INFO = '2181f86';
+export const CLI_VERSION = '0.3.15';
+//# sourceMappingURL=git-commit.js.map

package/dist/src/generated/git-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit.js","sourceRoot":"","sources":["../../../src/generated/git-commit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wFAAwF;AACxF,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC"}

package/dist/src/ide/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const QWEN_CODE_COMPANION_EXTENSION_NAME = "Qwen Code Companion";
+export declare const IDE_MAX_OPEN_FILES = 10;
+export declare const IDE_MAX_SELECTED_TEXT_LENGTH = 16384;
+export declare const IDE_REQUEST_TIMEOUT_MS: number;

package/dist/src/ide/constants.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const QWEN_CODE_COMPANION_EXTENSION_NAME = 'Qwen Code Companion';
+export const IDE_MAX_OPEN_FILES = 10;
+export const IDE_MAX_SELECTED_TEXT_LENGTH = 16384; // 16 KiB limit
+export const IDE_REQUEST_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+//# sourceMappingURL=constants.js.map

package/dist/src/ide/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/ide/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAG,qBAAqB,CAAC;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,CAAC,eAAe;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa"}

package/dist/src/ide/detect-ide.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const IDE_DEFINITIONS: {
+    readonly devin: {
+        readonly name: "devin";
+        readonly displayName: "Devin";
+    };
+    readonly replit: {
+        readonly name: "replit";
+        readonly displayName: "Replit";
+    };
+    readonly cursor: {
+        readonly name: "cursor";
+        readonly displayName: "Cursor";
+    };
+    readonly cloudshell: {
+        readonly name: "cloudshell";
+        readonly displayName: "Cloud Shell";
+    };
+    readonly codespaces: {
+        readonly name: "codespaces";
+        readonly displayName: "GitHub Codespaces";
+    };
+    readonly firebasestudio: {
+        readonly name: "firebasestudio";
+        readonly displayName: "Firebase Studio";
+    };
+    readonly trae: {
+        readonly name: "trae";
+        readonly displayName: "Trae";
+    };
+    readonly vscode: {
+        readonly name: "vscode";
+        readonly displayName: "VS Code";
+    };
+    readonly vscodefork: {
+        readonly name: "vscodefork";
+        readonly displayName: "IDE";
+    };
+};
+export interface IdeInfo {
+    name: string;
+    displayName: string;
+}
+export declare function isCloudShell(): boolean;
+export declare function detectIdeFromEnv(): IdeInfo;
+export declare function detectIde(ideProcessInfo: {
+    pid: number;
+    command: string;
+}, ideInfoFromFile?: {
+    name?: string;
+    displayName?: string;
+}): IdeInfo | undefined;

package/dist/src/ide/detect-ide.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const IDE_DEFINITIONS = {
+    devin: { name: 'devin', displayName: 'Devin' },
+    replit: { name: 'replit', displayName: 'Replit' },
+    cursor: { name: 'cursor', displayName: 'Cursor' },
+    cloudshell: { name: 'cloudshell', displayName: 'Cloud Shell' },
+    codespaces: { name: 'codespaces', displayName: 'GitHub Codespaces' },
+    firebasestudio: { name: 'firebasestudio', displayName: 'Firebase Studio' },
+    trae: { name: 'trae', displayName: 'Trae' },
+    vscode: { name: 'vscode', displayName: 'VS Code' },
+    vscodefork: { name: 'vscodefork', displayName: 'IDE' },
+};
+export function isCloudShell() {
+    return !!(process.env['EDITOR_IN_CLOUD_SHELL'] || process.env['CLOUD_SHELL']);
+}
+export function detectIdeFromEnv() {
+    if (process.env['__COG_BASHRC_SOURCED']) {
+        return IDE_DEFINITIONS.devin;
+    }
+    if (process.env['REPLIT_USER']) {
+        return IDE_DEFINITIONS.replit;
+    }
+    if (process.env['CURSOR_TRACE_ID']) {
+        return IDE_DEFINITIONS.cursor;
+    }
+    if (process.env['CODESPACES']) {
+        return IDE_DEFINITIONS.codespaces;
+    }
+    if (isCloudShell()) {
+        return IDE_DEFINITIONS.cloudshell;
+    }
+    if (process.env['TERM_PRODUCT'] === 'Trae') {
+        return IDE_DEFINITIONS.trae;
+    }
+    if (process.env['MONOSPACE_ENV']) {
+        return IDE_DEFINITIONS.firebasestudio;
+    }
+    return IDE_DEFINITIONS.vscode;
+}
+function verifyVSCode(ide, ideProcessInfo) {
+    if (ide.name !== IDE_DEFINITIONS.vscode.name) {
+        return ide;
+    }
+    if (ideProcessInfo.command &&
+        ideProcessInfo.command.toLowerCase().includes('code')) {
+        return IDE_DEFINITIONS.vscode;
+    }
+    return IDE_DEFINITIONS.vscodefork;
+}
+export function detectIde(ideProcessInfo, ideInfoFromFile) {
+    if (ideInfoFromFile?.name && ideInfoFromFile.displayName) {
+        return {
+            name: ideInfoFromFile.name,
+            displayName: ideInfoFromFile.displayName,
+        };
+    }
+    // Only VSCode-based integrations are currently supported.
+    if (process.env['TERM_PROGRAM'] !== 'vscode') {
+        return undefined;
+    }
+    const ide = detectIdeFromEnv();
+    return verifyVSCode(ide, ideProcessInfo);
+}
+//# sourceMappingURL=detect-ide.js.map

package/dist/src/ide/detect-ide.js.map

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

package/dist/src/ide/detect-ide.test.d.ts

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

package/dist/src/ide/detect-ide.test.js

@@ -0,0 +1,113 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { detectIde, IDE_DEFINITIONS } from './detect-ide.js';
+describe('detectIde', () => {
+    const ideProcessInfo = { pid: 123, command: 'some/path/to/code' };
+    const ideProcessInfoNoCode = { pid: 123, command: 'some/path/to/fork' };
+    // Clear all IDE-related environment variables before each test
+    beforeEach(() => {
+        vi.stubEnv('__COG_BASHRC_SOURCED', '');
+        vi.stubEnv('REPLIT_USER', '');
+        vi.stubEnv('CURSOR_TRACE_ID', '');
+        vi.stubEnv('CODESPACES', '');
+        vi.stubEnv('EDITOR_IN_CLOUD_SHELL', '');
+        vi.stubEnv('CLOUD_SHELL', '');
+        vi.stubEnv('TERM_PRODUCT', '');
+        vi.stubEnv('MONOSPACE_ENV', '');
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+    it('should return undefined if TERM_PROGRAM is not vscode', () => {
+        vi.stubEnv('TERM_PROGRAM', '');
+        expect(detectIde(ideProcessInfo)).toBeUndefined();
+    });
+    it('should detect Devin', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('__COG_BASHRC_SOURCED', '1');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.devin);
+    });
+    it('should detect Replit', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('REPLIT_USER', 'testuser');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.replit);
+    });
+    it('should detect Cursor', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('CURSOR_TRACE_ID', 'some-id');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.cursor);
+    });
+    it('should detect Codespaces', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('CODESPACES', 'true');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.codespaces);
+    });
+    it('should detect Cloud Shell via EDITOR_IN_CLOUD_SHELL', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('EDITOR_IN_CLOUD_SHELL', 'true');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.cloudshell);
+    });
+    it('should detect Cloud Shell via CLOUD_SHELL', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('CLOUD_SHELL', 'true');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.cloudshell);
+    });
+    it('should detect Trae', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('TERM_PRODUCT', 'Trae');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.trae);
+    });
+    it('should detect Firebase Studio via MONOSPACE_ENV', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('MONOSPACE_ENV', 'true');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.firebasestudio);
+    });
+    it('should detect VSCode when no other IDE is detected and command includes "code"', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('MONOSPACE_ENV', '');
+        expect(detectIde(ideProcessInfo)).toBe(IDE_DEFINITIONS.vscode);
+    });
+    it('should detect VSCodeFork when no other IDE is detected and command does not include "code"', () => {
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        vi.stubEnv('MONOSPACE_ENV', '');
+        expect(detectIde(ideProcessInfoNoCode)).toBe(IDE_DEFINITIONS.vscodefork);
+    });
+});
+describe('detectIde with ideInfoFromFile', () => {
+    const ideProcessInfo = { pid: 123, command: 'some/path/to/code' };
+    beforeEach(() => {
+        vi.stubEnv('__COG_BASHRC_SOURCED', '');
+        vi.stubEnv('REPLIT_USER', '');
+        vi.stubEnv('CURSOR_TRACE_ID', '');
+        vi.stubEnv('CODESPACES', '');
+        vi.stubEnv('EDITOR_IN_CLOUD_SHELL', '');
+        vi.stubEnv('CLOUD_SHELL', '');
+        vi.stubEnv('TERM_PRODUCT', '');
+        vi.stubEnv('MONOSPACE_ENV', '');
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+    it('should use the name and displayName from the file', () => {
+        const ideInfoFromFile = {
+            name: 'custom-ide',
+            displayName: 'Custom IDE',
+        };
+        expect(detectIde(ideProcessInfo, ideInfoFromFile)).toEqual(ideInfoFromFile);
+    });
+    it('should fall back to env detection if name is missing', () => {
+        const ideInfoFromFile = { displayName: 'Custom IDE' };
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        expect(detectIde(ideProcessInfo, ideInfoFromFile)).toBe(IDE_DEFINITIONS.vscode);
+    });
+    it('should fall back to env detection if displayName is missing', () => {
+        const ideInfoFromFile = { name: 'custom-ide' };
+        vi.stubEnv('TERM_PROGRAM', 'vscode');
+        expect(detectIde(ideProcessInfo, ideInfoFromFile)).toBe(IDE_DEFINITIONS.vscode);
+    });
+});
+//# sourceMappingURL=detect-ide.test.js.map

package/dist/src/ide/detect-ide.test.js.map

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