@tanstack/ai-groq 0.5.4 → 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/index.d.ts

@@ -5,6 +5,7 @@
  * Provides tree-shakeable adapters for Groq's Chat Completions API and TTS API.
  */
 export { GroqTextAdapter, createGroqText, groqText, type GroqTextConfig, type GroqTextProviderOptions, } from './adapters/text.js';
+export { createGroqSummarize, groqSummarize, type GroqSummarizeConfig, type GroqSummarizeModel, } from './adapters/summarize.js';
 export { GroqTranscriptionAdapter, createGroqTranscription, groqTranscription, type GroqTranscriptionConfig, } from './adapters/transcription.js';
 export type { GroqTranscriptionProviderOptions } from './audio/transcription-provider-options.js';
 export { GroqTTSAdapter, createGroqSpeech, groqSpeech, type GroqTTSConfig, } from './adapters/tts.js';

package/dist/esm/index.js

@@ -1,5 +1,6 @@
 import { GroqTextAdapter, createGroqText, groqText } from "./adapters/text.js";
+import { createGroqSummarize, groqSummarize } from "./adapters/summarize.js";
 import { GroqTranscriptionAdapter, createGroqTranscription, groqTranscription } from "./adapters/transcription.js";
 import { GroqTTSAdapter, createGroqSpeech, groqSpeech } from "./adapters/tts.js";
 import { GROQ_CHAT_MODELS, GROQ_TRANSCRIPTION_MODELS, GROQ_TTS_MODELS } from "./model-meta.js";
-export { GROQ_CHAT_MODELS, GROQ_TRANSCRIPTION_MODELS, GROQ_TTS_MODELS, GroqTTSAdapter, GroqTextAdapter, GroqTranscriptionAdapter, createGroqSpeech, createGroqText, createGroqTranscription, groqSpeech, groqText, groqTranscription };
+export { GROQ_CHAT_MODELS, GROQ_TRANSCRIPTION_MODELS, GROQ_TTS_MODELS, GroqTTSAdapter, GroqTextAdapter, GroqTranscriptionAdapter, createGroqSpeech, createGroqSummarize, createGroqText, createGroqTranscription, groqSpeech, groqSummarize, groqText, groqTranscription };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -53,12 +53,12 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.43.0"
+    "@tanstack/ai": "^0.44.0"
   },
   "dependencies": {
     "openai": "^6.41.0",
-    "@tanstack/ai-utils": "0.4.0",
-    "@tanstack/openai-base": "0.9.10"
+    "@tanstack/openai-base": "^0.9.11",
+    "@tanstack/ai-utils": "^0.4.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/summarize.ts

@@ -0,0 +1,77 @@
+import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'
+import { getGroqApiKeyFromEnv } from '../utils/client'
+import { GroqTextAdapter } from './text'
+import type { InferTextProviderOptions } from '@tanstack/ai/adapters'
+import type { GROQ_CHAT_MODELS } from '../model-meta'
+import type { GroqClientConfig } from '../utils/client'
+
+/**
+ * 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 function createGroqSummarize<TModel extends GroqSummarizeModel>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<GroqSummarizeConfig, 'apiKey'>,
+): ChatStreamSummarizeAdapter<
+  TModel,
+  InferTextProviderOptions<GroqTextAdapter<TModel>>
+> {
+  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..."
+ * });
+ * ```
+ */
+export function groqSummarize<TModel extends GroqSummarizeModel>(
+  model: TModel,
+  config?: Omit<GroqSummarizeConfig, 'apiKey'>,
+): ChatStreamSummarizeAdapter<
+  TModel,
+  InferTextProviderOptions<GroqTextAdapter<TModel>>
+> {
+  return createGroqSummarize(model, getGroqApiKeyFromEnv(), config)
+}

package/src/index.ts

@@ -14,6 +14,14 @@ export {
   type GroqTextProviderOptions,
 } from './adapters/text'
 
+// Summarize - thin factory functions over @tanstack/ai's ChatStreamSummarizeAdapter
+export {
+  createGroqSummarize,
+  groqSummarize,
+  type GroqSummarizeConfig,
+  type GroqSummarizeModel,
+} from './adapters/summarize'
+
 // Transcription adapter
 export {
   GroqTranscriptionAdapter,