@google/gemini-cli-core 0.0.1

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface GeminiIgnoreFilter {
+    isIgnored(filePath: string): boolean;
+    getPatterns(): string[];
+}
+export declare class GeminiIgnoreParser implements GeminiIgnoreFilter {
+    private projectRoot;
+    private patterns;
+    private ig;
+    constructor(projectRoot: string);
+    private loadPatterns;
+    isIgnored(filePath: string): boolean;
+    getPatterns(): string[];
+}

package/dist/src/utils/geminiIgnoreParser.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ignore from 'ignore';
+export class GeminiIgnoreParser {
+    projectRoot;
+    patterns = [];
+    ig = ignore();
+    constructor(projectRoot) {
+        this.projectRoot = path.resolve(projectRoot);
+        this.loadPatterns();
+    }
+    loadPatterns() {
+        const patternsFilePath = path.join(this.projectRoot, '.geminiignore');
+        let content;
+        try {
+            content = fs.readFileSync(patternsFilePath, 'utf-8');
+        }
+        catch (_error) {
+            // ignore file not found
+            return;
+        }
+        this.patterns = (content ?? '')
+            .split('\n')
+            .map((p) => p.trim())
+            .filter((p) => p !== '' && !p.startsWith('#'));
+        this.ig.add(this.patterns);
+    }
+    isIgnored(filePath) {
+        if (this.patterns.length === 0) {
+            return false;
+        }
+        if (!filePath || typeof filePath !== 'string') {
+            return false;
+        }
+        if (filePath.startsWith('\\') ||
+            filePath === '/' ||
+            filePath.includes('\0')) {
+            return false;
+        }
+        const resolved = path.resolve(this.projectRoot, filePath);
+        const relativePath = path.relative(this.projectRoot, resolved);
+        if (relativePath === '' || relativePath.startsWith('..')) {
+            return false;
+        }
+        // Even in windows, Ignore expects forward slashes.
+        const normalizedPath = relativePath.replace(/\\/g, '/');
+        if (normalizedPath.startsWith('/') || normalizedPath === '') {
+            return false;
+        }
+        return this.ig.ignores(normalizedPath);
+    }
+    getPatterns() {
+        return this.patterns;
+    }
+}
+//# sourceMappingURL=geminiIgnoreParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geminiIgnoreParser.js","sourceRoot":"","sources":["../../../src/utils/geminiIgnoreParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAO5B,MAAM,OAAO,kBAAkB;IACrB,WAAW,CAAS;IACpB,QAAQ,GAAa,EAAE,CAAC;IACxB,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtB,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEO,YAAY;QAClB,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACtE,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,wBAAwB;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;aAC5B,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjD,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IACE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YACzB,QAAQ,KAAK,GAAG;YAChB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EACvB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE/D,IAAI,YAAY,KAAK,EAAE,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mDAAmD;QACnD,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAExD,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { GeminiIgnoreParser } from './geminiIgnoreParser.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+describe('GeminiIgnoreParser', () => {
+    let projectRoot;
+    async function createTestFile(filePath, content = '') {
+        const fullPath = path.join(projectRoot, filePath);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, content);
+    }
+    beforeEach(async () => {
+        projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'geminiignore-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(projectRoot, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    describe('when .geminiignore exists', () => {
+        beforeEach(async () => {
+            await createTestFile('.geminiignore', 'ignored.txt\n# A comment\n/ignored_dir/\n');
+            await createTestFile('ignored.txt', 'ignored');
+            await createTestFile('not_ignored.txt', 'not ignored');
+            await createTestFile(path.join('ignored_dir', 'file.txt'), 'in ignored dir');
+            await createTestFile(path.join('subdir', 'not_ignored.txt'), 'not ignored');
+        });
+        it('should ignore files specified in .geminiignore', () => {
+            const parser = new GeminiIgnoreParser(projectRoot);
+            expect(parser.getPatterns()).toEqual(['ignored.txt', '/ignored_dir/']);
+            expect(parser.isIgnored('ignored.txt')).toBe(true);
+            expect(parser.isIgnored('not_ignored.txt')).toBe(false);
+            expect(parser.isIgnored(path.join('ignored_dir', 'file.txt'))).toBe(true);
+            expect(parser.isIgnored(path.join('subdir', 'not_ignored.txt'))).toBe(false);
+        });
+    });
+    describe('when .geminiignore does not exist', () => {
+        it('should not load any patterns and not ignore any files', () => {
+            const parser = new GeminiIgnoreParser(projectRoot);
+            expect(parser.getPatterns()).toEqual([]);
+            expect(parser.isIgnored('any_file.txt')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=geminiIgnoreParser.test.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, Part, FunctionCall } from '@google/genai';
+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;

package/dist/src/utils/generateContentResponseUtilities.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getResponseText } from './partUtils.js';
+export function getResponseTextFromParts(parts) {
+    if (!parts) {
+        return undefined;
+    }
+    const textSegments = parts
+        .map((part) => part.text)
+        .filter((text) => typeof text === 'string');
+    if (textSegments.length === 0) {
+        return undefined;
+    }
+    return textSegments.join('');
+}
+export function getFunctionCalls(response) {
+    const parts = response.candidates?.[0]?.content?.parts;
+    if (!parts) {
+        return undefined;
+    }
+    const functionCallParts = parts
+        .filter((part) => !!part.functionCall)
+        .map((part) => part.functionCall);
+    return functionCallParts.length > 0 ? functionCallParts : undefined;
+}
+export function getFunctionCallsFromParts(parts) {
+    if (!parts) {
+        return undefined;
+    }
+    const functionCallParts = parts
+        .filter((part) => !!part.functionCall)
+        .map((part) => part.functionCall);
+    return functionCallParts.length > 0 ? functionCallParts : undefined;
+}
+export function getFunctionCallsAsJson(response) {
+    const functionCalls = getFunctionCalls(response);
+    if (!functionCalls) {
+        return undefined;
+    }
+    return JSON.stringify(functionCalls, null, 2);
+}
+export function getFunctionCallsFromPartsAsJson(parts) {
+    const functionCalls = getFunctionCallsFromParts(parts);
+    if (!functionCalls) {
+        return undefined;
+    }
+    return JSON.stringify(functionCalls, null, 2);
+}
+export function getStructuredResponse(response) {
+    const textContent = getResponseText(response);
+    const functionCallsJson = getFunctionCallsAsJson(response);
+    if (textContent && functionCallsJson) {
+        return `${textContent}\n${functionCallsJson}`;
+    }
+    if (textContent) {
+        return textContent;
+    }
+    if (functionCallsJson) {
+        return functionCallsJson;
+    }
+    return undefined;
+}
+export function getStructuredResponseFromParts(parts) {
+    const textContent = getResponseTextFromParts(parts);
+    const functionCallsJson = getFunctionCallsFromPartsAsJson(parts);
+    if (textContent && functionCallsJson) {
+        return `${textContent}\n${functionCallsJson}`;
+    }
+    if (textContent) {
+        return textContent;
+    }
+    if (functionCallsJson) {
+        return functionCallsJson;
+    }
+    return undefined;
+}
+//# sourceMappingURL=generateContentResponseUtilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateContentResponseUtilities.js","sourceRoot":"","sources":["../../../src/utils/generateContentResponseUtilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,YAAY,GAAG,KAAK;SACvB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IAE9D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAiC;IAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,iBAAiB,GAAG,KAAK;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAA4B,CAAC,CAAC;IACpD,OAAO,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAa;IAEb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,iBAAiB,GAAG,KAAK;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAA4B,CAAC,CAAC;IACpD,OAAO,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAiC;IAEjC,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAa;IAEb,MAAM,aAAa,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAiC;IAEjC,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAE3D,IAAI,WAAW,IAAI,iBAAiB,EAAE,CAAC;QACrC,OAAO,GAAG,WAAW,KAAK,iBAAiB,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAa;IAEb,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;IAEjE,IAAI,WAAW,IAAI,iBAAiB,EAAE,CAAC;QACrC,OAAO,GAAG,WAAW,KAAK,iBAAiB,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

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

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

@@ -0,0 +1,235 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { getResponseTextFromParts, getFunctionCalls, getFunctionCallsFromParts, getFunctionCallsAsJson, getFunctionCallsFromPartsAsJson, getStructuredResponse, getStructuredResponseFromParts, } from './generateContentResponseUtilities.js';
+import { FinishReason } from '@google/genai';
+const mockTextPart = (text) => ({ text });
+const mockFunctionCallPart = (name, args) => ({
+    functionCall: { name, args: args ?? {} },
+});
+const mockResponse = (parts, finishReason = FinishReason.STOP, safetyRatings = []) => ({
+    candidates: [
+        {
+            content: {
+                parts,
+                role: 'model',
+            },
+            index: 0,
+            finishReason,
+            safetyRatings,
+        },
+    ],
+    promptFeedback: {
+        safetyRatings: [],
+    },
+    text: undefined,
+    data: undefined,
+    functionCalls: undefined,
+    executableCode: undefined,
+    codeExecutionResult: undefined,
+});
+const minimalMockResponse = (candidates) => ({
+    candidates,
+    promptFeedback: { safetyRatings: [] },
+    text: undefined,
+    data: undefined,
+    functionCalls: undefined,
+    executableCode: undefined,
+    codeExecutionResult: undefined,
+});
+describe('generateContentResponseUtilities', () => {
+    describe('getResponseTextFromParts', () => {
+        it('should return undefined for no parts', () => {
+            expect(getResponseTextFromParts([])).toBeUndefined();
+        });
+        it('should extract text from a single text part', () => {
+            expect(getResponseTextFromParts([mockTextPart('Hello')])).toBe('Hello');
+        });
+        it('should concatenate text from multiple text parts', () => {
+            expect(getResponseTextFromParts([
+                mockTextPart('Hello '),
+                mockTextPart('World'),
+            ])).toBe('Hello World');
+        });
+        it('should ignore function call parts', () => {
+            expect(getResponseTextFromParts([
+                mockTextPart('Hello '),
+                mockFunctionCallPart('testFunc'),
+                mockTextPart('World'),
+            ])).toBe('Hello World');
+        });
+        it('should return undefined if only function call parts exist', () => {
+            expect(getResponseTextFromParts([
+                mockFunctionCallPart('testFunc'),
+                mockFunctionCallPart('anotherFunc'),
+            ])).toBeUndefined();
+        });
+    });
+    describe('getFunctionCalls', () => {
+        it('should return undefined for no candidates', () => {
+            expect(getFunctionCalls(minimalMockResponse(undefined))).toBeUndefined();
+        });
+        it('should return undefined for empty candidates array', () => {
+            expect(getFunctionCalls(minimalMockResponse([]))).toBeUndefined();
+        });
+        it('should return undefined for no parts', () => {
+            const response = mockResponse([]);
+            expect(getFunctionCalls(response)).toBeUndefined();
+        });
+        it('should extract a single function call', () => {
+            const func = { name: 'testFunc', args: { a: 1 } };
+            const response = mockResponse([
+                mockFunctionCallPart(func.name, func.args),
+            ]);
+            expect(getFunctionCalls(response)).toEqual([func]);
+        });
+        it('should extract multiple function calls', () => {
+            const func1 = { name: 'testFunc1', args: { a: 1 } };
+            const func2 = { name: 'testFunc2', args: { b: 2 } };
+            const response = mockResponse([
+                mockFunctionCallPart(func1.name, func1.args),
+                mockFunctionCallPart(func2.name, func2.args),
+            ]);
+            expect(getFunctionCalls(response)).toEqual([func1, func2]);
+        });
+        it('should ignore text parts', () => {
+            const func = { name: 'testFunc', args: { a: 1 } };
+            const response = mockResponse([
+                mockTextPart('Some text'),
+                mockFunctionCallPart(func.name, func.args),
+                mockTextPart('More text'),
+            ]);
+            expect(getFunctionCalls(response)).toEqual([func]);
+        });
+        it('should return undefined if only text parts exist', () => {
+            const response = mockResponse([
+                mockTextPart('Some text'),
+                mockTextPart('More text'),
+            ]);
+            expect(getFunctionCalls(response)).toBeUndefined();
+        });
+    });
+    describe('getFunctionCallsFromParts', () => {
+        it('should return undefined for no parts', () => {
+            expect(getFunctionCallsFromParts([])).toBeUndefined();
+        });
+        it('should extract a single function call', () => {
+            const func = { name: 'testFunc', args: { a: 1 } };
+            expect(getFunctionCallsFromParts([mockFunctionCallPart(func.name, func.args)])).toEqual([func]);
+        });
+        it('should extract multiple function calls', () => {
+            const func1 = { name: 'testFunc1', args: { a: 1 } };
+            const func2 = { name: 'testFunc2', args: { b: 2 } };
+            expect(getFunctionCallsFromParts([
+                mockFunctionCallPart(func1.name, func1.args),
+                mockFunctionCallPart(func2.name, func2.args),
+            ])).toEqual([func1, func2]);
+        });
+        it('should ignore text parts', () => {
+            const func = { name: 'testFunc', args: { a: 1 } };
+            expect(getFunctionCallsFromParts([
+                mockTextPart('Some text'),
+                mockFunctionCallPart(func.name, func.args),
+                mockTextPart('More text'),
+            ])).toEqual([func]);
+        });
+        it('should return undefined if only text parts exist', () => {
+            expect(getFunctionCallsFromParts([
+                mockTextPart('Some text'),
+                mockTextPart('More text'),
+            ])).toBeUndefined();
+        });
+    });
+    describe('getFunctionCallsAsJson', () => {
+        it('should return JSON string of function calls', () => {
+            const func1 = { name: 'testFunc1', args: { a: 1 } };
+            const func2 = { name: 'testFunc2', args: { b: 2 } };
+            const response = mockResponse([
+                mockFunctionCallPart(func1.name, func1.args),
+                mockTextPart('text in between'),
+                mockFunctionCallPart(func2.name, func2.args),
+            ]);
+            const expectedJson = JSON.stringify([func1, func2], null, 2);
+            expect(getFunctionCallsAsJson(response)).toBe(expectedJson);
+        });
+        it('should return undefined if no function calls', () => {
+            const response = mockResponse([mockTextPart('Hello')]);
+            expect(getFunctionCallsAsJson(response)).toBeUndefined();
+        });
+    });
+    describe('getFunctionCallsFromPartsAsJson', () => {
+        it('should return JSON string of function calls from parts', () => {
+            const func1 = { name: 'testFunc1', args: { a: 1 } };
+            const func2 = { name: 'testFunc2', args: { b: 2 } };
+            const parts = [
+                mockFunctionCallPart(func1.name, func1.args),
+                mockTextPart('text in between'),
+                mockFunctionCallPart(func2.name, func2.args),
+            ];
+            const expectedJson = JSON.stringify([func1, func2], null, 2);
+            expect(getFunctionCallsFromPartsAsJson(parts)).toBe(expectedJson);
+        });
+        it('should return undefined if no function calls in parts', () => {
+            const parts = [mockTextPart('Hello')];
+            expect(getFunctionCallsFromPartsAsJson(parts)).toBeUndefined();
+        });
+    });
+    describe('getStructuredResponse', () => {
+        it('should return only text if only text exists', () => {
+            const response = mockResponse([mockTextPart('Hello World')]);
+            expect(getStructuredResponse(response)).toBe('Hello World');
+        });
+        it('should return only function call JSON if only function calls exist', () => {
+            const func = { name: 'testFunc', args: { data: 'payload' } };
+            const response = mockResponse([
+                mockFunctionCallPart(func.name, func.args),
+            ]);
+            const expectedJson = JSON.stringify([func], null, 2);
+            expect(getStructuredResponse(response)).toBe(expectedJson);
+        });
+        it('should return text and function call JSON if both exist', () => {
+            const text = 'Consider this data:';
+            const func = { name: 'processData', args: { item: 42 } };
+            const response = mockResponse([
+                mockTextPart(text),
+                mockFunctionCallPart(func.name, func.args),
+            ]);
+            const expectedJson = JSON.stringify([func], null, 2);
+            expect(getStructuredResponse(response)).toBe(`${text}\n${expectedJson}`);
+        });
+        it('should return undefined if neither text nor function calls exist', () => {
+            const response = mockResponse([]);
+            expect(getStructuredResponse(response)).toBeUndefined();
+        });
+    });
+    describe('getStructuredResponseFromParts', () => {
+        it('should return only text if only text exists in parts', () => {
+            const parts = [mockTextPart('Hello World')];
+            expect(getStructuredResponseFromParts(parts)).toBe('Hello World');
+        });
+        it('should return only function call JSON if only function calls exist in parts', () => {
+            const func = { name: 'testFunc', args: { data: 'payload' } };
+            const parts = [mockFunctionCallPart(func.name, func.args)];
+            const expectedJson = JSON.stringify([func], null, 2);
+            expect(getStructuredResponseFromParts(parts)).toBe(expectedJson);
+        });
+        it('should return text and function call JSON if both exist in parts', () => {
+            const text = 'Consider this data:';
+            const func = { name: 'processData', args: { item: 42 } };
+            const parts = [
+                mockTextPart(text),
+                mockFunctionCallPart(func.name, func.args),
+            ];
+            const expectedJson = JSON.stringify([func], null, 2);
+            expect(getStructuredResponseFromParts(parts)).toBe(`${text}\n${expectedJson}`);
+        });
+        it('should return undefined if neither text nor function calls exist in parts', () => {
+            const parts = [];
+            expect(getStructuredResponseFromParts(parts)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=generateContentResponseUtilities.test.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import type { FileFilteringOptions } from '../config/config.js';
+/** Options for customizing folder structure retrieval. */
+interface FolderStructureOptions {
+    /** Maximum number of files and folders combined to display. Defaults to 200. */
+    maxItems?: number;
+    /** Set of folder names to ignore completely. Case-sensitive. */
+    ignoredFolders?: Set<string>;
+    /** Optional regex to filter included files by name. */
+    fileIncludePattern?: RegExp;
+    /** For filtering files. */
+    fileService?: FileDiscoveryService;
+    /** File filtering ignore options. */
+    fileFilteringOptions?: FileFilteringOptions;
+}
+/**
+ * Generates a string representation of a directory's structure,
+ * limiting the number of items displayed. Ignored folders are shown
+ * followed by '...' instead of their contents.
+ *
+ * @param directory The absolute or relative path to the directory.
+ * @param options Optional configuration settings.
+ * @returns A promise resolving to the formatted folder structure string.
+ */
+export declare function getFolderStructure(directory: string, options?: FolderStructureOptions): Promise<string>;
+export {};