@tanstack/openai-base 0.1.0

package/dist/esm/adapters/chat-completions-text.d.ts

@@ -0,0 +1,76 @@
+import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
+import { default as OpenAI_SDK } from 'openai';
+import { ContentPart, DefaultMessageMetadataByModality, Modality, ModelMessage, StreamChunk, TextOptions } from '@tanstack/ai';
+import { OpenAICompatibleClientConfig } from '../types/config.js';
+/**
+ * OpenAI-compatible Chat Completions Text Adapter
+ *
+ * A generalized base class for providers that use the OpenAI Chat Completions API
+ * (`/v1/chat/completions`). Providers like Grok, Groq, OpenRouter, and others can
+ * extend this class and only need to:
+ * - Set `baseURL` in the config
+ * - Lock the generic type parameters to provider-specific types
+ * - Override specific methods for quirks
+ *
+ * All methods that build requests or process responses are `protected` so subclasses
+ * can override them.
+ */
+export declare class OpenAICompatibleChatCompletionsTextAdapter<TModel extends string, TProviderOptions extends Record<string, any> = Record<string, any>, TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>, TMessageMetadata extends DefaultMessageMetadataByModality = DefaultMessageMetadataByModality> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, TMessageMetadata> {
+    readonly kind: "text";
+    readonly name: string;
+    protected client: OpenAI_SDK;
+    constructor(config: OpenAICompatibleClientConfig, model: TModel, name?: string);
+    chatStream(options: TextOptions<TProviderOptions>): AsyncIterable<StreamChunk>;
+    /**
+     * Generate structured output using the provider's JSON Schema response format.
+     * Uses stream: false to get the complete response in one call.
+     *
+     * OpenAI-compatible APIs have strict requirements for structured output:
+     * - All properties must be in the `required` array
+     * - Optional fields should have null added to their type union
+     * - additionalProperties must be false for all objects
+     *
+     * The outputSchema is already JSON Schema (converted in the ai layer).
+     * We apply provider-specific transformations for structured output compatibility.
+     */
+    structuredOutput(options: StructuredOutputOptions<TProviderOptions>): Promise<StructuredOutputResult<unknown>>;
+    /**
+     * Applies provider-specific transformations for structured output compatibility.
+     * Override this in subclasses to handle provider-specific quirks.
+     */
+    protected makeStructuredOutputCompatible(schema: Record<string, any>, originalRequired: Array<string>): Record<string, any>;
+    /**
+     * Processes streamed chunks from the Chat Completions API and yields AG-UI events.
+     * Override this in subclasses to handle provider-specific stream behavior.
+     */
+    protected processStreamChunks(stream: AsyncIterable<OpenAI_SDK.Chat.Completions.ChatCompletionChunk>, options: TextOptions, aguiState: {
+        runId: string;
+        messageId: string;
+        timestamp: number;
+        hasEmittedRunStarted: boolean;
+    }): AsyncIterable<StreamChunk>;
+    /**
+     * Maps common TextOptions to Chat Completions API request format.
+     * Override this in subclasses to add provider-specific options.
+     */
+    protected mapOptionsToRequest(options: TextOptions): OpenAI_SDK.Chat.Completions.ChatCompletionCreateParamsStreaming;
+    /**
+     * Converts a single ModelMessage to the Chat Completions API message format.
+     * Override this in subclasses to handle provider-specific message formats.
+     */
+    protected convertMessage(message: ModelMessage): OpenAI_SDK.Chat.Completions.ChatCompletionMessageParam;
+    /**
+     * Converts a single ContentPart to the Chat Completions API content part format.
+     * Override this in subclasses to handle additional content types or provider-specific metadata.
+     */
+    protected convertContentPart(part: ContentPart): OpenAI_SDK.Chat.Completions.ChatCompletionContentPart | null;
+    /**
+     * Normalizes message content to an array of ContentPart.
+     * Handles backward compatibility with string content.
+     */
+    protected normalizeContent(content: string | null | Array<ContentPart>): Array<ContentPart>;
+    /**
+     * Extracts text content from a content value that may be string, null, or ContentPart array.
+     */
+    protected extractTextContent(content: string | null | Array<ContentPart>): string;
+}

package/dist/esm/adapters/chat-completions-text.js

@@ -0,0 +1,411 @@
+import { BaseTextAdapter } from "@tanstack/ai/adapters";
+import { generateId, transformNullsToUndefined } from "@tanstack/ai-utils";
+import { createOpenAICompatibleClient } from "../utils/client.js";
+import { makeStructuredOutputCompatible } from "../utils/schema-converter.js";
+import { convertToolsToChatCompletionsFormat } from "./chat-completions-tool-converter.js";
+class OpenAICompatibleChatCompletionsTextAdapter extends BaseTextAdapter {
+  constructor(config, model, name = "openai-compatible") {
+    super({}, model);
+    this.kind = "text";
+    this.name = name;
+    this.client = createOpenAICompatibleClient(config);
+  }
+  async *chatStream(options) {
+    const requestParams = this.mapOptionsToRequest(options);
+    const timestamp = Date.now();
+    const aguiState = {
+      runId: generateId(this.name),
+      messageId: generateId(this.name),
+      timestamp,
+      hasEmittedRunStarted: false
+    };
+    try {
+      const stream = await this.client.chat.completions.create(
+        {
+          ...requestParams,
+          stream: true,
+          stream_options: { include_usage: true }
+        },
+        {
+          headers: options.request?.headers,
+          signal: options.request?.signal
+        }
+      );
+      yield* this.processStreamChunks(stream, options, aguiState);
+    } catch (error) {
+      const err = error;
+      if (!aguiState.hasEmittedRunStarted) {
+        aguiState.hasEmittedRunStarted = true;
+        yield {
+          type: "RUN_STARTED",
+          runId: aguiState.runId,
+          model: options.model,
+          timestamp
+        };
+      }
+      yield {
+        type: "RUN_ERROR",
+        runId: aguiState.runId,
+        model: options.model,
+        timestamp,
+        error: {
+          message: err.message || "Unknown error",
+          code: err.code
+        }
+      };
+      console.error(
+        `>>> [${this.name}] chatStream: Fatal error during response creation <<<`
+      );
+      console.error(">>> Error message:", err.message);
+      console.error(">>> Error stack:", err.stack);
+      console.error(">>> Full error:", err);
+    }
+  }
+  /**
+   * Generate structured output using the provider's JSON Schema response format.
+   * Uses stream: false to get the complete response in one call.
+   *
+   * OpenAI-compatible APIs have strict requirements for structured output:
+   * - All properties must be in the `required` array
+   * - Optional fields should have null added to their type union
+   * - additionalProperties must be false for all objects
+   *
+   * The outputSchema is already JSON Schema (converted in the ai layer).
+   * We apply provider-specific transformations for structured output compatibility.
+   */
+  async structuredOutput(options) {
+    const { chatOptions, outputSchema } = options;
+    const requestParams = this.mapOptionsToRequest(chatOptions);
+    const jsonSchema = this.makeStructuredOutputCompatible(
+      outputSchema,
+      outputSchema.required || []
+    );
+    try {
+      const {
+        stream_options: _,
+        stream: __,
+        ...cleanParams
+      } = requestParams;
+      const response = await this.client.chat.completions.create(
+        {
+          ...cleanParams,
+          stream: false,
+          response_format: {
+            type: "json_schema",
+            json_schema: {
+              name: "structured_output",
+              schema: jsonSchema,
+              strict: true
+            }
+          }
+        },
+        {
+          headers: chatOptions.request?.headers,
+          signal: chatOptions.request?.signal
+        }
+      );
+      const rawText = response.choices[0]?.message.content || "";
+      let parsed;
+      try {
+        parsed = JSON.parse(rawText);
+      } catch {
+        throw new Error(
+          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? "..." : ""}`
+        );
+      }
+      const transformed = transformNullsToUndefined(parsed);
+      return {
+        data: transformed,
+        rawText
+      };
+    } catch (error) {
+      const err = error;
+      console.error(
+        `>>> [${this.name}] structuredOutput: Error during response creation <<<`
+      );
+      console.error(">>> Error message:", err.message);
+      throw error;
+    }
+  }
+  /**
+   * Applies provider-specific transformations for structured output compatibility.
+   * Override this in subclasses to handle provider-specific quirks.
+   */
+  makeStructuredOutputCompatible(schema, originalRequired) {
+    return makeStructuredOutputCompatible(schema, originalRequired);
+  }
+  /**
+   * Processes streamed chunks from the Chat Completions API and yields AG-UI events.
+   * Override this in subclasses to handle provider-specific stream behavior.
+   */
+  async *processStreamChunks(stream, options, aguiState) {
+    let accumulatedContent = "";
+    const timestamp = aguiState.timestamp;
+    let hasEmittedTextMessageStart = false;
+    const toolCallsInProgress = /* @__PURE__ */ new Map();
+    try {
+      for await (const chunk of stream) {
+        const choice = chunk.choices[0];
+        if (!choice) continue;
+        if (!aguiState.hasEmittedRunStarted) {
+          aguiState.hasEmittedRunStarted = true;
+          yield {
+            type: "RUN_STARTED",
+            runId: aguiState.runId,
+            model: chunk.model || options.model,
+            timestamp
+          };
+        }
+        const delta = choice.delta;
+        const deltaContent = delta.content;
+        const deltaToolCalls = delta.tool_calls;
+        if (deltaContent) {
+          if (!hasEmittedTextMessageStart) {
+            hasEmittedTextMessageStart = true;
+            yield {
+              type: "TEXT_MESSAGE_START",
+              messageId: aguiState.messageId,
+              model: chunk.model || options.model,
+              timestamp,
+              role: "assistant"
+            };
+          }
+          accumulatedContent += deltaContent;
+          yield {
+            type: "TEXT_MESSAGE_CONTENT",
+            messageId: aguiState.messageId,
+            model: chunk.model || options.model,
+            timestamp,
+            delta: deltaContent,
+            content: accumulatedContent
+          };
+        }
+        if (deltaToolCalls) {
+          for (const toolCallDelta of deltaToolCalls) {
+            const index = toolCallDelta.index;
+            if (!toolCallsInProgress.has(index)) {
+              toolCallsInProgress.set(index, {
+                id: toolCallDelta.id || "",
+                name: toolCallDelta.function?.name || "",
+                arguments: "",
+                started: false
+              });
+            }
+            const toolCall = toolCallsInProgress.get(index);
+            if (toolCallDelta.id) {
+              toolCall.id = toolCallDelta.id;
+            }
+            if (toolCallDelta.function?.name) {
+              toolCall.name = toolCallDelta.function.name;
+            }
+            if (toolCallDelta.function?.arguments) {
+              toolCall.arguments += toolCallDelta.function.arguments;
+            }
+            if (toolCall.id && toolCall.name && !toolCall.started) {
+              toolCall.started = true;
+              yield {
+                type: "TOOL_CALL_START",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                model: chunk.model || options.model,
+                timestamp,
+                index
+              };
+            }
+            if (toolCallDelta.function?.arguments && toolCall.started) {
+              yield {
+                type: "TOOL_CALL_ARGS",
+                toolCallId: toolCall.id,
+                model: chunk.model || options.model,
+                timestamp,
+                delta: toolCallDelta.function.arguments
+              };
+            }
+          }
+        }
+        if (choice.finish_reason) {
+          if (choice.finish_reason === "tool_calls" || toolCallsInProgress.size > 0) {
+            for (const [, toolCall] of toolCallsInProgress) {
+              let parsedInput = {};
+              try {
+                parsedInput = toolCall.arguments ? JSON.parse(toolCall.arguments) : {};
+              } catch {
+                parsedInput = {};
+              }
+              yield {
+                type: "TOOL_CALL_END",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                model: chunk.model || options.model,
+                timestamp,
+                input: parsedInput
+              };
+            }
+          }
+          const computedFinishReason = choice.finish_reason === "tool_calls" || toolCallsInProgress.size > 0 ? "tool_calls" : "stop";
+          if (hasEmittedTextMessageStart) {
+            yield {
+              type: "TEXT_MESSAGE_END",
+              messageId: aguiState.messageId,
+              model: chunk.model || options.model,
+              timestamp
+            };
+          }
+          yield {
+            type: "RUN_FINISHED",
+            runId: aguiState.runId,
+            model: chunk.model || options.model,
+            timestamp,
+            usage: chunk.usage ? {
+              promptTokens: chunk.usage.prompt_tokens || 0,
+              completionTokens: chunk.usage.completion_tokens || 0,
+              totalTokens: chunk.usage.total_tokens || 0
+            } : void 0,
+            finishReason: computedFinishReason
+          };
+        }
+      }
+    } catch (error) {
+      const err = error;
+      console.error(`[${this.name}] Stream ended with error:`, err.message);
+      yield {
+        type: "RUN_ERROR",
+        runId: aguiState.runId,
+        model: options.model,
+        timestamp,
+        error: {
+          message: err.message || "Unknown error occurred",
+          code: err.code
+        }
+      };
+    }
+  }
+  /**
+   * Maps common TextOptions to Chat Completions API request format.
+   * Override this in subclasses to add provider-specific options.
+   */
+  mapOptionsToRequest(options) {
+    const tools = options.tools ? convertToolsToChatCompletionsFormat(
+      options.tools,
+      this.makeStructuredOutputCompatible.bind(this)
+    ) : void 0;
+    const messages = [];
+    if (options.systemPrompts && options.systemPrompts.length > 0) {
+      messages.push({
+        role: "system",
+        content: options.systemPrompts.join("\n")
+      });
+    }
+    for (const message of options.messages) {
+      messages.push(this.convertMessage(message));
+    }
+    const modelOptions = options.modelOptions;
+    return {
+      ...modelOptions,
+      model: options.model,
+      messages,
+      temperature: options.temperature,
+      max_tokens: options.maxTokens,
+      top_p: options.topP,
+      tools,
+      stream: true
+    };
+  }
+  /**
+   * Converts a single ModelMessage to the Chat Completions API message format.
+   * Override this in subclasses to handle provider-specific message formats.
+   */
+  convertMessage(message) {
+    if (message.role === "tool") {
+      return {
+        role: "tool",
+        tool_call_id: message.toolCallId || "",
+        content: typeof message.content === "string" ? message.content : JSON.stringify(message.content)
+      };
+    }
+    if (message.role === "assistant") {
+      const toolCalls = message.toolCalls?.map((tc) => ({
+        id: tc.id,
+        type: "function",
+        function: {
+          name: tc.function.name,
+          arguments: typeof tc.function.arguments === "string" ? tc.function.arguments : JSON.stringify(tc.function.arguments)
+        }
+      }));
+      return {
+        role: "assistant",
+        content: this.extractTextContent(message.content),
+        ...toolCalls && toolCalls.length > 0 ? { tool_calls: toolCalls } : {}
+      };
+    }
+    const contentParts = this.normalizeContent(message.content);
+    if (contentParts.length === 1 && contentParts[0]?.type === "text") {
+      return {
+        role: "user",
+        content: contentParts[0].content
+      };
+    }
+    const parts = [];
+    for (const part of contentParts) {
+      const converted = this.convertContentPart(part);
+      if (converted) {
+        parts.push(converted);
+      }
+    }
+    return {
+      role: "user",
+      content: parts.length > 0 ? parts : ""
+    };
+  }
+  /**
+   * Converts a single ContentPart to the Chat Completions API content part format.
+   * Override this in subclasses to handle additional content types or provider-specific metadata.
+   */
+  convertContentPart(part) {
+    if (part.type === "text") {
+      return { type: "text", text: part.content };
+    }
+    if (part.type === "image") {
+      const imageMetadata = part.metadata;
+      const imageValue = part.source.value;
+      const imageUrl = part.source.type === "data" && !imageValue.startsWith("data:") ? `data:${part.source.mimeType};base64,${imageValue}` : imageValue;
+      return {
+        type: "image_url",
+        image_url: {
+          url: imageUrl,
+          detail: imageMetadata?.detail || "auto"
+        }
+      };
+    }
+    return null;
+  }
+  /**
+   * Normalizes message content to an array of ContentPart.
+   * Handles backward compatibility with string content.
+   */
+  normalizeContent(content) {
+    if (content === null) {
+      return [];
+    }
+    if (typeof content === "string") {
+      return [{ type: "text", content }];
+    }
+    return content;
+  }
+  /**
+   * Extracts text content from a content value that may be string, null, or ContentPart array.
+   */
+  extractTextContent(content) {
+    if (content === null) {
+      return "";
+    }
+    if (typeof content === "string") {
+      return content;
+    }
+    return content.filter((p) => p.type === "text").map((p) => p.content).join("");
+  }
+}
+export {
+  OpenAICompatibleChatCompletionsTextAdapter
+};
+//# sourceMappingURL=chat-completions-text.js.map

package/dist/esm/adapters/chat-completions-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-completions-text.js","sources":["../../../src/adapters/chat-completions-text.ts"],"sourcesContent":["import { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport { generateId, transformNullsToUndefined } from '@tanstack/ai-utils'\nimport { createOpenAICompatibleClient } from '../utils/client'\nimport { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport { convertToolsToChatCompletionsFormat } from './chat-completions-tool-converter'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type OpenAI_SDK from 'openai'\nimport type {\n  ContentPart,\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { OpenAICompatibleClientConfig } from '../types/config'\n\n/**\n * OpenAI-compatible Chat Completions Text Adapter\n *\n * A generalized base class for providers that use the OpenAI Chat Completions API\n * (`/v1/chat/completions`). Providers like Grok, Groq, OpenRouter, and others can\n * extend this class and only need to:\n * - Set `baseURL` in the config\n * - Lock the generic type parameters to provider-specific types\n * - Override specific methods for quirks\n *\n * All methods that build requests or process responses are `protected` so subclasses\n * can override them.\n */\nexport class OpenAICompatibleChatCompletionsTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, any> = Record<string, any>,\n  TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TMessageMetadata extends DefaultMessageMetadataByModality =\n    DefaultMessageMetadataByModality,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadata\n> {\n  readonly kind = 'text' as const\n  readonly name: string\n\n  protected client: OpenAI_SDK\n\n  constructor(\n    config: OpenAICompatibleClientConfig,\n    model: TModel,\n    name: string = 'openai-compatible',\n  ) {\n    super({}, model)\n    this.name = name\n    this.client = createOpenAICompatibleClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const requestParams = this.mapOptionsToRequest(options)\n    const timestamp = Date.now()\n\n    // AG-UI lifecycle tracking (mutable state object for ESLint compatibility)\n    const aguiState = {\n      runId: generateId(this.name),\n      messageId: generateId(this.name),\n      timestamp,\n      hasEmittedRunStarted: false,\n    }\n\n    try {\n      const stream = await this.client.chat.completions.create(\n        {\n          ...requestParams,\n          stream: true,\n          stream_options: { include_usage: true },\n        },\n        {\n          headers: (options.request as RequestInit | undefined)?.headers as\n            | Record<string, string>\n            | undefined,\n          signal: (options.request as RequestInit | undefined)?.signal,\n        },\n      )\n\n      yield* this.processStreamChunks(stream, options, aguiState)\n    } catch (error: unknown) {\n      const err = error as Error & { code?: string }\n\n      // Emit RUN_STARTED if not yet emitted\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: 'RUN_STARTED',\n          runId: aguiState.runId,\n          model: options.model,\n          timestamp,\n        }\n      }\n\n      // Emit AG-UI RUN_ERROR\n      yield {\n        type: 'RUN_ERROR',\n        runId: aguiState.runId,\n        model: options.model,\n        timestamp,\n        error: {\n          message: err.message || 'Unknown error',\n          code: err.code,\n        },\n      }\n\n      console.error(\n        `>>> [${this.name}] chatStream: Fatal error during response creation <<<`,\n      )\n      console.error('>>> Error message:', err.message)\n      console.error('>>> Error stack:', err.stack)\n      console.error('>>> Full error:', err)\n    }\n  }\n\n  /**\n   * Generate structured output using the provider's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * OpenAI-compatible APIs have strict requirements for structured output:\n   * - All properties must be in the `required` array\n   * - Optional fields should have null added to their type union\n   * - additionalProperties must be false for all objects\n   *\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   * We apply provider-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required || [],\n    )\n\n    try {\n      // Strip stream_options which is only valid for streaming calls\n      const {\n        stream_options: _,\n        stream: __,\n        ...cleanParams\n      } = requestParams as any\n      const response = await this.client.chat.completions.create(\n        {\n          ...cleanParams,\n          stream: false,\n          response_format: {\n            type: 'json_schema',\n            json_schema: {\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        {\n          headers: (chatOptions.request as RequestInit | undefined)?.headers as\n            | Record<string, string>\n            | undefined,\n          signal: (chatOptions.request as RequestInit | undefined)?.signal,\n        },\n      )\n\n      // Extract text content from the response\n      const rawText = response.choices[0]?.message.content || ''\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      // Transform null values to undefined to match original Zod schema expectations\n      // Provider returns null for optional fields we made nullable in the schema\n      const transformed = transformNullsToUndefined(parsed)\n\n      return {\n        data: transformed,\n        rawText,\n      }\n    } catch (error: unknown) {\n      const err = error as Error\n      console.error(\n        `>>> [${this.name}] structuredOutput: Error during response creation <<<`,\n      )\n      console.error('>>> Error message:', err.message)\n      throw error\n    }\n  }\n\n  /**\n   * Applies provider-specific transformations for structured output compatibility.\n   * Override this in subclasses to handle provider-specific quirks.\n   */\n  protected makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired: Array<string>,\n  ): Record<string, any> {\n    return makeStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  /**\n   * Processes streamed chunks from the Chat Completions API and yields AG-UI events.\n   * Override this in subclasses to handle provider-specific stream behavior.\n   */\n  protected async *processStreamChunks(\n    stream: AsyncIterable<OpenAI_SDK.Chat.Completions.ChatCompletionChunk>,\n    options: TextOptions,\n    aguiState: {\n      runId: string\n      messageId: string\n      timestamp: number\n      hasEmittedRunStarted: boolean\n    },\n  ): AsyncIterable<StreamChunk> {\n    let accumulatedContent = ''\n    const timestamp = aguiState.timestamp\n    let hasEmittedTextMessageStart = false\n\n    // Track tool calls being streamed (arguments come in chunks)\n    const toolCallsInProgress = new Map<\n      number,\n      {\n        id: string\n        name: string\n        arguments: string\n        started: boolean // Track if TOOL_CALL_START has been emitted\n      }\n    >()\n\n    try {\n      for await (const chunk of stream) {\n        const choice = chunk.choices[0]\n\n        if (!choice) continue\n\n        // Emit RUN_STARTED on first chunk\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: 'RUN_STARTED',\n            runId: aguiState.runId,\n            model: chunk.model || options.model,\n            timestamp,\n          }\n        }\n\n        const delta = choice.delta\n        const deltaContent = delta.content\n        const deltaToolCalls = delta.tool_calls\n\n        // Handle content delta\n        if (deltaContent) {\n          // Emit TEXT_MESSAGE_START on first text content\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: 'TEXT_MESSAGE_START',\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp,\n              role: 'assistant',\n            }\n          }\n\n          accumulatedContent += deltaContent\n\n          // Emit AG-UI TEXT_MESSAGE_CONTENT\n          yield {\n            type: 'TEXT_MESSAGE_CONTENT',\n            messageId: aguiState.messageId,\n            model: chunk.model || options.model,\n            timestamp,\n            delta: deltaContent,\n            content: accumulatedContent,\n          }\n        }\n\n        // Handle tool calls - they come in as deltas\n        if (deltaToolCalls) {\n          for (const toolCallDelta of deltaToolCalls) {\n            const index = toolCallDelta.index\n\n            // Initialize or update the tool call in progress\n            if (!toolCallsInProgress.has(index)) {\n              toolCallsInProgress.set(index, {\n                id: toolCallDelta.id || '',\n                name: toolCallDelta.function?.name || '',\n                arguments: '',\n                started: false,\n              })\n            }\n\n            const toolCall = toolCallsInProgress.get(index)!\n\n            // Update with any new data from the delta\n            if (toolCallDelta.id) {\n              toolCall.id = toolCallDelta.id\n            }\n            if (toolCallDelta.function?.name) {\n              toolCall.name = toolCallDelta.function.name\n            }\n            if (toolCallDelta.function?.arguments) {\n              toolCall.arguments += toolCallDelta.function.arguments\n            }\n\n            // Emit TOOL_CALL_START when we have id and name\n            if (toolCall.id && toolCall.name && !toolCall.started) {\n              toolCall.started = true\n              yield {\n                type: 'TOOL_CALL_START',\n                toolCallId: toolCall.id,\n                toolName: toolCall.name,\n                model: chunk.model || options.model,\n                timestamp,\n                index,\n              }\n            }\n\n            // Emit TOOL_CALL_ARGS for argument deltas\n            if (toolCallDelta.function?.arguments && toolCall.started) {\n              yield {\n                type: 'TOOL_CALL_ARGS',\n                toolCallId: toolCall.id,\n                model: chunk.model || options.model,\n                timestamp,\n                delta: toolCallDelta.function.arguments,\n              }\n            }\n          }\n        }\n\n        // Handle finish reason\n        if (choice.finish_reason) {\n          // Emit all completed tool calls\n          if (\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n          ) {\n            for (const [, toolCall] of toolCallsInProgress) {\n              // Parse arguments for TOOL_CALL_END\n              let parsedInput: unknown = {}\n              try {\n                parsedInput = toolCall.arguments\n                  ? JSON.parse(toolCall.arguments)\n                  : {}\n              } catch {\n                parsedInput = {}\n              }\n\n              // Emit AG-UI TOOL_CALL_END\n              yield {\n                type: 'TOOL_CALL_END',\n                toolCallId: toolCall.id,\n                toolName: toolCall.name,\n                model: chunk.model || options.model,\n                timestamp,\n                input: parsedInput,\n              }\n            }\n          }\n\n          const computedFinishReason =\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n              ? 'tool_calls'\n              : 'stop'\n\n          // Emit TEXT_MESSAGE_END if we had text content\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: 'TEXT_MESSAGE_END',\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp,\n            }\n          }\n\n          // Emit AG-UI RUN_FINISHED\n          yield {\n            type: 'RUN_FINISHED',\n            runId: aguiState.runId,\n            model: chunk.model || options.model,\n            timestamp,\n            usage: chunk.usage\n              ? {\n                  promptTokens: chunk.usage.prompt_tokens || 0,\n                  completionTokens: chunk.usage.completion_tokens || 0,\n                  totalTokens: chunk.usage.total_tokens || 0,\n                }\n              : undefined,\n            finishReason: computedFinishReason,\n          }\n        }\n      }\n    } catch (error: unknown) {\n      const err = error as Error & { code?: string }\n      console.error(`[${this.name}] Stream ended with error:`, err.message)\n\n      // Emit AG-UI RUN_ERROR\n      yield {\n        type: 'RUN_ERROR',\n        runId: aguiState.runId,\n        model: options.model,\n        timestamp,\n        error: {\n          message: err.message || 'Unknown error occurred',\n          code: err.code,\n        },\n      }\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Chat Completions API request format.\n   * Override this in subclasses to add provider-specific options.\n   */\n  protected mapOptionsToRequest(\n    options: TextOptions,\n  ): OpenAI_SDK.Chat.Completions.ChatCompletionCreateParamsStreaming {\n    const tools = options.tools\n      ? convertToolsToChatCompletionsFormat(\n          options.tools,\n          this.makeStructuredOutputCompatible.bind(this),\n        )\n      : undefined\n\n    // Build messages array with system prompts\n    const messages: Array<OpenAI_SDK.Chat.Completions.ChatCompletionMessageParam> =\n      []\n\n    // Add system prompts first\n    if (options.systemPrompts && options.systemPrompts.length > 0) {\n      messages.push({\n        role: 'system',\n        content: options.systemPrompts.join('\\n'),\n      })\n    }\n\n    // Convert messages\n    for (const message of options.messages) {\n      messages.push(this.convertMessage(message))\n    }\n\n    const modelOptions = options.modelOptions\n\n    return {\n      ...modelOptions,\n      model: options.model,\n      messages,\n      temperature: options.temperature,\n      max_tokens: options.maxTokens,\n      top_p: options.topP,\n      tools: tools as Array<OpenAI_SDK.Chat.Completions.ChatCompletionTool>,\n      stream: true,\n    }\n  }\n\n  /**\n   * Converts a single ModelMessage to the Chat Completions API message format.\n   * Override this in subclasses to handle provider-specific message formats.\n   */\n  protected convertMessage(\n    message: ModelMessage,\n  ): OpenAI_SDK.Chat.Completions.ChatCompletionMessageParam {\n    // Handle tool messages\n    if (message.role === 'tool') {\n      return {\n        role: 'tool',\n        tool_call_id: message.toolCallId || '',\n        content:\n          typeof message.content === 'string'\n            ? message.content\n            : JSON.stringify(message.content),\n      }\n    }\n\n    // Handle assistant messages\n    if (message.role === 'assistant') {\n      const toolCalls = message.toolCalls?.map((tc) => ({\n        id: tc.id,\n        type: 'function' as const,\n        function: {\n          name: tc.function.name,\n          arguments:\n            typeof tc.function.arguments === 'string'\n              ? tc.function.arguments\n              : JSON.stringify(tc.function.arguments),\n        },\n      }))\n\n      return {\n        role: 'assistant',\n        content: this.extractTextContent(message.content),\n        ...(toolCalls && toolCalls.length > 0 ? { tool_calls: toolCalls } : {}),\n      }\n    }\n\n    // Handle user messages - support multimodal content\n    const contentParts = this.normalizeContent(message.content)\n\n    // If only text, use simple string format\n    if (contentParts.length === 1 && contentParts[0]?.type === 'text') {\n      return {\n        role: 'user',\n        content: contentParts[0].content,\n      }\n    }\n\n    // Otherwise, use array format for multimodal\n    const parts: Array<OpenAI_SDK.Chat.Completions.ChatCompletionContentPart> =\n      []\n    for (const part of contentParts) {\n      const converted = this.convertContentPart(part)\n      if (converted) {\n        parts.push(converted)\n      }\n    }\n\n    return {\n      role: 'user',\n      content: parts.length > 0 ? parts : '',\n    }\n  }\n\n  /**\n   * Converts a single ContentPart to the Chat Completions API content part format.\n   * Override this in subclasses to handle additional content types or provider-specific metadata.\n   */\n  protected convertContentPart(\n    part: ContentPart,\n  ): OpenAI_SDK.Chat.Completions.ChatCompletionContentPart | null {\n    if (part.type === 'text') {\n      return { type: 'text', text: part.content }\n    }\n\n    if (part.type === 'image') {\n      const imageMetadata = part.metadata as\n        | { detail?: 'auto' | 'low' | 'high' }\n        | undefined\n\n      // For base64 data, construct a data URI using the mimeType from source\n      const imageValue = part.source.value\n      const imageUrl =\n        part.source.type === 'data' && !imageValue.startsWith('data:')\n          ? `data:${part.source.mimeType};base64,${imageValue}`\n          : imageValue\n\n      return {\n        type: 'image_url',\n        image_url: {\n          url: imageUrl,\n          detail: imageMetadata?.detail || 'auto',\n        },\n      }\n    }\n\n    // Unsupported content type — subclasses can override to handle more types\n    return null\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  protected normalizeContent(\n    content: string | null | Array<ContentPart>,\n  ): Array<ContentPart> {\n    if (content === null) {\n      return []\n    }\n    if (typeof content === 'string') {\n      return [{ type: 'text', content: content }]\n    }\n    return content\n  }\n\n  /**\n   * Extracts text content from a content value that may be string, null, or ContentPart array.\n   */\n  protected extractTextContent(\n    content: string | null | Array<ContentPart>,\n  ): string {\n    if (content === null) {\n      return ''\n    }\n    if (typeof content === 'string') {\n      return content\n    }\n    // It's an array of ContentPart\n    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/adapters/chat-completions-tool-converter.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from '@tanstack/ai';
+import { default as OpenAI } from 'openai';
+/**
+ * Chat Completions API tool format.
+ * This is distinct from the Responses API tool format.
+ */
+export type ChatCompletionFunctionTool = OpenAI.Chat.Completions.ChatCompletionTool;
+/**
+ * Converts a standard Tool to OpenAI Chat Completions ChatCompletionTool format.
+ *
+ * Tool schemas are already converted to JSON Schema in the ai layer.
+ * We apply OpenAI-compatible transformations for strict mode:
+ * - All properties in required array
+ * - Optional fields made nullable
+ * - additionalProperties: false
+ *
+ * This enables strict mode for all tools automatically.
+ */
+export declare function convertFunctionToolToChatCompletionsFormat(tool: Tool, schemaConverter?: (schema: Record<string, any>, required: Array<string>) => Record<string, any>): ChatCompletionFunctionTool;
+/**
+ * Converts an array of standard Tools to Chat Completions format.
+ * Chat Completions API primarily supports function tools.
+ */
+export declare function convertToolsToChatCompletionsFormat(tools: Array<Tool>, schemaConverter?: (schema: Record<string, any>, required: Array<string>) => Record<string, any>): Array<ChatCompletionFunctionTool>;

package/dist/esm/adapters/chat-completions-tool-converter.js

@@ -0,0 +1,29 @@
+import { makeStructuredOutputCompatible } from "../utils/schema-converter.js";
+function convertFunctionToolToChatCompletionsFormat(tool, schemaConverter = makeStructuredOutputCompatible) {
+  const inputSchema = tool.inputSchema ?? {
+    type: "object",
+    properties: {},
+    required: []
+  };
+  const jsonSchema = schemaConverter(inputSchema, inputSchema.required || []);
+  jsonSchema.additionalProperties = false;
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: jsonSchema,
+      strict: true
+    }
+  };
+}
+function convertToolsToChatCompletionsFormat(tools, schemaConverter) {
+  return tools.map(
+    (tool) => convertFunctionToolToChatCompletionsFormat(tool, schemaConverter)
+  );
+}
+export {
+  convertFunctionToolToChatCompletionsFormat,
+  convertToolsToChatCompletionsFormat
+};
+//# sourceMappingURL=chat-completions-tool-converter.js.map

package/dist/esm/adapters/chat-completions-tool-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-completions-tool-converter.js","sources":["../../../src/adapters/chat-completions-tool-converter.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport type { JSONSchema, Tool } from '@tanstack/ai'\nimport type OpenAI from 'openai'\n\n/**\n * Chat Completions API tool format.\n * This is distinct from the Responses API tool format.\n */\nexport type ChatCompletionFunctionTool =\n  OpenAI.Chat.Completions.ChatCompletionTool\n\n/**\n * Converts a standard Tool to OpenAI Chat Completions ChatCompletionTool format.\n *\n * Tool schemas are already converted to JSON Schema in the ai layer.\n * We apply OpenAI-compatible transformations for strict mode:\n * - All properties in required array\n * - Optional fields made nullable\n * - additionalProperties: false\n *\n * This enables strict mode for all tools automatically.\n */\nexport function convertFunctionToolToChatCompletionsFormat(\n  tool: Tool,\n  schemaConverter: (\n    schema: Record<string, any>,\n    required: Array<string>,\n  ) => Record<string, any> = makeStructuredOutputCompatible,\n): ChatCompletionFunctionTool {\n  const inputSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  const jsonSchema = schemaConverter(inputSchema, inputSchema.required || [])\n\n  // Ensure additionalProperties is false for strict mode\n  jsonSchema.additionalProperties = false\n\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: jsonSchema,\n      strict: true,\n    },\n  } satisfies ChatCompletionFunctionTool\n}\n\n/**\n * Converts an array of standard Tools to Chat Completions format.\n * Chat Completions API primarily supports function tools.\n */\nexport function convertToolsToChatCompletionsFormat(\n  tools: Array<Tool>,\n  schemaConverter?: (\n    schema: Record<string, any>,\n    required: Array<string>,\n  ) => Record<string, any>,\n): Array<ChatCompletionFunctionTool> {\n  return tools.map((tool) =>\n    convertFunctionToolToChatCompletionsFormat(tool, schemaConverter),\n  )\n}\n"],"names":[],"mappings":";AAsBO,SAAS,2CACd,MACA,kBAG2B,gCACC;AAC5B,QAAM,cAAe,KAAK,eAAe;AAAA,IACvC,MAAM;AAAA,IACN,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,aAAa,gBAAgB,aAAa,YAAY,YAAY,CAAA,CAAE;AAG1E,aAAW,uBAAuB;AAElC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,MAClB,YAAY;AAAA,MACZ,QAAQ;AAAA,IAAA;AAAA,EACV;AAEJ;AAMO,SAAS,oCACd,OACA,iBAImC;AACnC,SAAO,MAAM;AAAA,IAAI,CAAC,SAChB,2CAA2C,MAAM,eAAe;AAAA,EAAA;AAEpE;"}

package/dist/esm/adapters/image.d.ts

@@ -0,0 +1,32 @@
+import { BaseImageAdapter } from '@tanstack/ai/adapters';
+import { ImageGenerationOptions, ImageGenerationResult } from '@tanstack/ai';
+import { default as OpenAI_SDK } from 'openai';
+import { OpenAICompatibleClientConfig } from '../types/config.js';
+/**
+ * OpenAI-Compatible Image Generation Adapter
+ *
+ * A generalized base class for providers that implement OpenAI-compatible image
+ * generation APIs. Providers like OpenAI, Grok, and others can extend this class
+ * and only need to:
+ * - Set `baseURL` in the config
+ * - Lock the generic type parameters to provider-specific types
+ * - Override validation or request building methods for provider-specific constraints
+ *
+ * All methods that validate inputs, build requests, or transform responses are
+ * `protected` so subclasses can override them.
+ */
+export declare class OpenAICompatibleImageAdapter<TModel extends string, TProviderOptions extends object = Record<string, any>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string> = Record<string, string>> extends BaseImageAdapter<TModel, TProviderOptions, TModelProviderOptionsByName, TModelSizeByName> {
+    readonly kind: "image";
+    readonly name: string;
+    protected client: OpenAI_SDK;
+    constructor(config: OpenAICompatibleClientConfig, model: TModel, name?: string);
+    generateImages(options: ImageGenerationOptions<TProviderOptions>): Promise<ImageGenerationResult>;
+    protected buildRequest(options: ImageGenerationOptions<TProviderOptions>): OpenAI_SDK.Images.ImageGenerateParams;
+    protected transformResponse(model: string, response: OpenAI_SDK.Images.ImagesResponse): ImageGenerationResult;
+    protected validatePrompt(options: {
+        prompt: string;
+        model: string;
+    }): void;
+    protected validateImageSize(_model: string, _size: string | undefined): void;
+    protected validateNumberOfImages(_model: string, numberOfImages: number | undefined): void;
+}