@machina.ai/cell-cli 1.11.0-rc1 → 1.13.0-rc1

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

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type MouseEventName = 'left-press' | 'left-release' | 'right-press' | 'right-release' | 'middle-press' | 'middle-release' | 'scroll-up' | 'scroll-down' | 'scroll-left' | 'scroll-right' | 'move';
+export interface MouseEvent {
+    name: MouseEventName;
+    col: number;
+    row: number;
+    shift: boolean;
+    meta: boolean;
+    ctrl: boolean;
+}
+export type MouseHandler = (event: MouseEvent) => void;
+export declare function getMouseEventName(buttonCode: number, isRelease: boolean): MouseEventName | null;
+export declare function parseSGRMouseEvent(buffer: string): {
+    event: MouseEvent;
+    length: number;
+} | null;
+export declare function parseX11MouseEvent(buffer: string): {
+    event: MouseEvent;
+    length: number;
+} | null;
+export declare function parseMouseEvent(buffer: string): {
+    event: MouseEvent;
+    length: number;
+} | null;
+export declare function isIncompleteMouseSequence(buffer: string): boolean;
+export declare function enableMouseEvents(): void;
+export declare function disableMouseEvents(): void;

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

@@ -0,0 +1,164 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import process from 'node:process';
+import { SGR_MOUSE_REGEX, X11_MOUSE_REGEX, SGR_EVENT_PREFIX, X11_EVENT_PREFIX, couldBeMouseSequence as inputCouldBeMouseSequence, } from './input.js';
+export function getMouseEventName(buttonCode, isRelease) {
+    const isMove = (buttonCode & 32) !== 0;
+    if (buttonCode === 66) {
+        return 'scroll-left';
+    }
+    else if (buttonCode === 67) {
+        return 'scroll-right';
+    }
+    else if ((buttonCode & 64) === 64) {
+        if ((buttonCode & 1) === 0) {
+            return 'scroll-up';
+        }
+        else {
+            return 'scroll-down';
+        }
+    }
+    else if (isMove) {
+        return 'move';
+    }
+    else {
+        const button = buttonCode & 3;
+        const type = isRelease ? 'release' : 'press';
+        switch (button) {
+            case 0:
+                return `left-${type}`;
+            case 1:
+                return `middle-${type}`;
+            case 2:
+                return `right-${type}`;
+            default:
+                return null;
+        }
+    }
+}
+export function parseSGRMouseEvent(buffer) {
+    const match = buffer.match(SGR_MOUSE_REGEX);
+    if (match) {
+        const buttonCode = parseInt(match[1], 10);
+        const col = parseInt(match[2], 10);
+        const row = parseInt(match[3], 10);
+        const action = match[4];
+        const isRelease = action === 'm';
+        const shift = (buttonCode & 4) !== 0;
+        const meta = (buttonCode & 8) !== 0;
+        const ctrl = (buttonCode & 16) !== 0;
+        const name = getMouseEventName(buttonCode, isRelease);
+        if (name) {
+            return {
+                event: {
+                    name,
+                    ctrl,
+                    meta,
+                    shift,
+                    col,
+                    row,
+                },
+                length: match[0].length,
+            };
+        }
+        return null;
+    }
+    return null;
+}
+export function parseX11MouseEvent(buffer) {
+    const match = buffer.match(X11_MOUSE_REGEX);
+    if (!match)
+        return null;
+    // The 3 bytes are in match[1]
+    const b = match[1].charCodeAt(0) - 32;
+    const col = match[1].charCodeAt(1) - 32;
+    const row = match[1].charCodeAt(2) - 32;
+    const shift = (b & 4) !== 0;
+    const meta = (b & 8) !== 0;
+    const ctrl = (b & 16) !== 0;
+    const isMove = (b & 32) !== 0;
+    const isWheel = (b & 64) !== 0;
+    let name = null;
+    if (isWheel) {
+        const button = b & 3;
+        switch (button) {
+            case 0:
+                name = 'scroll-up';
+                break;
+            case 1:
+                name = 'scroll-down';
+                break;
+            default:
+                break;
+        }
+    }
+    else if (isMove) {
+        name = 'move';
+    }
+    else {
+        const button = b & 3;
+        if (button === 3) {
+            // X11 reports 'release' (3) for all button releases without specifying which one.
+            // We'll default to 'left-release' as a best-effort guess if we don't track state.
+            name = 'left-release';
+        }
+        else {
+            switch (button) {
+                case 0:
+                    name = 'left-press';
+                    break;
+                case 1:
+                    name = 'middle-press';
+                    break;
+                case 2:
+                    name = 'right-press';
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+    if (name) {
+        return {
+            event: { name, ctrl, meta, shift, col, row },
+            length: match[0].length,
+        };
+    }
+    return null;
+}
+export function parseMouseEvent(buffer) {
+    return parseSGRMouseEvent(buffer) || parseX11MouseEvent(buffer);
+}
+export function isIncompleteMouseSequence(buffer) {
+    if (!inputCouldBeMouseSequence(buffer))
+        return false;
+    // If it matches a complete sequence, it's not incomplete.
+    if (parseMouseEvent(buffer))
+        return false;
+    if (buffer.startsWith(X11_EVENT_PREFIX)) {
+        // X11 needs exactly 3 bytes after prefix.
+        return buffer.length < X11_EVENT_PREFIX.length + 3;
+    }
+    if (buffer.startsWith(SGR_EVENT_PREFIX)) {
+        // SGR sequences end with 'm' or 'M'.
+        // If it doesn't have it yet, it's incomplete.
+        // Add a reasonable max length check to fail early on garbage.
+        return !/[mM]/.test(buffer) && buffer.length < 50;
+    }
+    // It's a prefix of the prefix (e.g. "ESC" or "ESC [")
+    return true;
+}
+export function enableMouseEvents() {
+    // Enable mouse tracking with SGR format
+    // ?1002h = button event tracking (clicks + drags + scroll wheel)
+    // ?1006h = SGR extended mouse mode (better coordinate handling)
+    process.stdout.write('\u001b[?1002h\u001b[?1006h');
+}
+export function disableMouseEvents() {
+    // Disable mouse tracking with SGR format
+    process.stdout.write('\u001b[?1006l\u001b[?1002l');
+}
+//# sourceMappingURL=mouse.js.map

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

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

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

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

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

@@ -0,0 +1,131 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { parseSGRMouseEvent, parseX11MouseEvent, isIncompleteMouseSequence, parseMouseEvent, } from './mouse.js';
+import { ESC } from './input.js';
+describe('mouse utils', () => {
+    describe('parseSGRMouseEvent', () => {
+        it('parses a valid SGR mouse press', () => {
+            // Button 0 (left), col 37, row 25, press (M)
+            const input = `${ESC}[<0;37;25M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 37,
+                row: 25,
+                shift: false,
+                meta: false,
+                ctrl: false,
+            });
+            expect(result.length).toBe(input.length);
+        });
+        it('parses a valid SGR mouse release', () => {
+            // Button 0 (left), col 37, row 25, release (m)
+            const input = `${ESC}[<0;37;25m`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-release',
+                col: 37,
+                row: 25,
+                shift: false,
+                meta: false,
+                ctrl: false,
+            });
+        });
+        it('parses SGR with modifiers', () => {
+            // Button 0 + Shift(4) + Meta(8) + Ctrl(16) = 0 + 4 + 8 + 16 = 28
+            const input = `${ESC}[<28;10;20M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 10,
+                row: 20,
+                shift: true,
+                meta: true,
+                ctrl: true,
+            });
+        });
+        it('parses SGR move event', () => {
+            // Button 0 + Move(32) = 32
+            const input = `${ESC}[<32;10;20M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event.name).toBe('move');
+        });
+        it('parses SGR scroll events', () => {
+            expect(parseSGRMouseEvent(`${ESC}[<64;1;1M`).event.name).toBe('scroll-up');
+            expect(parseSGRMouseEvent(`${ESC}[<65;1;1M`).event.name).toBe('scroll-down');
+        });
+        it('returns null for invalid SGR', () => {
+            expect(parseSGRMouseEvent(`${ESC}[<;1;1M`)).toBeNull();
+            expect(parseSGRMouseEvent(`${ESC}[<0;1;M`)).toBeNull();
+            expect(parseSGRMouseEvent(`not sgr`)).toBeNull();
+        });
+    });
+    describe('parseX11MouseEvent', () => {
+        it('parses a valid X11 mouse press', () => {
+            // Button 0 (left) + 32 = ' ' (space)
+            // Col 1 + 32 = '!'
+            // Row 1 + 32 = '!'
+            const input = `${ESC}[M !!`;
+            const result = parseX11MouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 1,
+                row: 1,
+                shift: false,
+                meta: false,
+                ctrl: false,
+            });
+            expect(result.length).toBe(6);
+        });
+        it('returns null for incomplete X11', () => {
+            expect(parseX11MouseEvent(`${ESC}[M !`)).toBeNull();
+        });
+    });
+    describe('isIncompleteMouseSequence', () => {
+        it('returns true for prefixes', () => {
+            expect(isIncompleteMouseSequence(ESC)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[`)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[<`)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[M`)).toBe(true);
+        });
+        it('returns true for partial SGR', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[<0;10;20`)).toBe(true);
+        });
+        it('returns true for partial X11', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[M `)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[M !`)).toBe(true);
+        });
+        it('returns false for complete SGR', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[<0;10;20M`)).toBe(false);
+        });
+        it('returns false for complete X11', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[M !!!`)).toBe(false);
+        });
+        it('returns false for non-mouse sequences', () => {
+            expect(isIncompleteMouseSequence('a')).toBe(false);
+            expect(isIncompleteMouseSequence(`${ESC}[A`)).toBe(false); // Arrow up
+        });
+        it('returns false for garbage that started like a mouse sequence but got too long (SGR)', () => {
+            const longGarbage = `${ESC}[<` + '0'.repeat(100);
+            expect(isIncompleteMouseSequence(longGarbage)).toBe(false);
+        });
+    });
+    describe('parseMouseEvent', () => {
+        it('parses SGR', () => {
+            expect(parseMouseEvent(`${ESC}[<0;1;1M`)).not.toBeNull();
+        });
+        it('parses X11', () => {
+            expect(parseMouseEvent(`${ESC}[M !!!`)).not.toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=mouse.test.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class TextOutput {
+    private atStartOfLine;
+    /**
+     * Writes a string to stdout.
+     * @param str The string to write.
+     */
+    write(str: string): void;
+    /**
+     * Writes a string to stdout, ensuring it starts on a new line.
+     * If the previous output did not end with a newline, one will be added.
+     * This prevents adding extra blank lines if a newline already exists.
+     * @param str The string to write.
+     */
+    writeOnNewLine(str: string): void;
+    /**
+     * Ensures that the output ends with a newline. If the last character
+     * written was not a newline, one will be added.
+     */
+    ensureTrailingNewline(): void;
+}

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

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A utility to manage writing text to stdout, ensuring that newlines
+ * are handled consistently and robustly across the application.
+ */
+import stripAnsi from 'strip-ansi';
+export class TextOutput {
+    atStartOfLine = true;
+    /**
+     * Writes a string to stdout.
+     * @param str The string to write.
+     */
+    write(str) {
+        if (str.length === 0) {
+            return;
+        }
+        process.stdout.write(str);
+        const strippedStr = stripAnsi(str);
+        if (strippedStr.length > 0) {
+            this.atStartOfLine = strippedStr.endsWith('\n');
+        }
+    }
+    /**
+     * Writes a string to stdout, ensuring it starts on a new line.
+     * If the previous output did not end with a newline, one will be added.
+     * This prevents adding extra blank lines if a newline already exists.
+     * @param str The string to write.
+     */
+    writeOnNewLine(str) {
+        if (!this.atStartOfLine) {
+            this.write('\n');
+        }
+        this.write(str);
+    }
+    /**
+     * Ensures that the output ends with a newline. If the last character
+     * written was not a newline, one will be added.
+     */
+    ensureTrailingNewline() {
+        if (!this.atStartOfLine) {
+            this.write('\n');
+        }
+    }
+}
+//# sourceMappingURL=textOutput.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textOutput.js","sourceRoot":"","sources":["../../../../src/ui/utils/textOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,MAAM,OAAO,UAAU;IACb,aAAa,GAAG,IAAI,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAW;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import { TextOutput } from './textOutput.js';
+describe('TextOutput', () => {
+    let stdoutSpy;
+    let textOutput;
+    beforeEach(() => {
+        stdoutSpy = vi
+            .spyOn(process.stdout, 'write')
+            .mockImplementation(() => true);
+        textOutput = new TextOutput();
+    });
+    afterEach(() => {
+        stdoutSpy.mockRestore();
+    });
+    const getWrittenOutput = () => stdoutSpy.mock.calls.map((c) => c[0]).join('');
+    it('write() should call process.stdout.write', () => {
+        textOutput.write('hello');
+        expect(stdoutSpy).toHaveBeenCalledWith('hello');
+    });
+    it('write() should not call process.stdout.write for empty strings', () => {
+        textOutput.write('');
+        expect(stdoutSpy).not.toHaveBeenCalled();
+    });
+    it('writeOnNewLine() should not add a newline if the last char was a newline', () => {
+        // Default state starts at the beginning of a line
+        textOutput.writeOnNewLine('hello');
+        expect(getWrittenOutput()).toBe('hello');
+    });
+    it('writeOnNewLine() should add a newline if the last char was not a newline', () => {
+        textOutput.write('previous');
+        textOutput.writeOnNewLine('hello');
+        expect(getWrittenOutput()).toBe('previous\nhello');
+    });
+    it('ensureTrailingNewline() should add a newline if one is missing', () => {
+        textOutput.write('hello');
+        textOutput.ensureTrailingNewline();
+        expect(getWrittenOutput()).toBe('hello\n');
+    });
+    it('ensureTrailingNewline() should not add a newline if one already exists', () => {
+        textOutput.write('hello\n');
+        textOutput.ensureTrailingNewline();
+        expect(getWrittenOutput()).toBe('hello\n');
+    });
+    it('should handle a sequence of calls correctly', () => {
+        textOutput.write('first');
+        textOutput.writeOnNewLine('second');
+        textOutput.write(' part');
+        textOutput.ensureTrailingNewline();
+        textOutput.ensureTrailingNewline(); // second call should do nothing
+        textOutput.write('third');
+        expect(getWrittenOutput()).toMatchSnapshot();
+    });
+    it('should correctly handle ANSI escape codes when determining line breaks', () => {
+        const blue = (s) => `\u001b[34m${s}\u001b[39m`;
+        const bold = (s) => `\u001b[1m${s}\u001b[22m`;
+        textOutput.write(blue('hello'));
+        textOutput.writeOnNewLine(bold('world'));
+        textOutput.write(blue('\n'));
+        textOutput.writeOnNewLine('next');
+        expect(getWrittenOutput()).toMatchSnapshot();
+    });
+    it('should handle empty strings with ANSI codes', () => {
+        textOutput.write('hello');
+        textOutput.write('\u001b[34m\u001b[39m'); // Empty blue string
+        textOutput.writeOnNewLine('world');
+        expect(getWrittenOutput()).toMatchSnapshot();
+    });
+    it('should handle ANSI codes that do not end with a newline', () => {
+        textOutput.write('hello\u001b[34m');
+        textOutput.writeOnNewLine('world');
+        expect(getWrittenOutput()).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=textOutput.test.js.map

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

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

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

@@ -3,9 +3,15 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { UpdateInfo } from 'update-notifier';
+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;

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

@@ -3,13 +3,16 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import updateNotifier from 'update-notifier';
+import latestVersion from 'latest-version';
 import semver from 'semver';
-import { getPackageJson } from '../../utils/package.js';
-import { debugLogger } from '@google/gemini-cli-core';
+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 update, determines which is the "best" one to offer.
+ * 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) {
@@ -17,12 +20,10 @@ function getBestAvailableUpdate(nightly, stable) {
         return stable || null;
     if (!stable)
         return nightly || null;
-    const nightlyVer = nightly.latest;
-    const stableVer = stable.latest;
-    if (semver.coerce(stableVer)?.version === semver.coerce(nightlyVer)?.version) {
+    if (semver.coerce(stable)?.version === semver.coerce(nightly)?.version) {
         return nightly;
     }
-    return semver.gt(stableVer, nightlyVer) ? stable : nightly;
+    return semver.gt(stable, nightly) ? stable : nightly;
 }
 export async function checkForUpdates(settings) {
     try {
@@ -33,42 +34,45 @@ export async function checkForUpdates(settings) {
         if (process.env['DEV'] === 'true') {
             return null;
         }
-        const packageJson = await getPackageJson();
+        const packageJson = await getPackageJson(__dirname);
         if (!packageJson || !packageJson.name || !packageJson.version) {
             return null;
         }
         const { name, version: currentVersion } = packageJson;
         const isNightly = currentVersion.includes('nightly');
-        const createNotifier = (distTag) => updateNotifier({
-            pkg: {
-                name,
-                version: currentVersion,
-            },
-            updateCheckInterval: 0,
-            shouldNotifyInNpmScript: true,
-            distTag,
-        });
         if (isNightly) {
-            const [nightlyUpdateInfo, latestUpdateInfo] = await Promise.all([
-                createNotifier('nightly').fetchInfo(),
-                createNotifier('latest').fetchInfo(),
+            const [nightlyUpdate, latestUpdate] = await Promise.all([
+                latestVersion(name, { version: 'nightly' }),
+                latestVersion(name),
             ]);
-            const bestUpdate = getBestAvailableUpdate(nightlyUpdateInfo, latestUpdateInfo);
-            if (bestUpdate && semver.gt(bestUpdate.latest, currentVersion)) {
-                const message = `A new version of cell-cli is available! ${currentVersion} → ${bestUpdate.latest}`;
+            const bestUpdate = getBestAvailableUpdate(nightlyUpdate, latestUpdate);
+            if (bestUpdate && semver.gt(bestUpdate, currentVersion)) {
+                const message = `A new version of cell-cli is available! ${currentVersion} → ${bestUpdate}`;
+                const type = semver.diff(bestUpdate, currentVersion) || undefined;
                 return {
                     message,
-                    update: { ...bestUpdate, current: currentVersion },
+                    update: {
+                        latest: bestUpdate,
+                        current: currentVersion,
+                        name,
+                        type,
+                    },
                 };
             }
         }
         else {
-            const updateInfo = await createNotifier('latest').fetchInfo();
-            if (updateInfo && semver.gt(updateInfo.latest, currentVersion)) {
-                const message = `Cell CLI update available! ${currentVersion} → ${updateInfo.latest}`;
+            const latestUpdate = await latestVersion(name);
+            if (latestUpdate && semver.gt(latestUpdate, currentVersion)) {
+                const message = `Cell CLI update available! ${currentVersion} → ${latestUpdate}`;
+                const type = semver.diff(latestUpdate, currentVersion) || undefined;
                 return {
                     message,
-                    update: { ...updateInfo, current: currentVersion },
+                    update: {
+                        latest: latestUpdate,
+                        current: currentVersion,
+                        name,
+                        type,
+                    },
                 };
             }
         }