@tanstack/ai-grok 0.7.1 → 0.7.2

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

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

package/dist/esm/adapters/image.js

@@ -1,70 +1,20 @@
-import { BaseImageAdapter } from "@tanstack/ai/adapters";
-import { createGrokClient, generateId, getGrokApiKeyFromEnv } from "../utils/client.js";
+import { OpenAICompatibleImageAdapter } from "@tanstack/openai-base";
+import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
 import { validatePrompt, validateImageSize, validateNumberOfImages } from "../image/image-provider-options.js";
-class GrokImageAdapter extends BaseImageAdapter {
+class GrokImageAdapter extends OpenAICompatibleImageAdapter {
   constructor(config, model) {
-    super(model, {});
+    super(withGrokDefaults(config), model, "grok");
     this.kind = "image";
     this.name = "grok";
-    this.client = createGrokClient(config);
   }
-  async generateImages(options) {
-    const { model, prompt, numberOfImages, size, logger } = options;
-    logger.request(`activity=generateImage provider=grok model=${this.model}`, {
-      provider: "grok",
-      model: this.model
-    });
-    try {
-      validatePrompt({ prompt, model });
-      validateImageSize(model, size);
-      validateNumberOfImages(model, numberOfImages);
-      const request = this.buildRequest(options);
-      const response = await this.client.images.generate({
-        ...request,
-        stream: false
-      });
-      return this.transformResponse(model, response);
-    } catch (error) {
-      logger.errors("grok.generateImage fatal", {
-        error,
-        source: "grok.generateImage"
-      });
-      throw error;
-    }
+  validatePrompt(options) {
+    validatePrompt(options);
   }
-  buildRequest(options) {
-    const { model, prompt, numberOfImages, size, modelOptions } = options;
-    return {
-      ...modelOptions,
-      model,
-      prompt,
-      n: numberOfImages ?? 1,
-      size
-    };
+  validateImageSize(model, size) {
+    validateImageSize(model, size);
   }
-  transformResponse(model, response) {
-    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
-    };
+  validateNumberOfImages(model, numberOfImages) {
+    validateNumberOfImages(model, numberOfImages);
   }
 }
 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 { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { createGrokClient, generateId, getGrokApiKeyFromEnv } from '../utils'\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 {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\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  private client: OpenAI_SDK\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(model, {})\n    this.client = createGrokClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, numberOfImages, size, logger } = options\n\n    logger.request(`activity=generateImage provider=grok model=${this.model}`, {\n      provider: 'grok',\n      model: this.model,\n    })\n\n    try {\n      // Validate inputs\n      validatePrompt({ prompt, model })\n      validateImageSize(model, size)\n      validateNumberOfImages(model, numberOfImages)\n\n      // Build request based on model type\n      const request = this.buildRequest(options)\n\n      const response = await this.client.images.generate({\n        ...request,\n        stream: false,\n      })\n\n      return this.transformResponse(model, response)\n    } catch (error) {\n      logger.errors('grok.generateImage fatal', {\n        error,\n        source: 'grok.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private buildRequest(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): OpenAI_SDK.Images.ImageGenerateParams {\n    const { model, prompt, numberOfImages, size, modelOptions } = options\n\n    // Spread modelOptions FIRST so explicit args (model, prompt, n, size) win\n    // and user-supplied modelOptions cannot silently override them.\n    return {\n      ...modelOptions,\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      size: size as OpenAI_SDK.Images.ImageGenerateParams['size'],\n    }\n  }\n\n  private transformResponse(\n    model: string,\n    response: OpenAI_SDK.Images.ImagesResponse,\n  ): ImageGenerationResult {\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  }\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":";;;AAqCO,MAAM,yBAEH,iBAKR;AAAA,EAMA,YAAY,QAAyB,OAAe;AAClD,UAAM,OAAO,EAAE;AANjB,SAAS,OAAO;AAChB,SAAS,OAAO;AAMd,SAAK,SAAS,iBAAiB,MAAM;AAAA,EACvC;AAAA,EAEA,MAAM,eACJ,SACgC;AAChC,UAAM,EAAE,OAAO,QAAQ,gBAAgB,MAAM,WAAW;AAExD,WAAO,QAAQ,8CAA8C,KAAK,KAAK,IAAI;AAAA,MACzE,UAAU;AAAA,MACV,OAAO,KAAK;AAAA,IAAA,CACb;AAED,QAAI;AAEF,qBAAe,EAAE,QAAQ,OAAO;AAChC,wBAAkB,OAAO,IAAI;AAC7B,6BAAuB,OAAO,cAAc;AAG5C,YAAM,UAAU,KAAK,aAAa,OAAO;AAEzC,YAAM,WAAW,MAAM,KAAK,OAAO,OAAO,SAAS;AAAA,QACjD,GAAG;AAAA,QACH,QAAQ;AAAA,MAAA,CACT;AAED,aAAO,KAAK,kBAAkB,OAAO,QAAQ;AAAA,IAC/C,SAAS,OAAO;AACd,aAAO,OAAO,4BAA4B;AAAA,QACxC;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,aACN,SACuC;AACvC,UAAM,EAAE,OAAO,QAAQ,gBAAgB,MAAM,iBAAiB;AAI9D,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,GAAG,kBAAkB;AAAA,MACrB;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEQ,kBACN,OACA,UACuB;AACvB,UAAM,UAAiC,SAAS,QAAQ,CAAA,GAAI;AAAA,MAC1D,CAAC,SAAgC;AAC/B,cAAM,gBAAgB,KAAK;AAC3B,YAAI,KAAK,UAAU;AACjB,iBAAO,CAAC,EAAE,SAAS,KAAK,UAAU,eAAe;AAAA,QACnD;AACA,YAAI,KAAK,KAAK;AACZ,iBAAO,CAAC,EAAE,KAAK,KAAK,KAAK,eAAe;AAAA,QAC1C;AACA,eAAO,CAAA;AAAA,MACT;AAAA,IAAA;AAGF,WAAO;AAAA,MACL,IAAI,WAAW,KAAK,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,MACA,OAAO,SAAS,QACZ;AAAA,QACE,aAAa,SAAS,MAAM;AAAA,QAC5B,cAAc,SAAS,MAAM;AAAA,QAC7B,aAAa,SAAS,MAAM;AAAA,MAAA,IAE9B;AAAA,IAAA;AAAA,EAER;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 { 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;"}

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

@@ -1,6 +1,5 @@
-import { BaseSummarizeAdapter } from '@tanstack/ai/adapters';
+import { OpenAICompatibleSummarizeAdapter } from '@tanstack/openai-base';
 import { GROK_CHAT_MODELS } from '../model-meta.js';
-import { StreamChunk, SummarizationOptions, SummarizationResult } from '@tanstack/ai';
 import { GrokClientConfig } from '../utils.js';
 /**
  * Configuration for Grok summarize adapter
@@ -24,14 +23,10 @@ export type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number];
  * 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 BaseSummarizeAdapter<TModel, GrokSummarizeProviderOptions> {
+export declare class GrokSummarizeAdapter<TModel extends GrokSummarizeModel> extends OpenAICompatibleSummarizeAdapter<TModel, GrokSummarizeProviderOptions> {
     readonly kind: "summarize";
     readonly name: "grok";
-    private textAdapter;
     constructor(config: GrokSummarizeConfig, model: TModel);
-    summarize(options: SummarizationOptions): Promise<SummarizationResult>;
-    summarizeStream(options: SummarizationOptions): AsyncIterable<StreamChunk>;
-    private buildSummarizationPrompt;
 }
 /**
  * Creates a Grok summarize adapter with explicit API key.

package/dist/esm/adapters/summarize.js

@@ -1,103 +1,19 @@
-import { BaseSummarizeAdapter } from "@tanstack/ai/adapters";
+import { OpenAICompatibleSummarizeAdapter } from "@tanstack/openai-base";
+import "@tanstack/ai-utils";
 import { getGrokApiKeyFromEnv } from "../utils/client.js";
 import { GrokTextAdapter } from "./text.js";
-class GrokSummarizeAdapter extends BaseSummarizeAdapter {
+class GrokSummarizeAdapter extends OpenAICompatibleSummarizeAdapter {
   constructor(config, model) {
-    super({}, model);
+    super(
+      new GrokTextAdapter(
+        config,
+        model
+      ),
+      model,
+      "grok"
+    );
     this.kind = "summarize";
     this.name = "grok";
-    this.textAdapter = new GrokTextAdapter(config, model);
-  }
-  async summarize(options) {
-    const { logger } = options;
-    const systemPrompt = this.buildSummarizationPrompt(options);
-    logger.request(`activity=summarize provider=grok`, {
-      provider: "grok",
-      model: options.model
-    });
-    let summary = "";
-    const id = "";
-    let model = options.model;
-    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-    try {
-      for await (const chunk of this.textAdapter.chatStream({
-        model: options.model,
-        messages: [{ role: "user", content: options.text }],
-        systemPrompts: [systemPrompt],
-        maxTokens: options.maxLength,
-        temperature: 0.3,
-        logger
-      })) {
-        if (chunk.type === "TEXT_MESSAGE_CONTENT") {
-          if (chunk.content) {
-            summary = chunk.content;
-          } else {
-            summary += chunk.delta;
-          }
-          model = chunk.model || model;
-        }
-        if (chunk.type === "RUN_FINISHED") {
-          if (chunk.usage) {
-            usage = chunk.usage;
-          }
-        }
-      }
-    } catch (error) {
-      logger.errors("grok.summarize fatal", {
-        error,
-        source: "grok.summarize"
-      });
-      throw error;
-    }
-    return { id, model, summary, usage };
-  }
-  async *summarizeStream(options) {
-    const { logger } = options;
-    const systemPrompt = this.buildSummarizationPrompt(options);
-    logger.request(`activity=summarize provider=grok`, {
-      provider: "grok",
-      model: options.model,
-      stream: true
-    });
-    try {
-      yield* this.textAdapter.chatStream({
-        model: options.model,
-        messages: [{ role: "user", content: options.text }],
-        systemPrompts: [systemPrompt],
-        maxTokens: options.maxLength,
-        temperature: 0.3,
-        logger
-      });
-    } catch (error) {
-      logger.errors("grok.summarize fatal", {
-        error,
-        source: "grok.summarize"
-      });
-      throw error;
-    }
-  }
-  buildSummarizationPrompt(options) {
-    let prompt = "You are a professional summarizer. ";
-    switch (options.style) {
-      case "bullet-points":
-        prompt += "Provide a summary in bullet point format. ";
-        break;
-      case "paragraph":
-        prompt += "Provide a summary in paragraph format. ";
-        break;
-      case "concise":
-        prompt += "Provide a very concise summary in 1-2 sentences. ";
-        break;
-      default:
-        prompt += "Provide a clear and concise summary. ";
-    }
-    if (options.focus && options.focus.length > 0) {
-      prompt += `Focus on the following aspects: ${options.focus.join(", ")}. `;
-    }
-    if (options.maxLength) {
-      prompt += `Keep the summary under ${options.maxLength} tokens. `;
-    }
-    return prompt;
   }
 }
 function createGrokSummarize(model, apiKey, config) {

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

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { BaseSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getGrokApiKeyFromEnv } from '../utils'\nimport { GrokTextAdapter } from './text'\nimport type { GROK_CHAT_MODELS } from '../model-meta'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from '@tanstack/ai'\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 BaseSummarizeAdapter<TModel, GrokSummarizeProviderOptions> {\n  readonly kind = 'summarize' as const\n  readonly name = 'grok' as const\n\n  private textAdapter: GrokTextAdapter<TModel>\n\n  constructor(config: GrokSummarizeConfig, model: TModel) {\n    super({}, model)\n    this.textAdapter = new GrokTextAdapter(config, model)\n  }\n\n  async summarize(options: SummarizationOptions): Promise<SummarizationResult> {\n    const { logger } = options\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    logger.request(`activity=summarize provider=grok`, {\n      provider: 'grok',\n      model: options.model,\n    })\n\n    // Use the text adapter's streaming and collect the result\n    let summary = ''\n    const id = ''\n    let model = options.model\n    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 }\n\n    try {\n      for await (const chunk of this.textAdapter.chatStream({\n        model: options.model,\n        messages: [{ role: 'user', content: options.text }],\n        systemPrompts: [systemPrompt],\n        maxTokens: options.maxLength,\n        temperature: 0.3,\n        logger,\n      })) {\n        // AG-UI TEXT_MESSAGE_CONTENT event\n        if (chunk.type === 'TEXT_MESSAGE_CONTENT') {\n          if (chunk.content) {\n            summary = chunk.content\n          } else {\n            summary += chunk.delta\n          }\n          model = chunk.model || model\n        }\n        // AG-UI RUN_FINISHED event\n        if (chunk.type === 'RUN_FINISHED') {\n          if (chunk.usage) {\n            usage = chunk.usage\n          }\n        }\n      }\n    } catch (error) {\n      logger.errors('grok.summarize fatal', {\n        error,\n        source: 'grok.summarize',\n      })\n      throw error\n    }\n\n    return { id, model, summary, usage }\n  }\n\n  async *summarizeStream(\n    options: SummarizationOptions,\n  ): AsyncIterable<StreamChunk> {\n    const { logger } = options\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    logger.request(`activity=summarize provider=grok`, {\n      provider: 'grok',\n      model: options.model,\n      stream: true,\n    })\n\n    try {\n      // Delegate directly to the text adapter's streaming\n      yield* this.textAdapter.chatStream({\n        model: options.model,\n        messages: [{ role: 'user', content: options.text }],\n        systemPrompts: [systemPrompt],\n        maxTokens: options.maxLength,\n        temperature: 0.3,\n        logger,\n      })\n    } catch (error) {\n      logger.errors('grok.summarize fatal', {\n        error,\n        source: 'grok.summarize',\n      })\n      throw error\n    }\n  }\n\n  private buildSummarizationPrompt(options: SummarizationOptions): string {\n    let prompt = 'You are a professional summarizer. '\n\n    switch (options.style) {\n      case 'bullet-points':\n        prompt += 'Provide a summary in bullet point format. '\n        break\n      case 'paragraph':\n        prompt += 'Provide a summary in paragraph format. '\n        break\n      case 'concise':\n        prompt += 'Provide a very concise summary in 1-2 sentences. '\n        break\n      default:\n        prompt += 'Provide a clear and concise summary. '\n    }\n\n    if (options.focus && options.focus.length > 0) {\n      prompt += `Focus on the following aspects: ${options.focus.join(', ')}. `\n    }\n\n    if (options.maxLength) {\n      prompt += `Keep the summary under ${options.maxLength} tokens. `\n    }\n\n    return prompt\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":"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"}
+{"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;"}

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

@@ -1,9 +1,11 @@
-import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
+import { OpenAICompatibleChatCompletionsTextAdapter } from '@tanstack/openai-base';
 import { GROK_CHAT_MODELS, GrokChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
-import { Modality, StreamChunk, TextOptions } from '@tanstack/ai';
-import { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options.js';
+import { Modality } from '@tanstack/ai';
 import { GrokMessageMetadataByModality } from '../message-types.js';
 import { GrokClientConfig } from '../utils.js';
+/**
+ * Resolve tool capabilities for a specific Grok model.
+ */
 type ResolveToolCapabilities<TModel extends string> = TModel extends keyof GrokChatModelToolCapabilitiesByName ? NonNullable<GrokChatModelToolCapabilitiesByName[TModel]> : readonly [];
 /**
  * Configuration for Grok text adapter
@@ -19,41 +21,15 @@ 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.
  */
-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 BaseTextAdapter<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 OpenAICompatibleChatCompletionsTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
     readonly kind: "text";
     readonly name: "grok";
-    private client;
     constructor(config: GrokTextConfig, model: TModel);
-    chatStream(options: TextOptions<GrokTextProviderOptions>): AsyncIterable<StreamChunk>;
-    /**
-     * Generate structured output using Grok's JSON Schema response format.
-     * Uses stream: false to get the complete response in one call.
-     *
-     * Grok has strict requirements for structured output (via OpenAI-compatible API):
-     * - All properties must be in the `required` array
-     * - Optional fields should have null added to their type union
-     * - additionalProperties must be false for all objects
-     *
-     * The outputSchema is already JSON Schema (converted in the ai layer).
-     * We apply Grok-specific transformations for structured output compatibility.
-     */
-    structuredOutput(options: StructuredOutputOptions<GrokTextProviderOptions>): Promise<StructuredOutputResult<unknown>>;
-    private processGrokStreamChunks;
-    /**
-     * Maps common options to Grok-specific Chat Completions format
-     */
-    private mapTextOptionsToGrok;
-    private convertMessageToGrok;
-    /**
-     * Normalizes message content to an array of ContentPart.
-     * Handles backward compatibility with string content.
-     */
-    private normalizeContent;
-    /**
-     * Extracts text content from a content value that may be string, null, or ContentPart array.
-     */
-    private extractTextContent;
 }
 /**
  * Creates a Grok text adapter with explicit API key.