@tanstack/ai-grok 0.3.0 → 0.4.0

package/dist/esm/adapters/text.js

@@ -316,10 +316,12 @@ class GrokTextAdapter extends BaseTextAdapter {
         parts.push({ type: "text", text: part.content });
       } else 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;
         parts.push({
           type: "image_url",
           image_url: {
-            url: part.source.value,
+            url: imageUrl,
             detail: imageMetadata?.detail || "auto"
           }
         });

package/dist/esm/adapters/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport { validateTextProviderOptions } from '../text/text-provider-options'\nimport { convertToolsToProviderFormat } from '../tools'\nimport {\n  createGrokClient,\n  generateId,\n  getGrokApiKeyFromEnv,\n  makeGrokStructuredOutputCompatible,\n  transformNullsToUndefined,\n} from '../utils'\nimport type {\n  GROK_CHAT_MODELS,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type OpenAI_SDK from 'openai'\nimport type {\n  ContentPart,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { InternalTextProviderOptions } from '../text/text-provider-options'\nimport type {\n  GrokImageMetadata,\n  GrokMessageMetadataByModality,\n} from '../message-types'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses OpenAI-compatible Chat Completions API (not Responses API).\n */\nexport class GrokTextAdapter<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n> extends BaseTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  GrokMessageMetadataByModality\n> {\n  readonly kind = 'text' as const\n  readonly name = 'grok' as const\n\n  private client: OpenAI_SDK\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGrokClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<ResolveProviderOptions<TModel>>,\n  ): AsyncIterable<StreamChunk> {\n    const requestParams = this.mapTextOptionsToGrok(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        ...requestParams,\n        stream: true,\n      })\n\n      yield* this.processGrokStreamChunks(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('>>> chatStream: Fatal error during response creation <<<')\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 Grok's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * Grok has strict requirements for structured output (via OpenAI-compatible API):\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 Grok-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<ResolveProviderOptions<TModel>>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapTextOptionsToGrok(chatOptions)\n\n    // Apply Grok-specific transformations for structured output compatibility\n    const jsonSchema = makeGrokStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required || [],\n    )\n\n    try {\n      const response = await this.client.chat.completions.create({\n        ...requestParams,\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      // 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      // Grok 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('>>> structuredOutput: Error during response creation <<<')\n      console.error('>>> Error message:', err.message)\n      throw error\n    }\n  }\n\n  private async *processGrokStreamChunks(\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.log('[Grok Adapter] 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 options to Grok-specific Chat Completions format\n   */\n  private mapTextOptionsToGrok(\n    options: TextOptions,\n  ): OpenAI_SDK.Chat.Completions.ChatCompletionCreateParamsStreaming {\n    const modelOptions = options.modelOptions as\n      | Omit<\n          InternalTextProviderOptions,\n          'max_tokens' | 'tools' | 'temperature' | 'input' | 'top_p'\n        >\n      | undefined\n\n    if (modelOptions) {\n      validateTextProviderOptions({\n        ...modelOptions,\n        model: options.model,\n      })\n    }\n\n    const tools = options.tools\n      ? convertToolsToProviderFormat(options.tools)\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.convertMessageToGrok(message))\n    }\n\n    return {\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      stream_options: { include_usage: true },\n    }\n  }\n\n  private convertMessageToGrok(\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      if (part.type === 'text') {\n        parts.push({ type: 'text', text: part.content })\n      } else if (part.type === 'image') {\n        const imageMetadata = part.metadata as GrokImageMetadata | undefined\n        parts.push({\n          type: 'image_url',\n          image_url: {\n            url: part.source.value,\n            detail: imageMetadata?.detail || 'auto',\n          },\n        })\n      }\n    }\n\n    return {\n      role: 'user',\n      content: parts.length > 0 ? parts : '',\n    }\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  private 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  private 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\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-3', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-3\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-3');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport { validateTextProviderOptions } from '../text/text-provider-options'\nimport { convertToolsToProviderFormat } from '../tools'\nimport {\n  createGrokClient,\n  generateId,\n  getGrokApiKeyFromEnv,\n  makeGrokStructuredOutputCompatible,\n  transformNullsToUndefined,\n} from '../utils'\nimport type {\n  GROK_CHAT_MODELS,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type OpenAI_SDK from 'openai'\nimport type {\n  ContentPart,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { InternalTextProviderOptions } from '../text/text-provider-options'\nimport type {\n  GrokImageMetadata,\n  GrokMessageMetadataByModality,\n} from '../message-types'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses OpenAI-compatible Chat Completions API (not Responses API).\n */\nexport class GrokTextAdapter<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n> extends BaseTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  GrokMessageMetadataByModality\n> {\n  readonly kind = 'text' as const\n  readonly name = 'grok' as const\n\n  private client: OpenAI_SDK\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGrokClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<ResolveProviderOptions<TModel>>,\n  ): AsyncIterable<StreamChunk> {\n    const requestParams = this.mapTextOptionsToGrok(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        ...requestParams,\n        stream: true,\n      })\n\n      yield* this.processGrokStreamChunks(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('>>> chatStream: Fatal error during response creation <<<')\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 Grok's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * Grok has strict requirements for structured output (via OpenAI-compatible API):\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 Grok-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<ResolveProviderOptions<TModel>>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapTextOptionsToGrok(chatOptions)\n\n    // Apply Grok-specific transformations for structured output compatibility\n    const jsonSchema = makeGrokStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required || [],\n    )\n\n    try {\n      const response = await this.client.chat.completions.create({\n        ...requestParams,\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      // 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      // Grok 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('>>> structuredOutput: Error during response creation <<<')\n      console.error('>>> Error message:', err.message)\n      throw error\n    }\n  }\n\n  private async *processGrokStreamChunks(\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.log('[Grok Adapter] 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 options to Grok-specific Chat Completions format\n   */\n  private mapTextOptionsToGrok(\n    options: TextOptions,\n  ): OpenAI_SDK.Chat.Completions.ChatCompletionCreateParamsStreaming {\n    const modelOptions = options.modelOptions as\n      | Omit<\n          InternalTextProviderOptions,\n          'max_tokens' | 'tools' | 'temperature' | 'input' | 'top_p'\n        >\n      | undefined\n\n    if (modelOptions) {\n      validateTextProviderOptions({\n        ...modelOptions,\n        model: options.model,\n      })\n    }\n\n    const tools = options.tools\n      ? convertToolsToProviderFormat(options.tools)\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.convertMessageToGrok(message))\n    }\n\n    return {\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      stream_options: { include_usage: true },\n    }\n  }\n\n  private convertMessageToGrok(\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      if (part.type === 'text') {\n        parts.push({ type: 'text', text: part.content })\n      } else if (part.type === 'image') {\n        const imageMetadata = part.metadata as GrokImageMetadata | undefined\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        parts.push({\n          type: 'image_url',\n          image_url: {\n            url: imageUrl,\n            detail: imageMetadata?.detail || 'auto',\n          },\n        })\n      }\n    }\n\n    return {\n      role: 'user',\n      content: parts.length > 0 ? parts : '',\n    }\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  private 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  private 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\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-3', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-3\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-3');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Grok (xAI) adapter for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -38,7 +38,7 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.3.0"
+    "@tanstack/ai": "^0.4.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/text.ts

@@ -502,10 +502,16 @@ export class GrokTextAdapter<
         parts.push({ type: 'text', text: part.content })
       } else if (part.type === 'image') {
         const imageMetadata = part.metadata as GrokImageMetadata | undefined
+        // For base64 data, construct a data URI using the mimeType from source
+        const imageValue = part.source.value
+        const imageUrl =
+          part.source.type === 'data' && !imageValue.startsWith('data:')
+            ? `data:${part.source.mimeType};base64,${imageValue}`
+            : imageValue
         parts.push({
           type: 'image_url',
           image_url: {
-            url: part.source.value,
+            url: imageUrl,
             detail: imageMetadata?.detail || 'auto',
           },
         })