@tanstack/ai-grok 0.14.2 → 0.14.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.14.2",
+  "version": "0.14.3",
   "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -51,16 +51,16 @@
   "dependencies": {
     "openai": "^6.41.0",
     "@tanstack/ai-utils": "0.3.0",
-    "@tanstack/openai-base": "0.9.2"
+    "@tanstack/openai-base": "0.9.3"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.3.3",
-    "@tanstack/ai": "0.35.0"
+    "@tanstack/ai": "0.36.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.35.0"
+    "@tanstack/ai": "^0.36.0"
   },
   "scripts": {
     "build": "vite build",

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

@@ -1,89 +0,0 @@
-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 { GrokImageModelInputModalitiesByName, GrokImageModelProviderOptionsByName, GrokImageModelSizeByName, GrokImageProviderOptions } from '../image/image-provider-options.js';
-import { GrokClientConfig } from '../utils.js';
-/**
- * Configuration for Grok image adapter
- */
-export interface GrokImageConfig extends GrokClientConfig {
-}
-/**
- * Grok Image Generation Adapter
- *
- * Tree-shakeable adapter for Grok image generation functionality.
- * Supports the legacy grok-2-image-1212 model (text-to-image via the
- * OpenAI-compat endpoint) and the grok-imagine image models, which also
- * accept image prompt parts for image-conditioned generation via xAI's
- * `/v1/images/edits` endpoint (up to 3 source images).
- *
- * Features:
- * - Model-specific type-safe provider options
- * - Size / aspect-ratio validation per model
- * - Number of images validation
- */
-export declare class GrokImageAdapter<TModel extends GrokImageModel> extends BaseImageAdapter<TModel, GrokImageProviderOptions, GrokImageModelProviderOptionsByName, GrokImageModelSizeByName, GrokImageModelInputModalitiesByName> {
-    readonly kind: "image";
-    readonly name: "grok";
-    protected client: OpenAI;
-    private readonly clientConfig;
-    constructor(config: GrokImageConfig, model: TModel);
-    generateImages(options: ImageGenerationOptions<GrokImageProviderOptions>): Promise<ImageGenerationResult>;
-    /**
-     * Image-conditioned generation via xAI's Imagine API.
-     *
-     * The `/v1/images/edits` endpoint takes `application/json` (the OpenAI
-     * SDK's `images.edit()` sends `multipart/form-data`, which xAI rejects),
-     * so this path issues the request directly. One input is sent as
-     * `image: { url }`; multiple inputs (up to 3) as `images: [{ url }, ...]`,
-     * addressed by xAI in the order they are sent. The prompt text is sent
-     * verbatim — no referencing markers are injected.
-     */
-    private editImages;
-}
-/**
- * Creates a Grok image adapter with explicit API key.
- * Type resolution happens here at the call site.
- *
- * @param model - The model name (e.g., 'grok-2-image-1212')
- * @param apiKey - Your xAI API key
- * @param config - Optional additional configuration
- * @returns Configured Grok image adapter instance with resolved types
- *
- * @example
- * ```typescript
- * const adapter = createGrokImage('grok-2-image-1212', "xai-...");
- *
- * const result = await generateImage({
- *   adapter,
- *   prompt: 'A cute baby sea otter'
- * });
- * ```
- */
-export declare function createGrokImage<TModel extends GrokImageModel>(model: TModel, apiKey: string, config?: Omit<GrokImageConfig, 'apiKey'>): GrokImageAdapter<TModel>;
-/**
- * Creates a Grok image adapter with automatic API key detection from environment variables.
- * Type resolution happens here at the call site.
- *
- * Looks for `XAI_API_KEY` in:
- * - `process.env` (Node.js)
- * - `window.env` (Browser with injected env)
- *
- * @param model - The model name (e.g., 'grok-2-image-1212')
- * @param config - Optional configuration (excluding apiKey which is auto-detected)
- * @returns Configured Grok image adapter instance with resolved types
- * @throws Error if XAI_API_KEY is not found in environment
- *
- * @example
- * ```typescript
- * // Automatically uses XAI_API_KEY from environment
- * const adapter = grokImage('grok-2-image-1212');
- *
- * const result = await generateImage({
- *   adapter,
- *   prompt: 'A beautiful sunset over mountains'
- * });
- * ```
- */
-export declare function grokImage<TModel extends GrokImageModel>(model: TModel, config?: Omit<GrokImageConfig, 'apiKey'>): GrokImageAdapter<TModel>;

package/dist/esm/adapters/image.js

@@ -1,205 +0,0 @@
-import OpenAI from "openai";
-import { resolveMediaPrompt } from "@tanstack/ai";
-import { BaseImageAdapter } from "@tanstack/ai/adapters";
-import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
-import { buildImagesUsage } from "@tanstack/openai-base";
-import { generateId } from "@tanstack/ai-utils";
-import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
-import { isGrokImagineImageModel, validatePrompt, validateImageSize, validateNumberOfImages, parseGrokImagineSize } from "../image/image-provider-options.js";
-const MAX_EDIT_IMAGES = 3;
-function imagineSizeParams(size) {
-  if (!size) return {};
-  const parsed = parseGrokImagineSize(size);
-  if (!parsed) return {};
-  return {
-    aspect_ratio: parsed.aspectRatio,
-    ...parsed.resolution !== void 0 && { resolution: parsed.resolution }
-  };
-}
-function imagePartToUrl(part) {
-  if (part.source.type === "url") return part.source.value;
-  return `data:${part.source.mimeType};base64,${part.source.value}`;
-}
-class GrokImageAdapter extends BaseImageAdapter {
-  kind = "image";
-  name = "grok";
-  client;
-  clientConfig;
-  constructor(config, model) {
-    super(model, {});
-    this.clientConfig = withGrokDefaults(config);
-    this.client = new OpenAI(this.clientConfig);
-  }
-  async generateImages(options) {
-    const { model, numberOfImages, size, modelOptions } = options;
-    const resolved = resolveMediaPrompt(options.prompt);
-    const prompt = resolved.text;
-    if (resolved.videos.length > 0 || resolved.audios.length > 0) {
-      throw new Error(
-        `grok.generateImages does not support video / audio prompt parts on model ${model}.`
-      );
-    }
-    if (resolved.images.length > 0) {
-      if (!isGrokImagineImageModel(model)) {
-        throw new Error(
-          `grok: model "${model}" does not support image prompt parts. Image-conditioned generation requires an Imagine API model ('grok-imagine-image' or 'grok-imagine-image-quality').`
-        );
-      }
-      return await this.editImages(options, resolved);
-    }
-    validatePrompt({ prompt });
-    validateImageSize(model, size);
-    validateNumberOfImages(model, numberOfImages);
-    const isImagine = isGrokImagineImageModel(model);
-    const request = {
-      model,
-      prompt,
-      n: numberOfImages ?? 1,
-      ...isImagine ? imagineSizeParams(size) : size !== void 0 && {
-        size
-      },
-      stream: false,
-      ...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);
-      const images = (response.data ?? []).flatMap(
-        (item) => {
-          const revisedPrompt = item.revised_prompt;
-          if (item.b64_json) {
-            return [
-              {
-                b64Json: item.b64_json,
-                ...revisedPrompt !== void 0 && { revisedPrompt }
-              }
-            ];
-          }
-          if (item.url) {
-            return [
-              {
-                url: item.url,
-                ...revisedPrompt !== void 0 && { revisedPrompt }
-              }
-            ];
-          }
-          return [];
-        }
-      );
-      const usage = buildImagesUsage(response.usage);
-      return {
-        id: generateId(this.name),
-        model,
-        images,
-        ...usage ? { usage } : {}
-      };
-    } catch (error) {
-      options.logger.errors(`${this.name}.generateImages fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
-        source: `${this.name}.generateImages`
-      });
-      throw error;
-    }
-  }
-  /**
-   * Image-conditioned generation via xAI's Imagine API.
-   *
-   * The `/v1/images/edits` endpoint takes `application/json` (the OpenAI
-   * SDK's `images.edit()` sends `multipart/form-data`, which xAI rejects),
-   * so this path issues the request directly. One input is sent as
-   * `image: { url }`; multiple inputs (up to 3) as `images: [{ url }, ...]`,
-   * addressed by xAI in the order they are sent. The prompt text is sent
-   * verbatim — no referencing markers are injected.
-   */
-  async editImages(options, resolved) {
-    const { model, numberOfImages, size, modelOptions, logger } = options;
-    const prompt = resolved.text;
-    const imageInputs = resolved.images;
-    const unsupportedRole = imageInputs.find(
-      (part) => part.metadata?.role === "mask" || part.metadata?.role === "control"
-    );
-    if (unsupportedRole) {
-      throw new Error(
-        `grok: the Imagine API has no ${unsupportedRole.metadata?.role} input; only source/reference images are supported.`
-      );
-    }
-    if (imageInputs.length > MAX_EDIT_IMAGES) {
-      throw new Error(
-        `grok: model "${model}" accepts at most ${MAX_EDIT_IMAGES} source images; received ${imageInputs.length}.`
-      );
-    }
-    validatePrompt({ prompt });
-    validateImageSize(model, size);
-    validateNumberOfImages(model, numberOfImages);
-    const urls = imageInputs.map((part) => imagePartToUrl(part));
-    const request = {
-      model,
-      prompt,
-      ...urls.length === 1 ? { image: { url: urls[0] } } : { images: urls.map((url) => ({ url })) },
-      ...numberOfImages !== void 0 && { n: numberOfImages },
-      ...imagineSizeParams(size),
-      ...modelOptions
-    };
-    try {
-      logger.request(
-        `activity=image provider=${this.name} model=${model} edit images=${urls.length}`,
-        { provider: this.name, model }
-      );
-      const response = await fetch(
-        `${this.clientConfig.baseURL}/images/edits`,
-        {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${this.clientConfig.apiKey}`
-          },
-          body: JSON.stringify(request)
-        }
-      );
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(
-          `grok: image edit request failed (${response.status} ${response.statusText}): ${body}`
-        );
-      }
-      const result = await response.json();
-      const images = (result.data ?? []).flatMap(
-        (item) => {
-          if (item.b64_json) return [{ b64Json: item.b64_json }];
-          if (item.url) return [{ url: item.url }];
-          return [];
-        }
-      );
-      if (images.length === 0) {
-        throw new Error("grok: image edit response contained no images");
-      }
-      return {
-        id: generateId(this.name),
-        model,
-        images
-      };
-    } catch (error) {
-      logger.errors(`${this.name}.generateImages fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
-        source: `${this.name}.generateImages`
-      });
-      throw error;
-    }
-  }
-}
-function createGrokImage(model, apiKey, config) {
-  return new GrokImageAdapter({ apiKey, ...config }, model);
-}
-function grokImage(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokImage(model, apiKey, config);
-}
-export {
-  GrokImageAdapter,
-  createGrokImage,
-  grokImage
-};
-//# sourceMappingURL=image.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { buildImagesUsage } from '@tanstack/openai-base'\nimport { generateId } from '@tanstack/ai-utils'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  isGrokImagineImageModel,\n  parseGrokImagineSize,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ImagePart,\n  MediaInputMetadata,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GrokImageModel } from '../model-meta'\nimport type {\n  GrokImageModelInputModalitiesByName,\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/** Maximum source images accepted by xAI's image edit endpoint. */\nconst MAX_EDIT_IMAGES = 3\n\n/**\n * Maps the generic `size` option onto Imagine API parameters: the\n * \"aspectRatio_resolution\" template (\"16:9_2k\") splits into `aspect_ratio`\n * and optional `resolution` request fields.\n */\nfunction imagineSizeParams(size: string | undefined): {\n  aspect_ratio?: string\n  resolution?: string\n} {\n  if (!size) return {}\n  const parsed = parseGrokImagineSize(size)\n  if (!parsed) return {}\n  return {\n    aspect_ratio: parsed.aspectRatio,\n    ...(parsed.resolution !== undefined && { resolution: parsed.resolution }),\n  }\n}\n\n/**\n * Convert a TanStack ImagePart to the URL string accepted by xAI's edit\n * endpoint: public URLs pass through (fetched by xAI's servers), data\n * sources become base64 data URIs.\n */\nfunction imagePartToUrl(part: ImagePart<MediaInputMetadata>): string {\n  if (part.source.type === 'url') return part.source.value\n  return `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\n/** Response shape of xAI's `/v1/images/edits` endpoint. */\ninterface GrokImageEditResponse {\n  data?: Array<{\n    url?: string | null\n    b64_json?: string | null\n    mime_type?: string\n  }>\n}\n\n/**\n * Grok Image Generation Adapter\n *\n * Tree-shakeable adapter for Grok image generation functionality.\n * Supports the legacy grok-2-image-1212 model (text-to-image via the\n * OpenAI-compat endpoint) and the grok-imagine image models, which also\n * accept image prompt parts for image-conditioned generation via xAI's\n * `/v1/images/edits` endpoint (up to 3 source images).\n *\n * Features:\n * - Model-specific type-safe provider options\n * - Size / aspect-ratio 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  GrokImageModelInputModalitiesByName\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'grok' as const\n\n  protected client: OpenAI\n  private readonly clientConfig: GrokImageConfig\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(model, {})\n    this.clientConfig = withGrokDefaults(config)\n    this.client = new OpenAI(this.clientConfig)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions } = options\n\n    const resolved = resolveMediaPrompt(options.prompt)\n    const prompt = resolved.text\n\n    if (resolved.videos.length > 0 || resolved.audios.length > 0) {\n      throw new Error(\n        `grok.generateImages does not support video / audio prompt parts on model ${model}.`,\n      )\n    }\n\n    if (resolved.images.length > 0) {\n      if (!isGrokImagineImageModel(model)) {\n        throw new Error(\n          `grok: model \"${model}\" does not support image prompt parts. ` +\n            `Image-conditioned generation requires an Imagine API model ` +\n            `('grok-imagine-image' or 'grok-imagine-image-quality').`,\n        )\n      }\n      return await this.editImages(options, resolved)\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    // grok-imagine models are aspect-ratio sized: the generic `size` option\n    // carries an \"aspectRatio_resolution\" template (e.g. '16:9_2k', like\n    // Gemini native image models) and maps to the Imagine API's\n    // `aspect_ratio` / `resolution` parameters instead of OpenAI-style `size`.\n    const isImagine = isGrokImagineImageModel(model)\n    const request = {\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      ...(isImagine\n        ? imagineSizeParams(size)\n        : size !== undefined && {\n            size: size,\n          }),\n      stream: false,\n      ...modelOptions,\n    } as OpenAI_SDK.Images.ImageGenerateParamsNonStreaming\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(request)\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 [\n              {\n                b64Json: item.b64_json,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          if (item.url) {\n            return [\n              {\n                url: item.url,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          return []\n        },\n      )\n\n      const usage = buildImagesUsage(response.usage)\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n        ...(usage ? { usage } : {}),\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   * Image-conditioned generation via xAI's Imagine API.\n   *\n   * The `/v1/images/edits` endpoint takes `application/json` (the OpenAI\n   * SDK's `images.edit()` sends `multipart/form-data`, which xAI rejects),\n   * so this path issues the request directly. One input is sent as\n   * `image: { url }`; multiple inputs (up to 3) as `images: [{ url }, ...]`,\n   * addressed by xAI in the order they are sent. The prompt text is sent\n   * verbatim — no referencing markers are injected.\n   */\n  private async editImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n    resolved: ResolvedMediaPrompt,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions, logger } = options\n    const prompt = resolved.text\n    const imageInputs = resolved.images\n\n    const unsupportedRole = imageInputs.find(\n      (part) =>\n        part.metadata?.role === 'mask' || part.metadata?.role === 'control',\n    )\n    if (unsupportedRole) {\n      throw new Error(\n        `grok: the Imagine API has no ${unsupportedRole.metadata?.role} input; ` +\n          `only source/reference images are supported.`,\n      )\n    }\n    if (imageInputs.length > MAX_EDIT_IMAGES) {\n      throw new Error(\n        `grok: model \"${model}\" accepts at most ${MAX_EDIT_IMAGES} source images; received ${imageInputs.length}.`,\n      )\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    const urls = imageInputs.map((part) => imagePartToUrl(part))\n    const request: Record<string, unknown> = {\n      model,\n      prompt,\n      ...(urls.length === 1\n        ? { image: { url: urls[0] } }\n        : { images: urls.map((url) => ({ url })) }),\n      ...(numberOfImages !== undefined && { n: numberOfImages }),\n      ...imagineSizeParams(size),\n      ...modelOptions,\n    }\n\n    try {\n      logger.request(\n        `activity=image provider=${this.name} model=${model} edit images=${urls.length}`,\n        { provider: this.name, model },\n      )\n\n      const response = await fetch(\n        `${this.clientConfig.baseURL}/images/edits`,\n        {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.clientConfig.apiKey}`,\n          },\n          body: JSON.stringify(request),\n        },\n      )\n      if (!response.ok) {\n        const body = await response.text()\n        throw new Error(\n          `grok: image edit request failed (${response.status} ${response.statusText}): ${body}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokImageEditResponse\n      const images: Array<GeneratedImage> = (result.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          if (item.b64_json) return [{ b64Json: item.b64_json }]\n          if (item.url) return [{ url: item.url }]\n          return []\n        },\n      )\n      if (images.length === 0) {\n        throw new Error('grok: image edit response contained no images')\n      }\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n      }\n    } catch (error: unknown) {\n      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":"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"}

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

@@ -1,51 +0,0 @@
-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';
-/**
- * Configuration for Grok summarize adapter
- */
-export interface GrokSummarizeConfig extends GrokClientConfig {
-}
-/** Model type for Grok summarization */
-export type GrokSummarizeModel = (typeof GROK_CHAT_MODELS)[number];
-/**
- * Creates a Grok summarize adapter with explicit API key.
- * Type resolution happens here at the call site.
- *
- * @param model - The model name (e.g., 'grok-build-0.1')
- * @param apiKey - Your xAI API key
- * @param config - Optional additional configuration
- * @returns Configured Grok summarize adapter instance with resolved types
- *
- * @example
- * ```typescript
- * const adapter = createGrokSummarize('grok-build-0.1', "xai-...");
- * ```
- */
-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.
- *
- * Looks for `XAI_API_KEY` in:
- * - `process.env` (Node.js)
- * - `window.env` (Browser with injected env)
- *
- * @param model - The model name (e.g., 'grok-build-0.1')
- * @param config - Optional configuration (excluding apiKey which is auto-detected)
- * @returns Configured Grok summarize adapter instance with resolved types
- * @throws Error if XAI_API_KEY is not found in environment
- *
- * @example
- * ```typescript
- * // Automatically uses XAI_API_KEY from environment
- * const adapter = grokSummarize('grok-build-0.1');
- *
- * await summarize({
- *   adapter,
- *   text: "Long article text..."
- * });
- * ```
- */
-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,20 +0,0 @@
-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";
-function createGrokSummarize(model, apiKey, config) {
-  return new ChatStreamSummarizeAdapter(
-    new GrokTextAdapter({ apiKey, ...config }, model),
-    model,
-    "grok"
-  );
-}
-function grokSummarize(model, config) {
-  return createGrokSummarize(model, getGrokApiKeyFromEnv(), config);
-}
-export {
-  createGrokSummarize,
-  grokSummarize
-};
-//# sourceMappingURL=summarize.js.map

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

@@ -1 +0,0 @@
-{"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-build-0.1')\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-build-0.1', \"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-build-0.1')\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-build-0.1');\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,76 +0,0 @@
-import { OpenAIBaseResponsesTextAdapter } from '@tanstack/openai-base';
-import { GROK_CHAT_MODELS, GrokChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
-import { Modality, TextOptions } from '@tanstack/ai';
-import { GrokMessageMetadataByModality } from '../message-types.js';
-import { GrokClientConfig } from '../utils.js';
-import { ResponseCreateParams } from 'openai/resources/responses/responses';
-/**
- * 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
- */
-export interface GrokTextConfig extends GrokClientConfig {
-}
-/**
- * Alias for TextProviderOptions for external use
- */
-export type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options.js';
-/**
- * Grok Text (Chat) Adapter
- *
- * Tree-shakeable adapter for Grok chat/text completion functionality.
- * Uses xAI's OpenAI-compatible Responses API.
- *
- * Delegates implementation to {@link OpenAIBaseResponsesTextAdapter}
- * 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, unknown> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAIBaseResponsesTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
-    readonly kind: "text";
-    readonly name: "grok";
-    constructor(config: GrokTextConfig, model: TModel);
-    protected mapOptionsToRequest(options: TextOptions<TProviderOptions>): Omit<ResponseCreateParams, 'stream'>;
-}
-/**
- * Creates a Grok text adapter with explicit API key.
- * Type resolution happens here at the call site.
- *
- * @param model - The model name (e.g., 'grok-build-0.1')
- * @param apiKey - Your xAI API key
- * @param config - Optional additional configuration
- * @returns Configured Grok text adapter instance with resolved types
- *
- * @example
- * ```typescript
- * const adapter = createGrokText('grok-build-0.1', "xai-...");
- * // adapter has type-safe providerOptions for grok-build-0.1
- * ```
- */
-export declare function createGrokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(model: TModel, apiKey: string, config?: Omit<GrokTextConfig, 'apiKey'>): GrokTextAdapter<TModel>;
-/**
- * Creates a Grok text adapter with automatic API key detection from environment variables.
- * Type resolution happens here at the call site.
- *
- * Looks for `XAI_API_KEY` in:
- * - `process.env` (Node.js)
- * - `window.env` (Browser with injected env)
- *
- * @param model - The model name (e.g., 'grok-build-0.1')
- * @param config - Optional configuration (excluding apiKey which is auto-detected)
- * @returns Configured Grok text adapter instance with resolved types
- * @throws Error if XAI_API_KEY is not found in environment
- *
- * @example
- * ```typescript
- * // Automatically uses XAI_API_KEY from environment
- * const adapter = grokText('grok-build-0.1');
- *
- * const stream = chat({
- *   adapter,
- *   messages: [{ role: "user", content: "Hello!" }]
- * });
- * ```
- */
-export declare function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(model: TModel, config?: Omit<GrokTextConfig, 'apiKey'>): GrokTextAdapter<TModel>;

package/dist/esm/adapters/text.js

@@ -1,44 +0,0 @@
-import OpenAI from "openai";
-import { OpenAIBaseResponsesTextAdapter } from "@tanstack/openai-base";
-import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
-import { convertToolsToProviderFormat } from "../tools/index.js";
-class GrokTextAdapter extends OpenAIBaseResponsesTextAdapter {
-  kind = "text";
-  name = "grok";
-  constructor(config, model) {
-    super(model, "grok", new OpenAI(withGrokDefaults(config)));
-  }
-  mapOptionsToRequest(options) {
-    const { tools: _baseTools, ...request } = super.mapOptionsToRequest({
-      ...options,
-      tools: void 0
-    });
-    if (this.model === "grok-build-0.1" && request.reasoning !== void 0) {
-      throw new Error(
-        "grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model."
-      );
-    }
-    const tools = options.tools ? convertToolsToProviderFormat(options.tools) : void 0;
-    return {
-      ...request,
-      // xAI recommends encrypted reasoning for reasoning-capable Responses
-      // requests; callers can still override either field in modelOptions.
-      store: request.store ?? false,
-      include: request.include ?? ["reasoning.encrypted_content"],
-      ...tools && tools.length > 0 && { tools }
-    };
-  }
-}
-function createGrokText(model, apiKey, config) {
-  return new GrokTextAdapter({ apiKey, ...config }, model);
-}
-function grokText(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokText(model, apiKey, config);
-}
-export {
-  GrokTextAdapter,
-  createGrokText,
-  grokText
-};
-//# sourceMappingURL=text.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { OpenAIBaseResponsesTextAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport { convertToolsToProviderFormat } from '../tools'\nimport type {\n  GROK_CHAT_MODELS,\n  GrokChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { Modality, TextOptions } from '@tanstack/ai'\nimport type { GrokMessageMetadataByModality } from '../message-types'\nimport type { GrokClientConfig } from '../utils'\nimport type { ResponseCreateParams } from 'openai/resources/responses/responses'\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 xAI's OpenAI-compatible Responses API.\n *\n * Delegates implementation to {@link OpenAIBaseResponsesTextAdapter}\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, unknown> =\n    ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends OpenAIBaseResponsesTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GrokMessageMetadataByModality,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  override readonly name = 'grok' as const\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super(model, 'grok', new OpenAI(withGrokDefaults(config)))\n  }\n\n  protected override mapOptionsToRequest(\n    options: TextOptions<TProviderOptions>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const { tools: _baseTools, ...request } = super.mapOptionsToRequest({\n      ...options,\n      tools: undefined,\n    })\n    void _baseTools\n\n    if (this.model === 'grok-build-0.1' && request.reasoning !== undefined) {\n      throw new Error(\n        'grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model.',\n      )\n    }\n\n    const tools = options.tools\n      ? convertToolsToProviderFormat(options.tools)\n      : undefined\n\n    return {\n      ...request,\n      // xAI recommends encrypted reasoning for reasoning-capable Responses\n      // requests; callers can still override either field in modelOptions.\n      store: request.store ?? false,\n      include: request.include ?? ['reasoning.encrypted_content'],\n      ...(tools &&\n        tools.length > 0 && { tools: tools as ResponseCreateParams['tools'] }),\n    }\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-build-0.1')\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-build-0.1', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-build-0.1\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-build-0.1')\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-build-0.1');\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":";;;;AA2CO,MAAM,wBAQH,+BAMR;AAAA,EACkB,OAAO;AAAA,EACP,OAAO;AAAA,EAEzB,YAAY,QAAwB,OAAe;AACjD,UAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;AAAA,EAC3D;AAAA,EAEmB,oBACjB,SACsC;AACtC,UAAM,EAAE,OAAO,YAAY,GAAG,QAAA,IAAY,MAAM,oBAAoB;AAAA,MAClE,GAAG;AAAA,MACH,OAAO;AAAA,IAAA,CACR;AAGD,QAAI,KAAK,UAAU,oBAAoB,QAAQ,cAAc,QAAW;AACtE,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,QAAQ,QAAQ,QAClB,6BAA6B,QAAQ,KAAK,IAC1C;AAEJ,WAAO;AAAA,MACL,GAAG;AAAA;AAAA;AAAA,MAGH,OAAO,QAAQ,SAAS;AAAA,MACxB,SAAS,QAAQ,WAAW,CAAC,6BAA6B;AAAA,MAC1D,GAAI,SACF,MAAM,SAAS,KAAK,EAAE,MAAA;AAAA,IAA8C;AAAA,EAE1E;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/adapters/transcription.d.ts

@@ -1,84 +0,0 @@
-import { BaseTranscriptionAdapter } from '@tanstack/ai/adapters';
-import { TranscriptionOptions, TranscriptionResult, TranscriptionWord } from '@tanstack/ai';
-import { GrokTranscriptionModel } from '../model-meta.js';
-import { GrokTranscriptionProviderOptions } from '../audio/transcription-provider-options.js';
-/**
- * Grok-specific extension of `TranscriptionWord` that surfaces the extra
- * fields xAI returns when diarization / confidence are enabled. The base
- * cross-provider `TranscriptionWord` contract doesn't include these, so
- * callers who know they're using Grok can narrow with:
- *
- * ```ts
- * const words = result.words as Array<GrokTranscriptionWord> | undefined
- * ```
- */
-export interface GrokTranscriptionWord extends TranscriptionWord {
-    /** Model confidence for the word, when xAI returns one. */
-    confidence?: number;
-    /** Speaker index, populated when `modelOptions.diarize === true`. */
-    speaker?: number;
-}
-/**
- * Configuration for the Grok transcription adapter.
- *
- * Uses direct `fetch` rather than the OpenAI SDK because xAI's `/v1/stt`
- * endpoint is not OpenAI-compatible.
- */
-export interface GrokTranscriptionConfig {
-    apiKey: string;
-    baseURL?: string;
-    /** Additional headers to merge into every request (e.g., test IDs). */
-    defaultHeaders?: Record<string, string>;
-}
-/**
- * Grok Speech-to-Text Adapter.
- *
- * Talks to `POST {baseURL}/stt` per
- * https://docs.x.ai/developers/rest-api-reference/inference/voice
- */
-export declare class GrokTranscriptionAdapter<TModel extends GrokTranscriptionModel> extends BaseTranscriptionAdapter<TModel, GrokTranscriptionProviderOptions> {
-    readonly name: "grok";
-    private readonly apiKey;
-    private readonly baseURL;
-    private readonly defaultHeaders;
-    constructor(config: GrokTranscriptionConfig, model: TModel);
-    transcribe(options: TranscriptionOptions<GrokTranscriptionProviderOptions>): Promise<TranscriptionResult>;
-}
-/**
- * Build the multipart/form-data body for `POST /v1/stt`, coercing SDK-level
- * model options into xAI's wire format (booleans as `'true'`/`'false'`
- * strings, numeric fields stringified, etc.).
- *
- * Wire-field mapping:
- *   - `modelOptions.inverse_text_normalization` → `format` (xAI's chosen
- *     wire-field name for the ITN boolean; the SDK surfaces it under the
- *     clearer `inverse_text_normalization` key).
- *   - `modelOptions.audio_format`, `sample_rate`, `multichannel`, `channels`,
- *     `diarize` map to same-named form fields.
- */
-export declare function buildTranscriptionFormData(options: {
-    file: File;
-    language: string | undefined;
-    modelOptions: GrokTranscriptionProviderOptions | undefined;
-}): FormData;
-/**
- * Creates a Grok transcription adapter with an explicit API key.
- *
- * @example
- * ```typescript
- * const adapter = createGrokTranscription('grok-stt', 'xai-...')
- * const result = await generateTranscription({
- *   adapter,
- *   audio: audioFile,
- *   language: 'en',
- * })
- * ```
- */
-export declare function createGrokTranscription<TModel extends GrokTranscriptionModel>(model: TModel, apiKey: string, config?: Omit<GrokTranscriptionConfig, 'apiKey'>): GrokTranscriptionAdapter<TModel>;
-/**
- * Creates a Grok transcription adapter, reading the API key from
- * `XAI_API_KEY` in the environment.
- *
- * @throws Error if `XAI_API_KEY` is not set.
- */
-export declare function grokTranscription<TModel extends GrokTranscriptionModel>(model: TModel, config?: Omit<GrokTranscriptionConfig, 'apiKey'>): GrokTranscriptionAdapter<TModel>;