@animalabs/membrane 0.1.19 → 0.2.0

package/dist/providers/index.d.ts

@@ -5,4 +5,5 @@ export { AnthropicAdapter, toAnthropicContent, fromAnthropicContent, type Anthro
 export { OpenRouterAdapter, toOpenRouterMessages, fromOpenRouterMessage, type OpenRouterAdapterConfig, } from './openrouter.js';
 export { OpenAIAdapter, toOpenAIContent, fromOpenAIContent, type OpenAIAdapterConfig, } from './openai.js';
 export { OpenAICompatibleAdapter, toOpenAIMessages, fromOpenAIMessage, type OpenAICompatibleAdapterConfig, } from './openai-compatible.js';
+export { OpenAICompletionsAdapter, type OpenAICompletionsAdapterConfig, } from './openai-completions.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"}
+{"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"}

package/dist/providers/index.js

@@ -5,4 +5,5 @@ export { AnthropicAdapter, toAnthropicContent, fromAnthropicContent, } from './a
 export { OpenRouterAdapter, toOpenRouterMessages, fromOpenRouterMessage, } from './openrouter.js';
 export { OpenAIAdapter, toOpenAIContent, fromOpenAIContent, } from './openai.js';
 export { OpenAICompatibleAdapter, toOpenAIMessages, fromOpenAIMessage, } from './openai-compatible.js';
+export { OpenAICompletionsAdapter, } from './openai-completions.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"}
+{"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"}

package/dist/providers/openai-completions.d.ts

@@ -0,0 +1,62 @@
+/**
+ * OpenAI-Compatible Completions adapter for base models
+ *
+ * For true base/completion models that use the `/v1/completions` endpoint:
+ * - No chat formatting built-in
+ * - Single text prompt input
+ * - Raw completion output
+ * - No image support
+ *
+ * Serializes conversations to Human:/Assistant: format.
+ */
+import type { ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks } from '../types/index.js';
+export interface OpenAICompletionsAdapterConfig {
+    /** Base URL for the API (required, e.g., 'http://localhost:8000/v1') */
+    baseURL: string;
+    /** API key (optional for local servers) */
+    apiKey?: string;
+    /** Provider name for logging/identification (default: 'openai-completions') */
+    providerName?: string;
+    /** Default max tokens */
+    defaultMaxTokens?: number;
+    /** Additional headers to include with requests */
+    extraHeaders?: Record<string, string>;
+    /**
+     * Stop sequences to use (default: ['\n\nHuman:', '\nHuman:'])
+     * These prevent the model from generating user turns.
+     */
+    defaultStopSequences?: string[];
+    /**
+     * Whether to warn when images are stripped from context (default: true)
+     */
+    warnOnImageStrip?: boolean;
+}
+export declare class OpenAICompletionsAdapter implements ProviderAdapter {
+    readonly name: string;
+    private baseURL;
+    private apiKey;
+    private defaultMaxTokens;
+    private extraHeaders;
+    private defaultStopSequences;
+    private warnOnImageStrip;
+    constructor(config: OpenAICompletionsAdapterConfig);
+    supportsModel(_modelId: string): boolean;
+    complete(request: ProviderRequest, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    stream(request: ProviderRequest, callbacks: StreamCallbacks, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    /**
+     * Serialize messages to Human:/Assistant: format for base models.
+     * Images are stripped from content.
+     */
+    serializeToPrompt(messages: any[]): string;
+    private normalizeRole;
+    private extractTextContent;
+    private getHeaders;
+    private buildRequest;
+    private makeRequest;
+    private parseResponse;
+    private buildStreamedResponse;
+    private textToContent;
+    private mapFinishReason;
+    private handleError;
+}
+//# sourceMappingURL=openai-completions.d.ts.map

package/dist/providers/openai-completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-completions.d.ts","sourceRoot":"","sources":["../../src/providers/openai-completions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AA2C3B,MAAM,WAAW,8BAA8B;IAC7C,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,oBAAoB,CAAW;IACvC,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,MAAM,EAAE,8BAA8B;IAclD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAWtB,MAAM,CACV,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAkE5B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM;IA6B1C,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,YAAY;YA+BN,WAAW;IAgBzB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;CAqCpB"}

package/dist/providers/openai-completions.js

@@ -0,0 +1,286 @@
+/**
+ * OpenAI-Compatible Completions adapter for base models
+ *
+ * For true base/completion models that use the `/v1/completions` endpoint:
+ * - No chat formatting built-in
+ * - Single text prompt input
+ * - Raw completion output
+ * - No image support
+ *
+ * Serializes conversations to Human:/Assistant: format.
+ */
+import { MembraneError, rateLimitError, contextLengthError, authError, serverError, abortError, networkError, } from '../types/index.js';
+// ============================================================================
+// OpenAI Completions Adapter
+// ============================================================================
+export class OpenAICompletionsAdapter {
+    name;
+    baseURL;
+    apiKey;
+    defaultMaxTokens;
+    extraHeaders;
+    defaultStopSequences;
+    warnOnImageStrip;
+    constructor(config) {
+        if (!config.baseURL) {
+            throw new Error('OpenAI completions adapter requires baseURL');
+        }
+        this.name = config.providerName ?? 'openai-completions';
+        this.baseURL = config.baseURL.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = config.apiKey ?? '';
+        this.defaultMaxTokens = config.defaultMaxTokens ?? 4096;
+        this.extraHeaders = config.extraHeaders ?? {};
+        this.defaultStopSequences = config.defaultStopSequences ?? ['\n\nHuman:', '\nHuman:'];
+        this.warnOnImageStrip = config.warnOnImageStrip ?? true;
+    }
+    supportsModel(_modelId) {
+        return true;
+    }
+    async complete(request, options) {
+        const completionsRequest = this.buildRequest(request);
+        try {
+            const response = await this.makeRequest(completionsRequest, options);
+            return this.parseResponse(response, request.model, completionsRequest);
+        }
+        catch (error) {
+            throw this.handleError(error, completionsRequest);
+        }
+    }
+    async stream(request, callbacks, options) {
+        const completionsRequest = this.buildRequest(request);
+        completionsRequest.stream = true;
+        try {
+            const response = await fetch(`${this.baseURL}/completions`, {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: JSON.stringify(completionsRequest),
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`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';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value, { stream: true });
+                const lines = chunk.split('\n').filter(line => line.startsWith('data: '));
+                for (const line of lines) {
+                    const data = line.slice(6);
+                    if (data === '[DONE]')
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const text = parsed.choices?.[0]?.text;
+                        if (text) {
+                            accumulated += text;
+                            callbacks.onChunk(text);
+                        }
+                        if (parsed.choices?.[0]?.finish_reason) {
+                            finishReason = parsed.choices[0].finish_reason;
+                        }
+                    }
+                    catch {
+                        // Ignore parse errors in stream
+                    }
+                }
+            }
+            return this.buildStreamedResponse(accumulated, finishReason, request.model, completionsRequest);
+        }
+        catch (error) {
+            throw this.handleError(error, completionsRequest);
+        }
+    }
+    // ============================================================================
+    // Prompt Serialization
+    // ============================================================================
+    /**
+     * Serialize messages to Human:/Assistant: format for base models.
+     * Images are stripped from content.
+     */
+    serializeToPrompt(messages) {
+        const parts = [];
+        let hasStrippedImages = false;
+        for (const msg of messages) {
+            const role = this.normalizeRole(msg.role);
+            const prefix = role === 'user' ? 'Human:' : 'Assistant:';
+            // Extract text content, strip images
+            const textContent = this.extractTextContent(msg.content);
+            if (textContent.hadImages) {
+                hasStrippedImages = true;
+            }
+            if (textContent.text) {
+                parts.push(`${prefix} ${textContent.text}`);
+            }
+        }
+        if (hasStrippedImages && this.warnOnImageStrip) {
+            console.warn('[OpenAICompletionsAdapter] Images were stripped from context (not supported in completions mode)');
+        }
+        // Add final Assistant: prefix to prompt completion
+        parts.push('Assistant:');
+        return parts.join('\n\n');
+    }
+    normalizeRole(role) {
+        if (role === 'user' || role === 'human' || role === 'Human') {
+            return 'user';
+        }
+        return 'assistant';
+    }
+    extractTextContent(content) {
+        if (typeof content === 'string') {
+            return { text: content, hadImages: false };
+        }
+        if (Array.isArray(content)) {
+            const textParts = [];
+            let hadImages = false;
+            for (const block of content) {
+                if (block.type === 'text') {
+                    textParts.push(block.text);
+                }
+                else if (block.type === 'image' || block.type === 'image_url') {
+                    hadImages = true;
+                }
+                // Skip tool_use, tool_result, thinking blocks for base models
+            }
+            return { text: textParts.join('\n'), hadImages };
+        }
+        return { text: '', hadImages: false };
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.extraHeaders,
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    buildRequest(request) {
+        const prompt = this.serializeToPrompt(request.messages);
+        const params = {
+            model: request.model,
+            prompt,
+            max_tokens: request.maxTokens || this.defaultMaxTokens,
+        };
+        if (request.temperature !== undefined) {
+            params.temperature = request.temperature;
+        }
+        // Combine default stop sequences with any provided ones
+        const stopSequences = [
+            ...this.defaultStopSequences,
+            ...(request.stopSequences || []),
+        ];
+        if (stopSequences.length > 0) {
+            params.stop = stopSequences;
+        }
+        // Apply extra params (but not messages/tools which don't apply)
+        if (request.extra) {
+            const { messages, tools, ...rest } = request.extra;
+            Object.assign(params, rest);
+        }
+        return params;
+    }
+    async makeRequest(request, options) {
+        const response = await fetch(`${this.baseURL}/completions`, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify(request),
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API error: ${response.status} ${errorText}`);
+        }
+        return response.json();
+    }
+    parseResponse(response, requestedModel, rawRequest) {
+        const choice = response.choices[0];
+        const text = choice?.text ?? '';
+        return {
+            content: this.textToContent(text),
+            stopReason: this.mapFinishReason(choice?.finish_reason),
+            stopSequence: undefined,
+            usage: {
+                inputTokens: response.usage?.prompt_tokens ?? 0,
+                outputTokens: response.usage?.completion_tokens ?? 0,
+            },
+            model: response.model ?? requestedModel,
+            rawRequest,
+            raw: response,
+        };
+    }
+    buildStreamedResponse(accumulated, finishReason, requestedModel, rawRequest) {
+        return {
+            content: this.textToContent(accumulated),
+            stopReason: this.mapFinishReason(finishReason),
+            stopSequence: undefined,
+            usage: {
+                inputTokens: 0, // Not available in streaming
+                outputTokens: 0,
+            },
+            model: requestedModel,
+            rawRequest,
+            raw: { text: accumulated, finish_reason: finishReason },
+        };
+    }
+    textToContent(text) {
+        // Trim leading whitespace (model often starts with space after "Assistant:")
+        const trimmed = text.replace(/^\s+/, '');
+        if (!trimmed)
+            return [];
+        return [{ type: 'text', text: trimmed }];
+    }
+    mapFinishReason(reason) {
+        switch (reason) {
+            case 'stop':
+                return 'end_turn';
+            case 'length':
+                return 'max_tokens';
+            default:
+                return 'end_turn';
+        }
+    }
+    handleError(error, rawRequest) {
+        if (error instanceof Error) {
+            const message = error.message;
+            if (message.includes('429') || message.includes('rate')) {
+                return rateLimitError(message, undefined, error, rawRequest);
+            }
+            if (message.includes('401') || message.includes('auth') || message.includes('Unauthorized')) {
+                return authError(message, error, rawRequest);
+            }
+            if (message.includes('context') || message.includes('too long') || message.includes('maximum context')) {
+                return contextLengthError(message, error, rawRequest);
+            }
+            if (message.includes('500') || message.includes('502') || message.includes('503')) {
+                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,
+        });
+    }
+}
+//# sourceMappingURL=openai-completions.js.map

package/dist/providers/openai-completions.js.map

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

package/package.json

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

package/src/providers/index.ts

@@ -29,3 +29,8 @@ export {
   fromOpenAIMessage,
   type OpenAICompatibleAdapterConfig,
 } from './openai-compatible.js';
+
+export {
+  OpenAICompletionsAdapter,
+  type OpenAICompletionsAdapterConfig,
+} from './openai-completions.js';

package/src/providers/openai-completions.ts

@@ -0,0 +1,429 @@
+/**
+ * OpenAI-Compatible Completions adapter for base models
+ *
+ * For true base/completion models that use the `/v1/completions` endpoint:
+ * - No chat formatting built-in
+ * - Single text prompt input
+ * - Raw completion output
+ * - No image support
+ *
+ * Serializes conversations to Human:/Assistant: format.
+ */
+
+import type {
+  ProviderAdapter,
+  ProviderRequest,
+  ProviderRequestOptions,
+  ProviderResponse,
+  StreamCallbacks,
+  ContentBlock,
+} from '../types/index.js';
+import {
+  MembraneError,
+  rateLimitError,
+  contextLengthError,
+  authError,
+  serverError,
+  abortError,
+  networkError,
+} from '../types/index.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface CompletionsRequest {
+  model: string;
+  prompt: string;
+  max_tokens?: number;
+  temperature?: number;
+  stop?: string[];
+  stream?: boolean;
+}
+
+interface CompletionsResponse {
+  id: string;
+  model: string;
+  choices: {
+    index: number;
+    text: string;
+    finish_reason: string;
+  }[];
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+
+// ============================================================================
+// Adapter Configuration
+// ============================================================================
+
+export interface OpenAICompletionsAdapterConfig {
+  /** Base URL for the API (required, e.g., 'http://localhost:8000/v1') */
+  baseURL: string;
+
+  /** API key (optional for local servers) */
+  apiKey?: string;
+
+  /** Provider name for logging/identification (default: 'openai-completions') */
+  providerName?: string;
+
+  /** Default max tokens */
+  defaultMaxTokens?: number;
+
+  /** Additional headers to include with requests */
+  extraHeaders?: Record<string, string>;
+
+  /**
+   * Stop sequences to use (default: ['\n\nHuman:', '\nHuman:'])
+   * These prevent the model from generating user turns.
+   */
+  defaultStopSequences?: string[];
+
+  /**
+   * Whether to warn when images are stripped from context (default: true)
+   */
+  warnOnImageStrip?: boolean;
+}
+
+// ============================================================================
+// OpenAI Completions Adapter
+// ============================================================================
+
+export class OpenAICompletionsAdapter implements ProviderAdapter {
+  readonly name: string;
+  private baseURL: string;
+  private apiKey: string;
+  private defaultMaxTokens: number;
+  private extraHeaders: Record<string, string>;
+  private defaultStopSequences: string[];
+  private warnOnImageStrip: boolean;
+
+  constructor(config: OpenAICompletionsAdapterConfig) {
+    if (!config.baseURL) {
+      throw new Error('OpenAI completions adapter requires baseURL');
+    }
+
+    this.name = config.providerName ?? 'openai-completions';
+    this.baseURL = config.baseURL.replace(/\/$/, ''); // Remove trailing slash
+    this.apiKey = config.apiKey ?? '';
+    this.defaultMaxTokens = config.defaultMaxTokens ?? 4096;
+    this.extraHeaders = config.extraHeaders ?? {};
+    this.defaultStopSequences = config.defaultStopSequences ?? ['\n\nHuman:', '\nHuman:'];
+    this.warnOnImageStrip = config.warnOnImageStrip ?? true;
+  }
+
+  supportsModel(_modelId: string): boolean {
+    return true;
+  }
+
+  async complete(
+    request: ProviderRequest,
+    options?: ProviderRequestOptions
+  ): Promise<ProviderResponse> {
+    const completionsRequest = this.buildRequest(request);
+
+    try {
+      const response = await this.makeRequest(completionsRequest, options);
+      return this.parseResponse(response, request.model, completionsRequest);
+    } catch (error) {
+      throw this.handleError(error, completionsRequest);
+    }
+  }
+
+  async stream(
+    request: ProviderRequest,
+    callbacks: StreamCallbacks,
+    options?: ProviderRequestOptions
+  ): Promise<ProviderResponse> {
+    const completionsRequest = this.buildRequest(request);
+    completionsRequest.stream = true;
+
+    try {
+      const response = await fetch(`${this.baseURL}/completions`, {
+        method: 'POST',
+        headers: this.getHeaders(),
+        body: JSON.stringify(completionsRequest),
+        signal: options?.signal,
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`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';
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+
+        const chunk = decoder.decode(value, { stream: true });
+        const lines = chunk.split('\n').filter(line => line.startsWith('data: '));
+
+        for (const line of lines) {
+          const data = line.slice(6);
+          if (data === '[DONE]') continue;
+
+          try {
+            const parsed = JSON.parse(data);
+            const text = parsed.choices?.[0]?.text;
+
+            if (text) {
+              accumulated += text;
+              callbacks.onChunk(text);
+            }
+
+            if (parsed.choices?.[0]?.finish_reason) {
+              finishReason = parsed.choices[0].finish_reason;
+            }
+          } catch {
+            // Ignore parse errors in stream
+          }
+        }
+      }
+
+      return this.buildStreamedResponse(accumulated, finishReason, request.model, completionsRequest);
+
+    } catch (error) {
+      throw this.handleError(error, completionsRequest);
+    }
+  }
+
+  // ============================================================================
+  // Prompt Serialization
+  // ============================================================================
+
+  /**
+   * Serialize messages to Human:/Assistant: format for base models.
+   * Images are stripped from content.
+   */
+  serializeToPrompt(messages: any[]): string {
+    const parts: string[] = [];
+    let hasStrippedImages = false;
+
+    for (const msg of messages) {
+      const role = this.normalizeRole(msg.role);
+      const prefix = role === 'user' ? 'Human:' : 'Assistant:';
+
+      // Extract text content, strip images
+      const textContent = this.extractTextContent(msg.content);
+      if (textContent.hadImages) {
+        hasStrippedImages = true;
+      }
+
+      if (textContent.text) {
+        parts.push(`${prefix} ${textContent.text}`);
+      }
+    }
+
+    if (hasStrippedImages && this.warnOnImageStrip) {
+      console.warn('[OpenAICompletionsAdapter] Images were stripped from context (not supported in completions mode)');
+    }
+
+    // Add final Assistant: prefix to prompt completion
+    parts.push('Assistant:');
+
+    return parts.join('\n\n');
+  }
+
+  private normalizeRole(role: string): 'user' | 'assistant' {
+    if (role === 'user' || role === 'human' || role === 'Human') {
+      return 'user';
+    }
+    return 'assistant';
+  }
+
+  private extractTextContent(content: any): { text: string; hadImages: boolean } {
+    if (typeof content === 'string') {
+      return { text: content, hadImages: false };
+    }
+
+    if (Array.isArray(content)) {
+      const textParts: string[] = [];
+      let hadImages = false;
+
+      for (const block of content) {
+        if (block.type === 'text') {
+          textParts.push(block.text);
+        } else if (block.type === 'image' || block.type === 'image_url') {
+          hadImages = true;
+        }
+        // Skip tool_use, tool_result, thinking blocks for base models
+      }
+
+      return { text: textParts.join('\n'), hadImages };
+    }
+
+    return { text: '', hadImages: false };
+  }
+
+  // ============================================================================
+  // Private Methods
+  // ============================================================================
+
+  private getHeaders(): Record<string, string> {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      ...this.extraHeaders,
+    };
+
+    if (this.apiKey) {
+      headers['Authorization'] = `Bearer ${this.apiKey}`;
+    }
+
+    return headers;
+  }
+
+  private buildRequest(request: ProviderRequest): CompletionsRequest {
+    const prompt = this.serializeToPrompt(request.messages as any[]);
+
+    const params: CompletionsRequest = {
+      model: request.model,
+      prompt,
+      max_tokens: request.maxTokens || this.defaultMaxTokens,
+    };
+
+    if (request.temperature !== undefined) {
+      params.temperature = request.temperature;
+    }
+
+    // Combine default stop sequences with any provided ones
+    const stopSequences = [
+      ...this.defaultStopSequences,
+      ...(request.stopSequences || []),
+    ];
+    if (stopSequences.length > 0) {
+      params.stop = stopSequences;
+    }
+
+    // Apply extra params (but not messages/tools which don't apply)
+    if (request.extra) {
+      const { messages, tools, ...rest } = request.extra as any;
+      Object.assign(params, rest);
+    }
+
+    return params;
+  }
+
+  private async makeRequest(request: CompletionsRequest, options?: ProviderRequestOptions): Promise<CompletionsResponse> {
+    const response = await fetch(`${this.baseURL}/completions`, {
+      method: 'POST',
+      headers: this.getHeaders(),
+      body: JSON.stringify(request),
+      signal: options?.signal,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`API error: ${response.status} ${errorText}`);
+    }
+
+    return response.json() as Promise<CompletionsResponse>;
+  }
+
+  private parseResponse(response: CompletionsResponse, requestedModel: string, rawRequest: unknown): ProviderResponse {
+    const choice = response.choices[0];
+    const text = choice?.text ?? '';
+
+    return {
+      content: this.textToContent(text),
+      stopReason: this.mapFinishReason(choice?.finish_reason),
+      stopSequence: undefined,
+      usage: {
+        inputTokens: response.usage?.prompt_tokens ?? 0,
+        outputTokens: response.usage?.completion_tokens ?? 0,
+      },
+      model: response.model ?? requestedModel,
+      rawRequest,
+      raw: response,
+    };
+  }
+
+  private buildStreamedResponse(
+    accumulated: string,
+    finishReason: string,
+    requestedModel: string,
+    rawRequest?: unknown
+  ): ProviderResponse {
+    return {
+      content: this.textToContent(accumulated),
+      stopReason: this.mapFinishReason(finishReason),
+      stopSequence: undefined,
+      usage: {
+        inputTokens: 0, // Not available in streaming
+        outputTokens: 0,
+      },
+      model: requestedModel,
+      rawRequest,
+      raw: { text: accumulated, finish_reason: finishReason },
+    };
+  }
+
+  private textToContent(text: string): ContentBlock[] {
+    // Trim leading whitespace (model often starts with space after "Assistant:")
+    const trimmed = text.replace(/^\s+/, '');
+
+    if (!trimmed) return [];
+
+    return [{ type: 'text', text: trimmed }];
+  }
+
+  private mapFinishReason(reason: string | undefined): string {
+    switch (reason) {
+      case 'stop':
+        return 'end_turn';
+      case 'length':
+        return 'max_tokens';
+      default:
+        return 'end_turn';
+    }
+  }
+
+  private handleError(error: unknown, rawRequest?: unknown): MembraneError {
+    if (error instanceof Error) {
+      const message = error.message;
+
+      if (message.includes('429') || message.includes('rate')) {
+        return rateLimitError(message, undefined, error, rawRequest);
+      }
+
+      if (message.includes('401') || message.includes('auth') || message.includes('Unauthorized')) {
+        return authError(message, error, rawRequest);
+      }
+
+      if (message.includes('context') || message.includes('too long') || message.includes('maximum context')) {
+        return contextLengthError(message, error, rawRequest);
+      }
+
+      if (message.includes('500') || message.includes('502') || message.includes('503')) {
+        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,
+    });
+  }
+}