@zgsm/costrict-cli 0.0.1

package/dist/src/ui/utils/ui-sizing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-sizing.test.js","sourceRoot":"","sources":["../../../../src/ui/utils/ui-sizing.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAuB,MAAM,0BAA0B,CAAC;AAE/D,oBAAoB;AACpB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9B,wBAAwB,EAAE,EAAE,CAAC,EAAE,EAAE;CAClC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;CACzD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,cAAc,GAAG,CAAC,YAAsB,EAAkB,EAAE,CAChE,CAAC;QACC,MAAM,EAAE;YACN,EAAE,EAAE;gBACF,YAAY;aACb;SACF;KACF,CAA8B,CAAC;IAElC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,IAAI,CAAC;YACN,iDAAiD;YACjD,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrB,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;YACvB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,0BAA0B;YAChD,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YAErB,oDAAoD;YACpD,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC;YAE5B,qCAAqC;YACrC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,YAAY;YACpC,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,aAAa;YACvC,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,sBAAsB;YAEhD,sBAAsB;YACtB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,gBAAgB;SAC3C,CAAC,CACA,+DAA+D,EAC/D,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC3C,KAAK,CAAC,wBAAwB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE9C,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC,CACF,CAAC;QAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,KAAK,CAAC,wBAAwB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAEvC,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,4BAA4B;YAC5B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import semver from 'semver';
+import type { LoadedSettings } from '../../config/settings.js';
+export declare const FETCH_TIMEOUT_MS = 2000;
+export interface UpdateInfo {
+    latest: string;
+    current: string;
+    name: string;
+    type?: semver.ReleaseType;
+}
+export interface UpdateObject {
+    message: string;
+    update: UpdateInfo;
+}
+export declare function checkForUpdates(settings: LoadedSettings): Promise<UpdateObject | null>;

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?.disableUpdateNag) {
+            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: {
+                    disableUpdateNag: false,
+                },
+            },
+        };
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('should return null if disableUpdateNag is true', async () => {
+        mockSettings.merged.general.disableUpdateNag = true;
+        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/checks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function assumeExhaustive(_value: never): void;
+/**
+ * Throws an exception on unexpected values.
+ *
+ * A common use case is switch statements:
+ * switch(enumValue) {
+ *   case Enum.A:
+ *   case Enum.B:
+ *     break;
+ *   default:
+ *     checkExhaustive(enumValue);
+ * }
+ */
+export declare function checkExhaustive(value: never, msg?: string): never;

package/dist/src/utils/checks.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* Fail to compile on unexpected values. */
+export function assumeExhaustive(_value) { }
+/**
+ * Throws an exception on unexpected values.
+ *
+ * A common use case is switch statements:
+ * switch(enumValue) {
+ *   case Enum.A:
+ *   case Enum.B:
+ *     break;
+ *   default:
+ *     checkExhaustive(enumValue);
+ * }
+ */
+export function checkExhaustive(value, msg = `unexpected value ${value}!`) {
+    assumeExhaustive(value);
+    throw new Error(msg);
+}
+//# sourceMappingURL=checks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../../src/utils/checks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,MAAa,IAAS,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,GAAG,GAAG,oBAAoB,KAAK,GAAG;IAElC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { checkExhaustive, assumeExhaustive } from './checks.js';
+describe('checks', () => {
+    describe('checkExhaustive', () => {
+        it('should throw an error with default message', () => {
+            expect(() => {
+                checkExhaustive('unexpected');
+            }).toThrow('unexpected value unexpected!');
+        });
+        it('should throw an error with custom message', () => {
+            expect(() => {
+                checkExhaustive('unexpected', 'custom message');
+            }).toThrow('custom message');
+        });
+    });
+    describe('assumeExhaustive', () => {
+        it('should do nothing', () => {
+            expect(() => {
+                assumeExhaustive('unexpected');
+            }).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=checks.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checks.test.js","sourceRoot":"","sources":["../../../src/utils/checks.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CAAC,GAAG,EAAE;gBACV,eAAe,CAAC,YAAqB,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,GAAG,EAAE;gBACV,eAAe,CAAC,YAAqB,EAAE,gBAAgB,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,GAAG,EAAE;gBACV,gBAAgB,CAAC,YAAqB,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '@google/gemini-cli-core';
+export declare function registerCleanup(fn: (() => void) | (() => Promise<void>)): void;
+export declare function registerSyncCleanup(fn: () => void): void;
+export declare function runSyncCleanup(): void;
+/**
+ * Register the config instance for telemetry shutdown.
+ * This must be called early in the application lifecycle.
+ */
+export declare function registerTelemetryConfig(config: Config): void;
+export declare function runExitCleanup(): Promise<void>;
+export declare function cleanupCheckpoints(): Promise<void>;

package/dist/src/utils/cleanup.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { Storage, shutdownTelemetry, isTelemetrySdkInitialized, } from '@google/gemini-cli-core';
+const cleanupFunctions = [];
+const syncCleanupFunctions = [];
+let configForTelemetry = null;
+export function registerCleanup(fn) {
+    cleanupFunctions.push(fn);
+}
+export function registerSyncCleanup(fn) {
+    syncCleanupFunctions.push(fn);
+}
+export function runSyncCleanup() {
+    for (const fn of syncCleanupFunctions) {
+        try {
+            fn();
+        }
+        catch (_) {
+            // Ignore errors during cleanup.
+        }
+    }
+    syncCleanupFunctions.length = 0;
+}
+/**
+ * Register the config instance for telemetry shutdown.
+ * This must be called early in the application lifecycle.
+ */
+export function registerTelemetryConfig(config) {
+    configForTelemetry = config;
+}
+export async function runExitCleanup() {
+    runSyncCleanup();
+    for (const fn of cleanupFunctions) {
+        try {
+            await fn();
+        }
+        catch (_) {
+            // Ignore errors during cleanup.
+        }
+    }
+    cleanupFunctions.length = 0; // Clear the array
+    // IMPORTANT: Shutdown telemetry AFTER all other cleanup functions have run
+    // This ensures SessionEnd hooks and other telemetry are properly flushed
+    if (configForTelemetry && isTelemetrySdkInitialized()) {
+        try {
+            await shutdownTelemetry(configForTelemetry);
+        }
+        catch (_) {
+            // Ignore errors during telemetry shutdown
+        }
+    }
+}
+export async function cleanupCheckpoints() {
+    const storage = new Storage(process.cwd());
+    const tempDir = storage.getProjectTempDir();
+    const checkpointsDir = join(tempDir, 'checkpoints');
+    try {
+        await fs.rm(checkpointsDir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore errors if the directory doesn't exist or fails to delete.
+    }
+}
+//# sourceMappingURL=cleanup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAGjC,MAAM,gBAAgB,GAAgD,EAAE,CAAC;AACzE,MAAM,oBAAoB,GAAsB,EAAE,CAAC;AACnD,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,MAAM,UAAU,eAAe,CAAC,EAAwC;IACtE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAc;IAChD,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,KAAK,MAAM,EAAE,IAAI,oBAAoB,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,kBAAkB,GAAG,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,cAAc,EAAE,CAAC;IACjB,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,kBAAkB;IAE/C,2EAA2E;IAC3E,yEAAyE;IACzE,IAAI,kBAAkB,IAAI,yBAAyB,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,0CAA0C;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+vi.mock('@google/gemini-cli-core', () => ({
+    Storage: vi.fn().mockImplementation(() => ({
+        getProjectTempDir: vi.fn().mockReturnValue('/tmp/project'),
+    })),
+}));
+vi.mock('node:fs', () => ({
+    promises: {
+        rm: vi.fn(),
+    },
+}));
+describe('cleanup', () => {
+    beforeEach(async () => {
+        vi.resetModules();
+        vi.clearAllMocks();
+        // No need to re-assign, we can use the imported functions directly
+        // because we are using vi.resetModules() and re-importing if necessary,
+        // but actually, since we are mocking dependencies, we might not need to re-import cleanup.js
+        // unless it has internal state that needs resetting. It does (cleanupFunctions array).
+        // So we DO need to re-import it to get fresh state.
+    });
+    it('should run a registered synchronous function', async () => {
+        const cleanupModule = await import('./cleanup.js');
+        const cleanupFn = vi.fn();
+        cleanupModule.registerCleanup(cleanupFn);
+        await cleanupModule.runExitCleanup();
+        expect(cleanupFn).toHaveBeenCalledTimes(1);
+    });
+    it('should run a registered asynchronous function', async () => {
+        const cleanupModule = await import('./cleanup.js');
+        const cleanupFn = vi.fn().mockResolvedValue(undefined);
+        cleanupModule.registerCleanup(cleanupFn);
+        await cleanupModule.runExitCleanup();
+        expect(cleanupFn).toHaveBeenCalledTimes(1);
+    });
+    it('should run multiple registered functions', async () => {
+        const cleanupModule = await import('./cleanup.js');
+        const syncFn = vi.fn();
+        const asyncFn = vi.fn().mockResolvedValue(undefined);
+        cleanupModule.registerCleanup(syncFn);
+        cleanupModule.registerCleanup(asyncFn);
+        await cleanupModule.runExitCleanup();
+        expect(syncFn).toHaveBeenCalledTimes(1);
+        expect(asyncFn).toHaveBeenCalledTimes(1);
+    });
+    it('should continue running cleanup functions even if one throws an error', async () => {
+        const cleanupModule = await import('./cleanup.js');
+        const errorFn = vi.fn().mockImplementation(() => {
+            throw new Error('test error');
+        });
+        const successFn = vi.fn();
+        cleanupModule.registerCleanup(errorFn);
+        cleanupModule.registerCleanup(successFn);
+        await expect(cleanupModule.runExitCleanup()).resolves.not.toThrow();
+        expect(errorFn).toHaveBeenCalledTimes(1);
+        expect(successFn).toHaveBeenCalledTimes(1);
+    });
+    describe('sync cleanup', () => {
+        it('should run registered sync functions', async () => {
+            const cleanupModule = await import('./cleanup.js');
+            const syncFn = vi.fn();
+            cleanupModule.registerSyncCleanup(syncFn);
+            cleanupModule.runSyncCleanup();
+            expect(syncFn).toHaveBeenCalledTimes(1);
+        });
+        it('should continue running sync cleanup functions even if one throws', async () => {
+            const cleanupModule = await import('./cleanup.js');
+            const errorFn = vi.fn().mockImplementation(() => {
+                throw new Error('test error');
+            });
+            const successFn = vi.fn();
+            cleanupModule.registerSyncCleanup(errorFn);
+            cleanupModule.registerSyncCleanup(successFn);
+            expect(() => cleanupModule.runSyncCleanup()).not.toThrow();
+            expect(errorFn).toHaveBeenCalledTimes(1);
+            expect(successFn).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('cleanupCheckpoints', () => {
+        it('should remove checkpoints directory', async () => {
+            const cleanupModule = await import('./cleanup.js');
+            await cleanupModule.cleanupCheckpoints();
+            expect(fs.rm).toHaveBeenCalledWith(path.join('/tmp/project', 'checkpoints'), {
+                recursive: true,
+                force: true,
+            });
+        });
+        it('should ignore errors during checkpoint removal', async () => {
+            const cleanupModule = await import('./cleanup.js');
+            vi.mocked(fs.rm).mockRejectedValue(new Error('Failed to remove'));
+            await expect(cleanupModule.cleanupCheckpoints()).resolves.not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=cleanup.test.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type SlashCommand } from '../ui/commands/types.js';
+export type ParsedSlashCommand = {
+    commandToExecute: SlashCommand | undefined;
+    args: string;
+    canonicalPath: string[];
+};
+/**
+ * Parses a raw slash command string into its command, arguments, and canonical path.
+ * If no valid command is found, the `commandToExecute` property will be `undefined`.
+ *
+ * @param query The raw input string, e.g., "/memory add some data" or "/help".
+ * @param commands The list of available top-level slash commands.
+ * @returns An object containing the resolved command, its arguments, and its canonical path.
+ */
+export declare const parseSlashCommand: (query: string, commands: readonly SlashCommand[]) => ParsedSlashCommand;

package/dist/src/utils/commands.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from '../ui/commands/types.js';
+/**
+ * Parses a raw slash command string into its command, arguments, and canonical path.
+ * If no valid command is found, the `commandToExecute` property will be `undefined`.
+ *
+ * @param query The raw input string, e.g., "/memory add some data" or "/help".
+ * @param commands The list of available top-level slash commands.
+ * @returns An object containing the resolved command, its arguments, and its canonical path.
+ */
+export const parseSlashCommand = (query, commands) => {
+    const trimmed = query.trim();
+    const parts = trimmed.substring(1).trim().split(/\s+/);
+    const commandPath = parts.filter((p) => p); // The parts of the command, e.g., ['memory', 'add']
+    let currentCommands = commands;
+    let commandToExecute;
+    let pathIndex = 0;
+    const canonicalPath = [];
+    for (const part of commandPath) {
+        // TODO: For better performance and architectural clarity, this two-pass
+        // search could be replaced. A more optimal approach would be to
+        // pre-compute a single lookup map in `CommandService.ts` that resolves
+        // all name and alias conflicts during the initial loading phase. The
+        // processor would then perform a single, fast lookup on that map.
+        // First pass: check for an exact match on the primary command name.
+        let foundCommand = currentCommands.find((cmd) => cmd.name === part);
+        // Second pass: if no primary name matches, check for an alias.
+        if (!foundCommand) {
+            foundCommand = currentCommands.find((cmd) => cmd.altNames?.includes(part));
+        }
+        if (foundCommand) {
+            commandToExecute = foundCommand;
+            canonicalPath.push(foundCommand.name);
+            pathIndex++;
+            if (foundCommand.subCommands) {
+                currentCommands = foundCommand.subCommands;
+            }
+            else {
+                break;
+            }
+        }
+        else {
+            break;
+        }
+    }
+    const args = parts.slice(pathIndex).join(' ');
+    return { commandToExecute, args, canonicalPath };
+};
+//# sourceMappingURL=commands.js.map