@tanstack/ai-groq 0.1.4 → 0.1.6

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

@@ -1,8 +1,11 @@
 import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
-import { GROQ_CHAT_MODELS, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
-import { StreamChunk, TextOptions } from '@tanstack/ai';
+import { GROQ_CHAT_MODELS, GroqChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
+import { Modality, StreamChunk, TextOptions } from '@tanstack/ai';
+import { ExternalTextProviderOptions } from '../text/text-provider-options.js';
 import { GroqMessageMetadataByModality } from '../message-types.js';
 import { GroqClientConfig } from '../utils.js';
+type GroqTextProviderOptions = ExternalTextProviderOptions;
+type ResolveToolCapabilities<TModel extends string> = TModel extends keyof GroqChatModelToolCapabilitiesByName ? NonNullable<GroqChatModelToolCapabilitiesByName[TModel]> : readonly [];
 /**
  * Configuration for Groq text adapter
  */
@@ -18,12 +21,12 @@ export type { ExternalTextProviderOptions as GroqTextProviderOptions } from '../
  * Tree-shakeable adapter for Groq chat/text completion functionality.
  * Uses the Groq SDK which provides an OpenAI-compatible Chat Completions API.
  */
-export declare class GroqTextAdapter<TModel extends (typeof GROQ_CHAT_MODELS)[number]> extends BaseTextAdapter<TModel, ResolveProviderOptions<TModel>, ResolveInputModalities<TModel>, GroqMessageMetadataByModality> {
+export declare class GroqTextAdapter<TModel extends (typeof GROQ_CHAT_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, GroqMessageMetadataByModality, TToolCapabilities> {
     readonly kind: "text";
     readonly name: "groq";
     private client;
     constructor(config: GroqTextConfig, model: TModel);
-    chatStream(options: TextOptions<ResolveProviderOptions<TModel>>): AsyncIterable<StreamChunk>;
+    chatStream(options: TextOptions<GroqTextProviderOptions>): AsyncIterable<StreamChunk>;
     /**
      * Generate structured output using Groq's JSON Schema response format.
      * Uses stream: false to get the complete response in one call.
@@ -36,7 +39,7 @@ export declare class GroqTextAdapter<TModel extends (typeof GROQ_CHAT_MODELS)[nu
      * The outputSchema is already JSON Schema (converted in the ai layer).
      * We apply Groq-specific transformations for structured output compatibility.
      */
-    structuredOutput(options: StructuredOutputOptions<ResolveProviderOptions<TModel>>): Promise<StructuredOutputResult<unknown>>;
+    structuredOutput(options: StructuredOutputOptions<GroqTextProviderOptions>): Promise<StructuredOutputResult<unknown>>;
     /**
      * Processes streaming chunks from the Groq API and yields AG-UI stream events.
      * Handles text content deltas, tool call assembly, and lifecycle events.

package/dist/esm/adapters/text.js

@@ -3,6 +3,7 @@ import { validateTextProviderOptions } from "../text/text-provider-options.js";
 import { makeGroqStructuredOutputCompatible, transformNullsToUndefined } from "../utils/schema-converter.js";
 import { convertToolsToProviderFormat } from "../tools/tool-converter.js";
 import { createGroqClient, generateId, getGroqApiKeyFromEnv } from "../utils/client.js";
+const asChunk = (chunk) => chunk;
 class GroqTextAdapter extends BaseTextAdapter {
   constructor(config, model) {
     super({}, model);
@@ -14,7 +15,8 @@ class GroqTextAdapter extends BaseTextAdapter {
     const requestParams = this.mapTextOptionsToGroq(options);
     const timestamp = Date.now();
     const aguiState = {
-      runId: generateId(this.name),
+      runId: options.runId ?? generateId(this.name),
+      threadId: options.threadId ?? generateId(this.name),
       messageId: generateId(this.name),
       timestamp,
       hasEmittedRunStarted: false
@@ -29,23 +31,26 @@ class GroqTextAdapter extends BaseTextAdapter {
       const err = error;
       if (!aguiState.hasEmittedRunStarted) {
         aguiState.hasEmittedRunStarted = true;
-        yield {
+        yield asChunk({
           type: "RUN_STARTED",
           runId: aguiState.runId,
+          threadId: aguiState.threadId,
           model: options.model,
           timestamp
-        };
+        });
       }
-      yield {
+      yield asChunk({
         type: "RUN_ERROR",
         runId: aguiState.runId,
         model: options.model,
         timestamp,
+        message: err.message || "Unknown error",
+        code: err.code,
         error: {
           message: err.message || "Unknown error",
           code: err.code
         }
-      };
+      });
       console.error(">>> chatStream: Fatal error during response creation <<<");
       console.error(">>> Error message:", err.message);
       console.error(">>> Error stack:", err.stack);
@@ -120,12 +125,13 @@ class GroqTextAdapter extends BaseTextAdapter {
         if (!choice) continue;
         if (!aguiState.hasEmittedRunStarted) {
           aguiState.hasEmittedRunStarted = true;
-          yield {
+          yield asChunk({
             type: "RUN_STARTED",
             runId: aguiState.runId,
+            threadId: aguiState.threadId,
             model: chunk.model || options.model,
             timestamp
-          };
+          });
         }
         const delta = choice.delta;
         const deltaContent = delta.content;
@@ -133,23 +139,23 @@ class GroqTextAdapter extends BaseTextAdapter {
         if (deltaContent) {
           if (!hasEmittedTextMessageStart) {
             hasEmittedTextMessageStart = true;
-            yield {
+            yield asChunk({
               type: "TEXT_MESSAGE_START",
               messageId: aguiState.messageId,
               model: chunk.model || options.model,
               timestamp,
               role: "assistant"
-            };
+            });
           }
           accumulatedContent += deltaContent;
-          yield {
+          yield asChunk({
             type: "TEXT_MESSAGE_CONTENT",
             messageId: aguiState.messageId,
             model: chunk.model || options.model,
             timestamp,
             delta: deltaContent,
             content: accumulatedContent
-          };
+          });
         }
         if (deltaToolCalls) {
           for (const toolCallDelta of deltaToolCalls) {
@@ -174,23 +180,24 @@ class GroqTextAdapter extends BaseTextAdapter {
             }
             if (toolCall.id && toolCall.name && !toolCall.started) {
               toolCall.started = true;
-              yield {
+              yield asChunk({
                 type: "TOOL_CALL_START",
                 toolCallId: toolCall.id,
+                toolCallName: toolCall.name,
                 toolName: toolCall.name,
                 model: chunk.model || options.model,
                 timestamp,
                 index
-              };
+              });
             }
             if (toolCallDelta.function?.arguments && toolCall.started) {
-              yield {
+              yield asChunk({
                 type: "TOOL_CALL_ARGS",
                 toolCallId: toolCall.id,
                 model: chunk.model || options.model,
                 timestamp,
                 delta: toolCallDelta.function.arguments
-              };
+              });
             }
           }
         }
@@ -206,29 +213,31 @@ class GroqTextAdapter extends BaseTextAdapter {
               } catch {
                 parsedInput = {};
               }
-              yield {
+              yield asChunk({
                 type: "TOOL_CALL_END",
                 toolCallId: toolCall.id,
+                toolCallName: toolCall.name,
                 toolName: toolCall.name,
                 model: chunk.model || options.model,
                 timestamp,
                 input: parsedInput
-              };
+              });
             }
           }
           const computedFinishReason = choice.finish_reason === "tool_calls" || toolCallsInProgress.size > 0 ? "tool_calls" : choice.finish_reason === "length" ? "length" : "stop";
           if (hasEmittedTextMessageStart) {
-            yield {
+            yield asChunk({
               type: "TEXT_MESSAGE_END",
               messageId: aguiState.messageId,
               model: chunk.model || options.model,
               timestamp
-            };
+            });
           }
           const groqUsage = chunk.x_groq?.usage;
-          yield {
+          yield asChunk({
             type: "RUN_FINISHED",
             runId: aguiState.runId,
+            threadId: aguiState.threadId,
             model: chunk.model || options.model,
             timestamp,
             usage: groqUsage ? {
@@ -237,22 +246,24 @@ class GroqTextAdapter extends BaseTextAdapter {
               totalTokens: groqUsage.total_tokens || 0
             } : void 0,
             finishReason: computedFinishReason
-          };
+          });
         }
       }
     } catch (error) {
       const err = error;
       console.log("[Groq Adapter] Stream ended with error:", err.message);
-      yield {
+      yield asChunk({
         type: "RUN_ERROR",
         runId: aguiState.runId,
         model: options.model,
         timestamp,
+        message: err.message || "Unknown error occurred",
+        code: err.code,
         error: {
           message: err.message || "Unknown error occurred",
           code: err.code
         }
-      };
+      });
     }
   }
   /**

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  createGroqClient,\n  generateId,\n  getGroqApiKeyFromEnv,\n  makeGroqStructuredOutputCompatible,\n  transformNullsToUndefined,\n} from '../utils'\nimport type {\n  GROQ_CHAT_MODELS,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type GROQ_SDK from 'groq-sdk'\nimport type { ChatCompletionCreateParamsStreaming } from 'groq-sdk/resources/chat/completions'\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  ChatCompletionContentPart,\n  ChatCompletionMessageParam,\n  GroqImageMetadata,\n  GroqMessageMetadataByModality,\n} from '../message-types'\nimport type { GroqClientConfig } from '../utils'\n\n/**\n * Configuration for Groq text adapter\n */\nexport interface GroqTextConfig extends GroqClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GroqTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Groq Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Groq chat/text completion functionality.\n * Uses the Groq SDK which provides an OpenAI-compatible Chat Completions API.\n */\nexport class GroqTextAdapter<\n  TModel extends (typeof GROQ_CHAT_MODELS)[number],\n> extends BaseTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  GroqMessageMetadataByModality\n> {\n  readonly kind = 'text' as const\n  readonly name = 'groq' as const\n\n  private client: GROQ_SDK\n\n  constructor(config: GroqTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGroqClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<ResolveProviderOptions<TModel>>,\n  ): AsyncIterable<StreamChunk> {\n    const requestParams = this.mapTextOptionsToGroq(options)\n    const timestamp = Date.now()\n\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.processGroqStreamChunks(stream, options, aguiState)\n    } catch (error: unknown) {\n      const err = error as Error & { code?: string }\n\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      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 Groq's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * Groq has 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 Groq-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.mapTextOptionsToGroq(chatOptions)\n\n    const jsonSchema = makeGroqStructuredOutputCompatible(\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      const rawText = response.choices[0]?.message.content || ''\n\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      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  /**\n   * Processes streaming chunks from the Groq API and yields AG-UI stream events.\n   * Handles text content deltas, tool call assembly, and lifecycle events.\n   */\n  private async *processGroqStreamChunks(\n    stream: AsyncIterable<GROQ_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    const toolCallsInProgress = new Map<\n      number,\n      {\n        id: string\n        name: string\n        arguments: string\n        started: boolean\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        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        if (deltaContent) {\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          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        if (deltaToolCalls) {\n          for (const toolCallDelta of deltaToolCalls) {\n            const index = toolCallDelta.index\n\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            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            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            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        if (choice.finish_reason) {\n          if (\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n          ) {\n            for (const [, toolCall] of toolCallsInProgress) {\n              if (!toolCall.started || !toolCall.id || !toolCall.name) {\n                continue\n              }\n\n              let parsedInput: unknown = {}\n              try {\n                parsedInput = toolCall.arguments\n                  ? JSON.parse(toolCall.arguments)\n                  : {}\n              } catch {\n                parsedInput = {}\n              }\n\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              : choice.finish_reason === 'length'\n                ? 'length'\n                : 'stop'\n\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          const groqUsage = chunk.x_groq?.usage\n\n          yield {\n            type: 'RUN_FINISHED',\n            runId: aguiState.runId,\n            model: chunk.model || options.model,\n            timestamp,\n            usage: groqUsage\n              ? {\n                  promptTokens: groqUsage.prompt_tokens || 0,\n                  completionTokens: groqUsage.completion_tokens || 0,\n                  totalTokens: groqUsage.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('[Groq Adapter] Stream ended with error:', err.message)\n\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 Groq-specific Chat Completions request parameters.\n   */\n  private mapTextOptionsToGroq(\n    options: TextOptions,\n  ): 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    const messages: Array<ChatCompletionMessageParam> = []\n\n    if (options.systemPrompts && options.systemPrompts.length > 0) {\n      messages.push({\n        role: 'system',\n        content: options.systemPrompts.join('\\n'),\n      })\n    }\n\n    for (const message of options.messages) {\n      messages.push(this.convertMessageToGroq(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,\n      stream: true,\n    }\n  }\n\n  /**\n   * Converts a TanStack AI ModelMessage to a Groq ChatCompletionMessageParam.\n   * Handles tool, assistant, and user messages including multimodal content.\n   */\n  private convertMessageToGroq(\n    message: ModelMessage,\n  ): ChatCompletionMessageParam {\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    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    const contentParts = this.normalizeContent(message.content)\n\n    if (contentParts.length === 1 && contentParts[0]?.type === 'text') {\n      return {\n        role: 'user',\n        content: contentParts[0].content,\n      }\n    }\n\n    const parts: Array<ChatCompletionContentPart> = []\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 GroqImageMetadata | undefined\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    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n\n/**\n * Creates a Groq text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile', 'openai/gpt-oss-120b')\n * @param apiKey - Your Groq API key\n * @param config - Optional additional configuration\n * @returns Configured Groq text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGroqText('llama-3.3-70b-versatile', \"gsk_...\");\n * // adapter has type-safe providerOptions for llama-3.3-70b-versatile\n * ```\n */\nexport function createGroqText<\n  TModel extends (typeof GROQ_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GroqTextConfig, 'apiKey'>,\n): GroqTextAdapter<TModel> {\n  return new GroqTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Groq text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `GROQ_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile', 'openai/gpt-oss-120b')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Groq text adapter instance with resolved types\n * @throws Error if GROQ_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses GROQ_API_KEY from environment\n * const adapter = groqText('llama-3.3-70b-versatile');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function groqText<TModel extends (typeof GROQ_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GroqTextConfig, 'apiKey'>,\n): GroqTextAdapter<TModel> {\n  const apiKey = getGroqApiKeyFromEnv()\n  return createGroqText(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  createGroqClient,\n  generateId,\n  getGroqApiKeyFromEnv,\n  makeGroqStructuredOutputCompatible,\n  transformNullsToUndefined,\n} from '../utils'\nimport type {\n  GROQ_CHAT_MODELS,\n  GroqChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type GROQ_SDK from 'groq-sdk'\nimport type { ChatCompletionCreateParamsStreaming } from 'groq-sdk/resources/chat/completions'\nimport type {\n  ContentPart,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type {\n  ExternalTextProviderOptions,\n  InternalTextProviderOptions,\n} from '../text/text-provider-options'\nimport type {\n  ChatCompletionContentPart,\n  ChatCompletionMessageParam,\n  GroqImageMetadata,\n  GroqMessageMetadataByModality,\n} from '../message-types'\nimport type { GroqClientConfig } from '../utils'\n\ntype GroqTextProviderOptions = ExternalTextProviderOptions\n\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GroqChatModelToolCapabilitiesByName\n    ? NonNullable<GroqChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/** Cast an event object to StreamChunk. Adapters construct events with string\n *  literal types which are structurally compatible with the EventType enum. */\nconst asChunk = (chunk: Record<string, unknown>) =>\n  chunk as unknown as StreamChunk\n\n/**\n * Configuration for Groq text adapter\n */\nexport interface GroqTextConfig extends GroqClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GroqTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Groq Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Groq chat/text completion functionality.\n * Uses the Groq SDK which provides an OpenAI-compatible Chat Completions API.\n */\nexport class GroqTextAdapter<\n  TModel extends (typeof GROQ_CHAT_MODELS)[number],\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GroqMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  readonly name = 'groq' as const\n\n  private client: GROQ_SDK\n\n  constructor(config: GroqTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGroqClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<GroqTextProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const requestParams = this.mapTextOptionsToGroq(options)\n    const timestamp = Date.now()\n\n    const aguiState = {\n      runId: options.runId ?? generateId(this.name),\n      threadId: options.threadId ?? 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.processGroqStreamChunks(stream, options, aguiState)\n    } catch (error: unknown) {\n      const err = error as Error & { code?: string }\n\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield asChunk({\n          type: 'RUN_STARTED',\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp,\n        })\n      }\n\n      yield asChunk({\n        type: 'RUN_ERROR',\n        runId: aguiState.runId,\n        model: options.model,\n        timestamp,\n        message: err.message || 'Unknown error',\n        code: err.code,\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 Groq's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * Groq has 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 Groq-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<GroqTextProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapTextOptionsToGroq(chatOptions)\n\n    const jsonSchema = makeGroqStructuredOutputCompatible(\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      const rawText = response.choices[0]?.message.content || ''\n\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      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  /**\n   * Processes streaming chunks from the Groq API and yields AG-UI stream events.\n   * Handles text content deltas, tool call assembly, and lifecycle events.\n   */\n  private async *processGroqStreamChunks(\n    stream: AsyncIterable<GROQ_SDK.Chat.Completions.ChatCompletionChunk>,\n    options: TextOptions,\n    aguiState: {\n      runId: string\n      threadId: 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    const toolCallsInProgress = new Map<\n      number,\n      {\n        id: string\n        name: string\n        arguments: string\n        started: boolean\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        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield asChunk({\n            type: 'RUN_STARTED',\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\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        if (deltaContent) {\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield asChunk({\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          yield asChunk({\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        if (deltaToolCalls) {\n          for (const toolCallDelta of deltaToolCalls) {\n            const index = toolCallDelta.index\n\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            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            if (toolCall.id && toolCall.name && !toolCall.started) {\n              toolCall.started = true\n              yield asChunk({\n                type: 'TOOL_CALL_START',\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\n                toolName: toolCall.name,\n                model: chunk.model || options.model,\n                timestamp,\n                index,\n              })\n            }\n\n            if (toolCallDelta.function?.arguments && toolCall.started) {\n              yield asChunk({\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        if (choice.finish_reason) {\n          if (\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n          ) {\n            for (const [, toolCall] of toolCallsInProgress) {\n              if (!toolCall.started || !toolCall.id || !toolCall.name) {\n                continue\n              }\n\n              let parsedInput: unknown = {}\n              try {\n                parsedInput = toolCall.arguments\n                  ? JSON.parse(toolCall.arguments)\n                  : {}\n              } catch {\n                parsedInput = {}\n              }\n\n              yield asChunk({\n                type: 'TOOL_CALL_END',\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\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              : choice.finish_reason === 'length'\n                ? 'length'\n                : 'stop'\n\n          if (hasEmittedTextMessageStart) {\n            yield asChunk({\n              type: 'TEXT_MESSAGE_END',\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp,\n            })\n          }\n\n          const groqUsage = chunk.x_groq?.usage\n\n          yield asChunk({\n            type: 'RUN_FINISHED',\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: chunk.model || options.model,\n            timestamp,\n            usage: groqUsage\n              ? {\n                  promptTokens: groqUsage.prompt_tokens || 0,\n                  completionTokens: groqUsage.completion_tokens || 0,\n                  totalTokens: groqUsage.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('[Groq Adapter] Stream ended with error:', err.message)\n\n      yield asChunk({\n        type: 'RUN_ERROR',\n        runId: aguiState.runId,\n        model: options.model,\n        timestamp,\n        message: err.message || 'Unknown error occurred',\n        code: err.code,\n        error: {\n          message: err.message || 'Unknown error occurred',\n          code: err.code,\n        },\n      })\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Groq-specific Chat Completions request parameters.\n   */\n  private mapTextOptionsToGroq(\n    options: TextOptions,\n  ): 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    const messages: Array<ChatCompletionMessageParam> = []\n\n    if (options.systemPrompts && options.systemPrompts.length > 0) {\n      messages.push({\n        role: 'system',\n        content: options.systemPrompts.join('\\n'),\n      })\n    }\n\n    for (const message of options.messages) {\n      messages.push(this.convertMessageToGroq(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,\n      stream: true,\n    }\n  }\n\n  /**\n   * Converts a TanStack AI ModelMessage to a Groq ChatCompletionMessageParam.\n   * Handles tool, assistant, and user messages including multimodal content.\n   */\n  private convertMessageToGroq(\n    message: ModelMessage,\n  ): ChatCompletionMessageParam {\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    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    const contentParts = this.normalizeContent(message.content)\n\n    if (contentParts.length === 1 && contentParts[0]?.type === 'text') {\n      return {\n        role: 'user',\n        content: contentParts[0].content,\n      }\n    }\n\n    const parts: Array<ChatCompletionContentPart> = []\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 GroqImageMetadata | undefined\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    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n\n/**\n * Creates a Groq text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile', 'openai/gpt-oss-120b')\n * @param apiKey - Your Groq API key\n * @param config - Optional additional configuration\n * @returns Configured Groq text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGroqText('llama-3.3-70b-versatile', \"gsk_...\");\n * // adapter has type-safe providerOptions for llama-3.3-70b-versatile\n * ```\n */\nexport function createGroqText<\n  TModel extends (typeof GROQ_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GroqTextConfig, 'apiKey'>,\n): GroqTextAdapter<TModel> {\n  return new GroqTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Groq text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `GROQ_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile', 'openai/gpt-oss-120b')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Groq text adapter instance with resolved types\n * @throws Error if GROQ_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses GROQ_API_KEY from environment\n * const adapter = groqText('llama-3.3-70b-versatile');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function groqText<TModel extends (typeof GROQ_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GroqTextConfig, 'apiKey'>,\n): GroqTextAdapter<TModel> {\n  const apiKey = getGroqApiKeyFromEnv()\n  return createGroqText(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -5,6 +5,6 @@
  * Provides tree-shakeable adapters for Groq's Chat Completions API.
  */
 export { GroqTextAdapter, createGroqText, groqText, type GroqTextConfig, type GroqTextProviderOptions, } from './adapters/text.js';
-export type { GroqChatModelProviderOptionsByName, GroqModelInputModalitiesByName, ResolveProviderOptions, ResolveInputModalities, GroqChatModels, } from './model-meta.js';
+export type { GroqChatModelProviderOptionsByName, GroqChatModelToolCapabilitiesByName, GroqModelInputModalitiesByName, ResolveProviderOptions, ResolveInputModalities, GroqChatModels, } from './model-meta.js';
 export { GROQ_CHAT_MODELS } from './model-meta.js';
 export type { GroqTextMetadata, GroqImageMetadata, GroqAudioMetadata, GroqVideoMetadata, GroqDocumentMetadata, GroqMessageMetadataByModality, } from './message-types.js';

package/dist/esm/model-meta.d.ts

@@ -16,6 +16,7 @@ declare const LLAMA_3_3_70B_VERSATILE: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "tools", "json_object"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_4_MAVERICK_17B_128E_INSTRUCT: {
@@ -35,6 +36,7 @@ declare const LLAMA_4_MAVERICK_17B_128E_INSTRUCT: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "tools", "json_object", "json_schema", "vision"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_4_SCOUT_17B_16E_INSTRUCT: {
@@ -54,6 +56,7 @@ declare const LLAMA_4_SCOUT_17B_16E_INSTRUCT: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "tools", "json_object"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_GUARD_4_12B: {
@@ -73,6 +76,7 @@ declare const LLAMA_GUARD_4_12B: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "json_object", "content_moderation", "vision"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_PROMPT_GUARD_2_86M: {
@@ -92,6 +96,7 @@ declare const LLAMA_PROMPT_GUARD_2_86M: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "content_moderation", "json_object"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_3_1_8B_INSTANT: {
@@ -111,6 +116,7 @@ declare const LLAMA_3_1_8B_INSTANT: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "json_object", "tools"];
+        readonly tools: readonly [];
     };
 };
 declare const LLAMA_PROMPT_GUARD_2_22M: {
@@ -130,6 +136,7 @@ declare const LLAMA_PROMPT_GUARD_2_22M: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "content_moderation"];
+        readonly tools: readonly [];
     };
 };
 declare const GPT_OSS_120B: {
@@ -150,6 +157,7 @@ declare const GPT_OSS_120B: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "json_object", "json_schema", "tools", "browser_search", "code_execution", "reasoning"];
+        readonly tools: readonly [];
     };
 };
 declare const GPT_OSS_SAFEGUARD_20B: {
@@ -170,6 +178,7 @@ declare const GPT_OSS_SAFEGUARD_20B: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "tools", "browser_search", "code_execution", "json_object", "json_schema", "reasoning", "content_moderation"];
+        readonly tools: readonly [];
     };
 };
 declare const GPT_OSS_20B: {
@@ -190,6 +199,7 @@ declare const GPT_OSS_20B: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "browser_search", "code_execution", "json_object", "json_schema", "reasoning", "tools"];
+        readonly tools: readonly [];
     };
 };
 declare const KIMI_K2_INSTRUCT_0905: {
@@ -210,6 +220,7 @@ declare const KIMI_K2_INSTRUCT_0905: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "tools", "json_object", "json_schema"];
+        readonly tools: readonly [];
     };
 };
 declare const QWEN3_32B: {
@@ -229,6 +240,7 @@ declare const QWEN3_32B: {
         readonly output: ["text"];
         readonly endpoints: ["chat"];
         readonly features: ["streaming", "json_object", "tools", "reasoning"];
+        readonly tools: readonly [];
     };
 };
 /**
@@ -262,6 +274,26 @@ export type GroqModelInputModalitiesByName = {
 export type GroqChatModelProviderOptionsByName = {
     [K in (typeof GROQ_CHAT_MODELS)[number]]: GroqTextProviderOptions;
 };
+/**
+ * Type-only map from Groq chat model name to its supported provider tools.
+ * Groq exposes no provider-specific tool factories, so every model gets an
+ * empty tuple. This ensures that passing an Anthropic/OpenAI ProviderTool to
+ * a Groq adapter produces a compile-time type error.
+ */
+export type GroqChatModelToolCapabilitiesByName = {
+    [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.tools;
+    [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.tools;
+    [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.tools;
+    [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.tools;
+    [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.tools;
+    [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.tools;
+    [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.tools;
+    [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.tools;
+    [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.tools;
+    [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.tools;
+    [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.tools;
+    [QWEN3_32B.name]: typeof QWEN3_32B.supports.tools;
+};
 /**
  * Resolves the provider options type for a specific Groq model.
  * Falls back to generic GroqTextProviderOptions for unknown models.

package/dist/esm/model-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["import type { GroqTextProviderOptions } from './text/text-provider-options'\n\n/**\n * Internal metadata structure describing a Groq model's capabilities and pricing.\n */\ninterface ModelMeta<TProviderOptions = unknown> {\n  name: string\n  context_window?: number\n  max_completion_tokens?: number\n  pricing: {\n    input?: { normal: number; cached?: number }\n    output?: { normal: number }\n  }\n  supports: {\n    input: Array<'text' | 'image' | 'audio'>\n    output: Array<'text' | 'audio'>\n    endpoints: Array<'chat' | 'tts' | 'transcription' | 'batch'>\n\n    features: Array<\n      | 'streaming'\n      | 'tools'\n      | 'json_object'\n      | 'browser_search'\n      | 'code_execution'\n      | 'reasoning'\n      | 'content_moderation'\n      | 'json_schema'\n      | 'vision'\n    >\n  }\n  /**\n   * Type-level description of which provider options this model supports.\n   */\n  providerOptions?: TProviderOptions\n}\n\nconst LLAMA_3_3_70B_VERSATILE = {\n  name: 'llama-3.3-70b-versatile',\n  context_window: 131_072,\n  max_completion_tokens: 32_768,\n  pricing: {\n    input: {\n      normal: 0.59,\n    },\n    output: {\n      normal: 0.79,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_4_MAVERICK_17B_128E_INSTRUCT = {\n  name: 'meta-llama/llama-4-maverick-17b-128e-instruct',\n  context_window: 131_072,\n  max_completion_tokens: 8_192,\n  pricing: {\n    input: {\n      normal: 0.2,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object', 'json_schema', 'vision'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_4_SCOUT_17B_16E_INSTRUCT = {\n  name: 'meta-llama/llama-4-scout-17b-16e-instruct',\n  context_window: 131_072,\n  max_completion_tokens: 8_192,\n  pricing: {\n    input: {\n      normal: 0.05,\n    },\n    output: {\n      normal: 0.08,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_GUARD_4_12B = {\n  name: 'meta-llama/llama-guard-4-12b',\n  context_window: 131_072,\n  max_completion_tokens: 1024,\n  pricing: {\n    input: {\n      normal: 0.2,\n    },\n    output: {\n      normal: 0.2,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'content_moderation', 'vision'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_PROMPT_GUARD_2_86M = {\n  name: 'meta-llama/llama-prompt-guard-2-86m',\n  context_window: 512,\n  max_completion_tokens: 512,\n  pricing: {\n    input: {\n      normal: 0.04,\n    },\n    output: {\n      normal: 0.04,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'content_moderation', 'json_object'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_3_1_8B_INSTANT = {\n  name: 'llama-3.1-8b-instant',\n  context_window: 131_072,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: {\n      normal: 0.05,\n    },\n    output: {\n      normal: 0.08,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'tools'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_PROMPT_GUARD_2_22M = {\n  name: 'meta-llama/llama-prompt-guard-2-22m',\n  context_window: 512,\n  max_completion_tokens: 512,\n  pricing: {\n    input: {\n      normal: 0.03,\n    },\n    output: {\n      normal: 0.03,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'content_moderation'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_120B = {\n  name: 'openai/gpt-oss-120b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.15,\n      cached: 0.075,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'json_object',\n      'json_schema',\n      'tools',\n      'browser_search',\n      'code_execution',\n      'reasoning',\n    ],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_SAFEGUARD_20B = {\n  name: 'openai/gpt-oss-safeguard-20b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.075,\n      cached: 0.037,\n    },\n    output: {\n      normal: 0.3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'tools',\n      'browser_search',\n      'code_execution',\n      'json_object',\n      'json_schema',\n      'reasoning',\n      'content_moderation',\n    ],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_20B = {\n  name: 'openai/gpt-oss-20b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.075,\n      cached: 0.037,\n    },\n    output: {\n      normal: 0.3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'browser_search',\n      'code_execution',\n      'json_object',\n      'json_schema',\n      'reasoning',\n      'tools',\n    ],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst KIMI_K2_INSTRUCT_0905 = {\n  name: 'moonshotai/kimi-k2-instruct-0905',\n  context_window: 262_144,\n  max_completion_tokens: 16_384,\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.5,\n    },\n    output: {\n      normal: 3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object', 'json_schema'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst QWEN3_32B = {\n  name: 'qwen/qwen3-32b',\n  context_window: 131_072,\n  max_completion_tokens: 40_960,\n  pricing: {\n    input: {\n      normal: 0.29,\n    },\n    output: {\n      normal: 0.59,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'tools', 'reasoning'],\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\n/**\n * All supported Groq chat model identifiers.\n */\nexport const GROQ_CHAT_MODELS = [\n  LLAMA_3_1_8B_INSTANT.name,\n  LLAMA_3_3_70B_VERSATILE.name,\n  LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name,\n  LLAMA_4_SCOUT_17B_16E_INSTRUCT.name,\n  LLAMA_GUARD_4_12B.name,\n  LLAMA_PROMPT_GUARD_2_86M.name,\n  LLAMA_PROMPT_GUARD_2_22M.name,\n  GPT_OSS_20B.name,\n  GPT_OSS_120B.name,\n  GPT_OSS_SAFEGUARD_20B.name,\n  KIMI_K2_INSTRUCT_0905.name,\n  QWEN3_32B.name,\n] as const\n\n/**\n * Union type of all supported Groq chat model names.\n */\nexport type GroqChatModels = (typeof GROQ_CHAT_MODELS)[number]\n\n/**\n * Type-only map from Groq chat model name to its supported input modalities.\n */\nexport type GroqModelInputModalitiesByName = {\n  [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.input\n  [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.input\n  [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.input\n  [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.input\n  [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.input\n  [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.input\n  [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.input\n  [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.input\n  [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.input\n  [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.input\n  [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.input\n  [QWEN3_32B.name]: typeof QWEN3_32B.supports.input\n}\n\n/**\n * Type-only map from Groq chat model name to its provider options type.\n */\nexport type GroqChatModelProviderOptionsByName = {\n  [K in (typeof GROQ_CHAT_MODELS)[number]]: GroqTextProviderOptions\n}\n\n/**\n * Resolves the provider options type for a specific Groq model.\n * Falls back to generic GroqTextProviderOptions for unknown models.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GroqChatModelProviderOptionsByName\n    ? GroqChatModelProviderOptionsByName[TModel]\n    : GroqTextProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GroqModelInputModalitiesByName\n    ? GroqModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"names":[],"mappings":"AAoCA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAiBR;AAEA,MAAM,qCAAqC;AAAA,EACzC,MAAM;AAiBR;AAEA,MAAM,iCAAiC;AAAA,EACrC,MAAM;AAiBR;AAEA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAiBR;AAEA,MAAM,2BAA2B;AAAA,EAC/B,MAAM;AAiBR;AAEA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAiBR;AAEA,MAAM,2BAA2B;AAAA,EAC/B,MAAM;AAiBR;AAEA,MAAM,eAAe;AAAA,EACnB,MAAM;AA0BR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AA2BR;AAEA,MAAM,cAAc;AAAA,EAClB,MAAM;AA0BR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAkBR;AAEA,MAAM,YAAY;AAAA,EAChB,MAAM;AAiBR;AAKO,MAAM,mBAAmB;AAAA,EAC9B,qBAAqB;AAAA,EACrB,wBAAwB;AAAA,EACxB,mCAAmC;AAAA,EACnC,+BAA+B;AAAA,EAC/B,kBAAkB;AAAA,EAClB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,UAAU;AACZ;"}
+{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["import type { GroqTextProviderOptions } from './text/text-provider-options'\n\n/**\n * Internal metadata structure describing a Groq model's capabilities and pricing.\n */\ninterface ModelMeta<TProviderOptions = unknown> {\n  name: string\n  context_window?: number\n  max_completion_tokens?: number\n  pricing: {\n    input?: { normal: number; cached?: number }\n    output?: { normal: number }\n  }\n  supports: {\n    input: Array<'text' | 'image' | 'audio'>\n    output: Array<'text' | 'audio'>\n    endpoints: Array<'chat' | 'tts' | 'transcription' | 'batch'>\n\n    features: Array<\n      | 'streaming'\n      | 'tools'\n      | 'json_object'\n      | 'browser_search'\n      | 'code_execution'\n      | 'reasoning'\n      | 'content_moderation'\n      | 'json_schema'\n      | 'vision'\n    >\n    tools?: ReadonlyArray<never>\n  }\n  /**\n   * Type-level description of which provider options this model supports.\n   */\n  providerOptions?: TProviderOptions\n}\n\nconst LLAMA_3_3_70B_VERSATILE = {\n  name: 'llama-3.3-70b-versatile',\n  context_window: 131_072,\n  max_completion_tokens: 32_768,\n  pricing: {\n    input: {\n      normal: 0.59,\n    },\n    output: {\n      normal: 0.79,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_4_MAVERICK_17B_128E_INSTRUCT = {\n  name: 'meta-llama/llama-4-maverick-17b-128e-instruct',\n  context_window: 131_072,\n  max_completion_tokens: 8_192,\n  pricing: {\n    input: {\n      normal: 0.2,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object', 'json_schema', 'vision'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_4_SCOUT_17B_16E_INSTRUCT = {\n  name: 'meta-llama/llama-4-scout-17b-16e-instruct',\n  context_window: 131_072,\n  max_completion_tokens: 8_192,\n  pricing: {\n    input: {\n      normal: 0.05,\n    },\n    output: {\n      normal: 0.08,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_GUARD_4_12B = {\n  name: 'meta-llama/llama-guard-4-12b',\n  context_window: 131_072,\n  max_completion_tokens: 1024,\n  pricing: {\n    input: {\n      normal: 0.2,\n    },\n    output: {\n      normal: 0.2,\n    },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'content_moderation', 'vision'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_PROMPT_GUARD_2_86M = {\n  name: 'meta-llama/llama-prompt-guard-2-86m',\n  context_window: 512,\n  max_completion_tokens: 512,\n  pricing: {\n    input: {\n      normal: 0.04,\n    },\n    output: {\n      normal: 0.04,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'content_moderation', 'json_object'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_3_1_8B_INSTANT = {\n  name: 'llama-3.1-8b-instant',\n  context_window: 131_072,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: {\n      normal: 0.05,\n    },\n    output: {\n      normal: 0.08,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'tools'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst LLAMA_PROMPT_GUARD_2_22M = {\n  name: 'meta-llama/llama-prompt-guard-2-22m',\n  context_window: 512,\n  max_completion_tokens: 512,\n  pricing: {\n    input: {\n      normal: 0.03,\n    },\n    output: {\n      normal: 0.03,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'content_moderation'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_120B = {\n  name: 'openai/gpt-oss-120b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.15,\n      cached: 0.075,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'json_object',\n      'json_schema',\n      'tools',\n      'browser_search',\n      'code_execution',\n      'reasoning',\n    ],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_SAFEGUARD_20B = {\n  name: 'openai/gpt-oss-safeguard-20b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.075,\n      cached: 0.037,\n    },\n    output: {\n      normal: 0.3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'tools',\n      'browser_search',\n      'code_execution',\n      'json_object',\n      'json_schema',\n      'reasoning',\n      'content_moderation',\n    ],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst GPT_OSS_20B = {\n  name: 'openai/gpt-oss-20b',\n  context_window: 131_072,\n  max_completion_tokens: 65_536,\n  pricing: {\n    input: {\n      normal: 0.075,\n      cached: 0.037,\n    },\n    output: {\n      normal: 0.3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [\n      'streaming',\n      'browser_search',\n      'code_execution',\n      'json_object',\n      'json_schema',\n      'reasoning',\n      'tools',\n    ],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst KIMI_K2_INSTRUCT_0905 = {\n  name: 'moonshotai/kimi-k2-instruct-0905',\n  context_window: 262_144,\n  max_completion_tokens: 16_384,\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.5,\n    },\n    output: {\n      normal: 3,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'tools', 'json_object', 'json_schema'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\nconst QWEN3_32B = {\n  name: 'qwen/qwen3-32b',\n  context_window: 131_072,\n  max_completion_tokens: 40_960,\n  pricing: {\n    input: {\n      normal: 0.29,\n    },\n    output: {\n      normal: 0.59,\n    },\n  },\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: ['streaming', 'json_object', 'tools', 'reasoning'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta<GroqTextProviderOptions>\n\n/**\n * All supported Groq chat model identifiers.\n */\nexport const GROQ_CHAT_MODELS = [\n  LLAMA_3_1_8B_INSTANT.name,\n  LLAMA_3_3_70B_VERSATILE.name,\n  LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name,\n  LLAMA_4_SCOUT_17B_16E_INSTRUCT.name,\n  LLAMA_GUARD_4_12B.name,\n  LLAMA_PROMPT_GUARD_2_86M.name,\n  LLAMA_PROMPT_GUARD_2_22M.name,\n  GPT_OSS_20B.name,\n  GPT_OSS_120B.name,\n  GPT_OSS_SAFEGUARD_20B.name,\n  KIMI_K2_INSTRUCT_0905.name,\n  QWEN3_32B.name,\n] as const\n\n/**\n * Union type of all supported Groq chat model names.\n */\nexport type GroqChatModels = (typeof GROQ_CHAT_MODELS)[number]\n\n/**\n * Type-only map from Groq chat model name to its supported input modalities.\n */\nexport type GroqModelInputModalitiesByName = {\n  [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.input\n  [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.input\n  [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.input\n  [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.input\n  [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.input\n  [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.input\n  [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.input\n  [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.input\n  [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.input\n  [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.input\n  [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.input\n  [QWEN3_32B.name]: typeof QWEN3_32B.supports.input\n}\n\n/**\n * Type-only map from Groq chat model name to its provider options type.\n */\nexport type GroqChatModelProviderOptionsByName = {\n  [K in (typeof GROQ_CHAT_MODELS)[number]]: GroqTextProviderOptions\n}\n\n/**\n * Type-only map from Groq chat model name to its supported provider tools.\n * Groq exposes no provider-specific tool factories, so every model gets an\n * empty tuple. This ensures that passing an Anthropic/OpenAI ProviderTool to\n * a Groq adapter produces a compile-time type error.\n */\nexport type GroqChatModelToolCapabilitiesByName = {\n  [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.tools\n  [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.tools\n  [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.tools\n  [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.tools\n  [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.tools\n  [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.tools\n  [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.tools\n  [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.tools\n  [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.tools\n  [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.tools\n  [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.tools\n  [QWEN3_32B.name]: typeof QWEN3_32B.supports.tools\n}\n\n/**\n * Resolves the provider options type for a specific Groq model.\n * Falls back to generic GroqTextProviderOptions for unknown models.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GroqChatModelProviderOptionsByName\n    ? GroqChatModelProviderOptionsByName[TModel]\n    : GroqTextProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GroqModelInputModalitiesByName\n    ? GroqModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"names":[],"mappings":"AAqCA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAkBR;AAEA,MAAM,qCAAqC;AAAA,EACzC,MAAM;AAkBR;AAEA,MAAM,iCAAiC;AAAA,EACrC,MAAM;AAkBR;AAEA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAkBR;AAEA,MAAM,2BAA2B;AAAA,EAC/B,MAAM;AAkBR;AAEA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAkBR;AAEA,MAAM,2BAA2B;AAAA,EAC/B,MAAM;AAkBR;AAEA,MAAM,eAAe;AAAA,EACnB,MAAM;AA2BR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AA4BR;AAEA,MAAM,cAAc;AAAA,EAClB,MAAM;AA2BR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAmBR;AAEA,MAAM,YAAY;AAAA,EAChB,MAAM;AAkBR;AAKO,MAAM,mBAAmB;AAAA,EAC9B,qBAAqB;AAAA,EACrB,wBAAwB;AAAA,EACxB,mCAAmC;AAAA,EACnC,+BAA+B;AAAA,EAC/B,kBAAkB;AAAA,EAClB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,UAAU;AACZ;"}

package/dist/esm/tools/index.js

@@ -0,0 +1,7 @@
+import { convertFunctionToolToAdapterFormat } from "./function-tool.js";
+import { convertToolsToProviderFormat } from "./tool-converter.js";
+export {
+  convertFunctionToolToAdapterFormat,
+  convertToolsToProviderFormat
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "Groq adapter for TanStack AI",
   "author": "",
@@ -16,6 +16,10 @@
     ".": {
       "types": "./dist/esm/index.d.ts",
       "import": "./dist/esm/index.js"
+    },
+    "./tools": {
+      "types": "./dist/esm/tools/index.d.ts",
+      "import": "./dist/esm/tools/index.js"
     }
   },
   "files": [
@@ -34,7 +38,7 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.10.0"
+    "@tanstack/ai": "^0.12.0"
   },
   "dependencies": {
     "groq-sdk": "^0.37.0"

package/src/adapters/text.ts

@@ -10,6 +10,7 @@ import {
 } from '../utils'
 import type {
   GROQ_CHAT_MODELS,
+  GroqChatModelToolCapabilitiesByName,
   ResolveInputModalities,
   ResolveProviderOptions,
 } from '../model-meta'
@@ -21,11 +22,15 @@ import type GROQ_SDK from 'groq-sdk'
 import type { ChatCompletionCreateParamsStreaming } from 'groq-sdk/resources/chat/completions'
 import type {
   ContentPart,
+  Modality,
   ModelMessage,
   StreamChunk,
   TextOptions,
 } from '@tanstack/ai'
-import type { InternalTextProviderOptions } from '../text/text-provider-options'
+import type {
+  ExternalTextProviderOptions,
+  InternalTextProviderOptions,
+} from '../text/text-provider-options'
 import type {
   ChatCompletionContentPart,
   ChatCompletionMessageParam,
@@ -34,6 +39,18 @@ import type {
 } from '../message-types'
 import type { GroqClientConfig } from '../utils'
 
+type GroqTextProviderOptions = ExternalTextProviderOptions
+
+type ResolveToolCapabilities<TModel extends string> =
+  TModel extends keyof GroqChatModelToolCapabilitiesByName
+    ? NonNullable<GroqChatModelToolCapabilitiesByName[TModel]>
+    : readonly []
+
+/** Cast an event object to StreamChunk. Adapters construct events with string
+ *  literal types which are structurally compatible with the EventType enum. */
+const asChunk = (chunk: Record<string, unknown>) =>
+  chunk as unknown as StreamChunk
+
 /**
  * Configuration for Groq text adapter
  */
@@ -52,11 +69,17 @@ export type { ExternalTextProviderOptions as GroqTextProviderOptions } from '../
  */
 export class GroqTextAdapter<
   TModel extends (typeof GROQ_CHAT_MODELS)[number],
+  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,
+  TInputModalities extends ReadonlyArray<Modality> =
+    ResolveInputModalities<TModel>,
+  TToolCapabilities extends ReadonlyArray<string> =
+    ResolveToolCapabilities<TModel>,
 > extends BaseTextAdapter<
   TModel,
-  ResolveProviderOptions<TModel>,
-  ResolveInputModalities<TModel>,
-  GroqMessageMetadataByModality
+  TProviderOptions,
+  TInputModalities,
+  GroqMessageMetadataByModality,
+  TToolCapabilities
 > {
   readonly kind = 'text' as const
   readonly name = 'groq' as const
@@ -69,13 +92,14 @@ export class GroqTextAdapter<
   }
 
   async *chatStream(
-    options: TextOptions<ResolveProviderOptions<TModel>>,
+    options: TextOptions<GroqTextProviderOptions>,
   ): AsyncIterable<StreamChunk> {
     const requestParams = this.mapTextOptionsToGroq(options)
     const timestamp = Date.now()
 
     const aguiState = {
-      runId: generateId(this.name),
+      runId: options.runId ?? generateId(this.name),
+      threadId: options.threadId ?? generateId(this.name),
       messageId: generateId(this.name),
       timestamp,
       hasEmittedRunStarted: false,
@@ -93,24 +117,27 @@ export class GroqTextAdapter<
 
       if (!aguiState.hasEmittedRunStarted) {
         aguiState.hasEmittedRunStarted = true
-        yield {
+        yield asChunk({
           type: 'RUN_STARTED',
           runId: aguiState.runId,
+          threadId: aguiState.threadId,
           model: options.model,
           timestamp,
-        }
+        })
       }
 
-      yield {
+      yield asChunk({
         type: 'RUN_ERROR',
         runId: aguiState.runId,
         model: options.model,
         timestamp,
+        message: err.message || 'Unknown error',
+        code: err.code,
         error: {
           message: err.message || 'Unknown error',
           code: err.code,
         },
-      }
+      })
 
       console.error('>>> chatStream: Fatal error during response creation <<<')
       console.error('>>> Error message:', err.message)
@@ -132,7 +159,7 @@ export class GroqTextAdapter<
    * We apply Groq-specific transformations for structured output compatibility.
    */
   async structuredOutput(
-    options: StructuredOutputOptions<ResolveProviderOptions<TModel>>,
+    options: StructuredOutputOptions<GroqTextProviderOptions>,
   ): Promise<StructuredOutputResult<unknown>> {
     const { chatOptions, outputSchema } = options
     const requestParams = this.mapTextOptionsToGroq(chatOptions)
@@ -190,6 +217,7 @@ export class GroqTextAdapter<
     options: TextOptions,
     aguiState: {
       runId: string
+      threadId: string
       messageId: string
       timestamp: number
       hasEmittedRunStarted: boolean
@@ -217,12 +245,13 @@ export class GroqTextAdapter<
 
         if (!aguiState.hasEmittedRunStarted) {
           aguiState.hasEmittedRunStarted = true
-          yield {
+          yield asChunk({
             type: 'RUN_STARTED',
             runId: aguiState.runId,
+            threadId: aguiState.threadId,
             model: chunk.model || options.model,
             timestamp,
-          }
+          })
         }
 
         const delta = choice.delta
@@ -232,25 +261,25 @@ export class GroqTextAdapter<
         if (deltaContent) {
           if (!hasEmittedTextMessageStart) {
             hasEmittedTextMessageStart = true
-            yield {
+            yield asChunk({
               type: 'TEXT_MESSAGE_START',
               messageId: aguiState.messageId,
               model: chunk.model || options.model,
               timestamp,
               role: 'assistant',
-            }
+            })
           }
 
           accumulatedContent += deltaContent
 
-          yield {
+          yield asChunk({
             type: 'TEXT_MESSAGE_CONTENT',
             messageId: aguiState.messageId,
             model: chunk.model || options.model,
             timestamp,
             delta: deltaContent,
             content: accumulatedContent,
-          }
+          })
         }
 
         if (deltaToolCalls) {
@@ -280,24 +309,25 @@ export class GroqTextAdapter<
 
             if (toolCall.id && toolCall.name && !toolCall.started) {
               toolCall.started = true
-              yield {
+              yield asChunk({
                 type: 'TOOL_CALL_START',
                 toolCallId: toolCall.id,
+                toolCallName: toolCall.name,
                 toolName: toolCall.name,
                 model: chunk.model || options.model,
                 timestamp,
                 index,
-              }
+              })
             }
 
             if (toolCallDelta.function?.arguments && toolCall.started) {
-              yield {
+              yield asChunk({
                 type: 'TOOL_CALL_ARGS',
                 toolCallId: toolCall.id,
                 model: chunk.model || options.model,
                 timestamp,
                 delta: toolCallDelta.function.arguments,
-              }
+              })
             }
           }
         }
@@ -321,14 +351,15 @@ export class GroqTextAdapter<
                 parsedInput = {}
               }
 
-              yield {
+              yield asChunk({
                 type: 'TOOL_CALL_END',
                 toolCallId: toolCall.id,
+                toolCallName: toolCall.name,
                 toolName: toolCall.name,
                 model: chunk.model || options.model,
                 timestamp,
                 input: parsedInput,
-              }
+              })
             }
           }
 
@@ -341,19 +372,20 @@ export class GroqTextAdapter<
                 : 'stop'
 
           if (hasEmittedTextMessageStart) {
-            yield {
+            yield asChunk({
               type: 'TEXT_MESSAGE_END',
               messageId: aguiState.messageId,
               model: chunk.model || options.model,
               timestamp,
-            }
+            })
           }
 
           const groqUsage = chunk.x_groq?.usage
 
-          yield {
+          yield asChunk({
             type: 'RUN_FINISHED',
             runId: aguiState.runId,
+            threadId: aguiState.threadId,
             model: chunk.model || options.model,
             timestamp,
             usage: groqUsage
@@ -364,23 +396,25 @@ export class GroqTextAdapter<
                 }
               : undefined,
             finishReason: computedFinishReason,
-          }
+          })
         }
       }
     } catch (error: unknown) {
       const err = error as Error & { code?: string }
       console.log('[Groq Adapter] Stream ended with error:', err.message)
 
-      yield {
+      yield asChunk({
         type: 'RUN_ERROR',
         runId: aguiState.runId,
         model: options.model,
         timestamp,
+        message: err.message || 'Unknown error occurred',
+        code: err.code,
         error: {
           message: err.message || 'Unknown error occurred',
           code: err.code,
         },
-      }
+      })
     }
   }
 

package/src/index.ts

@@ -17,6 +17,7 @@ export {
 // Types
 export type {
   GroqChatModelProviderOptionsByName,
+  GroqChatModelToolCapabilitiesByName,
   GroqModelInputModalitiesByName,
   ResolveProviderOptions,
   ResolveInputModalities,

package/src/model-meta.ts

@@ -27,6 +27,7 @@ interface ModelMeta<TProviderOptions = unknown> {
       | 'json_schema'
       | 'vision'
     >
+    tools?: ReadonlyArray<never>
   }
   /**
    * Type-level description of which provider options this model supports.
@@ -51,6 +52,7 @@ const LLAMA_3_3_70B_VERSATILE = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'tools', 'json_object'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -71,6 +73,7 @@ const LLAMA_4_MAVERICK_17B_128E_INSTRUCT = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'tools', 'json_object', 'json_schema', 'vision'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -91,6 +94,7 @@ const LLAMA_4_SCOUT_17B_16E_INSTRUCT = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'tools', 'json_object'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -111,6 +115,7 @@ const LLAMA_GUARD_4_12B = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'json_object', 'content_moderation', 'vision'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -131,6 +136,7 @@ const LLAMA_PROMPT_GUARD_2_86M = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'content_moderation', 'json_object'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -151,6 +157,7 @@ const LLAMA_3_1_8B_INSTANT = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'json_object', 'tools'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -171,6 +178,7 @@ const LLAMA_PROMPT_GUARD_2_22M = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'content_moderation'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -200,6 +208,7 @@ const GPT_OSS_120B = {
       'code_execution',
       'reasoning',
     ],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -230,6 +239,7 @@ const GPT_OSS_SAFEGUARD_20B = {
       'reasoning',
       'content_moderation',
     ],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -259,6 +269,7 @@ const GPT_OSS_20B = {
       'reasoning',
       'tools',
     ],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -280,6 +291,7 @@ const KIMI_K2_INSTRUCT_0905 = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'tools', 'json_object', 'json_schema'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -300,6 +312,7 @@ const QWEN3_32B = {
     output: ['text'],
     endpoints: ['chat'],
     features: ['streaming', 'json_object', 'tools', 'reasoning'],
+    tools: [] as const,
   },
 } as const satisfies ModelMeta<GroqTextProviderOptions>
 
@@ -351,6 +364,27 @@ export type GroqChatModelProviderOptionsByName = {
   [K in (typeof GROQ_CHAT_MODELS)[number]]: GroqTextProviderOptions
 }
 
+/**
+ * Type-only map from Groq chat model name to its supported provider tools.
+ * Groq exposes no provider-specific tool factories, so every model gets an
+ * empty tuple. This ensures that passing an Anthropic/OpenAI ProviderTool to
+ * a Groq adapter produces a compile-time type error.
+ */
+export type GroqChatModelToolCapabilitiesByName = {
+  [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.tools
+  [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.tools
+  [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.tools
+  [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.tools
+  [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.tools
+  [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.tools
+  [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.tools
+  [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.tools
+  [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.tools
+  [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.tools
+  [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.tools
+  [QWEN3_32B.name]: typeof QWEN3_32B.supports.tools
+}
+
 /**
  * Resolves the provider options type for a specific Groq model.
  * Falls back to generic GroqTextProviderOptions for unknown models.