@anthropic-field/core 0.1.0

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

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable no-console */
+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;;;;GAIG;AAEH,+BAA+B;AAC/B,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/delay.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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;;;;GAIG;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/editCorrector.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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, disableLLMCorrection: boolean): Promise<CorrectedEditResult>;
+export declare function ensureCorrectFileContent(content: string, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal, disableLLMCorrection?: boolean): 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 {};