@animalabs/membrane 0.5.13 → 0.5.15

package/dist/providers/gemini.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Google Gemini provider adapter
+ *
+ * Direct adapter for Google's Generative AI REST API.
+ * Supports Gemini 2.x, 2.5, 3.x models with:
+ * - Text and image input
+ * - Tool/function calling
+ * - Streaming via SSE
+ *
+ * Auth: API key passed as query parameter (?key=...)
+ * Endpoint: generativelanguage.googleapis.com/v1beta
+ */
+import type { ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks, ContentBlock } from '../types/index.js';
+interface GeminiPart {
+    text?: string;
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+    functionCall?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    functionResponse?: {
+        name: string;
+        response: Record<string, unknown>;
+    };
+}
+export interface GeminiAdapterConfig {
+    /** Google AI API key */
+    apiKey?: string;
+    /** Base URL (default: https://generativelanguage.googleapis.com/v1beta) */
+    baseURL?: string;
+    /** Default max output tokens */
+    defaultMaxTokens?: number;
+}
+export declare class GeminiAdapter implements ProviderAdapter {
+    readonly name = "gemini";
+    private apiKey;
+    private baseURL;
+    private defaultMaxTokens;
+    constructor(config?: GeminiAdapterConfig);
+    supportsModel(modelId: string): boolean;
+    complete(request: ProviderRequest, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    stream(request: ProviderRequest, callbacks: StreamCallbacks, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    private buildRequest;
+    private convertMessages;
+    /**
+     * Gemini requires strictly alternating user/model messages.
+     * Merge consecutive messages with the same role into one.
+     */
+    private mergeConsecutiveRoles;
+    private convertTools;
+    private parseResponse;
+    private buildContentBlocks;
+    private mapFinishReason;
+    private handleError;
+}
+/**
+ * Convert normalized content blocks to Gemini parts
+ */
+export declare function toGeminiParts(blocks: ContentBlock[]): GeminiPart[];
+/**
+ * Convert Gemini parts to normalized content blocks
+ */
+export declare function fromGeminiParts(parts: GeminiPart[]): ContentBlock[];
+export {};
+//# sourceMappingURL=gemini.d.ts.map

package/dist/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAe3B,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC/D,gBAAgB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACxE;AA6CD,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,GAAE,mBAAwB;IAU5C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjC,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IA8BtB,MAAM,CACV,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAoG5B,OAAO,CAAC,YAAY;IAoDpB,OAAO,CAAC,eAAe;IA2EvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,WAAW;CAyCpB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAelE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,CAkBnE"}

package/dist/providers/gemini.js

@@ -0,0 +1,441 @@
+/**
+ * Google Gemini provider adapter
+ *
+ * Direct adapter for Google's Generative AI REST API.
+ * Supports Gemini 2.x, 2.5, 3.x models with:
+ * - Text and image input
+ * - Tool/function calling
+ * - Streaming via SSE
+ *
+ * Auth: API key passed as query parameter (?key=...)
+ * Endpoint: generativelanguage.googleapis.com/v1beta
+ */
+import { MembraneError, rateLimitError, contextLengthError, authError, serverError, abortError, networkError, } from '../types/index.js';
+// ============================================================================
+// Gemini Adapter
+// ============================================================================
+export class GeminiAdapter {
+    name = 'gemini';
+    apiKey;
+    baseURL;
+    defaultMaxTokens;
+    constructor(config = {}) {
+        this.apiKey = config.apiKey ?? process.env.GOOGLE_API_KEY ?? '';
+        this.baseURL = (config.baseURL ?? 'https://generativelanguage.googleapis.com/v1beta').replace(/\/$/, '');
+        this.defaultMaxTokens = config.defaultMaxTokens ?? 4096;
+        if (!this.apiKey) {
+            throw new Error('Google AI API key not provided');
+        }
+    }
+    supportsModel(modelId) {
+        return modelId.startsWith('gemini-');
+    }
+    async complete(request, options) {
+        const geminiRequest = this.buildRequest(request);
+        options?.onRequest?.(geminiRequest);
+        try {
+            const url = `${this.baseURL}/models/${request.model}:generateContent?key=${this.apiKey}`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(geminiRequest),
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Gemini API error: ${response.status} ${errorText}`);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(`Gemini API error: ${data.error.code} ${data.error.message}`);
+            }
+            return this.parseResponse(data, request.model, geminiRequest);
+        }
+        catch (error) {
+            throw this.handleError(error, geminiRequest);
+        }
+    }
+    async stream(request, callbacks, options) {
+        const geminiRequest = this.buildRequest(request);
+        options?.onRequest?.(geminiRequest);
+        try {
+            const url = `${this.baseURL}/models/${request.model}:streamGenerateContent?alt=sse&key=${this.apiKey}`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(geminiRequest),
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Gemini API error: ${response.status} ${errorText}`);
+            }
+            const reader = response.body?.getReader();
+            if (!reader) {
+                throw new Error('No response body');
+            }
+            const decoder = new TextDecoder();
+            let accumulated = '';
+            let finishReason = 'STOP';
+            let toolCalls = [];
+            let lastUsage;
+            let buffer = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                // Keep the last potentially incomplete line in buffer
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const data = line.slice(6).trim();
+                    if (!data || data === '[DONE]')
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const candidate = parsed.candidates?.[0];
+                        if (candidate?.content?.parts) {
+                            for (const part of candidate.content.parts) {
+                                if (part.text) {
+                                    accumulated += part.text;
+                                    callbacks.onChunk(part.text);
+                                }
+                                if (part.functionCall) {
+                                    toolCalls.push({
+                                        name: part.functionCall.name,
+                                        args: part.functionCall.args,
+                                    });
+                                }
+                            }
+                        }
+                        if (candidate?.finishReason) {
+                            finishReason = candidate.finishReason;
+                        }
+                        if (parsed.usageMetadata) {
+                            lastUsage = parsed.usageMetadata;
+                        }
+                    }
+                    catch {
+                        // Ignore parse errors in stream chunks
+                    }
+                }
+            }
+            return {
+                content: this.buildContentBlocks(accumulated, toolCalls),
+                stopReason: this.mapFinishReason(finishReason),
+                stopSequence: undefined,
+                usage: {
+                    inputTokens: lastUsage?.promptTokenCount ?? 0,
+                    outputTokens: lastUsage?.candidatesTokenCount ?? 0,
+                    cacheReadTokens: lastUsage?.cachedContentTokenCount
+                        ? lastUsage.cachedContentTokenCount
+                        : undefined,
+                },
+                model: request.model,
+                rawRequest: geminiRequest,
+                raw: { finishReason, usage: lastUsage },
+            };
+        }
+        catch (error) {
+            throw this.handleError(error, geminiRequest);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Request Building
+    // --------------------------------------------------------------------------
+    buildRequest(request) {
+        const contents = this.convertMessages(request.messages);
+        const maxTokens = request.maxTokens || this.defaultMaxTokens;
+        const geminiRequest = { contents };
+        // System instruction
+        if (request.system) {
+            const systemText = typeof request.system === 'string'
+                ? request.system
+                : request.system
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join('\n');
+            if (systemText) {
+                geminiRequest.systemInstruction = {
+                    parts: [{ text: systemText }],
+                };
+            }
+        }
+        // Generation config
+        geminiRequest.generationConfig = {
+            maxOutputTokens: maxTokens,
+        };
+        if (request.temperature !== undefined) {
+            geminiRequest.generationConfig.temperature = request.temperature;
+        }
+        if (request.stopSequences && request.stopSequences.length > 0) {
+            // Gemini API limits stop sequences to 5
+            geminiRequest.generationConfig.stopSequences = request.stopSequences.slice(0, 5);
+        }
+        // Tools
+        if (request.tools && request.tools.length > 0) {
+            geminiRequest.tools = [{
+                    functionDeclarations: this.convertTools(request.tools),
+                }];
+        }
+        // Extra params
+        if (request.extra) {
+            const { normalizedMessages, prompt, ...rest } = request.extra;
+            Object.assign(geminiRequest, rest);
+        }
+        return geminiRequest;
+    }
+    convertMessages(messages) {
+        const contents = [];
+        for (const msg of messages) {
+            const role = msg.role === 'assistant' ? 'model' : 'user';
+            // Simple string content
+            if (typeof msg.content === 'string') {
+                contents.push({ role, parts: [{ text: msg.content }] });
+                continue;
+            }
+            // Array content blocks (Anthropic-style)
+            if (Array.isArray(msg.content)) {
+                const parts = [];
+                const toolResultParts = [];
+                for (const block of msg.content) {
+                    if (block.type === 'text') {
+                        if (block.text)
+                            parts.push({ text: block.text });
+                    }
+                    else if (block.type === 'image') {
+                        // Anthropic image format → Gemini inlineData
+                        const source = block.source;
+                        if (source?.type === 'base64' && source.data) {
+                            parts.push({
+                                inlineData: {
+                                    mimeType: source.media_type ?? 'image/jpeg',
+                                    data: source.data,
+                                },
+                            });
+                        }
+                    }
+                    else if (block.type === 'tool_use') {
+                        parts.push({
+                            functionCall: {
+                                name: block.name,
+                                args: block.input ?? {},
+                            },
+                        });
+                    }
+                    else if (block.type === 'tool_result') {
+                        const resultContent = typeof block.content === 'string'
+                            ? block.content
+                            : JSON.stringify(block.content);
+                        toolResultParts.push({
+                            functionResponse: {
+                                name: block.name ?? block.tool_use_id ?? 'unknown',
+                                response: { result: resultContent },
+                            },
+                        });
+                    }
+                }
+                // Tool results go in a user message
+                if (toolResultParts.length > 0) {
+                    contents.push({ role: 'user', parts: toolResultParts });
+                }
+                if (parts.length > 0) {
+                    contents.push({ role, parts });
+                }
+                continue;
+            }
+            // Null/empty content — skip
+            if (msg.content === null || msg.content === undefined)
+                continue;
+            // Fallback
+            contents.push({ role, parts: [{ text: String(msg.content) }] });
+        }
+        // Gemini requires alternating user/model roles.
+        // Merge consecutive same-role messages.
+        return this.mergeConsecutiveRoles(contents);
+    }
+    /**
+     * Gemini requires strictly alternating user/model messages.
+     * Merge consecutive messages with the same role into one.
+     */
+    mergeConsecutiveRoles(contents) {
+        if (contents.length === 0)
+            return contents;
+        const merged = [contents[0]];
+        for (let i = 1; i < contents.length; i++) {
+            const current = contents[i];
+            const last = merged[merged.length - 1];
+            if (current.role === last.role) {
+                // Merge parts into the previous message
+                last.parts.push(...current.parts);
+            }
+            else {
+                merged.push(current);
+            }
+        }
+        // Gemini also requires the first message to be "user"
+        if (merged.length > 0 && merged[0].role !== 'user') {
+            merged.unshift({ role: 'user', parts: [{ text: '[Start]' }] });
+        }
+        return merged;
+    }
+    convertTools(tools) {
+        return tools.map(tool => {
+            const schema = tool.inputSchema || tool.input_schema || { type: 'object', properties: {} };
+            return {
+                name: tool.name,
+                description: tool.description ?? '',
+                parameters: schema,
+            };
+        });
+    }
+    // --------------------------------------------------------------------------
+    // Response Parsing
+    // --------------------------------------------------------------------------
+    parseResponse(response, requestedModel, rawRequest) {
+        const candidate = response.candidates?.[0];
+        const parts = candidate?.content?.parts ?? [];
+        let text = '';
+        const toolCalls = [];
+        for (const part of parts) {
+            if (part.text)
+                text += part.text;
+            if (part.functionCall) {
+                toolCalls.push({
+                    name: part.functionCall.name,
+                    args: part.functionCall.args,
+                });
+            }
+        }
+        return {
+            content: this.buildContentBlocks(text, toolCalls),
+            stopReason: this.mapFinishReason(candidate?.finishReason),
+            stopSequence: undefined,
+            usage: {
+                inputTokens: response.usageMetadata?.promptTokenCount ?? 0,
+                outputTokens: response.usageMetadata?.candidatesTokenCount ?? 0,
+                cacheReadTokens: response.usageMetadata?.cachedContentTokenCount
+                    ? response.usageMetadata.cachedContentTokenCount
+                    : undefined,
+            },
+            model: response.modelVersion ?? requestedModel,
+            rawRequest,
+            raw: response,
+        };
+    }
+    buildContentBlocks(text, toolCalls) {
+        const content = [];
+        if (text) {
+            content.push({ type: 'text', text });
+        }
+        for (const tc of toolCalls) {
+            content.push({
+                type: 'tool_use',
+                id: `gemini-tc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+                name: tc.name,
+                input: tc.args,
+            });
+        }
+        return content;
+    }
+    mapFinishReason(reason) {
+        switch (reason) {
+            case 'STOP':
+                return 'end_turn';
+            case 'MAX_TOKENS':
+                return 'max_tokens';
+            case 'SAFETY':
+                return 'refusal';
+            case 'RECITATION':
+                return 'refusal';
+            case 'TOOL_CALLS':
+            case 'FUNCTION_CALL':
+                return 'tool_use';
+            default:
+                return 'end_turn';
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Error Handling
+    // --------------------------------------------------------------------------
+    handleError(error, rawRequest) {
+        if (error instanceof MembraneError)
+            return error;
+        if (error instanceof Error) {
+            const message = error.message;
+            if (message.includes('401') || message.includes('403') || message.includes('API_KEY_INVALID') || message.includes('PERMISSION_DENIED')) {
+                return authError(message, error, rawRequest);
+            }
+            if (message.includes('429') || message.includes('RESOURCE_EXHAUSTED')) {
+                const retryMatch = message.match(/retry.after[:\s]*(\d+)/i);
+                const retryAfter = retryMatch?.[1] ? parseInt(retryMatch[1], 10) * 1000 : undefined;
+                return rateLimitError(message, retryAfter, error, rawRequest);
+            }
+            if (message.includes('context') || message.includes('too long') || message.includes('token limit')) {
+                return contextLengthError(message, error, rawRequest);
+            }
+            if (message.includes('500') || message.includes('502') || message.includes('503') || message.includes('INTERNAL')) {
+                return serverError(message, undefined, error, rawRequest);
+            }
+            if (error.name === 'AbortError') {
+                return abortError(undefined, rawRequest);
+            }
+            if (message.includes('network') || message.includes('fetch') || message.includes('ECONNREFUSED')) {
+                return networkError(message, error, rawRequest);
+            }
+        }
+        return new MembraneError({
+            type: 'unknown',
+            message: error instanceof Error ? error.message : String(error),
+            retryable: false,
+            rawError: error,
+            rawRequest,
+        });
+    }
+}
+// ============================================================================
+// Content Conversion Utilities
+// ============================================================================
+/**
+ * Convert normalized content blocks to Gemini parts
+ */
+export function toGeminiParts(blocks) {
+    return blocks.map(block => {
+        if (block.type === 'text') {
+            return { text: block.text };
+        }
+        if (block.type === 'tool_use') {
+            return {
+                functionCall: {
+                    name: block.name,
+                    args: block.input ?? {},
+                },
+            };
+        }
+        return { text: String(block) };
+    });
+}
+/**
+ * Convert Gemini parts to normalized content blocks
+ */
+export function fromGeminiParts(parts) {
+    const result = [];
+    for (const part of parts) {
+        if (part.text) {
+            result.push({ type: 'text', text: part.text });
+        }
+        if (part.functionCall) {
+            result.push({
+                type: 'tool_use',
+                id: `gemini-tc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+                name: part.functionCall.name,
+                input: part.functionCall.args,
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

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

package/dist/providers/index.d.ts

@@ -8,4 +8,5 @@ export { OpenAICompatibleAdapter, toOpenAIMessages, fromOpenAIMessage, type Open
 export { OpenAICompletionsAdapter, type OpenAICompletionsAdapterConfig, } from './openai-completions.js';
 export { MockAdapter, createEchoAdapter, createCannedAdapter, type MockAdapterConfig, } from './mock.js';
 export { BedrockAdapter, type BedrockAdapterConfig, } from './bedrock.js';
+export { GeminiAdapter, toGeminiParts, fromGeminiParts, type GeminiAdapterConfig, } from './gemini.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,6BAA6B,GACnC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,6BAA6B,GACnC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC"}

package/dist/providers/index.js

@@ -8,4 +8,5 @@ export { OpenAICompatibleAdapter, toOpenAIMessages, fromOpenAIMessage, } from '.
 export { OpenAICompletionsAdapter, } from './openai-completions.js';
 export { MockAdapter, createEchoAdapter, createCannedAdapter, } from './mock.js';
 export { BedrockAdapter, } from './bedrock.js';
+export { GeminiAdapter, toGeminiParts, fromGeminiParts, } from './gemini.js';
 //# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,GAElB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,GAEf,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,GAElB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,cAAc,GAEf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,GAEhB,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animalabs/membrane",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "LLM middleware - a selective boundary that transforms what passes through",
   "type": "module",
   "main": "./dist/index.js",

package/src/providers/gemini.ts

@@ -0,0 +1,599 @@
+/**
+ * Google Gemini provider adapter
+ *
+ * Direct adapter for Google's Generative AI REST API.
+ * Supports Gemini 2.x, 2.5, 3.x models with:
+ * - Text and image input
+ * - Tool/function calling
+ * - Streaming via SSE
+ *
+ * Auth: API key passed as query parameter (?key=...)
+ * Endpoint: generativelanguage.googleapis.com/v1beta
+ */
+
+import type {
+  ProviderAdapter,
+  ProviderRequest,
+  ProviderRequestOptions,
+  ProviderResponse,
+  StreamCallbacks,
+  ContentBlock,
+} from '../types/index.js';
+import {
+  MembraneError,
+  rateLimitError,
+  contextLengthError,
+  authError,
+  serverError,
+  abortError,
+  networkError,
+} from '../types/index.js';
+
+// ============================================================================
+// Gemini API Types
+// ============================================================================
+
+interface GeminiPart {
+  text?: string;
+  inlineData?: { mimeType: string; data: string };
+  functionCall?: { name: string; args: Record<string, unknown> };
+  functionResponse?: { name: string; response: Record<string, unknown> };
+}
+
+interface GeminiContent {
+  role: 'user' | 'model';
+  parts: GeminiPart[];
+}
+
+interface GeminiRequest {
+  contents: GeminiContent[];
+  systemInstruction?: { parts: GeminiPart[] };
+  generationConfig?: {
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    stopSequences?: string[];
+  };
+  tools?: { functionDeclarations: GeminiFunctionDeclaration[] }[];
+}
+
+interface GeminiFunctionDeclaration {
+  name: string;
+  description: string;
+  parameters?: Record<string, unknown>;
+}
+
+interface GeminiResponse {
+  candidates?: {
+    content?: GeminiContent;
+    finishReason?: string;
+    safetyRatings?: unknown[];
+  }[];
+  usageMetadata?: {
+    promptTokenCount?: number;
+    candidatesTokenCount?: number;
+    totalTokenCount?: number;
+    cachedContentTokenCount?: number;
+  };
+  modelVersion?: string;
+  error?: { code: number; message: string; status: string };
+}
+
+// ============================================================================
+// Adapter Configuration
+// ============================================================================
+
+export interface GeminiAdapterConfig {
+  /** Google AI API key */
+  apiKey?: string;
+
+  /** Base URL (default: https://generativelanguage.googleapis.com/v1beta) */
+  baseURL?: string;
+
+  /** Default max output tokens */
+  defaultMaxTokens?: number;
+}
+
+// ============================================================================
+// Gemini Adapter
+// ============================================================================
+
+export class GeminiAdapter implements ProviderAdapter {
+  readonly name = 'gemini';
+  private apiKey: string;
+  private baseURL: string;
+  private defaultMaxTokens: number;
+
+  constructor(config: GeminiAdapterConfig = {}) {
+    this.apiKey = config.apiKey ?? process.env.GOOGLE_API_KEY ?? '';
+    this.baseURL = (config.baseURL ?? 'https://generativelanguage.googleapis.com/v1beta').replace(/\/$/, '');
+    this.defaultMaxTokens = config.defaultMaxTokens ?? 4096;
+
+    if (!this.apiKey) {
+      throw new Error('Google AI API key not provided');
+    }
+  }
+
+  supportsModel(modelId: string): boolean {
+    return modelId.startsWith('gemini-');
+  }
+
+  async complete(
+    request: ProviderRequest,
+    options?: ProviderRequestOptions
+  ): Promise<ProviderResponse> {
+    const geminiRequest = this.buildRequest(request);
+    options?.onRequest?.(geminiRequest);
+
+    try {
+      const url = `${this.baseURL}/models/${request.model}:generateContent?key=${this.apiKey}`;
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(geminiRequest),
+        signal: options?.signal,
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Gemini API error: ${response.status} ${errorText}`);
+      }
+
+      const data = await response.json() as GeminiResponse;
+
+      if (data.error) {
+        throw new Error(`Gemini API error: ${data.error.code} ${data.error.message}`);
+      }
+
+      return this.parseResponse(data, request.model, geminiRequest);
+    } catch (error) {
+      throw this.handleError(error, geminiRequest);
+    }
+  }
+
+  async stream(
+    request: ProviderRequest,
+    callbacks: StreamCallbacks,
+    options?: ProviderRequestOptions
+  ): Promise<ProviderResponse> {
+    const geminiRequest = this.buildRequest(request);
+    options?.onRequest?.(geminiRequest);
+
+    try {
+      const url = `${this.baseURL}/models/${request.model}:streamGenerateContent?alt=sse&key=${this.apiKey}`;
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(geminiRequest),
+        signal: options?.signal,
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Gemini API error: ${response.status} ${errorText}`);
+      }
+
+      const reader = response.body?.getReader();
+      if (!reader) {
+        throw new Error('No response body');
+      }
+
+      const decoder = new TextDecoder();
+      let accumulated = '';
+      let finishReason = 'STOP';
+      let toolCalls: { name: string; args: Record<string, unknown> }[] = [];
+      let lastUsage: GeminiResponse['usageMetadata'] | undefined;
+      let buffer = '';
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        // Keep the last potentially incomplete line in buffer
+        buffer = lines.pop() ?? '';
+
+        for (const line of lines) {
+          if (!line.startsWith('data: ')) continue;
+          const data = line.slice(6).trim();
+          if (!data || data === '[DONE]') continue;
+
+          try {
+            const parsed = JSON.parse(data) as GeminiResponse;
+            const candidate = parsed.candidates?.[0];
+
+            if (candidate?.content?.parts) {
+              for (const part of candidate.content.parts) {
+                if (part.text) {
+                  accumulated += part.text;
+                  callbacks.onChunk(part.text);
+                }
+                if (part.functionCall) {
+                  toolCalls.push({
+                    name: part.functionCall.name,
+                    args: part.functionCall.args,
+                  });
+                }
+              }
+            }
+
+            if (candidate?.finishReason) {
+              finishReason = candidate.finishReason;
+            }
+
+            if (parsed.usageMetadata) {
+              lastUsage = parsed.usageMetadata;
+            }
+          } catch {
+            // Ignore parse errors in stream chunks
+          }
+        }
+      }
+
+      return {
+        content: this.buildContentBlocks(accumulated, toolCalls),
+        stopReason: this.mapFinishReason(finishReason),
+        stopSequence: undefined,
+        usage: {
+          inputTokens: lastUsage?.promptTokenCount ?? 0,
+          outputTokens: lastUsage?.candidatesTokenCount ?? 0,
+          cacheReadTokens: lastUsage?.cachedContentTokenCount
+            ? lastUsage.cachedContentTokenCount
+            : undefined,
+        },
+        model: request.model,
+        rawRequest: geminiRequest,
+        raw: { finishReason, usage: lastUsage },
+      };
+    } catch (error) {
+      throw this.handleError(error, geminiRequest);
+    }
+  }
+
+  // --------------------------------------------------------------------------
+  // Request Building
+  // --------------------------------------------------------------------------
+
+  private buildRequest(request: ProviderRequest): GeminiRequest {
+    const contents = this.convertMessages(request.messages as any[]);
+    const maxTokens = request.maxTokens || this.defaultMaxTokens;
+
+    const geminiRequest: GeminiRequest = { contents };
+
+    // System instruction
+    if (request.system) {
+      const systemText = typeof request.system === 'string'
+        ? request.system
+        : (request.system as any[])
+            .filter((b: any) => b.type === 'text')
+            .map((b: any) => b.text)
+            .join('\n');
+
+      if (systemText) {
+        geminiRequest.systemInstruction = {
+          parts: [{ text: systemText }],
+        };
+      }
+    }
+
+    // Generation config
+    geminiRequest.generationConfig = {
+      maxOutputTokens: maxTokens,
+    };
+
+    if (request.temperature !== undefined) {
+      geminiRequest.generationConfig.temperature = request.temperature;
+    }
+
+    if (request.stopSequences && request.stopSequences.length > 0) {
+      // Gemini API limits stop sequences to 5
+      geminiRequest.generationConfig.stopSequences = request.stopSequences.slice(0, 5);
+    }
+
+    // Tools
+    if (request.tools && request.tools.length > 0) {
+      geminiRequest.tools = [{
+        functionDeclarations: this.convertTools(request.tools as any[]),
+      }];
+    }
+
+    // Extra params
+    if (request.extra) {
+      const { normalizedMessages, prompt, ...rest } = request.extra as Record<string, unknown>;
+      Object.assign(geminiRequest, rest);
+    }
+
+    return geminiRequest;
+  }
+
+  private convertMessages(messages: any[]): GeminiContent[] {
+    const contents: GeminiContent[] = [];
+
+    for (const msg of messages) {
+      const role: 'user' | 'model' = msg.role === 'assistant' ? 'model' : 'user';
+
+      // Simple string content
+      if (typeof msg.content === 'string') {
+        contents.push({ role, parts: [{ text: msg.content }] });
+        continue;
+      }
+
+      // Array content blocks (Anthropic-style)
+      if (Array.isArray(msg.content)) {
+        const parts: GeminiPart[] = [];
+        const toolResultParts: GeminiPart[] = [];
+
+        for (const block of msg.content) {
+          if (block.type === 'text') {
+            if (block.text) parts.push({ text: block.text });
+          } else if (block.type === 'image') {
+            // Anthropic image format → Gemini inlineData
+            const source = block.source;
+            if (source?.type === 'base64' && source.data) {
+              parts.push({
+                inlineData: {
+                  mimeType: source.media_type ?? 'image/jpeg',
+                  data: source.data,
+                },
+              });
+            }
+          } else if (block.type === 'tool_use') {
+            parts.push({
+              functionCall: {
+                name: block.name,
+                args: block.input ?? {},
+              },
+            });
+          } else if (block.type === 'tool_result') {
+            const resultContent = typeof block.content === 'string'
+              ? block.content
+              : JSON.stringify(block.content);
+            toolResultParts.push({
+              functionResponse: {
+                name: block.name ?? block.tool_use_id ?? 'unknown',
+                response: { result: resultContent },
+              },
+            });
+          }
+        }
+
+        // Tool results go in a user message
+        if (toolResultParts.length > 0) {
+          contents.push({ role: 'user', parts: toolResultParts });
+        }
+
+        if (parts.length > 0) {
+          contents.push({ role, parts });
+        }
+
+        continue;
+      }
+
+      // Null/empty content — skip
+      if (msg.content === null || msg.content === undefined) continue;
+
+      // Fallback
+      contents.push({ role, parts: [{ text: String(msg.content) }] });
+    }
+
+    // Gemini requires alternating user/model roles.
+    // Merge consecutive same-role messages.
+    return this.mergeConsecutiveRoles(contents);
+  }
+
+  /**
+   * Gemini requires strictly alternating user/model messages.
+   * Merge consecutive messages with the same role into one.
+   */
+  private mergeConsecutiveRoles(contents: GeminiContent[]): GeminiContent[] {
+    if (contents.length === 0) return contents;
+
+    const merged: GeminiContent[] = [contents[0]!];
+
+    for (let i = 1; i < contents.length; i++) {
+      const current = contents[i]!;
+      const last = merged[merged.length - 1]!;
+
+      if (current.role === last.role) {
+        // Merge parts into the previous message
+        last.parts.push(...current.parts);
+      } else {
+        merged.push(current);
+      }
+    }
+
+    // Gemini also requires the first message to be "user"
+    if (merged.length > 0 && merged[0]!.role !== 'user') {
+      merged.unshift({ role: 'user', parts: [{ text: '[Start]' }] });
+    }
+
+    return merged;
+  }
+
+  private convertTools(tools: any[]): GeminiFunctionDeclaration[] {
+    return tools.map(tool => {
+      const schema = tool.inputSchema || tool.input_schema || { type: 'object', properties: {} };
+      return {
+        name: tool.name,
+        description: tool.description ?? '',
+        parameters: schema,
+      };
+    });
+  }
+
+  // --------------------------------------------------------------------------
+  // Response Parsing
+  // --------------------------------------------------------------------------
+
+  private parseResponse(
+    response: GeminiResponse,
+    requestedModel: string,
+    rawRequest: unknown
+  ): ProviderResponse {
+    const candidate = response.candidates?.[0];
+    const parts = candidate?.content?.parts ?? [];
+
+    let text = '';
+    const toolCalls: { name: string; args: Record<string, unknown> }[] = [];
+
+    for (const part of parts) {
+      if (part.text) text += part.text;
+      if (part.functionCall) {
+        toolCalls.push({
+          name: part.functionCall.name,
+          args: part.functionCall.args,
+        });
+      }
+    }
+
+    return {
+      content: this.buildContentBlocks(text, toolCalls),
+      stopReason: this.mapFinishReason(candidate?.finishReason),
+      stopSequence: undefined,
+      usage: {
+        inputTokens: response.usageMetadata?.promptTokenCount ?? 0,
+        outputTokens: response.usageMetadata?.candidatesTokenCount ?? 0,
+        cacheReadTokens: response.usageMetadata?.cachedContentTokenCount
+          ? response.usageMetadata.cachedContentTokenCount
+          : undefined,
+      },
+      model: response.modelVersion ?? requestedModel,
+      rawRequest,
+      raw: response,
+    };
+  }
+
+  private buildContentBlocks(
+    text: string,
+    toolCalls: { name: string; args: Record<string, unknown> }[]
+  ): ContentBlock[] {
+    const content: ContentBlock[] = [];
+
+    if (text) {
+      content.push({ type: 'text', text });
+    }
+
+    for (const tc of toolCalls) {
+      content.push({
+        type: 'tool_use',
+        id: `gemini-tc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: tc.name,
+        input: tc.args,
+      });
+    }
+
+    return content;
+  }
+
+  private mapFinishReason(reason: string | undefined): string {
+    switch (reason) {
+      case 'STOP':
+        return 'end_turn';
+      case 'MAX_TOKENS':
+        return 'max_tokens';
+      case 'SAFETY':
+        return 'refusal';
+      case 'RECITATION':
+        return 'refusal';
+      case 'TOOL_CALLS':
+      case 'FUNCTION_CALL':
+        return 'tool_use';
+      default:
+        return 'end_turn';
+    }
+  }
+
+  // --------------------------------------------------------------------------
+  // Error Handling
+  // --------------------------------------------------------------------------
+
+  private handleError(error: unknown, rawRequest?: unknown): MembraneError {
+    if (error instanceof MembraneError) return error;
+
+    if (error instanceof Error) {
+      const message = error.message;
+
+      if (message.includes('401') || message.includes('403') || message.includes('API_KEY_INVALID') || message.includes('PERMISSION_DENIED')) {
+        return authError(message, error, rawRequest);
+      }
+
+      if (message.includes('429') || message.includes('RESOURCE_EXHAUSTED')) {
+        const retryMatch = message.match(/retry.after[:\s]*(\d+)/i);
+        const retryAfter = retryMatch?.[1] ? parseInt(retryMatch[1], 10) * 1000 : undefined;
+        return rateLimitError(message, retryAfter, error, rawRequest);
+      }
+
+      if (message.includes('context') || message.includes('too long') || message.includes('token limit')) {
+        return contextLengthError(message, error, rawRequest);
+      }
+
+      if (message.includes('500') || message.includes('502') || message.includes('503') || message.includes('INTERNAL')) {
+        return serverError(message, undefined, error, rawRequest);
+      }
+
+      if (error.name === 'AbortError') {
+        return abortError(undefined, rawRequest);
+      }
+
+      if (message.includes('network') || message.includes('fetch') || message.includes('ECONNREFUSED')) {
+        return networkError(message, error, rawRequest);
+      }
+    }
+
+    return new MembraneError({
+      type: 'unknown',
+      message: error instanceof Error ? error.message : String(error),
+      retryable: false,
+      rawError: error,
+      rawRequest,
+    });
+  }
+}
+
+// ============================================================================
+// Content Conversion Utilities
+// ============================================================================
+
+/**
+ * Convert normalized content blocks to Gemini parts
+ */
+export function toGeminiParts(blocks: ContentBlock[]): GeminiPart[] {
+  return blocks.map(block => {
+    if (block.type === 'text') {
+      return { text: (block as any).text };
+    }
+    if (block.type === 'tool_use') {
+      return {
+        functionCall: {
+          name: (block as any).name,
+          args: (block as any).input ?? {},
+        },
+      };
+    }
+    return { text: String(block) };
+  });
+}
+
+/**
+ * Convert Gemini parts to normalized content blocks
+ */
+export function fromGeminiParts(parts: GeminiPart[]): ContentBlock[] {
+  const result: ContentBlock[] = [];
+
+  for (const part of parts) {
+    if (part.text) {
+      result.push({ type: 'text', text: part.text });
+    }
+    if (part.functionCall) {
+      result.push({
+        type: 'tool_use',
+        id: `gemini-tc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: part.functionCall.name,
+        input: part.functionCall.args,
+      });
+    }
+  }
+
+  return result;
+}

package/src/providers/index.ts

@@ -46,3 +46,10 @@ export {
   BedrockAdapter,
   type BedrockAdapterConfig,
 } from './bedrock.js';
+
+export {
+  GeminiAdapter,
+  toGeminiParts,
+  fromGeminiParts,
+  type GeminiAdapterConfig,
+} from './gemini.js';