@anthropic-field/core 0.1.0

package/dist/src/utils/apiConversionUtils.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Transforms a standard SDK GenerateContentParameters object into the
+ * equivalent REST API payload format. This is primarily used for debugging
+ * and exporting requests.
+ */
+export function convertToRestPayload(req) {
+    // Extract top-level REST fields from the SDK config object.
+    // 'pureGenerationConfig' will capture any remaining hyperparameters (e.g., temperature, topP).
+    const { systemInstruction: sdkSystemInstruction, tools: sdkTools, toolConfig: sdkToolConfig, safetySettings: sdkSafetySettings, cachedContent: sdkCachedContent, abortSignal: _sdkAbortSignal, // Exclude JS-specific abort controller
+    ...pureGenerationConfig } = req.config || {};
+    // Normalize systemInstruction to the expected REST Content format.
+    let restSystemInstruction;
+    if (typeof sdkSystemInstruction === 'string') {
+        restSystemInstruction = {
+            parts: [{ text: sdkSystemInstruction }],
+        };
+    }
+    else if (sdkSystemInstruction !== undefined) {
+        restSystemInstruction = sdkSystemInstruction;
+    }
+    const restPayload = {
+        contents: req.contents,
+    };
+    // Only include generationConfig if actual hyperparameters exist.
+    if (Object.keys(pureGenerationConfig).length > 0) {
+        restPayload['generationConfig'] = pureGenerationConfig;
+    }
+    // Assign extracted capabilities to the root level.
+    if (restSystemInstruction)
+        restPayload['systemInstruction'] = restSystemInstruction;
+    if (sdkTools)
+        restPayload['tools'] = sdkTools;
+    if (sdkToolConfig)
+        restPayload['toolConfig'] = sdkToolConfig;
+    if (sdkSafetySettings)
+        restPayload['safetySettings'] = sdkSafetySettings;
+    if (sdkCachedContent)
+        restPayload['cachedContent'] = sdkCachedContent;
+    return restPayload;
+}
+//# sourceMappingURL=apiConversionUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apiConversionUtils.js","sourceRoot":"","sources":["../../../src/utils/apiConversionUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAA8B;IAE9B,4DAA4D;IAC5D,+FAA+F;IAC/F,MAAM,EACJ,iBAAiB,EAAE,oBAAoB,EACvC,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,aAAa,EACzB,cAAc,EAAE,iBAAiB,EACjC,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,eAAe,EAAE,uCAAuC;IACrE,GAAG,oBAAoB,EACxB,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAErB,mEAAmE;IACnE,IAAI,qBAAqB,CAAC;IAC1B,IAAI,OAAO,oBAAoB,KAAK,QAAQ,EAAE,CAAC;QAC7C,qBAAqB,GAAG;YACtB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;SACxC,CAAC;IACJ,CAAC;SAAM,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC9C,qBAAqB,GAAG,oBAAoB,CAAC;IAC/C,CAAC;IAED,MAAM,WAAW,GAA4B;QAC3C,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;IAEF,iEAAiE;IACjE,IAAI,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,WAAW,CAAC,kBAAkB,CAAC,GAAG,oBAAoB,CAAC;IACzD,CAAC;IAED,mDAAmD;IACnD,IAAI,qBAAqB;QACvB,WAAW,CAAC,mBAAmB,CAAC,GAAG,qBAAqB,CAAC;IAC3D,IAAI,QAAQ;QAAE,WAAW,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC9C,IAAI,aAAa;QAAE,WAAW,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC;IAC7D,IAAI,iBAAiB;QAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG,iBAAiB,CAAC;IACzE,IAAI,gBAAgB;QAAE,WAAW,CAAC,eAAe,CAAC,GAAG,gBAAgB,CAAC;IAEtE,OAAO,WAAW,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import type { FileFilteringOptions } from '../config/constants.js';
+interface BfsFileSearchOptions {
+    fileName: string;
+    ignoreDirs?: string[];
+    maxDirs?: number;
+    debug?: boolean;
+    fileService?: FileDiscoveryService;
+    fileFilteringOptions?: FileFilteringOptions;
+}
+/**
+ * Performs a breadth-first search for a specific file within a directory structure.
+ *
+ * @param rootDir The directory to start the search from.
+ * @param options Configuration for the search.
+ * @returns A promise that resolves to an array of paths where the file was found.
+ */
+export declare function bfsFileSearch(rootDir: string, options: BfsFileSearchOptions): Promise<string[]>;
+/**
+ * Performs a synchronous breadth-first search for a specific file within a directory structure.
+ *
+ * @param rootDir The directory to start the search from.
+ * @param options Configuration for the search.
+ * @returns An array of paths where the file was found.
+ */
+export declare function bfsFileSearchSync(rootDir: string, options: BfsFileSearchOptions): string[];
+export {};

package/dist/src/utils/bfsFileSearch.js

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as path from 'node:path';
+import { debugLogger } from './debugLogger.js';
+// Simple console logger for now.
+// TODO: Integrate with a more robust server-side logger.
+const logger = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug: (...args) => debugLogger.debug('[DEBUG] [BfsFileSearch]', ...args),
+};
+/**
+ * Performs a breadth-first search for a specific file within a directory structure.
+ *
+ * @param rootDir The directory to start the search from.
+ * @param options Configuration for the search.
+ * @returns A promise that resolves to an array of paths where the file was found.
+ */
+export async function bfsFileSearch(rootDir, options) {
+    const { ignoreDirs = [], maxDirs = Infinity, debug = false } = options;
+    const foundFiles = [];
+    const queue = [rootDir];
+    const visited = new Set();
+    let scannedDirCount = 0;
+    let queueHead = 0; // Pointer-based queue head to avoid expensive splice operations
+    // Convert ignoreDirs array to Set for O(1) lookup performance
+    const ignoreDirsSet = new Set(ignoreDirs);
+    // Process directories in parallel batches for maximum performance
+    const PARALLEL_BATCH_SIZE = 15; // Parallel processing batch size for optimal performance
+    while (queueHead < queue.length && scannedDirCount < maxDirs) {
+        // Fill batch with unvisited directories up to the desired size
+        const batchSize = Math.min(PARALLEL_BATCH_SIZE, maxDirs - scannedDirCount);
+        const currentBatch = [];
+        while (currentBatch.length < batchSize && queueHead < queue.length) {
+            const currentDir = queue[queueHead];
+            queueHead++;
+            if (!visited.has(currentDir)) {
+                visited.add(currentDir);
+                currentBatch.push(currentDir);
+            }
+        }
+        scannedDirCount += currentBatch.length;
+        if (currentBatch.length === 0)
+            continue;
+        if (debug) {
+            logger.debug(`Scanning [${scannedDirCount}/${maxDirs}]: batch of ${currentBatch.length}`);
+        }
+        // Read directories in parallel instead of one by one
+        const readPromises = currentBatch.map(async (currentDir) => {
+            try {
+                const entries = await fs.readdir(currentDir, { withFileTypes: true });
+                return { currentDir, entries };
+            }
+            catch (error) {
+                // Warn user that a directory could not be read, as this affects search results.
+                const message = error?.message ?? 'Unknown error';
+                debugLogger.warn(`[WARN] Skipping unreadable directory: ${currentDir} (${message})`);
+                if (debug) {
+                    logger.debug(`Full error for ${currentDir}:`, error);
+                }
+                return { currentDir, entries: [] };
+            }
+        });
+        const results = await Promise.all(readPromises);
+        for (const { currentDir, entries } of results) {
+            processDirEntries(currentDir, entries, options, ignoreDirsSet, queue, foundFiles);
+        }
+    }
+    return foundFiles;
+}
+/**
+ * Performs a synchronous breadth-first search for a specific file within a directory structure.
+ *
+ * @param rootDir The directory to start the search from.
+ * @param options Configuration for the search.
+ * @returns An array of paths where the file was found.
+ */
+export function bfsFileSearchSync(rootDir, options) {
+    const { ignoreDirs = [], maxDirs = Infinity, debug = false } = options;
+    const foundFiles = [];
+    const queue = [rootDir];
+    const visited = new Set();
+    let scannedDirCount = 0;
+    let queueHead = 0;
+    const ignoreDirsSet = new Set(ignoreDirs);
+    while (queueHead < queue.length && scannedDirCount < maxDirs) {
+        const currentDir = queue[queueHead];
+        queueHead++;
+        if (!visited.has(currentDir)) {
+            visited.add(currentDir);
+            scannedDirCount++;
+            if (debug) {
+                logger.debug(`Scanning Sync [${scannedDirCount}/${maxDirs}]: ${currentDir}`);
+            }
+            try {
+                const entries = fsSync.readdirSync(currentDir, { withFileTypes: true });
+                processDirEntries(currentDir, entries, options, ignoreDirsSet, queue, foundFiles);
+            }
+            catch (error) {
+                const message = error?.message ?? 'Unknown error';
+                debugLogger.warn(`[WARN] Skipping unreadable directory: ${currentDir} (${message})`);
+            }
+        }
+    }
+    return foundFiles;
+}
+function processDirEntries(currentDir, entries, options, ignoreDirsSet, queue, foundFiles) {
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        const isDirectory = entry.isDirectory();
+        const isMatchingFile = entry.isFile() && entry.name === options.fileName;
+        if (!isDirectory && !isMatchingFile) {
+            continue;
+        }
+        if (isDirectory && ignoreDirsSet.has(entry.name)) {
+            continue;
+        }
+        if (options.fileService?.shouldIgnoreFile(fullPath, {
+            respectGitIgnore: options.fileFilteringOptions?.respectGitIgnore,
+            respectGeminiIgnore: options.fileFilteringOptions?.respectGeminiIgnore,
+        })) {
+            continue;
+        }
+        if (isDirectory) {
+            queue.push(fullPath);
+        }
+        else {
+            foundFiles.push(fullPath);
+        }
+    }
+}
+//# sourceMappingURL=bfsFileSearch.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Determines if we should attempt to launch a browser for authentication
+ * based on the user's environment.
+ *
+ * This is an adaptation of the logic from the Google Cloud SDK.
+ * @returns True if the tool should attempt to launch a browser.
+ */
+export declare function shouldAttemptBrowserLaunch(): boolean;

package/dist/src/utils/browser.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Determines if we should attempt to launch a browser for authentication
+ * based on the user's environment.
+ *
+ * This is an adaptation of the logic from the Google Cloud SDK.
+ * @returns True if the tool should attempt to launch a browser.
+ */
+export function shouldAttemptBrowserLaunch() {
+    // A list of browser names that indicate we should not attempt to open a
+    // web browser for the user.
+    const browserBlocklist = ['www-browser'];
+    const browserEnv = process.env['BROWSER'];
+    if (browserEnv && browserBlocklist.includes(browserEnv)) {
+        return false;
+    }
+    // Common environment variables used in CI/CD or other non-interactive shells.
+    if (process.env['CI'] ||
+        process.env['DEBIAN_FRONTEND'] === 'noninteractive') {
+        return false;
+    }
+    // The presence of SSH_CONNECTION indicates a remote session.
+    // We should not attempt to launch a browser unless a display is explicitly available
+    // (checked below for Linux).
+    const isSSH = !!process.env['SSH_CONNECTION'];
+    // On Linux, the presence of a display server is a strong indicator of a GUI.
+    if (process.platform === 'linux') {
+        // These are environment variables that can indicate a running compositor on
+        // Linux.
+        const displayVariables = ['DISPLAY', 'WAYLAND_DISPLAY', 'MIR_SOCKET'];
+        const hasDisplay = displayVariables.some((v) => !!process.env[v]);
+        if (!hasDisplay) {
+            return false;
+        }
+    }
+    // If in an SSH session on a non-Linux OS (e.g., macOS), don't launch browser.
+    // The Linux case is handled above (it's allowed if DISPLAY is set).
+    if (isSSH && process.platform !== 'linux') {
+        return false;
+    }
+    // For non-Linux OSes, we generally assume a GUI is available
+    // unless other signals (like SSH) suggest otherwise.
+    // The `open` command's error handling will catch final edge cases.
+    return true;
+}
+//# sourceMappingURL=browser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/utils/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B;IACxC,wEAAwE;IACxE,4BAA4B;IAC5B,MAAM,gBAAgB,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,UAAU,IAAI,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,8EAA8E;IAC9E,IACE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,gBAAgB,EACnD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6DAA6D;IAC7D,qFAAqF;IACrF,6BAA6B;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE9C,6EAA6E;IAC7E,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,4EAA4E;QAC5E,SAAS;QACT,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,oEAAoE;IACpE,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6DAA6D;IAC7D,qDAAqD;IACrD,mEAAmE;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum ReleaseChannel {
+    NIGHTLY = "nightly",
+    PREVIEW = "preview",
+    STABLE = "stable"
+}
+/**
+ * Clears the cache for testing purposes.
+ * @private
+ */
+export declare function _clearCache(): void;
+export declare function getReleaseChannel(cwd: string): Promise<ReleaseChannel>;
+export declare function isNightly(cwd: string): Promise<boolean>;
+export declare function isPreview(cwd: string): Promise<boolean>;
+export declare function isStable(cwd: string): Promise<boolean>;

package/dist/src/utils/channel.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getPackageJson } from './package.js';
+export var ReleaseChannel;
+(function (ReleaseChannel) {
+    ReleaseChannel["NIGHTLY"] = "nightly";
+    ReleaseChannel["PREVIEW"] = "preview";
+    ReleaseChannel["STABLE"] = "stable";
+})(ReleaseChannel || (ReleaseChannel = {}));
+const cache = new Map();
+/**
+ * Clears the cache for testing purposes.
+ * @private
+ */
+export function _clearCache() {
+    cache.clear();
+}
+export async function getReleaseChannel(cwd) {
+    if (cache.has(cwd)) {
+        return cache.get(cwd);
+    }
+    const packageJson = await getPackageJson(cwd);
+    const version = packageJson?.version ?? '';
+    let channel;
+    if (version.includes('nightly') || version === '') {
+        channel = ReleaseChannel.NIGHTLY;
+    }
+    else if (version.includes('preview')) {
+        channel = ReleaseChannel.PREVIEW;
+    }
+    else {
+        channel = ReleaseChannel.STABLE;
+    }
+    cache.set(cwd, channel);
+    return channel;
+}
+export async function isNightly(cwd) {
+    return (await getReleaseChannel(cwd)) === ReleaseChannel.NIGHTLY;
+}
+export async function isPreview(cwd) {
+    return (await getReleaseChannel(cwd)) === ReleaseChannel.PREVIEW;
+}
+export async function isStable(cwd) {
+    return (await getReleaseChannel(cwd)) === ReleaseChannel.STABLE;
+}
+//# sourceMappingURL=channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/utils/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;IAE3C,IAAI,OAAuB,CAAC;IAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAClD,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IACnC,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GitService } from '../services/gitService.js';
+import type { GeminiClient } from '../core/client.js';
+import { z } from 'zod';
+import type { Content } from '@google/genai';
+import type { ToolCallRequestInfo } from '../scheduler/types.js';
+export interface ToolCallData<HistoryType = unknown, ArgsType = unknown> {
+    history?: HistoryType;
+    clientHistory?: Content[];
+    commitHash?: string;
+    toolCall: {
+        name: string;
+        args: ArgsType;
+    };
+    messageId?: string;
+}
+export declare function getToolCallDataSchema(historyItemSchema?: z.ZodTypeAny): z.ZodObject<{
+    history: z.ZodOptional<z.ZodArray<z.ZodTypeAny, "many">>;
+    clientHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        role: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        role: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    commitHash: z.ZodOptional<z.ZodString>;
+    toolCall: z.ZodObject<{
+        name: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        args: Record<string, unknown>;
+    }, {
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+    messageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    toolCall: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    history?: any[] | undefined;
+    clientHistory?: z.objectOutputType<{
+        role: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    commitHash?: string | undefined;
+    messageId?: string | undefined;
+}, {
+    toolCall: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    history?: any[] | undefined;
+    clientHistory?: z.objectInputType<{
+        role: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    commitHash?: string | undefined;
+    messageId?: string | undefined;
+}>;
+export declare function generateCheckpointFileName(toolCall: ToolCallRequestInfo): string | null;
+export declare function formatCheckpointDisplayList(filenames: string[]): string;
+export declare function getTruncatedCheckpointNames(filenames: string[]): string[];
+export declare function processRestorableToolCalls<HistoryType>(toolCalls: ToolCallRequestInfo[], gitService: GitService, geminiClient: GeminiClient, history?: HistoryType): Promise<{
+    checkpointsToWrite: Map<string, string>;
+    toolCallToCheckpointMap: Map<string, string>;
+    errors: string[];
+}>;
+export interface CheckpointInfo {
+    messageId: string;
+    checkpoint: string;
+}
+export declare function getCheckpointInfoList(checkpointFiles: Map<string, string>): CheckpointInfo[];

package/dist/src/utils/checkpointUtils.js

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import { getErrorMessage } from './errors.js';
+import { z } from 'zod';
+const ContentSchema = z
+    .object({
+    role: z.string().optional(),
+    parts: z.array(z.record(z.unknown())),
+})
+    .passthrough();
+export function getToolCallDataSchema(historyItemSchema) {
+    const schema = historyItemSchema ?? z.any();
+    return z.object({
+        history: z.array(schema).optional(),
+        clientHistory: z.array(ContentSchema).optional(),
+        commitHash: z.string().optional(),
+        toolCall: z.object({
+            name: z.string(),
+            args: z.record(z.unknown()),
+        }),
+        messageId: z.string().optional(),
+    });
+}
+export function generateCheckpointFileName(toolCall) {
+    const toolArgs = toolCall.args;
+    const toolFilePath = toolArgs['file_path'];
+    if (!toolFilePath) {
+        return null;
+    }
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/:/g, '-')
+        .replace(/\./g, '_');
+    const toolName = toolCall.name;
+    const fileName = path.basename(toolFilePath);
+    return `${timestamp}-${fileName}-${toolName}`;
+}
+export function formatCheckpointDisplayList(filenames) {
+    return getTruncatedCheckpointNames(filenames).join('\n');
+}
+export function getTruncatedCheckpointNames(filenames) {
+    return filenames.map((file) => {
+        const components = file.split('.');
+        if (components.length <= 1) {
+            return file;
+        }
+        components.pop();
+        return components.join('.');
+    });
+}
+export async function processRestorableToolCalls(toolCalls, gitService, geminiClient, history) {
+    const checkpointsToWrite = new Map();
+    const toolCallToCheckpointMap = new Map();
+    const errors = [];
+    for (const toolCall of toolCalls) {
+        try {
+            let commitHash;
+            try {
+                commitHash = await gitService.createFileSnapshot(`Snapshot for ${toolCall.name}`);
+            }
+            catch (error) {
+                errors.push(`Failed to create new snapshot for ${toolCall.name}: ${getErrorMessage(error)}. Attempting to use current commit.`);
+                commitHash = await gitService.getCurrentCommitHash();
+            }
+            if (!commitHash) {
+                errors.push(`Failed to create snapshot for ${toolCall.name}. Checkpointing may not be working properly. Ensure Git is installed and the project directory is accessible.`);
+                continue;
+            }
+            const checkpointFileName = generateCheckpointFileName(toolCall);
+            if (!checkpointFileName) {
+                errors.push(`Skipping restorable tool call due to missing file_path: ${toolCall.name}`);
+                continue;
+            }
+            const clientHistory = geminiClient.getHistory();
+            const checkpointData = {
+                history,
+                clientHistory,
+                toolCall: {
+                    name: toolCall.name,
+                    args: toolCall.args,
+                },
+                commitHash,
+                messageId: toolCall.prompt_id,
+            };
+            const fileName = `${checkpointFileName}.json`;
+            checkpointsToWrite.set(fileName, JSON.stringify(checkpointData, null, 2));
+            toolCallToCheckpointMap.set(toolCall.callId, fileName.replace('.json', ''));
+        }
+        catch (error) {
+            errors.push(`Failed to create checkpoint for ${toolCall.name}: ${getErrorMessage(error)}`);
+        }
+    }
+    return { checkpointsToWrite, toolCallToCheckpointMap, errors };
+}
+export function getCheckpointInfoList(checkpointFiles) {
+    const checkpointInfoList = [];
+    for (const [file, content] of checkpointFiles) {
+        try {
+            const toolCallData = JSON.parse(content);
+            if (toolCallData.messageId) {
+                checkpointInfoList.push({
+                    messageId: toolCallData.messageId,
+                    checkpoint: file.replace('.json', ''),
+                });
+            }
+        }
+        catch (_e) {
+            // Ignore invalid JSON files
+        }
+    }
+    return checkpointInfoList;
+}
+//# sourceMappingURL=checkpointUtils.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const REFERENCE_CONTENT_START = "--- Content from referenced files ---";
+export declare const REFERENCE_CONTENT_END = "--- End of content ---";

package/dist/src/utils/constants.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const REFERENCE_CONTENT_START = '--- Content from referenced files ---';
+export const REFERENCE_CONTENT_END = '--- End of content ---';
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,uCAAuC,CAAC;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * 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;;;;GAIG;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"}