@tanstack/ai-groq 0.1.11 → 0.2.1

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

@@ -1,62 +1,22 @@
 /**
  * Groq-specific message types for the Chat Completions API.
  *
- * These type definitions mirror the Groq SDK types and are used internally
- * by the adapter to avoid tight coupling to the SDK's exported types.
+ * 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 interface ChatCompletionContentPartText {
-    /** The text content. */
-    text: string;
-    /** The type of the content part. */
-    type: 'text';
-}
-export interface ChatCompletionContentPartImage {
-    image_url: {
-        /** Either a URL of the image or the base64 encoded image data. */
-        url: string;
-        /** Specifies the detail level of the image. */
-        detail?: 'auto' | 'low' | 'high';
-    };
-    /** The type of the content part. */
-    type: 'image_url';
-}
-export interface ChatCompletionMessageToolCall {
-    /** The ID of the tool call. */
-    id: string;
-    /** The function that the model called. */
-    function: {
-        /**
-         * The arguments to call the function with, as generated by the model in JSON
-         * format. Note that the model does not always generate valid JSON, and may
-         * hallucinate parameters not defined by your function schema. Validate the
-         * arguments in your code before calling your function.
-         */
-        arguments: string;
-        /** The name of the function to call. */
-        name: string;
-    };
-    /** The type of the tool. Currently, only `function` is supported. */
-    type: 'function';
-}
-export interface ChatCompletionRequestMessageContentPartDocument {
-    document: {
-        /** The JSON document data. */
-        data: {
-            [key: string]: unknown;
-        };
-        /** Optional unique identifier for the document. */
-        id?: string | null;
-    };
-    /** The type of the content part. */
-    type: 'document';
-}
 export type FunctionParameters = {
     [key: string]: unknown;
 };
 export interface ChatCompletionNamedToolChoice {
-    Function: {
+    /** Always `function` for a named tool choice. */
+    type: 'function';
+    function: {
         /** The name of the function to call. */
         name: string;
     };
@@ -93,25 +53,6 @@ export interface FunctionDefinition {
  * - Named tool choice — forces the model to call a specific tool
  */
 export type ChatCompletionToolChoiceOption = 'none' | 'auto' | 'required' | ChatCompletionNamedToolChoice;
-export type ChatCompletionContentPart = ChatCompletionContentPartText | ChatCompletionContentPartImage | ChatCompletionRequestMessageContentPartDocument;
-export interface ChatCompletionAssistantMessageParam {
-    /** The role of the messages author, in this case `assistant`. */
-    role: 'assistant';
-    /**
-     * The contents of the assistant message. Required unless `tool_calls` or
-     * `function_call` is specified.
-     */
-    content?: string | Array<ChatCompletionContentPartText> | null;
-    /** An optional name for the participant. */
-    name?: string;
-    /**
-     * The reasoning output by the assistant if reasoning_format was set to 'parsed'.
-     * This field is only useable with qwen3 models.
-     */
-    reasoning?: string | null;
-    /** The tool calls generated by the model, such as function calls. */
-    tool_calls?: Array<ChatCompletionMessageToolCall>;
-}
 export interface ChatCompletionTool {
     /**
      * The type of the tool. `function`, `browser_search`, and `code_interpreter` are
@@ -120,34 +61,6 @@ export interface ChatCompletionTool {
     type: 'function' | 'browser_search' | 'code_interpreter' | (string & {});
     function?: FunctionDefinition;
 }
-export interface ChatCompletionToolMessageParam {
-    /** The contents of the tool message. */
-    content: string | Array<ChatCompletionContentPart>;
-    /** The role of the messages author, in this case `tool`. */
-    role: 'tool';
-    /** Tool call that this message is responding to. */
-    tool_call_id: string;
-}
-export interface ChatCompletionSystemMessageParam {
-    /** The contents of the system message. */
-    content: string | Array<ChatCompletionContentPartText>;
-    /** The role of the messages author, in this case `system`. */
-    role: 'system' | 'developer';
-    /** An optional name for the participant. */
-    name?: string;
-}
-export interface ChatCompletionUserMessageParam {
-    /** The contents of the user message. */
-    content: string | Array<ChatCompletionContentPart>;
-    /** The role of the messages author, in this case `user`. */
-    role: 'user';
-    /** An optional name for the participant. */
-    name?: string;
-}
-/**
- * Union of all supported chat completion message params.
- */
-export type ChatCompletionMessageParam = ChatCompletionSystemMessageParam | ChatCompletionUserMessageParam | ChatCompletionAssistantMessageParam | ChatCompletionToolMessageParam;
 export interface CompoundCustomModels {
     /** Custom model to use for answering. */
     answering_model?: string | null;

package/dist/esm/text/text-provider-options.d.ts

@@ -1,4 +1,4 @@
-import { ChatCompletionMessageParam, ChatCompletionTool, ChatCompletionToolChoiceOption, CompoundCustom, Document, ResponseFormatJsonObject, ResponseFormatJsonSchema, ResponseFormatText, SearchSettings } from '../message-types.js';
+import { ChatCompletionToolChoiceOption, CompoundCustom, Document, ResponseFormatJsonObject, ResponseFormatJsonSchema, ResponseFormatText, SearchSettings } from '../message-types.js';
 /**
  * Groq-specific provider options for text/chat models.
  *
@@ -148,32 +148,7 @@ export interface GroqTextProviderOptions {
      */
     user?: string | null;
 }
-/**
- * Internal options interface used for validation within the adapter.
- * Extends provider options with required fields for API requests.
- */
-export interface InternalTextProviderOptions extends GroqTextProviderOptions {
-    /** An array of messages comprising the conversation. */
-    messages: Array<ChatCompletionMessageParam>;
-    /**
-     * The model name (e.g. "llama-3.3-70b-versatile", "openai/gpt-oss-120b").
-     * @see https://console.groq.com/docs/models
-     */
-    model: string;
-    /** Whether to stream partial message deltas as server-sent events. */
-    stream?: boolean | null;
-    /**
-     * Tools the model may call (functions, code_interpreter, etc).
-     * @see https://console.groq.com/docs/tool-use
-     */
-    tools?: Array<ChatCompletionTool>;
-}
 /**
  * External provider options (what users pass in)
  */
 export type ExternalTextProviderOptions = GroqTextProviderOptions;
-/**
- * Validates text provider options.
- * Basic validation stub — Groq API handles detailed validation.
- */
-export declare function validateTextProviderOptions(_options: InternalTextProviderOptions): void;

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

@@ -1,17 +1,15 @@
-import { default as Groq_SDK, ClientOptions } from 'groq-sdk';
-export interface GroqClientConfig extends ClientOptions {
+import { ClientOptions } from 'openai';
+export interface GroqClientConfig extends Omit<ClientOptions, 'apiKey'> {
     apiKey: string;
 }
-/**
- * Creates a Groq SDK client instance
- */
-export declare function createGroqClient(config: GroqClientConfig): Groq_SDK;
 /**
  * Gets Groq API key from environment variables
  * @throws Error if GROQ_API_KEY is not found
  */
 export declare function getGroqApiKeyFromEnv(): string;
 /**
- * Generates a unique ID with a prefix
+ * 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 generateId(prefix: string): string;
+export declare function withGroqDefaults(config: GroqClientConfig): GroqClientConfig;

package/dist/esm/utils/client.js

@@ -1,17 +1,21 @@
-import { generateId as generateId$1, getApiKeyFromEnv } from "@tanstack/ai-utils";
-import Groq_SDK from "groq-sdk";
-function createGroqClient(config) {
-  return new Groq_SDK(config);
-}
+import { getApiKeyFromEnv } from "@tanstack/ai-utils";
 function getGroqApiKeyFromEnv() {
-  return getApiKeyFromEnv("GROQ_API_KEY");
+  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 generateId(prefix) {
-  return generateId$1(prefix);
+function withGroqDefaults(config) {
+  return {
+    ...config,
+    baseURL: config.baseURL || "https://api.groq.com/openai/v1"
+  };
 }
 export {
-  createGroqClient,
-  generateId,
-  getGroqApiKeyFromEnv
+  getGroqApiKeyFromEnv,
+  withGroqDefaults
 };
 //# sourceMappingURL=client.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport Groq_SDK from 'groq-sdk'\nimport type { ClientOptions } from 'groq-sdk'\n\nexport interface GroqClientConfig extends ClientOptions {\n  apiKey: string\n}\n\n/**\n * Creates a Groq SDK client instance\n */\nexport function createGroqClient(config: GroqClientConfig): Groq_SDK {\n  return new Groq_SDK(config)\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  return getApiKeyFromEnv('GROQ_API_KEY')\n}\n\n/**\n * Generates a unique ID with a prefix\n */\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n"],"names":["_generateId"],"mappings":";;AAWO,SAAS,iBAAiB,QAAoC;AACnE,SAAO,IAAI,SAAS,MAAM;AAC5B;AAMO,SAAS,uBAA+B;AAC7C,SAAO,iBAAiB,cAAc;AACxC;AAKO,SAAS,WAAW,QAAwB;AACjD,SAAOA,aAAY,MAAM;AAC3B;"}
+{"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,2 +1,3 @@
-export { createGroqClient, getGroqApiKeyFromEnv, generateId, type GroqClientConfig, } from './client.js';
+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.js.map

@@ -1 +1 @@
-{"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 * 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 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;"}
+{"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;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.1.11",
+  "version": "0.2.1",
   "type": "module",
   "description": "Groq adapter for TanStack AI",
   "author": "",
@@ -38,12 +38,12 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.16.0"
+    "@tanstack/ai": "^0.18.0"
   },
   "dependencies": {
-    "groq-sdk": "^0.37.0",
+    "openai": "^6.9.1",
     "@tanstack/ai-utils": "0.2.0",
-    "@tanstack/openai-base": "0.2.1"
+    "@tanstack/openai-base": "0.3.1"
   },
   "scripts": {
     "build": "vite build",