@anh3d0nic/qwen-code-termux-ice 21.0.1 → 21.2.0

package/core-dist/src/utils/environmentContext.test.js

@@ -0,0 +1,151 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { getEnvironmentContext, getDirectoryContextString, getInitialChatHistory, } from './environmentContext.js';
+import { getFolderStructure } from './getFolderStructure.js';
+vi.mock('../config/config.js');
+vi.mock('./getFolderStructure.js', () => ({
+    getFolderStructure: vi.fn(),
+}));
+vi.mock('../tools/read-many-files.js');
+describe('getDirectoryContextString', () => {
+    let mockConfig;
+    beforeEach(() => {
+        mockConfig = {
+            getWorkspaceContext: vi.fn().mockReturnValue({
+                getDirectories: vi.fn().mockReturnValue(['/test/dir']),
+            }),
+            getFileService: vi.fn(),
+        };
+        vi.mocked(getFolderStructure).mockResolvedValue('Mock Folder Structure');
+    });
+    afterEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should return context string for a single directory', async () => {
+        const contextString = await getDirectoryContextString(mockConfig);
+        expect(contextString).toContain("I'm currently working in the directory: /test/dir");
+        expect(contextString).toContain('Here is the folder structure of the current working directories:\n\nMock Folder Structure');
+    });
+    it('should return context string for multiple directories', async () => {
+        vi.mocked(mockConfig.getWorkspaceContext)().getDirectories.mockReturnValue(['/test/dir1', '/test/dir2']);
+        vi.mocked(getFolderStructure)
+            .mockResolvedValueOnce('Structure 1')
+            .mockResolvedValueOnce('Structure 2');
+        const contextString = await getDirectoryContextString(mockConfig);
+        expect(contextString).toContain("I'm currently working in the following directories:\n  - /test/dir1\n  - /test/dir2");
+        expect(contextString).toContain('Here is the folder structure of the current working directories:\n\nStructure 1\nStructure 2');
+    });
+});
+describe('getEnvironmentContext', () => {
+    let mockConfig;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2025-08-05T12:00:00Z'));
+        // Mock the locale to ensure consistent English date formatting
+        vi.stubGlobal('Intl', {
+            ...global.Intl,
+            DateTimeFormat: vi.fn().mockImplementation(() => ({
+                format: vi.fn().mockReturnValue('Tuesday, August 5, 2025'),
+            })),
+        });
+        mockConfig = {
+            getWorkspaceContext: vi.fn().mockReturnValue({
+                getDirectories: vi.fn().mockReturnValue(['/test/dir']),
+            }),
+            getFileService: vi.fn(),
+        };
+        vi.mocked(getFolderStructure).mockResolvedValue('Mock Folder Structure');
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it('should return basic environment context for a single directory', async () => {
+        const parts = await getEnvironmentContext(mockConfig);
+        expect(parts.length).toBe(1);
+        const context = parts[0].text;
+        expect(context).toContain("Today's date is");
+        expect(context).toContain("(formatted according to the user's locale)");
+        expect(context).toContain(`My operating system is: ${process.platform}`);
+        expect(context).toContain("I'm currently working in the directory: /test/dir");
+        expect(context).toContain('Here is the folder structure of the current working directories:\n\nMock Folder Structure');
+        expect(getFolderStructure).toHaveBeenCalledWith('/test/dir', {
+            fileService: undefined,
+        });
+    });
+    it('should return basic environment context for multiple directories', async () => {
+        vi.mocked(mockConfig.getWorkspaceContext)().getDirectories.mockReturnValue(['/test/dir1', '/test/dir2']);
+        vi.mocked(getFolderStructure)
+            .mockResolvedValueOnce('Structure 1')
+            .mockResolvedValueOnce('Structure 2');
+        const parts = await getEnvironmentContext(mockConfig);
+        expect(parts.length).toBe(1);
+        const context = parts[0].text;
+        expect(context).toContain("I'm currently working in the following directories:\n  - /test/dir1\n  - /test/dir2");
+        expect(context).toContain('Here is the folder structure of the current working directories:\n\nStructure 1\nStructure 2');
+        expect(getFolderStructure).toHaveBeenCalledTimes(2);
+    });
+});
+describe('getInitialChatHistory', () => {
+    let mockConfig;
+    beforeEach(() => {
+        vi.mocked(getFolderStructure).mockResolvedValue('Mock Folder Structure');
+        mockConfig = {
+            getSkipStartupContext: vi.fn().mockReturnValue(false),
+            getWorkspaceContext: vi.fn().mockReturnValue({
+                getDirectories: vi.fn().mockReturnValue(['/test/dir']),
+            }),
+            getFileService: vi.fn(),
+        };
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+        vi.restoreAllMocks();
+    });
+    it('includes startup context when skipStartupContext is false', async () => {
+        const history = await getInitialChatHistory(mockConfig);
+        expect(mockConfig.getSkipStartupContext).toHaveBeenCalled();
+        expect(history).toHaveLength(2);
+        expect(history).toEqual([
+            expect.objectContaining({
+                role: 'user',
+                parts: [
+                    expect.objectContaining({
+                        text: expect.stringContaining("I'm currently working in the directory"),
+                    }),
+                ],
+            }),
+            {
+                role: 'model',
+                parts: [{ text: 'Got it. Thanks for the context!' }],
+            },
+        ]);
+    });
+    it('returns only extra history when skipStartupContext is true', async () => {
+        mockConfig.getSkipStartupContext = vi.fn().mockReturnValue(true);
+        mockConfig.getWorkspaceContext = vi.fn(() => {
+            throw new Error('getWorkspaceContext should not be called when skipping startup context');
+        });
+        const extraHistory = [
+            { role: 'user', parts: [{ text: 'custom context' }] },
+        ];
+        const history = await getInitialChatHistory(mockConfig, extraHistory);
+        expect(mockConfig.getSkipStartupContext).toHaveBeenCalled();
+        expect(history).toEqual(extraHistory);
+        expect(history).not.toBe(extraHistory);
+    });
+    it('returns empty history when skipping startup context without extras', async () => {
+        mockConfig.getSkipStartupContext = vi.fn().mockReturnValue(true);
+        mockConfig.getWorkspaceContext = vi.fn(() => {
+            throw new Error('getWorkspaceContext should not be called when skipping startup context');
+        });
+        const history = await getInitialChatHistory(mockConfig);
+        expect(history).toEqual([]);
+    });
+});
+//# sourceMappingURL=environmentContext.test.js.map

package/core-dist/src/utils/environmentContext.test.js.map

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

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

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

package/core-dist/src/utils/errorParsing.js

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isApiError, isStructuredError } from './quotaErrorDetection.js';
+import { AuthType } from '../core/contentGenerator.js';
+// Free Tier message functions
+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 RATE_LIMIT_ERROR_MESSAGE_DEFAULT = '\nPossible quota limitations in place or slow response times detected. Please wait and try again later.';
+function getRateLimitMessage(authType) {
+    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 RATE_LIMIT_ERROR_MESSAGE_DEFAULT;
+    }
+}
+export function parseAndFormatApiError(error, authType) {
+    if (isStructuredError(error)) {
+        // Qwen OAuth quota errors have their own user-friendly message; don't wrap them
+        if (error.message.startsWith('Qwen OAuth quota exceeded:')) {
+            return error.message;
+        }
+        let text = `[API Error: ${error.message}]`;
+        if (error.status === 429) {
+            text += getRateLimitMessage(authType);
+        }
+        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.
+                }
+                const statusText = parsedError.error.status
+                    ? ` (Status: ${parsedError.error.status})`
+                    : '';
+                let text = `[API Error: ${finalMessage}${statusText}]`;
+                if (parsedError.error.code === 429) {
+                    text += getRateLimitMessage(authType);
+                }
+                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/core-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,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,8BAA8B;AAC9B,MAAM,mCAAmC,GACvC,2IAA2I,CAAC;AAC9I,MAAM,+BAA+B,GACnC,wIAAwI,CAAC;AAC3I,MAAM,gCAAgC,GACpC,yGAAyG,CAAC;AAE5G,SAAS,mBAAmB,CAAC,QAAmB;IAC9C,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,gCAAgC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,QAAmB;IAEnB,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,gFAAgF;QAChF,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,4BAA4B,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,IAAI,IAAI,GAAG,eAAe,KAAK,CAAC,OAAO,GAAG,CAAC;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACzB,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxC,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,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM;oBACzC,CAAC,CAAC,aAAa,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG;oBAC1C,CAAC,CAAC,EAAE,CAAC;gBACP,IAAI,IAAI,GAAG,eAAe,YAAY,GAAG,UAAU,GAAG,CAAC;gBACvD,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;oBACnC,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBACxC,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/core-dist/src/utils/errorParsing.test.d.ts

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

package/core-dist/src/utils/errorParsing.test.js

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { parseAndFormatApiError } from './errorParsing.js';
+import { AuthType } from '../core/contentGenerator.js';
+describe('parseAndFormatApiError', () => {
+    const vertexMessage = 'request a quota increase through Vertex';
+    const geminiMessage = 'request a quota increase through AI Studio';
+    it('should format a valid API error JSON', () => {
+        const errorMessage = 'got status: 400 Bad Request. {"error":{"code":400,"message":"API key not valid. Please pass a valid API key.","status":"INVALID_ARGUMENT"}}';
+        const expected = '[API Error: API key not valid. Please pass a valid API key. (Status: INVALID_ARGUMENT)]';
+        expect(parseAndFormatApiError(errorMessage)).toBe(expected);
+    });
+    it('should format a 429 API error with the default message', () => {
+        const errorMessage = 'got status: 429 Too Many Requests. {"error":{"code":429,"message":"Rate limit exceeded","status":"RESOURCE_EXHAUSTED"}}';
+        const result = parseAndFormatApiError(errorMessage, undefined);
+        expect(result).toContain('[API Error: Rate limit exceeded');
+        expect(result).toContain('Possible quota limitations in place or slow response times detected. Please wait and try again later.');
+    });
+    it('should format a 429 API error with the vertex message', () => {
+        const errorMessage = 'got status: 429 Too Many Requests. {"error":{"code":429,"message":"Rate limit exceeded","status":"RESOURCE_EXHAUSTED"}}';
+        const result = parseAndFormatApiError(errorMessage, AuthType.USE_VERTEX_AI);
+        expect(result).toContain('[API Error: Rate limit exceeded');
+        expect(result).toContain(vertexMessage);
+    });
+    it('should return the original message if it is not a JSON error', () => {
+        const errorMessage = 'This is a plain old error message';
+        expect(parseAndFormatApiError(errorMessage)).toBe(`[API Error: ${errorMessage}]`);
+    });
+    it('should return the original message for malformed JSON', () => {
+        const errorMessage = '[Stream Error: {"error": "malformed}';
+        expect(parseAndFormatApiError(errorMessage)).toBe(`[API Error: ${errorMessage}]`);
+    });
+    it('should handle JSON that does not match the ApiError structure', () => {
+        const errorMessage = '[Stream Error: {"not_an_error": "some other json"}]';
+        expect(parseAndFormatApiError(errorMessage)).toBe(`[API Error: ${errorMessage}]`);
+    });
+    it('should omit status when the API error has no status field', () => {
+        const errorMessage = '{"error":{"code":1302,"message":"您的账户已达到速率限制，请您控制请求频率"}}';
+        expect(parseAndFormatApiError(errorMessage)).toBe('[API Error: 您的账户已达到速率限制，请您控制请求频率]');
+    });
+    it('should format a nested API error', () => {
+        const nestedErrorMessage = JSON.stringify({
+            error: {
+                code: 429,
+                message: "Gemini 2.5 Pro Preview doesn't have a free quota tier. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits.",
+                status: 'RESOURCE_EXHAUSTED',
+            },
+        });
+        const errorMessage = JSON.stringify({
+            error: {
+                code: 429,
+                message: nestedErrorMessage,
+                status: 'Too Many Requests',
+            },
+        });
+        const result = parseAndFormatApiError(errorMessage, AuthType.USE_GEMINI);
+        expect(result).toContain('Gemini 2.5 Pro Preview');
+        expect(result).toContain(geminiMessage);
+    });
+    it('should format a StructuredError', () => {
+        const error = {
+            message: 'A structured error occurred',
+            status: 500,
+        };
+        const expected = '[API Error: A structured error occurred]';
+        expect(parseAndFormatApiError(error)).toBe(expected);
+    });
+    it('should format a 429 StructuredError with the vertex message', () => {
+        const error = {
+            message: 'Rate limit exceeded',
+            status: 429,
+        };
+        const result = parseAndFormatApiError(error, AuthType.USE_VERTEX_AI);
+        expect(result).toContain('[API Error: Rate limit exceeded]');
+        expect(result).toContain(vertexMessage);
+    });
+    it('should handle an unknown error type', () => {
+        const error = 12345;
+        const expected = '[API Error: An unknown error occurred.]';
+        expect(parseAndFormatApiError(error)).toBe(expected);
+    });
+});
+//# sourceMappingURL=errorParsing.test.js.map

package/core-dist/src/utils/errorParsing.test.js.map

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

package/core-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 and writes it to the debug log.
+ * @param error The error object.
+ * @param baseMessage The base message describing the error context.
+ * @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').
+ */
+export declare function reportError(error: Error | unknown, baseMessage: string, context?: Content[] | Record<string, unknown> | unknown[], type?: string): Promise<void>;

package/core-dist/src/utils/errorReporting.js

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createDebugLogger } from './debugLogger.js';
+const debugLogger = createDebugLogger('ERROR_REPORT');
+/**
+ * Generates an error report and writes it to the debug log.
+ * @param error The error object.
+ * @param baseMessage The base message describing the error context.
+ * @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').
+ */
+export async function reportError(error, baseMessage, context, type = 'general') {
+    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;
+    }
+    const reportLabel = `${baseMessage} [${type}]`;
+    let stringifiedReportContent;
+    try {
+        stringifiedReportContent = JSON.stringify(reportContent, null, 2);
+    }
+    catch (stringifyError) {
+        // This can happen if context contains something like BigInt
+        debugLogger.error(`${reportLabel} Could not stringify report content (likely due to context):`, stringifyError, error);
+        // Fallback: try to report only the error if context was the issue
+        try {
+            const minimalReportContent = { error: errorToReport };
+            stringifiedReportContent = JSON.stringify(minimalReportContent, null, 2);
+            debugLogger.error(reportLabel, stringifiedReportContent);
+        }
+        catch (minimalStringifyError) {
+            debugLogger.error(`${reportLabel} Failed to stringify minimal error report:`, minimalStringifyError, error);
+        }
+        return;
+    }
+    // Write to debug log instead of separate file
+    debugLogger.error(reportLabel, stringifiedReportContent);
+}
+//# sourceMappingURL=errorReporting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorReporting.js","sourceRoot":"","sources":["../../../src/utils/errorReporting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;AAQtD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAsB,EACtB,WAAmB,EACnB,OAAyD,EACzD,IAAI,GAAG,SAAS;IAEhB,IAAI,aAAkD,CAAC;IACvD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,aAAa,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC;SAAM,IACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK,EAClB,CAAC;QACD,aAAa,GAAG;YACd,OAAO,EAAE,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC;SACzD,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,aAAa,GAAoB,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAEhE,IAAI,OAAO,EAAE,CAAC;QACZ,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,WAAW,KAAK,IAAI,GAAG,CAAC;IAC/C,IAAI,wBAAgC,CAAC;IACrC,IAAI,CAAC;QACH,wBAAwB,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,cAAc,EAAE,CAAC;QACxB,4DAA4D;QAC5D,WAAW,CAAC,KAAK,CACf,GAAG,WAAW,8DAA8D,EAC5E,cAAc,EACd,KAAK,CACN,CAAC;QACF,kEAAkE;QAClE,IAAI,CAAC;YACH,MAAM,oBAAoB,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;YACtD,wBAAwB,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACzE,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,qBAAqB,EAAE,CAAC;YAC/B,WAAW,CAAC,KAAK,CACf,GAAG,WAAW,4CAA4C,EAC1D,qBAAqB,EACrB,KAAK,CACN,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,8CAA8C;IAC9C,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;AAC3D,CAAC"}

package/core-dist/src/utils/errorReporting.test.d.ts

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

package/core-dist/src/utils/errorReporting.test.js

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { reportError } from './errorReporting.js';
+const debugLoggerSpy = vi.hoisted(() => ({
+    error: vi.fn(),
+    warn: vi.fn(),
+    info: vi.fn(),
+    debug: vi.fn(),
+}));
+// Mock the debugLogger
+vi.mock('./debugLogger.js', () => ({
+    createDebugLogger: () => ({
+        error: debugLoggerSpy.error,
+        warn: debugLoggerSpy.warn,
+        info: debugLoggerSpy.info,
+        debug: debugLoggerSpy.debug,
+    }),
+}));
+describe('reportError', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should not throw when called with a standard error', async () => {
+        const error = new Error('Test error');
+        error.stack = 'Test stack';
+        const baseMessage = 'An error occurred.';
+        const context = { data: 'test context' };
+        const type = 'test-type';
+        await expect(reportError(error, baseMessage, context, type)).resolves.not.toThrow();
+        expect(debugLoggerSpy.error).toHaveBeenCalled();
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [${type}]`, expect.any(String));
+    });
+    it('should handle errors that are plain objects with a message property', async () => {
+        const error = { message: 'Test plain object error' };
+        const baseMessage = 'Another error.';
+        const type = 'general';
+        await expect(reportError(error, baseMessage, undefined, type)).resolves.not.toThrow();
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [${type}]`, expect.any(String));
+    });
+    it('should handle string errors', async () => {
+        const error = 'Just a string error';
+        const baseMessage = 'String error occurred.';
+        const type = 'general';
+        await expect(reportError(error, baseMessage, undefined, type)).resolves.not.toThrow();
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [${type}]`, expect.any(String));
+    });
+    it('should handle stringification failure of report content (e.g. BigInt in context)', async () => {
+        const error = new Error('Main error');
+        error.stack = 'Main stack';
+        const baseMessage = 'Failed operation with BigInt.';
+        const context = { a: BigInt(1) }; // BigInt cannot be stringified by JSON.stringify
+        // Simulate JSON.stringify throwing an error for the full report
+        const originalJsonStringify = JSON.stringify;
+        let callCount = 0;
+        vi.spyOn(JSON, 'stringify').mockImplementation((value, replacer, space) => {
+            callCount++;
+            if (callCount === 1) {
+                // First call is for the full report content
+                throw new TypeError('Do not know how to serialize a BigInt');
+            }
+            // Subsequent calls (for minimal report) should succeed
+            return originalJsonStringify(value, replacer, space);
+        });
+        await expect(reportError(error, baseMessage, context, 'bigint-fail')).resolves.not.toThrow();
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [bigint-fail] Could not stringify report content (likely due to context):`, expect.any(TypeError), error);
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [bigint-fail]`, expect.any(String));
+    });
+    it('should generate a report without context if context is not provided', async () => {
+        const error = new Error('Error without context');
+        error.stack = 'No context stack';
+        const baseMessage = 'Simple error.';
+        const type = 'general';
+        await expect(reportError(error, baseMessage, undefined, type)).resolves.not.toThrow();
+        expect(debugLoggerSpy.error).toHaveBeenCalledWith(`${baseMessage} [${type}]`, expect.any(String));
+    });
+});
+//# sourceMappingURL=errorReporting.test.js.map

package/core-dist/src/utils/errorReporting.test.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;
+/**
+ * Check if the error is an abort error (user cancellation).
+ * This handles both DOMException-style AbortError and Node.js abort errors.
+ */
+export declare function isAbortError(error: unknown): boolean;
+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 ForbiddenError extends Error {
+}
+export declare class UnauthorizedError extends Error {
+}
+export declare class BadRequestError extends Error {
+}
+export declare function toFriendlyError(error: unknown): unknown;