@google/gemini-cli-core 0.35.0-preview.2 → 0.36.0-nightly.20260321.fc03891a1

package/dist/src/utils/agent-sanitization-utils.test.js

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { sanitizeErrorMessage, sanitizeToolArgs, sanitizeThoughtContent, } from './agent-sanitization-utils.js';
+describe('agent-sanitization-utils', () => {
+    describe('sanitizeErrorMessage', () => {
+        it('should redact standard inline PEM content', () => {
+            const input = 'Here is my key: -----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEA12345\n-----END RSA PRIVATE KEY----- do not share.';
+            const expected = 'Here is my key: [REDACTED_PEM] do not share.';
+            expect(sanitizeErrorMessage(input)).toBe(expected);
+        });
+        it('should redact non-standard inline PEM content (with punctuation)', () => {
+            const input = '-----BEGIN X.509 CERTIFICATE-----\nMIIEowIBAAKCAQEA12345\n-----END X.509 CERTIFICATE-----';
+            const expected = '[REDACTED_PEM]';
+            expect(sanitizeErrorMessage(input)).toBe(expected);
+        });
+        it('should not hang on ReDoS attack string for PEM redaction', () => {
+            const start = Date.now();
+            // A string that starts with -----BEGIN but has no ending, with many spaces
+            // In the vulnerable regex, this would cause catastrophic backtracking.
+            const maliciousInput = '-----BEGIN ' + ' '.repeat(50000) + 'A';
+            const result = sanitizeErrorMessage(maliciousInput);
+            const duration = Date.now() - start;
+            // Should process very quickly (e.g. < 50ms)
+            expect(duration).toBeLessThan(50);
+            // Since it doesn't match the full PEM block pattern, it should return the input unaltered
+            expect(result).toBe(maliciousInput);
+        });
+        it('should redact key-value pairs with sensitive keys', () => {
+            const input = 'Error: connection failed. --api-key="secret123"';
+            const result = sanitizeErrorMessage(input);
+            expect(result).toContain('[REDACTED]');
+            expect(result).not.toContain('secret123');
+        });
+        it('should redact space-separated sensitive keywords', () => {
+            // The keyword regex requires tokens to be 8+ chars
+            const input = 'Using password mySuperSecretPassword123';
+            const result = sanitizeErrorMessage(input);
+            expect(result).toContain('[REDACTED]');
+            expect(result).not.toContain('mySuperSecretPassword123');
+        });
+    });
+    describe('sanitizeToolArgs', () => {
+        it('should redact sensitive fields in an object', () => {
+            const input = {
+                username: 'admin',
+                password: 'superSecretPassword',
+                nested: {
+                    api_key: 'abc123xyz',
+                    normal_field: 'hello',
+                },
+            };
+            const result = sanitizeToolArgs(input);
+            expect(result).toEqual({
+                username: 'admin',
+                password: '[REDACTED]',
+                nested: {
+                    api_key: '[REDACTED]',
+                    normal_field: 'hello',
+                },
+            });
+        });
+        it('should handle arrays and strings correctly', () => {
+            const input = ['normal string', '--api-key="secret123"'];
+            const result = sanitizeToolArgs(input);
+            expect(result[0]).toBe('normal string');
+            expect(result[1]).toContain('[REDACTED]');
+            expect(result[1]).not.toContain('secret123');
+        });
+    });
+    describe('sanitizeThoughtContent', () => {
+        it('should redact sensitive patterns from thought content', () => {
+            const input = 'I will now authenticate using token 1234567890abcdef.';
+            const result = sanitizeThoughtContent(input);
+            expect(result).toContain('[REDACTED]');
+            expect(result).not.toContain('1234567890abcdef');
+        });
+    });
+});
+//# sourceMappingURL=agent-sanitization-utils.test.js.map

package/dist/src/utils/agent-sanitization-utils.test.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Ensures the user has acknowledged the browser agent privacy notice.
+ *
+ * On first invocation (per profile), an interactive consent dialog is shown
+ * describing chrome-devtools-mcp's data collection and the fact that browser
+ * content is exposed to the AI model. A sentinel file is written to the
+ * browser profile directory once the user accepts.
+ *
+ * @returns `true` if consent was already given or the user accepted,
+ *          `false` if the user declined.
+ */
+export declare function getBrowserConsentIfNeeded(): Promise<boolean>;

package/dist/src/utils/browserConsent.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CoreEvent, coreEvents } from './events.js';
+import { Storage } from '../config/storage.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** Sentinel file written after the user acknowledges the browser privacy notice. */
+const BROWSER_CONSENT_FLAG_FILE = 'browser-consent-acknowledged.txt';
+/** Default browser profile directory name within ~/.gemini/ */
+const BROWSER_PROFILE_DIR = 'cli-browser-profile';
+/**
+ * Ensures the user has acknowledged the browser agent privacy notice.
+ *
+ * On first invocation (per profile), an interactive consent dialog is shown
+ * describing chrome-devtools-mcp's data collection and the fact that browser
+ * content is exposed to the AI model. A sentinel file is written to the
+ * browser profile directory once the user accepts.
+ *
+ * @returns `true` if consent was already given or the user accepted,
+ *          `false` if the user declined.
+ */
+export async function getBrowserConsentIfNeeded() {
+    const consentFilePath = path.join(Storage.getGlobalGeminiDir(), BROWSER_PROFILE_DIR, BROWSER_CONSENT_FLAG_FILE);
+    // Fast path: consent already persisted.
+    try {
+        await fs.access(consentFilePath);
+        return true;
+    }
+    catch {
+        // File doesn't exist — need to request consent.
+        void 0;
+    }
+    // Non-interactive mode (no UI listeners): skip the dialog for this session
+    // only. Do NOT persist the sentinel file — an interactive user on the same
+    // machine should still see the consent dialog the first time they use the
+    // browser agent.
+    if (coreEvents.listenerCount(CoreEvent.ConsentRequest) === 0) {
+        return true;
+    }
+    const prompt = '🔒 Browser Agent Privacy Notice\n\n' +
+        'The Browser Agent uses chrome-devtools-mcp to control your browser. ' +
+        'Please note:\n\n' +
+        '• Chrome DevTools MCP collects usage statistics by default ' +
+        '(can be disabled via privacy settings)\n' +
+        '• Performance tools may send trace URLs to Google CrUX API\n' +
+        '• Browser content will be exposed to the AI model for analysis\n' +
+        '• All data is handled per the Google Privacy Policy ' +
+        '(https://policies.google.com/privacy)\n\n' +
+        'Do you understand and consent to proceed?';
+    return new Promise((resolve) => {
+        coreEvents.emitConsentRequest({
+            prompt,
+            onConfirm: async (confirmed) => {
+                if (confirmed) {
+                    await markConsentAsAcknowledged(consentFilePath);
+                }
+                resolve(confirmed);
+            },
+        });
+    });
+}
+/**
+ * Persists a sentinel file so consent is not requested again.
+ */
+async function markConsentAsAcknowledged(consentFilePath) {
+    try {
+        await fs.mkdir(path.dirname(consentFilePath), { recursive: true });
+        await fs.writeFile(consentFilePath, `Browser privacy consent acknowledged at ${new Date().toISOString()}\n`);
+    }
+    catch {
+        // Best-effort: if we can't persist, the dialog will appear again next time.
+        void 0;
+    }
+}
+//# sourceMappingURL=browserConsent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browserConsent.js","sourceRoot":"","sources":["../../../src/utils/browserConsent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,oFAAoF;AACpF,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAErE,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,OAAO,CAAC,kBAAkB,EAAE,EAC5B,mBAAmB,EACnB,yBAAyB,CAC1B,CAAC;IAEF,wCAAwC;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;QAChD,KAAK,CAAC,CAAC;IACT,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,0EAA0E;IAC1E,iBAAiB;IACjB,IAAI,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GACV,qCAAqC;QACrC,sEAAsE;QACtE,kBAAkB;QAClB,6DAA6D;QAC7D,0CAA0C;QAC1C,8DAA8D;QAC9D,kEAAkE;QAClE,sDAAsD;QACtD,2CAA2C;QAC3C,2CAA2C,CAAC;IAE9C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,UAAU,CAAC,kBAAkB,CAAC;YAC5B,MAAM;YACN,SAAS,EAAE,KAAK,EAAE,SAAkB,EAAE,EAAE;gBACtC,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,yBAAyB,CAAC,eAAe,CAAC,CAAC;gBACnD,CAAC;gBACD,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,yBAAyB,CACtC,eAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,EAAE,CAAC,SAAS,CAChB,eAAe,EACf,2CAA2C,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CACxE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,KAAK,CAAC,CAAC;IACT,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import { coreEvents } from './events.js';
+import { Storage } from '../config/storage.js';
+// Mock fs/promises before importing the module under test
+vi.mock('node:fs/promises', () => ({
+    access: vi.fn(),
+    mkdir: vi.fn().mockResolvedValue(undefined),
+    writeFile: vi.fn().mockResolvedValue(undefined),
+}));
+// Mock Storage to return a predictable directory
+vi.mock('../config/storage.js', () => ({
+    Storage: {
+        getGlobalGeminiDir: vi.fn(),
+    },
+}));
+import { getBrowserConsentIfNeeded } from './browserConsent.js';
+describe('browserConsent', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        vi.mocked(Storage.getGlobalGeminiDir).mockReturnValue('/mock/.gemini');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return true if consent file already exists', async () => {
+        // Consent file exists — fs.access resolves
+        vi.mocked(fs.access).mockResolvedValue(undefined);
+        const result = await getBrowserConsentIfNeeded();
+        expect(result).toBe(true);
+        // Should not emit a consent request
+        const emitSpy = vi.spyOn(coreEvents, 'emitConsentRequest');
+        expect(emitSpy).not.toHaveBeenCalled();
+    });
+    it('should auto-accept in non-interactive mode (no listeners) without persisting consent', async () => {
+        // Consent file does not exist
+        vi.mocked(fs.access).mockRejectedValue(new Error('ENOENT'));
+        // No listeners registered
+        vi.spyOn(coreEvents, 'listenerCount').mockReturnValue(0);
+        const result = await getBrowserConsentIfNeeded();
+        expect(result).toBe(true);
+        // Should NOT persist the consent — an interactive user on the same machine
+        // must still see the dialog the first time they use the browser agent.
+        expect(fs.writeFile).not.toHaveBeenCalled();
+    });
+    it('should request consent interactively and return true when accepted', async () => {
+        // Consent file does not exist
+        vi.mocked(fs.access).mockRejectedValue(new Error('ENOENT'));
+        // Simulate interactive mode: there is at least one listener
+        vi.spyOn(coreEvents, 'listenerCount').mockReturnValue(1);
+        // Mock emitConsentRequest to auto-confirm
+        vi.spyOn(coreEvents, 'emitConsentRequest').mockImplementation((payload) => {
+            payload.onConfirm(true);
+        });
+        const result = await getBrowserConsentIfNeeded();
+        expect(result).toBe(true);
+        expect(coreEvents.emitConsentRequest).toHaveBeenCalledWith(expect.objectContaining({
+            prompt: expect.stringContaining('Privacy Notice'),
+        }));
+        expect(fs.writeFile).toHaveBeenCalled();
+    });
+    it('should return false when user declines consent', async () => {
+        // Consent file does not exist
+        vi.mocked(fs.access).mockRejectedValue(new Error('ENOENT'));
+        // Simulate interactive mode
+        vi.spyOn(coreEvents, 'listenerCount').mockReturnValue(1);
+        // Mock emitConsentRequest to decline
+        vi.spyOn(coreEvents, 'emitConsentRequest').mockImplementation((payload) => {
+            payload.onConfirm(false);
+        });
+        const result = await getBrowserConsentIfNeeded();
+        expect(result).toBe(false);
+        // Should NOT persist consent
+        expect(fs.writeFile).not.toHaveBeenCalled();
+    });
+    it('should include privacy policy link in the prompt', async () => {
+        vi.mocked(fs.access).mockRejectedValue(new Error('ENOENT'));
+        vi.spyOn(coreEvents, 'listenerCount').mockReturnValue(1);
+        vi.spyOn(coreEvents, 'emitConsentRequest').mockImplementation((payload) => {
+            payload.onConfirm(true);
+        });
+        await getBrowserConsentIfNeeded();
+        expect(coreEvents.emitConsentRequest).toHaveBeenCalledWith(expect.objectContaining({
+            prompt: expect.stringContaining('policies.google.com/privacy'),
+        }));
+    });
+});
+//# sourceMappingURL=browserConsent.test.js.map

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

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

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

@@ -12,6 +12,22 @@ export declare function isWindows10(): boolean;
  * Detects if the current terminal is a JetBrains-based IDE terminal.
  */
 export declare function isJetBrainsTerminal(): boolean;
+/**
+ * Detects if the current terminal is running inside tmux.
+ */
+export declare function isTmux(): boolean;
+/**
+ * Detects if the current terminal is running inside GNU screen.
+ */
+export declare function isGnuScreen(): boolean;
+/**
+ * Detects if the terminal is low-color mode (TERM=screen* with no COLORTERM).
+ */
+export declare function isLowColorTmux(): boolean;
+/**
+ * Detects if the terminal is a "dumb" terminal.
+ */
+export declare function isDumbTerminal(): boolean;
 /**
  * Detects if the current terminal is the default Apple Terminal.app.
  */

package/dist/src/utils/compatibility.js

@@ -24,7 +24,34 @@ export function isWindows10() {
  * Detects if the current terminal is a JetBrains-based IDE terminal.
  */
 export function isJetBrainsTerminal() {
-    return process.env['TERMINAL_EMULATOR'] === 'JetBrains-JediTerm';
+    const env = process.env;
+    return !!(env['TERMINAL_EMULATOR']?.startsWith('JetBrains') || env['JETBRAINS_IDE']);
+}
+/**
+ * Detects if the current terminal is running inside tmux.
+ */
+export function isTmux() {
+    return !!process.env['TMUX'];
+}
+/**
+ * Detects if the current terminal is running inside GNU screen.
+ */
+export function isGnuScreen() {
+    return !!process.env['STY'];
+}
+/**
+ * Detects if the terminal is low-color mode (TERM=screen* with no COLORTERM).
+ */
+export function isLowColorTmux() {
+    const term = process.env['TERM'] || '';
+    return isTmux() && term.startsWith('screen') && !process.env['COLORTERM'];
+}
+/**
+ * Detects if the terminal is a "dumb" terminal.
+ */
+export function isDumbTerminal() {
+    const term = process.env['TERM'] || '';
+    return term === 'dumb' || term === 'vt100';
 }
 /**
  * Detects if the current terminal is the default Apple Terminal.app.
@@ -80,16 +107,38 @@ export function getCompatibilityWarnings(options) {
         });
     }
     if (isJetBrainsTerminal() && options?.isAlternateBuffer) {
-        const platformTerminals = {
-            win32: 'Windows Terminal',
-            darwin: 'iTerm2 or Ghostty',
-            linux: 'Ghostty',
-        };
-        const suggestion = platformTerminals[os.platform()];
-        const suggestedTerminals = suggestion ? ` (e.g., ${suggestion})` : '';
         warnings.push({
             id: 'jetbrains-terminal',
-            message: `Warning: JetBrains mouse scrolling is unreliable. Disabling alternate buffer mode in settings or using an external terminal${suggestedTerminals} is recommended.`,
+            message: 'Warning: JetBrains terminal detected — alternate buffer mode may cause scroll wheel issues and rendering artifacts. If you experience problems, disable it in /settings → "Use Alternate Screen Buffer".',
+            priority: WarningPriority.High,
+        });
+    }
+    if (isTmux() && options?.isAlternateBuffer) {
+        warnings.push({
+            id: 'tmux-alternate-buffer',
+            message: 'Warning: tmux detected — alternate buffer mode may cause unexpected scrollback loss and flickering. If you experience issues, disable it in /settings → "Use Alternate Screen Buffer".\n    Tip: Use Ctrl-b [ to access tmux copy mode for scrolling history.',
+            priority: WarningPriority.High,
+        });
+    }
+    if (isLowColorTmux()) {
+        warnings.push({
+            id: 'low-color-tmux',
+            message: 'Warning: Limited color support detected (TERM=screen). Some visual elements may not render correctly. For better color support in tmux, add to ~/.tmux.conf:\n      set -g default-terminal "tmux-256color"\n      set -ga terminal-overrides ",*256col*:Tc"',
+            priority: WarningPriority.High,
+        });
+    }
+    if (isGnuScreen()) {
+        warnings.push({
+            id: 'gnu-screen',
+            message: 'Warning: GNU screen detected. Some keyboard shortcuts and visual features may behave unexpectedly. For the best experience, consider using tmux or running Gemini CLI directly in your terminal.',
+            priority: WarningPriority.Low,
+        });
+    }
+    if (isDumbTerminal()) {
+        const term = process.env['TERM'] || 'dumb';
+        warnings.push({
+            id: 'dumb-terminal',
+            message: `Warning: Basic terminal detected (TERM=${term}). Visual rendering will be limited. For the best experience, use a terminal emulator with truecolor support.`,
             priority: WarningPriority.High,
         });
     }

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

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

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

@@ -5,7 +5,7 @@
  */
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import os from 'node:os';
-import { isWindows10, isJetBrainsTerminal, supports256Colors, supportsTrueColor, getCompatibilityWarnings, WarningPriority, } from './compatibility.js';
+import { isWindows10, isJetBrainsTerminal, isTmux, isGnuScreen, isLowColorTmux, isDumbTerminal, supports256Colors, supportsTrueColor, getCompatibilityWarnings, WarningPriority, } from './compatibility.js';
 vi.mock('node:os', () => ({
     default: {
         platform: vi.fn(),
@@ -46,19 +46,89 @@ describe('compatibility', () => {
         });
     });
     describe('isJetBrainsTerminal', () => {
+        beforeEach(() => {
+            vi.stubEnv('TERMINAL_EMULATOR', '');
+            vi.stubEnv('JETBRAINS_IDE', '');
+        });
         it.each([
             {
-                env: 'JetBrains-JediTerm',
+                env: { TERMINAL_EMULATOR: 'JetBrains-JediTerm' },
                 expected: true,
-                desc: 'TERMINAL_EMULATOR is JetBrains-JediTerm',
+                desc: 'TERMINAL_EMULATOR starts with JetBrains',
+            },
+            {
+                env: { JETBRAINS_IDE: 'IntelliJ' },
+                expected: true,
+                desc: 'JETBRAINS_IDE is set',
+            },
+            {
+                env: { TERMINAL_EMULATOR: 'xterm' },
+                expected: false,
+                desc: 'other terminals',
             },
-            { env: 'something-else', expected: false, desc: 'other terminals' },
-            { env: '', expected: false, desc: 'TERMINAL_EMULATOR is not set' },
+            { env: {}, expected: false, desc: 'no env vars set' },
         ])('should return $expected when $desc', ({ env, expected }) => {
-            vi.stubEnv('TERMINAL_EMULATOR', env);
+            vi.stubEnv('TERMINAL_EMULATOR', '');
+            vi.stubEnv('JETBRAINS_IDE', '');
+            for (const [key, value] of Object.entries(env)) {
+                vi.stubEnv(key, value);
+            }
             expect(isJetBrainsTerminal()).toBe(expected);
         });
     });
+    describe('isTmux', () => {
+        it('should return true when TMUX is set', () => {
+            vi.stubEnv('TMUX', '/tmp/tmux-1001/default,1425,0');
+            expect(isTmux()).toBe(true);
+        });
+        it('should return false when TMUX is not set', () => {
+            vi.stubEnv('TMUX', '');
+            expect(isTmux()).toBe(false);
+        });
+    });
+    describe('isGnuScreen', () => {
+        it('should return true when STY is set', () => {
+            vi.stubEnv('STY', '1234.pts-0.host');
+            expect(isGnuScreen()).toBe(true);
+        });
+        it('should return false when STY is not set', () => {
+            vi.stubEnv('STY', '');
+            expect(isGnuScreen()).toBe(false);
+        });
+    });
+    describe('isLowColorTmux', () => {
+        it('should return true when TERM=screen and COLORTERM is not set', () => {
+            vi.stubEnv('TERM', 'screen');
+            vi.stubEnv('TMUX', '1');
+            vi.stubEnv('COLORTERM', '');
+            expect(isLowColorTmux()).toBe(true);
+        });
+        it('should return false when TERM=screen and COLORTERM is set', () => {
+            vi.stubEnv('TERM', 'screen');
+            vi.stubEnv('TMUX', '1');
+            vi.stubEnv('COLORTERM', 'truecolor');
+            expect(isLowColorTmux()).toBe(false);
+        });
+        it('should return false when TERM=xterm-256color', () => {
+            vi.stubEnv('TERM', 'xterm-256color');
+            vi.stubEnv('COLORTERM', '');
+            expect(isLowColorTmux()).toBe(false);
+        });
+    });
+    describe('isDumbTerminal', () => {
+        it('should return true when TERM=dumb', () => {
+            vi.stubEnv('TERM', 'dumb');
+            expect(isDumbTerminal()).toBe(true);
+        });
+        it('should return true when TERM=vt100', () => {
+            vi.stubEnv('TERM', 'vt100');
+            expect(isDumbTerminal()).toBe(true);
+        });
+        it('should return false when TERM=xterm', () => {
+            vi.stubEnv('TERM', 'xterm');
+            expect(isDumbTerminal()).toBe(false);
+        });
+    });
     describe('supports256Colors', () => {
         it.each([
             {
@@ -84,6 +154,9 @@ describe('compatibility', () => {
             if (term !== undefined) {
                 vi.stubEnv('TERM', term);
             }
+            else {
+                vi.stubEnv('TERM', '');
+            }
             expect(supports256Colors()).toBe(expected);
         });
     });
@@ -121,6 +194,13 @@ describe('compatibility', () => {
     });
     describe('getCompatibilityWarnings', () => {
         beforeEach(() => {
+            // Clear out potential local environment variables that might trigger warnings
+            vi.stubEnv('TERMINAL_EMULATOR', '');
+            vi.stubEnv('JETBRAINS_IDE', '');
+            vi.stubEnv('TMUX', '');
+            vi.stubEnv('STY', '');
+            vi.stubEnv('TERM', 'xterm-256color'); // Prevent dumb terminal warning
+            vi.stubEnv('TERM_PROGRAM', '');
             // Default to supporting true color to keep existing tests simple
             vi.stubEnv('COLORTERM', 'truecolor');
             process.stdout.getColorDepth = vi.fn().mockReturnValue(24);
@@ -135,33 +215,51 @@ describe('compatibility', () => {
                 message: expect.stringContaining('Windows 10 detected'),
             }));
         });
-        it.each([
-            {
-                platform: 'darwin',
-                release: '20.6.0',
-                externalTerminal: 'iTerm2 or Ghostty',
-                desc: 'macOS',
-            },
-            {
-                platform: 'win32',
-                release: '10.0.22000',
-                externalTerminal: 'Windows Terminal',
-                desc: 'Windows',
-            }, // Valid Windows 11 release to not trigger the Windows 10 warning
-            {
-                platform: 'linux',
-                release: '5.10.0',
-                externalTerminal: 'Ghostty',
-                desc: 'Linux',
-            },
-        ])('should return JetBrains warning when detected and in alternate buffer ($desc)', ({ platform, release, externalTerminal }) => {
-            vi.mocked(os.platform).mockReturnValue(platform);
-            vi.mocked(os.release).mockReturnValue(release);
+        it('should return JetBrains warning when detected and in alternate buffer', () => {
+            vi.mocked(os.platform).mockReturnValue('darwin');
             vi.stubEnv('TERMINAL_EMULATOR', 'JetBrains-JediTerm');
             const warnings = getCompatibilityWarnings({ isAlternateBuffer: true });
             expect(warnings).toContainEqual(expect.objectContaining({
                 id: 'jetbrains-terminal',
-                message: expect.stringContaining(`Warning: JetBrains mouse scrolling is unreliable. Disabling alternate buffer mode in settings or using an external terminal (e.g., ${externalTerminal}) is recommended.`),
+                message: expect.stringContaining('JetBrains terminal detected'),
+                priority: WarningPriority.High,
+            }));
+        });
+        it('should return tmux warning when detected and in alternate buffer', () => {
+            vi.stubEnv('TMUX', '/tmp/tmux-1001/default,1,0');
+            const warnings = getCompatibilityWarnings({ isAlternateBuffer: true });
+            expect(warnings).toContainEqual(expect.objectContaining({
+                id: 'tmux-alternate-buffer',
+                message: expect.stringContaining('tmux detected'),
+                priority: WarningPriority.High,
+            }));
+        });
+        it('should return low-color tmux warning when detected', () => {
+            vi.stubEnv('TERM', 'screen');
+            vi.stubEnv('TMUX', '1');
+            vi.stubEnv('COLORTERM', '');
+            const warnings = getCompatibilityWarnings();
+            expect(warnings).toContainEqual(expect.objectContaining({
+                id: 'low-color-tmux',
+                message: expect.stringContaining('Limited color support detected'),
+                priority: WarningPriority.High,
+            }));
+        });
+        it('should return GNU screen warning when detected', () => {
+            vi.stubEnv('STY', '1234.pts-0.host');
+            const warnings = getCompatibilityWarnings();
+            expect(warnings).toContainEqual(expect.objectContaining({
+                id: 'gnu-screen',
+                message: expect.stringContaining('GNU screen detected'),
+                priority: WarningPriority.Low,
+            }));
+        });
+        it.each(['dumb', 'vt100'])('should return dumb terminal warning when TERM=%s', (term) => {
+            vi.stubEnv('TERM', term);
+            const warnings = getCompatibilityWarnings();
+            expect(warnings).toContainEqual(expect.objectContaining({
+                id: 'dumb-terminal',
+                message: `Warning: Basic terminal detected (TERM=${term}). Visual rendering will be limited. For the best experience, use a terminal emulator with truecolor support.`,
                 priority: WarningPriority.High,
             }));
         });