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

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

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+/**
+ * Check if the error is an abort error (user cancellation).
+ * This handles both DOMException-style AbortError and Node.js abort errors.
+ */
+export function isAbortError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    // Check for AbortError by name (standard DOMException and custom AbortError)
+    if (error instanceof Error && error.name === 'AbortError') {
+        return true;
+    }
+    // Check for Node.js abort error code
+    if (isNodeError(error) && error.code === 'ABORT_ERR') {
+        return true;
+    }
+    return false;
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'Failed to get error details';
+    }
+}
+export class FatalError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+    }
+}
+export class FatalAuthenticationError extends FatalError {
+    constructor(message) {
+        super(message, 41);
+    }
+}
+export class FatalInputError extends FatalError {
+    constructor(message) {
+        super(message, 42);
+    }
+}
+export class FatalSandboxError extends FatalError {
+    constructor(message) {
+        super(message, 44);
+    }
+}
+export class FatalConfigError extends FatalError {
+    constructor(message) {
+        super(message, 52);
+    }
+}
+export class FatalTurnLimitedError extends FatalError {
+    constructor(message) {
+        super(message, 53);
+    }
+}
+export class FatalToolExecutionError extends FatalError {
+    constructor(message) {
+        super(message, 54);
+    }
+}
+export class FatalCancellationError extends FatalError {
+    constructor(message) {
+        super(message, 130); // Standard exit code for SIGINT
+    }
+}
+export class ForbiddenError extends Error {
+}
+export class UnauthorizedError extends Error {
+}
+export class BadRequestError extends Error {
+}
+export function toFriendlyError(error) {
+    if (error && typeof error === 'object' && 'response' in error) {
+        const gaxiosError = error;
+        const data = parseResponseData(gaxiosError);
+        if (data.error && data.error.message && data.error.code) {
+            switch (data.error.code) {
+                case 400:
+                    return new BadRequestError(data.error.message);
+                case 401:
+                    return new UnauthorizedError(data.error.message);
+                case 403:
+                    // It's import to pass the message here since it might
+                    // explain the cause like "the cloud project you're
+                    // using doesn't have code assist enabled".
+                    return new ForbiddenError(data.error.message);
+                default:
+            }
+        }
+    }
+    return error;
+}
+function parseResponseData(error) {
+    // Inexplicably, Gaxios sometimes doesn't JSONify the response data.
+    if (typeof error.response?.data === 'string') {
+        return JSON.parse(error.response?.data);
+    }
+    return error.response?.data;
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6EAA6E;IAC7E,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6BAA6B,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGxB;IAFX,YACE,OAAe,EACN,QAAgB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,aAAQ,GAAR,QAAQ,CAAQ;IAG3B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;CACF;AACD,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,gCAAgC;IACvD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAC5C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAS7C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,KAAoB,CAAC;QACzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxD,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACxB,KAAK,GAAG;oBACN,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjD,KAAK,GAAG;oBACN,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnD,KAAK,GAAG;oBACN,sDAAsD;oBACtD,mDAAmD;oBACnD,2CAA2C;oBAC3C,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChD,QAAQ;YACV,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,oEAAoE;IACpE,IAAI,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAiB,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAoB,CAAC;AAC9C,CAAC"}

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { isAbortError, isNodeError } from './errors.js';
+describe('isAbortError', () => {
+    it('should return true for DOMException-style AbortError', () => {
+        const abortError = new Error('The operation was aborted');
+        abortError.name = 'AbortError';
+        expect(isAbortError(abortError)).toBe(true);
+    });
+    it('should return true for custom AbortError class', () => {
+        class AbortError extends Error {
+            constructor(message) {
+                super(message);
+                this.name = 'AbortError';
+            }
+        }
+        const error = new AbortError('Custom abort error');
+        expect(isAbortError(error)).toBe(true);
+    });
+    it('should return true for Node.js abort error (ABORT_ERR code)', () => {
+        const nodeAbortError = new Error('Request aborted');
+        nodeAbortError.code = 'ABORT_ERR';
+        expect(isAbortError(nodeAbortError)).toBe(true);
+    });
+    it('should return false for regular errors', () => {
+        expect(isAbortError(new Error('Regular error'))).toBe(false);
+    });
+    it('should return false for null', () => {
+        expect(isAbortError(null)).toBe(false);
+    });
+    it('should return false for undefined', () => {
+        expect(isAbortError(undefined)).toBe(false);
+    });
+    it('should return false for non-object values', () => {
+        expect(isAbortError('string error')).toBe(false);
+        expect(isAbortError(123)).toBe(false);
+        expect(isAbortError(true)).toBe(false);
+    });
+    it('should return false for errors with different names', () => {
+        const timeoutError = new Error('Request timed out');
+        timeoutError.name = 'TimeoutError';
+        expect(isAbortError(timeoutError)).toBe(false);
+    });
+    it('should return false for errors with other error codes', () => {
+        const networkError = new Error('Network error');
+        networkError.code = 'ECONNREFUSED';
+        expect(isAbortError(networkError)).toBe(false);
+    });
+});
+describe('isNodeError', () => {
+    it('should return true for Error with code property', () => {
+        const nodeError = new Error('File not found');
+        nodeError.code = 'ENOENT';
+        expect(isNodeError(nodeError)).toBe(true);
+    });
+    it('should return false for Error without code property', () => {
+        const regularError = new Error('Regular error');
+        expect(isNodeError(regularError)).toBe(false);
+    });
+    it('should return false for non-Error objects', () => {
+        expect(isNodeError({ code: 'ENOENT' })).toBe(false);
+        expect(isNodeError('string')).toBe(false);
+        expect(isNodeError(null)).toBe(false);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../../src/utils/errors.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC1D,UAAU,CAAC,IAAI,GAAG,YAAY,CAAC;QAE/B,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,UAAW,SAAQ,KAAK;YAC5B,YAAY,OAAe;gBACzB,KAAK,CAAC,OAAO,CAAC,CAAC;gBACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;YAC3B,CAAC;SACF;QAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,cAAc,GAAG,IAAI,KAAK,CAC9B,iBAAiB,CACO,CAAC;QAC3B,cAAc,CAAC,IAAI,GAAG,WAAW,CAAC;QAElC,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACpD,YAAY,CAAC,IAAI,GAAG,cAAc,CAAC;QAEnC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,eAAe,CAA0B,CAAC;QACzE,YAAY,CAAC,IAAI,GAAG,cAAc,CAAC;QAEnC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAA0B,CAAC;QACvE,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC;QAE1B,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAEhD,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class FetchError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare function isPrivateIp(url: string): boolean;
+export declare function fetchWithTimeout(url: string, timeout: number): Promise<Response>;
+export declare function formatFetchErrorForUser(error: unknown, options?: {
+    url?: string;
+}): string;

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

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage, isNodeError } from './errors.js';
+import { URL } from 'node:url';
+const PRIVATE_IP_RANGES = [
+    /^10\./,
+    /^127\./,
+    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+    /^192\.168\./,
+    /^::1$/,
+    /^fc00:/,
+    /^fe80:/,
+];
+const TLS_ERROR_CODES = new Set([
+    'UNABLE_TO_GET_ISSUER_CERT_LOCALLY',
+    'UNABLE_TO_VERIFY_LEAF_SIGNATURE',
+    'SELF_SIGNED_CERT_IN_CHAIN',
+    'DEPTH_ZERO_SELF_SIGNED_CERT',
+    'CERT_HAS_EXPIRED',
+    'ERR_TLS_CERT_ALTNAME_INVALID',
+]);
+const FETCH_TROUBLESHOOTING_ERROR_CODES = new Set([
+    ...TLS_ERROR_CODES,
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+]);
+export class FetchError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'FetchError';
+    }
+}
+export function isPrivateIp(url) {
+    try {
+        const hostname = new URL(url).hostname;
+        return PRIVATE_IP_RANGES.some((range) => range.test(hostname));
+    }
+    catch (_e) {
+        return false;
+    }
+}
+export async function fetchWithTimeout(url, timeout) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ABORT_ERR') {
+            throw new FetchError(`Request timed out after ${timeout}ms`, 'ETIMEDOUT');
+        }
+        throw new FetchError(getErrorMessage(error));
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+function getErrorCode(error) {
+    if (!error || typeof error !== 'object') {
+        return undefined;
+    }
+    if ('code' in error &&
+        typeof error['code'] === 'string') {
+        return error['code'];
+    }
+    return undefined;
+}
+function formatUnknownErrorMessage(error) {
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (typeof error === 'number' ||
+        typeof error === 'boolean' ||
+        typeof error === 'bigint') {
+        return String(error);
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (!error || typeof error !== 'object') {
+        return undefined;
+    }
+    const message = error['message'];
+    if (typeof message === 'string') {
+        return message;
+    }
+    return undefined;
+}
+function formatErrorCause(error) {
+    if (!(error instanceof Error)) {
+        return undefined;
+    }
+    const cause = error.cause;
+    if (!cause) {
+        return undefined;
+    }
+    const causeCode = getErrorCode(cause);
+    const causeMessage = formatUnknownErrorMessage(cause);
+    if (!causeCode && !causeMessage) {
+        return undefined;
+    }
+    if (causeCode && causeMessage && !causeMessage.includes(causeCode)) {
+        return `${causeCode}: ${causeMessage}`;
+    }
+    return causeMessage ?? causeCode;
+}
+export function formatFetchErrorForUser(error, options = {}) {
+    const errorMessage = getErrorMessage(error);
+    const code = error instanceof Error
+        ? (getErrorCode(error.cause) ??
+            getErrorCode(error))
+        : getErrorCode(error);
+    const cause = formatErrorCause(error);
+    const fullErrorMessage = [
+        errorMessage,
+        cause ? `(cause: ${cause})` : undefined,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    const shouldShowFetchHints = errorMessage.toLowerCase().includes('fetch failed') ||
+        (code != null && FETCH_TROUBLESHOOTING_ERROR_CODES.has(code));
+    const shouldShowTlsHint = code != null && TLS_ERROR_CODES.has(code);
+    if (!shouldShowFetchHints) {
+        return fullErrorMessage;
+    }
+    const hintLines = [
+        '',
+        'Troubleshooting:',
+        ...(options.url
+            ? [`- Confirm you can reach ${options.url} from this machine.`]
+            : []),
+        '- If you are behind a proxy, pass `--proxy <url>` (or set `proxy` in settings).',
+        ...(shouldShowTlsHint
+            ? [
+                '- If your network uses a corporate TLS inspection CA, set `NODE_EXTRA_CA_CERTS` to your CA bundle.',
+            ]
+            : []),
+    ];
+    return `${fullErrorMessage}${hintLines.join('\n')}`;
+}
+//# sourceMappingURL=fetch.js.map

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

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

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { FetchError, formatFetchErrorForUser } from './fetch.js';
+describe('formatFetchErrorForUser', () => {
+    it('includes troubleshooting hints for TLS errors', () => {
+        const tlsCause = new Error('unable to verify the first certificate');
+        tlsCause.code =
+            'UNABLE_TO_VERIFY_LEAF_SIGNATURE';
+        const fetchError = new TypeError('fetch failed');
+        fetchError.cause = tlsCause;
+        const message = formatFetchErrorForUser(fetchError, {
+            url: 'https://chat.qwen.ai',
+        });
+        expect(message).toContain('fetch failed');
+        expect(message).toContain('UNABLE_TO_VERIFY_LEAF_SIGNATURE');
+        expect(message).toContain('Troubleshooting:');
+        expect(message).toContain('Confirm you can reach https://chat.qwen.ai');
+        expect(message).toContain('--proxy');
+        expect(message).toContain('NODE_EXTRA_CA_CERTS');
+    });
+    it('includes troubleshooting hints for network codes', () => {
+        const fetchError = new FetchError('Request timed out after 100ms', 'ETIMEDOUT');
+        const message = formatFetchErrorForUser(fetchError, {
+            url: 'https://example.com',
+        });
+        expect(message).toContain('Request timed out after 100ms');
+        expect(message).toContain('Troubleshooting:');
+        expect(message).toContain('Confirm you can reach https://example.com');
+        expect(message).toContain('--proxy');
+        expect(message).not.toContain('NODE_EXTRA_CA_CERTS');
+    });
+    it('does not include troubleshooting for non-fetch errors', () => {
+        expect(formatFetchErrorForUser(new Error('boom'))).toBe('boom');
+    });
+});
+//# sourceMappingURL=fetch.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.test.js","sourceRoot":"","sources":["../../../src/utils/fetch.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEjE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACpE,QAAsC,CAAC,IAAI;YAC1C,iCAAiC,CAAC;QAEpC,MAAM,UAAU,GAAG,IAAI,SAAS,CAAC,cAAc,CAE9C,CAAC;QACF,UAAU,CAAC,KAAK,GAAG,QAAQ,CAAC;QAE5B,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,EAAE;YAClD,GAAG,EAAE,sBAAsB;SAC5B,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,4CAA4C,CAAC,CAAC;QACxE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,UAAU,GAAG,IAAI,UAAU,CAC/B,+BAA+B,EAC/B,WAAW,CACZ,CAAC;QACF,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,EAAE;YAClD,GAAG,EAAE,qBAAqB;SAC3B,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACvE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { PartUnion } from '@google/genai';
+import { ToolErrorType } from '../tools/tool-error.js';
+import type { Config } from '../config/config.js';
+export declare const DEFAULT_ENCODING: BufferEncoding;
+type UnicodeEncoding = 'utf8' | 'utf16le' | 'utf16be' | 'utf32le' | 'utf32be';
+interface BOMInfo {
+    encoding: UnicodeEncoding;
+    bomLength: number;
+}
+/**
+ * Detect a Unicode BOM (Byte Order Mark) if present.
+ * Reads up to the first 4 bytes and returns encoding + BOM length, else null.
+ */
+export declare function detectBOM(buf: Buffer): BOMInfo | null;
+/**
+ * Result of reading a file with encoding detection.
+ */
+export interface FileReadResult {
+    /** Decoded text content of the file (BOM stripped if present). */
+    content: string;
+    /** Detected encoding name (e.g. 'utf-8', 'gb18030', 'utf-16le'). */
+    encoding: string;
+    /**
+     * Whether the file had a Unicode BOM (UTF-8, UTF-16 LE/BE, or UTF-32 LE/BE).
+     * When true, the same BOM should be re-written on save to preserve the file's
+     * original byte-order mark.
+     */
+    bom: boolean;
+}
+/**
+ * Read a file as text, honoring BOM encodings (UTF‑8/16/32) and stripping the BOM.
+ * For files without BOM, validates UTF-8 first. If invalid UTF-8, uses chardet
+ * to detect encoding (e.g. GBK, Big5, Shift_JIS) and iconv-lite to decode.
+ * Falls back to utf8 when detection fails.
+ *
+ * Returns both the decoded content and the detected encoding/BOM information
+ * in a single I/O pass, avoiding redundant file reads.
+ */
+export declare function readFileWithEncodingInfo(filePath: string): Promise<FileReadResult>;
+/**
+ * Read a file as text, honoring BOM encodings (UTF‑8/16/32) and stripping the BOM.
+ * For files without BOM, validates UTF-8 first. If invalid UTF-8, uses chardet
+ * to detect encoding (e.g. GBK, Big5, Shift_JIS) and iconv-lite to decode.
+ * Falls back to utf8 when detection fails.
+ */
+export declare function readFileWithEncoding(filePath: string): Promise<string>;
+/**
+ * Detect the encoding of a file by reading a sample from its beginning.
+ * Returns the encoding name (e.g. 'utf-8', 'gbk', 'shift_jis').
+ * Uses BOM detection first, then UTF-8 validation, then chardet as fallback.
+ */
+export declare function detectFileEncoding(filePath: string): Promise<string>;
+/**
+ * Looks up the specific MIME type for a file path.
+ * @param filePath Path to the file.
+ * @returns The specific MIME type string (e.g., 'text/python', 'application/javascript') or undefined if not found or ambiguous.
+ */
+export declare function getSpecificMimeType(filePath: string): string | undefined;
+/**
+ * Checks if a path is within a given root directory.
+ * @param pathToCheck The absolute path to check.
+ * @param rootDirectory The absolute root directory.
+ * @returns True if the path is within the root directory, false otherwise.
+ */
+export declare function isWithinRoot(pathToCheck: string, rootDirectory: string): boolean;
+/**
+ * Heuristic: determine if a file is likely binary.
+ * Now BOM-aware: if a Unicode BOM is detected, we treat it as text.
+ * For non-BOM files, retain the existing null-byte and non-printable ratio checks.
+ */
+export declare function isBinaryFile(filePath: string): Promise<boolean>;
+/**
+ * Detects the type of file based on extension and content.
+ * @param filePath Path to the file.
+ * @returns Promise that resolves to 'text', 'image', 'pdf', 'audio', 'video', 'binary' or 'svg'.
+ */
+export declare function detectFileType(filePath: string): Promise<'text' | 'image' | 'pdf' | 'audio' | 'video' | 'binary' | 'svg'>;
+export interface ProcessedFileReadResult {
+    llmContent: PartUnion;
+    returnDisplay: string;
+    error?: string;
+    errorType?: ToolErrorType;
+    isTruncated?: boolean;
+    originalLineCount?: number;
+    linesShown?: [number, number];
+}
+/**
+ * Reads and processes a single file, handling text, images, and PDFs.
+ * @param filePath Absolute path to the file.
+ * @param config Config instance for truncation settings.
+ * @param offset Optional offset for text files (0-based line number).
+ * @param limit Optional limit for text files (number of lines to read).
+ * @returns ProcessedFileReadResult object.
+ */
+export declare function processSingleFileContent(filePath: string, config: Config, offset?: number, limit?: number): Promise<ProcessedFileReadResult>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export {};