@terminai/core 0.21.0

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Parses custom headers and returns a map of key and vallues
+ */
+export declare function parseCustomHeaders(envValue: string | undefined): Record<string, string>;

package/dist/src/utils/customHeaderUtils.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Parses custom headers and returns a map of key and vallues
+ */
+export function parseCustomHeaders(envValue) {
+    const headers = {};
+    if (!envValue) {
+        return headers;
+    }
+    // Split the string on commas that are followed by a header key (key:),
+    // but ignore commas that are part of a header value (including values with colons or commas)
+    for (const entry of envValue.split(/,(?=\s*[^,:]+:)/)) {
+        const trimmedEntry = entry.trim();
+        if (!trimmedEntry) {
+            continue;
+        }
+        const separatorIndex = trimmedEntry.indexOf(':');
+        if (separatorIndex === -1) {
+            continue;
+        }
+        const name = trimmedEntry.slice(0, separatorIndex).trim();
+        const value = trimmedEntry.slice(separatorIndex + 1).trim();
+        if (!name) {
+            continue;
+        }
+        headers[name] = value;
+    }
+    return headers;
+}
+//# sourceMappingURL=customHeaderUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customHeaderUtils.js","sourceRoot":"","sources":["../../../src/utils/customHeaderUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA4B;IAE5B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uEAAuE;IACvE,6FAA6F;IAC7F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

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

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

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { parseCustomHeaders } from './customHeaderUtils.js';
+describe('parseCustomHeaders', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should return an empty object if input is undefined', () => {
+        expect(parseCustomHeaders(undefined)).toEqual({});
+    });
+    it('should return an empty object if input is empty string', () => {
+        expect(parseCustomHeaders('')).toEqual({});
+    });
+    it('should parse a single header correctly', () => {
+        const input = 'Authorization: Bearer abc123';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+        });
+    });
+    it('should parse multiple headers separated by commas', () => {
+        const input = 'Authorization: Bearer abc123, Content-Type: application/json';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should ignore entries without colon', () => {
+        const input = 'Authorization Bearer abc123, Content-Type: application/json';
+        expect(parseCustomHeaders(input)).toEqual({
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should trim whitespace around names and values', () => {
+        const input = '  Authorization  :   Bearer abc123  ,  Content-Type : application/json  ';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should handle headers with colons in the value', () => {
+        const input = 'X-Custom: value:with:colons, Authorization: Bearer xyz';
+        expect(parseCustomHeaders(input)).toEqual({
+            'X-Custom': 'value:with:colons',
+            Authorization: 'Bearer xyz',
+        });
+    });
+    it('should skip headers with empty name', () => {
+        const input = ': no-name, Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc',
+        });
+    });
+    it('should skip completely empty entries', () => {
+        const input = ', , Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc',
+        });
+    });
+    it('should handle Authorization Bearer with different casing', () => {
+        const input = 'authorization: Bearer token123';
+        expect(parseCustomHeaders(input)).toEqual({
+            authorization: 'Bearer token123',
+        });
+    });
+    it('should handle values with commas correctly', () => {
+        const input = 'X-Header: value,with,commas, Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            'X-Header': 'value,with,commas',
+            Authorization: 'Bearer abc',
+        });
+    });
+});
+//# sourceMappingURL=customHeaderUtils.test.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A simple, centralized logger for developer-facing debug messages.
+ *
+ * WHY USE THIS?
+ * - It makes the INTENT of the log clear (it's for developers, not users).
+ * - It provides a single point of control for debug logging behavior.
+ * - We can lint against direct `console.*` usage to enforce this pattern.
+ *
+ * HOW IT WORKS:
+ * This is a thin wrapper around the native `console` object. The `ConsolePatcher`
+ * will intercept these calls and route them to the debug drawer UI.
+ */
+declare class DebugLogger {
+    private logStream;
+    constructor();
+    private writeToFile;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export declare const debugLogger: DebugLogger;
+export {};

package/dist/src/utils/debugLogger.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as util from 'node:util';
+/**
+ * A simple, centralized logger for developer-facing debug messages.
+ *
+ * WHY USE THIS?
+ * - It makes the INTENT of the log clear (it's for developers, not users).
+ * - It provides a single point of control for debug logging behavior.
+ * - We can lint against direct `console.*` usage to enforce this pattern.
+ *
+ * HOW IT WORKS:
+ * This is a thin wrapper around the native `console` object. The `ConsolePatcher`
+ * will intercept these calls and route them to the debug drawer UI.
+ */
+class DebugLogger {
+    logStream;
+    constructor() {
+        this.logStream = process.env['GEMINI_DEBUG_LOG_FILE']
+            ? fs.createWriteStream(process.env['GEMINI_DEBUG_LOG_FILE'], {
+                flags: 'a',
+            })
+            : undefined;
+        // Handle potential errors with the stream
+        this.logStream?.on('error', (err) => {
+            // Log to console as a fallback, but don't crash the app
+            console.error('Error writing to debug log stream:', err);
+        });
+    }
+    writeToFile(level, args) {
+        if (this.logStream) {
+            const message = util.format(...args);
+            const timestamp = new Date().toISOString();
+            const logEntry = `[${timestamp}] [${level}] ${message}\n`;
+            this.logStream.write(logEntry);
+        }
+    }
+    log(...args) {
+        this.writeToFile('LOG', args);
+        console.log(...args);
+    }
+    warn(...args) {
+        this.writeToFile('WARN', args);
+        console.warn(...args);
+    }
+    error(...args) {
+        this.writeToFile('ERROR', args);
+        console.error(...args);
+    }
+    debug(...args) {
+        this.writeToFile('DEBUG', args);
+        console.debug(...args);
+    }
+}
+export const debugLogger = new DebugLogger();
+//# sourceMappingURL=debugLogger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debugLogger.js","sourceRoot":"","sources":["../../../src/utils/debugLogger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW;IACP,SAAS,CAA6B;IAE9C;QACE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE;gBACzD,KAAK,EAAE,GAAG;aACX,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,0CAA0C;QAC1C,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAClC,wDAAwD;YACxD,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAa,EAAE,IAAe;QAChD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,KAAK,KAAK,OAAO,IAAI,CAAC;YAC1D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAG,IAAe;QACpB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { debugLogger } from './debugLogger.js';
+describe('DebugLogger', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should call console.log with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const message = 'This is a log message';
+        const data = { key: 'value' };
+        debugLogger.log(message, data);
+        expect(spy).toHaveBeenCalledWith(message, data);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.warn with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const message = 'This is a warning message';
+        const data = [1, 2, 3];
+        debugLogger.warn(message, data);
+        expect(spy).toHaveBeenCalledWith(message, data);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.error with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const message = 'This is an error message';
+        const error = new Error('Something went wrong');
+        debugLogger.error(message, error);
+        expect(spy).toHaveBeenCalledWith(message, error);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.debug with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        const message = 'This is a debug message';
+        const obj = { a: { b: 'c' } };
+        debugLogger.debug(message, obj);
+        expect(spy).toHaveBeenCalledWith(message, obj);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should handle multiple arguments correctly for all methods', () => {
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const debugSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        debugLogger.log('one', 2, true);
+        expect(logSpy).toHaveBeenCalledWith('one', 2, true);
+        debugLogger.warn('one', 2, false);
+        expect(warnSpy).toHaveBeenCalledWith('one', 2, false);
+        debugLogger.error('one', 2, null);
+        expect(errorSpy).toHaveBeenCalledWith('one', 2, null);
+        debugLogger.debug('one', 2, undefined);
+        expect(debugSpy).toHaveBeenCalledWith('one', 2, undefined);
+    });
+    it('should handle calls with no arguments', () => {
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        debugLogger.log();
+        expect(logSpy).toHaveBeenCalledWith();
+        expect(logSpy).toHaveBeenCalledTimes(1);
+        debugLogger.warn();
+        expect(warnSpy).toHaveBeenCalledWith();
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=debugLogger.test.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MergeStrategy } from '../config/settings/schema-types.js';
+export type Mergeable = string | number | boolean | null | undefined | object | Mergeable[];
+export type MergeableObject = Record<string, Mergeable>;
+export declare function customDeepMerge(getMergeStrategyForPath: (path: string[]) => MergeStrategy | undefined, ...sources: MergeableObject[]): MergeableObject;

package/dist/src/utils/deepMerge.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MergeStrategy } from '../config/settings/schema-types.js';
+function isPlainObject(item) {
+    return !!item && typeof item === 'object' && !Array.isArray(item);
+}
+function mergeRecursively(target, source, getMergeStrategyForPath, path = []) {
+    for (const key of Object.keys(source)) {
+        // JSON.parse can create objects with __proto__ as an own property.
+        // We must skip it to prevent prototype pollution.
+        if (key === '__proto__') {
+            continue;
+        }
+        const srcValue = source[key];
+        if (srcValue === undefined) {
+            continue;
+        }
+        const newPath = [...path, key];
+        const objValue = target[key];
+        const mergeStrategy = getMergeStrategyForPath(newPath);
+        if (mergeStrategy === MergeStrategy.SHALLOW_MERGE && objValue && srcValue) {
+            const obj1 = typeof objValue === 'object' && objValue !== null ? objValue : {};
+            const obj2 = typeof srcValue === 'object' && srcValue !== null ? srcValue : {};
+            target[key] = { ...obj1, ...obj2 };
+            continue;
+        }
+        if (Array.isArray(objValue)) {
+            const srcArray = Array.isArray(srcValue) ? srcValue : [srcValue];
+            if (mergeStrategy === MergeStrategy.CONCAT) {
+                target[key] = objValue.concat(srcArray);
+                continue;
+            }
+            if (mergeStrategy === MergeStrategy.UNION) {
+                target[key] = [...new Set(objValue.concat(srcArray))];
+                continue;
+            }
+        }
+        if (isPlainObject(objValue) && isPlainObject(srcValue)) {
+            mergeRecursively(objValue, srcValue, getMergeStrategyForPath, newPath);
+        }
+        else if (isPlainObject(srcValue)) {
+            target[key] = {};
+            mergeRecursively(target[key], srcValue, getMergeStrategyForPath, newPath);
+        }
+        else {
+            target[key] = srcValue;
+        }
+    }
+    return target;
+}
+export function customDeepMerge(getMergeStrategyForPath, ...sources) {
+    const result = {};
+    for (const source of sources) {
+        if (source) {
+            mergeRecursively(result, source, getMergeStrategyForPath);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deepMerge.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Factory to create a standard abort error for delay helpers.
+ */
+export declare function createAbortError(): Error;
+/**
+ * Returns a promise that resolves after the provided duration unless aborted.
+ *
+ * @param ms Delay duration in milliseconds.
+ * @param signal Optional abort signal to cancel the wait early.
+ */
+export declare function delay(ms: number, signal?: AbortSignal): Promise<void>;

package/dist/src/utils/delay.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Factory to create a standard abort error for delay helpers.
+ */
+export function createAbortError() {
+    const abortError = new Error('Aborted');
+    abortError.name = 'AbortError';
+    return abortError;
+}
+/**
+ * Returns a promise that resolves after the provided duration unless aborted.
+ *
+ * @param ms Delay duration in milliseconds.
+ * @param signal Optional abort signal to cancel the wait early.
+ */
+export function delay(ms, signal) {
+    // If no abort signal is provided, set simple delay
+    if (!signal) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    // Immediately reject if signal has already been aborted
+    if (signal.aborted) {
+        return Promise.reject(createAbortError());
+    }
+    // remove abort and timeout listeners to prevent memory-leaks
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timeoutId);
+            signal.removeEventListener('abort', onAbort);
+            reject(createAbortError());
+        };
+        const timeoutId = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=delay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../../src/utils/delay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IACxC,UAAU,CAAC,IAAI,GAAG,YAAY,CAAC;IAC/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,mDAAmD;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,wDAAwD;IACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,6DAA6D;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
+import { delay } from './delay.js';
+describe('abortableDelay', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('resolves after the specified duration without a signal', async () => {
+        const promise = delay(100);
+        await vi.advanceTimersByTimeAsync(100);
+        await expect(promise).resolves.toBeUndefined();
+    });
+    it('resolves when a non-aborted signal is provided', async () => {
+        const controller = new AbortController();
+        const promise = delay(200, controller.signal);
+        await vi.advanceTimersByTimeAsync(200);
+        await expect(promise).resolves.toBeUndefined();
+    });
+    it('rejects immediately if the signal is already aborted', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        await expect(delay(50, controller.signal)).rejects.toMatchObject({
+            name: 'AbortError',
+            message: 'Aborted',
+        });
+    });
+    it('rejects if the signal aborts while waiting', async () => {
+        const controller = new AbortController();
+        const promise = delay(500, controller.signal);
+        await vi.advanceTimersByTimeAsync(100);
+        controller.abort();
+        await expect(promise).rejects.toMatchObject({
+            name: 'AbortError',
+            message: 'Aborted',
+        });
+    });
+    it('cleans up signal listeners after resolving', async () => {
+        const removeEventListener = vi.fn();
+        const mockSignal = {
+            aborted: false,
+            addEventListener: vi
+                .fn()
+                .mockImplementation((_type, listener) => {
+                mockSignal.__listener = listener;
+            }),
+            removeEventListener,
+            __listener: undefined,
+        };
+        const promise = delay(150, mockSignal);
+        await vi.advanceTimersByTimeAsync(150);
+        await promise;
+        expect(mockSignal.addEventListener).toHaveBeenCalledTimes(1);
+        expect(removeEventListener).toHaveBeenCalledTimes(1);
+        expect(removeEventListener.mock.calls[0][1]).toBe(mockSignal.__listener);
+    });
+    // Technically unnecessary due to `onceTrue` but good sanity check
+    it('cleans up signal listeners when aborted before completion', async () => {
+        const controller = new AbortController();
+        const removeEventListenerSpy = vi.spyOn(controller.signal, 'removeEventListener');
+        const promise = delay(400, controller.signal);
+        await vi.advanceTimersByTimeAsync(50);
+        controller.abort();
+        await expect(promise).rejects.toMatchObject({
+            name: 'AbortError',
+        });
+        expect(removeEventListenerSpy).toHaveBeenCalledTimes(1);
+    });
+    it('cleans up timeout when aborted before completion', async () => {
+        const clearTimeoutSpy = vi.spyOn(global, 'clearTimeout');
+        const controller = new AbortController();
+        const promise = delay(400, controller.signal);
+        await vi.advanceTimersByTimeAsync(50);
+        controller.abort();
+        await expect(promise).rejects.toMatchObject({
+            name: 'AbortError',
+        });
+        expect(clearTimeoutSpy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=delay.test.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GeminiClient } from '../core/client.js';
+import type { BaseLlmClient } from '../core/baseLlmClient.js';
+import type { EditToolParams } from '../tools/edit.js';
+/**
+ * Defines the structure of the parameters within CorrectedEditResult
+ */
+interface CorrectedEditParams {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+}
+/**
+ * Defines the result structure for ensureCorrectEdit.
+ */
+export interface CorrectedEditResult {
+    params: CorrectedEditParams;
+    occurrences: number;
+}
+/**
+ * Attempts to correct edit parameters if the original old_string is not found.
+ * It tries unescaping, and then LLM-based correction.
+ * Results are cached to avoid redundant processing.
+ *
+ * @param currentContent The current content of the file.
+ * @param originalParams The original EditToolParams
+ * @param client The GeminiClient for LLM calls.
+ * @returns A promise resolving to an object containing the (potentially corrected)
+ *          EditToolParams (as CorrectedEditParams) and the final occurrences count.
+ */
+export declare function ensureCorrectEdit(filePath: string, currentContent: string, originalParams: EditToolParams, // This is the EditToolParams from edit.ts, without \'corrected\'
+geminiClient: GeminiClient, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal): Promise<CorrectedEditResult>;
+export declare function ensureCorrectFileContent(content: string, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal): Promise<string>;
+export declare function correctOldStringMismatch(baseLlmClient: BaseLlmClient, fileContent: string, problematicSnippet: string, abortSignal: AbortSignal): Promise<string>;
+/**
+ * Adjusts the new_string to align with a corrected old_string, maintaining the original intent.
+ */
+export declare function correctNewString(baseLlmClient: BaseLlmClient, originalOldString: string, correctedOldString: string, originalNewString: string, abortSignal: AbortSignal): Promise<string>;
+export declare function correctNewStringEscaping(baseLlmClient: BaseLlmClient, oldString: string, potentiallyProblematicNewString: string, abortSignal: AbortSignal): Promise<string>;
+export declare function correctStringEscaping(potentiallyProblematicString: string, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal): Promise<string>;
+/**
+ * Unescapes a string that might have been overly escaped by an LLM.
+ */
+export declare function unescapeStringForGeminiBug(inputString: string): string;
+/**
+ * Counts occurrences of a substring in a string
+ */
+export declare function countOccurrences(str: string, substr: string): number;
+export declare function resetEditCorrectorCaches_TEST_ONLY(): void;
+export {};