@machina.ai/cell-cli-core 1.0.13-rc3

package/dist/src/utils/editor.js

@@ -0,0 +1,169 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync, spawn } from 'child_process';
+function isValidEditorType(editor) {
+    return [
+        'vscode',
+        'vscodium',
+        'windsurf',
+        'cursor',
+        'vim',
+        'neovim',
+        'zed',
+    ].includes(editor);
+}
+function commandExists(cmd) {
+    try {
+        execSync(process.platform === 'win32' ? `where.exe ${cmd}` : `command -v ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Editor command configurations for different platforms.
+ * Each editor can have multiple possible command names, listed in order of preference.
+ */
+const editorCommands = {
+    vscode: { win32: ['code.cmd'], default: ['code'] },
+    vscodium: { win32: ['codium.cmd'], default: ['codium'] },
+    windsurf: { win32: ['windsurf'], default: ['windsurf'] },
+    cursor: { win32: ['cursor'], default: ['cursor'] },
+    vim: { win32: ['vim'], default: ['vim'] },
+    neovim: { win32: ['nvim'], default: ['nvim'] },
+    zed: { win32: ['zed'], default: ['zed', 'zeditor'] },
+};
+export function checkHasEditorType(editor) {
+    const commandConfig = editorCommands[editor];
+    const commands = process.platform === 'win32' ? commandConfig.win32 : commandConfig.default;
+    return commands.some((cmd) => commandExists(cmd));
+}
+export function allowEditorTypeInSandbox(editor) {
+    const notUsingSandbox = !process.env.SANDBOX;
+    if (['vscode', 'vscodium', 'windsurf', 'cursor', 'zed'].includes(editor)) {
+        return notUsingSandbox;
+    }
+    return true;
+}
+/**
+ * Check if the editor is valid and can be used.
+ * Returns false if preferred editor is not set / invalid / not available / not allowed in sandbox.
+ */
+export function isEditorAvailable(editor) {
+    if (editor && isValidEditorType(editor)) {
+        return checkHasEditorType(editor) && allowEditorTypeInSandbox(editor);
+    }
+    return false;
+}
+/**
+ * Get the diff command for a specific editor.
+ */
+export function getDiffCommand(oldPath, newPath, editor) {
+    if (!isValidEditorType(editor)) {
+        return null;
+    }
+    const commandConfig = editorCommands[editor];
+    const commands = process.platform === 'win32' ? commandConfig.win32 : commandConfig.default;
+    const command = commands.slice(0, -1).find((cmd) => commandExists(cmd)) ||
+        commands[commands.length - 1];
+    switch (editor) {
+        case 'vscode':
+        case 'vscodium':
+        case 'windsurf':
+        case 'cursor':
+        case 'zed':
+            return { command, args: ['--wait', '--diff', oldPath, newPath] };
+        case 'vim':
+        case 'neovim':
+            return {
+                command,
+                args: [
+                    '-d',
+                    // skip viminfo file to avoid E138 errors
+                    '-i',
+                    'NONE',
+                    // make the left window read-only and the right window editable
+                    '-c',
+                    'wincmd h | set readonly | wincmd l',
+                    // set up colors for diffs
+                    '-c',
+                    'highlight DiffAdd cterm=bold ctermbg=22 guibg=#005f00 | highlight DiffChange cterm=bold ctermbg=24 guibg=#005f87 | highlight DiffText ctermbg=21 guibg=#0000af | highlight DiffDelete ctermbg=52 guibg=#5f0000',
+                    // Show helpful messages
+                    '-c',
+                    'set showtabline=2 | set tabline=[Instructions]\\ :wqa(save\\ &\\ quit)\\ \\|\\ i/esc(toggle\\ edit\\ mode)',
+                    '-c',
+                    'wincmd h | setlocal statusline=OLD\\ FILE',
+                    '-c',
+                    'wincmd l | setlocal statusline=%#StatusBold#NEW\\ FILE\\ :wqa(save\\ &\\ quit)\\ \\|\\ i/esc(toggle\\ edit\\ mode)',
+                    // Auto close all windows when one is closed
+                    '-c',
+                    'autocmd WinClosed * wqa',
+                    oldPath,
+                    newPath,
+                ],
+            };
+        default:
+            return null;
+    }
+}
+/**
+ * Opens a diff tool to compare two files.
+ * Terminal-based editors by default blocks parent process until the editor exits.
+ * GUI-based editors require args such as "--wait" to block parent process.
+ */
+export async function openDiff(oldPath, newPath, editor) {
+    const diffCommand = getDiffCommand(oldPath, newPath, editor);
+    if (!diffCommand) {
+        console.error('No diff tool available. Install a supported editor.');
+        return;
+    }
+    try {
+        switch (editor) {
+            case 'vscode':
+            case 'vscodium':
+            case 'windsurf':
+            case 'cursor':
+            case 'zed':
+                // Use spawn for GUI-based editors to avoid blocking the entire process
+                return new Promise((resolve, reject) => {
+                    const childProcess = spawn(diffCommand.command, diffCommand.args, {
+                        stdio: 'inherit',
+                        shell: true,
+                    });
+                    childProcess.on('close', (code) => {
+                        if (code === 0) {
+                            resolve();
+                        }
+                        else {
+                            reject(new Error(`${editor} exited with code ${code}`));
+                        }
+                    });
+                    childProcess.on('error', (error) => {
+                        reject(error);
+                    });
+                });
+            case 'vim':
+            case 'neovim': {
+                // Use execSync for terminal-based editors
+                const command = process.platform === 'win32'
+                    ? `${diffCommand.command} ${diffCommand.args.join(' ')}`
+                    : `${diffCommand.command} ${diffCommand.args.map((arg) => `"${arg}"`).join(' ')}`;
+                execSync(command, {
+                    stdio: 'inherit',
+                    encoding: 'utf8',
+                });
+                break;
+            }
+            default:
+                throw new Error(`Unsupported editor: ${editor}`);
+        }
+    }
+    catch (error) {
+        console.error(error);
+    }
+}
+//# sourceMappingURL=editor.js.map

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

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

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

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

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

@@ -0,0 +1,393 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach, } from 'vitest';
+import { checkHasEditorType, getDiffCommand, openDiff, allowEditorTypeInSandbox, isEditorAvailable, } from './editor.js';
+import { execSync, spawn } from 'child_process';
+vi.mock('child_process', () => ({
+    execSync: vi.fn(),
+    spawn: vi.fn(),
+}));
+const originalPlatform = process.platform;
+describe('editor utils', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        delete process.env.SANDBOX;
+        Object.defineProperty(process, 'platform', {
+            value: originalPlatform,
+            writable: true,
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env.SANDBOX;
+        Object.defineProperty(process, 'platform', {
+            value: originalPlatform,
+            writable: true,
+        });
+    });
+    describe('checkHasEditorType', () => {
+        const testCases = [
+            { editor: 'vscode', commands: ['code'], win32Commands: ['code.cmd'] },
+            {
+                editor: 'vscodium',
+                commands: ['codium'],
+                win32Commands: ['codium.cmd'],
+            },
+            {
+                editor: 'windsurf',
+                commands: ['windsurf'],
+                win32Commands: ['windsurf'],
+            },
+            { editor: 'cursor', commands: ['cursor'], win32Commands: ['cursor'] },
+            { editor: 'vim', commands: ['vim'], win32Commands: ['vim'] },
+            { editor: 'neovim', commands: ['nvim'], win32Commands: ['nvim'] },
+            { editor: 'zed', commands: ['zed', 'zeditor'], win32Commands: ['zed'] },
+        ];
+        for (const { editor, commands, win32Commands } of testCases) {
+            describe(`${editor}`, () => {
+                // Non-windows tests
+                it(`should return true if first command "${commands[0]}" exists on non-windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'linux' });
+                    execSync.mockReturnValue(Buffer.from(`/usr/bin/${commands[0]}`));
+                    expect(checkHasEditorType(editor)).toBe(true);
+                    expect(execSync).toHaveBeenCalledWith(`command -v ${commands[0]}`, {
+                        stdio: 'ignore',
+                    });
+                });
+                if (commands.length > 1) {
+                    it(`should return true if first command doesn't exist but second command "${commands[1]}" exists on non-windows`, () => {
+                        Object.defineProperty(process, 'platform', { value: 'linux' });
+                        execSync
+                            .mockImplementationOnce(() => {
+                            throw new Error(); // first command not found
+                        })
+                            .mockReturnValueOnce(Buffer.from(`/usr/bin/${commands[1]}`)); // second command found
+                        expect(checkHasEditorType(editor)).toBe(true);
+                        expect(execSync).toHaveBeenCalledTimes(2);
+                    });
+                }
+                it(`should return false if none of the commands exist on non-windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'linux' });
+                    execSync.mockImplementation(() => {
+                        throw new Error(); // all commands not found
+                    });
+                    expect(checkHasEditorType(editor)).toBe(false);
+                    expect(execSync).toHaveBeenCalledTimes(commands.length);
+                });
+                // Windows tests
+                it(`should return true if first command "${win32Commands[0]}" exists on windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'win32' });
+                    execSync.mockReturnValue(Buffer.from(`C:\\Program Files\\...\\${win32Commands[0]}`));
+                    expect(checkHasEditorType(editor)).toBe(true);
+                    expect(execSync).toHaveBeenCalledWith(`where.exe ${win32Commands[0]}`, {
+                        stdio: 'ignore',
+                    });
+                });
+                if (win32Commands.length > 1) {
+                    it(`should return true if first command doesn't exist but second command "${win32Commands[1]}" exists on windows`, () => {
+                        Object.defineProperty(process, 'platform', { value: 'win32' });
+                        execSync
+                            .mockImplementationOnce(() => {
+                            throw new Error(); // first command not found
+                        })
+                            .mockReturnValueOnce(Buffer.from(`C:\\Program Files\\...\\${win32Commands[1]}`)); // second command found
+                        expect(checkHasEditorType(editor)).toBe(true);
+                        expect(execSync).toHaveBeenCalledTimes(2);
+                    });
+                }
+                it(`should return false if none of the commands exist on windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'win32' });
+                    execSync.mockImplementation(() => {
+                        throw new Error(); // all commands not found
+                    });
+                    expect(checkHasEditorType(editor)).toBe(false);
+                    expect(execSync).toHaveBeenCalledTimes(win32Commands.length);
+                });
+            });
+        }
+    });
+    describe('getDiffCommand', () => {
+        const guiEditors = [
+            { editor: 'vscode', commands: ['code'], win32Commands: ['code.cmd'] },
+            {
+                editor: 'vscodium',
+                commands: ['codium'],
+                win32Commands: ['codium.cmd'],
+            },
+            {
+                editor: 'windsurf',
+                commands: ['windsurf'],
+                win32Commands: ['windsurf'],
+            },
+            { editor: 'cursor', commands: ['cursor'], win32Commands: ['cursor'] },
+            { editor: 'zed', commands: ['zed', 'zeditor'], win32Commands: ['zed'] },
+        ];
+        for (const { editor, commands, win32Commands } of guiEditors) {
+            // Non-windows tests
+            it(`should use first command "${commands[0]}" when it exists on non-windows`, () => {
+                Object.defineProperty(process, 'platform', { value: 'linux' });
+                execSync.mockReturnValue(Buffer.from(`/usr/bin/${commands[0]}`));
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(diffCommand).toEqual({
+                    command: commands[0],
+                    args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                });
+            });
+            if (commands.length > 1) {
+                it(`should use second command "${commands[1]}" when first doesn't exist on non-windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'linux' });
+                    execSync
+                        .mockImplementationOnce(() => {
+                        throw new Error(); // first command not found
+                    })
+                        .mockReturnValueOnce(Buffer.from(`/usr/bin/${commands[1]}`)); // second command found
+                    const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                    expect(diffCommand).toEqual({
+                        command: commands[1],
+                        args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                    });
+                });
+            }
+            it(`should fall back to last command "${commands[commands.length - 1]}" when none exist on non-windows`, () => {
+                Object.defineProperty(process, 'platform', { value: 'linux' });
+                execSync.mockImplementation(() => {
+                    throw new Error(); // all commands not found
+                });
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(diffCommand).toEqual({
+                    command: commands[commands.length - 1],
+                    args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                });
+            });
+            // Windows tests
+            it(`should use first command "${win32Commands[0]}" when it exists on windows`, () => {
+                Object.defineProperty(process, 'platform', { value: 'win32' });
+                execSync.mockReturnValue(Buffer.from(`C:\\Program Files\\...\\${win32Commands[0]}`));
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(diffCommand).toEqual({
+                    command: win32Commands[0],
+                    args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                });
+            });
+            if (win32Commands.length > 1) {
+                it(`should use second command "${win32Commands[1]}" when first doesn't exist on windows`, () => {
+                    Object.defineProperty(process, 'platform', { value: 'win32' });
+                    execSync
+                        .mockImplementationOnce(() => {
+                        throw new Error(); // first command not found
+                    })
+                        .mockReturnValueOnce(Buffer.from(`C:\\Program Files\\...\\${win32Commands[1]}`)); // second command found
+                    const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                    expect(diffCommand).toEqual({
+                        command: win32Commands[1],
+                        args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                    });
+                });
+            }
+            it(`should fall back to last command "${win32Commands[win32Commands.length - 1]}" when none exist on windows`, () => {
+                Object.defineProperty(process, 'platform', { value: 'win32' });
+                execSync.mockImplementation(() => {
+                    throw new Error(); // all commands not found
+                });
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(diffCommand).toEqual({
+                    command: win32Commands[win32Commands.length - 1],
+                    args: ['--wait', '--diff', 'old.txt', 'new.txt'],
+                });
+            });
+        }
+        const terminalEditors = [
+            { editor: 'vim', command: 'vim' },
+            { editor: 'neovim', command: 'nvim' },
+        ];
+        for (const { editor, command } of terminalEditors) {
+            it(`should return the correct command for ${editor}`, () => {
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(diffCommand).toEqual({
+                    command,
+                    args: [
+                        '-d',
+                        '-i',
+                        'NONE',
+                        '-c',
+                        'wincmd h | set readonly | wincmd l',
+                        '-c',
+                        'highlight DiffAdd cterm=bold ctermbg=22 guibg=#005f00 | highlight DiffChange cterm=bold ctermbg=24 guibg=#005f87 | highlight DiffText ctermbg=21 guibg=#0000af | highlight DiffDelete ctermbg=52 guibg=#5f0000',
+                        '-c',
+                        'set showtabline=2 | set tabline=[Instructions]\\ :wqa(save\\ &\\ quit)\\ \\|\\ i/esc(toggle\\ edit\\ mode)',
+                        '-c',
+                        'wincmd h | setlocal statusline=OLD\\ FILE',
+                        '-c',
+                        'wincmd l | setlocal statusline=%#StatusBold#NEW\\ FILE\\ :wqa(save\\ &\\ quit)\\ \\|\\ i/esc(toggle\\ edit\\ mode)',
+                        '-c',
+                        'autocmd WinClosed * wqa',
+                        'old.txt',
+                        'new.txt',
+                    ],
+                });
+            });
+        }
+        it('should return null for an unsupported editor', () => {
+            // @ts-expect-error Testing unsupported editor
+            const command = getDiffCommand('old.txt', 'new.txt', 'foobar');
+            expect(command).toBeNull();
+        });
+    });
+    describe('openDiff', () => {
+        const spawnEditors = [
+            'vscode',
+            'vscodium',
+            'windsurf',
+            'cursor',
+            'zed',
+        ];
+        for (const editor of spawnEditors) {
+            it(`should call spawn for ${editor}`, async () => {
+                const mockSpawn = {
+                    on: vi.fn((event, cb) => {
+                        if (event === 'close') {
+                            cb(0);
+                        }
+                    }),
+                };
+                spawn.mockReturnValue(mockSpawn);
+                await openDiff('old.txt', 'new.txt', editor);
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                expect(spawn).toHaveBeenCalledWith(diffCommand.command, diffCommand.args, {
+                    stdio: 'inherit',
+                    shell: true,
+                });
+                expect(mockSpawn.on).toHaveBeenCalledWith('close', expect.any(Function));
+                expect(mockSpawn.on).toHaveBeenCalledWith('error', expect.any(Function));
+            });
+            it(`should reject if spawn for ${editor} fails`, async () => {
+                const mockError = new Error('spawn error');
+                const mockSpawn = {
+                    on: vi.fn((event, cb) => {
+                        if (event === 'error') {
+                            cb(mockError);
+                        }
+                    }),
+                };
+                spawn.mockReturnValue(mockSpawn);
+                await expect(openDiff('old.txt', 'new.txt', editor)).rejects.toThrow('spawn error');
+            });
+            it(`should reject if ${editor} exits with non-zero code`, async () => {
+                const mockSpawn = {
+                    on: vi.fn((event, cb) => {
+                        if (event === 'close') {
+                            cb(1);
+                        }
+                    }),
+                };
+                spawn.mockReturnValue(mockSpawn);
+                await expect(openDiff('old.txt', 'new.txt', editor)).rejects.toThrow(`${editor} exited with code 1`);
+            });
+        }
+        const execSyncEditors = ['vim', 'neovim'];
+        for (const editor of execSyncEditors) {
+            it(`should call execSync for ${editor} on non-windows`, async () => {
+                Object.defineProperty(process, 'platform', { value: 'linux' });
+                await openDiff('old.txt', 'new.txt', editor);
+                expect(execSync).toHaveBeenCalledTimes(1);
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                const expectedCommand = `${diffCommand.command} ${diffCommand.args.map((arg) => `"${arg}"`).join(' ')}`;
+                expect(execSync).toHaveBeenCalledWith(expectedCommand, {
+                    stdio: 'inherit',
+                    encoding: 'utf8',
+                });
+            });
+            it(`should call execSync for ${editor} on windows`, async () => {
+                Object.defineProperty(process, 'platform', { value: 'win32' });
+                await openDiff('old.txt', 'new.txt', editor);
+                expect(execSync).toHaveBeenCalledTimes(1);
+                const diffCommand = getDiffCommand('old.txt', 'new.txt', editor);
+                const expectedCommand = `${diffCommand.command} ${diffCommand.args.join(' ')}`;
+                expect(execSync).toHaveBeenCalledWith(expectedCommand, {
+                    stdio: 'inherit',
+                    encoding: 'utf8',
+                });
+            });
+        }
+        it('should log an error if diff command is not available', async () => {
+            const consoleErrorSpy = vi
+                .spyOn(console, 'error')
+                .mockImplementation(() => { });
+            // @ts-expect-error Testing unsupported editor
+            await openDiff('old.txt', 'new.txt', 'foobar');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('No diff tool available. Install a supported editor.');
+        });
+    });
+    describe('allowEditorTypeInSandbox', () => {
+        it('should allow vim in sandbox mode', () => {
+            process.env.SANDBOX = 'sandbox';
+            expect(allowEditorTypeInSandbox('vim')).toBe(true);
+        });
+        it('should allow vim when not in sandbox mode', () => {
+            expect(allowEditorTypeInSandbox('vim')).toBe(true);
+        });
+        it('should allow neovim in sandbox mode', () => {
+            process.env.SANDBOX = 'sandbox';
+            expect(allowEditorTypeInSandbox('neovim')).toBe(true);
+        });
+        it('should allow neovim when not in sandbox mode', () => {
+            expect(allowEditorTypeInSandbox('neovim')).toBe(true);
+        });
+        const guiEditors = [
+            'vscode',
+            'vscodium',
+            'windsurf',
+            'cursor',
+            'zed',
+        ];
+        for (const editor of guiEditors) {
+            it(`should not allow ${editor} in sandbox mode`, () => {
+                process.env.SANDBOX = 'sandbox';
+                expect(allowEditorTypeInSandbox(editor)).toBe(false);
+            });
+            it(`should allow ${editor} when not in sandbox mode`, () => {
+                expect(allowEditorTypeInSandbox(editor)).toBe(true);
+            });
+        }
+    });
+    describe('isEditorAvailable', () => {
+        it('should return false for undefined editor', () => {
+            expect(isEditorAvailable(undefined)).toBe(false);
+        });
+        it('should return false for empty string editor', () => {
+            expect(isEditorAvailable('')).toBe(false);
+        });
+        it('should return false for invalid editor type', () => {
+            expect(isEditorAvailable('invalid-editor')).toBe(false);
+        });
+        it('should return true for vscode when installed and not in sandbox mode', () => {
+            execSync.mockReturnValue(Buffer.from('/usr/bin/code'));
+            expect(isEditorAvailable('vscode')).toBe(true);
+        });
+        it('should return false for vscode when not installed and not in sandbox mode', () => {
+            execSync.mockImplementation(() => {
+                throw new Error();
+            });
+            expect(isEditorAvailable('vscode')).toBe(false);
+        });
+        it('should return false for vscode when installed and in sandbox mode', () => {
+            execSync.mockReturnValue(Buffer.from('/usr/bin/code'));
+            process.env.SANDBOX = 'sandbox';
+            expect(isEditorAvailable('vscode')).toBe(false);
+        });
+        it('should return true for vim when installed and in sandbox mode', () => {
+            execSync.mockReturnValue(Buffer.from('/usr/bin/vim'));
+            process.env.SANDBOX = 'sandbox';
+            expect(isEditorAvailable('vim')).toBe(true);
+        });
+        it('should return true for neovim when installed and in sandbox mode', () => {
+            execSync.mockReturnValue(Buffer.from('/usr/bin/nvim'));
+            process.env.SANDBOX = 'sandbox';
+            expect(isEditorAvailable('neovim')).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=editor.test.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Content } from '@google/genai';
+/**
+ * Generates an error report, writes it to a temporary file, and logs information to console.error.
+ * @param error The error object.
+ * @param context The relevant context (e.g., chat history, request contents).
+ * @param type A string to identify the type of error (e.g., 'startChat', 'generateJson-api').
+ * @param baseMessage The initial message to log to console.error before the report path.
+ */
+export declare function reportError(error: Error | unknown, baseMessage: string, context?: Content[] | Record<string, unknown> | unknown[], type?: string): Promise<void>;