@strands-agents/sdk 0.0.1

package/dist/src/models/openai.js

@@ -0,0 +1,752 @@
+/**
+ * OpenAI model provider implementation.
+ *
+ * This module provides integration with OpenAI's Chat Completions API,
+ * supporting streaming responses, tool use, and configurable model parameters.
+ *
+ * @see https://platform.openai.com/docs/api-reference/chat/create
+ */
+import OpenAI, {} from 'openai';
+import { Model } from '../models/model.js';
+import { encodeBase64 } from '../types/media.js';
+import { ContextWindowOverflowError } from '../errors.js';
+/**
+ * Browser-compatible MIME type lookup.
+ * Maps file extensions to MIME types without using Node.js path module.
+ */
+const mimeTypeLookup = (format) => {
+    const mimeTypes = {
+        // Video
+        mkv: 'video/x-matroska',
+        mov: 'video/quicktime',
+        mp4: 'application/mp4',
+        webm: 'video/webm',
+        flv: 'video/x-flv',
+        mpeg: 'video/mpeg',
+        mpg: 'video/mpeg',
+        wmv: 'video/x-ms-wmv',
+        '3gp': 'video/3gpp',
+        // Images
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        // Documents
+        pdf: 'application/pdf',
+        csv: 'text/csv',
+        doc: 'application/msword',
+        docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        xls: 'application/vnd.ms-excel',
+        txt: 'text/plain',
+        json: 'application/json',
+        xml: 'application/xml',
+        html: 'text/html',
+        md: 'text/markdown',
+    };
+    return mimeTypes[format.toLowerCase()] || false;
+};
+const DEFAULT_OPENAI_MODEL_ID = 'gpt-4o';
+/**
+ * Error message patterns that indicate context window overflow.
+ * Used to detect when input exceeds the model's context window.
+ *
+ * @see https://platform.openai.com/docs/guides/error-codes
+ */
+const OPENAI_CONTEXT_WINDOW_OVERFLOW_PATTERNS = [
+    'maximum context length',
+    'context_length_exceeded',
+    'too many tokens',
+    'context length',
+];
+/**
+ * OpenAI model provider implementation.
+ *
+ * Implements the Model interface for OpenAI using the Chat Completions API.
+ * Supports streaming responses, tool use, and comprehensive configuration.
+ *
+ * @example
+ * ```typescript
+ * const provider = new OpenAIModel({
+ *   apiKey: 'sk-...',
+ *   modelId: 'gpt-4o',
+ *   temperature: 0.7,
+ *   maxTokens: 1024
+ * })
+ *
+ * const messages: Message[] = [
+ *   { role: 'user', content: [{ type: 'textBlock', text: 'Hello!' }] }
+ * ]
+ *
+ * for await (const event of provider.stream(messages)) {
+ *   if (event.type === 'modelContentBlockDeltaEvent' && event.delta.type === 'textDelta') {
+ *     process.stdout.write(event.delta.text)
+ *   }
+ * }
+ * ```
+ */
+export class OpenAIModel extends Model {
+    _config;
+    _client;
+    /**
+     * Creates a new OpenAIModel instance.
+     *
+     * @param options - Configuration for model and client (modelId is required)
+     *
+     * @example
+     * ```typescript
+     * // Minimal configuration with API key and model ID
+     * const provider = new OpenAIModel({
+     *   modelId: 'gpt-4o',
+     *   apiKey: 'sk-...'
+     * })
+     *
+     * // With additional model configuration
+     * const provider = new OpenAIModel({
+     *   modelId: 'gpt-4o',
+     *   apiKey: 'sk-...',
+     *   temperature: 0.8,
+     *   maxTokens: 2048
+     * })
+     *
+     * // Using environment variable for API key
+     * const provider = new OpenAIModel({
+     *   modelId: 'gpt-3.5-turbo'
+     * })
+     *
+     * // Using a pre-configured client instance
+     * const client = new OpenAI({ apiKey: 'sk-...', timeout: 60000 })
+     * const provider = new OpenAIModel({
+     *   modelId: 'gpt-4o',
+     *   client
+     * })
+     * ```
+     */
+    constructor(options) {
+        super();
+        const { apiKey, client, clientConfig, ...modelConfig } = options || {};
+        // Initialize model config
+        this._config = modelConfig;
+        // Use provided client or create a new one
+        if (client) {
+            this._client = client;
+        }
+        else {
+            // Check if API key is available when creating a new client
+            // In browsers, apiKey must be provided directly
+            // In Node.js, can use OPENAI_API_KEY environment variable as fallback
+            const hasEnvKey = typeof process !== 'undefined' && typeof process.env !== 'undefined' && process.env.OPENAI_API_KEY;
+            if (!apiKey && !hasEnvKey) {
+                throw new Error("OpenAI API key is required. Provide it via the 'apiKey' option or set the OPENAI_API_KEY environment variable.");
+            }
+            // Initialize OpenAI client
+            // Only include apiKey if explicitly provided, otherwise let client use env var
+            this._client = new OpenAI({
+                ...(apiKey ? { apiKey } : {}),
+                ...clientConfig,
+            });
+        }
+    }
+    /**
+     * Updates the model configuration.
+     * Merges the provided configuration with existing settings.
+     *
+     * @param modelConfig - Configuration object with model-specific settings to update
+     *
+     * @example
+     * ```typescript
+     * // Update temperature and maxTokens
+     * provider.updateConfig({
+     *   temperature: 0.9,
+     *   maxTokens: 2048
+     * })
+     * ```
+     */
+    updateConfig(modelConfig) {
+        this._config = { ...this._config, ...modelConfig };
+    }
+    /**
+     * Retrieves the current model configuration.
+     *
+     * @returns The current configuration object
+     *
+     * @example
+     * ```typescript
+     * const config = provider.getConfig()
+     * console.log(config.modelId)
+     * ```
+     */
+    getConfig() {
+        return this._config;
+    }
+    /**
+     * Streams a conversation with the OpenAI model.
+     * Returns an async iterable that yields streaming events as they occur.
+     *
+     * @param messages - Array of conversation messages
+     * @param options - Optional streaming configuration
+     * @returns Async iterable of streaming events
+     *
+     * @throws \{ContextWindowOverflowError\} When input exceeds the model's context window
+     *
+     * @example
+     * ```typescript
+     * const provider = new OpenAIModel({ modelId: 'gpt-4o', apiKey: 'sk-...' })
+     * const messages: Message[] = [
+     *   { role: 'user', content: [{ type: 'textBlock', text: 'What is 2+2?' }] }
+     * ]
+     *
+     * for await (const event of provider.stream(messages)) {
+     *   if (event.type === 'modelContentBlockDeltaEvent' && event.delta.type === 'textDelta') {
+     *     process.stdout.write(event.delta.text)
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With tool use
+     * const options: StreamOptions = {
+     *   systemPrompt: 'You are a helpful assistant',
+     *   toolSpecs: [calculatorTool]
+     * }
+     *
+     * for await (const event of provider.stream(messages, options)) {
+     *   if (event.type === 'modelMessageStopEvent' && event.stopReason === 'toolUse') {
+     *     console.log('Model wants to use a tool')
+     *   }
+     * }
+     * ```
+     */
+    async *stream(messages, options) {
+        // Validate messages array is not empty
+        if (!messages || messages.length === 0) {
+            throw new Error('At least one message is required');
+        }
+        try {
+            // Format the request
+            const request = this._formatRequest(messages, options);
+            // Create streaming request with usage tracking
+            const stream = await this._client.chat.completions.create(request);
+            // Track streaming state (Use mutable object for proper state tracking)
+            const streamState = {
+                messageStarted: false,
+                textContentBlockStarted: false,
+            };
+            // Track active tool calls for stop events
+            const activeToolCalls = new Map();
+            // Buffer usage to emit before message stop
+            let bufferedUsage = null;
+            // Process streaming response
+            for await (const chunk of stream) {
+                if (!chunk.choices || chunk.choices.length === 0) {
+                    // Handle usage chunk (no choices)
+                    // Buffer usage to emit before message stop
+                    if (chunk.usage) {
+                        bufferedUsage = {
+                            type: 'modelMetadataEvent',
+                            usage: {
+                                inputTokens: chunk.usage.prompt_tokens ?? 0,
+                                outputTokens: chunk.usage.completion_tokens ?? 0,
+                                totalTokens: chunk.usage.total_tokens ?? 0,
+                            },
+                        };
+                    }
+                    continue;
+                }
+                // Map chunk to SDK events
+                const events = this._mapOpenAIChunkToSDKEvents(chunk, streamState, activeToolCalls);
+                for (const event of events) {
+                    // Emit buffered usage before message stop
+                    if (event.type === 'modelMessageStopEvent' && bufferedUsage) {
+                        yield bufferedUsage;
+                        bufferedUsage = null;
+                    }
+                    yield event;
+                }
+            }
+            // Emit any remaining buffered usage
+            if (bufferedUsage) {
+                yield bufferedUsage;
+            }
+        }
+        catch (error) {
+            const err = error;
+            // Check for context window overflow using simple pattern matching
+            if (OPENAI_CONTEXT_WINDOW_OVERFLOW_PATTERNS.some((pattern) => err.message?.toLowerCase().includes(pattern))) {
+                throw new ContextWindowOverflowError(err.message);
+            }
+            // Re-throw other errors unchanged
+            throw err;
+        }
+    }
+    /**
+     * Formats a request for the OpenAI Chat Completions API.
+     *
+     * @param messages - Conversation messages
+     * @param options - Stream options
+     * @returns Formatted OpenAI request
+     */
+    _formatRequest(messages, options) {
+        // Start with required fields
+        const request = {
+            model: this._config.modelId ?? DEFAULT_OPENAI_MODEL_ID,
+            messages: [],
+            stream: true,
+            stream_options: { include_usage: true },
+        };
+        // Handle system prompt (string or array format)
+        if (options?.systemPrompt !== undefined) {
+            if (typeof options.systemPrompt === 'string') {
+                // String path: validate and add as-is
+                if (options.systemPrompt.trim().length > 0) {
+                    request.messages.push({
+                        role: 'system',
+                        content: options.systemPrompt,
+                    });
+                }
+            }
+            else if (Array.isArray(options.systemPrompt) && options.systemPrompt.length > 0) {
+                // Array path: extract text blocks and warn about cache points
+                const textBlocks = [];
+                let hasCachePoints = false;
+                let hasGuardContent = false;
+                for (const block of options.systemPrompt) {
+                    if (block.type === 'textBlock') {
+                        textBlocks.push(block.text);
+                    }
+                    else if (block.type === 'cachePointBlock') {
+                        hasCachePoints = true;
+                    }
+                    else if (block.type === 'guardContentBlock') {
+                        hasGuardContent = true;
+                    }
+                }
+                if (hasCachePoints) {
+                    console.warn('Cache points are not supported in OpenAI system prompts and will be ignored.');
+                }
+                if (hasGuardContent) {
+                    console.warn('OpenAI does not support guard content in system prompts. Removing guard content block.');
+                }
+                if (textBlocks.length > 0) {
+                    request.messages.push({
+                        role: 'system',
+                        content: textBlocks.join(''),
+                    });
+                }
+            }
+        }
+        // Add formatted messages
+        const formattedMessages = this._formatMessages(messages);
+        request.messages.push(...formattedMessages);
+        // Add model configuration parameters
+        if (this._config.temperature !== undefined) {
+            request.temperature = this._config.temperature;
+        }
+        if (this._config.maxTokens !== undefined) {
+            request.max_tokens = this._config.maxTokens;
+        }
+        if (this._config.topP !== undefined) {
+            request.top_p = this._config.topP;
+        }
+        if (this._config.frequencyPenalty !== undefined) {
+            request.frequency_penalty = this._config.frequencyPenalty;
+        }
+        if (this._config.presencePenalty !== undefined) {
+            request.presence_penalty = this._config.presencePenalty;
+        }
+        // Add tool specifications with validation
+        if (options?.toolSpecs && options.toolSpecs.length > 0) {
+            request.tools = options.toolSpecs.map((spec) => {
+                if (!spec.name || !spec.description) {
+                    throw new Error('Tool specification must have both name and description');
+                }
+                return {
+                    type: 'function',
+                    function: {
+                        name: spec.name,
+                        description: spec.description,
+                        parameters: spec.inputSchema,
+                    },
+                };
+            });
+            // Add tool choice if specified
+            if (options.toolChoice) {
+                if ('auto' in options.toolChoice) {
+                    request.tool_choice = 'auto';
+                }
+                else if ('any' in options.toolChoice) {
+                    request.tool_choice = 'required';
+                }
+                else if ('tool' in options.toolChoice) {
+                    request.tool_choice = {
+                        type: 'function',
+                        function: { name: options.toolChoice.tool.name },
+                    };
+                }
+            }
+        }
+        // Spread params object last for forward compatibility
+        if (this._config.params) {
+            Object.assign(request, this._config.params);
+        }
+        // Validate n parameter (number of completions) - only n=1 supported for streaming
+        if ('n' in request && request.n !== undefined && request.n !== null && request.n > 1) {
+            throw new Error('Streaming with n > 1 is not supported');
+        }
+        return request;
+    }
+    /**
+     * Formats messages for OpenAI API.
+     * Handles splitting tool results into separate messages.
+     *
+     * @param messages - SDK messages
+     * @returns OpenAI-formatted messages
+     */
+    _formatMessages(messages) {
+        const openAIMessages = [];
+        for (const message of messages) {
+            if (message.role === 'user') {
+                // Separate tool results from other content
+                const toolResults = message.content.filter((b) => b.type === 'toolResultBlock');
+                const otherContent = message.content.filter((b) => b.type !== 'toolResultBlock');
+                // Add non-tool-result content as user message
+                if (otherContent.length > 0) {
+                    const contentParts = [];
+                    for (const block of otherContent) {
+                        switch (block.type) {
+                            case 'textBlock': {
+                                contentParts.push({
+                                    type: 'text',
+                                    text: block.text,
+                                });
+                                break;
+                            }
+                            case 'imageBlock': {
+                                const imageBlock = block;
+                                switch (imageBlock.source.type) {
+                                    case 'imageSourceUrl': {
+                                        contentParts.push({
+                                            type: 'image_url',
+                                            image_url: {
+                                                url: imageBlock.source.url,
+                                            },
+                                        });
+                                        break;
+                                    }
+                                    case 'imageSourceBytes': {
+                                        const base64 = encodeBase64(String.fromCharCode(...imageBlock.source.bytes));
+                                        const mimeType = mimeTypeLookup(imageBlock.format) || `image/${imageBlock.format}`;
+                                        contentParts.push({
+                                            type: 'image_url',
+                                            image_url: {
+                                                url: `data:${mimeType};base64,${base64}`,
+                                            },
+                                        });
+                                        break;
+                                    }
+                                    default: {
+                                        console.warn(`OpenAI ChatCompletions API does not support image block type: ${imageBlock.source.type}.`);
+                                        break;
+                                    }
+                                }
+                                break;
+                            }
+                            case 'documentBlock': {
+                                const docBlock = block;
+                                switch (docBlock.source.type) {
+                                    case 'documentSourceBytes': {
+                                        const mimeType = mimeTypeLookup(docBlock.format) || `application/${docBlock.format}`;
+                                        const base64 = encodeBase64(String.fromCharCode(...docBlock.source.bytes));
+                                        const file = {
+                                            type: 'file',
+                                            file: {
+                                                file_data: `data:${mimeType};base64,${base64}`,
+                                                filename: docBlock.name,
+                                            },
+                                        };
+                                        contentParts.push(file);
+                                        break;
+                                    }
+                                    case 'documentSourceText': {
+                                        // Text documents can be added directly
+                                        console.warn('OpenAI does not support text document sources directly. Converting this text document to string content.');
+                                        contentParts.push({
+                                            type: 'text',
+                                            text: docBlock.source.text,
+                                        });
+                                        break;
+                                    }
+                                    case 'documentSourceContentBlock': {
+                                        // Push each content block as a content part
+                                        contentParts.push(...docBlock.source.content.map((block) => {
+                                            return {
+                                                type: 'text',
+                                                text: block.text,
+                                            };
+                                        }));
+                                        break;
+                                    }
+                                    default: {
+                                        console.warn(`OpenAI ChatCompletions API only supports text content in user messages. Skipping document block type: ${docBlock.source.type}.`);
+                                        break;
+                                    }
+                                }
+                                break;
+                            }
+                            default: {
+                                console.warn(`OpenAI ChatCompletions API does not support content type: ${block.type}.`);
+                                break;
+                            }
+                        }
+                    }
+                    // Validate content is not empty before adding
+                    if (contentParts.length > 0) {
+                        openAIMessages.push({
+                            role: 'user',
+                            content: contentParts,
+                        });
+                    }
+                }
+                // Add each tool result as separate tool message
+                // OpenAI only supports text content in tool result messages, not JSON
+                for (const toolResult of toolResults) {
+                    if (toolResult.type === 'toolResultBlock') {
+                        // Format tool result content - convert all to text string
+                        // Note: OpenAI tool messages only accept string content (not structured JSON)
+                        const contentText = toolResult.content
+                            .map((c) => {
+                            if (c.type === 'textBlock') {
+                                return c.text;
+                            }
+                            else if (c.type === 'jsonBlock') {
+                                try {
+                                    return JSON.stringify(c.json);
+                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                }
+                                catch (error) {
+                                    const dataPreview = typeof c.json === 'object' && c.json !== null
+                                        ? `object with keys: ${Object.keys(c.json).slice(0, 5).join(', ')}`
+                                        : typeof c.json;
+                                    return `[JSON Serialization Error: ${error.message}. Data type: ${dataPreview}]`;
+                                }
+                            }
+                            return '';
+                        })
+                            .join('');
+                        // Validate content is not empty
+                        if (!contentText || contentText.trim().length === 0) {
+                            throw new Error(`Tool result for toolUseId "${toolResult.toolUseId}" has empty content. ` +
+                                'OpenAI requires tool messages to have non-empty content.');
+                        }
+                        // Prepend error indicator if status is error
+                        const finalContent = toolResult.status === 'error' ? `[ERROR] ${contentText}` : contentText;
+                        openAIMessages.push({
+                            role: 'tool',
+                            tool_call_id: toolResult.toolUseId,
+                            content: finalContent,
+                        });
+                    }
+                }
+            }
+            else {
+                // Handle assistant messages
+                const toolUseCalls = [];
+                // Use array + join pattern for efficient string concatenation
+                const textParts = [];
+                for (const block of message.content) {
+                    switch (block.type) {
+                        case 'textBlock': {
+                            textParts.push(block.text);
+                            break;
+                        }
+                        case 'toolUseBlock': {
+                            try {
+                                toolUseCalls.push({
+                                    id: block.toolUseId,
+                                    type: 'function',
+                                    function: {
+                                        name: block.name,
+                                        arguments: JSON.stringify(block.input),
+                                    },
+                                });
+                            }
+                            catch (error) {
+                                if (error instanceof Error) {
+                                    throw new Error(`Failed to serialize tool input for "${block.name}`, error);
+                                }
+                                throw error;
+                            }
+                            break;
+                        }
+                        case 'reasoningBlock': {
+                            if (block.text) {
+                                console.warn('Reasoning blocks are not supported by OpenAI Chat Completions API. Converting to text.');
+                                textParts.push(block.text);
+                            }
+                            break;
+                        }
+                        default: {
+                            console.warn(`OpenAI ChatCompletions API does not support ${block.type} content in assistant messages. Skipping this block.`);
+                        }
+                    }
+                }
+                // Trim text content to avoid whitespace-only messages
+                const textContent = textParts.join('').trim();
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: textContent,
+                };
+                if (toolUseCalls.length > 0) {
+                    assistantMessage.tool_calls = toolUseCalls;
+                }
+                // Only add if message has content or tool calls
+                if (textContent.length > 0 || toolUseCalls.length > 0) {
+                    openAIMessages.push(assistantMessage);
+                }
+            }
+        }
+        return openAIMessages;
+    }
+    /**
+     * Converts a snake_case string to camelCase.
+     * Used for mapping OpenAI stop reasons to SDK format.
+     *
+     * @param str - Snake case string (e.g., 'content_filter')
+     * @returns Camel case string (e.g., 'contentFilter')
+     *
+     * @example
+     * ```typescript
+     * _snakeToCamel('context_length_exceeded') // => 'contextLengthExceeded'
+     * _snakeToCamel('tool_calls') // => 'toolCalls'
+     * ```
+     */
+    _snakeToCamel(str) {
+        return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+    }
+    /**
+     * Maps an OpenAI chunk to SDK streaming events.
+     *
+     * @param chunk - OpenAI chunk
+     * @param streamState - Mutable state object tracking message and content block state
+     * @param activeToolCalls - Map tracking active tool calls by index
+     * @returns Array of SDK streaming events
+     */
+    _mapOpenAIChunkToSDKEvents(chunk, streamState, activeToolCalls) {
+        const events = [];
+        // Validate choices array has at least one element
+        if (!chunk.choices || chunk.choices.length === 0) {
+            return events;
+        }
+        const choice = chunk.choices[0];
+        // Validate choice is an object
+        if (!choice || typeof choice !== 'object') {
+            console.warn('Invalid choice format in OpenAI chunk:', choice);
+            return events;
+        }
+        // Process first choice (OpenAI typically returns one choice in streaming)
+        const typedChoice = choice;
+        if (!typedChoice.delta && !typedChoice.finish_reason) {
+            return events;
+        }
+        const delta = typedChoice.delta;
+        // Handle message start (role appears) - update mutable state
+        if (delta?.role && !streamState.messageStarted) {
+            streamState.messageStarted = true;
+            events.push({
+                type: 'modelMessageStartEvent',
+                role: delta.role,
+            });
+        }
+        // Handle text content delta and start event
+        if (delta?.content && delta.content.length > 0) {
+            // Emit start event on first text delta
+            if (!streamState.textContentBlockStarted) {
+                streamState.textContentBlockStarted = true;
+                events.push({
+                    type: 'modelContentBlockStartEvent',
+                });
+            }
+            events.push({
+                type: 'modelContentBlockDeltaEvent',
+                delta: {
+                    type: 'textDelta',
+                    text: delta.content,
+                },
+            });
+        }
+        // Handle tool calls
+        if (delta?.tool_calls && delta.tool_calls.length > 0) {
+            for (const toolCall of delta.tool_calls) {
+                // Validate tool call index
+                if (toolCall.index === undefined || typeof toolCall.index !== 'number') {
+                    console.warn('Received tool call with invalid index:', toolCall);
+                    continue;
+                }
+                // If tool call has id and name, it's the start of a new tool call
+                if (toolCall.id && toolCall.function?.name) {
+                    events.push({
+                        type: 'modelContentBlockStartEvent',
+                        start: {
+                            type: 'toolUseStart',
+                            name: toolCall.function.name,
+                            toolUseId: toolCall.id,
+                        },
+                    });
+                    // Track active tool calls
+                    activeToolCalls.set(toolCall.index, true);
+                }
+                // If tool call has arguments, it's a delta
+                if (toolCall.function?.arguments) {
+                    events.push({
+                        type: 'modelContentBlockDeltaEvent',
+                        delta: {
+                            type: 'toolUseInputDelta',
+                            input: toolCall.function.arguments,
+                        },
+                    });
+                }
+            }
+        }
+        // Handle finish reason (message stop)
+        if (typedChoice.finish_reason) {
+            // Emit stop event for text content if it was started
+            if (streamState.textContentBlockStarted) {
+                events.push({
+                    type: 'modelContentBlockStopEvent',
+                });
+                streamState.textContentBlockStarted = false;
+            }
+            // Emit stop events for all active tool calls and delete during iteration
+            for (const [index] of activeToolCalls) {
+                events.push({
+                    type: 'modelContentBlockStopEvent',
+                });
+                activeToolCalls.delete(index);
+            }
+            // Map OpenAI stop reason to SDK stop reason
+            const stopReasonMap = {
+                stop: 'endTurn',
+                tool_calls: 'toolUse',
+                length: 'maxTokens',
+                content_filter: 'contentFiltered',
+            };
+            // Log unknown stop reasons
+            let stopReason = stopReasonMap[typedChoice.finish_reason];
+            if (!stopReason) {
+                const fallbackReason = this._snakeToCamel(typedChoice.finish_reason);
+                console.warn(`Unknown OpenAI stop reason: "${typedChoice.finish_reason}". ` +
+                    `Using camelCase conversion as fallback: "${fallbackReason}". ` +
+                    'Please report this to update the stop reason mapping.');
+                stopReason = fallbackReason;
+            }
+            events.push({
+                type: 'modelMessageStopEvent',
+                stopReason,
+            });
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=openai.js.map