@trukhinyuri/gemini-pp 0.27.0-nightly.20260121.97aac696f

package/dist/src/ui/utils/updateCheck.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import latestVersion from 'latest-version';
+import semver from 'semver';
+import { getPackageJson, debugLogger } from '@google/gemini-cli-core';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export const FETCH_TIMEOUT_MS = 2000;
+/**
+ * From a nightly and stable version, determines which is the "best" one to offer.
+ * The rule is to always prefer nightly if the base versions are the same.
+ */
+function getBestAvailableUpdate(nightly, stable) {
+    if (!nightly)
+        return stable || null;
+    if (!stable)
+        return nightly || null;
+    if (semver.coerce(stable)?.version === semver.coerce(nightly)?.version) {
+        return nightly;
+    }
+    return semver.gt(stable, nightly) ? stable : nightly;
+}
+export async function checkForUpdates(settings) {
+    try {
+        if (!settings.merged.general.enableAutoUpdateNotification) {
+            return null;
+        }
+        // Skip update check when running from source (development mode)
+        if (process.env['DEV'] === 'true') {
+            return null;
+        }
+        const packageJson = await getPackageJson(__dirname);
+        if (!packageJson || !packageJson.name || !packageJson.version) {
+            return null;
+        }
+        const { name, version: currentVersion } = packageJson;
+        const isNightly = currentVersion.includes('nightly');
+        if (isNightly) {
+            const [nightlyUpdate, latestUpdate] = await Promise.all([
+                latestVersion(name, { version: 'nightly' }),
+                latestVersion(name),
+            ]);
+            const bestUpdate = getBestAvailableUpdate(nightlyUpdate, latestUpdate);
+            if (bestUpdate && semver.gt(bestUpdate, currentVersion)) {
+                const message = `A new version of Gemini CLI is available! ${currentVersion} → ${bestUpdate}`;
+                const type = semver.diff(bestUpdate, currentVersion) || undefined;
+                return {
+                    message,
+                    update: {
+                        latest: bestUpdate,
+                        current: currentVersion,
+                        name,
+                        type,
+                    },
+                };
+            }
+        }
+        else {
+            const latestUpdate = await latestVersion(name);
+            if (latestUpdate && semver.gt(latestUpdate, currentVersion)) {
+                const message = `Gemini CLI update available! ${currentVersion} → ${latestUpdate}`;
+                const type = semver.diff(latestUpdate, currentVersion) || undefined;
+                return {
+                    message,
+                    update: {
+                        latest: latestUpdate,
+                        current: currentVersion,
+                        name,
+                        type,
+                    },
+                };
+            }
+        }
+        return null;
+    }
+    catch (e) {
+        debugLogger.warn('Failed to check for updates: ' + e);
+        return null;
+    }
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/src/ui/utils/updateCheck.js.map

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

package/dist/src/ui/utils/updateCheck.test.d.ts

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

package/dist/src/ui/utils/updateCheck.test.js

@@ -0,0 +1,134 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { checkForUpdates } from './updateCheck.js';
+const getPackageJson = vi.hoisted(() => vi.fn());
+const debugLogger = vi.hoisted(() => ({
+    warn: vi.fn(),
+}));
+vi.mock('@google/gemini-cli-core', () => ({
+    getPackageJson,
+    debugLogger,
+}));
+const latestVersion = vi.hoisted(() => vi.fn());
+vi.mock('latest-version', () => ({
+    default: latestVersion,
+}));
+describe('checkForUpdates', () => {
+    let mockSettings;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.resetAllMocks();
+        // Clear DEV environment variable before each test
+        delete process.env['DEV'];
+        mockSettings = {
+            merged: {
+                general: {
+                    enableAutoUpdateNotification: true,
+                },
+            },
+        };
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('should return null if enableAutoUpdateNotification is false', async () => {
+        mockSettings.merged.general.enableAutoUpdateNotification = false;
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+        expect(getPackageJson).not.toHaveBeenCalled();
+        expect(latestVersion).not.toHaveBeenCalled();
+    });
+    it('should return null when running from source (DEV=true)', async () => {
+        process.env['DEV'] = 'true';
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.0.0',
+        });
+        latestVersion.mockResolvedValue('1.1.0');
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+        expect(getPackageJson).not.toHaveBeenCalled();
+        expect(latestVersion).not.toHaveBeenCalled();
+    });
+    it('should return null if package.json is missing', async () => {
+        getPackageJson.mockResolvedValue(null);
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    it('should return null if there is no update', async () => {
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.0.0',
+        });
+        latestVersion.mockResolvedValue('1.0.0');
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    it('should return a message if a newer version is available', async () => {
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.0.0',
+        });
+        latestVersion.mockResolvedValue('1.1.0');
+        const result = await checkForUpdates(mockSettings);
+        expect(result?.message).toContain('1.0.0 → 1.1.0');
+        expect(result?.update.current).toEqual('1.0.0');
+        expect(result?.update.latest).toEqual('1.1.0');
+        expect(result?.update.name).toEqual('test-package');
+    });
+    it('should return null if the latest version is the same as the current version', async () => {
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.0.0',
+        });
+        latestVersion.mockResolvedValue('1.0.0');
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    it('should return null if the latest version is older than the current version', async () => {
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.1.0',
+        });
+        latestVersion.mockResolvedValue('1.0.0');
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    it('should return null if latestVersion rejects', async () => {
+        getPackageJson.mockResolvedValue({
+            name: 'test-package',
+            version: '1.0.0',
+        });
+        latestVersion.mockRejectedValue(new Error('Timeout'));
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    it('should handle errors gracefully', async () => {
+        getPackageJson.mockRejectedValue(new Error('test error'));
+        const result = await checkForUpdates(mockSettings);
+        expect(result).toBeNull();
+    });
+    describe('nightly updates', () => {
+        it('should notify for a newer nightly version when current is nightly', async () => {
+            getPackageJson.mockResolvedValue({
+                name: 'test-package',
+                version: '1.2.3-nightly.1',
+            });
+            latestVersion.mockImplementation(async (name, options) => {
+                if (options?.version === 'nightly') {
+                    return '1.2.3-nightly.2';
+                }
+                return '1.2.3';
+            });
+            const result = await checkForUpdates(mockSettings);
+            expect(result?.message).toContain('1.2.3-nightly.1 → 1.2.3-nightly.2');
+            expect(result?.update.latest).toBe('1.2.3-nightly.2');
+        });
+    });
+});
+//# sourceMappingURL=updateCheck.test.js.map

package/dist/src/ui/utils/updateCheck.test.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+import type { Config } from '@google/gemini-cli-core';
+export interface NetworkLog {
+    id: string;
+    timestamp: number;
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+    pending?: boolean;
+    response?: {
+        status: number;
+        headers: Record<string, string>;
+        body?: string;
+        durationMs: number;
+    };
+    error?: string;
+}
+/**
+ * Capture utility for session activities (network and console).
+ * Provides a stream of events that can be persisted for analysis or inspection.
+ */
+export declare class ActivityLogger extends EventEmitter {
+    private static instance;
+    private isInterceptionEnabled;
+    private requestStartTimes;
+    static getInstance(): ActivityLogger;
+    private stringifyHeaders;
+    private sanitizeNetworkLog;
+    private safeEmitNetwork;
+    enable(): void;
+    private patchGlobalFetch;
+    private patchNodeHttp;
+    logConsole(payload: unknown): void;
+}
+/**
+ * Registers the activity logger if debug mode and interactive session are enabled.
+ * Captures network and console logs to a session-specific JSONL file.
+ *
+ * @param config The CLI configuration
+ */
+export declare function registerActivityLogger(config: Config): void;

package/dist/src/utils/activityLogger.js

@@ -0,0 +1,297 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unnecessary-type-assertion */
+/* eslint-disable @typescript-eslint/no-this-alias */
+import http from 'node:http';
+import https from 'node:https';
+import zlib from 'node:zlib';
+import fs from 'node:fs';
+import path from 'node:path';
+import { EventEmitter } from 'node:events';
+import { CoreEvent, coreEvents, debugLogger } from '@google/gemini-cli-core';
+const ACTIVITY_ID_HEADER = 'x-activity-request-id';
+/**
+ * Capture utility for session activities (network and console).
+ * Provides a stream of events that can be persisted for analysis or inspection.
+ */
+export class ActivityLogger extends EventEmitter {
+    static instance;
+    isInterceptionEnabled = false;
+    requestStartTimes = new Map();
+    static getInstance() {
+        if (!ActivityLogger.instance) {
+            ActivityLogger.instance = new ActivityLogger();
+        }
+        return ActivityLogger.instance;
+    }
+    stringifyHeaders(headers) {
+        const result = {};
+        if (!headers)
+            return result;
+        if (headers instanceof Headers) {
+            headers.forEach((v, k) => {
+                result[k.toLowerCase()] = v;
+            });
+        }
+        else if (typeof headers === 'object' && headers !== null) {
+            for (const [key, val] of Object.entries(headers)) {
+                result[key.toLowerCase()] = Array.isArray(val)
+                    ? val.join(', ')
+                    : String(val);
+            }
+        }
+        return result;
+    }
+    sanitizeNetworkLog(log) {
+        if (!log || typeof log !== 'object')
+            return log;
+        const sanitized = { ...log };
+        // Sanitize request headers
+        if (sanitized.headers) {
+            const headers = { ...sanitized.headers };
+            for (const key of Object.keys(headers)) {
+                if (['authorization', 'cookie', 'x-goog-api-key'].includes(key.toLowerCase())) {
+                    headers[key] = '[REDACTED]';
+                }
+            }
+            sanitized.headers = headers;
+        }
+        // Sanitize response headers
+        if (sanitized.response?.headers) {
+            const resHeaders = { ...sanitized.response.headers };
+            for (const key of Object.keys(resHeaders)) {
+                if (['set-cookie'].includes(key.toLowerCase())) {
+                    resHeaders[key] = '[REDACTED]';
+                }
+            }
+            sanitized.response = { ...sanitized.response, headers: resHeaders };
+        }
+        return sanitized;
+    }
+    safeEmitNetwork(payload) {
+        this.emit('network', this.sanitizeNetworkLog(payload));
+    }
+    enable() {
+        if (this.isInterceptionEnabled)
+            return;
+        this.isInterceptionEnabled = true;
+        this.patchGlobalFetch();
+        this.patchNodeHttp();
+    }
+    patchGlobalFetch() {
+        if (!global.fetch)
+            return;
+        const originalFetch = global.fetch;
+        global.fetch = async (input, init) => {
+            const url = typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.toString()
+                    : input.url;
+            if (url.includes('127.0.0.1'))
+                return originalFetch(input, init);
+            const id = Math.random().toString(36).substring(7);
+            const method = (init?.method || 'GET').toUpperCase();
+            const newInit = { ...init };
+            const headers = new Headers(init?.headers || {});
+            headers.set(ACTIVITY_ID_HEADER, id);
+            newInit.headers = headers;
+            let reqBody = '';
+            if (init?.body) {
+                if (typeof init.body === 'string')
+                    reqBody = init.body;
+                else if (init.body instanceof URLSearchParams)
+                    reqBody = init.body.toString();
+            }
+            this.requestStartTimes.set(id, Date.now());
+            this.safeEmitNetwork({
+                id,
+                timestamp: Date.now(),
+                method,
+                url,
+                headers: this.stringifyHeaders(newInit.headers),
+                body: reqBody,
+                pending: true,
+            });
+            try {
+                const response = await originalFetch(input, newInit);
+                const clonedRes = response.clone();
+                clonedRes
+                    .text()
+                    .then((text) => {
+                    const startTime = this.requestStartTimes.get(id);
+                    const durationMs = startTime ? Date.now() - startTime : 0;
+                    this.requestStartTimes.delete(id);
+                    this.safeEmitNetwork({
+                        id,
+                        pending: false,
+                        response: {
+                            status: response.status,
+                            headers: this.stringifyHeaders(response.headers),
+                            body: text,
+                            durationMs,
+                        },
+                    });
+                })
+                    .catch((err) => {
+                    const message = err instanceof Error ? err.message : String(err);
+                    this.safeEmitNetwork({
+                        id,
+                        pending: false,
+                        error: `Failed to read response body: ${message}`,
+                    });
+                });
+                return response;
+            }
+            catch (err) {
+                this.requestStartTimes.delete(id);
+                const message = err instanceof Error ? err.message : String(err);
+                this.safeEmitNetwork({ id, pending: false, error: message });
+                throw err;
+            }
+        };
+    }
+    patchNodeHttp() {
+        const self = this;
+        const originalRequest = http.request;
+        const originalHttpsRequest = https.request;
+        const wrapRequest = (originalFn, args, protocol) => {
+            const options = args[0];
+            const url = typeof options === 'string'
+                ? options
+                : options.href ||
+                    `${protocol}//${options.hostname || options.host || 'localhost'}${options.path || '/'}`;
+            if (url.includes('127.0.0.1'))
+                return originalFn.apply(http, args);
+            const headers = typeof options === 'object' && typeof options !== 'function'
+                ? options.headers
+                : {};
+            if (headers && headers[ACTIVITY_ID_HEADER]) {
+                delete headers[ACTIVITY_ID_HEADER];
+                return originalFn.apply(http, args);
+            }
+            const id = Math.random().toString(36).substring(7);
+            self.requestStartTimes.set(id, Date.now());
+            const req = originalFn.apply(http, args);
+            const requestChunks = [];
+            const oldWrite = req.write;
+            const oldEnd = req.end;
+            req.write = function (chunk, ...etc) {
+                if (chunk) {
+                    const encoding = typeof etc[0] === 'string' ? etc[0] : undefined;
+                    requestChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, encoding));
+                }
+                return oldWrite.apply(this, [chunk, ...etc]);
+            };
+            req.end = function (chunk, ...etc) {
+                if (chunk && typeof chunk !== 'function') {
+                    const encoding = typeof etc[0] === 'string' ? etc[0] : undefined;
+                    requestChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, encoding));
+                }
+                const body = Buffer.concat(requestChunks).toString('utf8');
+                self.safeEmitNetwork({
+                    id,
+                    timestamp: Date.now(),
+                    method: req.method || 'GET',
+                    url,
+                    headers: self.stringifyHeaders(req.getHeaders()),
+                    body,
+                    pending: true,
+                });
+                return oldEnd.apply(this, [chunk, ...etc]);
+            };
+            req.on('response', (res) => {
+                const responseChunks = [];
+                res.on('data', (chunk) => responseChunks.push(Buffer.from(chunk)));
+                res.on('end', () => {
+                    const buffer = Buffer.concat(responseChunks);
+                    const encoding = res.headers['content-encoding'];
+                    const processBuffer = (finalBuffer) => {
+                        const resBody = finalBuffer.toString('utf8');
+                        const startTime = self.requestStartTimes.get(id);
+                        const durationMs = startTime ? Date.now() - startTime : 0;
+                        self.requestStartTimes.delete(id);
+                        self.safeEmitNetwork({
+                            id,
+                            pending: false,
+                            response: {
+                                status: res.statusCode,
+                                headers: self.stringifyHeaders(res.headers),
+                                body: resBody,
+                                durationMs,
+                            },
+                        });
+                    };
+                    if (encoding === 'gzip') {
+                        zlib.gunzip(buffer, (err, decompressed) => {
+                            processBuffer(err ? buffer : decompressed);
+                        });
+                    }
+                    else if (encoding === 'deflate') {
+                        zlib.inflate(buffer, (err, decompressed) => {
+                            processBuffer(err ? buffer : decompressed);
+                        });
+                    }
+                    else {
+                        processBuffer(buffer);
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                self.requestStartTimes.delete(id);
+                const message = err instanceof Error ? err.message : String(err);
+                self.safeEmitNetwork({ id, pending: false, error: message });
+            });
+            return req;
+        };
+        http.request = (...args) => wrapRequest(originalRequest, args, 'http:');
+        https.request = (...args) => wrapRequest(originalHttpsRequest, args, 'https:');
+    }
+    logConsole(payload) {
+        this.emit('console', payload);
+    }
+}
+/**
+ * Registers the activity logger if debug mode and interactive session are enabled.
+ * Captures network and console logs to a session-specific JSONL file.
+ *
+ * @param config The CLI configuration
+ */
+export function registerActivityLogger(config) {
+    if (config.isInteractive() && config.storage && config.getDebugMode()) {
+        const capture = ActivityLogger.getInstance();
+        capture.enable();
+        const logsDir = config.storage.getProjectTempLogsDir();
+        if (!fs.existsSync(logsDir)) {
+            fs.mkdirSync(logsDir, { recursive: true });
+        }
+        const logFile = path.join(logsDir, `session-${config.getSessionId()}.jsonl`);
+        const writeToLog = (type, payload) => {
+            try {
+                const entry = JSON.stringify({
+                    type,
+                    payload,
+                    timestamp: Date.now(),
+                }) + '\n';
+                // Use asynchronous fire-and-forget to avoid blocking the event loop
+                fs.promises.appendFile(logFile, entry).catch((err) => {
+                    debugLogger.error('Failed to write to activity log:', err);
+                });
+            }
+            catch (err) {
+                debugLogger.error('Failed to prepare activity log entry:', err);
+            }
+        };
+        capture.on('console', (payload) => writeToLog('console', payload));
+        capture.on('network', (payload) => writeToLog('network', payload));
+        // Bridge CoreEvents to local capture
+        coreEvents.on(CoreEvent.ConsoleLog, (payload) => {
+            capture.logConsole(payload);
+        });
+    }
+}
+//# sourceMappingURL=activityLogger.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SettingScope, type LoadedSettings } from '../config/settings.js';
+import type { ModifiedScope } from './skillSettings.js';
+export type AgentActionStatus = 'success' | 'no-op' | 'error';
+/**
+ * Metadata representing the result of an agent settings operation.
+ */
+export interface AgentActionResult {
+    status: AgentActionStatus;
+    agentName: string;
+    action: 'enable' | 'disable';
+    /** Scopes where the agent's state was actually changed. */
+    modifiedScopes: ModifiedScope[];
+    /** Scopes where the agent was already in the desired state. */
+    alreadyInStateScopes: ModifiedScope[];
+    /** Error message if status is 'error'. */
+    error?: string;
+}
+/**
+ * Enables an agent by ensuring it is enabled in any writable scope (User and Workspace).
+ * It sets `agents.overrides.<agentName>.enabled` to `true`.
+ */
+export declare function enableAgent(settings: LoadedSettings, agentName: string): AgentActionResult;
+/**
+ * Disables an agent by setting `agents.overrides.<agentName>.enabled` to `false` in the specified scope.
+ */
+export declare function disableAgent(settings: LoadedSettings, agentName: string, scope: SettingScope): AgentActionResult;