@tanstack/ai-groq 0.6.0 → 0.6.2

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

@@ -31,6 +31,12 @@ export declare class GroqTextAdapter<TModel extends (typeof GROQ_CHAT_MODELS)[nu
     readonly kind: "text";
     readonly name: "groq";
     constructor(config: GroqTextConfig, model: TModel);
+    protected extractRejectedToolCall(rawEvent: unknown, fallbackMessage: string): {
+        toolName: string;
+        arguments: string;
+        input?: unknown;
+        error: string;
+    } | undefined;
     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;

package/dist/esm/adapters/text.js

@@ -22,6 +22,35 @@ var GroqTextAdapter = class extends OpenAIBaseChatCompletionsTextAdapter {
 	constructor(config, model) {
 		super(model, "groq", new OpenAI(withGroqDefaults(config)));
 	}
+	extractRejectedToolCall(rawEvent, fallbackMessage) {
+		if (!isRecord(rawEvent) || rawEvent.code !== "tool_use_failed" || typeof rawEvent.failed_generation !== "string") return;
+		let failedGeneration;
+		try {
+			failedGeneration = JSON.parse(rawEvent.failed_generation);
+		} catch {
+			return;
+		}
+		if (!isRecord(failedGeneration) || typeof failedGeneration.name !== "string" || failedGeneration.name.trim().length === 0) return;
+		const rawArguments = failedGeneration.arguments;
+		let argumentsJson;
+		let input;
+		if (typeof rawArguments === "string") {
+			argumentsJson = rawArguments;
+			try {
+				const parsed = JSON.parse(rawArguments);
+				if (isRecord(parsed)) input = parsed;
+			} catch {}
+		} else if (isRecord(rawArguments)) {
+			argumentsJson = JSON.stringify(rawArguments);
+			input = rawArguments;
+		} else return;
+		return {
+			toolName: failedGeneration.name,
+			arguments: argumentsJson,
+			...input !== void 0 && { input },
+			error: typeof rawEvent.message === "string" && rawEvent.message.length > 0 ? rawEvent.message : fallbackMessage
+		};
+	}
 	makeStructuredOutputCompatible(schema, originalRequired) {
 		return makeGroqStructuredOutputCompatible(schema, originalRequired);
 	}
@@ -51,6 +80,9 @@ var GroqTextAdapter = class extends OpenAIBaseChatCompletionsTextAdapter {
 		return false;
 	}
 };
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 /**
 * Promotes Groq's non-standard `x_groq.usage` to the standard `chunk.usage`
 * slot the base reads. Pass-through for chunks that already carry usage at

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

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"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/client'\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"],"mappings":";;;;;;;;;;;;;;;;;;AA0CA,IAAa,kBAAb,cAOU,qCAMR;CACA,OAAyB;CACzB,OAAyB;CAEzB,YAAY,QAAwB,OAAe;EACjD,MAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;CAC3D;CAEA,+BACE,QACA,kBACqB;EACrB,OAAO,mCAAmC,QAAQ,gBAAgB;CACpE;CAEA,OAA0B,oBACxB,QACA,SACA,WAMA;EACA,OAAO,MAAM,oBACX,iBAAiB,MAAM,GACvB,SACA,SACF;CACF;;;;;;;;CASA,iBACE,OAC8B;EAC9B,MAAM,QAAQ,MAAM,QAAQ,EAAE,EAAE;EAGhC,MAAM,MAAM,OAAO,aAAa,OAAO;EACvC,IAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,GAC1C,OAAO,EAAE,MAAM,IAAI;CAGvB;;;;;;;;CASA,iCAAmD;EACjD,OAAO;CACT;AACF;;;;;;AAOA,gBAAgB,iBACd,QAC4D;CAC5D,WAAW,MAAM,SAAS,QAAQ;EAChC,MAAM,YAAY;EAGlB,IAAI,CAAC,MAAM,SAAS,UAAU,QAAQ,OACpC,MAAM;GAAE,GAAG;GAAO,OAAO,UAAU,OAAO;EAAM;OAEhD,MAAM;CAEV;AACF;;;;;;;;;AAUA,SAAgB,eAGd,OACA,QACA,QACyB;CACzB,OAAO,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACzD;;;;;;;;;AAUA,SAAgB,SACd,OACA,QACyB;CAEzB,OAAO,eAAe,OADP,qBACc,GAAQ,MAAM;AAC7C"}
+{"version":3,"file":"text.js","names":[],"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/client'\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 extractRejectedToolCall(\n    rawEvent: unknown,\n    fallbackMessage: string,\n  ):\n    | {\n        toolName: string\n        arguments: string\n        input?: unknown\n        error: string\n      }\n    | undefined {\n    if (\n      !isRecord(rawEvent) ||\n      rawEvent.code !== 'tool_use_failed' ||\n      typeof rawEvent.failed_generation !== 'string'\n    ) {\n      return undefined\n    }\n\n    let failedGeneration: unknown\n    try {\n      failedGeneration = JSON.parse(rawEvent.failed_generation)\n    } catch {\n      return undefined\n    }\n    if (\n      !isRecord(failedGeneration) ||\n      typeof failedGeneration.name !== 'string' ||\n      failedGeneration.name.trim().length === 0\n    ) {\n      return undefined\n    }\n\n    const rawArguments = failedGeneration.arguments\n    let argumentsJson: string\n    let input: unknown\n    if (typeof rawArguments === 'string') {\n      argumentsJson = rawArguments\n      try {\n        const parsed: unknown = JSON.parse(rawArguments)\n        if (isRecord(parsed)) input = parsed\n      } catch {\n        // The provider-rejected call remains non-executable with its raw input.\n      }\n    } else if (isRecord(rawArguments)) {\n      argumentsJson = JSON.stringify(rawArguments)\n      input = rawArguments\n    } else {\n      return undefined\n    }\n\n    return {\n      toolName: failedGeneration.name,\n      arguments: argumentsJson,\n      ...(input !== undefined && { input }),\n      error:\n        typeof rawEvent.message === 'string' && rawEvent.message.length > 0\n          ? rawEvent.message\n          : fallbackMessage,\n    }\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\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\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"],"mappings":";;;;;;;;;;;;;;;;;;AA0CA,IAAa,kBAAb,cAOU,qCAMR;CACA,OAAyB;CACzB,OAAyB;CAEzB,YAAY,QAAwB,OAAe;EACjD,MAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;CAC3D;CAEA,wBACE,UACA,iBAQY;EACZ,IACE,CAAC,SAAS,QAAQ,KAClB,SAAS,SAAS,qBAClB,OAAO,SAAS,sBAAsB,UAEtC;EAGF,IAAI;EACJ,IAAI;GACF,mBAAmB,KAAK,MAAM,SAAS,iBAAiB;EAC1D,QAAQ;GACN;EACF;EACA,IACE,CAAC,SAAS,gBAAgB,KAC1B,OAAO,iBAAiB,SAAS,YACjC,iBAAiB,KAAK,KAAK,CAAC,CAAC,WAAW,GAExC;EAGF,MAAM,eAAe,iBAAiB;EACtC,IAAI;EACJ,IAAI;EACJ,IAAI,OAAO,iBAAiB,UAAU;GACpC,gBAAgB;GAChB,IAAI;IACF,MAAM,SAAkB,KAAK,MAAM,YAAY;IAC/C,IAAI,SAAS,MAAM,GAAG,QAAQ;GAChC,QAAQ,CAER;EACF,OAAO,IAAI,SAAS,YAAY,GAAG;GACjC,gBAAgB,KAAK,UAAU,YAAY;GAC3C,QAAQ;EACV,OACE;EAGF,OAAO;GACL,UAAU,iBAAiB;GAC3B,WAAW;GACX,GAAI,UAAU,KAAA,KAAa,EAAE,MAAM;GACnC,OACE,OAAO,SAAS,YAAY,YAAY,SAAS,QAAQ,SAAS,IAC9D,SAAS,UACT;EACR;CACF;CAEA,+BACE,QACA,kBACqB;EACrB,OAAO,mCAAmC,QAAQ,gBAAgB;CACpE;CAEA,OAA0B,oBACxB,QACA,SACA,WAMA;EACA,OAAO,MAAM,oBACX,iBAAiB,MAAM,GACvB,SACA,SACF;CACF;;;;;;;;CASA,iBACE,OAC8B;EAC9B,MAAM,QAAQ,MAAM,QAAQ,EAAE,EAAE;EAGhC,MAAM,MAAM,OAAO,aAAa,OAAO;EACvC,IAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,GAC1C,OAAO,EAAE,MAAM,IAAI;CAGvB;;;;;;;;CASA,iCAAmD;EACjD,OAAO;CACT;AACF;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;;;AAOA,gBAAgB,iBACd,QAC4D;CAC5D,WAAW,MAAM,SAAS,QAAQ;EAChC,MAAM,YAAY;EAGlB,IAAI,CAAC,MAAM,SAAS,UAAU,QAAQ,OACpC,MAAM;GAAE,GAAG;GAAO,OAAO,UAAU,OAAO;EAAM;OAEhD,MAAM;CAEV;AACF;;;;;;;;;AAUA,SAAgB,eAGd,OACA,QACA,QACyB;CACzB,OAAO,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACzD;;;;;;;;;AAUA,SAAgB,SACd,OACA,QACyB;CAEzB,OAAO,eAAe,OADP,qBACc,GAAQ,MAAM;AAC7C"}

package/dist/esm/adapters/tts.js

@@ -49,7 +49,8 @@ var GroqTTSAdapter = class extends BaseTTSAdapter {
 				provider: this.name,
 				model
 			});
-			const base64 = arrayBufferToBase64(await (await this.client.audio.speech.create(request)).arrayBuffer());
+			const arrayBuffer = await (await this.client.audio.speech.create(request)).arrayBuffer();
+			const base64 = arrayBufferToBase64(arrayBuffer);
 			const outputFormat = request.response_format ?? "wav";
 			const contentType = this.getContentType(outputFormat);
 			return {

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

@@ -1 +1 @@
-{"version":3,"file":"tts.js","names":[],"sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { arrayBufferToBase64, generateId } from '@tanstack/ai-utils'\nimport { getGroqApiKeyFromEnv, withGroqDefaults } from '../utils/client'\nimport { validateAudioInput } from '../audio/audio-provider-options'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GroqTTSModel } from '../model-meta'\nimport type { GroqTTSProviderOptions } from '../audio/tts-provider-options'\nimport type { GroqClientConfig } from '../utils/client'\n\n/**\n * Configuration for Groq TTS adapter\n */\nexport interface GroqTTSConfig extends GroqClientConfig {}\n\n/**\n * Groq Text-to-Speech Adapter\n *\n * Tree-shakeable adapter for Groq TTS functionality. Groq exposes an\n * OpenAI-compatible `/audio/speech` endpoint, so the adapter drives it with\n * the OpenAI SDK via a `baseURL` override (the same pattern as the Groq text\n * adapter).\n *\n * Supports `canopylabs/orpheus-v1-english` and\n * `canopylabs/orpheus-arabic-saudi`.\n *\n * Features:\n * - English voices: autumn(f), diana(f), hannah(f), austin(m), daniel(m), troy(m)\n * - Arabic voices: fahad(m), sultan(m), lulwa(f), noura(f)\n * - Output formats: flac, mp3, mulaw, ogg, wav (default wav)\n * - Speed control\n * - Configurable sample rate via `modelOptions`\n */\nexport class GroqTTSAdapter<TModel extends GroqTTSModel> extends BaseTTSAdapter<\n  TModel,\n  GroqTTSProviderOptions\n> {\n  readonly name = 'groq' as const\n\n  protected client: OpenAI\n\n  constructor(config: GroqTTSConfig, model: TModel) {\n    super(model, {})\n    this.client = new OpenAI(withGroqDefaults(config))\n  }\n\n  async generateSpeech(\n    options: TTSOptions<GroqTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { model, text, voice, format, speed, modelOptions } = options\n\n    validateAudioInput({ input: text, model: this.model })\n\n    // Spreading optional inputs conditionally keeps the request compatible\n    // with the vendor SDK shape under exactOptionalPropertyTypes. `sample_rate`\n    // is a Groq-only body field carried via modelOptions.\n    const request: OpenAI_SDK.Audio.SpeechCreateParams = {\n      model,\n      input: text,\n      voice: voice ?? 'autumn',\n      response_format: format ?? 'wav',\n      ...(speed !== undefined && { speed }),\n      ...(modelOptions ?? {}),\n    }\n\n    try {\n      options.logger.request(\n        `activity=tts provider=${this.name} model=${model} format=${request.response_format ?? 'default'} voice=${request.voice}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.audio.speech.create(request)\n\n      const arrayBuffer = await response.arrayBuffer()\n      const base64 = arrayBufferToBase64(arrayBuffer)\n\n      const outputFormat = request.response_format ?? 'wav'\n      const contentType = this.getContentType(outputFormat)\n\n      return {\n        id: generateId(this.name),\n        model,\n        audio: base64,\n        format: outputFormat,\n        contentType,\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      options.logger.errors(`${this.name}.generateSpeech fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateSpeech failed`),\n        source: `${this.name}.generateSpeech`,\n      })\n      throw error\n    }\n  }\n\n  private getContentType(format: string): string {\n    const contentTypes: Record<string, string> = {\n      flac: 'audio/flac',\n      mp3: 'audio/mpeg',\n      mulaw: 'audio/basic',\n      ogg: 'audio/ogg',\n      wav: 'audio/wav',\n    }\n    return contentTypes[format] || 'audio/wav'\n  }\n}\n\n/**\n * Creates a Groq speech adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'canopylabs/orpheus-v1-english')\n * @param apiKey - Your Groq API key\n * @param config - Optional additional configuration\n * @returns Configured Groq speech adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGroqSpeech('canopylabs/orpheus-v1-english', 'gsk_...')\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello, world!',\n *   voice: 'autumn',\n * })\n * ```\n */\nexport function createGroqSpeech<TModel extends GroqTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GroqTTSConfig, 'apiKey'>,\n): GroqTTSAdapter<TModel> {\n  return new GroqTTSAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Groq speech adapter with automatic API key detection from\n * environment variables.\n *\n * Looks for `GROQ_API_KEY` in the environment.\n *\n * @param model - The model name (e.g., 'canopylabs/orpheus-v1-english')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Groq speech adapter instance with resolved types\n * @throws Error if GROQ_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * const adapter = groqSpeech('canopylabs/orpheus-v1-english')\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Welcome to TanStack AI!',\n *   voice: 'autumn',\n *   format: 'wav',\n * })\n * ```\n */\nexport function groqSpeech<TModel extends GroqTTSModel>(\n  model: TModel,\n  config?: Omit<GroqTTSConfig, 'apiKey'>,\n): GroqTTSAdapter<TModel> {\n  const apiKey = getGroqApiKeyFromEnv()\n  return createGroqSpeech(model, apiKey, config)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,iBAAb,cAAiE,eAG/D;CACA,OAAgB;CAEhB;CAEA,YAAY,QAAuB,OAAe;EAChD,MAAM,OAAO,CAAC,CAAC;EACf,KAAK,SAAS,IAAI,OAAO,iBAAiB,MAAM,CAAC;CACnD;CAEA,MAAM,eACJ,SACoB;EACpB,MAAM,EAAE,OAAO,MAAM,OAAO,QAAQ,OAAO,iBAAiB;EAE5D,mBAAmB;GAAE,OAAO;GAAM,OAAO,KAAK;EAAM,CAAC;EAKrD,MAAM,UAA+C;GACnD;GACA,OAAO;GACP,OAAO,SAAS;GAChB,iBAAiB,UAAU;GAC3B,GAAI,UAAU,KAAA,KAAa,EAAE,MAAM;GACnC,GAAI,gBAAgB,CAAC;EACvB;EAEA,IAAI;GACF,QAAQ,OAAO,QACb,yBAAyB,KAAK,KAAK,SAAS,MAAM,UAAU,QAAQ,mBAAmB,UAAU,SAAS,QAAQ,SAClH;IAAE,UAAU,KAAK;IAAM;GAAM,CAC/B;GAIA,MAAM,SAAS,oBAAoB,OADT,MAFH,KAAK,OAAO,MAAM,OAAO,OAAO,OAAO,EAAA,CAE3B,YAAY,CACD;GAE9C,MAAM,eAAe,QAAQ,mBAAmB;GAChD,MAAM,cAAc,KAAK,eAAe,YAAY;GAEpD,OAAO;IACL,IAAI,WAAW,KAAK,IAAI;IACxB;IACA,OAAO;IACP,QAAQ;IACR;GACF;EACF,SAAS,OAAgB;GAGvB,QAAQ,OAAO,OAAO,GAAG,KAAK,KAAK,wBAAwB;IACzD,OAAO,kBAAkB,OAAO,GAAG,KAAK,KAAK,uBAAuB;IACpE,QAAQ,GAAG,KAAK,KAAK;GACvB,CAAC;GACD,MAAM;EACR;CACF;CAEA,eAAuB,QAAwB;EAQ7C,OAAO;GANL,MAAM;GACN,KAAK;GACL,OAAO;GACP,KAAK;GACL,KAAK;EAEA,EAAa,WAAW;CACjC;AACF;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,iBACd,OACA,QACA,QACwB;CACxB,OAAO,IAAI,eAAe;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACxD;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,WACd,OACA,QACwB;CAExB,OAAO,iBAAiB,OADT,qBACgB,GAAQ,MAAM;AAC/C"}
+{"version":3,"file":"tts.js","names":[],"sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { arrayBufferToBase64, generateId } from '@tanstack/ai-utils'\nimport { getGroqApiKeyFromEnv, withGroqDefaults } from '../utils/client'\nimport { validateAudioInput } from '../audio/audio-provider-options'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GroqTTSModel } from '../model-meta'\nimport type { GroqTTSProviderOptions } from '../audio/tts-provider-options'\nimport type { GroqClientConfig } from '../utils/client'\n\n/**\n * Configuration for Groq TTS adapter\n */\nexport interface GroqTTSConfig extends GroqClientConfig {}\n\n/**\n * Groq Text-to-Speech Adapter\n *\n * Tree-shakeable adapter for Groq TTS functionality. Groq exposes an\n * OpenAI-compatible `/audio/speech` endpoint, so the adapter drives it with\n * the OpenAI SDK via a `baseURL` override (the same pattern as the Groq text\n * adapter).\n *\n * Supports `canopylabs/orpheus-v1-english` and\n * `canopylabs/orpheus-arabic-saudi`.\n *\n * Features:\n * - English voices: autumn(f), diana(f), hannah(f), austin(m), daniel(m), troy(m)\n * - Arabic voices: fahad(m), sultan(m), lulwa(f), noura(f)\n * - Output formats: flac, mp3, mulaw, ogg, wav (default wav)\n * - Speed control\n * - Configurable sample rate via `modelOptions`\n */\nexport class GroqTTSAdapter<TModel extends GroqTTSModel> extends BaseTTSAdapter<\n  TModel,\n  GroqTTSProviderOptions\n> {\n  readonly name = 'groq' as const\n\n  protected client: OpenAI\n\n  constructor(config: GroqTTSConfig, model: TModel) {\n    super(model, {})\n    this.client = new OpenAI(withGroqDefaults(config))\n  }\n\n  async generateSpeech(\n    options: TTSOptions<GroqTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { model, text, voice, format, speed, modelOptions } = options\n\n    validateAudioInput({ input: text, model: this.model })\n\n    // Spreading optional inputs conditionally keeps the request compatible\n    // with the vendor SDK shape under exactOptionalPropertyTypes. `sample_rate`\n    // is a Groq-only body field carried via modelOptions.\n    const request: OpenAI_SDK.Audio.SpeechCreateParams = {\n      model,\n      input: text,\n      voice: voice ?? 'autumn',\n      response_format: format ?? 'wav',\n      ...(speed !== undefined && { speed }),\n      ...(modelOptions ?? {}),\n    }\n\n    try {\n      options.logger.request(\n        `activity=tts provider=${this.name} model=${model} format=${request.response_format ?? 'default'} voice=${request.voice}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.audio.speech.create(request)\n\n      const arrayBuffer = await response.arrayBuffer()\n      const base64 = arrayBufferToBase64(arrayBuffer)\n\n      const outputFormat = request.response_format ?? 'wav'\n      const contentType = this.getContentType(outputFormat)\n\n      return {\n        id: generateId(this.name),\n        model,\n        audio: base64,\n        format: outputFormat,\n        contentType,\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      options.logger.errors(`${this.name}.generateSpeech fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateSpeech failed`),\n        source: `${this.name}.generateSpeech`,\n      })\n      throw error\n    }\n  }\n\n  private getContentType(format: string): string {\n    const contentTypes: Record<string, string> = {\n      flac: 'audio/flac',\n      mp3: 'audio/mpeg',\n      mulaw: 'audio/basic',\n      ogg: 'audio/ogg',\n      wav: 'audio/wav',\n    }\n    return contentTypes[format] || 'audio/wav'\n  }\n}\n\n/**\n * Creates a Groq speech adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'canopylabs/orpheus-v1-english')\n * @param apiKey - Your Groq API key\n * @param config - Optional additional configuration\n * @returns Configured Groq speech adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGroqSpeech('canopylabs/orpheus-v1-english', 'gsk_...')\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello, world!',\n *   voice: 'autumn',\n * })\n * ```\n */\nexport function createGroqSpeech<TModel extends GroqTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GroqTTSConfig, 'apiKey'>,\n): GroqTTSAdapter<TModel> {\n  return new GroqTTSAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Groq speech adapter with automatic API key detection from\n * environment variables.\n *\n * Looks for `GROQ_API_KEY` in the environment.\n *\n * @param model - The model name (e.g., 'canopylabs/orpheus-v1-english')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Groq speech adapter instance with resolved types\n * @throws Error if GROQ_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * const adapter = groqSpeech('canopylabs/orpheus-v1-english')\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Welcome to TanStack AI!',\n *   voice: 'autumn',\n *   format: 'wav',\n * })\n * ```\n */\nexport function groqSpeech<TModel extends GroqTTSModel>(\n  model: TModel,\n  config?: Omit<GroqTTSConfig, 'apiKey'>,\n): GroqTTSAdapter<TModel> {\n  const apiKey = getGroqApiKeyFromEnv()\n  return createGroqSpeech(model, apiKey, config)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,iBAAb,cAAiE,eAG/D;CACA,OAAgB;CAEhB;CAEA,YAAY,QAAuB,OAAe;EAChD,MAAM,OAAO,CAAC,CAAC;EACf,KAAK,SAAS,IAAI,OAAO,iBAAiB,MAAM,CAAC;CACnD;CAEA,MAAM,eACJ,SACoB;EACpB,MAAM,EAAE,OAAO,MAAM,OAAO,QAAQ,OAAO,iBAAiB;EAE5D,mBAAmB;GAAE,OAAO;GAAM,OAAO,KAAK;EAAM,CAAC;EAKrD,MAAM,UAA+C;GACnD;GACA,OAAO;GACP,OAAO,SAAS;GAChB,iBAAiB,UAAU;GAC3B,GAAI,UAAU,KAAA,KAAa,EAAE,MAAM;GACnC,GAAI,gBAAgB,CAAC;EACvB;EAEA,IAAI;GACF,QAAQ,OAAO,QACb,yBAAyB,KAAK,KAAK,SAAS,MAAM,UAAU,QAAQ,mBAAmB,UAAU,SAAS,QAAQ,SAClH;IAAE,UAAU,KAAK;IAAM;GAAM,CAC/B;GAGA,MAAM,cAAc,OAAM,MAFH,KAAK,OAAO,MAAM,OAAO,OAAO,OAAO,EAAA,CAE3B,YAAY;GAC/C,MAAM,SAAS,oBAAoB,WAAW;GAE9C,MAAM,eAAe,QAAQ,mBAAmB;GAChD,MAAM,cAAc,KAAK,eAAe,YAAY;GAEpD,OAAO;IACL,IAAI,WAAW,KAAK,IAAI;IACxB;IACA,OAAO;IACP,QAAQ;IACR;GACF;EACF,SAAS,OAAgB;GAGvB,QAAQ,OAAO,OAAO,GAAG,KAAK,KAAK,wBAAwB;IACzD,OAAO,kBAAkB,OAAO,GAAG,KAAK,KAAK,uBAAuB;IACpE,QAAQ,GAAG,KAAK,KAAK;GACvB,CAAC;GACD,MAAM;EACR;CACF;CAEA,eAAuB,QAAwB;EAQ7C,OAAO;GANL,MAAM;GACN,KAAK;GACL,OAAO;GACP,KAAK;GACL,KAAK;EAEA,EAAa,WAAW;CACjC;AACF;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,iBACd,OACA,QACA,QACwB;CACxB,OAAO,IAAI,eAAe;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACxD;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,WACd,OACA,QACwB;CAExB,OAAO,iBAAiB,OADT,qBACgB,GAAQ,MAAM;AAC/C"}

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

@@ -65,7 +65,8 @@ function normalizeObjectSchemas(schema) {
 * @returns Transformed schema compatible with Groq structured output
 */
 function makeGroqStructuredOutputCompatible(schema, originalRequired = []) {
-	return removeEmptyRequired(makeStructuredOutputCompatible(normalizeObjectSchemas(schema), originalRequired));
+	const normalised = normalizeObjectSchemas(schema);
+	return removeEmptyRequired(makeStructuredOutputCompatible(normalised, originalRequired));
 }
 //#endregion
 export { makeGroqStructuredOutputCompatible };

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

@@ -1 +1 @@
-{"version":3,"file":"schema-converter.js","names":[],"sources":["../../../src/utils/schema-converter.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '@tanstack/openai-base'\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"],"mappings":";;;;;;;AAOA,SAAS,oBAAoB,QAAkD;CAC7E,MAAM,SAAS,EAAE,GAAG,OAAO;CAE3B,IAAI,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,WAAW,GAC/D,OAAO,OAAO;CAGhB,IAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU;EAC9D,MAAM,aAAkC,CAAC;EACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAChC,OAAO,UACT,GACE,WAAW,OACT,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,oBAAoB,KAAK,IACzB;EAER,OAAO,aAAa;CACtB;CAEA,IACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAE3B,OAAO,QAAQ,oBAAoB,OAAO,KAAK;CAIjD,KAAK,MAAM,WAAW;EAAC;EAAS;EAAS;CAAO,GAC9C,IAAI,MAAM,QAAQ,OAAO,QAAQ,GAC/B,OAAO,WAAW,OAAO,QAAQ,CAAC,KAAK,UACrC,oBAAoB,KAAK,CAC3B;CAKJ,IACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAE1C,OAAO,uBAAuB,oBAC5B,OAAO,oBACT;CAGF,OAAO;AACT;;;;;;;;;AAUA,SAAS,uBACP,QACqB;CACrB,MAAM,SACJ,OAAO,SAAS,YAAY,CAAC,OAAO,aAChC;EAAE,GAAG;EAAQ,YAAY,CAAC;CAAE,IAC5B,EAAE,GAAG,OAAO;CAElB,IAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UACpD,OAAO,aAAa,OAAO,YACzB,OAAO,QAAQ,OAAO,UAAiC,CAAC,CAAC,KACtD,CAAC,KAAK,WAAW,CAChB,KACA,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,uBAAuB,KAAK,IAC5B,KACN,CACF,CACF;CAGF,IACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAE3B,OAAO,QAAQ,uBAAuB,OAAO,KAAK;CAGpD,KAAK,MAAM,WAAW;EAAC;EAAS;EAAS;CAAO,GAAY;EAC1D,MAAM,SAAS,OAAO;EACtB,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,WAAW,OAAO,KAAK,UAC5B,OAAO,UAAU,YAAY,UAAU,OACnC,uBAAuB,KAA4B,IACnD,KACN;CAEJ;CAEA,IACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAE1C,OAAO,uBAAuB,uBAC5B,OAAO,oBACT;CAGF,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,SAAgB,mCACd,QACA,mBAAkC,CAAC,GACd;CAQrB,OAAO,oBAHQ,+BAFI,uBAAuB,MAEI,GAAY,gBAG/B,CAAM;AACnC"}
+{"version":3,"file":"schema-converter.js","names":[],"sources":["../../../src/utils/schema-converter.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '@tanstack/openai-base'\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"],"mappings":";;;;;;;AAOA,SAAS,oBAAoB,QAAkD;CAC7E,MAAM,SAAS,EAAE,GAAG,OAAO;CAE3B,IAAI,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,WAAW,GAC/D,OAAO,OAAO;CAGhB,IAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU;EAC9D,MAAM,aAAkC,CAAC;EACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAChC,OAAO,UACT,GACE,WAAW,OACT,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,oBAAoB,KAAK,IACzB;EAER,OAAO,aAAa;CACtB;CAEA,IACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAE3B,OAAO,QAAQ,oBAAoB,OAAO,KAAK;CAIjD,KAAK,MAAM,WAAW;EAAC;EAAS;EAAS;CAAO,GAC9C,IAAI,MAAM,QAAQ,OAAO,QAAQ,GAC/B,OAAO,WAAW,OAAO,QAAQ,CAAC,KAAK,UACrC,oBAAoB,KAAK,CAC3B;CAKJ,IACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAE1C,OAAO,uBAAuB,oBAC5B,OAAO,oBACT;CAGF,OAAO;AACT;;;;;;;;;AAUA,SAAS,uBACP,QACqB;CACrB,MAAM,SACJ,OAAO,SAAS,YAAY,CAAC,OAAO,aAChC;EAAE,GAAG;EAAQ,YAAY,CAAC;CAAE,IAC5B,EAAE,GAAG,OAAO;CAElB,IAAI,OAAO,cAAc,OAAO,OAAO,eAAe,UACpD,OAAO,aAAa,OAAO,YACzB,OAAO,QAAQ,OAAO,UAAiC,CAAC,CAAC,KACtD,CAAC,KAAK,WAAW,CAChB,KACA,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAC/D,uBAAuB,KAAK,IAC5B,KACN,CACF,CACF;CAGF,IACE,OAAO,SACP,OAAO,OAAO,UAAU,YACxB,CAAC,MAAM,QAAQ,OAAO,KAAK,GAE3B,OAAO,QAAQ,uBAAuB,OAAO,KAAK;CAGpD,KAAK,MAAM,WAAW;EAAC;EAAS;EAAS;CAAO,GAAY;EAC1D,MAAM,SAAS,OAAO;EACtB,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,WAAW,OAAO,KAAK,UAC5B,OAAO,UAAU,YAAY,UAAU,OACnC,uBAAuB,KAA4B,IACnD,KACN;CAEJ;CAEA,IACE,OAAO,wBACP,OAAO,OAAO,yBAAyB,YACvC,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAE1C,OAAO,uBAAuB,uBAC5B,OAAO,oBACT;CAGF,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,SAAgB,mCACd,QACA,mBAAkC,CAAC,GACd;CAGrB,MAAM,aAAa,uBAAuB,MAAM;CAKhD,OAAO,oBAHQ,+BAA+B,YAAY,gBAG/B,CAAM;AACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -48,17 +48,17 @@
     "structured-outputs"
   ],
   "devDependencies": {
-    "@vitest/coverage-v8": "4.0.14",
-    "vite": "^8.1.4"
+    "@vitest/coverage-v8": "4.1.10",
+    "vite": "^8.2.1"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.44.0"
+    "@tanstack/ai": "^0.45.1"
   },
   "dependencies": {
     "openai": "^6.41.0",
-    "@tanstack/openai-base": "^0.9.11",
-    "@tanstack/ai-utils": "^0.4.0"
+    "@tanstack/ai-utils": "^0.4.0",
+    "@tanstack/openai-base": "^0.9.14"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/text.ts

@@ -61,6 +61,68 @@ export class GroqTextAdapter<
     super(model, 'groq', new OpenAI(withGroqDefaults(config)))
   }
 
+  protected override extractRejectedToolCall(
+    rawEvent: unknown,
+    fallbackMessage: string,
+  ):
+    | {
+        toolName: string
+        arguments: string
+        input?: unknown
+        error: string
+      }
+    | undefined {
+    if (
+      !isRecord(rawEvent) ||
+      rawEvent.code !== 'tool_use_failed' ||
+      typeof rawEvent.failed_generation !== 'string'
+    ) {
+      return undefined
+    }
+
+    let failedGeneration: unknown
+    try {
+      failedGeneration = JSON.parse(rawEvent.failed_generation)
+    } catch {
+      return undefined
+    }
+    if (
+      !isRecord(failedGeneration) ||
+      typeof failedGeneration.name !== 'string' ||
+      failedGeneration.name.trim().length === 0
+    ) {
+      return undefined
+    }
+
+    const rawArguments = failedGeneration.arguments
+    let argumentsJson: string
+    let input: unknown
+    if (typeof rawArguments === 'string') {
+      argumentsJson = rawArguments
+      try {
+        const parsed: unknown = JSON.parse(rawArguments)
+        if (isRecord(parsed)) input = parsed
+      } catch {
+        // The provider-rejected call remains non-executable with its raw input.
+      }
+    } else if (isRecord(rawArguments)) {
+      argumentsJson = JSON.stringify(rawArguments)
+      input = rawArguments
+    } else {
+      return undefined
+    }
+
+    return {
+      toolName: failedGeneration.name,
+      arguments: argumentsJson,
+      ...(input !== undefined && { input }),
+      error:
+        typeof rawEvent.message === 'string' && rawEvent.message.length > 0
+          ? rawEvent.message
+          : fallbackMessage,
+    }
+  }
+
   protected override makeStructuredOutputCompatible(
     schema: Record<string, any>,
     originalRequired?: Array<string>,
@@ -117,6 +179,10 @@ export class GroqTextAdapter<
   }
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
 /**
  * Promotes Groq's non-standard `x_groq.usage` to the standard `chunk.usage`
  * slot the base reads. Pass-through for chunks that already carry usage at