hazo_llm_api 1.2.12 → 1.3.0

package/dist/lib/providers/openai/openai_client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * OpenAI API Client Module
+ *
+ * Handles communication with the OpenAI Chat Completions API and Image Generation API.
+ * Uses the standard OpenAI API format (also compatible with many other providers).
+ */
+import type { LLMStreamChunk } from '../../llm_api/types.js';
+/**
+ * OpenAI message role
+ */
+export interface OpenAIMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | OpenAIContentItem[];
+}
+/**
+ * OpenAI content item for multimodal messages
+ */
+export type OpenAIContentItem = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+};
+/**
+ * OpenAI generation configuration parameters
+ */
+export interface OpenAIGenerationConfig {
+    /** Controls randomness in output (0.0-2.0). Lower = more deterministic */
+    temperature?: number;
+    /** Nucleus sampling probability (0.0-1.0) */
+    top_p?: number;
+    /** Maximum number of tokens in the response */
+    max_tokens?: number;
+    /** Penalizes new tokens based on whether they appear in the text so far */
+    frequency_penalty?: number;
+    /** Penalizes new tokens based on whether they appear in the text at all */
+    presence_penalty?: number;
+}
+/**
+ * Call the OpenAI Chat Completions API (non-streaming)
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export declare function call_openai_api(opts: {
+    api_key: string;
+    api_url: string;
+    model: string;
+    messages: OpenAIMessage[];
+    generation_config?: OpenAIGenerationConfig;
+}): Promise<{
+    raw: Record<string, unknown>;
+    status: number;
+}>;
+/**
+ * Call the OpenAI Image Generation API
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export declare function call_openai_image_api(opts: {
+    api_key: string;
+    api_url_image: string;
+    model: string;
+    prompt: string;
+}): Promise<{
+    raw: Record<string, unknown>;
+    status: number;
+}>;
+/**
+ * Call the OpenAI Embeddings API
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export declare function call_openai_embed_api(opts: {
+    api_key: string;
+    api_url_embed: string;
+    model: string;
+    input: string | string[];
+}): Promise<{
+    raw: Record<string, unknown>;
+    status: number;
+}>;
+/**
+ * Call the OpenAI Chat Completions API with streaming enabled.
+ * Yields LLMStreamChunk objects as SSE events arrive.
+ *
+ * @param opts - API call options
+ * @yields LLMStreamChunk objects with text deltas or done/error signals
+ */
+export declare function call_openai_api_stream(opts: {
+    api_key: string;
+    api_url: string;
+    model: string;
+    messages: OpenAIMessage[];
+    generation_config?: OpenAIGenerationConfig;
+}): AsyncGenerator<LLMStreamChunk, void, unknown>;
+//# sourceMappingURL=openai_client.d.ts.map

package/dist/lib/providers/openai/openai_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai_client.d.ts","sourceRoot":"","sources":["../../../../src/lib/providers/openai/openai_client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CAC5C,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC5D;AAMD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5D;AAMD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAa5D;AAMD;;;;;;GAMG;AACH,wBAAuB,sBAAsB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CAC5C,GAAG,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAuFhD"}

package/dist/lib/providers/openai/openai_client.js

@@ -0,0 +1,187 @@
+/**
+ * OpenAI API Client Module
+ *
+ * Handles communication with the OpenAI Chat Completions API and Image Generation API.
+ * Uses the standard OpenAI API format (also compatible with many other providers).
+ */
+// =============================================================================
+// OpenAI Chat Completions API Client
+// =============================================================================
+/**
+ * Call the OpenAI Chat Completions API (non-streaming)
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export async function call_openai_api(opts) {
+    const body = {
+        model: opts.model,
+        messages: opts.messages,
+    };
+    if (opts.generation_config) {
+        if (opts.generation_config.temperature !== undefined) {
+            body.temperature = opts.generation_config.temperature;
+        }
+        if (opts.generation_config.top_p !== undefined) {
+            body.top_p = opts.generation_config.top_p;
+        }
+        if (opts.generation_config.max_tokens !== undefined) {
+            body.max_tokens = opts.generation_config.max_tokens;
+        }
+        if (opts.generation_config.frequency_penalty !== undefined) {
+            body.frequency_penalty = opts.generation_config.frequency_penalty;
+        }
+        if (opts.generation_config.presence_penalty !== undefined) {
+            body.presence_penalty = opts.generation_config.presence_penalty;
+        }
+    }
+    const response = await fetch(opts.api_url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${opts.api_key}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    const raw = (await response.json());
+    return { raw, status: response.status };
+}
+// =============================================================================
+// OpenAI Image Generation API Client
+// =============================================================================
+/**
+ * Call the OpenAI Image Generation API
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export async function call_openai_image_api(opts) {
+    const body = {
+        model: opts.model,
+        prompt: opts.prompt,
+        response_format: 'b64_json',
+    };
+    const response = await fetch(opts.api_url_image, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${opts.api_key}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    const raw = (await response.json());
+    return { raw, status: response.status };
+}
+// =============================================================================
+// OpenAI Streaming API Client
+// =============================================================================
+/**
+ * Call the OpenAI Embeddings API
+ * @param opts - API call options
+ * @returns Raw API response and HTTP status code
+ */
+export async function call_openai_embed_api(opts) {
+    const { api_key, api_url_embed, model, input } = opts;
+    const response = await fetch(api_url_embed, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${api_key}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ model, input }),
+    });
+    const raw = (await response.json());
+    return { raw, status: response.status };
+}
+// =============================================================================
+// OpenAI Streaming API Client
+// =============================================================================
+/**
+ * Call the OpenAI Chat Completions API with streaming enabled.
+ * Yields LLMStreamChunk objects as SSE events arrive.
+ *
+ * @param opts - API call options
+ * @yields LLMStreamChunk objects with text deltas or done/error signals
+ */
+export async function* call_openai_api_stream(opts) {
+    const body = {
+        model: opts.model,
+        messages: opts.messages,
+        stream: true,
+    };
+    if (opts.generation_config) {
+        if (opts.generation_config.temperature !== undefined) {
+            body.temperature = opts.generation_config.temperature;
+        }
+        if (opts.generation_config.top_p !== undefined) {
+            body.top_p = opts.generation_config.top_p;
+        }
+        if (opts.generation_config.max_tokens !== undefined) {
+            body.max_tokens = opts.generation_config.max_tokens;
+        }
+        if (opts.generation_config.frequency_penalty !== undefined) {
+            body.frequency_penalty = opts.generation_config.frequency_penalty;
+        }
+        if (opts.generation_config.presence_penalty !== undefined) {
+            body.presence_penalty = opts.generation_config.presence_penalty;
+        }
+    }
+    let response;
+    try {
+        response = await fetch(opts.api_url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${opts.api_key}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        yield { text: '', done: false, error: `OpenAI network error: ${msg}` };
+        return;
+    }
+    if (!response.ok || !response.body) {
+        yield { text: '', done: false, error: `OpenAI API error: ${response.status}` };
+        return;
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                if (!line.startsWith('data: '))
+                    continue;
+                const data_str = line.slice(6).trim();
+                if (!data_str)
+                    continue;
+                if (data_str === '[DONE]') {
+                    yield { text: '', done: true };
+                    return;
+                }
+                try {
+                    const data = JSON.parse(data_str);
+                    const choices = data.choices;
+                    const delta = choices?.[0]?.delta;
+                    const content = delta?.content;
+                    if (content !== null && content !== undefined) {
+                        yield { text: content, done: false };
+                    }
+                }
+                catch {
+                    // Ignore malformed SSE data lines
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=openai_client.js.map

package/dist/lib/providers/openai/openai_client.js.map

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

package/dist/lib/providers/openai/openai_provider.d.ts

@@ -0,0 +1,66 @@
+/**
+ * OpenAI Provider Implementation
+ *
+ * Implements the LLMProvider interface for the OpenAI API.
+ * Handles text generation, image understanding, image generation, and streaming.
+ */
+import type { LLMProvider, LLMCapabilities, ServiceType } from '../types.js';
+import type { TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, DocumentTextParams, EmbedParams, EmbedResponse, LLMResponse, LLMStreamResponse, Logger } from '../../llm_api/types.js';
+import { type OpenAIGenerationConfig } from './openai_client.js';
+/**
+ * Configuration for the OpenAI provider
+ */
+export interface OpenAIProviderConfig {
+    /** API key from .env.local (OPENAI_API_KEY) */
+    api_key: string;
+    /** Chat completions API URL (default: 'https://api.openai.com/v1/chat/completions') */
+    api_url?: string;
+    /** Image generation API URL (default: 'https://api.openai.com/v1/images/generations') */
+    api_url_image?: string;
+    /** Embeddings API URL (default: 'https://api.openai.com/v1/embeddings') */
+    api_url_embed?: string;
+    /** Model for text_text service (default: 'gpt-4o') */
+    model_text_text?: string;
+    /** Model for image_text service (default: 'gpt-4o') */
+    model_image_text?: string;
+    /** Model for text_image service (default: 'gpt-image-1') */
+    model_text_image?: string;
+    /** Model for embed service (default: 'text-embedding-3-small') */
+    model_embed?: string;
+    /** Generation parameters applied to text calls */
+    generation_config?: OpenAIGenerationConfig;
+    /** Capabilities this provider supports (overrides defaults when specified) */
+    capabilities?: ServiceType[];
+    /** Logger instance */
+    logger: Logger;
+}
+/**
+ * OpenAI LLM Provider
+ * Implements the LLMProvider interface for the OpenAI API
+ */
+export declare class OpenAIProvider implements LLMProvider {
+    private readonly name;
+    private readonly api_key;
+    private readonly api_url;
+    private readonly api_url_image;
+    private readonly api_url_embed;
+    private readonly model_text_text;
+    private readonly model_image_text;
+    private readonly model_text_image;
+    private readonly model_embed;
+    private readonly generation_config;
+    private readonly capabilities;
+    private readonly logger;
+    constructor(config: OpenAIProviderConfig);
+    get_name(): string;
+    get_capabilities(): LLMCapabilities;
+    get_model_for_service(service_type: ServiceType): string | undefined;
+    text_text(params: TextTextParams, _logger: Logger): Promise<LLMResponse>;
+    image_text(params: ImageTextParams, _logger: Logger): Promise<LLMResponse>;
+    text_image(params: TextImageParams, _logger: Logger): Promise<LLMResponse>;
+    text_text_stream(params: TextTextParams, _logger: Logger): Promise<LLMStreamResponse>;
+    embed(params: EmbedParams, _logger: Logger): Promise<EmbedResponse>;
+    image_image(_params: ImageImageParams, _logger: Logger): Promise<LLMResponse>;
+    document_text(_params: DocumentTextParams, _logger: Logger): Promise<LLMResponse>;
+}
+//# sourceMappingURL=openai_provider.d.ts.map

package/dist/lib/providers/openai/openai_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai_provider.d.ts","sourceRoot":"","sources":["../../../../src/lib/providers/openai/openai_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,MAAM,EACP,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAML,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAmB5B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAE3C,8EAA8E;IAC9E,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAE7B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,oBAAoB;IA6BxC,QAAQ,IAAI,MAAM;IAIlB,gBAAgB,IAAI,eAAe;IAInC,qBAAqB,CAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS;IAmB9D,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqDxE,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA6D1E,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqD1E,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmBrF,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqDnE,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO7E,aAAa,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAMxF"}

package/dist/lib/providers/openai/openai_provider.js

@@ -0,0 +1,297 @@
+/**
+ * OpenAI Provider Implementation
+ *
+ * Implements the LLMProvider interface for the OpenAI API.
+ * Handles text generation, image understanding, image generation, and streaming.
+ */
+import { SERVICE_TYPES } from '../types.js';
+import { call_openai_api, call_openai_image_api, call_openai_api_stream, call_openai_embed_api, } from './openai_client.js';
+import { openai_response_to_usage } from './openai_response_to_usage.js';
+// =============================================================================
+// Default constants
+// =============================================================================
+const DEFAULT_API_URL = 'https://api.openai.com/v1/chat/completions';
+const DEFAULT_API_URL_IMAGE = 'https://api.openai.com/v1/images/generations';
+const DEFAULT_API_URL_EMBED = 'https://api.openai.com/v1/embeddings';
+const DEFAULT_MODEL_TEXT_TEXT = 'gpt-4o';
+const DEFAULT_MODEL_IMAGE_TEXT = 'gpt-4o';
+const DEFAULT_MODEL_TEXT_IMAGE = 'gpt-image-1';
+const DEFAULT_MODEL_EMBED = 'text-embedding-3-small';
+// =============================================================================
+// OpenAI Provider Class
+// =============================================================================
+/**
+ * OpenAI LLM Provider
+ * Implements the LLMProvider interface for the OpenAI API
+ */
+export class OpenAIProvider {
+    constructor(config) {
+        this.name = 'openai';
+        this.api_key = config.api_key;
+        this.api_url = config.api_url ?? DEFAULT_API_URL;
+        this.api_url_image = config.api_url_image ?? DEFAULT_API_URL_IMAGE;
+        this.api_url_embed = config.api_url_embed ?? DEFAULT_API_URL_EMBED;
+        this.model_text_text = config.model_text_text ?? DEFAULT_MODEL_TEXT_TEXT;
+        this.model_image_text = config.model_image_text ?? DEFAULT_MODEL_IMAGE_TEXT;
+        this.model_text_image = config.model_text_image ?? DEFAULT_MODEL_TEXT_IMAGE;
+        this.model_embed = config.model_embed ?? DEFAULT_MODEL_EMBED;
+        this.generation_config = config.generation_config;
+        this.logger = config.logger;
+        if (config.capabilities && config.capabilities.length > 0) {
+            this.capabilities = new Set(config.capabilities);
+        }
+        else {
+            this.capabilities = new Set([
+                SERVICE_TYPES.TEXT_TEXT,
+                SERVICE_TYPES.IMAGE_TEXT,
+                SERVICE_TYPES.TEXT_IMAGE,
+                SERVICE_TYPES.EMBED,
+                'text_text_stream',
+            ]);
+        }
+    }
+    // =========================================================================
+    // LLMProvider interface — identity & introspection
+    // =========================================================================
+    get_name() {
+        return this.name;
+    }
+    get_capabilities() {
+        return new Set(this.capabilities);
+    }
+    get_model_for_service(service_type) {
+        switch (service_type) {
+            case SERVICE_TYPES.TEXT_TEXT:
+                return this.model_text_text;
+            case SERVICE_TYPES.IMAGE_TEXT:
+                return this.model_image_text;
+            case SERVICE_TYPES.TEXT_IMAGE:
+                return this.model_text_image;
+            case SERVICE_TYPES.EMBED:
+                return this.model_embed;
+            default:
+                return undefined;
+        }
+    }
+    // =========================================================================
+    // text_text — Text input → Text output
+    // =========================================================================
+    async text_text(params, _logger) {
+        const model = this.model_text_text;
+        const messages = [
+            { role: 'user', content: params.prompt ?? '' },
+        ];
+        const start_time = Date.now();
+        let raw;
+        let status;
+        try {
+            ({ raw, status } = await call_openai_api({
+                api_key: this.api_key,
+                api_url: this.api_url,
+                model,
+                messages,
+                generation_config: this.generation_config,
+            }));
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return { success: false, error, error_code: 'NETWORK_ERROR', retryable: true };
+        }
+        const latency_ms = Date.now() - start_time;
+        if (status >= 400) {
+            const error_code = status === 429 ? 'RATE_LIMITED' : 'API_ERROR';
+            return {
+                success: false,
+                error: `OpenAI API error: ${status}`,
+                error_code,
+                retryable: error_code === 'RATE_LIMITED',
+            };
+        }
+        const choices = raw.choices;
+        const message = choices?.[0]?.message;
+        const data = message?.content;
+        const usage = openai_response_to_usage({ raw, model_fallback: model, latency_ms });
+        return {
+            success: true,
+            data,
+            text: data,
+            raw_response: raw,
+            usage,
+        };
+    }
+    // =========================================================================
+    // image_text — Image input → Text output
+    // =========================================================================
+    async image_text(params, _logger) {
+        const model = this.model_image_text;
+        const url = `data:${params.image_mime_type};base64,${params.image_b64}`;
+        const messages = [
+            {
+                role: 'user',
+                content: [
+                    { type: 'image_url', image_url: { url } },
+                    { type: 'text', text: params.prompt },
+                ],
+            },
+        ];
+        const start_time = Date.now();
+        let raw;
+        let status;
+        try {
+            ({ raw, status } = await call_openai_api({
+                api_key: this.api_key,
+                api_url: this.api_url,
+                model,
+                messages,
+                generation_config: this.generation_config,
+            }));
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return { success: false, error, error_code: 'NETWORK_ERROR', retryable: true };
+        }
+        const latency_ms = Date.now() - start_time;
+        if (status >= 400) {
+            const error_code = status === 429 ? 'RATE_LIMITED' : 'API_ERROR';
+            return {
+                success: false,
+                error: `OpenAI API error: ${status}`,
+                error_code,
+                retryable: error_code === 'RATE_LIMITED',
+            };
+        }
+        const choices = raw.choices;
+        const message = choices?.[0]?.message;
+        const data = message?.content;
+        const usage = openai_response_to_usage({ raw, model_fallback: model, latency_ms });
+        return {
+            success: true,
+            data,
+            text: data,
+            raw_response: raw,
+            usage,
+        };
+    }
+    // =========================================================================
+    // text_image — Text input → Image output
+    // =========================================================================
+    async text_image(params, _logger) {
+        const model = this.model_text_image;
+        const start_time = Date.now();
+        let raw;
+        let status;
+        try {
+            ({ raw, status } = await call_openai_image_api({
+                api_key: this.api_key,
+                api_url_image: this.api_url_image,
+                model,
+                prompt: params.prompt,
+            }));
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return { success: false, error, error_code: 'NETWORK_ERROR', retryable: true };
+        }
+        const latency_ms = Date.now() - start_time;
+        if (status >= 400) {
+            const error_code = status === 429 ? 'RATE_LIMITED' : 'API_ERROR';
+            return {
+                success: false,
+                error: `OpenAI API error: ${status}`,
+                error_code,
+                retryable: error_code === 'RATE_LIMITED',
+            };
+        }
+        const image_data_arr = raw.data;
+        const data = image_data_arr?.[0]?.b64_json;
+        return {
+            success: true,
+            data,
+            image_b64: data,
+            image_mime_type: 'image/png',
+            raw_response: raw,
+            usage: {
+                provider: 'openai',
+                model,
+                tokens: { input: 0, output: 0, total: 0 },
+                latency_ms,
+            },
+        };
+    }
+    // =========================================================================
+    // text_text_stream — Text input → streaming Text output
+    // =========================================================================
+    async text_text_stream(params, _logger) {
+        const model = this.model_text_text;
+        const messages = [
+            { role: 'user', content: params.prompt ?? '' },
+        ];
+        return call_openai_api_stream({
+            api_key: this.api_key,
+            api_url: this.api_url,
+            model,
+            messages,
+            generation_config: this.generation_config,
+        });
+    }
+    // =========================================================================
+    // embed — Text input → Vector embeddings output
+    // =========================================================================
+    async embed(params, _logger) {
+        const api_url_embed = this.api_url_embed;
+        const model = params.model ?? this.model_embed;
+        const start_time = Date.now();
+        const { raw, status } = await call_openai_embed_api({
+            api_key: this.api_key,
+            api_url_embed,
+            model,
+            input: params.text,
+        });
+        const latency_ms = Date.now() - start_time;
+        if (status >= 400) {
+            const error_code = status === 429 ? 'RATE_LIMITED' : 'API_ERROR';
+            return {
+                success: false,
+                error: `OpenAI Embeddings API error: ${status}`,
+                error_code,
+            };
+        }
+        // Sort data by index (OpenAI guarantees order but let's be safe)
+        const data = raw.data
+            .sort((a, b) => a.index - b.index);
+        const vectors = data.map(d => d.embedding);
+        const dimensions = vectors[0]?.length;
+        const usage_raw = raw.usage;
+        const input_tokens = usage_raw?.prompt_tokens ?? 0;
+        const total_tokens = usage_raw?.total_tokens ?? 0;
+        const response_model = typeof raw.model === 'string' ? raw.model : model;
+        return {
+            success: true,
+            vectors,
+            dimensions,
+            model: response_model,
+            usage: {
+                provider: 'openai',
+                model: response_model,
+                tokens: { input: input_tokens, output: 0, total: total_tokens },
+                latency_ms,
+            },
+        };
+    }
+    // =========================================================================
+    // Unsupported methods (satisfy LLMProvider interface completeness)
+    // =========================================================================
+    async image_image(_params, _logger) {
+        return {
+            success: false,
+            error: 'OpenAI provider does not support image_image via this implementation',
+        };
+    }
+    async document_text(_params, _logger) {
+        return {
+            success: false,
+            error: 'OpenAI provider does not support document_text via this implementation',
+        };
+    }
+}
+//# sourceMappingURL=openai_provider.js.map