@truefoundry/ai-gateway-sdk 0.0.0-stage → 0.0.2

package/dist/adapters/gemini/requestTransform.js

@@ -0,0 +1,227 @@
+/**
+ * Gemini generateContent → OpenAI Chat Completions request transform.
+ *
+ * Reverses the mapping performed by VertexGoogleChatCompleteConfig /
+ * GoogleChatCompleteConfig in the provider layer.
+ */
+import crypto from 'crypto';
+const GEMINI_ROLE_TO_OPENAI = {
+    user: 'user',
+    model: 'assistant',
+    function: 'tool',
+    system: 'system',
+};
+function transformGeminiToolChoiceToOpenAI(config) {
+    if (!config?.mode)
+        return undefined;
+    const mode = config.mode.toUpperCase();
+    if (mode === 'AUTO')
+        return 'auto';
+    if (mode === 'ANY') {
+        if (config.allowed_function_names?.length === 1) {
+            return { type: 'function', function: { name: config.allowed_function_names[0] } };
+        }
+        return 'required';
+    }
+    if (mode === 'NONE')
+        return 'none';
+    return 'auto';
+}
+export function transformGeminiToChatCompletions(body) {
+    const messages = [];
+    // System instruction → system message
+    if (body.systemInstruction?.parts?.length) {
+        const systemText = body.systemInstruction.parts
+            .filter(p => p.text)
+            .map(p => p.text)
+            .join('\n');
+        if (systemText) {
+            messages.push({ role: 'system', content: systemText });
+        }
+    }
+    // Convert contents → messages
+    for (const content of body.contents ?? []) {
+        const role = GEMINI_ROLE_TO_OPENAI[content.role] || content.role;
+        // Collect parts by type
+        const textParts = [];
+        const toolCalls = [];
+        const functionResponses = [];
+        const imageParts = [];
+        for (const part of content.parts ?? []) {
+            if (part.functionResponse) {
+                functionResponses.push(part);
+            }
+            else if (part.functionCall) {
+                const baseToolCall = {
+                    id: `call-${crypto.randomUUID().slice(0, 8)}`,
+                    type: 'function',
+                    function: {
+                        name: part.functionCall.name,
+                        arguments: JSON.stringify(part.functionCall.args || {}),
+                    },
+                };
+                toolCalls.push(baseToolCall);
+            }
+            else if (part.text != null) {
+                if (part.thought) {
+                    // Intentionally stripped — thinking blocks are provider-specific, not portable
+                }
+                else {
+                    textParts.push(part.text);
+                }
+            }
+            else if (part.inlineData) {
+                imageParts.push({
+                    type: 'image_url',
+                    image_url: {
+                        url: `data:${part.inlineData.mimeType};base64,${part.inlineData.data}`,
+                    },
+                });
+            }
+            else if (part.fileData) {
+                imageParts.push({
+                    type: 'image_url',
+                    image_url: {
+                        url: part.fileData.fileUri,
+                        mime_type: part.fileData.mimeType,
+                    },
+                });
+            }
+        }
+        // Function responses become individual tool messages.
+        // Correlate with tool_call_ids from the preceding assistant message's tool calls.
+        if (functionResponses.length > 0) {
+            for (const fr of functionResponses) {
+                const fnName = fr.functionResponse.name;
+                // Find matching tool_call_id from previous assistant messages
+                let toolCallId = `call-${fnName}`;
+                for (let mi = messages.length - 1; mi >= 0; mi--) {
+                    const prev = messages[mi];
+                    if (prev.role === 'assistant' && prev.tool_calls) {
+                        const match = prev.tool_calls.find((tc) => tc.function?.name === fnName);
+                        if (match) {
+                            toolCallId = match.id;
+                            break;
+                        }
+                    }
+                }
+                messages.push({
+                    role: 'tool',
+                    tool_call_id: toolCallId,
+                    name: fnName,
+                    content: typeof fr.functionResponse.response === 'string'
+                        ? fr.functionResponse.response
+                        : fr.functionResponse.response != null
+                            ? JSON.stringify(fr.functionResponse.response)
+                            : '',
+                });
+            }
+            continue;
+        }
+        // Build OpenAI message
+        const hasMultimodal = imageParts.length > 0;
+        let msgContent;
+        if (hasMultimodal) {
+            const contentParts = [];
+            for (const t of textParts) {
+                contentParts.push({ type: 'text', text: t });
+            }
+            contentParts.push(...imageParts);
+            msgContent = contentParts;
+        }
+        else {
+            msgContent = textParts.join('');
+        }
+        const openAIMsg = { role, content: msgContent };
+        if (toolCalls.length > 0) {
+            openAIMsg.tool_calls = toolCalls;
+        }
+        messages.push(openAIMsg);
+    }
+    const params = {
+        messages,
+        model: body.model || '',
+        stream: body.stream ?? false,
+    };
+    if (params.stream) {
+        params.stream_options = { include_usage: true };
+    }
+    // generationConfig → OpenAI params
+    const gc = body.generationConfig;
+    if (gc) {
+        if (gc.temperature != null)
+            params.temperature = gc.temperature;
+        if (gc.topP != null)
+            params.top_p = gc.topP;
+        if (gc.topK != null)
+            params.top_k = gc.topK;
+        if (gc.maxOutputTokens != null)
+            params.max_completion_tokens = gc.maxOutputTokens;
+        if (gc.stopSequences)
+            params.stop = gc.stopSequences;
+        if (gc.seed != null)
+            params.seed = gc.seed;
+        if (gc.responseLogprobs != null)
+            params.logprobs = gc.responseLogprobs;
+        if (gc.logprobs != null)
+            params.top_logprobs = gc.logprobs;
+        // Response format
+        if (gc.responseMimeType === 'application/json') {
+            if (gc.responseSchema) {
+                params.response_format = {
+                    type: 'json_schema',
+                    json_schema: { schema: gc.responseSchema },
+                };
+            }
+            else {
+                params.response_format = { type: 'json_object' };
+            }
+        }
+        // Thinking config → reasoning_effort or thinking
+        if (gc.thinkingConfig) {
+            if (gc.thinkingConfig.thinkingBudget != null) {
+                params.thinking = {
+                    type: gc.thinkingConfig.includeThoughts ? 'enabled' : 'disabled',
+                    budget_tokens: gc.thinkingConfig.thinkingBudget,
+                };
+            }
+            else if (gc.thinkingConfig.thinkingLevel) {
+                const levelMap = {
+                    THINKING_LEVEL_NONE: 'none',
+                    THINKING_LEVEL_LOW: 'low',
+                    THINKING_LEVEL_MEDIUM: 'medium',
+                    THINKING_LEVEL_HIGH: 'high',
+                };
+                params.reasoning_effort = levelMap[gc.thinkingConfig.thinkingLevel] || 'medium';
+            }
+        }
+    }
+    // tools → OpenAI tools
+    if (body.tools?.length) {
+        const tools = [];
+        for (const toolGroup of body.tools) {
+            if ('functionDeclarations' in toolGroup && Array.isArray(toolGroup.functionDeclarations)) {
+                for (const fn of toolGroup.functionDeclarations) {
+                    tools.push({
+                        type: 'function',
+                        function: {
+                            name: fn.name,
+                            description: fn.description,
+                            parameters: fn.parameters,
+                        },
+                    });
+                }
+            }
+        }
+        if (tools.length > 0)
+            params.tools = tools;
+    }
+    // tool_config → tool_choice
+    if (body.tool_config?.function_calling_config) {
+        const choice = transformGeminiToolChoiceToOpenAI(body.tool_config.function_calling_config);
+        if (choice)
+            params.tool_choice = choice;
+    }
+    return params;
+}
+//# sourceMappingURL=requestTransform.js.map

package/dist/adapters/gemini/requestTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestTransform.js","sourceRoot":"","sources":["../../../src/adapters/gemini/requestTransform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAoD5B,MAAM,qBAAqB,GAA2B;IACpD,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,SAAS,iCAAiC,CACxC,MAA4E;IAE5E,IAAI,CAAC,MAAM,EAAE,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,IAAI,MAAM,CAAC,sBAAsB,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAmB;IAClE,MAAM,QAAQ,GAAU,EAAE,CAAC;IAE3B,sCAAsC;IACtC,IAAI,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;QAEjE,wBAAwB;QACxB,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAU,EAAE,CAAC;QAC5B,MAAM,iBAAiB,GAAU,EAAE,CAAC;QACpC,MAAM,UAAU,GAAU,EAAE,CAAC;QAE7B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAQ;oBACxB,EAAE,EAAE,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBAC7C,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;wBAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC;qBACxD;iBACF,CAAC;gBACF,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,+EAA+E;gBACjF,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC3B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,SAAS,EAAE;wBACT,GAAG,EAAE,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,WAAW,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;qBACvE;iBACF,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACzB,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,SAAS,EAAE;wBACT,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;wBAC1B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;qBAClC;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,kFAAkF;QAClF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBACxC,8DAA8D;gBAC9D,IAAI,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAC;gBAClC,KAAK,IAAI,EAAE,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;oBACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAQ,CAAC;oBACjC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;wBACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;wBAC9E,IAAI,KAAK,EAAE,CAAC;4BACV,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;4BACtB,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM;oBACZ,YAAY,EAAE,UAAU;oBACxB,IAAI,EAAE,MAAM;oBACZ,OAAO,EACL,OAAO,EAAE,CAAC,gBAAgB,CAAC,QAAQ,KAAK,QAAQ;wBAC9C,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ;wBAC9B,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,IAAI,IAAI;4BACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC;4BAC9C,CAAC,CAAC,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,IAAI,UAAe,CAAC;QACpB,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,YAAY,GAAU,EAAE,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YACjC,UAAU,GAAG,YAAY,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,SAAS,GAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAErD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GAAW;QACrB,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,MAAM,EAAG,IAAI,CAAC,MAAkB,IAAI,KAAK;KAC1C,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACjB,MAAc,CAAC,cAAc,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED,mCAAmC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACjC,IAAI,EAAE,EAAE,CAAC;QACP,IAAI,EAAE,CAAC,WAAW,IAAI,IAAI;YAAE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC;QAChE,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI;YAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC;QAC5C,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI;YAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC;QAC5C,IAAI,EAAE,CAAC,eAAe,IAAI,IAAI;YAAE,MAAM,CAAC,qBAAqB,GAAG,EAAE,CAAC,eAAe,CAAC;QAClF,IAAI,EAAE,CAAC,aAAa;YAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,aAAa,CAAC;QACrD,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,gBAAgB,IAAI,IAAI;YAAE,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,gBAAgB,CAAC;QACvE,IAAI,EAAE,CAAC,QAAQ,IAAI,IAAI;YAAE,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC;QAE3D,kBAAkB;QAClB,IAAI,EAAE,CAAC,gBAAgB,KAAK,kBAAkB,EAAE,CAAC;YAC/C,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;gBACtB,MAAM,CAAC,eAAe,GAAG;oBACvB,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,cAAc,EAAE;iBAC3C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YACnD,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,EAAE,CAAC,cAAc,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;gBAC7C,MAAM,CAAC,QAAQ,GAAG;oBAChB,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;oBAChE,aAAa,EAAE,EAAE,CAAC,cAAc,CAAC,cAAc;iBAChD,CAAC;YACJ,CAAC;iBAAM,IAAI,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;gBAC3C,MAAM,QAAQ,GAA+C;oBAC3D,mBAAmB,EAAE,MAAM;oBAC3B,kBAAkB,EAAE,KAAK;oBACzB,qBAAqB,EAAE,QAAQ;oBAC/B,mBAAmB,EAAE,MAAM;iBAC5B,CAAC;gBACF,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAU,EAAE,CAAC;QACxB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,sBAAsB,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACzF,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,oBAAoB,EAAE,CAAC;oBAChD,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE;4BACR,IAAI,EAAE,EAAE,CAAC,IAAI;4BACb,WAAW,EAAE,EAAE,CAAC,WAAW;4BAC3B,UAAU,EAAE,EAAE,CAAC,UAAU;yBAC1B;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC7C,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,uBAAuB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,iCAAiC,CAAC,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAC3F,IAAI,MAAM;YAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/adapters/gemini/responseTransform.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenAI Chat Completions → Gemini generateContent response transform.
+ *
+ * Reverses the mapping performed by GoogleChatCompleteResponseTransform in
+ * src/providers/google-vertex-ai/chatComplete.ts.
+ */
+export declare function transformChatCompletionsToGemini(ccResponse: any, responseStatus: number, provider: string, originalRequest?: any): any;

package/dist/adapters/gemini/responseTransform.js

@@ -0,0 +1,113 @@
+/**
+ * OpenAI Chat Completions → Gemini generateContent response transform.
+ *
+ * Reverses the mapping performed by GoogleChatCompleteResponseTransform in
+ * src/providers/google-vertex-ai/chatComplete.ts.
+ */
+import { parseToolArgumentsByContext } from '../../providers/utils/toolUtils.js';
+import { OPENAI_FINISH_TO_GEMINI } from '../constants.js';
+function mapFinishReason(openAIReason) {
+    if (!openAIReason)
+        return 'STOP';
+    return OPENAI_FINISH_TO_GEMINI[openAIReason] || 'STOP';
+}
+export function transformChatCompletionsToGemini(ccResponse, responseStatus, provider, originalRequest) {
+    if (responseStatus !== 200 || ccResponse?.error) {
+        return {
+            error: {
+                code: responseStatus || 500,
+                message: ccResponse?.error?.message || 'Unknown error',
+                status: ccResponse?.error?.type || 'INTERNAL',
+            },
+        };
+    }
+    const choice = ccResponse.choices?.[0];
+    if (!choice) {
+        return {
+            error: {
+                code: 500,
+                message: 'No choices in response',
+                status: 'INTERNAL',
+            },
+        };
+    }
+    const message = choice.message || {};
+    const parts = [];
+    // Reconstruct thinking parts from thinking_blocks
+    if (message.thinking_blocks?.length) {
+        for (const block of message.thinking_blocks) {
+            if (block.type === 'thinking') {
+                parts.push({
+                    text: block.thinking || '',
+                    thought: true,
+                    ...(block.signature && { thoughtSignature: block.signature }),
+                });
+            }
+        }
+    }
+    // Text content — handle both string and array (multimodal) formats
+    if (message.content) {
+        if (typeof message.content === 'string') {
+            parts.push({ text: message.content });
+        }
+        else if (Array.isArray(message.content)) {
+            for (const part of message.content) {
+                if (part.type === 'text' && part.text) {
+                    parts.push({ text: part.text });
+                }
+            }
+        }
+    }
+    // Tool calls → functionCall parts
+    if (message.tool_calls?.length) {
+        for (const tc of message.tool_calls) {
+            if (!tc.function)
+                continue;
+            const part = {
+                functionCall: {
+                    name: tc.function.name,
+                    args: parseToolArgumentsByContext(tc.function.arguments, {
+                        provider,
+                        model: originalRequest?.model ?? ccResponse?.model,
+                    }),
+                },
+            };
+            const thoughtSig = tc.provider_specific_fields?.thought_signature;
+            if (thoughtSig) {
+                part.thoughtSignature = thoughtSig;
+            }
+            parts.push(part);
+        }
+    }
+    // Build usage metadata
+    const usage = ccResponse.usage || {};
+    const promptTokenCount = usage.prompt_tokens ?? 0;
+    const candidatesTokenCount = usage.completion_tokens ?? 0;
+    const totalTokenCount = usage.total_tokens ?? 0;
+    const thoughtsTokenCount = usage.completion_tokens_details?.reasoning_tokens ?? 0;
+    const cachedContentTokenCount = usage.prompt_tokens_details?.cached_tokens ?? 0;
+    const response = {
+        candidates: [
+            {
+                content: {
+                    parts,
+                    role: 'model',
+                },
+                finishReason: mapFinishReason(choice.finish_reason),
+                index: 0,
+            },
+        ],
+        usageMetadata: {
+            promptTokenCount,
+            candidatesTokenCount,
+            totalTokenCount,
+            ...(thoughtsTokenCount > 0 && { thoughtsTokenCount }),
+            ...(cachedContentTokenCount > 0 && { cachedContentTokenCount }),
+        },
+    };
+    if (ccResponse.model) {
+        response.modelVersion = ccResponse.model;
+    }
+    return response;
+}
+//# sourceMappingURL=responseTransform.js.map

package/dist/adapters/gemini/responseTransform.js.map

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

package/dist/adapters/gemini/streamTransform.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAI CC SSE stream → Gemini generateContent stream events.
+ *
+ * Gemini streaming uses the same `GoogleGenerateContentResponse` shape as
+ * non-streaming, wrapped in `data: {json}` SSE lines. Each chunk contains
+ * the current candidate delta with `content.parts` and partial `usageMetadata`.
+ */
+import { AdapterStreamState } from '../types.js';
+export interface GeminiStreamState extends AdapterStreamState {
+    done: boolean;
+    /** Accumulated tool call arguments across chunks, keyed by tool call index */
+    toolCallArgs: Map<number, {
+        id?: string;
+        name: string;
+        args: string;
+        thoughtSignature?: string;
+    }>;
+    model?: string;
+    provider?: string;
+}
+export declare function createGeminiStreamState(): GeminiStreamState;
+export declare function transformGeminiStreamChunk(chunk: string, state: GeminiStreamState): string | undefined;

package/dist/adapters/gemini/streamTransform.js

@@ -0,0 +1,174 @@
+/**
+ * OpenAI CC SSE stream → Gemini generateContent stream events.
+ *
+ * Gemini streaming uses the same `GoogleGenerateContentResponse` shape as
+ * non-streaming, wrapped in `data: {json}` SSE lines. Each chunk contains
+ * the current candidate delta with `content.parts` and partial `usageMetadata`.
+ */
+import { parseToolArgumentsByContext } from '../../providers/utils/toolUtils.js';
+import { OPENAI_FINISH_TO_GEMINI } from '../constants.js';
+export function createGeminiStreamState() {
+    return {
+        done: false,
+        toolCallArgs: new Map(),
+    };
+}
+export function transformGeminiStreamChunk(chunk, state) {
+    if (state.done)
+        return undefined;
+    const trimmed = chunk
+        .trim()
+        .replace(/^data: /, '')
+        .trim();
+    if (trimmed === '[DONE]') {
+        state.done = true;
+        // Flush any accumulated tool calls that weren't emitted via finish_reason
+        if (state.toolCallArgs.size > 0) {
+            const parts = [];
+            for (const [, tc] of state.toolCallArgs) {
+                const part = {
+                    functionCall: {
+                        name: tc.name,
+                        args: parseToolArgumentsByContext(tc.args, {
+                            model: state.model,
+                            provider: state.provider,
+                        }),
+                    },
+                };
+                if (tc.thoughtSignature) {
+                    part.thoughtSignature = tc.thoughtSignature;
+                }
+                parts.push(part);
+            }
+            state.toolCallArgs.clear();
+            return `data: ${JSON.stringify({
+                candidates: [
+                    {
+                        content: { parts, role: 'model' },
+                        index: 0,
+                        finishReason: 'STOP',
+                    },
+                ],
+            })}\n\n`;
+        }
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    state.model = parsed.model ?? state.model;
+    state.provider = parsed.provider ?? state.provider;
+    const choice = parsed.choices?.[0];
+    const delta = choice?.delta || {};
+    const parts = [];
+    // Thinking blocks → thought parts
+    if (delta.thinking_blocks?.length) {
+        for (const block of delta.thinking_blocks) {
+            if (block.type === 'thinking') {
+                parts.push({
+                    text: block.thinking || '',
+                    thought: true,
+                    ...(block.signature && { thoughtSignature: block.signature }),
+                });
+            }
+            else if (block.type === 'redacted_thinking') {
+                parts.push({
+                    text: '',
+                    thought: true,
+                    ...(block.data && { thoughtSignature: block.data }),
+                });
+            }
+        }
+    }
+    // Text content
+    if (delta.content != null && delta.content !== '') {
+        parts.push({ text: delta.content });
+    }
+    // Tool calls → functionCall parts
+    // CC streaming sends tool_calls across multiple chunks:
+    //   1. First chunk has `function.name` + initial `arguments` fragment
+    //   2. Subsequent chunks have only `function.arguments` (partial JSON)
+    // We accumulate argument strings in state and emit the complete functionCall
+    // only when finish_reason arrives (below).
+    if (delta.tool_calls?.length) {
+        for (const tc of delta.tool_calls) {
+            const idx = tc.index ?? 0;
+            if (tc.function?.name) {
+                state.toolCallArgs.set(idx, {
+                    id: tc.id,
+                    name: tc.function.name,
+                    args: tc.function.arguments || '',
+                    ...(tc.provider_specific_fields?.thought_signature && {
+                        thoughtSignature: tc.provider_specific_fields.thought_signature,
+                    }),
+                });
+            }
+            else if (tc.function?.arguments) {
+                const existing = state.toolCallArgs.get(idx);
+                if (existing) {
+                    existing.args += tc.function.arguments;
+                }
+            }
+        }
+    }
+    // On finish_reason, emit accumulated tool calls as functionCall parts
+    if (choice?.finish_reason && state.toolCallArgs.size > 0) {
+        for (const [, tc] of state.toolCallArgs) {
+            const part = {
+                functionCall: {
+                    name: tc.name,
+                    args: parseToolArgumentsByContext(tc.args, {
+                        model: state.model,
+                        provider: state.provider,
+                    }),
+                },
+            };
+            if (tc.thoughtSignature) {
+                part.thoughtSignature = tc.thoughtSignature;
+            }
+            parts.push(part);
+        }
+        state.toolCallArgs.clear();
+    }
+    // Build Gemini-style chunk
+    const geminiChunk = {};
+    if (choice) {
+        geminiChunk.candidates = [
+            {
+                content: {
+                    parts: parts.length > 0 ? parts : [{ text: '' }],
+                    role: 'model',
+                },
+                index: 0,
+                ...(choice.finish_reason && {
+                    finishReason: OPENAI_FINISH_TO_GEMINI[choice.finish_reason] || 'STOP',
+                }),
+            },
+        ];
+    }
+    // Usage metadata (may arrive in a separate chunk without candidates)
+    if (parsed.usage) {
+        geminiChunk.usageMetadata = {
+            promptTokenCount: parsed.usage.prompt_tokens ?? 0,
+            candidatesTokenCount: parsed.usage.completion_tokens ?? 0,
+            totalTokenCount: parsed.usage.total_tokens ?? 0,
+            ...(parsed.usage.completion_tokens_details?.reasoning_tokens && {
+                thoughtsTokenCount: parsed.usage.completion_tokens_details.reasoning_tokens,
+            }),
+            ...(parsed.usage.prompt_tokens_details?.cached_tokens && {
+                cachedContentTokenCount: parsed.usage.prompt_tokens_details.cached_tokens,
+            }),
+        };
+    }
+    if (parsed.model) {
+        geminiChunk.modelVersion = parsed.model;
+    }
+    if (!geminiChunk.candidates && !geminiChunk.usageMetadata)
+        return undefined;
+    return `data: ${JSON.stringify(geminiChunk)}\n\n`;
+}
+//# sourceMappingURL=streamTransform.js.map

package/dist/adapters/gemini/streamTransform.js.map

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

package/dist/adapters/guardrailHelpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * P6.2 — Injected guardrail extract/reconstruct port for format adapters.
+ *
+ * Types are SDK-owned structural copies of the live plugin shapes so the
+ * adapters tree never imports `plugins/` or `guardrails/`. Real plugin engines
+ * are wired by the gateway in P7.
+ */
+/** Which conversation turns guardrails evaluate (`all` | `last` | last-N). */
+export type GuardrailsScope = 'all' | 'last' | number;
+/** Configuration for guardrail message processing. */
+export interface GuardrailsRunConfig {
+    scope: GuardrailsScope;
+}
+/** Location info for an extracted message text (reconstruction). */
+export interface MessageLocation {
+    text: string;
+    messageIndex: number;
+    contentIndex: number | null;
+    role?: string;
+    source?: 'tool_calls' | 'tool_result';
+}
+/** Result of message extraction with location tracking for reconstruction. */
+export interface ExtractedMessages {
+    messages: string[];
+    locations: MessageLocation[];
+    original: any;
+}
+/** Normalized text slice for validate-only guardrails. */
+export type ContentItem = {
+    type: 'text';
+    text: string;
+    role?: string;
+};
+/** Hook lifecycle event type (structural; no plugins import). */
+export type HookEventType = 'beforeRequestHook' | 'afterRequestHook' | 'mcpPreTool' | 'mcpPostTool';
+/**
+ * Port injected into format-adapter factories.
+ * Gateway (P7) builds an implementation from plugins; SDK defaults throw.
+ */
+export interface GuardrailHelpers {
+    extractMessages(body: any, config: GuardrailsRunConfig): ExtractedMessages;
+    reconstructMessages(extracted: ExtractedMessages, transformedMessages: string[]): any;
+    extractContentForValidation(json: any, eventType: HookEventType, config: GuardrailsRunConfig): ContentItem[];
+}
+/**
+ * Default helpers for {@link initAdapters} until P7 injects real plugins.
+ * Accidental guardrail use fails loudly rather than silently no-oping.
+ */
+export declare function createThrowingGuardrailHelpers(): GuardrailHelpers;

package/dist/adapters/guardrailHelpers.js

@@ -0,0 +1,23 @@
+/**
+ * P6.2 — Injected guardrail extract/reconstruct port for format adapters.
+ *
+ * Types are SDK-owned structural copies of the live plugin shapes so the
+ * adapters tree never imports `plugins/` or `guardrails/`. Real plugin engines
+ * are wired by the gateway in P7.
+ */
+/**
+ * Default helpers for {@link initAdapters} until P7 injects real plugins.
+ * Accidental guardrail use fails loudly rather than silently no-oping.
+ */
+export function createThrowingGuardrailHelpers() {
+    const fail = (method) => {
+        throw new Error(`GuardrailHelpers.${method} was called but no helpers were injected. ` +
+            `Pass create*Adapter(helpers) with a real port (P7), or a mock in tests.`);
+    };
+    return {
+        extractMessages: () => fail('extractMessages'),
+        reconstructMessages: () => fail('reconstructMessages'),
+        extractContentForValidation: () => fail('extractContentForValidation'),
+    };
+}
+//# sourceMappingURL=guardrailHelpers.js.map

package/dist/adapters/guardrailHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrailHelpers.js","sourceRoot":"","sources":["../../src/adapters/guardrailHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0CH;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,IAAI,GAAG,CAAC,MAAc,EAAS,EAAE;QACrC,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,4CAA4C;YACpE,yEAAyE,CAC5E,CAAC;IACJ,CAAC,CAAC;IACF,OAAO;QACL,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC9C,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC;QACtD,2BAA2B,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC;KACvE,CAAC;AACJ,CAAC"}