@anthropic-field/core 0.1.0

package/dist/src/utils/extensionLoader.js

@@ -0,0 +1,208 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { refreshServerHierarchicalMemory } from './memoryDiscovery.js';
+export class ExtensionLoader {
+    eventEmitter;
+    // Assigned in `start`.
+    config;
+    // Used to track the count of currently starting and stopping extensions and
+    // fire appropriate events.
+    startingCount = 0;
+    startCompletedCount = 0;
+    stoppingCount = 0;
+    stopCompletedCount = 0;
+    // Whether or not we are currently executing `start`
+    isStarting = false;
+    constructor(eventEmitter) {
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Fully initializes all active extensions.
+     *
+     * Called within `Config.initialize`, which must already have an
+     * McpClientManager, PromptRegistry, and GeminiChat set up.
+     */
+    async start(config) {
+        this.isStarting = true;
+        try {
+            if (!this.config) {
+                this.config = config;
+            }
+            else {
+                throw new Error('Already started, you may only call `start` once.');
+            }
+            await Promise.all(this.getExtensions()
+                .filter((e) => e.isActive)
+                .map(this.startExtension.bind(this)));
+        }
+        finally {
+            this.isStarting = false;
+        }
+    }
+    /**
+     * Unconditionally starts an `extension` and loads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * This should typically only be called from `start`, most other calls should
+     * go through `maybeStartExtension` which will only start the extension if
+     * extension reloading is enabled and the `config` object is initialized.
+     */
+    async startExtension(extension) {
+        if (!this.config) {
+            throw new Error('Cannot call `startExtension` prior to calling `start`.');
+        }
+        this.startingCount++;
+        this.eventEmitter?.emit('extensionsStarting', {
+            total: this.startingCount,
+            completed: this.startCompletedCount,
+        });
+        try {
+            await this.config.getMcpClientManager().startExtension(extension);
+            await this.maybeRefreshGeminiTools(extension);
+            // Note: Context files are loaded only once all extensions are done
+            // loading/unloading to reduce churn, see the `maybeRefreshMemories` call
+            // below.
+            // TODO: Update custom command updating away from the event based system
+            // and call directly into a custom command manager here. See the
+            // useSlashCommandProcessor hook which responds to events fired here today.
+        }
+        finally {
+            this.startCompletedCount++;
+            this.eventEmitter?.emit('extensionsStarting', {
+                total: this.startingCount,
+                completed: this.startCompletedCount,
+            });
+            if (this.startingCount === this.startCompletedCount) {
+                this.startingCount = 0;
+                this.startCompletedCount = 0;
+            }
+            await this.maybeRefreshMemories();
+        }
+    }
+    async maybeRefreshMemories() {
+        if (!this.config) {
+            throw new Error('Cannot refresh gemini memories prior to calling `start`.');
+        }
+        if (!this.isStarting && // Don't refresh memories on the first call to `start`.
+            this.startingCount === this.startCompletedCount &&
+            this.stoppingCount === this.stopCompletedCount) {
+            // Wait until all extensions are done starting and stopping before we
+            // reload memory, this is somewhat expensive and also busts the context
+            // cache, we want to only do it once.
+            await refreshServerHierarchicalMemory(this.config);
+            await this.config.getHookSystem()?.initialize();
+            await this.config.getAgentRegistry().reload();
+        }
+    }
+    /**
+     * Refreshes the gemini tools list if it is initialized and the extension has
+     * any excludeTools settings.
+     */
+    async maybeRefreshGeminiTools(extension) {
+        if (extension.excludeTools && extension.excludeTools.length > 0) {
+            const geminiClient = this.config?.getGeminiClient();
+            if (geminiClient?.isInitialized()) {
+                await geminiClient.setTools();
+            }
+        }
+    }
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then calls `startExtension` to include all extension features into the
+     * program.
+     */
+    async maybeStartExtension(extension) {
+        if (this.config && this.config.getEnableExtensionReloading()) {
+            await this.startExtension(extension);
+        }
+    }
+    /**
+     * Unconditionally stops an `extension` and unloads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * Most calls should go through `maybeStopExtension` which will only stop the
+     * extension if extension reloading is enabled and the `config` object is
+     * initialized.
+     */
+    async stopExtension(extension) {
+        if (!this.config) {
+            throw new Error('Cannot call `stopExtension` prior to calling `start`.');
+        }
+        this.stoppingCount++;
+        this.eventEmitter?.emit('extensionsStopping', {
+            total: this.stoppingCount,
+            completed: this.stopCompletedCount,
+        });
+        try {
+            await this.config.getMcpClientManager().stopExtension(extension);
+            await this.maybeRefreshGeminiTools(extension);
+            // Note: Context files are loaded only once all extensions are done
+            // loading/unloading to reduce churn, see the `maybeRefreshMemories` call
+            // below.
+            // TODO: Update custom command updating away from the event based system
+            // and call directly into a custom command manager here. See the
+            // useSlashCommandProcessor hook which responds to events fired here today.
+        }
+        finally {
+            this.stopCompletedCount++;
+            this.eventEmitter?.emit('extensionsStopping', {
+                total: this.stoppingCount,
+                completed: this.stopCompletedCount,
+            });
+            if (this.stoppingCount === this.stopCompletedCount) {
+                this.stoppingCount = 0;
+                this.stopCompletedCount = 0;
+            }
+            await this.maybeRefreshMemories();
+        }
+    }
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then this also performs all necessary steps to remove all extension
+     * features from the rest of the system.
+     */
+    async maybeStopExtension(extension) {
+        if (this.config && this.config.getEnableExtensionReloading()) {
+            await this.stopExtension(extension);
+        }
+    }
+    async restartExtension(extension) {
+        await this.stopExtension(extension);
+        await this.startExtension(extension);
+    }
+}
+export class SimpleExtensionLoader extends ExtensionLoader {
+    extensions;
+    constructor(extensions, eventEmitter) {
+        super(eventEmitter);
+        this.extensions = extensions;
+    }
+    getExtensions() {
+        return this.extensions;
+    }
+    /// Adds `extension` to the list of extensions and calls
+    /// `maybeStartExtension`.
+    ///
+    /// This is intended for dynamic loading of extensions after calling `start`.
+    async loadExtension(extension) {
+        this.extensions.push(extension);
+        await this.maybeStartExtension(extension);
+    }
+    /// Removes `extension` from the list of extensions and calls
+    // `maybeStopExtension` if it was found.
+    ///
+    /// This is intended for dynamic unloading of extensions after calling `start`.
+    async unloadExtension(extension) {
+        const index = this.extensions.indexOf(extension);
+        if (index === -1)
+            return;
+        this.extensions.splice(index, 1);
+        await this.maybeStopExtension(extension);
+    }
+}
+//# sourceMappingURL=extensionLoader.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * @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, options?: ErrorOptions);
+}
+export declare function isPrivateIp(url: string): boolean;
+export declare function fetchWithTimeout(url: string, timeout: number): Promise<Response>;
+export declare function setGlobalProxy(proxy: string): void;

package/dist/src/utils/fetch.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage, isNodeError } from './errors.js';
+import { URL } from 'node:url';
+import { ProxyAgent, setGlobalDispatcher } from 'undici';
+const PRIVATE_IP_RANGES = [
+    /^10\./,
+    /^127\./,
+    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+    /^192\.168\./,
+    /^::1$/,
+    /^fc00:/,
+    /^fe80:/,
+];
+export class FetchError extends Error {
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        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), undefined, { cause: error });
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+export function setGlobalProxy(proxy) {
+    setGlobalDispatcher(new ProxyAgent(proxy));
+}
+//# sourceMappingURL=fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAEzD,MAAM,iBAAiB,GAAG;IACxB,OAAO;IACP,QAAQ;IACR,gCAAgC;IAChC,aAAa;IACb,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IAFT,YACE,OAAe,EACR,IAAa,EACpB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAHjB,SAAI,GAAJ,IAAI,CAAS;QAIpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,OAAe;IAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAAC,2BAA2B,OAAO,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,mBAAmB,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiff } from '../tools/tools.js';
+import type { ToolCallRecord } from '../services/chatRecordingService.js';
+/**
+ * Safely extracts the FileDiff object from a tool call's resultDisplay.
+ * This helper performs runtime checks to ensure the object conforms to the FileDiff structure.
+ * @param resultDisplay The resultDisplay property of a ToolCallRecord.
+ * @returns The FileDiff object if found and valid, otherwise undefined.
+ */
+export declare function getFileDiffFromResultDisplay(resultDisplay: ToolCallRecord['resultDisplay']): FileDiff | undefined;
+export declare function computeAddedAndRemovedLines(stats: FileDiff['diffStat'] | undefined): {
+    addedLines: number;
+    removedLines: number;
+};

package/dist/src/utils/fileDiffUtils.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely extracts the FileDiff object from a tool call's resultDisplay.
+ * This helper performs runtime checks to ensure the object conforms to the FileDiff structure.
+ * @param resultDisplay The resultDisplay property of a ToolCallRecord.
+ * @returns The FileDiff object if found and valid, otherwise undefined.
+ */
+export function getFileDiffFromResultDisplay(resultDisplay) {
+    if (resultDisplay &&
+        typeof resultDisplay === 'object' &&
+        'diffStat' in resultDisplay &&
+        typeof resultDisplay.diffStat === 'object' &&
+        resultDisplay.diffStat !== null) {
+        const diffStat = resultDisplay.diffStat;
+        if (diffStat) {
+            return resultDisplay;
+        }
+    }
+    return undefined;
+}
+export function computeAddedAndRemovedLines(stats) {
+    if (!stats) {
+        return {
+            addedLines: 0,
+            removedLines: 0,
+        };
+    }
+    return {
+        addedLines: stats.model_added_lines + stats.user_added_lines,
+        removedLines: stats.model_removed_lines + stats.user_removed_lines,
+    };
+}
+//# sourceMappingURL=fileDiffUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileDiffUtils.js","sourceRoot":"","sources":["../../../src/utils/fileDiffUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAA8C;IAE9C,IACE,aAAa;QACb,OAAO,aAAa,KAAK,QAAQ;QACjC,UAAU,IAAI,aAAa;QAC3B,OAAO,aAAa,CAAC,QAAQ,KAAK,QAAQ;QAC1C,aAAa,CAAC,QAAQ,KAAK,IAAI,EAC/B,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAgC,CAAC;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAuC;IAKvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,gBAAgB;QAC5D,YAAY,EAAE,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,kBAAkB;KACnE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { PartUnion } from '@google/genai';
+import type { FileSystemService } from '../services/fileSystemService.js';
+import { ToolErrorType } from '../tools/tool-error.js';
+export declare function readWasmBinaryFromDisk(specifier: string): Promise<Uint8Array>;
+export declare function loadWasmBinary(dynamicImport: () => Promise<{
+    default: Uint8Array;
+}>, fallbackSpecifier: string): Promise<Uint8Array>;
+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;
+/**
+ * Read a file as text, honoring BOM encodings (UTF‑8/16/32) and stripping the BOM.
+ * Falls back to utf8 when no BOM is present.
+ */
+export declare function readFileWithEncoding(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 rootDirectory Absolute path to the project root for relative path display.
+ * @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, rootDirectory: string, fileSystemService: FileSystemService, offset?: number, limit?: number): Promise<ProcessedFileReadResult>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Formats a truncated message for tool output, handling multi-line and single-line (elephant) cases.
+ */
+export declare function formatTruncatedToolOutput(contentStr: string, outputFile: string, truncateLines?: number): string;
+/**
+ * Saves tool output to a temporary file for later retrieval.
+ */
+export declare const TOOL_OUTPUT_DIR = "tool_output";
+export declare function saveTruncatedToolOutput(content: string, toolName: string, id: string | number, // Accept string (callId) or number (truncationId)
+projectTempDir: string): Promise<{
+    outputFile: string;
+    totalLines: number;
+}>;
+export {};