@strands-agents/sdk 0.2.2 → 0.3.0

package/dist/src/models/__tests__/gemini.test.js

@@ -1,10 +1,10 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { GoogleGenAI } from '@google/genai';
+import { GoogleGenAI, FunctionCallingConfigMode } from '@google/genai';
 import { collectIterator } from '../../__fixtures__/model-test-helpers.js';
 import { GeminiModel } from '../gemini/model.js';
 import { ContextWindowOverflowError } from '../../errors.js';
-import { CachePointBlock, GuardContentBlock, ReasoningBlock, ToolUseBlock } from '../../types/messages.js';
-import { formatMessages } from '../gemini/adapters.js';
+import { CachePointBlock, GuardContentBlock, ReasoningBlock, TextBlock, ToolResultBlock, ToolUseBlock, } from '../../types/messages.js';
+import { formatMessages, mapChunkToEvents } from '../gemini/adapters.js';
 import { ImageBlock, DocumentBlock, VideoBlock } from '../../types/media.js';
 /**
  * Helper to create a mock Gemini client with streaming support
@@ -16,6 +16,49 @@ function createMockClient(streamGenerator) {
         },
     };
 }
+/**
+ * Helper to create a mock Gemini client that captures the request parameters.
+ * Returns the client and a captured object with `config` and `contents` fields
+ * populated after a stream call.
+ */
+function createMockClientWithCapture() {
+    const captured = {};
+    const client = {
+        models: {
+            generateContentStream: vi.fn(async (params) => {
+                Object.assign(captured, params);
+                return (async function* () {
+                    yield { candidates: [{ finishReason: 'STOP' }] };
+                })();
+            }),
+        },
+    };
+    return { client, captured };
+}
+/**
+ * Helper to set up a capture-based test with provider, captured params, and a default user message.
+ */
+function setupCaptureTest() {
+    const { client, captured } = createMockClientWithCapture();
+    const provider = new GeminiModel({ client });
+    const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+    return { provider, captured, messages };
+}
+/**
+ * Helper to set up a stream-based test with a mock client, provider, and default user message.
+ */
+function setupStreamTest(streamGenerator) {
+    const client = createMockClient(streamGenerator);
+    const provider = new GeminiModel({ client });
+    const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+    return { provider, messages };
+}
+/**
+ * Helper to format a single content block via formatMessages.
+ */
+function formatBlock(block, role = 'user') {
+    return formatMessages([{ type: 'message', role, content: [block] }]);
+}
 describe('GeminiModel', () => {
     beforeEach(() => {
         vi.stubEnv('GEMINI_API_KEY', 'test-api-key');
@@ -66,7 +109,7 @@ describe('GeminiModel', () => {
             await expect(collectIterator(provider.stream([]))).rejects.toThrow('At least one message is required');
         });
         it('emits message start and stop events', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -76,14 +119,12 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             expect(events[0]).toEqual({ type: 'modelMessageStartEvent', role: 'assistant' });
             expect(events[events.length - 1]).toEqual({ type: 'modelMessageStopEvent', stopReason: 'endTurn' });
         });
         it('emits text content block events', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -100,8 +141,6 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             expect(events).toHaveLength(6);
             expect(events[0]).toEqual({ type: 'modelMessageStartEvent', role: 'assistant' });
@@ -118,7 +157,7 @@ describe('GeminiModel', () => {
             expect(events[5]).toEqual({ type: 'modelMessageStopEvent', stopReason: 'endTurn' });
         });
         it('emits usage metadata when available', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -132,11 +171,8 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             const metadataEvent = events.find((e) => e.type === 'modelMetadataEvent');
-            expect(metadataEvent).toBeDefined();
             expect(metadataEvent).toEqual({
                 type: 'modelMetadataEvent',
                 usage: {
@@ -147,7 +183,7 @@ describe('GeminiModel', () => {
             });
         });
         it('handles MAX_TOKENS finish reason', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -157,8 +193,6 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'MAX_TOKENS' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             const stopEvent = events.find((e) => e.type === 'modelMessageStopEvent');
             expect(stopEvent).toBeDefined();
@@ -197,81 +231,37 @@ describe('GeminiModel', () => {
         });
     });
     describe('system prompt', () => {
-        /**
-         * Helper to create a mock client that captures the request config
-         */
-        function createMockClientWithCapture(captureContainer) {
-            return {
-                models: {
-                    generateContentStream: vi.fn(async ({ config }) => {
-                        captureContainer.config = config;
-                        return (async function* () {
-                            yield { candidates: [{ finishReason: 'STOP' }] };
-                        })();
-                    }),
-                },
-            };
-        }
         it('passes string system prompt to config', async () => {
-            const captured = { config: null };
-            const mockClient = createMockClientWithCapture(captured);
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+            const { provider, captured, messages } = setupCaptureTest();
             await collectIterator(provider.stream(messages, { systemPrompt: 'You are a helpful assistant' }));
-            expect(captured.config).toBeDefined();
             const config = captured.config;
             expect(config.systemInstruction).toBe('You are a helpful assistant');
         });
         it('ignores empty string system prompt', async () => {
-            const captured = { config: null };
-            const mockClient = createMockClientWithCapture(captured);
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+            const { provider, captured, messages } = setupCaptureTest();
             await collectIterator(provider.stream(messages, { systemPrompt: '   ' }));
-            expect(captured.config).toBeDefined();
             const config = captured.config;
             expect(config.systemInstruction).toBeUndefined();
         });
     });
     describe('message formatting', () => {
-        /**
-         * Helper to create a mock client that captures the request contents
-         */
-        function createMockClientWithCapture(captureContainer) {
-            return {
-                models: {
-                    generateContentStream: vi.fn(async ({ contents }) => {
-                        captureContainer.contents = contents;
-                        return (async function* () {
-                            yield { candidates: [{ finishReason: 'STOP' }] };
-                        })();
-                    }),
-                },
-            };
-        }
         it('formats user messages correctly', async () => {
-            const captured = { contents: null };
-            const mockClient = createMockClientWithCapture(captured);
-            const provider = new GeminiModel({ client: mockClient });
+            const { provider, captured } = setupCaptureTest();
             const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hello' }] }];
             await collectIterator(provider.stream(messages));
-            expect(captured.contents).toBeDefined();
             const contents = captured.contents;
             expect(contents).toHaveLength(1);
             expect(contents[0]?.role).toBe('user');
             expect(contents[0]?.parts[0]?.text).toBe('Hello');
         });
         it('formats assistant messages correctly', async () => {
-            const captured = { contents: null };
-            const mockClient = createMockClientWithCapture(captured);
-            const provider = new GeminiModel({ client: mockClient });
+            const { provider, captured } = setupCaptureTest();
             const messages = [
                 { type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] },
                 { type: 'message', role: 'assistant', content: [{ type: 'textBlock', text: 'Hello!' }] },
                 { type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'How are you?' }] },
             ];
             await collectIterator(provider.stream(messages));
-            expect(captured.contents).toBeDefined();
             const contents = captured.contents;
             expect(contents).toHaveLength(3);
             expect(contents[0]?.role).toBe('user');
@@ -286,25 +276,20 @@ describe('GeminiModel', () => {
                     format: 'png',
                     source: { bytes: new Uint8Array([0x89, 0x50, 0x4e, 0x47]) },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [imageBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(imageBlock);
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('inlineData');
-                expect(part.inlineData.mimeType).toBe('image/png');
+                expect(contents[0].parts).toEqual([{ inlineData: { data: 'iVBORw==', mimeType: 'image/png' } }]);
             });
             it('formats image with URL source as fileData', () => {
                 const imageBlock = new ImageBlock({
                     format: 'jpeg',
                     source: { url: 'https://example.com/image.jpg' },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [imageBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(imageBlock);
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('fileData');
-                expect(part.fileData.fileUri).toBe('https://example.com/image.jpg');
-                expect(part.fileData.mimeType).toBe('image/jpeg');
+                expect(contents[0].parts).toEqual([
+                    { fileData: { fileUri: 'https://example.com/image.jpg', mimeType: 'image/jpeg' } },
+                ]);
             });
             it('skips image with S3 source and logs warning', () => {
                 const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
@@ -312,8 +297,7 @@ describe('GeminiModel', () => {
                     format: 'png',
                     source: { s3Location: { uri: 's3://test/image.png' } },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [imageBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(imageBlock);
                 // Message with no valid parts is not included
                 expect(contents).toHaveLength(0);
                 expect(warnSpy).toHaveBeenCalled();
@@ -327,12 +311,9 @@ describe('GeminiModel', () => {
                     format: 'pdf',
                     source: { bytes: new Uint8Array([0x25, 0x50, 0x44, 0x46]) },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [docBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(docBlock);
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('inlineData');
-                expect(part.inlineData.mimeType).toBe('application/pdf');
+                expect(contents[0].parts).toEqual([{ inlineData: { data: 'JVBERg==', mimeType: 'application/pdf' } }]);
             });
             it('formats document with text source as inlineData bytes', () => {
                 const docBlock = new DocumentBlock({
@@ -340,12 +321,11 @@ describe('GeminiModel', () => {
                     format: 'txt',
                     source: { text: 'Document content here' },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [docBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(docBlock);
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('inlineData');
-                expect(part.inlineData.mimeType).toBe('text/plain');
+                expect(contents[0].parts).toEqual([
+                    { inlineData: { data: 'RG9jdW1lbnQgY29udGVudCBoZXJl', mimeType: 'text/plain' } },
+                ]);
             });
             it('formats document with content block source as separate text parts', () => {
                 const docBlock = new DocumentBlock({
@@ -353,8 +333,7 @@ describe('GeminiModel', () => {
                     format: 'txt',
                     source: { content: [{ text: 'Line 1' }, { text: 'Line 2' }] },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [docBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(docBlock);
                 expect(contents).toHaveLength(1);
                 expect(contents[0].parts).toEqual([{ text: 'Line 1' }, { text: 'Line 2' }]);
             });
@@ -365,68 +344,56 @@ describe('GeminiModel', () => {
                     format: 'mp4',
                     source: { bytes: new Uint8Array([0x00, 0x00, 0x00, 0x1c]) },
                 });
-                const messages = [{ type: 'message', role: 'user', content: [videoBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(videoBlock);
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('inlineData');
-                expect(part.inlineData.mimeType).toBe('video/mp4');
+                expect(contents[0].parts).toEqual([{ inlineData: { data: 'AAAAHA==', mimeType: 'video/mp4' } }]);
             });
         });
         describe('reasoning content', () => {
             it('formats reasoning block with thought flag', () => {
                 const reasoningBlock = new ReasoningBlock({ text: 'Let me think about this...' });
-                const messages = [{ type: 'message', role: 'assistant', content: [reasoningBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(reasoningBlock, 'assistant');
                 expect(contents).toHaveLength(1);
-                const part = contents[0].parts[0];
-                expect(part).toHaveProperty('text', 'Let me think about this...');
-                expect(part).toHaveProperty('thought', true);
+                expect(contents[0].parts).toEqual([{ text: 'Let me think about this...', thought: true }]);
             });
             it('includes thought signature when present', () => {
                 const reasoningBlock = new ReasoningBlock({ text: 'Thinking...', signature: 'sig123' });
-                const messages = [{ type: 'message', role: 'assistant', content: [reasoningBlock] }];
-                const contents = formatMessages(messages);
-                const part = contents[0].parts[0];
-                expect(part.thoughtSignature).toBe('sig123');
+                const contents = formatBlock(reasoningBlock, 'assistant');
+                expect(contents).toHaveLength(1);
+                expect(contents[0].parts).toEqual([{ text: 'Thinking...', thought: true, thoughtSignature: 'sig123' }]);
             });
             it('skips reasoning block with empty text', () => {
                 const reasoningBlock = new ReasoningBlock({ text: '' });
-                const messages = [{ type: 'message', role: 'assistant', content: [reasoningBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(reasoningBlock, 'assistant');
                 expect(contents).toHaveLength(0);
             });
         });
         describe('unsupported content types', () => {
-            it('skips cache point blocks with warning', () => {
-                const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-                const cacheBlock = new CachePointBlock({ cacheType: 'default' });
-                const messages = [{ type: 'message', role: 'user', content: [cacheBlock] }];
-                const contents = formatMessages(messages);
-                expect(contents).toHaveLength(0);
-                warnSpy.mockRestore();
-            });
-            it('skips guard content blocks with warning', () => {
+            it.each([
+                { name: 'cache point', block: new CachePointBlock({ cacheType: 'default' }) },
+                {
+                    name: 'guard content',
+                    block: new GuardContentBlock({ text: { qualifiers: ['guard_content'], text: 'test' } }),
+                },
+            ])('skips $name blocks with warning', ({ block }) => {
                 const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-                const guardBlock = new GuardContentBlock({ text: { qualifiers: ['guard_content'], text: 'test' } });
-                const messages = [{ type: 'message', role: 'user', content: [guardBlock] }];
-                const contents = formatMessages(messages);
+                const contents = formatBlock(block);
                 expect(contents).toHaveLength(0);
                 warnSpy.mockRestore();
             });
-            it('skips tool use blocks with warning', () => {
-                const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-                const toolUseBlock = new ToolUseBlock({ toolUseId: 'test-id', name: 'testTool', input: {} });
-                const messages = [{ type: 'message', role: 'assistant', content: [toolUseBlock] }];
-                const contents = formatMessages(messages);
-                expect(contents).toHaveLength(0);
-                warnSpy.mockRestore();
+            it('formats tool use blocks as function calls', () => {
+                const toolUseBlock = new ToolUseBlock({ toolUseId: 'test-id', name: 'testTool', input: { key: 'value' } });
+                const contents = formatBlock(toolUseBlock, 'assistant');
+                expect(contents).toHaveLength(1);
+                expect(contents[0].parts).toEqual([
+                    { functionCall: { id: 'test-id', name: 'testTool', args: { key: 'value' } } },
+                ]);
             });
         });
     });
     describe('reasoning content streaming', () => {
         it('emits reasoning content delta events for thought parts', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -436,8 +403,6 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             expect(events).toHaveLength(5);
             expect(events[0]).toEqual({ type: 'modelMessageStartEvent', role: 'assistant' });
@@ -450,7 +415,7 @@ describe('GeminiModel', () => {
             expect(events[4]).toEqual({ type: 'modelMessageStopEvent', stopReason: 'endTurn' });
         });
         it('handles transition from reasoning to text content', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -467,8 +432,6 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             // Should have: messageStart, blockStart (reasoning), delta (reasoning), blockStop,
             //              blockStart (text), delta (text), blockStop, messageStop
@@ -490,7 +453,7 @@ describe('GeminiModel', () => {
             expect(events[7]).toEqual({ type: 'modelMessageStopEvent', stopReason: 'endTurn' });
         });
         it('includes signature in reasoning delta when present', async () => {
-            const mockClient = createMockClient(async function* () {
+            const { provider, messages } = setupStreamTest(async function* () {
                 yield {
                     candidates: [
                         {
@@ -508,12 +471,346 @@ describe('GeminiModel', () => {
                 };
                 yield { candidates: [{ finishReason: 'STOP' }] };
             });
-            const provider = new GeminiModel({ client: mockClient });
-            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
             const events = await collectIterator(provider.stream(messages));
             const deltaEvent = events.find((e) => e.type === 'modelContentBlockDeltaEvent' && e.delta.type === 'reasoningContentDelta');
-            expect(deltaEvent).toBeDefined();
-            expect(deltaEvent.delta.signature).toBe('sig456');
+            expect(deltaEvent).toEqual({
+                type: 'modelContentBlockDeltaEvent',
+                delta: { type: 'reasoningContentDelta', text: 'Thinking...', signature: 'sig456' },
+            });
+        });
+    });
+    describe('tool configuration', () => {
+        it('passes tool specs as functionDeclarations', async () => {
+            const { provider, captured, messages } = setupCaptureTest();
+            await collectIterator(provider.stream(messages, {
+                toolSpecs: [
+                    {
+                        name: 'get_weather',
+                        description: 'Get the weather',
+                        inputSchema: { type: 'object', properties: { city: { type: 'string' } } },
+                    },
+                ],
+            }));
+            const config = captured.config;
+            expect(config.tools).toEqual([
+                {
+                    functionDeclarations: [
+                        {
+                            name: 'get_weather',
+                            description: 'Get the weather',
+                            parametersJsonSchema: { type: 'object', properties: { city: { type: 'string' } } },
+                        },
+                    ],
+                },
+            ]);
+        });
+        it.each([
+            {
+                name: 'auto to AUTO',
+                toolChoice: { auto: {} },
+                expectedMode: FunctionCallingConfigMode.AUTO,
+            },
+            {
+                name: 'any to ANY',
+                toolChoice: { any: {} },
+                expectedMode: FunctionCallingConfigMode.ANY,
+            },
+            {
+                name: 'tool to ANY with allowedFunctionNames',
+                toolChoice: { tool: { name: 'get_weather' } },
+                expectedMode: FunctionCallingConfigMode.ANY,
+                expectedAllowedFunctionNames: ['get_weather'],
+            },
+        ])('maps toolChoice $name', async ({ toolChoice, expectedMode, expectedAllowedFunctionNames }) => {
+            const { provider, captured, messages } = setupCaptureTest();
+            await collectIterator(provider.stream(messages, {
+                toolSpecs: [{ name: 'get_weather', description: 'test' }],
+                toolChoice,
+            }));
+            const config = captured.config;
+            expect(config.toolConfig?.functionCallingConfig?.mode).toBe(expectedMode);
+            if (expectedAllowedFunctionNames) {
+                expect(config.toolConfig?.functionCallingConfig?.allowedFunctionNames).toEqual(expectedAllowedFunctionNames);
+            }
+        });
+        it('does not add tools config when no toolSpecs provided', async () => {
+            const { provider, captured, messages } = setupCaptureTest();
+            await collectIterator(provider.stream(messages));
+            const config = captured.config;
+            expect(config.tools).toBeUndefined();
+        });
+    });
+    describe('built-in tools', () => {
+        it('appends geminiTools to config.tools alongside functionDeclarations', async () => {
+            const { client, captured } = createMockClientWithCapture();
+            const provider = new GeminiModel({ client, geminiTools: [{ googleSearch: {} }] });
+            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+            await collectIterator(provider.stream(messages, {
+                toolSpecs: [
+                    {
+                        name: 'get_weather',
+                        description: 'Get the weather',
+                        inputSchema: { type: 'object', properties: { city: { type: 'string' } } },
+                    },
+                ],
+            }));
+            const config = captured.config;
+            expect(config.tools).toHaveLength(2);
+            expect(config.tools[0]).toEqual({
+                functionDeclarations: [
+                    {
+                        name: 'get_weather',
+                        description: 'Get the weather',
+                        parametersJsonSchema: { type: 'object', properties: { city: { type: 'string' } } },
+                    },
+                ],
+            });
+            expect(config.tools[1]).toEqual({ googleSearch: {} });
+        });
+        it('passes geminiTools when no toolSpecs provided', async () => {
+            const { client, captured } = createMockClientWithCapture();
+            const provider = new GeminiModel({ client, geminiTools: [{ codeExecution: {} }] });
+            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+            await collectIterator(provider.stream(messages));
+            const config = captured.config;
+            expect(config.tools).toHaveLength(1);
+            expect(config.tools[0]).toEqual({ codeExecution: {} });
+        });
+        it('does not add tools when neither geminiTools nor toolSpecs provided', async () => {
+            const { client, captured } = createMockClientWithCapture();
+            const provider = new GeminiModel({ client });
+            const messages = [{ type: 'message', role: 'user', content: [{ type: 'textBlock', text: 'Hi' }] }];
+            await collectIterator(provider.stream(messages));
+            const config = captured.config;
+            expect(config.tools).toBeUndefined();
+        });
+    });
+    describe('tool use formatting', () => {
+        it('formats toolUseBlock with reasoningSignature as thoughtSignature', () => {
+            const toolUseBlock = new ToolUseBlock({
+                toolUseId: 'test-id',
+                name: 'testTool',
+                input: { key: 'value' },
+                reasoningSignature: 'sig789',
+            });
+            const contents = formatBlock(toolUseBlock, 'assistant');
+            expect(contents).toHaveLength(1);
+            expect(contents[0].parts).toEqual([
+                {
+                    functionCall: { id: 'test-id', name: 'testTool', args: { key: 'value' } },
+                    thoughtSignature: 'sig789',
+                },
+            ]);
+        });
+        it('formats toolResultBlock as functionResponse', () => {
+            const toolUseBlock = new ToolUseBlock({ toolUseId: 'test-id', name: 'testTool', input: {} });
+            const toolResultBlock = new ToolResultBlock({
+                toolUseId: 'test-id',
+                status: 'success',
+                content: [new TextBlock('result text')],
+            });
+            const messages = [
+                { type: 'message', role: 'assistant', content: [toolUseBlock] },
+                { type: 'message', role: 'user', content: [toolResultBlock] },
+            ];
+            const contents = formatMessages(messages);
+            expect(contents).toHaveLength(2);
+            expect(contents[1].parts[0]).toEqual({
+                functionResponse: {
+                    id: 'test-id',
+                    name: 'testTool',
+                    response: { output: [{ text: 'result text' }] },
+                },
+            });
+        });
+        it('resolves tool name from toolUseId in toolResultBlock', () => {
+            const toolUseBlock = new ToolUseBlock({ toolUseId: 'abc-123', name: 'my_tool', input: {} });
+            const toolResultBlock = new ToolResultBlock({
+                toolUseId: 'abc-123',
+                status: 'success',
+                content: [new TextBlock('ok')],
+            });
+            const messages = [
+                { type: 'message', role: 'assistant', content: [toolUseBlock] },
+                { type: 'message', role: 'user', content: [toolResultBlock] },
+            ];
+            const contents = formatMessages(messages);
+            const resultPart = contents[1].parts[0];
+            const fr = resultPart.functionResponse;
+            expect(fr.name).toBe('my_tool');
+        });
+        it('falls back to toolUseId when tool name mapping is not found', () => {
+            const toolResultBlock = new ToolResultBlock({
+                toolUseId: 'unknown-id',
+                status: 'success',
+                content: [new TextBlock('ok')],
+            });
+            const messages = [{ type: 'message', role: 'user', content: [toolResultBlock] }];
+            const contents = formatMessages(messages);
+            const resultPart = contents[0].parts[0];
+            const fr = resultPart.functionResponse;
+            expect(fr.name).toBe('unknown-id');
+        });
+    });
+    describe('tool use streaming', () => {
+        function createStreamState() {
+            return {
+                messageStarted: true,
+                textContentBlockStarted: false,
+                reasoningContentBlockStarted: false,
+                hasToolCalls: false,
+                inputTokens: 0,
+                outputTokens: 0,
+            };
+        }
+        it('emits tool use events for function call in response', () => {
+            const streamState = createStreamState();
+            const chunk = {
+                candidates: [
+                    {
+                        content: {
+                            parts: [{ functionCall: { id: 'tool-1', name: 'get_weather', args: { city: 'NYC' } } }],
+                        },
+                    },
+                ],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            expect(events).toEqual([
+                {
+                    type: 'modelContentBlockStartEvent',
+                    start: { type: 'toolUseStart', name: 'get_weather', toolUseId: 'tool-1' },
+                },
+                {
+                    type: 'modelContentBlockDeltaEvent',
+                    delta: { type: 'toolUseInputDelta', input: '{"city":"NYC"}' },
+                },
+                { type: 'modelContentBlockStopEvent' },
+            ]);
+            expect(streamState.hasToolCalls).toBe(true);
+        });
+        it('generates tool use ID when Gemini does not provide one', () => {
+            const streamState = createStreamState();
+            const chunk = {
+                candidates: [
+                    {
+                        content: {
+                            parts: [{ functionCall: { name: 'testTool', args: {} } }],
+                        },
+                    },
+                ],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            const startEvent = events[0];
+            expect(startEvent.type).toBe('modelContentBlockStartEvent');
+            const start = startEvent.start;
+            expect(start.toolUseId).toMatch(/^tooluse_/);
+        });
+        it('includes reasoningSignature from thoughtSignature on function call', () => {
+            const streamState = createStreamState();
+            const chunk = {
+                candidates: [
+                    {
+                        content: {
+                            parts: [
+                                {
+                                    functionCall: { id: 'tool-1', name: 'testTool', args: {} },
+                                    thoughtSignature: 'sig-abc',
+                                },
+                            ],
+                        },
+                    },
+                ],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            const startEvent = events[0];
+            const start = startEvent.start;
+            expect(start.reasoningSignature).toBe('sig-abc');
+        });
+        it('sets stop reason to toolUse when function calls are present', () => {
+            const streamState = createStreamState();
+            streamState.hasToolCalls = true;
+            const chunk = {
+                candidates: [{ finishReason: 'STOP' }],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            expect(events).toEqual([{ type: 'modelMessageStopEvent', stopReason: 'toolUse' }]);
+        });
+        it.each([
+            { blockType: 'reasoning', stateField: 'reasoningContentBlockStarted' },
+            { blockType: 'text', stateField: 'textContentBlockStarted' },
+        ])('closes $blockType block before tool use block', ({ stateField }) => {
+            const streamState = createStreamState();
+            streamState[stateField] = true;
+            const chunk = {
+                candidates: [
+                    {
+                        content: {
+                            parts: [{ functionCall: { id: 'tool-1', name: 'testTool', args: {} } }],
+                        },
+                    },
+                ],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            expect(events[0]).toEqual({ type: 'modelContentBlockStopEvent' });
+            expect(events[1]).toEqual({
+                type: 'modelContentBlockStartEvent',
+                start: { type: 'toolUseStart', name: 'testTool', toolUseId: 'tool-1' },
+            });
+            expect(streamState[stateField]).toBe(false);
+        });
+        it('handles multiple function calls in a single response', () => {
+            const streamState = createStreamState();
+            const chunk = {
+                candidates: [
+                    {
+                        content: {
+                            parts: [
+                                { functionCall: { id: 'tool-1', name: 'get_weather', args: { city: 'NYC' } } },
+                                { functionCall: { id: 'tool-2', name: 'get_time', args: { tz: 'EST' } } },
+                            ],
+                        },
+                    },
+                ],
+            };
+            const events = mapChunkToEvents(chunk, streamState);
+            // Each function call: start + delta + stop = 3 events, x2 = 6
+            expect(events).toHaveLength(6);
+            expect(events[0]).toEqual({
+                type: 'modelContentBlockStartEvent',
+                start: { type: 'toolUseStart', name: 'get_weather', toolUseId: 'tool-1' },
+            });
+            expect(events[3]).toEqual({
+                type: 'modelContentBlockStartEvent',
+                start: { type: 'toolUseStart', name: 'get_time', toolUseId: 'tool-2' },
+            });
+        });
+        it('handles full tool use flow via stream method', async () => {
+            const { provider, messages } = setupStreamTest(async function* () {
+                yield {
+                    candidates: [
+                        {
+                            content: {
+                                parts: [{ functionCall: { id: 'call-1', name: 'get_weather', args: { city: 'NYC' } } }],
+                            },
+                        },
+                    ],
+                };
+                yield { candidates: [{ finishReason: 'STOP' }] };
+            });
+            const events = await collectIterator(provider.stream(messages));
+            // messageStart, blockStart (toolUse), delta (toolUseInput), blockStop, messageStop
+            expect(events).toHaveLength(5);
+            expect(events[0]).toEqual({ type: 'modelMessageStartEvent', role: 'assistant' });
+            expect(events[1]).toEqual({
+                type: 'modelContentBlockStartEvent',
+                start: { type: 'toolUseStart', name: 'get_weather', toolUseId: 'call-1' },
+            });
+            expect(events[2]).toEqual({
+                type: 'modelContentBlockDeltaEvent',
+                delta: { type: 'toolUseInputDelta', input: '{"city":"NYC"}' },
+            });
+            expect(events[3]).toEqual({ type: 'modelContentBlockStopEvent' });
+            expect(events[4]).toEqual({ type: 'modelMessageStopEvent', stopReason: 'toolUse' });
         });
     });
 });