@anthropic-field/core 0.1.0

package/dist/src/utils/filesearch/crawler.js

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import { fdir } from 'fdir';
+import * as cache from './crawlCache.js';
+function toPosixPath(p) {
+    return p.split(path.sep).join(path.posix.sep);
+}
+export async function crawl(options) {
+    if (options.cache) {
+        const cacheKey = cache.getCacheKey(options.crawlDirectory, options.ignore.getFingerprint(), options.maxDepth);
+        const cachedResults = cache.read(cacheKey);
+        if (cachedResults) {
+            return cachedResults;
+        }
+    }
+    const posixCwd = toPosixPath(options.cwd);
+    const posixCrawlDirectory = toPosixPath(options.crawlDirectory);
+    const maxFiles = options.maxFiles ?? Infinity;
+    let fileCount = 0;
+    let truncated = false;
+    let results;
+    try {
+        const dirFilter = options.ignore.getDirectoryFilter();
+        const api = new fdir()
+            .withRelativePaths()
+            .withDirs()
+            .withPathSeparator('/') // Always use unix style paths
+            .filter((path, isDirectory) => {
+            if (!isDirectory) {
+                fileCount++;
+                if (fileCount > maxFiles) {
+                    truncated = true;
+                    return false;
+                }
+            }
+            return true;
+        })
+            .exclude((_, dirPath) => {
+            if (fileCount > maxFiles) {
+                truncated = true;
+                return true;
+            }
+            const relativePath = path.posix.relative(posixCrawlDirectory, dirPath);
+            return dirFilter(`${relativePath}/`);
+        });
+        if (options.maxDepth !== undefined) {
+            api.withMaxDepth(options.maxDepth);
+        }
+        results = await api.crawl(options.crawlDirectory).withPromise();
+    }
+    catch (_e) {
+        // The directory probably doesn't exist.
+        return [];
+    }
+    const relativeToCrawlDir = path.posix.relative(posixCwd, posixCrawlDirectory);
+    const relativeToCwdResults = results.map((p) => path.posix.join(relativeToCrawlDir, p));
+    if (options.cache && !truncated) {
+        const cacheKey = cache.getCacheKey(options.crawlDirectory, options.ignore.getFingerprint(), options.maxDepth);
+        cache.write(cacheKey, relativeToCwdResults, options.cacheTtl * 1000);
+    }
+    return relativeToCwdResults;
+}
+//# sourceMappingURL=crawler.js.map

package/dist/src/utils/filesearch/crawler.js.map

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

package/dist/src/utils/filesearch/fileSearch.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../../services/fileDiscoveryService.js';
+export interface FileSearchOptions {
+    projectRoot: string;
+    ignoreDirs: string[];
+    fileDiscoveryService: FileDiscoveryService;
+    cache: boolean;
+    cacheTtl: number;
+    enableRecursiveFileSearch: boolean;
+    enableFuzzySearch: boolean;
+    maxDepth?: number;
+    maxFiles?: number;
+}
+export declare class AbortError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Filters a list of paths based on a given pattern.
+ * @param allPaths The list of all paths to filter.
+ * @param pattern The picomatch pattern to filter by.
+ * @param signal An AbortSignal to cancel the operation.
+ * @returns A promise that resolves to the filtered and sorted list of paths.
+ */
+export declare function filter(allPaths: string[], pattern: string, signal: AbortSignal | undefined): Promise<string[]>;
+export interface SearchOptions {
+    signal?: AbortSignal;
+    maxResults?: number;
+}
+export interface FileSearch {
+    initialize(): Promise<void>;
+    search(pattern: string, options?: SearchOptions): Promise<string[]>;
+}
+export declare class FileSearchFactory {
+    static create(options: FileSearchOptions): FileSearch;
+}

package/dist/src/utils/filesearch/fileSearch.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import picomatch from 'picomatch';
+import { loadIgnoreRules } from './ignore.js';
+import { ResultCache } from './result-cache.js';
+import { crawl } from './crawler.js';
+import { AsyncFzf } from 'fzf';
+import { unescapePath } from '../paths.js';
+export class AbortError extends Error {
+    constructor(message = 'Search aborted') {
+        super(message);
+        this.name = 'AbortError';
+    }
+}
+/**
+ * Filters a list of paths based on a given pattern.
+ * @param allPaths The list of all paths to filter.
+ * @param pattern The picomatch pattern to filter by.
+ * @param signal An AbortSignal to cancel the operation.
+ * @returns A promise that resolves to the filtered and sorted list of paths.
+ */
+export async function filter(allPaths, pattern, signal) {
+    const patternFilter = picomatch(pattern, {
+        dot: true,
+        contains: true,
+        nocase: true,
+    });
+    const results = [];
+    for (const [i, p] of allPaths.entries()) {
+        // Yield control to the event loop periodically to prevent blocking.
+        if (i % 1000 === 0) {
+            await new Promise((resolve) => setImmediate(resolve));
+            if (signal?.aborted) {
+                throw new AbortError();
+            }
+        }
+        if (patternFilter(p)) {
+            results.push(p);
+        }
+    }
+    results.sort((a, b) => {
+        const aIsDir = a.endsWith('/');
+        const bIsDir = b.endsWith('/');
+        if (aIsDir && !bIsDir)
+            return -1;
+        if (!aIsDir && bIsDir)
+            return 1;
+        // This is 40% faster than localeCompare and the only thing we would really
+        // gain from localeCompare is case-sensitive sort
+        return a < b ? -1 : a > b ? 1 : 0;
+    });
+    return results;
+}
+class RecursiveFileSearch {
+    options;
+    ignore;
+    resultCache;
+    allFiles = [];
+    fzf;
+    constructor(options) {
+        this.options = options;
+    }
+    async initialize() {
+        this.ignore = loadIgnoreRules(this.options.fileDiscoveryService, this.options.ignoreDirs);
+        this.allFiles = await crawl({
+            crawlDirectory: this.options.projectRoot,
+            cwd: this.options.projectRoot,
+            ignore: this.ignore,
+            cache: this.options.cache,
+            cacheTtl: this.options.cacheTtl,
+            maxDepth: this.options.maxDepth,
+            maxFiles: this.options.maxFiles ?? 20000,
+        });
+        this.buildResultCache();
+    }
+    async search(pattern, options = {}) {
+        if (!this.resultCache ||
+            (!this.fzf && this.options.enableFuzzySearch) ||
+            !this.ignore) {
+            throw new Error('Engine not initialized. Call initialize() first.');
+        }
+        pattern = unescapePath(pattern) || '*';
+        let filteredCandidates;
+        const { files: candidates, isExactMatch } = await this.resultCache.get(pattern);
+        if (isExactMatch) {
+            // Use the cached result.
+            filteredCandidates = candidates;
+        }
+        else {
+            let shouldCache = true;
+            if (pattern.includes('*') || !this.fzf) {
+                filteredCandidates = await filter(candidates, pattern, options.signal);
+            }
+            else {
+                filteredCandidates = await this.fzf
+                    .find(pattern)
+                    .then((results) => results.map((entry) => entry.item))
+                    .catch(() => {
+                    shouldCache = false;
+                    return [];
+                });
+            }
+            if (shouldCache) {
+                this.resultCache.set(pattern, filteredCandidates);
+            }
+        }
+        const fileFilter = this.ignore.getFileFilter();
+        const results = [];
+        for (const [i, candidate] of filteredCandidates.entries()) {
+            if (i % 1000 === 0) {
+                await new Promise((resolve) => setImmediate(resolve));
+                if (options.signal?.aborted) {
+                    throw new AbortError();
+                }
+            }
+            if (results.length >= (options.maxResults ?? Infinity)) {
+                break;
+            }
+            if (candidate === '.') {
+                continue;
+            }
+            if (!fileFilter(candidate)) {
+                results.push(candidate);
+            }
+        }
+        return results;
+    }
+    buildResultCache() {
+        this.resultCache = new ResultCache(this.allFiles);
+        if (this.options.enableFuzzySearch) {
+            // The v1 algorithm is much faster since it only looks at the first
+            // occurrence of the pattern. We use it for search spaces that have >20k
+            // files, because the v2 algorithm is just too slow in those cases.
+            this.fzf = new AsyncFzf(this.allFiles, {
+                fuzzy: this.allFiles.length > 20000 ? 'v1' : 'v2',
+            });
+        }
+    }
+}
+class DirectoryFileSearch {
+    options;
+    ignore;
+    constructor(options) {
+        this.options = options;
+    }
+    async initialize() {
+        this.ignore = loadIgnoreRules(this.options.fileDiscoveryService, this.options.ignoreDirs);
+    }
+    async search(pattern, options = {}) {
+        if (!this.ignore) {
+            throw new Error('Engine not initialized. Call initialize() first.');
+        }
+        pattern = pattern || '*';
+        const dir = pattern.endsWith('/') ? pattern : path.dirname(pattern);
+        const results = await crawl({
+            crawlDirectory: path.join(this.options.projectRoot, dir),
+            cwd: this.options.projectRoot,
+            maxDepth: 0,
+            ignore: this.ignore,
+            cache: this.options.cache,
+            cacheTtl: this.options.cacheTtl,
+        });
+        const filteredResults = await filter(results, pattern, options.signal);
+        const fileFilter = this.ignore.getFileFilter();
+        const finalResults = [];
+        for (const candidate of filteredResults) {
+            if (finalResults.length >= (options.maxResults ?? Infinity)) {
+                break;
+            }
+            if (candidate === '.') {
+                continue;
+            }
+            if (!fileFilter(candidate)) {
+                finalResults.push(candidate);
+            }
+        }
+        return finalResults;
+    }
+}
+export class FileSearchFactory {
+    static create(options) {
+        if (options.enableRecursiveFileSearch) {
+            return new RecursiveFileSearch(options);
+        }
+        return new DirectoryFileSearch(options);
+    }
+}
+//# sourceMappingURL=fileSearch.js.map

package/dist/src/utils/filesearch/fileSearch.js.map

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

package/dist/src/utils/filesearch/ignore.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../../services/fileDiscoveryService.js';
+export declare function loadIgnoreRules(service: FileDiscoveryService, ignoreDirs?: string[]): Ignore;
+export declare class Ignore {
+    private readonly allPatterns;
+    private dirIgnorer;
+    private fileIgnorer;
+    /**
+     * Adds one or more ignore patterns.
+     * @param patterns A single pattern string or an array of pattern strings.
+     *                 Each pattern can be a glob-like string similar to .gitignore rules.
+     * @returns The `Ignore` instance for chaining.
+     */
+    add(patterns: string | string[]): this;
+    /**
+     * Returns a predicate that matches explicit directory ignore patterns (patterns ending with '/').
+     * @returns {(dirPath: string) => boolean}
+     */
+    getDirectoryFilter(): (dirPath: string) => boolean;
+    /**
+     * Returns a predicate that matches file ignore patterns (all patterns not ending with '/').
+     * Note: This may also match directories if a file pattern matches a directory name, but all explicit directory patterns are handled by getDirectoryFilter.
+     * @returns {(filePath: string) => boolean}
+     */
+    getFileFilter(): (filePath: string) => boolean;
+    /**
+     * Returns a string representing the current set of ignore patterns.
+     * This can be used to generate a unique identifier for the ignore configuration,
+     * useful for caching purposes.
+     * @returns A string fingerprint of the ignore patterns.
+     */
+    getFingerprint(): string;
+}

package/dist/src/utils/filesearch/ignore.js

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import ignore from 'ignore';
+import picomatch from 'picomatch';
+const hasFileExtension = picomatch('**/*[*.]*');
+export function loadIgnoreRules(service, ignoreDirs = []) {
+    const ignorer = new Ignore();
+    const ignoreFiles = service.getAllIgnoreFilePaths();
+    for (const filePath of ignoreFiles) {
+        if (fs.existsSync(filePath)) {
+            ignorer.add(fs.readFileSync(filePath, 'utf8'));
+        }
+    }
+    const allIgnoreDirs = ['.git', ...ignoreDirs];
+    ignorer.add(allIgnoreDirs.map((dir) => {
+        if (dir.endsWith('/')) {
+            return dir;
+        }
+        return `${dir}/`;
+    }));
+    return ignorer;
+}
+export class Ignore {
+    allPatterns = [];
+    dirIgnorer = ignore();
+    fileIgnorer = ignore();
+    /**
+     * Adds one or more ignore patterns.
+     * @param patterns A single pattern string or an array of pattern strings.
+     *                 Each pattern can be a glob-like string similar to .gitignore rules.
+     * @returns The `Ignore` instance for chaining.
+     */
+    add(patterns) {
+        if (typeof patterns === 'string') {
+            patterns = patterns.split(/\r?\n/);
+        }
+        for (const p of patterns) {
+            const pattern = p.trim();
+            if (pattern === '' || pattern.startsWith('#')) {
+                continue;
+            }
+            this.allPatterns.push(pattern);
+            const isPositiveDirPattern = pattern.endsWith('/') && !pattern.startsWith('!');
+            if (isPositiveDirPattern) {
+                this.dirIgnorer.add(pattern);
+            }
+            else {
+                // An ambiguous pattern (e.g., "build") could match a file or a
+                // directory. To optimize the file system crawl, we use a heuristic:
+                // patterns without a dot in the last segment are included in the
+                // directory exclusion check.
+                //
+                // This heuristic can fail. For example, an ignore pattern of "my.assets"
+                // intended to exclude a directory will not be treated as a directory
+                // pattern because it contains a ".". This results in crawling a
+                // directory that should have been excluded, reducing efficiency.
+                // Correctness is still maintained. The incorrectly crawled directory
+                // will be filtered out by the final ignore check.
+                //
+                // For maximum crawl efficiency, users should explicitly mark directory
+                // patterns with a trailing slash (e.g., "my.assets/").
+                this.fileIgnorer.add(pattern);
+                if (!hasFileExtension(pattern)) {
+                    this.dirIgnorer.add(pattern);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Returns a predicate that matches explicit directory ignore patterns (patterns ending with '/').
+     * @returns {(dirPath: string) => boolean}
+     */
+    getDirectoryFilter() {
+        return (dirPath) => this.dirIgnorer.ignores(dirPath);
+    }
+    /**
+     * Returns a predicate that matches file ignore patterns (all patterns not ending with '/').
+     * Note: This may also match directories if a file pattern matches a directory name, but all explicit directory patterns are handled by getDirectoryFilter.
+     * @returns {(filePath: string) => boolean}
+     */
+    getFileFilter() {
+        return (filePath) => this.fileIgnorer.ignores(filePath);
+    }
+    /**
+     * Returns a string representing the current set of ignore patterns.
+     * This can be used to generate a unique identifier for the ignore configuration,
+     * useful for caching purposes.
+     * @returns A string fingerprint of the ignore patterns.
+     */
+    getFingerprint() {
+        return this.allPatterns.join('\n');
+    }
+}
+//# sourceMappingURL=ignore.js.map

package/dist/src/utils/filesearch/ignore.js.map

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

package/dist/src/utils/filesearch/result-cache.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Implements an in-memory cache for file search results.
+ * This cache optimizes subsequent searches by leveraging previously computed results.
+ */
+export declare class ResultCache {
+    private readonly allFiles;
+    private readonly cache;
+    private hits;
+    private misses;
+    constructor(allFiles: string[]);
+    /**
+     * Retrieves cached search results for a given query, or provides a base set
+     * of files to search from.
+     * @param query The search query pattern.
+     * @returns An object containing the files to search and a boolean indicating
+     *          if the result is an exact cache hit.
+     */
+    get(query: string): Promise<{
+        files: string[];
+        isExactMatch: boolean;
+    }>;
+    /**
+     * Stores search results in the cache.
+     * @param query The search query pattern.
+     * @param results The matching file paths to cache.
+     */
+    set(query: string, results: string[]): void;
+}

package/dist/src/utils/filesearch/result-cache.js

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Implements an in-memory cache for file search results.
+ * This cache optimizes subsequent searches by leveraging previously computed results.
+ */
+export class ResultCache {
+    allFiles;
+    cache;
+    hits = 0;
+    misses = 0;
+    constructor(allFiles) {
+        this.allFiles = allFiles;
+        this.cache = new Map();
+    }
+    /**
+     * Retrieves cached search results for a given query, or provides a base set
+     * of files to search from.
+     * @param query The search query pattern.
+     * @returns An object containing the files to search and a boolean indicating
+     *          if the result is an exact cache hit.
+     */
+    async get(query) {
+        const isCacheHit = this.cache.has(query);
+        if (isCacheHit) {
+            this.hits++;
+            return { files: this.cache.get(query), isExactMatch: true };
+        }
+        this.misses++;
+        // This is the core optimization of the memory cache.
+        // If a user first searches for "foo", and then for "foobar",
+        // we don't need to search through all files again. We can start
+        // from the results of the "foo" search.
+        // This finds the most specific, already-cached query that is a prefix
+        // of the current query.
+        let bestBaseQuery = '';
+        for (const key of this.cache?.keys?.() ?? []) {
+            if (query.startsWith(key) && key.length > bestBaseQuery.length) {
+                bestBaseQuery = key;
+            }
+        }
+        const filesToSearch = bestBaseQuery
+            ? this.cache.get(bestBaseQuery)
+            : this.allFiles;
+        return { files: filesToSearch, isExactMatch: false };
+    }
+    /**
+     * Stores search results in the cache.
+     * @param query The search query pattern.
+     * @param results The matching file paths to cache.
+     */
+    set(query, results) {
+        this.cache.set(query, results);
+    }
+}
+//# sourceMappingURL=result-cache.js.map

package/dist/src/utils/filesearch/result-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-cache.js","sourceRoot":"","sources":["../../../../src/utils/filesearch/result-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,OAAO,WAAW;IAKO;IAJZ,KAAK,CAAwB;IACtC,IAAI,GAAG,CAAC,CAAC;IACT,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CACP,KAAa;QAEb,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,qDAAqD;QACrD,6DAA6D;QAC7D,gEAAgE;QAChE,wCAAwC;QACxC,sEAAsE;QACtE,wBAAwB;QACxB,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;gBAC/D,aAAa,GAAG,GAAG,CAAC;YACtB,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,aAAa;YACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAE;YAChC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QAElB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,KAAa,EAAE,OAAiB;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const bytesToMB: (bytes: number) => number;
+export declare const formatBytes: (bytes: number) => string;

package/dist/src/utils/formatters.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const bytesToMB = (bytes) => bytes / (1024 * 1024);
+export const formatBytes = (bytes) => {
+    const gb = bytes / (1024 * 1024 * 1024);
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    if (bytes < 1024 * 1024 * 1024) {
+        return `${bytesToMB(bytes).toFixed(1)} MB`;
+    }
+    return `${gb.toFixed(2)} GB`;
+};
+//# sourceMappingURL=formatters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACnD,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QAC/B,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/B,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, Part, FunctionCall, PartListUnion } from '@google/genai';
+export declare function convertToFunctionResponse(toolName: string, callId: string, llmContent: PartListUnion, model: string): Part[];
+export declare function getResponseTextFromParts(parts: Part[]): string | undefined;
+export declare function getFunctionCalls(response: GenerateContentResponse): FunctionCall[] | undefined;
+export declare function getFunctionCallsFromParts(parts: Part[]): FunctionCall[] | undefined;
+export declare function getFunctionCallsAsJson(response: GenerateContentResponse): string | undefined;
+export declare function getFunctionCallsFromPartsAsJson(parts: Part[]): string | undefined;
+export declare function getStructuredResponse(response: GenerateContentResponse): string | undefined;
+export declare function getStructuredResponseFromParts(parts: Part[]): string | undefined;
+export declare function getCitations(resp: GenerateContentResponse): string[];