@tanstack/ai-groq 0.4.11 → 0.4.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -53,12 +53,12 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.35.0"
+    "@tanstack/ai": "^0.36.0"
   },
   "dependencies": {
     "openai": "^6.41.0",
     "@tanstack/ai-utils": "0.3.0",
-    "@tanstack/openai-base": "0.9.1"
+    "@tanstack/openai-base": "0.9.3"
   },
   "scripts": {
     "build": "vite build",

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

@@ -1,77 +0,0 @@
-import { default as OpenAI } from 'openai';
-import { OpenAIBaseChatCompletionsTextAdapter } from '@tanstack/openai-base';
-import { Modality, TextOptions } from '@tanstack/ai';
-import { GROQ_CHAT_MODELS, GroqChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
-import { GroqMessageMetadataByModality } from '../message-types.js';
-import { GroqClientConfig } from '../utils.js';
-type ResolveToolCapabilities<TModel extends string> = TModel extends keyof GroqChatModelToolCapabilitiesByName ? NonNullable<GroqChatModelToolCapabilitiesByName[TModel]> : readonly [];
-/**
- * Configuration for Groq text adapter
- */
-export interface GroqTextConfig extends GroqClientConfig {
-}
-/**
- * Re-export of the public provider options type
- */
-export type { ExternalTextProviderOptions as GroqTextProviderOptions } from '../text/text-provider-options.js';
-/**
- * Groq Text (Chat) Adapter
- *
- * Tree-shakeable adapter for Groq chat/text completion. Groq exposes an
- * OpenAI-compatible Chat Completions endpoint at `/openai/v1`, so we drive
- * it with the OpenAI SDK via a `baseURL` override (the same pattern as
- * `ai-grok`).
- *
- * Quirk: when usage is present on a stream, Groq historically delivered it
- * under `chunk.x_groq.usage` rather than `chunk.usage`. The override below
- * promotes it to the standard location so the base's RUN_FINISHED usage
- * accounting works unchanged.
- */
-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 OpenAIBaseChatCompletionsTextAdapter<TModel, TProviderOptions, TInputModalities, GroqMessageMetadataByModality, TToolCapabilities> {
-    readonly kind: "text";
-    readonly name: "groq";
-    constructor(config: GroqTextConfig, model: TModel);
-    protected makeStructuredOutputCompatible(schema: Record<string, any>, originalRequired?: Array<string>): Record<string, any>;
-    protected processStreamChunks(stream: AsyncIterable<OpenAI.Chat.Completions.ChatCompletionChunk>, options: TextOptions, aguiState: {
-        runId: string;
-        threadId: string;
-        messageId: string;
-        hasEmittedRunStarted: boolean;
-    }): AsyncGenerator<import('@tanstack/ai').AGUIEvent, void, any>;
-    /**
-     * Surfaces Groq's reasoning deltas during streaming structured output.
-     * Groq emits `delta.reasoning` (or legacy `delta.reasoning_content`) on
-     * reasoning models when the caller sets `reasoning_format: 'parsed'` in
-     * modelOptions. The base's chatStream and structuredOutputStream both
-     * route reasoning through this hook.
-     */
-    protected extractReasoning(chunk: OpenAI.Chat.Completions.ChatCompletionChunk): {
-        text: string;
-    } | undefined;
-    /**
-     * Groq's API rejects `response_format: json_schema` together with `tools`
-     * + `stream` (returns 400 — see Groq Structured Outputs docs:
-     * "Streaming and tool use are not currently supported with Structured
-     * Outputs."). Force the engine onto the legacy finalization path even
-     * though the OpenAI Chat Completions base would otherwise opt in.
-     */
-    supportsCombinedToolsAndSchema(): boolean;
-}
-/**
- * Creates a Groq text adapter with explicit API key.
- *
- * @example
- * ```typescript
- * const adapter = createGroqText('llama-3.3-70b-versatile', "gsk_...");
- * ```
- */
-export declare function createGroqText<TModel extends (typeof GROQ_CHAT_MODELS)[number]>(model: TModel, apiKey: string, config?: Omit<GroqTextConfig, 'apiKey'>): GroqTextAdapter<TModel>;
-/**
- * Creates a Groq text adapter with API key from `GROQ_API_KEY`.
- *
- * @example
- * ```typescript
- * const adapter = groqText('llama-3.3-70b-versatile');
- * ```
- */
-export declare function groqText<TModel extends (typeof GROQ_CHAT_MODELS)[number]>(model: TModel, config?: Omit<GroqTextConfig, 'apiKey'>): GroqTextAdapter<TModel>;

package/dist/esm/adapters/text.js

@@ -1,69 +0,0 @@
-import OpenAI from "openai";
-import { OpenAIBaseChatCompletionsTextAdapter } from "@tanstack/openai-base";
-import { withGroqDefaults, getGroqApiKeyFromEnv } from "../utils/client.js";
-import { makeGroqStructuredOutputCompatible } from "../utils/schema-converter.js";
-class GroqTextAdapter extends OpenAIBaseChatCompletionsTextAdapter {
-  kind = "text";
-  name = "groq";
-  constructor(config, model) {
-    super(model, "groq", new OpenAI(withGroqDefaults(config)));
-  }
-  makeStructuredOutputCompatible(schema, originalRequired) {
-    return makeGroqStructuredOutputCompatible(schema, originalRequired);
-  }
-  async *processStreamChunks(stream, options, aguiState) {
-    yield* super.processStreamChunks(
-      promoteGroqUsage(stream),
-      options,
-      aguiState
-    );
-  }
-  /**
-   * Surfaces Groq's reasoning deltas during streaming structured output.
-   * Groq emits `delta.reasoning` (or legacy `delta.reasoning_content`) on
-   * reasoning models when the caller sets `reasoning_format: 'parsed'` in
-   * modelOptions. The base's chatStream and structuredOutputStream both
-   * route reasoning through this hook.
-   */
-  extractReasoning(chunk) {
-    const delta = chunk.choices[0]?.delta;
-    const raw = delta?.reasoning ?? delta?.reasoning_content;
-    if (typeof raw === "string" && raw.length > 0) {
-      return { text: raw };
-    }
-    return void 0;
-  }
-  /**
-   * Groq's API rejects `response_format: json_schema` together with `tools`
-   * + `stream` (returns 400 — see Groq Structured Outputs docs:
-   * "Streaming and tool use are not currently supported with Structured
-   * Outputs."). Force the engine onto the legacy finalization path even
-   * though the OpenAI Chat Completions base would otherwise opt in.
-   */
-  supportsCombinedToolsAndSchema() {
-    return false;
-  }
-}
-async function* promoteGroqUsage(stream) {
-  for await (const chunk of stream) {
-    const groqChunk = chunk;
-    if (!chunk.usage && groqChunk.x_groq?.usage) {
-      yield { ...chunk, usage: groqChunk.x_groq.usage };
-    } else {
-      yield chunk;
-    }
-  }
-}
-function createGroqText(model, apiKey, config) {
-  return new GroqTextAdapter({ apiKey, ...config }, model);
-}
-function groqText(model, config) {
-  const apiKey = getGroqApiKeyFromEnv();
-  return createGroqText(model, apiKey, config);
-}
-export {
-  GroqTextAdapter,
-  createGroqText,
-  groqText
-};
-//# sourceMappingURL=text.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { OpenAIBaseChatCompletionsTextAdapter } from '@tanstack/openai-base'\nimport { getGroqApiKeyFromEnv, withGroqDefaults } from '../utils/client'\nimport { makeGroqStructuredOutputCompatible } from '../utils/schema-converter'\nimport type { Modality, TextOptions } from '@tanstack/ai'\nimport type {\n  GROQ_CHAT_MODELS,\n  GroqChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { GroqMessageMetadataByModality } from '../message-types'\nimport type { GroqClientConfig } from '../utils'\n\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GroqChatModelToolCapabilitiesByName\n    ? NonNullable<GroqChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for Groq text adapter\n */\nexport interface GroqTextConfig extends GroqClientConfig {}\n\n/**\n * Re-export of the public provider options type\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. Groq exposes an\n * OpenAI-compatible Chat Completions endpoint at `/openai/v1`, so we drive\n * it with the OpenAI SDK via a `baseURL` override (the same pattern as\n * `ai-grok`).\n *\n * Quirk: when usage is present on a stream, Groq historically delivered it\n * under `chunk.x_groq.usage` rather than `chunk.usage`. The override below\n * promotes it to the standard location so the base's RUN_FINISHED usage\n * accounting works unchanged.\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 OpenAIBaseChatCompletionsTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GroqMessageMetadataByModality,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  override readonly name = 'groq' as const\n\n  constructor(config: GroqTextConfig, model: TModel) {\n    super(model, 'groq', new OpenAI(withGroqDefaults(config)))\n  }\n\n  protected override makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired?: Array<string>,\n  ): Record<string, any> {\n    return makeGroqStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  protected override async *processStreamChunks(\n    stream: AsyncIterable<OpenAI.Chat.Completions.ChatCompletionChunk>,\n    options: TextOptions,\n    aguiState: {\n      runId: string\n      threadId: string\n      messageId: string\n      hasEmittedRunStarted: boolean\n    },\n  ) {\n    yield* super.processStreamChunks(\n      promoteGroqUsage(stream),\n      options,\n      aguiState,\n    )\n  }\n\n  /**\n   * Surfaces Groq's reasoning deltas during streaming structured output.\n   * Groq emits `delta.reasoning` (or legacy `delta.reasoning_content`) on\n   * reasoning models when the caller sets `reasoning_format: 'parsed'` in\n   * modelOptions. The base's chatStream and structuredOutputStream both\n   * route reasoning through this hook.\n   */\n  protected override extractReasoning(\n    chunk: OpenAI.Chat.Completions.ChatCompletionChunk,\n  ): { text: string } | undefined {\n    const delta = chunk.choices[0]?.delta as\n      | { reasoning?: unknown; reasoning_content?: unknown }\n      | undefined\n    const raw = delta?.reasoning ?? delta?.reasoning_content\n    if (typeof raw === 'string' && raw.length > 0) {\n      return { text: raw }\n    }\n    return undefined\n  }\n\n  /**\n   * Groq's API rejects `response_format: json_schema` together with `tools`\n   * + `stream` (returns 400 — see Groq Structured Outputs docs:\n   * \"Streaming and tool use are not currently supported with Structured\n   * Outputs.\"). Force the engine onto the legacy finalization path even\n   * though the OpenAI Chat Completions base would otherwise opt in.\n   */\n  override supportsCombinedToolsAndSchema(): boolean {\n    return false\n  }\n}\n\n/**\n * Promotes Groq's non-standard `x_groq.usage` to the standard `chunk.usage`\n * slot the base reads. Pass-through for chunks that already carry usage at\n * the documented location.\n */\nasync function* promoteGroqUsage(\n  stream: AsyncIterable<OpenAI.Chat.Completions.ChatCompletionChunk>,\n): AsyncIterable<OpenAI.Chat.Completions.ChatCompletionChunk> {\n  for await (const chunk of stream) {\n    const groqChunk = chunk as typeof chunk & {\n      x_groq?: { usage?: OpenAI.Chat.Completions.ChatCompletionChunk['usage'] }\n    }\n    if (!chunk.usage && groqChunk.x_groq?.usage) {\n      yield { ...chunk, usage: groqChunk.x_groq.usage }\n    } else {\n      yield chunk\n    }\n  }\n}\n\n/**\n * Creates a Groq text adapter with explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createGroqText('llama-3.3-70b-versatile', \"gsk_...\");\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 API key from `GROQ_API_KEY`.\n *\n * @example\n * ```typescript\n * const adapter = groqText('llama-3.3-70b-versatile');\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":";;;;AA0CO,MAAM,wBAOH,qCAMR;AAAA,EACkB,OAAO;AAAA,EACP,OAAO;AAAA,EAEzB,YAAY,QAAwB,OAAe;AACjD,UAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;AAAA,EAC3D;AAAA,EAEmB,+BACjB,QACA,kBACqB;AACrB,WAAO,mCAAmC,QAAQ,gBAAgB;AAAA,EACpE;AAAA,EAEA,OAA0B,oBACxB,QACA,SACA,WAMA;AACA,WAAO,MAAM;AAAA,MACX,iBAAiB,MAAM;AAAA,MACvB;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASmB,iBACjB,OAC8B;AAC9B,UAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG;AAGhC,UAAM,MAAM,OAAO,aAAa,OAAO;AACvC,QAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,GAAG;AAC7C,aAAO,EAAE,MAAM,IAAA;AAAA,IACjB;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASS,iCAA0C;AACjD,WAAO;AAAA,EACT;AACF;AAOA,gBAAgB,iBACd,QAC4D;AAC5D,mBAAiB,SAAS,QAAQ;AAChC,UAAM,YAAY;AAGlB,QAAI,CAAC,MAAM,SAAS,UAAU,QAAQ,OAAO;AAC3C,YAAM,EAAE,GAAG,OAAO,OAAO,UAAU,OAAO,MAAA;AAAA,IAC5C,OAAO;AACL,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAUO,SAAS,eAGd,OACA,QACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AACzD;AAUO,SAAS,SACd,OACA,QACyB;AACzB,QAAM,SAAS,qBAAA;AACf,SAAO,eAAe,OAAO,QAAQ,MAAM;AAC7C;"}

package/dist/esm/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @module @tanstack/ai-groq
- *
- * Groq provider adapter for TanStack AI.
- * 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, 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/index.js

@@ -1,9 +0,0 @@
-import { GroqTextAdapter, createGroqText, groqText } from "./adapters/text.js";
-import { GROQ_CHAT_MODELS } from "./model-meta.js";
-export {
-  GROQ_CHAT_MODELS,
-  GroqTextAdapter,
-  createGroqText,
-  groqText
-};
-//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/message-types.d.ts

@@ -1,205 +0,0 @@
-/**
- * Groq-specific message types for the Chat Completions API.
- *
- * Groq's wire format is OpenAI Chat Completions plus a few Groq-specific
- * extensions (compound tools, citation/service-tier provider options,
- * etc.). These type definitions describe that wire shape directly — the
- * Groq SDK was dropped in favour of pointing the OpenAI SDK at Groq's
- * `/openai/v1` base URL, so this file is the source of truth for
- * Groq-only fields rather than a mirror of an external SDK's types.
- *
- * @see https://console.groq.com/docs/api-reference#chat
- */
-export type FunctionParameters = {
-    [key: string]: unknown;
-};
-export interface ChatCompletionNamedToolChoice {
-    /** Always `function` for a named tool choice. */
-    type: 'function';
-    function: {
-        /** The name of the function to call. */
-        name: string;
-    };
-}
-export interface FunctionDefinition {
-    /**
-     * The name of the function to be called. Must be a-z, A-Z, 0-9, or contain
-     * underscores and dashes, with a maximum length of 64.
-     */
-    name: string;
-    /**
-     * A description of what the function does, used by the model to choose when and
-     * how to call the function.
-     */
-    description?: string;
-    /**
-     * Function parameters defined as a JSON Schema object.
-     * @see https://json-schema.org/understanding-json-schema/
-     */
-    parameters?: FunctionParameters;
-    /**
-     * Whether to enable strict schema adherence when generating the output. If set to
-     * true, the model will always follow the exact schema defined in the `schema`
-     * field. Only a subset of JSON Schema is supported when `strict` is `true`.
-     */
-    strict?: boolean;
-}
-/**
- * Controls which (if any) tool is called by the model.
- *
- * - `none` — the model will not call any tool and instead generates a message
- * - `auto` — the model can pick between generating a message or calling tools
- * - `required` — the model must call one or more tools
- * - Named tool choice — forces the model to call a specific tool
- */
-export type ChatCompletionToolChoiceOption = 'none' | 'auto' | 'required' | ChatCompletionNamedToolChoice;
-export interface ChatCompletionTool {
-    /**
-     * The type of the tool. `function`, `browser_search`, and `code_interpreter` are
-     * supported.
-     */
-    type: 'function' | 'browser_search' | 'code_interpreter' | (string & {});
-    function?: FunctionDefinition;
-}
-export interface CompoundCustomModels {
-    /** Custom model to use for answering. */
-    answering_model?: string | null;
-    /** Custom model to use for reasoning. */
-    reasoning_model?: string | null;
-}
-export interface CompoundCustomTools {
-    /** A list of tool names that are enabled for the request. */
-    enabled_tools?: Array<string> | null;
-    /** Configuration for the Wolfram tool integration. */
-    wolfram_settings?: CompoundCustomToolsWolframSettings | null;
-}
-export interface CompoundCustomToolsWolframSettings {
-    /** API key used to authorize requests to Wolfram services. */
-    authorization?: string | null;
-}
-export interface CompoundCustom {
-    models?: CompoundCustomModels | null;
-    /** Configuration options for tools available to Compound. */
-    tools?: CompoundCustomTools | null;
-}
-export interface DocumentSourceText {
-    /** The document contents. */
-    text: string;
-    /** Identifies this document source as inline text. */
-    type: 'text';
-}
-export interface DocumentSourceJson {
-    /** The JSON payload associated with the document. */
-    data: {
-        [key: string]: unknown;
-    };
-    /** Identifies this document source as JSON data. */
-    type: 'json';
-}
-export interface Document {
-    /** The source of the document. Only text and JSON sources are currently supported. */
-    source: DocumentSourceText | DocumentSourceJson;
-    /** Optional unique identifier that can be used for citations in responses. */
-    id?: string | null;
-}
-export interface ResponseFormatText {
-    /** The type of response format being defined. Always `text`. */
-    type: 'text';
-}
-export interface ResponseFormatJsonSchemaJsonSchema {
-    /**
-     * The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores
-     * and dashes, with a maximum length of 64.
-     */
-    name: string;
-    /**
-     * A description of what the response format is for, used by the model to determine
-     * how to respond in the format.
-     */
-    description?: string;
-    /**
-     * The schema for the response format, described as a JSON Schema object.
-     * @see https://json-schema.org/
-     */
-    schema?: {
-        [key: string]: unknown;
-    };
-    /**
-     * Whether to enable strict schema adherence when generating the output. If set to
-     * true, the model will always follow the exact schema defined in the `schema`
-     * field. Only a subset of JSON Schema is supported when `strict` is `true`.
-     */
-    strict?: boolean | null;
-}
-export interface ResponseFormatJsonSchema {
-    /** Structured Outputs configuration options, including a JSON Schema. */
-    json_schema: ResponseFormatJsonSchemaJsonSchema;
-    /** The type of response format being defined. Always `json_schema`. */
-    type: 'json_schema';
-}
-export interface ResponseFormatJsonObject {
-    /** The type of response format being defined. Always `json_object`. */
-    type: 'json_object';
-}
-export interface SearchSettings {
-    /**
-     * Name of country to prioritize search results from
-     * (e.g., "united states", "germany", "france").
-     */
-    country?: string | null;
-    /** A list of domains to exclude from the search results. */
-    exclude_domains?: Array<string> | null;
-    /** A list of domains to include in the search results. */
-    include_domains?: Array<string> | null;
-    /** Whether to include images in the search results. */
-    include_images?: boolean | null;
-}
-/**
- * Metadata for Groq document content parts.
- */
-export interface GroqDocumentMetadata {
-}
-/**
- * Metadata for Groq text content parts.
- * Currently no specific metadata options for text in Groq.
- */
-export interface GroqTextMetadata {
-}
-/**
- * Metadata for Groq image content parts.
- * Controls how the model processes and analyzes images.
- */
-export interface GroqImageMetadata {
-    /**
-     * Specifies the detail level of the image.
-     * - 'auto': Let the model decide based on image size and content
-     * - 'low': Use low resolution processing (faster, cheaper, less detail)
-     * - 'high': Use high resolution processing (slower, more expensive, more detail)
-     *
-     * @default 'auto'
-     */
-    detail?: 'auto' | 'low' | 'high';
-}
-/**
- * Metadata for Groq audio content parts.
- * Note: Audio support in Groq is limited; check current API capabilities.
- */
-export interface GroqAudioMetadata {
-}
-/**
- * Metadata for Groq video content parts.
- * Note: Groq does not currently support video input.
- */
-export interface GroqVideoMetadata {
-}
-/**
- * Map of modality types to their Groq-specific metadata types.
- * Used for type inference when constructing multimodal messages.
- */
-export interface GroqMessageMetadataByModality {
-    text: GroqTextMetadata;
-    image: GroqImageMetadata;
-    audio: GroqAudioMetadata;
-    video: GroqVideoMetadata;
-    document: GroqDocumentMetadata;
-}

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

@@ -1,307 +0,0 @@
-import { GroqTextProviderOptions } from './text/text-provider-options.js';
-declare const LLAMA_3_3_70B_VERSATILE: {
-    readonly name: "llama-3.3-70b-versatile";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 32768;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.59;
-        };
-        readonly output: {
-            readonly normal: 0.79;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "tools", "json_object"];
-        readonly tools: readonly [];
-    };
-};
-declare const LLAMA_4_MAVERICK_17B_128E_INSTRUCT: {
-    readonly name: "meta-llama/llama-4-maverick-17b-128e-instruct";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 8192;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-        };
-        readonly output: {
-            readonly normal: 0.6;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text", "image"];
-        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: {
-    readonly name: "meta-llama/llama-4-scout-17b-16e-instruct";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 8192;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.08;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "tools", "json_object"];
-        readonly tools: readonly [];
-    };
-};
-declare const LLAMA_GUARD_4_12B: {
-    readonly name: "meta-llama/llama-guard-4-12b";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 1024;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-        };
-        readonly output: {
-            readonly normal: 0.2;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "json_object", "content_moderation", "vision"];
-        readonly tools: readonly [];
-    };
-};
-declare const LLAMA_PROMPT_GUARD_2_86M: {
-    readonly name: "meta-llama/llama-prompt-guard-2-86m";
-    readonly context_window: 512;
-    readonly max_completion_tokens: 512;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.04;
-        };
-        readonly output: {
-            readonly normal: 0.04;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "content_moderation", "json_object"];
-        readonly tools: readonly [];
-    };
-};
-declare const LLAMA_3_1_8B_INSTANT: {
-    readonly name: "llama-3.1-8b-instant";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 131072;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.08;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "json_object", "tools"];
-        readonly tools: readonly [];
-    };
-};
-declare const LLAMA_PROMPT_GUARD_2_22M: {
-    readonly name: "meta-llama/llama-prompt-guard-2-22m";
-    readonly context_window: 512;
-    readonly max_completion_tokens: 512;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.03;
-        };
-        readonly output: {
-            readonly normal: 0.03;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "content_moderation"];
-        readonly tools: readonly [];
-    };
-};
-declare const GPT_OSS_120B: {
-    readonly name: "openai/gpt-oss-120b";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 65536;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.15;
-            readonly cached: 0.075;
-        };
-        readonly output: {
-            readonly normal: 0.6;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        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: {
-    readonly name: "openai/gpt-oss-safeguard-20b";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 65536;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.075;
-            readonly cached: 0.037;
-        };
-        readonly output: {
-            readonly normal: 0.3;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        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: {
-    readonly name: "openai/gpt-oss-20b";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 65536;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.075;
-            readonly cached: 0.037;
-        };
-        readonly output: {
-            readonly normal: 0.3;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        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: {
-    readonly name: "moonshotai/kimi-k2-instruct-0905";
-    readonly context_window: 262144;
-    readonly max_completion_tokens: 16384;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 1;
-            readonly cached: 0.5;
-        };
-        readonly output: {
-            readonly normal: 3;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "tools", "json_object", "json_schema"];
-        readonly tools: readonly [];
-    };
-};
-declare const QWEN3_32B: {
-    readonly name: "qwen/qwen3-32b";
-    readonly context_window: 131072;
-    readonly max_completion_tokens: 40960;
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.29;
-        };
-        readonly output: {
-            readonly normal: 0.59;
-        };
-    };
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly endpoints: ["chat"];
-        readonly features: ["streaming", "json_object", "tools", "reasoning"];
-        readonly tools: readonly [];
-    };
-};
-/**
- * All supported Groq chat model identifiers.
- */
-export declare const GROQ_CHAT_MODELS: readonly ["llama-3.1-8b-instant", "llama-3.3-70b-versatile", "meta-llama/llama-4-maverick-17b-128e-instruct", "meta-llama/llama-4-scout-17b-16e-instruct", "meta-llama/llama-guard-4-12b", "meta-llama/llama-prompt-guard-2-86m", "meta-llama/llama-prompt-guard-2-22m", "openai/gpt-oss-20b", "openai/gpt-oss-120b", "openai/gpt-oss-safeguard-20b", "moonshotai/kimi-k2-instruct-0905", "qwen/qwen3-32b"];
-/**
- * Union type of all supported Groq chat model names.
- */
-export type GroqChatModels = (typeof GROQ_CHAT_MODELS)[number];
-/**
- * Type-only map from Groq chat model name to its supported input modalities.
- */
-export type GroqModelInputModalitiesByName = {
-    [LLAMA_3_1_8B_INSTANT.name]: typeof LLAMA_3_1_8B_INSTANT.supports.input;
-    [LLAMA_3_3_70B_VERSATILE.name]: typeof LLAMA_3_3_70B_VERSATILE.supports.input;
-    [LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name]: typeof LLAMA_4_MAVERICK_17B_128E_INSTRUCT.supports.input;
-    [LLAMA_4_SCOUT_17B_16E_INSTRUCT.name]: typeof LLAMA_4_SCOUT_17B_16E_INSTRUCT.supports.input;
-    [LLAMA_GUARD_4_12B.name]: typeof LLAMA_GUARD_4_12B.supports.input;
-    [LLAMA_PROMPT_GUARD_2_86M.name]: typeof LLAMA_PROMPT_GUARD_2_86M.supports.input;
-    [LLAMA_PROMPT_GUARD_2_22M.name]: typeof LLAMA_PROMPT_GUARD_2_22M.supports.input;
-    [GPT_OSS_20B.name]: typeof GPT_OSS_20B.supports.input;
-    [GPT_OSS_120B.name]: typeof GPT_OSS_120B.supports.input;
-    [GPT_OSS_SAFEGUARD_20B.name]: typeof GPT_OSS_SAFEGUARD_20B.supports.input;
-    [KIMI_K2_INSTRUCT_0905.name]: typeof KIMI_K2_INSTRUCT_0905.supports.input;
-    [QWEN3_32B.name]: typeof QWEN3_32B.supports.input;
-};
-/**
- * Type-only map from Groq chat model name to its provider options type.
- */
-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.
- */
-export type ResolveProviderOptions<TModel extends string> = TModel extends keyof GroqChatModelProviderOptionsByName ? GroqChatModelProviderOptionsByName[TModel] : GroqTextProviderOptions;
-/**
- * Resolve input modalities for a specific model.
- * If the model has explicit modalities in the map, use those; otherwise use text only.
- */
-export type ResolveInputModalities<TModel extends string> = TModel extends keyof GroqModelInputModalitiesByName ? GroqModelInputModalitiesByName[TModel] : readonly ['text'];
-export {};

package/dist/esm/model-meta.js

@@ -1,54 +0,0 @@
-const LLAMA_3_3_70B_VERSATILE = {
-  name: "llama-3.3-70b-versatile"
-};
-const LLAMA_4_MAVERICK_17B_128E_INSTRUCT = {
-  name: "meta-llama/llama-4-maverick-17b-128e-instruct"
-};
-const LLAMA_4_SCOUT_17B_16E_INSTRUCT = {
-  name: "meta-llama/llama-4-scout-17b-16e-instruct"
-};
-const LLAMA_GUARD_4_12B = {
-  name: "meta-llama/llama-guard-4-12b"
-};
-const LLAMA_PROMPT_GUARD_2_86M = {
-  name: "meta-llama/llama-prompt-guard-2-86m"
-};
-const LLAMA_3_1_8B_INSTANT = {
-  name: "llama-3.1-8b-instant"
-};
-const LLAMA_PROMPT_GUARD_2_22M = {
-  name: "meta-llama/llama-prompt-guard-2-22m"
-};
-const GPT_OSS_120B = {
-  name: "openai/gpt-oss-120b"
-};
-const GPT_OSS_SAFEGUARD_20B = {
-  name: "openai/gpt-oss-safeguard-20b"
-};
-const GPT_OSS_20B = {
-  name: "openai/gpt-oss-20b"
-};
-const KIMI_K2_INSTRUCT_0905 = {
-  name: "moonshotai/kimi-k2-instruct-0905"
-};
-const QWEN3_32B = {
-  name: "qwen/qwen3-32b"
-};
-const GROQ_CHAT_MODELS = [
-  LLAMA_3_1_8B_INSTANT.name,
-  LLAMA_3_3_70B_VERSATILE.name,
-  LLAMA_4_MAVERICK_17B_128E_INSTRUCT.name,
-  LLAMA_4_SCOUT_17B_16E_INSTRUCT.name,
-  LLAMA_GUARD_4_12B.name,
-  LLAMA_PROMPT_GUARD_2_86M.name,
-  LLAMA_PROMPT_GUARD_2_22M.name,
-  GPT_OSS_20B.name,
-  GPT_OSS_120B.name,
-  GPT_OSS_SAFEGUARD_20B.name,
-  KIMI_K2_INSTRUCT_0905.name,
-  QWEN3_32B.name
-];
-export {
-  GROQ_CHAT_MODELS
-};
-//# sourceMappingURL=model-meta.js.map

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

@@ -1 +0,0 @@
-{"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/text/text-provider-options.d.ts

@@ -1,154 +0,0 @@
-import { ChatCompletionToolChoiceOption, CompoundCustom, Document, ResponseFormatJsonObject, ResponseFormatJsonSchema, ResponseFormatText, SearchSettings } from '../message-types.js';
-/**
- * Groq-specific provider options for text/chat models.
- *
- * These options extend the standard Chat Completions API parameters
- * with Groq-specific features like compound models and search settings.
- *
- * @see https://console.groq.com/docs/api-reference#chat
- */
-export interface GroqTextProviderOptions {
-    /**
-     * Whether to enable citations in the response. When enabled, the model will
-     * include citations for information retrieved from provided documents or web
-     * searches.
-     */
-    citation_options?: 'enabled' | 'disabled' | null;
-    /** Custom configuration of models and tools for Compound. */
-    compound_custom?: CompoundCustom | null;
-    /**
-     * If set to true, groq will return called tools without validating that the tool
-     * is present in request.tools. tool_choice=required/none will still be enforced,
-     * but the request cannot require a specific tool be used.
-     */
-    disable_tool_validation?: boolean;
-    /**
-     * A list of documents to provide context for the conversation. Each document
-     * contains text that can be referenced by the model.
-     */
-    documents?: Array<Document> | null;
-    /**
-     * Number between -2.0 and 2.0. Positive values penalize new tokens based on their
-     * existing frequency in the text so far, decreasing the model's likelihood to
-     * repeat the same line verbatim.
-     */
-    frequency_penalty?: number | null;
-    /**
-     * Whether to include reasoning in the response. This field is mutually exclusive
-     * with `reasoning_format`.
-     */
-    include_reasoning?: boolean | null;
-    /** Modify the likelihood of specified tokens appearing in the completion. */
-    logit_bias?: {
-        [key: string]: number;
-    } | null;
-    /**
-     * Whether to return log probabilities of the output tokens or not. If true,
-     * returns the log probabilities of each output token returned in the `content`
-     * of `message`.
-     */
-    logprobs?: boolean | null;
-    /**
-     * The maximum number of tokens that can be generated in the chat completion. The
-     * total length of input tokens and generated tokens is limited by the model's
-     * context length.
-     */
-    max_completion_tokens?: number | null;
-    /** Request metadata. */
-    metadata?: {
-        [key: string]: string;
-    } | null;
-    /**
-     * How many chat completion choices to generate for each input message.
-     * Currently only n=1 is supported.
-     */
-    n?: number | null;
-    /** Whether to enable parallel function calling during tool use. */
-    parallel_tool_calls?: boolean | null;
-    /**
-     * Number between -2.0 and 2.0. Positive values penalize new tokens based on
-     * whether they appear in the text so far, increasing the model's likelihood to
-     * talk about new topics.
-     */
-    presence_penalty?: number | null;
-    /**
-     * Controls reasoning effort for supported models.
-     *
-     * - qwen3 models: `'none'` to disable, `'default'` or null to enable
-     * - openai/gpt-oss models: `'low'`, `'medium'` (default), or `'high'`
-     */
-    reasoning_effort?: 'none' | 'default' | 'low' | 'medium' | 'high' | null;
-    /**
-     * Specifies how to output reasoning tokens.
-     * This field is mutually exclusive with `include_reasoning`.
-     */
-    reasoning_format?: 'hidden' | 'raw' | 'parsed' | null;
-    /**
-     * An object specifying the format that the model must output.
-     *
-     * - `json_schema` — enables Structured Outputs (preferred)
-     * - `json_object` — enables the older JSON mode
-     * - `text` — plain text output (default)
-     *
-     * @see https://console.groq.com/docs/structured-outputs
-     */
-    response_format?: ResponseFormatText | ResponseFormatJsonSchema | ResponseFormatJsonObject | null;
-    /** Settings for web search functionality when the model uses a web search tool. */
-    search_settings?: SearchSettings | null;
-    /**
-     * If specified, our system will make a best effort to sample deterministically,
-     * such that repeated requests with the same `seed` and parameters should return
-     * the same result.
-     */
-    seed?: number | null;
-    /**
-     * The service tier to use for the request.
-     *
-     * - `auto` — automatically select the highest tier available
-     * - `flex` — uses the flex tier, which will succeed or fail quickly
-     */
-    service_tier?: 'auto' | 'on_demand' | 'flex' | 'performance' | null;
-    /**
-     * Up to 4 sequences where the API will stop generating further tokens.
-     * The returned text will not contain the stop sequence.
-     */
-    stop?: string | null | Array<string>;
-    /** Whether to store the request for future use. */
-    store?: boolean | null;
-    /**
-     * Sampling temperature between 0 and 2. Higher values like 0.8 will make the
-     * output more random, while lower values like 0.2 will make it more focused
-     * and deterministic. We generally recommend altering this or top_p but not both.
-     */
-    temperature?: number | null;
-    /**
-     * Controls which (if any) tool is called by the model.
-     *
-     * - `none` — never call tools
-     * - `auto` — model decides (default when tools are present)
-     * - `required` — model must call tools
-     * - Named choice — forces a specific tool
-     */
-    tool_choice?: ChatCompletionToolChoiceOption | null;
-    /**
-     * An integer between 0 and 20 specifying the number of most likely tokens to
-     * return at each token position. `logprobs` must be set to `true` if this
-     * parameter is used.
-     */
-    top_logprobs?: number | null;
-    /**
-     * An alternative to sampling with temperature, called nucleus sampling, where the
-     * model considers the results of the tokens with top_p probability mass. So 0.1
-     * means only the tokens comprising the top 10% probability mass are considered.
-     */
-    top_p?: number | null;
-    /**
-     * A unique identifier representing your end-user, which can help monitor and
-     * detect abuse.
-     */
-    user?: string | null;
-}
-/**
- * External provider options (what users pass in)
- */
-export type ExternalTextProviderOptions = GroqTextProviderOptions;

package/dist/esm/tools/function-tool.d.ts

@@ -1,13 +0,0 @@
-import { Tool } from '@tanstack/ai';
-import { ChatCompletionTool } from '../message-types.js';
-export type FunctionTool = ChatCompletionTool;
-/**
- * Converts a standard Tool to Groq ChatCompletionTool format.
- *
- * Tool schemas are already converted to JSON Schema in the ai layer.
- * We apply Groq-specific transformations for strict mode:
- * - All properties in required array
- * - Optional fields made nullable
- * - additionalProperties: false
- */
-export declare function convertFunctionToolToAdapterFormat(tool: Tool): FunctionTool;

package/dist/esm/tools/function-tool.js

@@ -1,29 +0,0 @@
-import { makeGroqStructuredOutputCompatible } from "../utils/schema-converter.js";
-function convertFunctionToolToAdapterFormat(tool) {
-  const inputSchema = tool.inputSchema ?? {
-    type: "object",
-    properties: {},
-    required: []
-  };
-  if (inputSchema.type === "object" && !inputSchema.properties) {
-    inputSchema.properties = {};
-  }
-  const jsonSchema = makeGroqStructuredOutputCompatible(
-    inputSchema,
-    inputSchema.required || []
-  );
-  jsonSchema.additionalProperties = false;
-  return {
-    type: "function",
-    function: {
-      name: tool.name,
-      description: tool.description,
-      parameters: jsonSchema,
-      strict: true
-    }
-  };
-}
-export {
-  convertFunctionToolToAdapterFormat
-};
-//# sourceMappingURL=function-tool.js.map

package/dist/esm/tools/function-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"function-tool.js","sources":["../../../src/tools/function-tool.ts"],"sourcesContent":["import { makeGroqStructuredOutputCompatible } from '../utils/schema-converter'\nimport type { JSONSchema, Tool } from '@tanstack/ai'\nimport type { ChatCompletionTool } from '../message-types'\n\nexport type FunctionTool = ChatCompletionTool\n\n/**\n * Converts a standard Tool to Groq ChatCompletionTool format.\n *\n * Tool schemas are already converted to JSON Schema in the ai layer.\n * We apply Groq-specific transformations for strict mode:\n * - All properties in required array\n * - Optional fields made nullable\n * - additionalProperties: false\n */\nexport function convertFunctionToolToAdapterFormat(tool: Tool): FunctionTool {\n  const inputSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  // Ensure object schemas always have properties (e.g. z.object({}) may produce { type: 'object' } without properties)\n  if (inputSchema.type === 'object' && !inputSchema.properties) {\n    inputSchema.properties = {}\n  }\n\n  const jsonSchema = makeGroqStructuredOutputCompatible(\n    inputSchema,\n    inputSchema.required || [],\n  )\n\n  jsonSchema.additionalProperties = false\n\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: jsonSchema,\n      strict: true,\n    },\n  } satisfies FunctionTool\n}\n"],"names":[],"mappings":";AAeO,SAAS,mCAAmC,MAA0B;AAC3E,QAAM,cAAe,KAAK,eAAe;AAAA,IACvC,MAAM;AAAA,IACN,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAIb,MAAI,YAAY,SAAS,YAAY,CAAC,YAAY,YAAY;AAC5D,gBAAY,aAAa,CAAA;AAAA,EAC3B;AAEA,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,YAAY,YAAY,CAAA;AAAA,EAAC;AAG3B,aAAW,uBAAuB;AAElC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,MAClB,YAAY;AAAA,MACZ,QAAQ;AAAA,IAAA;AAAA,EACV;AAEJ;"}

package/dist/esm/tools/index.d.ts

@@ -1,2 +0,0 @@
-export { convertFunctionToolToAdapterFormat, type FunctionTool, } from './function-tool.js';
-export { convertToolsToProviderFormat } from './tool-converter.js';

package/dist/esm/tools/index.js

@@ -1,7 +0,0 @@
-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

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

package/dist/esm/tools/tool-converter.d.ts

@@ -1,7 +0,0 @@
-import { FunctionTool } from './function-tool.js';
-import { Tool } from '@tanstack/ai';
-/**
- * Converts an array of standard Tools to Groq-specific format.
- * Groq uses an OpenAI-compatible API, so we primarily support function tools.
- */
-export declare function convertToolsToProviderFormat(tools: Array<Tool>): Array<FunctionTool>;

package/dist/esm/tools/tool-converter.js

@@ -1,10 +0,0 @@
-import { convertFunctionToolToAdapterFormat } from "./function-tool.js";
-function convertToolsToProviderFormat(tools) {
-  return tools.map((tool) => {
-    return convertFunctionToolToAdapterFormat(tool);
-  });
-}
-export {
-  convertToolsToProviderFormat
-};
-//# sourceMappingURL=tool-converter.js.map

package/dist/esm/tools/tool-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-converter.js","sources":["../../../src/tools/tool-converter.ts"],"sourcesContent":["import { convertFunctionToolToAdapterFormat } from './function-tool'\nimport type { FunctionTool } from './function-tool'\nimport type { Tool } from '@tanstack/ai'\n\n/**\n * Converts an array of standard Tools to Groq-specific format.\n * Groq uses an OpenAI-compatible API, so we primarily support function tools.\n */\nexport function convertToolsToProviderFormat(\n  tools: Array<Tool>,\n): Array<FunctionTool> {\n  return tools.map((tool) => {\n    return convertFunctionToolToAdapterFormat(tool)\n  })\n}\n"],"names":[],"mappings":";AAQO,SAAS,6BACd,OACqB;AACrB,SAAO,MAAM,IAAI,CAAC,SAAS;AACzB,WAAO,mCAAmC,IAAI;AAAA,EAChD,CAAC;AACH;"}

package/dist/esm/utils/client.d.ts

@@ -1,15 +0,0 @@
-import { ClientOptions } from 'openai';
-export interface GroqClientConfig extends Omit<ClientOptions, 'apiKey'> {
-    apiKey: string;
-}
-/**
- * Gets Groq API key from environment variables
- * @throws Error if GROQ_API_KEY is not found
- */
-export declare function getGroqApiKeyFromEnv(): string;
-/**
- * Returns a Groq client config with Groq's OpenAI-compatible base URL
- * applied when not already set. The Groq endpoint accepts the OpenAI SDK
- * verbatim, so the adapter drives it via the OpenAI SDK with this baseURL.
- */
-export declare function withGroqDefaults(config: GroqClientConfig): GroqClientConfig;

package/dist/esm/utils/client.js

@@ -1,21 +0,0 @@
-import { getApiKeyFromEnv } from "@tanstack/ai-utils";
-function getGroqApiKeyFromEnv() {
-  try {
-    return getApiKeyFromEnv("GROQ_API_KEY");
-  } catch {
-    throw new Error(
-      "GROQ_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key."
-    );
-  }
-}
-function withGroqDefaults(config) {
-  return {
-    ...config,
-    baseURL: config.baseURL || "https://api.groq.com/openai/v1"
-  };
-}
-export {
-  getGroqApiKeyFromEnv,
-  withGroqDefaults
-};
-//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport interface GroqClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets Groq API key from environment variables\n * @throws Error if GROQ_API_KEY is not found\n */\nexport function getGroqApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('GROQ_API_KEY')\n  } catch {\n    throw new Error(\n      'GROQ_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.',\n    )\n  }\n}\n\n/**\n * Returns a Groq client config with Groq's OpenAI-compatible base URL\n * applied when not already set. The Groq endpoint accepts the OpenAI SDK\n * verbatim, so the adapter drives it via the OpenAI SDK with this baseURL.\n */\nexport function withGroqDefaults(config: GroqClientConfig): GroqClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.groq.com/openai/v1',\n  }\n}\n"],"names":[],"mappings":";AAWO,SAAS,uBAA+B;AAC7C,MAAI;AACF,WAAO,iBAAiB,cAAc;AAAA,EACxC,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAOO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,WAAW;AAAA,EAAA;AAE/B;"}

package/dist/esm/utils/index.d.ts

@@ -1,3 +0,0 @@
-export { getGroqApiKeyFromEnv, withGroqDefaults, type GroqClientConfig, } from './client.js';
-export { generateId } from '@tanstack/ai-utils';
-export { makeGroqStructuredOutputCompatible, transformNullsToUndefined, } from './schema-converter.js';

package/dist/esm/utils/schema-converter.d.ts

@@ -1,19 +0,0 @@
-import { transformNullsToUndefined } from '@tanstack/ai-utils';
-export { transformNullsToUndefined };
-/**
- * Transform a JSON schema to be compatible with Groq's structured output requirements.
- *
- * Groq requires:
- * - All properties must be in the `required` array
- * - Optional fields should have null added to their type union
- * - additionalProperties must be false for objects
- * - `required` must be omitted (not empty array) when there are no properties
- *
- * Delegates to the shared OpenAI-compatible transformer and applies the
- * Groq-specific quirk of removing empty `required` arrays.
- *
- * @param schema - JSON schema to transform
- * @param originalRequired - Original required array (to know which fields were optional)
- * @returns Transformed schema compatible with Groq structured output
- */
-export declare function makeGroqStructuredOutputCompatible(schema: Record<string, any>, originalRequired?: Array<string>): Record<string, any>;

package/dist/esm/utils/schema-converter.js

@@ -1,73 +0,0 @@
-import { makeStructuredOutputCompatible } from "@tanstack/openai-base";
-import { transformNullsToUndefined } from "@tanstack/ai-utils";
-function removeEmptyRequired(schema) {
-  const result = { ...schema };
-  if (Array.isArray(result.required) && result.required.length === 0) {
-    delete result.required;
-  }
-  if (result.properties && typeof result.properties === "object") {
-    const properties = {};
-    for (const [key, value] of Object.entries(
-      result.properties
-    )) {
-      properties[key] = typeof value === "object" && value !== null && !Array.isArray(value) ? removeEmptyRequired(value) : value;
-    }
-    result.properties = properties;
-  }
-  if (result.items && typeof result.items === "object" && !Array.isArray(result.items)) {
-    result.items = removeEmptyRequired(result.items);
-  }
-  for (const keyword of ["anyOf", "oneOf", "allOf"]) {
-    if (Array.isArray(result[keyword])) {
-      result[keyword] = result[keyword].map(
-        (entry) => removeEmptyRequired(entry)
-      );
-    }
-  }
-  if (result.additionalProperties && typeof result.additionalProperties === "object" && !Array.isArray(result.additionalProperties)) {
-    result.additionalProperties = removeEmptyRequired(
-      result.additionalProperties
-    );
-  }
-  return result;
-}
-function normalizeObjectSchemas(schema) {
-  const result = schema.type === "object" && !schema.properties ? { ...schema, properties: {} } : { ...schema };
-  if (result.properties && typeof result.properties === "object") {
-    result.properties = Object.fromEntries(
-      Object.entries(result.properties).map(
-        ([key, value]) => [
-          key,
-          typeof value === "object" && value !== null && !Array.isArray(value) ? normalizeObjectSchemas(value) : value
-        ]
-      )
-    );
-  }
-  if (result.items && typeof result.items === "object" && !Array.isArray(result.items)) {
-    result.items = normalizeObjectSchemas(result.items);
-  }
-  for (const keyword of ["anyOf", "oneOf", "allOf"]) {
-    const branch = result[keyword];
-    if (Array.isArray(branch)) {
-      result[keyword] = branch.map(
-        (entry) => typeof entry === "object" && entry !== null ? normalizeObjectSchemas(entry) : entry
-      );
-    }
-  }
-  if (result.additionalProperties && typeof result.additionalProperties === "object" && !Array.isArray(result.additionalProperties)) {
-    result.additionalProperties = normalizeObjectSchemas(
-      result.additionalProperties
-    );
-  }
-  return result;
-}
-function makeGroqStructuredOutputCompatible(schema, originalRequired = []) {
-  const normalised = normalizeObjectSchemas(schema);
-  const result = makeStructuredOutputCompatible(normalised, originalRequired);
-  return removeEmptyRequired(result);
-}
-export {
-  makeGroqStructuredOutputCompatible,
-  transformNullsToUndefined
-};
-//# sourceMappingURL=schema-converter.js.map

package/dist/esm/utils/schema-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-converter.js","sources":["../../../src/utils/schema-converter.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '@tanstack/openai-base'\nimport { transformNullsToUndefined } from '@tanstack/ai-utils'\n\nexport { transformNullsToUndefined }\n\n/**\n * Recursively removes `required: []` from a schema object.\n * Groq rejects `required` when it is an empty array, even though\n * OpenAI-compatible schemas allow it.\n */\nfunction removeEmptyRequired(schema: Record<string, any>): Record<string, any> {\n  const result = { ...schema }\n\n  if (Array.isArray(result.required) && result.required.length === 0) {\n    delete result.required\n  }\n\n  if (result.properties && typeof result.properties === 'object') {\n    const properties: Record<string, any> = {}\n    for (const [key, value] of Object.entries(\n      result.properties as Record<string, any>,\n    )) {\n      properties[key] =\n        typeof value === 'object' && value !== null && !Array.isArray(value)\n          ? removeEmptyRequired(value)\n          : value\n    }\n    result.properties = properties\n  }\n\n  if (\n    result.items &&\n    typeof result.items === 'object' &&\n    !Array.isArray(result.items)\n  ) {\n    result.items = removeEmptyRequired(result.items)\n  }\n\n  // Recurse into combinator arrays (anyOf, oneOf, allOf)\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    if (Array.isArray(result[keyword])) {\n      result[keyword] = result[keyword].map((entry: Record<string, any>) =>\n        removeEmptyRequired(entry),\n      )\n    }\n  }\n\n  // Recurse into additionalProperties if it's a schema object\n  if (\n    result.additionalProperties &&\n    typeof result.additionalProperties === 'object' &&\n    !Array.isArray(result.additionalProperties)\n  ) {\n    result.additionalProperties = removeEmptyRequired(\n      result.additionalProperties,\n    )\n  }\n\n  return result\n}\n\n/**\n * Recursively normalise object schemas so any `{ type: 'object' }` node\n * without `properties` gets an empty `properties: {}` object. The\n * ai-openai-base transformer only descends into objects that already have\n * `properties` set, so a Zod `z.object({})` nested inside `properties`,\n * `items`, `additionalProperties`, or a combinator branch would otherwise\n * skip the strict-mode rewrite and fail Groq validation.\n */\nfunction normalizeObjectSchemas(\n  schema: Record<string, any>,\n): Record<string, any> {\n  const result: Record<string, any> =\n    schema.type === 'object' && !schema.properties\n      ? { ...schema, properties: {} }\n      : { ...schema }\n\n  if (result.properties && typeof result.properties === 'object') {\n    result.properties = Object.fromEntries(\n      Object.entries(result.properties as Record<string, any>).map(\n        ([key, value]) => [\n          key,\n          typeof value === 'object' && value !== null && !Array.isArray(value)\n            ? normalizeObjectSchemas(value)\n            : value,\n        ],\n      ),\n    )\n  }\n\n  if (\n    result.items &&\n    typeof result.items === 'object' &&\n    !Array.isArray(result.items)\n  ) {\n    result.items = normalizeObjectSchemas(result.items)\n  }\n\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    const branch = result[keyword]\n    if (Array.isArray(branch)) {\n      result[keyword] = branch.map((entry) =>\n        typeof entry === 'object' && entry !== null\n          ? normalizeObjectSchemas(entry as Record<string, any>)\n          : entry,\n      )\n    }\n  }\n\n  if (\n    result.additionalProperties &&\n    typeof result.additionalProperties === 'object' &&\n    !Array.isArray(result.additionalProperties)\n  ) {\n    result.additionalProperties = normalizeObjectSchemas(\n      result.additionalProperties as Record<string, any>,\n    )\n  }\n\n  return result\n}\n\n/**\n * Transform a JSON schema to be compatible with Groq's structured output requirements.\n *\n * Groq requires:\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 objects\n * - `required` must be omitted (not empty array) when there are no properties\n *\n * Delegates to the shared OpenAI-compatible transformer and applies the\n * Groq-specific quirk of removing empty `required` arrays.\n *\n * @param schema - JSON schema to transform\n * @param originalRequired - Original required array (to know which fields were optional)\n * @returns Transformed schema compatible with Groq structured output\n */\nexport function makeGroqStructuredOutputCompatible(\n  schema: Record<string, any>,\n  originalRequired: Array<string> = [],\n): Record<string, any> {\n  // Recursively patch every `{ type: 'object' }` node so the ai-openai-base\n  // transformer descends into nested empty objects too.\n  const normalised = normalizeObjectSchemas(schema)\n\n  const result = makeStructuredOutputCompatible(normalised, originalRequired)\n\n  // Groq rejects `required` when it is an empty array\n  return removeEmptyRequired(result)\n}\n"],"names":[],"mappings":";;AAUA,SAAS,oBAAoB,QAAkD;AAC7E,QAAM,SAAS,EAAE,GAAG,OAAA;AAEpB,MAAI,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,WAAW,GAAG;AAClE,WAAO,OAAO;AAAA,EAChB;AAEA,MAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU;AAC9D,UAAM,aAAkC,CAAA;AACxC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO;AAAA,MAChC,OAAO;AAAA,IAAA,GACN;AACD,iBAAW,GAAG,IACZ,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,oBAAoB,KAAK,IACzB;AAAA,IACR;AACA,WAAO,aAAa;AAAA,EACtB;AAEA,MACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAC3B;AACA,WAAO,QAAQ,oBAAoB,OAAO,KAAK;AAAA,EACjD;AAGA,aAAW,WAAW,CAAC,SAAS,SAAS,OAAO,GAAY;AAC1D,QAAI,MAAM,QAAQ,OAAO,OAAO,CAAC,GAAG;AAClC,aAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAAA,QAAI,CAAC,UACrC,oBAAoB,KAAK;AAAA,MAAA;AAAA,IAE7B;AAAA,EACF;AAGA,MACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAC1C;AACA,WAAO,uBAAuB;AAAA,MAC5B,OAAO;AAAA,IAAA;AAAA,EAEX;AAEA,SAAO;AACT;AAUA,SAAS,uBACP,QACqB;AACrB,QAAM,SACJ,OAAO,SAAS,YAAY,CAAC,OAAO,aAChC,EAAE,GAAG,QAAQ,YAAY,CAAA,EAAC,IAC1B,EAAE,GAAG,OAAA;AAEX,MAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU;AAC9D,WAAO,aAAa,OAAO;AAAA,MACzB,OAAO,QAAQ,OAAO,UAAiC,EAAE;AAAA,QACvD,CAAC,CAAC,KAAK,KAAK,MAAM;AAAA,UAChB;AAAA,UACA,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,uBAAuB,KAAK,IAC5B;AAAA,QAAA;AAAA,MACN;AAAA,IACF;AAAA,EAEJ;AAEA,MACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAC3B;AACA,WAAO,QAAQ,uBAAuB,OAAO,KAAK;AAAA,EACpD;AAEA,aAAW,WAAW,CAAC,SAAS,SAAS,OAAO,GAAY;AAC1D,UAAM,SAAS,OAAO,OAAO;AAC7B,QAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,aAAO,OAAO,IAAI,OAAO;AAAA,QAAI,CAAC,UAC5B,OAAO,UAAU,YAAY,UAAU,OACnC,uBAAuB,KAA4B,IACnD;AAAA,MAAA;AAAA,IAER;AAAA,EACF;AAEA,MACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAC1C;AACA,WAAO,uBAAuB;AAAA,MAC5B,OAAO;AAAA,IAAA;AAAA,EAEX;AAEA,SAAO;AACT;AAkBO,SAAS,mCACd,QACA,mBAAkC,IACb;AAGrB,QAAM,aAAa,uBAAuB,MAAM;AAEhD,QAAM,SAAS,+BAA+B,YAAY,gBAAgB;AAG1E,SAAO,oBAAoB,MAAM;AACnC;"}