@tanstack/ai-grok 0.7.2 → 0.8.0

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

@@ -1,4 +1,6 @@
-import { OpenAICompatibleImageAdapter } from '@tanstack/openai-base';
+import { default as OpenAI } from 'openai';
+import { BaseImageAdapter } from '@tanstack/ai/adapters';
+import { ImageGenerationOptions, ImageGenerationResult } from '@tanstack/ai';
 import { GrokImageModel } from '../model-meta.js';
 import { GrokImageModelProviderOptionsByName, GrokImageModelSizeByName, GrokImageProviderOptions } from '../image/image-provider-options.js';
 import { GrokClientConfig } from '../utils.js';
@@ -18,16 +20,12 @@ export interface GrokImageConfig extends GrokClientConfig {
  * - Size validation per model
  * - Number of images validation
  */
-export declare class GrokImageAdapter<TModel extends GrokImageModel> extends OpenAICompatibleImageAdapter<TModel, GrokImageProviderOptions, GrokImageModelProviderOptionsByName, GrokImageModelSizeByName> {
+export declare class GrokImageAdapter<TModel extends GrokImageModel> extends BaseImageAdapter<TModel, GrokImageProviderOptions, GrokImageModelProviderOptionsByName, GrokImageModelSizeByName> {
     readonly kind: "image";
     readonly name: "grok";
+    protected client: OpenAI;
     constructor(config: GrokImageConfig, model: TModel);
-    protected validatePrompt(options: {
-        prompt: string;
-        model: string;
-    }): void;
-    protected validateImageSize(model: string, size: string | undefined): void;
-    protected validateNumberOfImages(model: string, numberOfImages: number | undefined): void;
+    generateImages(options: ImageGenerationOptions<GrokImageProviderOptions>): Promise<ImageGenerationResult>;
 }
 /**
  * Creates a Grok image adapter with explicit API key.

package/dist/esm/adapters/image.js

@@ -1,20 +1,66 @@
-import { OpenAICompatibleImageAdapter } from "@tanstack/openai-base";
+import OpenAI from "openai";
+import { BaseImageAdapter } from "@tanstack/ai/adapters";
+import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
+import { generateId } from "@tanstack/ai-utils";
 import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
 import { validatePrompt, validateImageSize, validateNumberOfImages } from "../image/image-provider-options.js";
-class GrokImageAdapter extends OpenAICompatibleImageAdapter {
+class GrokImageAdapter extends BaseImageAdapter {
   constructor(config, model) {
-    super(withGrokDefaults(config), model, "grok");
+    super(model, {});
     this.kind = "image";
     this.name = "grok";
+    this.client = new OpenAI(withGrokDefaults(config));
   }
-  validatePrompt(options) {
-    validatePrompt(options);
-  }
-  validateImageSize(model, size) {
+  async generateImages(options) {
+    const { model, prompt, numberOfImages, size, modelOptions } = options;
+    validatePrompt({ prompt });
     validateImageSize(model, size);
-  }
-  validateNumberOfImages(model, numberOfImages) {
     validateNumberOfImages(model, numberOfImages);
+    const request = {
+      model,
+      prompt,
+      n: numberOfImages ?? 1,
+      size,
+      ...modelOptions
+    };
+    try {
+      options.logger.request(
+        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? "default"}`,
+        { provider: this.name, model }
+      );
+      const response = await this.client.images.generate({
+        ...request,
+        stream: false
+      });
+      const images = (response.data ?? []).flatMap(
+        (item) => {
+          const revisedPrompt = item.revised_prompt;
+          if (item.b64_json) {
+            return [{ b64Json: item.b64_json, revisedPrompt }];
+          }
+          if (item.url) {
+            return [{ url: item.url, revisedPrompt }];
+          }
+          return [];
+        }
+      );
+      return {
+        id: generateId(this.name),
+        model,
+        images,
+        usage: response.usage ? {
+          inputTokens: response.usage.input_tokens,
+          outputTokens: response.usage.output_tokens,
+          totalTokens: response.usage.total_tokens
+        } : void 0
+      };
+    } catch (error) {
+      options.logger.errors(`${this.name}.generateImages fatal`, {
+        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
+        source: `${this.name}.generateImages`
+      });
+      throw error;
+    }
   }
 }
 function createGrokImage(model, apiKey, config) {

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { OpenAICompatibleImageAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type { GrokImageModel } from '../model-meta'\nimport type {\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageProviderOptions,\n} from '../image/image-provider-options'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok image adapter\n */\nexport interface GrokImageConfig extends GrokClientConfig {}\n\n/**\n * Grok Image Generation Adapter\n *\n * Tree-shakeable adapter for Grok image generation functionality.\n * Supports grok-2-image-1212 model.\n *\n * Features:\n * - Model-specific type-safe provider options\n * - Size validation per model\n * - Number of images validation\n */\nexport class GrokImageAdapter<\n  TModel extends GrokImageModel,\n> extends OpenAICompatibleImageAdapter<\n  TModel,\n  GrokImageProviderOptions,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName\n> {\n  readonly kind = 'image' as const\n  readonly name = 'grok' as const\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(withGrokDefaults(config), model, 'grok')\n  }\n\n  protected override validatePrompt(options: {\n    prompt: string\n    model: string\n  }): void {\n    validatePrompt(options)\n  }\n\n  protected override validateImageSize(\n    model: string,\n    size: string | undefined,\n  ): void {\n    validateImageSize(model, size)\n  }\n\n  protected override validateNumberOfImages(\n    model: string,\n    numberOfImages: number | undefined,\n  ): void {\n    validateNumberOfImages(model, numberOfImages)\n  }\n}\n\n/**\n * Creates a Grok image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokImage('grok-2-image-1212', \"xai-...\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGrokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  return new GrokImageAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok image adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok image adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokImage('grok-2-image-1212');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function grokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokImage(model, apiKey, config)\n}\n"],"names":[],"mappings":";;;AA+BO,MAAM,yBAEH,6BAKR;AAAA,EAIA,YAAY,QAAyB,OAAe;AAClD,UAAM,iBAAiB,MAAM,GAAG,OAAO,MAAM;AAJ/C,SAAS,OAAO;AAChB,SAAS,OAAO;AAAA,EAIhB;AAAA,EAEmB,eAAe,SAGzB;AACP,mBAAe,OAAO;AAAA,EACxB;AAAA,EAEmB,kBACjB,OACA,MACM;AACN,sBAAkB,OAAO,IAAI;AAAA,EAC/B;AAAA,EAEmB,uBACjB,OACA,gBACM;AACN,2BAAuB,OAAO,cAAc;AAAA,EAC9C;AACF;AAqBO,SAAS,gBACd,OACA,QACA,QAC0B;AAC1B,SAAO,IAAI,iBAAiB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAC1D;AA0BO,SAAS,UACd,OACA,QAC0B;AAC1B,QAAM,SAAS,qBAAA;AACf,SAAO,gBAAgB,OAAO,QAAQ,MAAM;AAC9C;"}
+{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GrokImageModel } from '../model-meta'\nimport type {\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageProviderOptions,\n} from '../image/image-provider-options'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok image adapter\n */\nexport interface GrokImageConfig extends GrokClientConfig {}\n\n/**\n * Grok Image Generation Adapter\n *\n * Tree-shakeable adapter for Grok image generation functionality.\n * Supports grok-2-image-1212 model.\n *\n * Features:\n * - Model-specific type-safe provider options\n * - Size validation per model\n * - Number of images validation\n */\nexport class GrokImageAdapter<\n  TModel extends GrokImageModel,\n> extends BaseImageAdapter<\n  TModel,\n  GrokImageProviderOptions,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName\n> {\n  readonly kind = 'image' as const\n  readonly name = 'grok' as const\n\n  protected client: OpenAI\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(model, {})\n    this.client = new OpenAI(withGrokDefaults(config))\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, numberOfImages, size, modelOptions } = options\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    const request: OpenAI_SDK.Images.ImageGenerateParams = {\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      size: size as OpenAI_SDK.Images.ImageGenerateParams['size'],\n      ...modelOptions,\n    }\n\n    try {\n      options.logger.request(\n        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.images.generate({\n        ...request,\n        stream: false,\n      })\n\n      const images: Array<GeneratedImage> = (response.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          const revisedPrompt = item.revised_prompt\n          if (item.b64_json) {\n            return [{ b64Json: item.b64_json, revisedPrompt }]\n          }\n          if (item.url) {\n            return [{ url: item.url, revisedPrompt }]\n          }\n          return []\n        },\n      )\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n        usage: response.usage\n          ? {\n              inputTokens: response.usage.input_tokens,\n              outputTokens: response.usage.output_tokens,\n              totalTokens: response.usage.total_tokens,\n            }\n          : undefined,\n      }\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.generateImages fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),\n        source: `${this.name}.generateImages`,\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Creates a Grok image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokImage('grok-2-image-1212', \"xai-...\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGrokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  return new GrokImageAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok image adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok image adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokImage('grok-2-image-1212');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function grokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokImage(model, apiKey, config)\n}\n"],"names":[],"mappings":";;;;;;AAwCO,MAAM,yBAEH,iBAKR;AAAA,EAMA,YAAY,QAAyB,OAAe;AAClD,UAAM,OAAO,EAAE;AANjB,SAAS,OAAO;AAChB,SAAS,OAAO;AAMd,SAAK,SAAS,IAAI,OAAO,iBAAiB,MAAM,CAAC;AAAA,EACnD;AAAA,EAEA,MAAM,eACJ,SACgC;AAChC,UAAM,EAAE,OAAO,QAAQ,gBAAgB,MAAM,iBAAiB;AAE9D,mBAAe,EAAE,OAAc,CAAC;AAChC,sBAAkB,OAAO,IAAI;AAC7B,2BAAuB,OAAO,cAAc;AAE5C,UAAM,UAAiD;AAAA,MACrD;AAAA,MACA;AAAA,MACA,GAAG,kBAAkB;AAAA,MACrB;AAAA,MACA,GAAG;AAAA,IAAA;AAGL,QAAI;AACF,cAAQ,OAAO;AAAA,QACb,2BAA2B,KAAK,IAAI,UAAU,KAAK,MAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,QAAQ,SAAS;AAAA,QACzG,EAAE,UAAU,KAAK,MAAM,MAAA;AAAA,MAAM;AAE/B,YAAM,WAAW,MAAM,KAAK,OAAO,OAAO,SAAS;AAAA,QACjD,GAAG;AAAA,QACH,QAAQ;AAAA,MAAA,CACT;AAED,YAAM,UAAiC,SAAS,QAAQ,CAAA,GAAI;AAAA,QAC1D,CAAC,SAAgC;AAC/B,gBAAM,gBAAgB,KAAK;AAC3B,cAAI,KAAK,UAAU;AACjB,mBAAO,CAAC,EAAE,SAAS,KAAK,UAAU,eAAe;AAAA,UACnD;AACA,cAAI,KAAK,KAAK;AACZ,mBAAO,CAAC,EAAE,KAAK,KAAK,KAAK,eAAe;AAAA,UAC1C;AACA,iBAAO,CAAA;AAAA,QACT;AAAA,MAAA;AAGF,aAAO;AAAA,QACL,IAAI,WAAW,KAAK,IAAI;AAAA,QACxB;AAAA,QACA;AAAA,QACA,OAAO,SAAS,QACZ;AAAA,UACE,aAAa,SAAS,MAAM;AAAA,UAC5B,cAAc,SAAS,MAAM;AAAA,UAC7B,aAAa,SAAS,MAAM;AAAA,QAAA,IAE9B;AAAA,MAAA;AAAA,IAER,SAAS,OAAgB;AACvB,cAAQ,OAAO,OAAO,GAAG,KAAK,IAAI,yBAAyB;AAAA,QACzD,OAAO,kBAAkB,OAAO,GAAG,KAAK,IAAI,wBAAwB;AAAA,QACpE,QAAQ,GAAG,KAAK,IAAI;AAAA,MAAA,CACrB;AACD,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAqBO,SAAS,gBACd,OACA,QACA,QAC0B;AAC1B,SAAO,IAAI,iBAAiB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAC1D;AA0BO,SAAS,UACd,OACA,QAC0B;AAC1B,QAAM,SAAS,qBAAA;AACf,SAAO,gBAAgB,OAAO,QAAQ,MAAM;AAC9C;"}

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

@@ -1,4 +1,5 @@
-import { OpenAICompatibleSummarizeAdapter } from '@tanstack/openai-base';
+import { ChatStreamSummarizeAdapter, InferTextProviderOptions } from '@tanstack/ai/adapters';
+import { GrokTextAdapter } from './text.js';
 import { GROK_CHAT_MODELS } from '../model-meta.js';
 import { GrokClientConfig } from '../utils.js';
 /**
@@ -6,28 +7,8 @@ import { GrokClientConfig } from '../utils.js';
  */
 export interface GrokSummarizeConfig extends GrokClientConfig {
 }
-/**
- * Grok-specific provider options for summarization
- */
-export interface GrokSummarizeProviderOptions {
-    /** Temperature for response generation (0-2) */
-    temperature?: number;
-    /** Maximum tokens in the response */
-    maxTokens?: number;
-}
 /** Model type for Grok summarization */
 export type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number];
-/**
- * Grok Summarize Adapter
- *
- * A thin wrapper around the text adapter that adds summarization-specific prompting.
- * Delegates all API calls to the GrokTextAdapter.
- */
-export declare class GrokSummarizeAdapter<TModel extends GrokSummarizeModel> extends OpenAICompatibleSummarizeAdapter<TModel, GrokSummarizeProviderOptions> {
-    readonly kind: "summarize";
-    readonly name: "grok";
-    constructor(config: GrokSummarizeConfig, model: TModel);
-}
 /**
  * Creates a Grok summarize adapter with explicit API key.
  * Type resolution happens here at the call site.
@@ -42,7 +23,7 @@ export declare class GrokSummarizeAdapter<TModel extends GrokSummarizeModel> ext
  * const adapter = createGrokSummarize('grok-3', "xai-...");
  * ```
  */
-export declare function createGrokSummarize<TModel extends GrokSummarizeModel>(model: TModel, apiKey: string, config?: Omit<GrokSummarizeConfig, 'apiKey'>): GrokSummarizeAdapter<TModel>;
+export declare function createGrokSummarize<TModel extends GrokSummarizeModel>(model: TModel, apiKey: string, config?: Omit<GrokSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<GrokTextAdapter<TModel>>>;
 /**
  * Creates a Grok summarize adapter with automatic API key detection from environment variables.
  * Type resolution happens here at the call site.
@@ -67,4 +48,4 @@ export declare function createGrokSummarize<TModel extends GrokSummarizeModel>(m
  * });
  * ```
  */
-export declare function grokSummarize<TModel extends GrokSummarizeModel>(model: TModel, config?: Omit<GrokSummarizeConfig, 'apiKey'>): GrokSummarizeAdapter<TModel>;
+export declare function grokSummarize<TModel extends GrokSummarizeModel>(model: TModel, config?: Omit<GrokSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<GrokTextAdapter<TModel>>>;

package/dist/esm/adapters/summarize.js

@@ -1,30 +1,19 @@
-import { OpenAICompatibleSummarizeAdapter } from "@tanstack/openai-base";
+import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
 import "@tanstack/ai-utils";
 import { getGrokApiKeyFromEnv } from "../utils/client.js";
+import "@tanstack/openai-base";
 import { GrokTextAdapter } from "./text.js";
-class GrokSummarizeAdapter extends OpenAICompatibleSummarizeAdapter {
-  constructor(config, model) {
-    super(
-      new GrokTextAdapter(
-        config,
-        model
-      ),
-      model,
-      "grok"
-    );
-    this.kind = "summarize";
-    this.name = "grok";
-  }
-}
 function createGrokSummarize(model, apiKey, config) {
-  return new GrokSummarizeAdapter({ apiKey, ...config }, model);
+  return new ChatStreamSummarizeAdapter(
+    new GrokTextAdapter({ apiKey, ...config }, model),
+    model,
+    "grok"
+  );
 }
 function grokSummarize(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokSummarize(model, apiKey, config);
+  return createGrokSummarize(model, getGrokApiKeyFromEnv(), config);
 }
 export {
-  GrokSummarizeAdapter,
   createGrokSummarize,
   grokSummarize
 };

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

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { OpenAICompatibleSummarizeAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv } from '../utils'\nimport { GrokTextAdapter } from './text'\nimport type { ChatStreamCapable } from '@tanstack/openai-base'\nimport type { GROK_CHAT_MODELS } from '../model-meta'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok summarize adapter\n */\nexport interface GrokSummarizeConfig extends GrokClientConfig {}\n\n/**\n * Grok-specific provider options for summarization\n */\nexport interface GrokSummarizeProviderOptions {\n  /** Temperature for response generation (0-2) */\n  temperature?: number\n  /** Maximum tokens in the response */\n  maxTokens?: number\n}\n\n/** Model type for Grok summarization */\nexport type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number]\n\n/**\n * Grok Summarize Adapter\n *\n * A thin wrapper around the text adapter that adds summarization-specific prompting.\n * Delegates all API calls to the GrokTextAdapter.\n */\nexport class GrokSummarizeAdapter<\n  TModel extends GrokSummarizeModel,\n> extends OpenAICompatibleSummarizeAdapter<\n  TModel,\n  GrokSummarizeProviderOptions\n> {\n  readonly kind = 'summarize' as const\n  readonly name = 'grok' as const\n\n  constructor(config: GrokSummarizeConfig, model: TModel) {\n    // The text adapter accepts richer provider options than the summarize adapter needs,\n    // but we only pass basic options (model, messages, systemPrompts, etc.) at call time.\n    super(\n      new GrokTextAdapter(\n        config,\n        model,\n      ) as unknown as ChatStreamCapable<GrokSummarizeProviderOptions>,\n      model,\n      'grok',\n    )\n  }\n}\n\n/**\n * Creates a Grok summarize adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok summarize adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokSummarize('grok-3', \"xai-...\");\n * ```\n */\nexport function createGrokSummarize<TModel extends GrokSummarizeModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokSummarizeConfig, 'apiKey'>,\n): GrokSummarizeAdapter<TModel> {\n  return new GrokSummarizeAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok summarize adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok summarize adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokSummarize('grok-3');\n *\n * await summarize({\n *   adapter,\n *   text: \"Long article text...\"\n * });\n * ```\n */\nexport function grokSummarize<TModel extends GrokSummarizeModel>(\n  model: TModel,\n  config?: Omit<GrokSummarizeConfig, 'apiKey'>,\n): GrokSummarizeAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokSummarize(model, apiKey, config)\n}\n"],"names":[],"mappings":";;;;AA+BO,MAAM,6BAEH,iCAGR;AAAA,EAIA,YAAY,QAA6B,OAAe;AAGtD;AAAA,MACE,IAAI;AAAA,QACF;AAAA,QACA;AAAA,MAAA;AAAA,MAEF;AAAA,MACA;AAAA,IAAA;AAZJ,SAAS,OAAO;AAChB,SAAS,OAAO;AAAA,EAahB;AACF;AAgBO,SAAS,oBACd,OACA,QACA,QAC8B;AAC9B,SAAO,IAAI,qBAAqB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAC9D;AA0BO,SAAS,cACd,OACA,QAC8B;AAC9B,QAAM,SAAS,qBAAA;AACf,SAAO,oBAAoB,OAAO,QAAQ,MAAM;AAClD;"}
+{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getGrokApiKeyFromEnv } from '../utils'\nimport { GrokTextAdapter } from './text'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { GROK_CHAT_MODELS } from '../model-meta'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Configuration for Grok summarize adapter\n */\nexport interface GrokSummarizeConfig extends GrokClientConfig {}\n\n/** Model type for Grok summarization */\nexport type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number]\n\n/**\n * Creates a Grok summarize adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok summarize adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokSummarize('grok-3', \"xai-...\");\n * ```\n */\nexport function createGrokSummarize<TModel extends GrokSummarizeModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<GrokTextAdapter<TModel>>\n> {\n  return new ChatStreamSummarizeAdapter(\n    new GrokTextAdapter({ apiKey, ...config }, model),\n    model,\n    'grok',\n  )\n}\n\n/**\n * Creates a Grok summarize adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok summarize adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokSummarize('grok-3');\n *\n * await summarize({\n *   adapter,\n *   text: \"Long article text...\"\n * });\n * ```\n */\nexport function grokSummarize<TModel extends GrokSummarizeModel>(\n  model: TModel,\n  config?: Omit<GrokSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<GrokTextAdapter<TModel>>\n> {\n  return createGrokSummarize(model, getGrokApiKeyFromEnv(), config)\n}\n"],"names":[],"mappings":";;;;;AA6BO,SAAS,oBACd,OACA,QACA,QAIA;AACA,SAAO,IAAI;AAAA,IACT,IAAI,gBAAgB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAAA,IAChD;AAAA,IACA;AAAA,EAAA;AAEJ;AA0BO,SAAS,cACd,OACA,QAIA;AACA,SAAO,oBAAoB,OAAO,qBAAA,GAAwB,MAAM;AAClE;"}

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

@@ -1,4 +1,5 @@
-import { OpenAICompatibleChatCompletionsTextAdapter } from '@tanstack/openai-base';
+import { default as OpenAI } from 'openai';
+import { OpenAIBaseChatCompletionsTextAdapter } from '@tanstack/openai-base';
 import { GROK_CHAT_MODELS, GrokChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
 import { Modality } from '@tanstack/ai';
 import { GrokMessageMetadataByModality } from '../message-types.js';
@@ -22,14 +23,24 @@ export type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../
  * Tree-shakeable adapter for Grok chat/text completion functionality.
  * Uses OpenAI-compatible Chat Completions API (not Responses API).
  *
- * Delegates implementation to {@link OpenAICompatibleChatCompletionsTextAdapter}
- * from `@tanstack/openai-base` and threads Grok-specific tool-capability typing
- * through the 5th generic of the base class.
+ * Delegates implementation to {@link OpenAIBaseChatCompletionsTextAdapter}
+ * from `@tanstack/openai-base` and threads Grok-specific tool-capability
+ * typing through the 5th generic of the base class.
  */
-export declare class GrokTextAdapter<TModel extends (typeof GROK_CHAT_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAICompatibleChatCompletionsTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
+export declare class GrokTextAdapter<TModel extends (typeof GROK_CHAT_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAIBaseChatCompletionsTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
     readonly kind: "text";
     readonly name: "grok";
     constructor(config: GrokTextConfig, model: TModel);
+    /**
+     * Surfaces xAI reasoning deltas on Grok reasoning models. The DeepSeek-style
+     * convention puts the chain-of-thought on `delta.reasoning_content`; some
+     * Grok variants also populate `delta.reasoning`. Reading both keeps
+     * reasoning flowing through the base's REASONING_* lifecycle for both
+     * `chatStream` and `structuredOutputStream`.
+     */
+    protected extractReasoning(chunk: OpenAI.Chat.Completions.ChatCompletionChunk): {
+        text: string;
+    } | undefined;
 }
 /**
  * Creates a Grok text adapter with explicit API key.

package/dist/esm/adapters/text.js

@@ -1,11 +1,27 @@
-import { OpenAICompatibleChatCompletionsTextAdapter } from "@tanstack/openai-base";
+import OpenAI from "openai";
+import { OpenAIBaseChatCompletionsTextAdapter } from "@tanstack/openai-base";
 import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
-class GrokTextAdapter extends OpenAICompatibleChatCompletionsTextAdapter {
+class GrokTextAdapter extends OpenAIBaseChatCompletionsTextAdapter {
   constructor(config, model) {
-    super(withGrokDefaults(config), model, "grok");
+    super(model, "grok", new OpenAI(withGrokDefaults(config)));
     this.kind = "text";
     this.name = "grok";
   }
+  /**
+   * Surfaces xAI reasoning deltas on Grok reasoning models. The DeepSeek-style
+   * convention puts the chain-of-thought on `delta.reasoning_content`; some
+   * Grok variants also populate `delta.reasoning`. Reading both keeps
+   * reasoning flowing through the base's REASONING_* lifecycle for both
+   * `chatStream` and `structuredOutputStream`.
+   */
+  extractReasoning(chunk) {
+    const delta = chunk.choices[0]?.delta;
+    const raw = delta?.reasoning_content ?? delta?.reasoning;
+    if (typeof raw === "string" && raw.length > 0) {
+      return { text: raw };
+    }
+    return void 0;
+  }
 }
 function createGrokText(model, apiKey, config) {
   return new GrokTextAdapter({ apiKey, ...config }, model);

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

@@ -1 +1 @@
-{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import { OpenAICompatibleChatCompletionsTextAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport type {\n  GROK_CHAT_MODELS,\n  GrokChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { Modality } from '@tanstack/ai'\nimport type { GrokMessageMetadataByModality } from '../message-types'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Resolve tool capabilities for a specific Grok model.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GrokChatModelToolCapabilitiesByName\n    ? NonNullable<GrokChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses OpenAI-compatible Chat Completions API (not Responses API).\n *\n * Delegates implementation to {@link OpenAICompatibleChatCompletionsTextAdapter}\n * from `@tanstack/openai-base` and threads Grok-specific tool-capability typing\n * through the 5th generic of the base class.\n */\nexport class GrokTextAdapter<\n  TModel extends (typeof GROK_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 OpenAICompatibleChatCompletionsTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GrokMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  readonly name = 'grok' as const\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super(withGrokDefaults(config), model, 'grok')\n  }\n}\n\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-3', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-3\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-3');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"names":[],"mappings":";;AAwCO,MAAM,wBAOH,2CAMR;AAAA,EAIA,YAAY,QAAwB,OAAe;AACjD,UAAM,iBAAiB,MAAM,GAAG,OAAO,MAAM;AAJ/C,SAAS,OAAO;AAChB,SAAS,OAAO;AAAA,EAIhB;AACF;AAiBO,SAAS,eAGd,OACA,QACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AACzD;AA0BO,SAAS,SACd,OACA,QACyB;AACzB,QAAM,SAAS,qBAAA;AACf,SAAO,eAAe,OAAO,QAAQ,MAAM;AAC7C;"}
+{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { OpenAIBaseChatCompletionsTextAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport type {\n  GROK_CHAT_MODELS,\n  GrokChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { Modality } from '@tanstack/ai'\nimport type { GrokMessageMetadataByModality } from '../message-types'\nimport type { GrokClientConfig } from '../utils'\n\n/**\n * Resolve tool capabilities for a specific Grok model.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GrokChatModelToolCapabilitiesByName\n    ? NonNullable<GrokChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses OpenAI-compatible Chat Completions API (not Responses API).\n *\n * Delegates implementation to {@link OpenAIBaseChatCompletionsTextAdapter}\n * from `@tanstack/openai-base` and threads Grok-specific tool-capability\n * typing through the 5th generic of the base class.\n */\nexport class GrokTextAdapter<\n  TModel extends (typeof GROK_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  GrokMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  readonly name = 'grok' as const\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super(model, 'grok', new OpenAI(withGrokDefaults(config)))\n  }\n\n  /**\n   * Surfaces xAI reasoning deltas on Grok reasoning models. The DeepSeek-style\n   * convention puts the chain-of-thought on `delta.reasoning_content`; some\n   * Grok variants also populate `delta.reasoning`. Reading both keeps\n   * reasoning flowing through the base's REASONING_* lifecycle for both\n   * `chatStream` and `structuredOutputStream`.\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_content ?? delta?.reasoning\n    if (typeof raw === 'string' && raw.length > 0) {\n      return { text: raw }\n    }\n    return undefined\n  }\n}\n\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-3', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-3\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-3', 'grok-4')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-3');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"names":[],"mappings":";;;AAyCO,MAAM,wBAOH,qCAMR;AAAA,EAIA,YAAY,QAAwB,OAAe;AACjD,UAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;AAJ3D,SAAS,OAAO;AAChB,SAAS,OAAO;AAAA,EAIhB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASmB,iBACjB,OAC8B;AAC9B,UAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG;AAGhC,UAAM,MAAM,OAAO,qBAAqB,OAAO;AAC/C,QAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,GAAG;AAC7C,aAAO,EAAE,MAAM,IAAA;AAAA,IACjB;AACA,WAAO;AAAA,EACT;AACF;AAiBO,SAAS,eAGd,OACA,QACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AACzD;AA0BO,SAAS,SACd,OACA,QACyB;AACzB,QAAM,SAAS,qBAAA;AACf,SAAO,eAAe,OAAO,QAAQ,MAAM;AAC7C;"}

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { GrokTextAdapter, createGrokText, grokText, type GrokTextConfig, type GrokTextProviderOptions, } from './adapters/text.js';
-export { GrokSummarizeAdapter, createGrokSummarize, grokSummarize, type GrokSummarizeConfig, type GrokSummarizeProviderOptions, type GrokSummarizeModel, } from './adapters/summarize.js';
+export { createGrokSummarize, grokSummarize, type GrokSummarizeConfig, type GrokSummarizeModel, } from './adapters/summarize.js';
 export { GrokImageAdapter, createGrokImage, grokImage, type GrokImageConfig, } from './adapters/image.js';
 export type { GrokImageProviderOptions, GrokImageModelProviderOptionsByName, } from './image/image-provider-options.js';
 export { GrokSpeechAdapter, createGrokSpeech, grokSpeech, type GrokSpeechConfig, } from './adapters/tts.js';

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 import { GrokTextAdapter, createGrokText, grokText } from "./adapters/text.js";
-import { GrokSummarizeAdapter, createGrokSummarize, grokSummarize } from "./adapters/summarize.js";
+import { createGrokSummarize, grokSummarize } from "./adapters/summarize.js";
 import { GrokImageAdapter, createGrokImage, grokImage } from "./adapters/image.js";
 import { GrokSpeechAdapter, createGrokSpeech, grokSpeech } from "./adapters/tts.js";
 import { GrokTranscriptionAdapter, createGrokTranscription, grokTranscription } from "./adapters/transcription.js";
@@ -14,7 +14,6 @@ export {
   GROK_TTS_MODELS,
   GrokImageAdapter,
   GrokSpeechAdapter,
-  GrokSummarizeAdapter,
   GrokTextAdapter,
   GrokTranscriptionAdapter,
   createGrokImage,

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

@@ -1,5 +1,6 @@
-import { OpenAICompatibleClientConfig } from '@tanstack/openai-base';
-export interface GrokClientConfig extends OpenAICompatibleClientConfig {
+import { ClientOptions } from 'openai';
+export interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {
+    apiKey: string;
 }
 /**
  * Gets Grok API key from environment variables
@@ -10,4 +11,4 @@ export declare function getGrokApiKeyFromEnv(): string;
  * Returns a Grok client config with the default xAI base URL applied
  * when not already set.
  */
-export declare function withGrokDefaults(config: GrokClientConfig): OpenAICompatibleClientConfig;
+export declare function withGrokDefaults(config: GrokClientConfig): GrokClientConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { OpenAICompatibleClientConfig } from '@tanstack/openai-base'\n\nexport interface GrokClientConfig extends OpenAICompatibleClientConfig {}\n\n/**\n * Gets Grok API key from environment variables\n * @throws Error if XAI_API_KEY is not found\n */\nexport function getGrokApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('XAI_API_KEY')\n  } catch {\n    throw new Error(\n      'XAI_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 Grok client config with the default xAI base URL applied\n * when not already set.\n */\nexport function withGrokDefaults(\n  config: GrokClientConfig,\n): OpenAICompatibleClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.x.ai/v1',\n  }\n}\n"],"names":[],"mappings":";AASO,SAAS,uBAA+B;AAC7C,MAAI;AACF,WAAO,iBAAiB,aAAa;AAAA,EACvC,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAMO,SAAS,iBACd,QAC8B;AAC9B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,WAAW;AAAA,EAAA;AAE/B;"}
+{"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 GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets Grok API key from environment variables\n * @throws Error if XAI_API_KEY is not found\n */\nexport function getGrokApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('XAI_API_KEY')\n  } catch {\n    throw new Error(\n      'XAI_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 Grok client config with the default xAI base URL applied\n * when not already set.\n */\nexport function withGrokDefaults(config: GrokClientConfig): GrokClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.x.ai/v1',\n  }\n}\n"],"names":[],"mappings":";AAWO,SAAS,uBAA+B;AAC7C,MAAI;AACF,WAAO,iBAAiB,aAAa;AAAA,EACvC,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAMO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,WAAW;AAAA,EAAA;AAE/B;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Grok (xAI) adapter for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -34,18 +34,19 @@
     "adapter"
   ],
   "dependencies": {
+    "openai": "^6.9.1",
     "@tanstack/ai-utils": "0.2.0",
-    "@tanstack/openai-base": "0.2.0"
+    "@tanstack/openai-base": "0.3.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.2.7",
-    "@tanstack/ai": "0.15.0",
-    "@tanstack/ai-client": "0.9.0"
+    "@tanstack/ai": "0.17.0",
+    "@tanstack/ai-client": "0.9.2"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.15.0"
+    "@tanstack/ai": "^0.17.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/image.ts

@@ -1,10 +1,19 @@
-import { OpenAICompatibleImageAdapter } from '@tanstack/openai-base'
+import OpenAI from 'openai'
+import { BaseImageAdapter } from '@tanstack/ai/adapters'
+import { toRunErrorPayload } from '@tanstack/ai/adapter-internals'
+import { generateId } from '@tanstack/ai-utils'
 import { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'
 import {
   validateImageSize,
   validateNumberOfImages,
   validatePrompt,
 } from '../image/image-provider-options'
+import type {
+  GeneratedImage,
+  ImageGenerationOptions,
+  ImageGenerationResult,
+} from '@tanstack/ai'
+import type OpenAI_SDK from 'openai'
 import type { GrokImageModel } from '../model-meta'
 import type {
   GrokImageModelProviderOptionsByName,
@@ -31,7 +40,7 @@ export interface GrokImageConfig extends GrokClientConfig {}
  */
 export class GrokImageAdapter<
   TModel extends GrokImageModel,
-> extends OpenAICompatibleImageAdapter<
+> extends BaseImageAdapter<
   TModel,
   GrokImageProviderOptions,
   GrokImageModelProviderOptionsByName,
@@ -40,29 +49,72 @@ export class GrokImageAdapter<
   readonly kind = 'image' as const
   readonly name = 'grok' as const
 
+  protected client: OpenAI
+
   constructor(config: GrokImageConfig, model: TModel) {
-    super(withGrokDefaults(config), model, 'grok')
+    super(model, {})
+    this.client = new OpenAI(withGrokDefaults(config))
   }
 
-  protected override validatePrompt(options: {
-    prompt: string
-    model: string
-  }): void {
-    validatePrompt(options)
-  }
+  async generateImages(
+    options: ImageGenerationOptions<GrokImageProviderOptions>,
+  ): Promise<ImageGenerationResult> {
+    const { model, prompt, numberOfImages, size, modelOptions } = options
 
-  protected override validateImageSize(
-    model: string,
-    size: string | undefined,
-  ): void {
+    validatePrompt({ prompt, model })
     validateImageSize(model, size)
-  }
-
-  protected override validateNumberOfImages(
-    model: string,
-    numberOfImages: number | undefined,
-  ): void {
     validateNumberOfImages(model, numberOfImages)
+
+    const request: OpenAI_SDK.Images.ImageGenerateParams = {
+      model,
+      prompt,
+      n: numberOfImages ?? 1,
+      size: size as OpenAI_SDK.Images.ImageGenerateParams['size'],
+      ...modelOptions,
+    }
+
+    try {
+      options.logger.request(
+        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,
+        { provider: this.name, model },
+      )
+      const response = await this.client.images.generate({
+        ...request,
+        stream: false,
+      })
+
+      const images: Array<GeneratedImage> = (response.data ?? []).flatMap(
+        (item): Array<GeneratedImage> => {
+          const revisedPrompt = item.revised_prompt
+          if (item.b64_json) {
+            return [{ b64Json: item.b64_json, revisedPrompt }]
+          }
+          if (item.url) {
+            return [{ url: item.url, revisedPrompt }]
+          }
+          return []
+        },
+      )
+
+      return {
+        id: generateId(this.name),
+        model,
+        images,
+        usage: response.usage
+          ? {
+              inputTokens: response.usage.input_tokens,
+              outputTokens: response.usage.output_tokens,
+              totalTokens: response.usage.total_tokens,
+            }
+          : undefined,
+      }
+    } catch (error: unknown) {
+      options.logger.errors(`${this.name}.generateImages fatal`, {
+        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
+        source: `${this.name}.generateImages`,
+      })
+      throw error
+    }
   }
 }
 

package/src/adapters/summarize.ts

@@ -1,7 +1,7 @@
-import { OpenAICompatibleSummarizeAdapter } from '@tanstack/openai-base'
+import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'
 import { getGrokApiKeyFromEnv } from '../utils'
 import { GrokTextAdapter } from './text'
-import type { ChatStreamCapable } from '@tanstack/openai-base'
+import type { InferTextProviderOptions } from '@tanstack/ai/adapters'
 import type { GROK_CHAT_MODELS } from '../model-meta'
 import type { GrokClientConfig } from '../utils'
 
@@ -10,48 +10,9 @@ import type { GrokClientConfig } from '../utils'
  */
 export interface GrokSummarizeConfig extends GrokClientConfig {}
 
-/**
- * Grok-specific provider options for summarization
- */
-export interface GrokSummarizeProviderOptions {
-  /** Temperature for response generation (0-2) */
-  temperature?: number
-  /** Maximum tokens in the response */
-  maxTokens?: number
-}
-
 /** Model type for Grok summarization */
 export type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number]
 
-/**
- * Grok Summarize Adapter
- *
- * A thin wrapper around the text adapter that adds summarization-specific prompting.
- * Delegates all API calls to the GrokTextAdapter.
- */
-export class GrokSummarizeAdapter<
-  TModel extends GrokSummarizeModel,
-> extends OpenAICompatibleSummarizeAdapter<
-  TModel,
-  GrokSummarizeProviderOptions
-> {
-  readonly kind = 'summarize' as const
-  readonly name = 'grok' as const
-
-  constructor(config: GrokSummarizeConfig, model: TModel) {
-    // The text adapter accepts richer provider options than the summarize adapter needs,
-    // but we only pass basic options (model, messages, systemPrompts, etc.) at call time.
-    super(
-      new GrokTextAdapter(
-        config,
-        model,
-      ) as unknown as ChatStreamCapable<GrokSummarizeProviderOptions>,
-      model,
-      'grok',
-    )
-  }
-}
-
 /**
  * Creates a Grok summarize adapter with explicit API key.
  * Type resolution happens here at the call site.
@@ -70,8 +31,15 @@ export function createGrokSummarize<TModel extends GrokSummarizeModel>(
   model: TModel,
   apiKey: string,
   config?: Omit<GrokSummarizeConfig, 'apiKey'>,
-): GrokSummarizeAdapter<TModel> {
-  return new GrokSummarizeAdapter({ apiKey, ...config }, model)
+): ChatStreamSummarizeAdapter<
+  TModel,
+  InferTextProviderOptions<GrokTextAdapter<TModel>>
+> {
+  return new ChatStreamSummarizeAdapter(
+    new GrokTextAdapter({ apiKey, ...config }, model),
+    model,
+    'grok',
+  )
 }
 
 /**
@@ -101,7 +69,9 @@ export function createGrokSummarize<TModel extends GrokSummarizeModel>(
 export function grokSummarize<TModel extends GrokSummarizeModel>(
   model: TModel,
   config?: Omit<GrokSummarizeConfig, 'apiKey'>,
-): GrokSummarizeAdapter<TModel> {
-  const apiKey = getGrokApiKeyFromEnv()
-  return createGrokSummarize(model, apiKey, config)
+): ChatStreamSummarizeAdapter<
+  TModel,
+  InferTextProviderOptions<GrokTextAdapter<TModel>>
+> {
+  return createGrokSummarize(model, getGrokApiKeyFromEnv(), config)
 }

package/src/adapters/text.ts

@@ -1,4 +1,5 @@
-import { OpenAICompatibleChatCompletionsTextAdapter } from '@tanstack/openai-base'
+import OpenAI from 'openai'
+import { OpenAIBaseChatCompletionsTextAdapter } from '@tanstack/openai-base'
 import { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'
 import type {
   GROK_CHAT_MODELS,
@@ -34,9 +35,9 @@ export type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../
  * Tree-shakeable adapter for Grok chat/text completion functionality.
  * Uses OpenAI-compatible Chat Completions API (not Responses API).
  *
- * Delegates implementation to {@link OpenAICompatibleChatCompletionsTextAdapter}
- * from `@tanstack/openai-base` and threads Grok-specific tool-capability typing
- * through the 5th generic of the base class.
+ * Delegates implementation to {@link OpenAIBaseChatCompletionsTextAdapter}
+ * from `@tanstack/openai-base` and threads Grok-specific tool-capability
+ * typing through the 5th generic of the base class.
  */
 export class GrokTextAdapter<
   TModel extends (typeof GROK_CHAT_MODELS)[number],
@@ -45,7 +46,7 @@ export class GrokTextAdapter<
     ResolveInputModalities<TModel>,
   TToolCapabilities extends ReadonlyArray<string> =
     ResolveToolCapabilities<TModel>,
-> extends OpenAICompatibleChatCompletionsTextAdapter<
+> extends OpenAIBaseChatCompletionsTextAdapter<
   TModel,
   TProviderOptions,
   TInputModalities,
@@ -56,7 +57,27 @@ export class GrokTextAdapter<
   readonly name = 'grok' as const
 
   constructor(config: GrokTextConfig, model: TModel) {
-    super(withGrokDefaults(config), model, 'grok')
+    super(model, 'grok', new OpenAI(withGrokDefaults(config)))
+  }
+
+  /**
+   * Surfaces xAI reasoning deltas on Grok reasoning models. The DeepSeek-style
+   * convention puts the chain-of-thought on `delta.reasoning_content`; some
+   * Grok variants also populate `delta.reasoning`. Reading both keeps
+   * reasoning flowing through the base's REASONING_* lifecycle for both
+   * `chatStream` and `structuredOutputStream`.
+   */
+  protected override extractReasoning(
+    chunk: OpenAI.Chat.Completions.ChatCompletionChunk,
+  ): { text: string } | undefined {
+    const delta = chunk.choices[0]?.delta as
+      | { reasoning?: unknown; reasoning_content?: unknown }
+      | undefined
+    const raw = delta?.reasoning_content ?? delta?.reasoning
+    if (typeof raw === 'string' && raw.length > 0) {
+      return { text: raw }
+    }
+    return undefined
   }
 }
 

package/src/index.ts

@@ -11,13 +11,11 @@ export {
   type GrokTextProviderOptions,
 } from './adapters/text'
 
-// Summarize adapter - for text summarization
+// Summarize - thin factory functions over @tanstack/ai's ChatStreamSummarizeAdapter
 export {
-  GrokSummarizeAdapter,
   createGrokSummarize,
   grokSummarize,
   type GrokSummarizeConfig,
-  type GrokSummarizeProviderOptions,
   type GrokSummarizeModel,
 } from './adapters/summarize'
 

package/src/utils/client.ts

@@ -1,7 +1,9 @@
 import { getApiKeyFromEnv } from '@tanstack/ai-utils'
-import type { OpenAICompatibleClientConfig } from '@tanstack/openai-base'
+import type { ClientOptions } from 'openai'
 
-export interface GrokClientConfig extends OpenAICompatibleClientConfig {}
+export interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {
+  apiKey: string
+}
 
 /**
  * Gets Grok API key from environment variables
@@ -21,9 +23,7 @@ export function getGrokApiKeyFromEnv(): string {
  * Returns a Grok client config with the default xAI base URL applied
  * when not already set.
  */
-export function withGrokDefaults(
-  config: GrokClientConfig,
-): OpenAICompatibleClientConfig {
+export function withGrokDefaults(config: GrokClientConfig): GrokClientConfig {
   return {
     ...config,
     baseURL: config.baseURL || 'https://api.x.ai/v1',