@tanstack/ai-grok 0.14.8 → 0.14.10

package/dist/esm/adapters/image.js

@@ -1,205 +1,240 @@
+import { getGrokApiKeyFromEnv, withGrokDefaults } from "../utils/client.js";
+import { isGrokImagineImageModel, parseGrokImagineSize, validateImageSize, validateNumberOfImages, validatePrompt } from "../image/image-provider-options.js";
 import OpenAI from "openai";
+import { buildImagesUsage } from "@tanstack/openai-base";
+import { generateId } from "@tanstack/ai-utils";
 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;
+//#region src/adapters/image.ts
+/** Maximum source images accepted by xAI's image edit endpoint. */
+var MAX_EDIT_IMAGES = 3;
+/**
+* Maps the generic `size` option onto Imagine API parameters: the
+* "aspectRatio_resolution" template ("16:9_2k") splits into `aspect_ratio`
+* and optional `resolution` request fields.
+*/
 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 }
-  };
+	if (!size) return {};
+	const parsed = parseGrokImagineSize(size);
+	if (!parsed) return {};
+	return {
+		aspect_ratio: parsed.aspectRatio,
+		...parsed.resolution !== void 0 && { resolution: parsed.resolution }
+	};
 }
+/**
+* Convert a TanStack ImagePart to the URL string accepted by xAI's edit
+* endpoint: public URLs pass through (fetched by xAI's servers), data
+* sources become base64 data URIs.
+*/
 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;
-    }
-  }
+	if (part.source.type === "url") return part.source.value;
+	return `data:${part.source.mimeType};base64,${part.source.value}`;
 }
+/**
+* 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
+*/
+var GrokImageAdapter = class 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,
+			model
+		});
+		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,
+			model
+		});
+		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 images = ((await response.json()).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;
+		}
+	}
+};
+/**
+* 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'
+* });
+* ```
+*/
 function createGrokImage(model, apiKey, config) {
-  return new GrokImageAdapter({ apiKey, ...config }, model);
+	return new GrokImageAdapter({
+		apiKey,
+		...config
+	}, model);
 }
+/**
+* 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'
+* });
+* ```
+*/
 function grokImage(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokImage(model, apiKey, config);
+	return createGrokImage(model, getGrokApiKeyFromEnv(), config);
 }
-export {
-  GrokImageAdapter,
-  createGrokImage,
-  grokImage
-};
-//# sourceMappingURL=image.js.map
+//#endregion
+export { GrokImageAdapter, createGrokImage, grokImage };
+
+//# sourceMappingURL=image.js.map

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

@@ -1 +1 @@
-{"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/client'\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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"}
+{"version":3,"file":"image.js","names":[],"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/client'\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"],"mappings":"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"}

package/dist/esm/adapters/summarize.js

@@ -1,18 +1,55 @@
-import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
 import { getGrokApiKeyFromEnv } from "../utils/client.js";
 import { GrokTextAdapter } from "./text.js";
+import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
+//#region src/adapters/summarize.ts
+/**
+* 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-...");
+* ```
+*/
 function createGrokSummarize(model, apiKey, config) {
-  return new ChatStreamSummarizeAdapter(
-    new GrokTextAdapter({ apiKey, ...config }, model),
-    model,
-    "grok"
-  );
+	return new ChatStreamSummarizeAdapter(new GrokTextAdapter({
+		apiKey,
+		...config
+	}, model), model, "grok");
 }
+/**
+* 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..."
+* });
+* ```
+*/
 function grokSummarize(model, config) {
-  return createGrokSummarize(model, getGrokApiKeyFromEnv(), config);
+	return createGrokSummarize(model, getGrokApiKeyFromEnv(), config);
 }
-export {
-  createGrokSummarize,
-  grokSummarize
-};
-//# sourceMappingURL=summarize.js.map
+//#endregion
+export { createGrokSummarize, grokSummarize };
+
+//# sourceMappingURL=summarize.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getGrokApiKeyFromEnv } from '../utils/client'\nimport { GrokTextAdapter } from './text'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { GROK_CHAT_MODELS } from '../model-meta'\nimport type { GrokClientConfig } from '../utils/client'\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;"}
+{"version":3,"file":"summarize.js","names":[],"sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getGrokApiKeyFromEnv } from '../utils/client'\nimport { GrokTextAdapter } from './text'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { GROK_CHAT_MODELS } from '../model-meta'\nimport type { GrokClientConfig } from '../utils/client'\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"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,SAAgB,oBACd,OACA,QACA,QAIA;CACA,OAAO,IAAI,2BACT,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK,GAChD,OACA,MACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,cACd,OACA,QAIA;CACA,OAAO,oBAAoB,OAAO,qBAAqB,GAAG,MAAM;AAClE"}