@mcp-abap-adt/llm-agent-server 10.0.0

package/dist/llm-providers/anthropic.js

@@ -0,0 +1,202 @@
+/**
+ * Anthropic (Claude) LLM Provider
+ */
+import axios from 'axios';
+import { BaseLLMProvider } from './base.js';
+export class AnthropicProvider extends BaseLLMProvider {
+    client;
+    model;
+    constructor(config) {
+        super(config);
+        this.validateConfig();
+        this.model = config.model || 'claude-3-5-sonnet-20241022';
+        this.client = axios.create({
+            baseURL: config.baseURL || 'https://api.anthropic.com/v1',
+            headers: {
+                'x-api-key': config.apiKey,
+                'anthropic-version': '2023-06-01',
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    async chat(messages, tools, options) {
+        try {
+            const systemMessage = messages.find((m) => m.role === 'system');
+            const conversationMessages = messages.filter((m) => m.role !== 'system');
+            const requestBody = {
+                model: options?.model ?? this.model,
+                messages: this.formatMessages(conversationMessages),
+                max_tokens: options?.maxTokens ?? this.config.maxTokens ?? 4096,
+                temperature: options?.temperature ?? this.config.temperature ?? 0.7,
+                ...(options?.topP !== undefined ? { top_p: options.topP } : {}),
+                ...(options?.stop ? { stop_sequences: options.stop } : {}),
+            };
+            if (systemMessage) {
+                requestBody.system = systemMessage.content;
+            }
+            if (tools && tools.length > 0) {
+                requestBody.tools = tools;
+            }
+            const response = await this.client.post('/messages', requestBody);
+            // Handle multi-block response (text + tool_use)
+            const content = response.data.content;
+            let textContent = '';
+            for (const block of content) {
+                if (block.type === 'text')
+                    textContent += block.text;
+            }
+            const rawUsage = response.data.usage;
+            const usage = rawUsage
+                ? {
+                    prompt_tokens: rawUsage.input_tokens ?? 0,
+                    completion_tokens: rawUsage.output_tokens ?? 0,
+                    total_tokens: (rawUsage.input_tokens ?? 0) + (rawUsage.output_tokens ?? 0),
+                }
+                : undefined;
+            return {
+                content: textContent,
+                finishReason: response.data.stop_reason,
+                raw: response.data,
+                usage,
+            };
+        }
+        catch (error) {
+            const message = axios.isAxiosError(error)
+                ? error.response?.data?.error
+                    ?.message || error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            throw new Error(`Anthropic API error: ${message}`);
+        }
+    }
+    async *streamChat(messages, tools, options) {
+        const systemMessage = messages.find((m) => m.role === 'system');
+        const conversationMessages = messages.filter((m) => m.role !== 'system');
+        const requestBody = {
+            model: options?.model ?? this.model,
+            messages: this.formatMessages(conversationMessages),
+            max_tokens: options?.maxTokens ?? this.config.maxTokens ?? 4096,
+            temperature: options?.temperature ?? this.config.temperature ?? 0.7,
+            stream: true,
+            ...(options?.topP !== undefined ? { top_p: options.topP } : {}),
+            ...(options?.stop ? { stop_sequences: options.stop } : {}),
+        };
+        if (systemMessage) {
+            requestBody.system = systemMessage.content;
+        }
+        if (tools && tools.length > 0) {
+            requestBody.tools = tools;
+        }
+        const baseURL = this.config.baseURL || 'https://api.anthropic.com/v1';
+        const response = await fetch(`${baseURL}/messages`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.config.apiKey ?? '',
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok || !response.body) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Anthropic streaming error: HTTP ${response.status} — ${text}`);
+        }
+        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() || '';
+                let eventType = '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed) {
+                        eventType = '';
+                        continue;
+                    }
+                    if (trimmed.startsWith('event: ')) {
+                        eventType = trimmed.slice(7);
+                        continue;
+                    }
+                    if (!trimmed.startsWith('data: '))
+                        continue;
+                    const data = trimmed.slice(6);
+                    try {
+                        const parsed = JSON.parse(data);
+                        if (eventType === 'content_block_delta' &&
+                            parsed.delta?.type === 'text_delta') {
+                            yield { content: parsed.delta.text || '', raw: parsed };
+                        }
+                        else if (eventType === 'message_start' && parsed.message?.usage) {
+                            const u = parsed.message.usage;
+                            yield {
+                                content: '',
+                                raw: parsed,
+                                usage: {
+                                    prompt_tokens: u.input_tokens ?? 0,
+                                    completion_tokens: u.output_tokens ?? 0,
+                                    total_tokens: (u.input_tokens ?? 0) + (u.output_tokens ?? 0),
+                                },
+                            };
+                        }
+                        else if (eventType === 'message_delta') {
+                            const u = parsed.usage;
+                            yield {
+                                content: '',
+                                finishReason: parsed.delta?.stop_reason,
+                                raw: parsed,
+                                usage: u
+                                    ? {
+                                        prompt_tokens: 0,
+                                        completion_tokens: u.output_tokens ?? 0,
+                                        total_tokens: u.output_tokens ?? 0,
+                                    }
+                                    : undefined,
+                            };
+                        }
+                        else if (eventType === 'error') {
+                            const error = parsed.error;
+                            throw new Error(`Anthropic stream error: ${error?.message ?? 'unknown'}`);
+                        }
+                        else {
+                            yield { content: '', raw: parsed };
+                        }
+                    }
+                    catch (e) {
+                        if (e instanceof Error &&
+                            e.message.startsWith('Anthropic stream error:')) {
+                            throw e;
+                        }
+                        /* incomplete JSON — skip */
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async getModels() {
+        const response = await this.client.get('/models');
+        return response.data.data.map((m) => ({ id: m.id, owned_by: m.owned_by }));
+    }
+    async getEmbeddingModels() {
+        return [];
+    }
+    /**
+     * Format messages for Anthropic API
+     */
+    formatMessages(messages) {
+        return messages.map((msg) => ({
+            role: msg.role === 'assistant' ? 'assistant' : 'user',
+            content: msg.content,
+        }));
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/llm-providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/llm-providers/anthropic.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAA6B,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C,MAAM,OAAO,iBAAkB,SAAQ,eAAgC;IAC5D,MAAM,CAAgB;IACtB,KAAK,CAAS;IAEvB,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,4BAA4B,CAAC;QAE1D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,8BAA8B;YACzD,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,mBAAmB,EAAE,YAAY;gBACjC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAAmB,EACnB,KAAiB,EACjB,OAAwB;QAExB,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAChE,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAEzE,MAAM,WAAW,GAA4B;gBAC3C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK;gBACnC,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC;gBACnD,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI;gBAC/D,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG;gBACnE,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC;YAEF,IAAI,aAAa,EAAE,CAAC;gBAClB,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;YAC7C,CAAC;YAED,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5B,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAElE,gDAAgD;YAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAG5B,CAAC;YACH,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC;YACvD,CAAC;YAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ;gBACpB,CAAC,CAAC;oBACE,aAAa,EAAE,QAAQ,CAAC,YAAY,IAAI,CAAC;oBACzC,iBAAiB,EAAE,QAAQ,CAAC,aAAa,IAAI,CAAC;oBAC9C,YAAY,EACV,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,CAAC;iBAC/D;gBACH,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,WAAW;gBACpB,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW;gBACvC,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,KAAK;aACN,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAE,KAAK,CAAC,QAAQ,EAAE,IAAyC,EAAE,KAAK;oBAC/D,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO;gBAC9B,CAAC,CAAC,KAAK,YAAY,KAAK;oBACtB,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,QAAmB,EACnB,KAAiB,EACjB,OAAwB;QAExB,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAChE,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAEzE,MAAM,WAAW,GAA4B;YAC3C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK;YACnC,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC;YACnD,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI;YAC/D,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG;YACnE,MAAM,EAAE,IAAI;YACZ,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC;QAEF,IAAI,aAAa,EAAE,CAAC;YAClB,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;QAC7C,CAAC;QAED,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,8BAA8B,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,WAAW,EAAE;YAClD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE;gBACrC,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,mCAAmC,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,IAAI,SAAS,GAAG,EAAE,CAAC;gBACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,SAAS,GAAG,EAAE,CAAC;wBACf,SAAS;oBACX,CAAC;oBACD,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBAClC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;wBAC7B,SAAS;oBACX,CAAC;oBACD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;wBAAE,SAAS;oBAE5C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAChC,IACE,SAAS,KAAK,qBAAqB;4BACnC,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,EACnC,CAAC;4BACD,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;wBAC1D,CAAC;6BAAM,IAAI,SAAS,KAAK,eAAe,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;4BAClE,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;4BAC/B,MAAM;gCACJ,OAAO,EAAE,EAAE;gCACX,GAAG,EAAE,MAAM;gCACX,KAAK,EAAE;oCACL,aAAa,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;oCAClC,iBAAiB,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC;oCACvC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC;iCAC7D;6BACF,CAAC;wBACJ,CAAC;6BAAM,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;4BACzC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;4BACvB,MAAM;gCACJ,OAAO,EAAE,EAAE;gCACX,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW;gCACvC,GAAG,EAAE,MAAM;gCACX,KAAK,EAAE,CAAC;oCACN,CAAC,CAAC;wCACE,aAAa,EAAE,CAAC;wCAChB,iBAAiB,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC;wCACvC,YAAY,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC;qCACnC;oCACH,CAAC,CAAC,SAAS;6BACd,CAAC;wBACJ,CAAC;6BAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;4BACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAyC,CAAC;4BAC/D,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,CACzD,CAAC;wBACJ,CAAC;6BAAM,CAAC;4BACN,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;wBACrC,CAAC;oBACH,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,IACE,CAAC,YAAY,KAAK;4BAClB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAC/C,CAAC;4BACD,MAAM,CAAC,CAAC;wBACV,CAAC;wBACD,4BAA4B;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,OAAQ,QAAQ,CAAC,IAAI,CAAC,IAAiD,CAAC,GAAG,CACzE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAmB;QACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;YACrD,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/llm-providers/base.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Base interface for LLM providers
+ */
+import type { IModelInfo, LLMCallOptions, LLMProviderConfig, LLMResponse, Message } from '@mcp-abap-adt/llm-agent';
+export interface LLMProvider {
+    /**
+     * Send a chat message and get response
+     */
+    chat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): Promise<LLMResponse>;
+    /**
+     * Stream chat response
+     */
+    streamChat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): AsyncIterable<LLMResponse>;
+    /**
+     * Get available models
+     */
+    getModels?(): Promise<string[] | IModelInfo[]>;
+    /**
+     * Get embedding models. Best-effort; may return empty array.
+     */
+    getEmbeddingModels?(): Promise<string[] | IModelInfo[]>;
+}
+export declare abstract class BaseLLMProvider<C extends LLMProviderConfig = LLMProviderConfig> implements LLMProvider {
+    readonly config: C;
+    constructor(config: C);
+    abstract chat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): Promise<LLMResponse>;
+    abstract streamChat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): AsyncIterable<LLMResponse>;
+    /**
+     * Validate configuration
+     */
+    protected validateConfig(): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/llm-providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/llm-providers/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,OAAO,EACR,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CACF,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;OAEG;IACH,UAAU,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IAE/C;;OAEG;IACH,kBAAkB,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;CACzD;AAED,8BAAsB,eAAe,CACnC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAC/C,YAAW,WAAW;IAEtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAEP,MAAM,EAAE,CAAC;IAIrB,QAAQ,CAAC,IAAI,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IAEvB,QAAQ,CAAC,UAAU,CACjB,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAAC,WAAW,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;CAKjC"}

package/dist/llm-providers/base.js

@@ -0,0 +1,18 @@
+/**
+ * Base interface for LLM providers
+ */
+export class BaseLLMProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig() {
+        if (!this.config.apiKey) {
+            throw new Error('API key is required');
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/llm-providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/llm-providers/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH,MAAM,OAAgB,eAAe;IAI1B,MAAM,CAAI;IAEnB,YAAY,MAAS;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAcD;;OAEG;IACO,cAAc;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/llm-providers/deepseek.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DeepSeek LLM Provider — extends OpenAI (DeepSeek uses OpenAI-compatible API).
+ */
+import type { IModelInfo, LLMProviderConfig, Message } from '@mcp-abap-adt/llm-agent';
+import { OpenAIProvider } from './openai.js';
+export interface DeepSeekConfig extends LLMProviderConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export declare class DeepSeekProvider extends OpenAIProvider {
+    protected readonly providerName: string;
+    constructor(config: DeepSeekConfig);
+    /**
+     * DeepSeek always uses max_tokens (no gpt-5/o1/o3 distinction).
+     */
+    protected getTokenLimitParam(_model: string, maxTokens: number): Record<string, number>;
+    getEmbeddingModels(): Promise<IModelInfo[]>;
+    /**
+     * Stricter formatMessages — tracks known tool_call_ids and drops orphans.
+     */
+    protected formatMessages(messages: Message[]): Array<Record<string, unknown>>;
+}
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/llm-providers/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/llm-providers/deepseek.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,OAAO,EACR,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,mBAA4B,YAAY,EAAE,MAAM,CAAc;gBAElD,MAAM,EAAE,cAAc;IAQlC;;OAEG;cACgB,kBAAkB,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIV,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAI1D;;OAEG;cACgB,cAAc,CAC/B,QAAQ,EAAE,OAAO,EAAE,GAClB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAsClC"}

package/dist/llm-providers/deepseek.js

@@ -0,0 +1,60 @@
+/**
+ * DeepSeek LLM Provider — extends OpenAI (DeepSeek uses OpenAI-compatible API).
+ */
+import { OpenAIProvider } from './openai.js';
+export class DeepSeekProvider extends OpenAIProvider {
+    providerName = 'DeepSeek';
+    constructor(config) {
+        super({
+            ...config,
+            baseURL: config.baseURL || 'https://api.deepseek.com/v1',
+            model: config.model || 'deepseek-chat',
+        });
+    }
+    /**
+     * DeepSeek always uses max_tokens (no gpt-5/o1/o3 distinction).
+     */
+    getTokenLimitParam(_model, maxTokens) {
+        return { max_tokens: maxTokens };
+    }
+    async getEmbeddingModels() {
+        return [];
+    }
+    /**
+     * Stricter formatMessages — tracks known tool_call_ids and drops orphans.
+     */
+    formatMessages(messages) {
+        const formatted = [];
+        const knownToolCallIds = new Set();
+        for (const msg of messages) {
+            const entry = {
+                role: msg.role,
+                content: msg.content ?? '',
+            };
+            if (msg.role === 'assistant' &&
+                msg.tool_calls &&
+                msg.tool_calls.length > 0) {
+                entry.tool_calls = msg.tool_calls;
+                entry.content = msg.content || null;
+                for (const tc of msg.tool_calls)
+                    if (tc.id)
+                        knownToolCallIds.add(tc.id);
+            }
+            if (msg.role === 'tool') {
+                if (!msg.tool_call_id || !knownToolCallIds.has(msg.tool_call_id))
+                    continue;
+                entry.tool_call_id = msg.tool_call_id;
+                entry.content =
+                    typeof msg.content === 'string'
+                        ? msg.content
+                        : JSON.stringify(msg.content ?? '');
+            }
+            // Final safety check: non-assistant roles MUST have string content
+            if (entry.role !== 'assistant' && entry.content === null)
+                entry.content = '';
+            formatted.push(entry);
+        }
+        return formatted;
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/llm-providers/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/llm-providers/deepseek.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAqB,cAAc,EAAE,MAAM,aAAa,CAAC;AAQhE,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACtB,YAAY,GAAW,UAAU,CAAC;IAE9D,YAAY,MAAsB;QAChC,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,6BAA6B;YACxD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,eAAe;SACvB,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACgB,kBAAkB,CACnC,MAAc,EACd,SAAiB;QAEjB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACnC,CAAC;IAEQ,KAAK,CAAC,kBAAkB;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACgB,cAAc,CAC/B,QAAmB;QAEnB,MAAM,SAAS,GAAmC,EAAE,CAAC;QACrD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,KAAK,GAA4B;gBACrC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;aAC3B,CAAC;YAEF,IACE,GAAG,CAAC,IAAI,KAAK,WAAW;gBACxB,GAAG,CAAC,UAAU;gBACd,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EACzB,CAAC;gBACD,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;gBAClC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;gBACpC,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU;oBAAE,IAAI,EAAE,CAAC,EAAE;wBAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;oBAC9D,SAAS;gBACX,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;gBACtC,KAAK,CAAC,OAAO;oBACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;wBAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;wBACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC;YAED,mEAAmE;YACnE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBACtD,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;YAErB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/llm-providers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * LLM Provider exports
+ *
+ * NOTE: All LLM providers are accessed through SAP AI Core.
+ * Direct integrations with OpenAI/Anthropic/DeepSeek are removed.
+ * Use SapCoreAIProvider with appropriate model names to access different providers.
+ */
+export { type AnthropicConfig, AnthropicProvider } from './anthropic.js';
+export { BaseLLMProvider, type LLMProvider } from './base.js';
+export { type DeepSeekConfig, DeepSeekProvider } from './deepseek.js';
+export { type OpenAIConfig, OpenAIProvider } from './openai.js';
+export { type SapCoreAIConfig, SapCoreAIProvider } from './sap-core-ai.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,KAAK,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/llm-providers/index.js

@@ -0,0 +1,15 @@
+/**
+ * LLM Provider exports
+ *
+ * NOTE: All LLM providers are accessed through SAP AI Core.
+ * Direct integrations with OpenAI/Anthropic/DeepSeek are removed.
+ * Use SapCoreAIProvider with appropriate model names to access different providers.
+ */
+export { AnthropicProvider } from './anthropic.js';
+export { BaseLLMProvider } from './base.js';
+export { DeepSeekProvider } from './deepseek.js';
+// Legacy exports (deprecated - use SapCoreAIProvider instead)
+// These are kept for backward compatibility but will be removed in future versions
+export { OpenAIProvider } from './openai.js';
+export { SapCoreAIProvider } from './sap-core-ai.js';
+//# sourceMappingURL=index.js.map

package/dist/llm-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAwB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAoB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAuB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtE,8DAA8D;AAC9D,mFAAmF;AACnF,OAAO,EAAqB,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAwB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * OpenAI LLM Provider
+ */
+import type { IModelInfo, LLMCallOptions, LLMProviderConfig, LLMResponse, Message } from '@mcp-abap-adt/llm-agent';
+import { type AxiosInstance } from 'axios';
+import { BaseLLMProvider } from './base.js';
+export interface OpenAIConfig extends LLMProviderConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    organization?: string;
+    project?: string;
+}
+export declare class OpenAIProvider extends BaseLLMProvider<OpenAIConfig> {
+    readonly client: AxiosInstance;
+    readonly model: string;
+    protected readonly providerName: string;
+    constructor(config: OpenAIConfig);
+    chat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): Promise<LLMResponse>;
+    streamChat(messages: Message[], tools?: unknown[], options?: LLMCallOptions): AsyncIterable<LLMResponse>;
+    getModels(): Promise<IModelInfo[]>;
+    getEmbeddingModels(): Promise<IModelInfo[]>;
+    /**
+     * Return the appropriate token limit parameter for the model.
+     * Newer models (o1, o3, gpt-5+) require max_completion_tokens;
+     * legacy models use max_tokens.
+     */
+    protected getTokenLimitParam(model: string, maxTokens: number): Record<string, number>;
+    /**
+     * Format messages for OpenAI API with strict protocol enforcement.
+     */
+    protected formatMessages(messages: Message[]): Array<Record<string, unknown>>;
+}
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/llm-providers/openai.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,OAAO,EACR,MAAM,yBAAyB,CAAC;AACjC,OAAc,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,eAAe,CAAC,YAAY,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAY;gBAEvC,MAAM,EAAE,YAAY;IA2B1B,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IA6ChB,UAAU,CACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAAC,WAAW,CAAC;IA6EvB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAOlC,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAOjD;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQzB;;OAEG;IACH,SAAS,CAAC,cAAc,CACtB,QAAQ,EAAE,OAAO,EAAE,GAClB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAmClC"}

package/dist/llm-providers/openai.js

@@ -0,0 +1,193 @@
+/**
+ * OpenAI LLM Provider
+ */
+import axios from 'axios';
+import { BaseLLMProvider } from './base.js';
+export class OpenAIProvider extends BaseLLMProvider {
+    client;
+    model;
+    providerName = 'OpenAI';
+    constructor(config) {
+        super(config);
+        this.validateConfig();
+        this.model = config.model || 'gpt-4o-mini';
+        const headers = {
+            Authorization: `Bearer ${config.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+        // Add organization header if provided
+        if (config.organization) {
+            headers['OpenAI-Organization'] = config.organization;
+        }
+        // Add project header if provided
+        if (config.project) {
+            headers['OpenAI-Project'] = config.project;
+        }
+        this.client = axios.create({
+            baseURL: config.baseURL || 'https://api.openai.com/v1',
+            headers,
+        });
+    }
+    async chat(messages, tools, options) {
+        try {
+            const model = options?.model ?? this.model;
+            const temperature = options?.temperature ?? this.config.temperature ?? 0.7;
+            const maxTokens = options?.maxTokens ?? this.config.maxTokens ?? 4096;
+            const response = await this.client.post('/chat/completions', {
+                model,
+                messages: this.formatMessages(messages),
+                tools: tools && tools.length > 0 ? tools : undefined,
+                tool_choice: tools && tools.length > 0 ? 'auto' : undefined,
+                temperature,
+                ...this.getTokenLimitParam(model, maxTokens),
+                ...(options?.topP !== undefined ? { top_p: options.topP } : {}),
+                ...(options?.stop ? { stop: options.stop } : {}),
+            });
+            const choice = response.data.choices[0];
+            const usage = response.data.usage
+                ? {
+                    prompt_tokens: response.data.usage.prompt_tokens,
+                    completion_tokens: response.data.usage.completion_tokens,
+                    total_tokens: response.data.usage.total_tokens,
+                }
+                : undefined;
+            return {
+                content: choice.message.content || '',
+                finishReason: choice.finish_reason,
+                raw: response.data,
+                usage,
+            };
+        }
+        catch (error) {
+            const message = axios.isAxiosError(error)
+                ? error.response?.data?.error
+                    ?.message || error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            throw new Error(`${this.providerName} API error: ${message}`);
+        }
+    }
+    async *streamChat(messages, tools, options) {
+        try {
+            const model = options?.model ?? this.model;
+            const temperature = options?.temperature ?? this.config.temperature ?? 0.7;
+            const maxTokens = options?.maxTokens ?? this.config.maxTokens ?? 4096;
+            const response = await this.client.post('/chat/completions', {
+                model,
+                messages: this.formatMessages(messages),
+                tools: tools && tools.length > 0 ? tools : undefined,
+                tool_choice: tools && tools.length > 0 ? 'auto' : undefined,
+                temperature,
+                ...this.getTokenLimitParam(model, maxTokens),
+                ...(options?.topP !== undefined ? { top_p: options.topP } : {}),
+                ...(options?.stop ? { stop: options.stop } : {}),
+                stream: true,
+                stream_options: { include_usage: true },
+            }, { responseType: 'stream' });
+            const stream = response.data;
+            let buffer = '';
+            for await (const chunk of stream) {
+                buffer += chunk.toString();
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed?.startsWith('data: '))
+                        continue;
+                    const data = trimmed.slice(6);
+                    if (data === '[DONE]')
+                        break;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const choice = parsed.choices?.[0];
+                        if (choice?.delta) {
+                            yield {
+                                content: choice.delta.content || '',
+                                finishReason: choice.finish_reason,
+                                raw: parsed,
+                            };
+                        }
+                        // Usage-only chunk (stream_options: include_usage)
+                        if (parsed.usage && !choice?.delta) {
+                            yield {
+                                content: '',
+                                raw: parsed,
+                                usage: {
+                                    prompt_tokens: parsed.usage.prompt_tokens,
+                                    completion_tokens: parsed.usage.completion_tokens,
+                                    total_tokens: parsed.usage.total_tokens,
+                                },
+                            };
+                        }
+                    }
+                    catch (_e) {
+                        // Ignore parse errors for incomplete chunks
+                    }
+                }
+            }
+        }
+        catch (error) {
+            const message = axios.isAxiosError(error)
+                ? error.response?.data?.error
+                    ?.message || error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            throw new Error(`${this.providerName} Streaming error: ${message}`);
+        }
+    }
+    async getModels() {
+        const response = await this.client.get('/models');
+        return response.data.data.map((m) => ({ id: m.id, owned_by: m.owned_by }));
+    }
+    async getEmbeddingModels() {
+        const response = await this.client.get('/models');
+        return response.data.data
+            .filter((m) => /embed/i.test(m.id))
+            .map((m) => ({ id: m.id, owned_by: m.owned_by }));
+    }
+    /**
+     * Return the appropriate token limit parameter for the model.
+     * Newer models (o1, o3, gpt-5+) require max_completion_tokens;
+     * legacy models use max_tokens.
+     */
+    getTokenLimitParam(model, maxTokens) {
+        const normalized = model.toLowerCase();
+        const needsCompletionTokens = /^(o[13]|gpt-5)/.test(normalized);
+        return needsCompletionTokens
+            ? { max_completion_tokens: maxTokens }
+            : { max_tokens: maxTokens };
+    }
+    /**
+     * Format messages for OpenAI API with strict protocol enforcement.
+     */
+    formatMessages(messages) {
+        const formatted = [];
+        for (const msg of messages) {
+            if (msg.role === 'tool' && !msg.tool_call_id) {
+                continue;
+            }
+            const entry = {
+                role: msg.role,
+                content: msg.content ?? '',
+            };
+            if (msg.role === 'assistant' &&
+                msg.tool_calls &&
+                msg.tool_calls.length > 0) {
+                entry.tool_calls = msg.tool_calls;
+                entry.content = msg.content || null;
+            }
+            if (msg.role === 'tool') {
+                entry.tool_call_id = msg.tool_call_id;
+                entry.content =
+                    typeof msg.content === 'string'
+                        ? msg.content
+                        : JSON.stringify(msg.content ?? '');
+            }
+            formatted.push(entry);
+        }
+        return formatted;
+    }
+}
+//# sourceMappingURL=openai.js.map