@tanstack/ai-groq 0.5.3 → 0.6.0

package/README.md

@@ -72,6 +72,7 @@ const adapter = createGroqText('llama-3.3-70b-versatile', 'gsk_api_key')
 - ✅ Structured output (JSON Schema)
 - ✅ Function/tool calling
 - ✅ Multimodal input (text + images for vision models)
+- ✅ Summarization (`groqSummarize`)
 - ❌ Embeddings (not supported by Groq)
 - ❌ Image generation (not supported by Groq)
 

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

@@ -0,0 +1,51 @@
+import { ChatStreamSummarizeAdapter, InferTextProviderOptions } from '@tanstack/ai/adapters';
+import { GroqTextAdapter } from './text.js';
+import { GROQ_CHAT_MODELS } from '../model-meta.js';
+import { GroqClientConfig } from '../utils/client.js';
+/**
+ * Configuration for Groq summarize adapter
+ */
+export interface GroqSummarizeConfig extends GroqClientConfig {
+}
+/** Model type for Groq summarization */
+export type GroqSummarizeModel = (typeof GROQ_CHAT_MODELS)[number];
+/**
+ * Creates a Groq summarize adapter with explicit API key.
+ * Type resolution happens here at the call site.
+ *
+ * @param model - The model name (e.g., 'llama-3.3-70b-versatile')
+ * @param apiKey - Your Groq API key
+ * @param config - Optional additional configuration
+ * @returns Configured Groq summarize adapter instance with resolved types
+ *
+ * @example
+ * ```typescript
+ * const adapter = createGroqSummarize('llama-3.3-70b-versatile', "gsk_...");
+ * ```
+ */
+export declare function createGroqSummarize<TModel extends GroqSummarizeModel>(model: TModel, apiKey: string, config?: Omit<GroqSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<GroqTextAdapter<TModel>>>;
+/**
+ * Creates a Groq summarize adapter with automatic API key detection from environment variables.
+ * Type resolution happens here at the call site.
+ *
+ * Looks for `GROQ_API_KEY` in:
+ * - `process.env` (Node.js)
+ * - `window.env` (Browser with injected env)
+ *
+ * @param model - The model name (e.g., 'llama-3.3-70b-versatile')
+ * @param config - Optional configuration (excluding apiKey which is auto-detected)
+ * @returns Configured Groq summarize adapter instance with resolved types
+ * @throws Error if GROQ_API_KEY is not found in environment
+ *
+ * @example
+ * ```typescript
+ * // Automatically uses GROQ_API_KEY from environment
+ * const adapter = groqSummarize('llama-3.3-70b-versatile');
+ *
+ * await summarize({
+ *   adapter,
+ *   text: "Long article text..."
+ * });
+ * ```
+ */
+export declare function groqSummarize<TModel extends GroqSummarizeModel>(model: TModel, config?: Omit<GroqSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<GroqTextAdapter<TModel>>>;

package/dist/esm/adapters/summarize.js

@@ -0,0 +1,55 @@
+import { getGroqApiKeyFromEnv } from "../utils/client.js";
+import { GroqTextAdapter } from "./text.js";
+import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
+//#region src/adapters/summarize.ts
+/**
+* Creates a Groq summarize adapter with explicit API key.
+* Type resolution happens here at the call site.
+*
+* @param model - The model name (e.g., 'llama-3.3-70b-versatile')
+* @param apiKey - Your Groq API key
+* @param config - Optional additional configuration
+* @returns Configured Groq summarize adapter instance with resolved types
+*
+* @example
+* ```typescript
+* const adapter = createGroqSummarize('llama-3.3-70b-versatile', "gsk_...");
+* ```
+*/
+function createGroqSummarize(model, apiKey, config) {
+	return new ChatStreamSummarizeAdapter(new GroqTextAdapter({
+		apiKey,
+		...config
+	}, model), model, "groq");
+}
+/**
+* Creates a Groq summarize adapter with automatic API key detection from environment variables.
+* Type resolution happens here at the call site.
+*
+* Looks for `GROQ_API_KEY` in:
+* - `process.env` (Node.js)
+* - `window.env` (Browser with injected env)
+*
+* @param model - The model name (e.g., 'llama-3.3-70b-versatile')
+* @param config - Optional configuration (excluding apiKey which is auto-detected)
+* @returns Configured Groq summarize adapter instance with resolved types
+* @throws Error if GROQ_API_KEY is not found in environment
+*
+* @example
+* ```typescript
+* // Automatically uses GROQ_API_KEY from environment
+* const adapter = groqSummarize('llama-3.3-70b-versatile');
+*
+* await summarize({
+*   adapter,
+*   text: "Long article text..."
+* });
+* ```
+*/
+function groqSummarize(model, config) {
+	return createGroqSummarize(model, getGroqApiKeyFromEnv(), config);
+}
+//#endregion
+export { createGroqSummarize, groqSummarize };
+
+//# sourceMappingURL=summarize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","names":[],"sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getGroqApiKeyFromEnv } from '../utils/client'\nimport { GroqTextAdapter } from './text'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { GROQ_CHAT_MODELS } from '../model-meta'\nimport type { GroqClientConfig } from '../utils/client'\n\n/**\n * Configuration for Groq summarize adapter\n */\nexport interface GroqSummarizeConfig extends GroqClientConfig {}\n\n/** Model type for Groq summarization */\nexport type GroqSummarizeModel = (typeof GROQ_CHAT_MODELS)[number]\n\n/**\n * Creates a Groq summarize adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile')\n * @param apiKey - Your Groq API key\n * @param config - Optional additional configuration\n * @returns Configured Groq summarize adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGroqSummarize('llama-3.3-70b-versatile', \"gsk_...\");\n * ```\n */\nexport function createGroqSummarize<TModel extends GroqSummarizeModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GroqSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<GroqTextAdapter<TModel>>\n> {\n  return new ChatStreamSummarizeAdapter(\n    new GroqTextAdapter({ apiKey, ...config }, model),\n    model,\n    'groq',\n  )\n}\n\n/**\n * Creates a Groq summarize adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `GROQ_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'llama-3.3-70b-versatile')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Groq summarize adapter instance with resolved types\n * @throws Error if GROQ_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses GROQ_API_KEY from environment\n * const adapter = groqSummarize('llama-3.3-70b-versatile');\n *\n * await summarize({\n *   adapter,\n *   text: \"Long article text...\"\n * });\n * ```\n */\nexport function groqSummarize<TModel extends GroqSummarizeModel>(\n  model: TModel,\n  config?: Omit<GroqSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<GroqTextAdapter<TModel>>\n> {\n  return createGroqSummarize(model, getGroqApiKeyFromEnv(), config)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,SAAgB,oBACd,OACA,QACA,QAIA;CACA,OAAO,IAAI,2BACT,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK,GAChD,OACA,MACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,cACd,OACA,QAIA;CACA,OAAO,oBAAoB,OAAO,qBAAqB,GAAG,MAAM;AAClE"}

package/dist/esm/adapters/text.js

@@ -1,69 +1,97 @@
+import { getGroqApiKeyFromEnv, withGroqDefaults } from "../utils/client.js";
+import { makeGroqStructuredOutputCompatible } from "../utils/schema-converter.js";
 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;
-  }
-}
+//#region src/adapters/text.ts
+/**
+* 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.
+*/
+var GroqTextAdapter = class 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 };
+	}
+	/**
+	* 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;
+	}
+};
+/**
+* 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
+* the documented location.
+*/
 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;
-    }
-  }
+	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;
+	}
 }
+/**
+* Creates a Groq text adapter with explicit API key.
+*
+* @example
+* ```typescript
+* const adapter = createGroqText('llama-3.3-70b-versatile', "gsk_...");
+* ```
+*/
 function createGroqText(model, apiKey, config) {
-  return new GroqTextAdapter({ apiKey, ...config }, model);
+	return new GroqTextAdapter({
+		apiKey,
+		...config
+	}, model);
 }
+/**
+* Creates a Groq text adapter with API key from `GROQ_API_KEY`.
+*
+* @example
+* ```typescript
+* const adapter = groqText('llama-3.3-70b-versatile');
+* ```
+*/
 function groqText(model, config) {
-  const apiKey = getGroqApiKeyFromEnv();
-  return createGroqText(model, apiKey, config);
+	return createGroqText(model, getGroqApiKeyFromEnv(), config);
 }
-export {
-  GroqTextAdapter,
-  createGroqText,
-  groqText
-};
-//# sourceMappingURL=text.js.map
+//#endregion
+export { GroqTextAdapter, createGroqText, groqText };
+
+//# sourceMappingURL=text.js.map

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

@@ -1 +1 @@
-{"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/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"],"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;"}
+{"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"}