@aituber-onair/core 0.7.0 → 0.8.1

package/dist/services/chat/providers/claude/ClaudeChatServiceProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClaudeChatServiceProvider.js","sourceRoot":"","sources":["../../../../../src/services/chat/providers/claude/ClaudeChatServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMxD;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;OAIG;IACH,iBAAiB,CAAC,OAA2B;QAC3C,gFAAgF;QAChF,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;YACnB,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnE,CAAC,CAAC,OAAO,CAAC,KAAK;gBACf,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAE9B,OAAO,IAAI,iBAAiB,CAC1B,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,EACvC,WAAW,CACZ,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO;YACL,oBAAoB;YACpB,sBAAsB;YACtB,uBAAuB;YACvB,uBAAuB;SACxB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,KAAa;QAClC,OAAO,8BAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;CACF"}
+{"version":3,"file":"ClaudeChatServiceProvider.js","sourceRoot":"","sources":["../../../../../src/services/chat/providers/claude/ClaudeChatServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMxD;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;OAIG;IACH,iBAAiB,CAAC,OAA2B;QAC3C,gFAAgF;QAChF,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;YACnB,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnE,CAAC,CAAC,OAAO,CAAC,KAAK;gBACf,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAE9B,OAAO,IAAI,iBAAiB,CAC1B,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,EACvC,WAAW,EACX,OAAO,CAAC,KAAK,IAAI,EAAE,CACpB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO;YACL,oBAAoB;YACpB,sBAAsB;YACtB,uBAAuB;YACvB,uBAAuB;SACxB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,KAAa;QAClC,OAAO,8BAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/services/chat/providers/gemini/GeminiChatService.d.ts

@@ -1,21 +1,30 @@
 import { ChatService } from '../../ChatService';
-import { Message, MessageWithVision } from '../../../../types';
+import { Message, MessageWithVision, ToolChatCompletion, ToolDefinition } from '../../../../types';
 /**
  * Gemini implementation of ChatService
  */
 export declare class GeminiChatService implements ChatService {
+    /** Provider name */
+    readonly provider: string;
     private apiKey;
     private model;
     private visionModel;
-    /** Provider name */
-    readonly provider: string;
+    private tools;
+    /** id(OpenAI) → name(Gemini) mapping */
+    private callIdMap;
+    private safeJsonParse;
+    private normalizeToolResult;
+    /**
+     * camelCase → snake_case conversion (v1beta)
+     */
+    private adaptKeysForApi;
     /**
      * Constructor
      * @param apiKey Google API key
      * @param model Name of the model to use
      * @param visionModel Name of the vision model
      */
-    constructor(apiKey: string, model?: string, visionModel?: string);
+    constructor(apiKey: string, model?: string, visionModel?: string, tools?: ToolDefinition[]);
     /**
      * Get the current model name
      * @returns Model name
@@ -33,20 +42,9 @@ export declare class GeminiChatService implements ChatService {
      * @param onCompleteResponse Callback to execute when response is complete
      */
     processChat(messages: Message[], onPartialResponse: (text: string) => void, onCompleteResponse: (text: string) => Promise<void>): Promise<void>;
-    /**
-     * Process chat messages with images
-     * @param messages Array of messages to send (including images)
-     * @param onPartialResponse Callback to receive each part of streaming response
-     * @param onCompleteResponse Callback to execute when response is complete
-     * @throws Error if the selected model doesn't support vision
-     */
     processVisionChat(messages: MessageWithVision[], onPartialResponse: (text: string) => void, onCompleteResponse: (text: string) => Promise<void>): Promise<void>;
-    /**
-     * Convert AITuber OnAir messages to Gemini format
-     * @param messages Array of messages
-     * @returns Gemini formatted messages
-     */
     private convertMessagesToGeminiFormat;
+    private callGemini;
     /**
      * Convert AITuber OnAir vision messages to Gemini format
      * @param messages Array of vision messages
@@ -65,4 +63,9 @@ export declare class GeminiChatService implements ChatService {
      * @returns Gemini role
      */
     private mapRoleToGemini;
+    private parseStream;
+    private parseOneShot;
+    chatOnce(messages: Message[], stream?: boolean, onPartialResponse?: (t: string) => void): Promise<ToolChatCompletion>;
+    visionChatOnce(messages: MessageWithVision[], stream?: boolean): Promise<ToolChatCompletion>;
+    private genUUID;
 }

package/dist/services/chat/providers/gemini/GeminiChatService.js

@@ -3,15 +3,56 @@ import { ENDPOINT_GEMINI_API, MODEL_GEMINI_2_0_FLASH_LITE, GEMINI_VISION_SUPPORT
  * Gemini implementation of ChatService
  */
 export class GeminiChatService {
+    /* ────────────────────────────────── */
+    /*  Utilities                           */
+    /* ────────────────────────────────── */
+    safeJsonParse(str) {
+        try {
+            return JSON.parse(str);
+        }
+        catch {
+            return str; // keep as string
+        }
+    }
+    normalizeToolResult(val) {
+        if (val === null)
+            return { content: null };
+        if (typeof val === 'object')
+            return val;
+        return { content: val }; // wrap primitive
+    }
+    /**
+     * camelCase → snake_case conversion (v1beta)
+     */
+    adaptKeysForApi(obj) {
+        const map = {
+            toolConfig: 'tool_config',
+            functionCallingConfig: 'function_calling_config',
+            functionDeclarations: 'function_declarations',
+            functionCall: 'function_call',
+            functionResponse: 'function_response',
+        };
+        if (Array.isArray(obj))
+            return obj.map((v) => this.adaptKeysForApi(v));
+        if (obj && typeof obj === 'object') {
+            return Object.fromEntries(Object.entries(obj).map(([k, v]) => [
+                map[k] ?? k,
+                this.adaptKeysForApi(v),
+            ]));
+        }
+        return obj;
+    }
     /**
      * Constructor
      * @param apiKey Google API key
      * @param model Name of the model to use
      * @param visionModel Name of the vision model
      */
-    constructor(apiKey, model = MODEL_GEMINI_2_0_FLASH_LITE, visionModel = MODEL_GEMINI_2_0_FLASH_LITE) {
+    constructor(apiKey, model = MODEL_GEMINI_2_0_FLASH_LITE, visionModel = MODEL_GEMINI_2_0_FLASH_LITE, tools = []) {
         /** Provider name */
         this.provider = 'gemini';
+        /** id(OpenAI) → name(Gemini) mapping */
+        this.callIdMap = new Map();
         this.apiKey = apiKey;
         this.model = model;
         // check if the vision model is supported
@@ -19,6 +60,7 @@ export class GeminiChatService {
             throw new Error(`Model ${visionModel} does not support vision capabilities.`);
         }
         this.visionModel = visionModel;
+        this.tools = tools;
     }
     /**
      * Get the current model name
@@ -42,188 +84,186 @@ export class GeminiChatService {
      */
     async processChat(messages, onPartialResponse, onCompleteResponse) {
         try {
-            // Convert messages to Gemini format
-            const geminiMessages = this.convertMessagesToGeminiFormat(messages);
-            // Create the endpoint URL with API key
-            const apiUrl = `${ENDPOINT_GEMINI_API}/models/${this.model}:streamGenerateContent?key=${this.apiKey}`;
-            // Request to Gemini API
-            const response = await fetch(apiUrl, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({
-                    contents: geminiMessages,
-                    generationConfig: {
-                        temperature: 0.7,
-                        topK: 40,
-                        topP: 0.95,
-                        maxOutputTokens: 1000,
-                    },
-                }),
-            });
-            if (!response.ok) {
-                const errorData = await response.json();
-                throw new Error(`Gemini API error: ${errorData.error?.message || response.statusText}`);
+            // not use tools
+            if (this.tools.length === 0) {
+                const res = await this.callGemini(messages, this.model, true);
+                const { blocks } = await this.parseStream(res, onPartialResponse);
+                const full = blocks
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join('');
+                await onCompleteResponse(full);
+                return;
             }
-            // Process streaming response
-            const reader = response.body?.getReader();
-            const decoder = new TextDecoder('utf-8');
-            let fullText = '';
-            if (!reader) {
-                throw new Error('Failed to get response reader');
+            /* with tools (1 turn) */
+            const { blocks, stop_reason } = await this.chatOnce(messages, true, onPartialResponse);
+            if (stop_reason === 'end') {
+                const full = blocks
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join('');
+                await onCompleteResponse(full);
+                return;
             }
-            // get full response
-            let responseText = '';
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    break;
-                const chunk = decoder.decode(value);
-                responseText += chunk;
-            }
-            // parse response
-            try {
-                const responseArray = JSON.parse(responseText);
-                // process each response
-                for (const item of responseArray) {
-                    if (item.candidates && item.candidates.length > 0) {
-                        const content = item.candidates[0].content;
-                        if (content && content.parts && content.parts.length > 0) {
-                            const text = content.parts[0].text || '';
-                            if (text) {
-                                fullText += text;
-                                onPartialResponse(text);
-                            }
-                        }
-                    }
-                }
-            }
-            catch (err) {
-                console.error('Error parsing Gemini response:', err);
-                throw new Error(`Failed to parse Gemini response: ${err.message}`);
-            }
-            // Complete response callback
-            await onCompleteResponse(fullText);
+            throw new Error('Received functionCall. Use chatOnce() loop when tools are enabled.');
         }
-        catch (error) {
-            console.error('Error in processChat:', error);
-            throw error;
+        catch (err) {
+            console.error('Error in processChat:', err);
+            throw err;
         }
     }
-    /**
-     * Process chat messages with images
-     * @param messages Array of messages to send (including images)
-     * @param onPartialResponse Callback to receive each part of streaming response
-     * @param onCompleteResponse Callback to execute when response is complete
-     * @throws Error if the selected model doesn't support vision
-     */
     async processVisionChat(messages, onPartialResponse, onCompleteResponse) {
         try {
-            // Check if the vision model supports vision capabilities
             if (!GEMINI_VISION_SUPPORTED_MODELS.includes(this.visionModel)) {
                 throw new Error(`Model ${this.visionModel} does not support vision capabilities.`);
             }
-            // Convert messages to Gemini vision format
-            const geminiMessages = await this.convertVisionMessagesToGeminiFormat(messages);
-            // Create the endpoint URL with API key
-            const apiUrl = `${ENDPOINT_GEMINI_API}/models/${this.visionModel}:streamGenerateContent?key=${this.apiKey}`;
-            // Request to Gemini API
-            const response = await fetch(apiUrl, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({
-                    contents: geminiMessages,
-                    generationConfig: {
-                        temperature: 0.7,
-                        topK: 40,
-                        topP: 0.95,
-                        maxOutputTokens: 1000,
-                    },
-                }),
-            });
-            if (!response.ok) {
-                const errorData = await response.json();
-                throw new Error(`Gemini API error: ${errorData.error?.message || response.statusText}`);
-            }
-            // Process streaming response
-            const reader = response.body?.getReader();
-            const decoder = new TextDecoder('utf-8');
-            let fullText = '';
-            if (!reader) {
-                throw new Error('Failed to get response reader');
-            }
-            // get full response
-            let responseText = '';
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    break;
-                const chunk = decoder.decode(value);
-                responseText += chunk;
-            }
-            // parse response
-            try {
-                const responseArray = JSON.parse(responseText);
-                // process each response
-                for (const item of responseArray) {
-                    if (item.candidates && item.candidates.length > 0) {
-                        const content = item.candidates[0].content;
-                        if (content && content.parts && content.parts.length > 0) {
-                            const text = content.parts[0].text || '';
-                            if (text) {
-                                fullText += text;
-                                onPartialResponse(text);
-                            }
-                        }
-                    }
-                }
+            if (this.tools.length === 0) {
+                const res = await this.callGemini(messages, this.visionModel, true);
+                const { blocks } = await this.parseStream(res, onPartialResponse);
+                const full = blocks
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join('');
+                await onCompleteResponse(full);
+                return;
             }
-            catch (err) {
-                console.error('Error parsing Gemini response:', err);
-                throw new Error(`Failed to parse Gemini response: ${err.message}`);
+            const { blocks, stop_reason } = await this.visionChatOnce(messages);
+            blocks
+                .filter((b) => b.type === 'text')
+                .forEach((b) => onPartialResponse(b.text));
+            if (stop_reason === 'end') {
+                const full = blocks
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join('');
+                await onCompleteResponse(full);
+                return;
             }
-            // Complete response callback
-            await onCompleteResponse(fullText);
+            throw new Error('Received functionCall. Use visionChatOnce() loop when tools are enabled.');
         }
-        catch (error) {
-            console.error('Error in processVisionChat:', error);
-            throw error;
+        catch (err) {
+            console.error('Error in processVisionChat:', err);
+            throw err;
         }
     }
-    /**
-     * Convert AITuber OnAir messages to Gemini format
-     * @param messages Array of messages
-     * @returns Gemini formatted messages
-     */
+    /* ────────────────────────────────── */
+    /*  OpenAI → Gemini conversion         */
+    /* ────────────────────────────────── */
     convertMessagesToGeminiFormat(messages) {
-        const geminiMessages = [];
+        const gemini = [];
         let currentRole = null;
         let currentParts = [];
+        const pushCurrent = () => {
+            if (currentRole && currentParts.length) {
+                gemini.push({ role: currentRole, parts: [...currentParts] });
+                currentParts = [];
+            }
+        };
         for (const msg of messages) {
-            // Map AITuber OnAir roles to Gemini roles
             const role = this.mapRoleToGemini(msg.role);
-            // If role changes, start a new message
-            if (role !== currentRole && currentParts.length > 0) {
-                geminiMessages.push({
-                    role: currentRole,
-                    parts: [...currentParts],
+            /* assistant: tool_calls -> functionCall */
+            if (msg.tool_calls) {
+                pushCurrent();
+                for (const call of msg.tool_calls) {
+                    this.callIdMap.set(call.id, call.function.name);
+                    gemini.push({
+                        role: 'model',
+                        parts: [
+                            {
+                                functionCall: {
+                                    name: call.function.name,
+                                    args: JSON.parse(call.function.arguments || '{}'),
+                                },
+                            },
+                        ],
+                    });
+                }
+                continue;
+            }
+            /* tool → functionResponse */
+            if (msg.role === 'tool') {
+                pushCurrent();
+                const funcName = msg.name ??
+                    this.callIdMap.get(msg.tool_call_id) ??
+                    'result';
+                gemini.push({
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: funcName,
+                                response: this.normalizeToolResult(this.safeJsonParse(msg.content)),
+                            },
+                        },
+                    ],
                 });
-                currentParts = [];
+                continue;
             }
+            /* normal text */
+            if (role !== currentRole)
+                pushCurrent();
             currentRole = role;
             currentParts.push({ text: msg.content });
         }
-        // Add the last message
-        if (currentRole && currentParts.length > 0) {
-            geminiMessages.push({
-                role: currentRole,
-                parts: [...currentParts],
-            });
+        pushCurrent();
+        return gemini;
+    }
+    /* ────────────────────────────────── */
+    /*  HTTP call                           */
+    /* ────────────────────────────────── */
+    async callGemini(messages, model, stream = false) {
+        const hasVision = messages.some((m) => Array.isArray(m.content) &&
+            m.content.some((b) => b?.type === 'image_url' || b?.inlineData));
+        const contents = hasVision
+            ? await this.convertVisionMessagesToGeminiFormat(messages)
+            : this.convertMessagesToGeminiFormat(messages);
+        const body = {
+            contents,
+            generationConfig: {
+                maxOutputTokens: 1000,
+            },
+        };
+        if (this.tools.length) {
+            body.tools = [
+                {
+                    functionDeclarations: this.tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        parameters: t.parameters,
+                    })),
+                },
+            ];
+            body.toolConfig = { functionCallingConfig: { mode: 'AUTO' } };
         }
-        return geminiMessages;
+        const fetchOnce = async (ver, payload) => {
+            const fn = stream ? 'streamGenerateContent' : 'generateContent';
+            const alt = stream ? '?alt=sse' : '';
+            const url = `${ENDPOINT_GEMINI_API}/${ver}/models/${model}:${fn}${alt}${alt ? '&' : '?'}key=${this.apiKey}`;
+            return fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+        };
+        const isLite = /flash[-_]lite/.test(model);
+        const firstVer = isLite ? 'v1beta' : 'v1';
+        const tryApi = async () => {
+            try {
+                const payload = firstVer === 'v1' ? body : this.adaptKeysForApi(body); // snake_case conversion
+                return await fetchOnce(firstVer, payload);
+            }
+            catch (e) {
+                // Only retry v1beta if camel/snake case mismatch error occurs in non-Lite models
+                if (!isLite && /Unknown name|Cannot find field|404/.test(e.message)) {
+                    return await fetchOnce('v1beta', this.adaptKeysForApi(body));
+                }
+                throw e; // otherwise, throw to upper layer
+            }
+        };
+        const res = await tryApi();
+        if (!res.ok)
+            throw new Error(`Gemini HTTP ${res.status}`);
+        return res;
     }
     /**
      * Convert AITuber OnAir vision messages to Gemini format
@@ -237,6 +277,43 @@ export class GeminiChatService {
         for (const msg of messages) {
             // Map AITuber OnAir roles to Gemini roles
             const role = this.mapRoleToGemini(msg.role);
+            /* ----------- OpenAI compatible tool metadata ----------- */
+            // assistant: { tool_calls:[{id,name,function:{arguments}}] }
+            if (msg.tool_calls) {
+                for (const call of msg.tool_calls) {
+                    // Gemini does not need id. Insert functionCall into parts
+                    geminiMessages.push({
+                        role: 'model',
+                        parts: [
+                            {
+                                functionCall: {
+                                    name: call.function.name,
+                                    args: JSON.parse(call.function.arguments || '{}'),
+                                },
+                            },
+                        ],
+                    });
+                }
+                continue;
+            }
+            // tool role → user role + functionResponse
+            if (msg.role === 'tool') {
+                const funcName = msg.name ??
+                    this.callIdMap.get(msg.tool_call_id) ??
+                    'result';
+                geminiMessages.push({
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: funcName,
+                                response: this.normalizeToolResult(this.safeJsonParse(msg.content)),
+                            },
+                        },
+                    ],
+                });
+                continue;
+            }
             // If role changes, start a new message
             if (role !== currentRole && currentParts.length > 0) {
                 geminiMessages.push({
@@ -321,5 +398,147 @@ export class GeminiChatService {
                 return 'user';
         }
     }
+    /* ────────────────────────────────────────────────────────── */
+    /*  Convert NDJSON stream to common format             */
+    /* ────────────────────────────────────────────────────────── */
+    async parseStream(res, onPartial) {
+        const reader = res.body.getReader();
+        const dec = new TextDecoder();
+        const textBlocks = [];
+        const toolBlocks = [];
+        let buf = '';
+        const flush = (payload) => {
+            if (!payload || payload === '[DONE]')
+                return;
+            let obj;
+            try {
+                obj = JSON.parse(payload);
+            }
+            catch {
+                return;
+            }
+            for (const cand of obj.candidates ?? []) {
+                for (const part of cand.content?.parts ?? []) {
+                    if (part.text) {
+                        onPartial(part.text);
+                        textBlocks.push({ type: 'text', text: part.text });
+                    }
+                    if (part.functionCall) {
+                        toolBlocks.push({
+                            type: 'tool_use',
+                            id: this.genUUID(),
+                            name: part.functionCall.name,
+                            input: part.functionCall.args ?? {},
+                        });
+                    }
+                    if (part.functionResponse) {
+                        toolBlocks.push({
+                            type: 'tool_result',
+                            tool_use_id: part.functionResponse.name,
+                            content: JSON.stringify(part.functionResponse.response),
+                        });
+                    }
+                }
+            }
+        };
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            let nl;
+            while ((nl = buf.indexOf('\n')) !== -1) {
+                let line = buf.slice(0, nl);
+                buf = buf.slice(nl + 1);
+                if (line.endsWith('\r'))
+                    line = line.slice(0, -1); // CRLF support
+                if (!line.trim()) {
+                    flush('');
+                    continue;
+                } // keep-alive empty line
+                if (line.startsWith('data:'))
+                    line = line.slice(5).trim();
+                if (!line)
+                    continue;
+                flush(line);
+            }
+        }
+        if (buf)
+            flush(buf);
+        const blocks = [...textBlocks, ...toolBlocks];
+        return {
+            blocks,
+            stop_reason: toolBlocks.some((b) => b.type === 'tool_use')
+                ? 'tool_use'
+                : 'end',
+        };
+    }
+    /* ────────────────────────────────────────────────────────── */
+    /*  Convert JSON of non-stream (= generateContent)        */
+    /* ────────────────────────────────────────────────────────── */
+    parseOneShot(data) {
+        const textBlocks = [];
+        const toolBlocks = [];
+        for (const cand of data.candidates ?? []) {
+            for (const part of cand.content?.parts ?? []) {
+                if (part.text) {
+                    textBlocks.push({ type: 'text', text: part.text });
+                }
+                if (part.functionCall) {
+                    toolBlocks.push({
+                        type: 'tool_use',
+                        id: this.genUUID(),
+                        name: part.functionCall.name,
+                        input: part.functionCall.args ?? {},
+                    });
+                }
+                if (part.functionResponse) {
+                    toolBlocks.push({
+                        type: 'tool_result',
+                        tool_use_id: part.functionResponse.name,
+                        content: JSON.stringify(part.functionResponse.response),
+                    });
+                }
+            }
+        }
+        const blocks = [...textBlocks, ...toolBlocks];
+        return {
+            blocks,
+            stop_reason: toolBlocks.some((b) => b.type === 'tool_use')
+                ? 'tool_use'
+                : 'end',
+        };
+    }
+    /* ────────────────────────────────────────────────────────── */
+    /*  chatOnce (text)                                       */
+    /* ────────────────────────────────────────────────────────── */
+    async chatOnce(messages, stream = true, onPartialResponse = () => { }) {
+        const res = await this.callGemini(messages, this.model, stream);
+        return stream
+            ? this.parseStream(res, onPartialResponse)
+            : this.parseOneShot(await res.json());
+    }
+    /* ────────────────────────────────────────────────────────── */
+    /*  visionChatOnce (images)                               */
+    /* ────────────────────────────────────────────────────────── */
+    async visionChatOnce(messages, stream = false) {
+        const res = await this.callGemini(messages, this.visionModel, stream);
+        return stream
+            ? this.parseStream(res, 
+            /* vision is usually stream=false, but just in case */ () => { })
+            : this.parseOneShot(await res.json());
+    }
+    /* ────────────────────────────────────────────────────────── */
+    /*  UUID helper                                           */
+    /* ────────────────────────────────────────────────────────── */
+    genUUID() {
+        return typeof crypto !== 'undefined' && crypto.randomUUID
+            ? crypto.randomUUID()
+            : 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+                const r = (Math.random() * 16) | 0;
+                const v = c === 'x' ? r : (r & 0x3) | 0x8;
+                return v.toString(16);
+            });
+    }
 }
 //# sourceMappingURL=GeminiChatService.js.map