@anthropic-field/core 0.1.0

package/dist/src/utils/editor.js

@@ -0,0 +1,219 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync, spawn, spawnSync } from 'node:child_process';
+import { debugLogger } from './debugLogger.js';
+import { coreEvents, CoreEvent } from './events.js';
+const GUI_EDITORS = [
+    'vscode',
+    'vscodium',
+    'windsurf',
+    'cursor',
+    'zed',
+    'antigravity',
+];
+const TERMINAL_EDITORS = ['vim', 'neovim', 'emacs', 'hx'];
+const EDITORS = [...GUI_EDITORS, ...TERMINAL_EDITORS];
+const GUI_EDITORS_SET = new Set(GUI_EDITORS);
+const TERMINAL_EDITORS_SET = new Set(TERMINAL_EDITORS);
+const EDITORS_SET = new Set(EDITORS);
+export const DEFAULT_GUI_EDITOR = 'vscode';
+export function isGuiEditor(editor) {
+    return GUI_EDITORS_SET.has(editor);
+}
+export function isTerminalEditor(editor) {
+    return TERMINAL_EDITORS_SET.has(editor);
+}
+export const EDITOR_DISPLAY_NAMES = {
+    vscode: 'VS Code',
+    vscodium: 'VSCodium',
+    windsurf: 'Windsurf',
+    cursor: 'Cursor',
+    vim: 'Vim',
+    neovim: 'Neovim',
+    zed: 'Zed',
+    emacs: 'Emacs',
+    antigravity: 'Antigravity',
+    hx: 'Helix',
+};
+export function getEditorDisplayName(editor) {
+    return EDITOR_DISPLAY_NAMES[editor] || editor;
+}
+function isValidEditorType(editor) {
+    return EDITORS_SET.has(editor);
+}
+/**
+ * Escapes a string for use in an Emacs Lisp string literal.
+ * Wraps in double quotes and escapes backslashes and double quotes.
+ */
+function escapeELispString(str) {
+    return `"${str.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+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'] },
+    emacs: { win32: ['emacs.exe'], default: ['emacs'] },
+    antigravity: {
+        win32: ['agy.cmd', 'antigravity.cmd', 'antigravity'],
+        default: ['agy', 'antigravity'],
+    },
+    hx: { win32: ['hx'], default: ['hx'] },
+};
+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 getEditorCommand(editor) {
+    const commandConfig = editorCommands[editor];
+    const commands = process.platform === 'win32' ? commandConfig.win32 : commandConfig.default;
+    return (commands.slice(0, -1).find((cmd) => commandExists(cmd)) ||
+        commands[commands.length - 1]);
+}
+export function allowEditorTypeInSandbox(editor) {
+    const notUsingSandbox = !process.env['SANDBOX'];
+    if (isGuiEditor(editor)) {
+        return notUsingSandbox;
+    }
+    // For terminal-based editors like vim and emacs, allow in sandbox.
+    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 command = getEditorCommand(editor);
+    switch (editor) {
+        case 'vscode':
+        case 'vscodium':
+        case 'windsurf':
+        case 'cursor':
+        case 'zed':
+        case 'antigravity':
+            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 BufWritePost * wqa',
+                    oldPath,
+                    newPath,
+                ],
+            };
+        case 'emacs':
+            return {
+                command: 'emacs',
+                args: [
+                    '--eval',
+                    `(ediff ${escapeELispString(oldPath)} ${escapeELispString(newPath)})`,
+                ],
+            };
+        case 'hx':
+            return {
+                command: 'hx',
+                args: ['--vsplit', '--', 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) {
+        debugLogger.error('No diff tool available. Install a supported editor.');
+        return;
+    }
+    if (isTerminalEditor(editor)) {
+        try {
+            const result = spawnSync(diffCommand.command, diffCommand.args, {
+                stdio: 'inherit',
+            });
+            if (result.error) {
+                throw result.error;
+            }
+            if (result.status !== 0) {
+                throw new Error(`${editor} exited with code ${result.status}`);
+            }
+        }
+        finally {
+            coreEvents.emit(CoreEvent.ExternalEditorClosed);
+        }
+        return;
+    }
+    return new Promise((resolve, reject) => {
+        const childProcess = spawn(diffCommand.command, diffCommand.args, {
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        childProcess.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${editor} exited with code ${code}`));
+            }
+        });
+        childProcess.on('error', (error) => {
+            reject(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/environmentContext.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Part, Content } from '@google/genai';
+import type { Config } from '../config/config.js';
+export declare const INITIAL_HISTORY_LENGTH = 1;
+/**
+ * Generates a string describing the current workspace directories and their structures.
+ * @param {Config} config - The runtime configuration and services.
+ * @returns {Promise<string>} A promise that resolves to the directory context string.
+ */
+export declare function getDirectoryContextString(config: Config): Promise<string>;
+/**
+ * Retrieves environment-related information to be included in the chat context.
+ * This includes the current working directory, date, operating system, and folder structure.
+ * Optionally, it can also include the full file context if enabled.
+ * @param {Config} config - The runtime configuration and services.
+ * @returns A promise that resolves to an array of `Part` objects containing environment information.
+ */
+export declare function getEnvironmentContext(config: Config): Promise<Part[]>;
+export declare function getInitialChatHistory(config: Config, extraHistory?: Content[]): Promise<Content[]>;

package/dist/src/utils/environmentContext.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getFolderStructure } from './getFolderStructure.js';
+export const INITIAL_HISTORY_LENGTH = 1;
+/**
+ * Generates a string describing the current workspace directories and their structures.
+ * @param {Config} config - The runtime configuration and services.
+ * @returns {Promise<string>} A promise that resolves to the directory context string.
+ */
+export async function getDirectoryContextString(config) {
+    const workspaceContext = config.getWorkspaceContext();
+    const workspaceDirectories = workspaceContext.getDirectories();
+    const folderStructures = await Promise.all(workspaceDirectories.map((dir) => getFolderStructure(dir, {
+        fileService: config.getFileService(),
+    })));
+    const folderStructure = folderStructures.join('\n');
+    let workingDirPreamble;
+    if (workspaceDirectories.length === 1) {
+        workingDirPreamble = `I'm currently working in the directory: ${workspaceDirectories[0]}`;
+    }
+    else {
+        const dirList = workspaceDirectories.map((dir) => `  - ${dir}`).join('\n');
+        workingDirPreamble = `I'm currently working in the following directories:\n${dirList}`;
+    }
+    return `${workingDirPreamble}
+Here is the folder structure of the current working directories:
+
+${folderStructure}`;
+}
+/**
+ * Retrieves environment-related information to be included in the chat context.
+ * This includes the current working directory, date, operating system, and folder structure.
+ * Optionally, it can also include the full file context if enabled.
+ * @param {Config} config - The runtime configuration and services.
+ * @returns A promise that resolves to an array of `Part` objects containing environment information.
+ */
+export async function getEnvironmentContext(config) {
+    const today = new Date().toLocaleDateString(undefined, {
+        weekday: 'long',
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+    const platform = process.platform;
+    const directoryContext = await getDirectoryContextString(config);
+    const tempDir = config.storage.getProjectTempDir();
+    const environmentMemory = config.getEnvironmentMemory();
+    const context = `
+This is the Gemini CLI. We are setting up the context for our chat.
+Today's date is ${today} (formatted according to the user's locale).
+My operating system is: ${platform}
+The project's temporary directory is: ${tempDir}
+${directoryContext}
+
+${environmentMemory}
+        `.trim();
+    const initialParts = [{ text: context }];
+    return initialParts;
+}
+export async function getInitialChatHistory(config, extraHistory) {
+    const envParts = await getEnvironmentContext(config);
+    const envContextString = envParts.map((part) => part.text || '').join('\n\n');
+    const allSetupText = `
+${envContextString}
+
+Reminder: Do not return an empty response when a tool call is required.
+
+My setup is complete. I will provide my first command in the next turn.
+    `.trim();
+    return [
+        {
+            role: 'user',
+            parts: [{ text: allSetupText }],
+        },
+        ...(extraHistory ?? []),
+    ];
+}
+//# sourceMappingURL=environmentContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentContext.js","sourceRoot":"","sources":["../../../src/utils/environmentContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAc;IAEd,MAAM,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACtD,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,cAAc,EAAE,CAAC;IAE/D,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CACxC,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/B,kBAAkB,CAAC,GAAG,EAAE;QACtB,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE;KACrC,CAAC,CACH,CACF,CAAC;IAEF,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,kBAA0B,CAAC;IAC/B,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,kBAAkB,GAAG,2CAA2C,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,kBAAkB,GAAG,wDAAwD,OAAO,EAAE,CAAC;IACzF,CAAC;IAED,OAAO,GAAG,kBAAkB;;;EAG5B,eAAe,EAAE,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc;IACxD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE;QACrD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,gBAAgB,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IACnD,MAAM,iBAAiB,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;IAExD,MAAM,OAAO,GAAG;;kBAEA,KAAK;0BACG,QAAQ;wCACM,OAAO;EAC7C,gBAAgB;;EAEhB,iBAAiB;SACV,CAAC,IAAI,EAAE,CAAC;IAEf,MAAM,YAAY,GAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEjD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,YAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE9E,MAAM,YAAY,GAAG;EACrB,gBAAgB;;;;;KAKb,CAAC,IAAI,EAAE,CAAC;IAEX,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;SAChC;QACD,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;KACxB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { UserTierId } from '../code_assist/types.js';
+import { AuthType } from '../core/contentGenerator.js';
+export declare function parseAndFormatApiError(error: unknown, authType?: AuthType, userTier?: UserTierId, currentModel?: string, fallbackModel?: string): string;

package/dist/src/utils/errorParsing.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isApiError, isStructuredError } from './quotaErrorDetection.js';
+import { DEFAULT_GEMINI_FLASH_MODEL } from '../config/models.js';
+import { AuthType } from '../core/contentGenerator.js';
+const RATE_LIMIT_ERROR_MESSAGE_USE_GEMINI = '\nPlease wait and try again later. To increase your limits, request a quota increase through AI Studio, or switch to another /auth method';
+const RATE_LIMIT_ERROR_MESSAGE_VERTEX = '\nPlease wait and try again later. To increase your limits, request a quota increase through Vertex, or switch to another /auth method';
+const getRateLimitErrorMessageDefault = (fallbackModel = DEFAULT_GEMINI_FLASH_MODEL) => `\nPossible quota limitations in place or slow response times detected. Switching to the ${fallbackModel} model for the rest of this session.`;
+function getRateLimitMessage(authType, fallbackModel) {
+    switch (authType) {
+        case AuthType.USE_GEMINI:
+            return RATE_LIMIT_ERROR_MESSAGE_USE_GEMINI;
+        case AuthType.USE_VERTEX_AI:
+            return RATE_LIMIT_ERROR_MESSAGE_VERTEX;
+        default:
+            return getRateLimitErrorMessageDefault(fallbackModel);
+    }
+}
+export function parseAndFormatApiError(error, authType, userTier, currentModel, fallbackModel) {
+    if (isStructuredError(error)) {
+        let text = `[API Error: ${error.message}]`;
+        if (error.status === 429) {
+            text += getRateLimitMessage(authType, fallbackModel);
+        }
+        return text;
+    }
+    // The error message might be a string containing a JSON object.
+    if (typeof error === 'string') {
+        const jsonStart = error.indexOf('{');
+        if (jsonStart === -1) {
+            return `[API Error: ${error}]`; // Not a JSON error, return as is.
+        }
+        const jsonString = error.substring(jsonStart);
+        try {
+            const parsedError = JSON.parse(jsonString);
+            if (isApiError(parsedError)) {
+                let finalMessage = parsedError.error.message;
+                try {
+                    // See if the message is a stringified JSON with another error
+                    const nestedError = JSON.parse(finalMessage);
+                    if (isApiError(nestedError)) {
+                        finalMessage = nestedError.error.message;
+                    }
+                }
+                catch (_e) {
+                    // It's not a nested JSON error, so we just use the message as is.
+                }
+                let text = `[API Error: ${finalMessage} (Status: ${parsedError.error.status})]`;
+                if (parsedError.error.code === 429) {
+                    text += getRateLimitMessage(authType, fallbackModel);
+                }
+                return text;
+            }
+        }
+        catch (_e) {
+            // Not a valid JSON, fall through and return the original message.
+        }
+        return `[API Error: ${error}]`;
+    }
+    return '[API Error: An unknown error occurred.]';
+}
+//# sourceMappingURL=errorParsing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorParsing.js","sourceRoot":"","sources":["../../../src/utils/errorParsing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,MAAM,mCAAmC,GACvC,2IAA2I,CAAC;AAC9I,MAAM,+BAA+B,GACnC,wIAAwI,CAAC;AAC3I,MAAM,+BAA+B,GAAG,CACtC,gBAAwB,0BAA0B,EAClD,EAAE,CACF,2FAA2F,aAAa,sCAAsC,CAAC;AAEjJ,SAAS,mBAAmB,CAC1B,QAAmB,EACnB,aAAsB;IAEtB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,UAAU;YACtB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,QAAQ,CAAC,aAAa;YACzB,OAAO,+BAA+B,CAAC;QACzC;YACE,OAAO,+BAA+B,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,QAAmB,EACnB,QAAqB,EACrB,YAAqB,EACrB,aAAsB;IAEtB,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,IAAI,GAAG,eAAe,KAAK,CAAC,OAAO,GAAG,CAAC;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACzB,IAAI,IAAI,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gEAAgE;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,OAAO,eAAe,KAAK,GAAG,CAAC,CAAC,kCAAkC;QACpE,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAY,CAAC;YACtD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5B,IAAI,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC7C,IAAI,CAAC;oBACH,8DAA8D;oBAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAY,CAAC;oBACxD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC5B,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;oBAC3C,CAAC;gBACH,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,kEAAkE;gBACpE,CAAC;gBACD,IAAI,IAAI,GAAG,eAAe,YAAY,aAAa,WAAW,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;gBAChF,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;oBACnC,IAAI,IAAI,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;gBACvD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,kEAAkE;QACpE,CAAC;QACD,OAAO,eAAe,KAAK,GAAG,CAAC;IACjC,CAAC;IAED,OAAO,yCAAyC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content } from '@google/genai';
+/**
+ * Generates an error report, writes it to a temporary file, and logs information to user
+ * @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, reportingDir?: string): Promise<void>;

package/dist/src/utils/errorReporting.js

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { debugLogger } from './debugLogger.js';
+/**
+ * Generates an error report, writes it to a temporary file, and logs information to user
+ * @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 async function reportError(error, baseMessage, context, type = 'general', reportingDir = os.tmpdir()) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const reportFileName = `gemini-client-error-${type}-${timestamp}.json`;
+    const reportPath = path.join(reportingDir, reportFileName);
+    let errorToReport;
+    if (error instanceof Error) {
+        errorToReport = { message: error.message, stack: error.stack };
+    }
+    else if (typeof error === 'object' &&
+        error !== null &&
+        'message' in error) {
+        errorToReport = {
+            message: String(error.message),
+        };
+    }
+    else {
+        errorToReport = { message: String(error) };
+    }
+    const reportContent = { error: errorToReport };
+    if (context) {
+        reportContent.context = context;
+    }
+    let stringifiedReportContent;
+    try {
+        stringifiedReportContent = JSON.stringify(reportContent, null, 2);
+    }
+    catch (stringifyError) {
+        // This can happen if context contains something like BigInt
+        debugLogger.error(`${baseMessage} Could not stringify report content (likely due to context):`, stringifyError);
+        debugLogger.error('Original error that triggered report generation:', error);
+        if (context) {
+            debugLogger.error('Original context could not be stringified or included in report.');
+        }
+        // Fallback: try to report only the error if context was the issue
+        try {
+            const minimalReportContent = { error: errorToReport };
+            stringifiedReportContent = JSON.stringify(minimalReportContent, null, 2);
+            // Still try to write the minimal report
+            await fs.writeFile(reportPath, stringifiedReportContent);
+            debugLogger.error(`${baseMessage} Partial report (excluding context) available at: ${reportPath}`, error);
+        }
+        catch (minimalWriteError) {
+            debugLogger.error(`${baseMessage} Failed to write even a minimal error report:`, minimalWriteError);
+        }
+        return;
+    }
+    try {
+        await fs.writeFile(reportPath, stringifiedReportContent);
+        debugLogger.error(`${baseMessage} Full report available at: ${reportPath}`, error);
+    }
+    catch (writeError) {
+        debugLogger.error(`${baseMessage} Additionally, failed to write detailed error report:`, writeError);
+        // Log the original error as a fallback if report writing fails
+        debugLogger.error('Original error that triggered report generation:', error);
+        if (context) {
+            // Context was stringifiable, but writing the file failed.
+            // We already have stringifiedReportContent, but it might be too large for console.
+            // So, we try to log the original context object, and if that fails, its stringified version (truncated).
+            try {
+                debugLogger.error('Original context:', context);
+            }
+            catch {
+                try {
+                    debugLogger.error('Original context (stringified, truncated):', JSON.stringify(context).substring(0, 1000));
+                }
+                catch {
+                    debugLogger.error('Original context could not be logged or stringified.');
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=errorReporting.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;
+export declare function getErrorMessage(error: unknown): string;
+export declare class FatalError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}
+export declare class FatalAuthenticationError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalInputError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalSandboxError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalConfigError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalTurnLimitedError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalToolExecutionError extends FatalError {
+    constructor(message: string);
+}
+export declare class FatalCancellationError extends FatalError {
+    constructor(message: string);
+}
+export declare class CanceledError extends Error {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends Error {
+}
+export declare class UnauthorizedError extends Error {
+}
+export declare class BadRequestError extends Error {
+}
+export declare class ChangeAuthRequestedError extends Error {
+    constructor();
+}
+export declare function toFriendlyError(error: unknown): unknown;
+/**
+ * Checks if an error is a 401 authentication error.
+ * Uses structured error properties from MCP SDK errors.
+ *
+ * @param error The error to check
+ * @returns true if this is a 401/authentication error
+ */
+export declare function isAuthenticationError(error: unknown): boolean;