@tanstack/openai-base 0.2.0 → 0.3.0

package/src/index.ts

@@ -1,24 +1,14 @@
 export { makeStructuredOutputCompatible } from './utils/schema-converter'
-export { createOpenAICompatibleClient } from './utils/client'
-export type { OpenAICompatibleClientConfig } from './types/config'
 export * from './tools/index'
-export { OpenAICompatibleChatCompletionsTextAdapter } from './adapters/chat-completions-text'
+export { OpenAIBaseChatCompletionsTextAdapter } from './adapters/chat-completions-text'
 export {
   convertFunctionToolToChatCompletionsFormat,
   convertToolsToChatCompletionsFormat,
   type ChatCompletionFunctionTool,
 } from './adapters/chat-completions-tool-converter'
-export { OpenAICompatibleResponsesTextAdapter } from './adapters/responses-text'
+export { OpenAIBaseResponsesTextAdapter } from './adapters/responses-text'
 export {
   convertFunctionToolToResponsesFormat,
   convertToolsToResponsesFormat,
   type ResponsesFunctionTool,
 } from './adapters/responses-tool-converter'
-export { OpenAICompatibleImageAdapter } from './adapters/image'
-export {
-  OpenAICompatibleSummarizeAdapter,
-  type ChatStreamCapable,
-} from './adapters/summarize'
-export { OpenAICompatibleTranscriptionAdapter } from './adapters/transcription'
-export { OpenAICompatibleTTSAdapter } from './adapters/tts'
-export { OpenAICompatibleVideoAdapter } from './adapters/video'

package/src/tools/apply-patch-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { ApplyPatchTool as ApplyPatchToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type ApplyPatchToolConfig = OpenAI.Responses.ApplyPatchTool
+export type { ApplyPatchToolConfig }
 
 /** @deprecated Renamed to `ApplyPatchToolConfig`. Will be removed in a future release. */
 export type ApplyPatchTool = ApplyPatchToolConfig

package/src/tools/code-interpreter-tool.ts

@@ -1,7 +1,9 @@
+import type { Tool as SDKTool } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
-import type OpenAI from 'openai'
 
-export type CodeInterpreterToolConfig = OpenAI.Responses.Tool.CodeInterpreter
+type CodeInterpreterToolConfig = SDKTool.CodeInterpreter
+
+export type { CodeInterpreterToolConfig }
 
 /** @deprecated Renamed to `CodeInterpreterToolConfig`. Will be removed in a future release. */
 export type CodeInterpreterTool = CodeInterpreterToolConfig

package/src/tools/computer-use-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { ComputerTool as ComputerUseToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type ComputerUseToolConfig = OpenAI.Responses.ComputerTool
+export type { ComputerUseToolConfig }
 
 /** @deprecated Renamed to `ComputerUseToolConfig`. Will be removed in a future release. */
 export type ComputerUseTool = ComputerUseToolConfig

package/src/tools/custom-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { CustomTool as CustomToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type CustomToolConfig = OpenAI.Responses.CustomTool
+export type { CustomToolConfig }
 
 /** @deprecated Renamed to `CustomToolConfig`. Will be removed in a future release. */
 export type CustomTool = CustomToolConfig

package/src/tools/file-search-tool.ts

@@ -1,6 +1,8 @@
-import type OpenAI from 'openai'
+import type { FileSearchTool as FileSearchToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
+export type { FileSearchToolConfig }
+
 const validateMaxNumResults = (maxNumResults: number | undefined) => {
   if (
     maxNumResults !== undefined &&
@@ -10,8 +12,6 @@ const validateMaxNumResults = (maxNumResults: number | undefined) => {
   }
 }
 
-export type FileSearchToolConfig = OpenAI.Responses.FileSearchTool
-
 /** @deprecated Renamed to `FileSearchToolConfig`. Will be removed in a future release. */
 export type FileSearchTool = FileSearchToolConfig
 

package/src/tools/function-tool.ts

@@ -1,8 +1,8 @@
 import { makeStructuredOutputCompatible } from '../utils/schema-converter'
+import type { FunctionTool as FunctionToolConfig } from 'openai/resources/responses/responses'
 import type { JSONSchema, Tool } from '@tanstack/ai'
-import type OpenAI from 'openai'
 
-export type FunctionToolConfig = OpenAI.Responses.FunctionTool
+export type { FunctionToolConfig }
 
 /** @deprecated Renamed to `FunctionToolConfig`. Will be removed in a future release. */
 export type FunctionTool = FunctionToolConfig

package/src/tools/image-generation-tool.ts

@@ -1,7 +1,9 @@
-import type OpenAI from 'openai'
+import type { Tool as SDKTool } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type ImageGenerationToolConfig = OpenAI.Responses.Tool.ImageGeneration
+type ImageGenerationToolConfig = SDKTool.ImageGeneration
+
+export type { ImageGenerationToolConfig }
 
 /** @deprecated Renamed to `ImageGenerationToolConfig`. Will be removed in a future release. */
 export type ImageGenerationTool = ImageGenerationToolConfig

package/src/tools/local-shell-tool.ts

@@ -1,7 +1,9 @@
-import type OpenAI from 'openai'
+import type { Tool as SDKTool } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type LocalShellToolConfig = OpenAI.Responses.Tool.LocalShell
+type LocalShellToolConfig = SDKTool.LocalShell
+
+export type { LocalShellToolConfig }
 
 /** @deprecated Renamed to `LocalShellToolConfig`. Will be removed in a future release. */
 export type LocalShellTool = LocalShellToolConfig

package/src/tools/mcp-tool.ts

@@ -1,7 +1,9 @@
-import type OpenAI from 'openai'
+import type { Tool as SDKTool } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type MCPToolConfig = OpenAI.Responses.Tool.Mcp
+type MCPToolConfig = SDKTool.Mcp
+
+export type { MCPToolConfig }
 
 /** @deprecated Renamed to `MCPToolConfig`. Will be removed in a future release. */
 export type MCPTool = MCPToolConfig

package/src/tools/shell-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { FunctionShellTool as ShellToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type ShellToolConfig = OpenAI.Responses.FunctionShellTool
+export type { ShellToolConfig }
 
 /** @deprecated Renamed to `ShellToolConfig`. Will be removed in a future release. */
 export type ShellTool = ShellToolConfig

package/src/tools/web-search-preview-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { WebSearchPreviewTool as WebSearchPreviewToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type WebSearchPreviewToolConfig = OpenAI.Responses.WebSearchPreviewTool
+export type { WebSearchPreviewToolConfig }
 
 /** @deprecated Renamed to `WebSearchPreviewToolConfig`. Will be removed in a future release. */
 export type WebSearchPreviewTool = WebSearchPreviewToolConfig

package/src/tools/web-search-tool.ts

@@ -1,7 +1,7 @@
-import type OpenAI from 'openai'
+import type { WebSearchTool as WebSearchToolConfig } from 'openai/resources/responses/responses'
 import type { Tool } from '@tanstack/ai'
 
-export type WebSearchToolConfig = OpenAI.Responses.WebSearchTool
+export type { WebSearchToolConfig }
 
 /** @deprecated Renamed to `WebSearchToolConfig`. Will be removed in a future release. */
 export type WebSearchTool = WebSearchToolConfig

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

@@ -1,32 +0,0 @@
-import { BaseImageAdapter } from '@tanstack/ai/adapters';
-import { ImageGenerationOptions, ImageGenerationResult } from '@tanstack/ai';
-import { default as OpenAI_SDK } from 'openai';
-import { OpenAICompatibleClientConfig } from '../types/config.js';
-/**
- * OpenAI-Compatible Image Generation Adapter
- *
- * A generalized base class for providers that implement OpenAI-compatible image
- * generation APIs. Providers like OpenAI, Grok, and others can extend this class
- * and only need to:
- * - Set `baseURL` in the config
- * - Lock the generic type parameters to provider-specific types
- * - Override validation or request building methods for provider-specific constraints
- *
- * All methods that validate inputs, build requests, or transform responses are
- * `protected` so subclasses can override them.
- */
-export declare class OpenAICompatibleImageAdapter<TModel extends string, TProviderOptions extends object = Record<string, any>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string> = Record<string, string>> extends BaseImageAdapter<TModel, TProviderOptions, TModelProviderOptionsByName, TModelSizeByName> {
-    readonly kind: "image";
-    readonly name: string;
-    protected client: OpenAI_SDK;
-    constructor(config: OpenAICompatibleClientConfig, model: TModel, name?: string);
-    generateImages(options: ImageGenerationOptions<TProviderOptions>): Promise<ImageGenerationResult>;
-    protected buildRequest(options: ImageGenerationOptions<TProviderOptions>): OpenAI_SDK.Images.ImageGenerateParams;
-    protected transformResponse(model: string, response: OpenAI_SDK.Images.ImagesResponse): ImageGenerationResult;
-    protected validatePrompt(options: {
-        prompt: string;
-        model: string;
-    }): void;
-    protected validateImageSize(_model: string, _size: string | undefined): void;
-    protected validateNumberOfImages(_model: string, numberOfImages: number | undefined): void;
-}

package/dist/esm/adapters/image.js

@@ -1,89 +0,0 @@
-import { BaseImageAdapter } from "@tanstack/ai/adapters";
-import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
-import { generateId } from "@tanstack/ai-utils";
-import { createOpenAICompatibleClient } from "../utils/client.js";
-class OpenAICompatibleImageAdapter extends BaseImageAdapter {
-  constructor(config, model, name = "openai-compatible") {
-    super(model, {});
-    this.kind = "image";
-    this.name = name;
-    this.client = createOpenAICompatibleClient(config);
-  }
-  async generateImages(options) {
-    const { model, prompt, numberOfImages, size } = options;
-    this.validatePrompt({ prompt, model });
-    this.validateImageSize(model, size);
-    this.validateNumberOfImages(model, numberOfImages);
-    const request = this.buildRequest(options);
-    try {
-      options.logger.request(
-        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? "default"}`,
-        { provider: this.name, model }
-      );
-      const response = await this.client.images.generate({
-        ...request,
-        stream: false
-      });
-      return this.transformResponse(model, response);
-    } catch (error) {
-      options.logger.errors(`${this.name}.generateImages fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
-        source: `${this.name}.generateImages`
-      });
-      throw error;
-    }
-  }
-  buildRequest(options) {
-    const { model, prompt, numberOfImages, size, modelOptions } = options;
-    return {
-      model,
-      prompt,
-      n: numberOfImages ?? 1,
-      size,
-      ...modelOptions
-    };
-  }
-  transformResponse(model, response) {
-    const images = (response.data ?? []).flatMap(
-      (item) => {
-        const revisedPrompt = item.revised_prompt;
-        if (item.b64_json) {
-          return [{ b64Json: item.b64_json, revisedPrompt }];
-        }
-        if (item.url) {
-          return [{ url: item.url, revisedPrompt }];
-        }
-        return [];
-      }
-    );
-    return {
-      id: generateId(this.name),
-      model,
-      images,
-      usage: response.usage ? {
-        inputTokens: response.usage.input_tokens,
-        outputTokens: response.usage.output_tokens,
-        totalTokens: response.usage.total_tokens
-      } : void 0
-    };
-  }
-  validatePrompt(options) {
-    if (options.prompt.length === 0) {
-      throw new Error("Prompt cannot be empty.");
-    }
-  }
-  validateImageSize(_model, _size) {
-  }
-  validateNumberOfImages(_model, numberOfImages) {
-    if (numberOfImages === void 0) return;
-    if (numberOfImages < 1) {
-      throw new Error(
-        `Number of images must be at least 1. Requested: ${numberOfImages}`
-      );
-    }
-  }
-}
-export {
-  OpenAICompatibleImageAdapter
-};
-//# 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 { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { createOpenAICompatibleClient } from '../utils/client'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { OpenAICompatibleClientConfig } from '../types/config'\n\n/**\n * OpenAI-Compatible Image Generation Adapter\n *\n * A generalized base class for providers that implement OpenAI-compatible image\n * generation APIs. Providers like OpenAI, Grok, and others can extend this class\n * and only need to:\n * - Set `baseURL` in the config\n * - Lock the generic type parameters to provider-specific types\n * - Override validation or request building methods for provider-specific constraints\n *\n * All methods that validate inputs, build requests, or transform responses are\n * `protected` so subclasses can override them.\n */\nexport class OpenAICompatibleImageAdapter<\n  TModel extends string,\n  TProviderOptions extends object = Record<string, any>,\n  TModelProviderOptionsByName extends Record<string, any> = Record<string, any>,\n  TModelSizeByName extends Record<string, string> = Record<string, string>,\n> extends BaseImageAdapter<\n  TModel,\n  TProviderOptions,\n  TModelProviderOptionsByName,\n  TModelSizeByName\n> {\n  readonly kind = 'image' as const\n  readonly name: string\n\n  protected client: OpenAI_SDK\n\n  constructor(\n    config: OpenAICompatibleClientConfig,\n    model: TModel,\n    name: string = 'openai-compatible',\n  ) {\n    super(model, {})\n    this.name = name\n    this.client = createOpenAICompatibleClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<TProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, numberOfImages, size } = options\n\n    // Validate inputs\n    this.validatePrompt({ prompt, model })\n    this.validateImageSize(model, size)\n    this.validateNumberOfImages(model, numberOfImages)\n\n    // Build request based on model type\n    const request = this.buildRequest(options)\n\n    try {\n      options.logger.request(\n        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.images.generate({\n        ...request,\n        stream: false,\n      })\n\n      return this.transformResponse(model, response)\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\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  protected buildRequest(\n    options: ImageGenerationOptions<TProviderOptions>,\n  ): OpenAI_SDK.Images.ImageGenerateParams {\n    const { model, prompt, numberOfImages, size, modelOptions } = options\n\n    return {\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      size: size as OpenAI_SDK.Images.ImageGenerateParams['size'],\n      ...modelOptions,\n    }\n  }\n\n  protected transformResponse(\n    model: string,\n    response: OpenAI_SDK.Images.ImagesResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = (response.data ?? []).flatMap(\n      (item): Array<GeneratedImage> => {\n        const revisedPrompt = item.revised_prompt\n        if (item.b64_json) {\n          return [{ b64Json: item.b64_json, revisedPrompt }]\n        }\n        if (item.url) {\n          return [{ url: item.url, revisedPrompt }]\n        }\n        return []\n      },\n    )\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      usage: response.usage\n        ? {\n            inputTokens: response.usage.input_tokens,\n            outputTokens: response.usage.output_tokens,\n            totalTokens: response.usage.total_tokens,\n          }\n        : undefined,\n    }\n  }\n\n  protected validatePrompt(options: { prompt: string; model: string }): void {\n    if (options.prompt.length === 0) {\n      throw new Error('Prompt cannot be empty.')\n    }\n  }\n\n  protected validateImageSize(_model: string, _size: string | undefined): void {\n    // Default: no size validation — subclasses can override\n  }\n\n  protected validateNumberOfImages(\n    _model: string,\n    numberOfImages: number | undefined,\n  ): void {\n    if (numberOfImages === undefined) return\n\n    // The base adapter only enforces \"must be at least 1\". Per-provider /\n    // per-model upper bounds vary widely (some support 4, some 10, some\n    // unlimited), so concrete adapter subclasses are expected to override\n    // this method with a model-specific cap.\n    if (numberOfImages < 1) {\n      throw new Error(\n        `Number of images must be at least 1. Requested: ${numberOfImages}`,\n      )\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AAyBO,MAAM,qCAKH,iBAKR;AAAA,EAMA,YACE,QACA,OACA,OAAe,qBACf;AACA,UAAM,OAAO,EAAE;AAVjB,SAAS,OAAO;AAWd,SAAK,OAAO;AACZ,SAAK,SAAS,6BAA6B,MAAM;AAAA,EACnD;AAAA,EAEA,MAAM,eACJ,SACgC;AAChC,UAAM,EAAE,OAAO,QAAQ,gBAAgB,SAAS;AAGhD,SAAK,eAAe,EAAE,QAAQ,MAAA,CAAO;AACrC,SAAK,kBAAkB,OAAO,IAAI;AAClC,SAAK,uBAAuB,OAAO,cAAc;AAGjD,UAAM,UAAU,KAAK,aAAa,OAAO;AAEzC,QAAI;AACF,cAAQ,OAAO;AAAA,QACb,2BAA2B,KAAK,IAAI,UAAU,KAAK,MAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,QAAQ,SAAS;AAAA,QACzG,EAAE,UAAU,KAAK,MAAM,MAAA;AAAA,MAAM;AAE/B,YAAM,WAAW,MAAM,KAAK,OAAO,OAAO,SAAS;AAAA,QACjD,GAAG;AAAA,QACH,QAAQ;AAAA,MAAA,CACT;AAED,aAAO,KAAK,kBAAkB,OAAO,QAAQ;AAAA,IAC/C,SAAS,OAAgB;AAGvB,cAAQ,OAAO,OAAO,GAAG,KAAK,IAAI,yBAAyB;AAAA,QACzD,OAAO,kBAAkB,OAAO,GAAG,KAAK,IAAI,wBAAwB;AAAA,QACpE,QAAQ,GAAG,KAAK,IAAI;AAAA,MAAA,CACrB;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEU,aACR,SACuC;AACvC,UAAM,EAAE,OAAO,QAAQ,gBAAgB,MAAM,iBAAiB;AAE9D,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,GAAG,kBAAkB;AAAA,MACrB;AAAA,MACA,GAAG;AAAA,IAAA;AAAA,EAEP;AAAA,EAEU,kBACR,OACA,UACuB;AACvB,UAAM,UAAiC,SAAS,QAAQ,CAAA,GAAI;AAAA,MAC1D,CAAC,SAAgC;AAC/B,cAAM,gBAAgB,KAAK;AAC3B,YAAI,KAAK,UAAU;AACjB,iBAAO,CAAC,EAAE,SAAS,KAAK,UAAU,eAAe;AAAA,QACnD;AACA,YAAI,KAAK,KAAK;AACZ,iBAAO,CAAC,EAAE,KAAK,KAAK,KAAK,eAAe;AAAA,QAC1C;AACA,eAAO,CAAA;AAAA,MACT;AAAA,IAAA;AAGF,WAAO;AAAA,MACL,IAAI,WAAW,KAAK,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,MACA,OAAO,SAAS,QACZ;AAAA,QACE,aAAa,SAAS,MAAM;AAAA,QAC5B,cAAc,SAAS,MAAM;AAAA,QAC7B,aAAa,SAAS,MAAM;AAAA,MAAA,IAE9B;AAAA,IAAA;AAAA,EAER;AAAA,EAEU,eAAe,SAAkD;AACzE,QAAI,QAAQ,OAAO,WAAW,GAAG;AAC/B,YAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAAA,EACF;AAAA,EAEU,kBAAkB,QAAgB,OAAiC;AAAA,EAE7E;AAAA,EAEU,uBACR,QACA,gBACM;AACN,QAAI,mBAAmB,OAAW;AAMlC,QAAI,iBAAiB,GAAG;AACtB,YAAM,IAAI;AAAA,QACR,mDAAmD,cAAc;AAAA,MAAA;AAAA,IAErE;AAAA,EACF;AACF;"}

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

@@ -1,28 +0,0 @@
-import { BaseSummarizeAdapter } from '@tanstack/ai/adapters';
-import { StreamChunk, SummarizationOptions, SummarizationResult, TextOptions } from '@tanstack/ai';
-/**
- * Minimal interface for a text adapter that supports chatStream.
- * This allows the summarize adapter to work with any OpenAI-compatible
- * text adapter without tight coupling to a specific implementation.
- */
-export interface ChatStreamCapable<TProviderOptions extends object> {
-    chatStream: (options: TextOptions<TProviderOptions>) => AsyncIterable<StreamChunk>;
-}
-/**
- * OpenAI-Compatible Summarize Adapter
- *
- * A thin wrapper around a text adapter that adds summarization-specific prompting.
- * Delegates all API calls to the provided text adapter.
- *
- * Subclasses or instantiators provide a text adapter (or factory) at construction
- * time, allowing any OpenAI-compatible provider to get summarization for free by
- * reusing its text adapter.
- */
-export declare class OpenAICompatibleSummarizeAdapter<TModel extends string, TProviderOptions extends object = Record<string, any>> extends BaseSummarizeAdapter<TModel, TProviderOptions> {
-    readonly name: string;
-    private textAdapter;
-    constructor(textAdapter: ChatStreamCapable<TProviderOptions>, model: TModel, name?: string);
-    summarize(options: SummarizationOptions): Promise<SummarizationResult>;
-    summarizeStream(options: SummarizationOptions): AsyncIterable<StreamChunk>;
-    protected buildSummarizationPrompt(options: SummarizationOptions): string;
-}

package/dist/esm/adapters/summarize.js

@@ -1,112 +0,0 @@
-import { BaseSummarizeAdapter } from "@tanstack/ai/adapters";
-import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
-import { generateId } from "@tanstack/ai-utils";
-class OpenAICompatibleSummarizeAdapter extends BaseSummarizeAdapter {
-  constructor(textAdapter, model, name = "openai-compatible") {
-    super({}, model);
-    this.name = name;
-    this.textAdapter = textAdapter;
-  }
-  async summarize(options) {
-    const systemPrompt = this.buildSummarizationPrompt(options);
-    let summary = "";
-    const id = generateId(this.name);
-    let model = options.model;
-    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-    options.logger.request(
-      `activity=summarize provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? "unset"}`,
-      { provider: this.name, model: options.model }
-    );
-    try {
-      for await (const chunk of this.textAdapter.chatStream({
-        model: options.model,
-        messages: [{ role: "user", content: options.text }],
-        systemPrompts: [systemPrompt],
-        maxTokens: options.maxLength,
-        temperature: 0.3,
-        logger: options.logger
-      })) {
-        if (chunk.type === "TEXT_MESSAGE_CONTENT") {
-          if (chunk.content) {
-            summary = chunk.content;
-          } else if (chunk.delta) {
-            summary += chunk.delta;
-          }
-          model = chunk.model || model;
-        }
-        if (chunk.type === "RUN_FINISHED") {
-          if (chunk.usage) {
-            usage = chunk.usage;
-          }
-        }
-        if (chunk.type === "RUN_ERROR") {
-          const message = (chunk.error && typeof chunk.error.message === "string" ? chunk.error.message : null) ?? "Summarization failed";
-          const code = chunk.error && typeof chunk.error.code === "string" ? chunk.error.code : void 0;
-          const err = new Error(message);
-          if (code) {
-            ;
-            err.code = code;
-          }
-          throw err;
-        }
-      }
-    } catch (error) {
-      options.logger.errors(`${this.name}.summarize fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.summarize failed`),
-        source: `${this.name}.summarize`
-      });
-      throw error;
-    }
-    return { id, model, summary, usage };
-  }
-  async *summarizeStream(options) {
-    const systemPrompt = this.buildSummarizationPrompt(options);
-    options.logger.request(
-      `activity=summarizeStream provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? "unset"}`,
-      { provider: this.name, model: options.model }
-    );
-    try {
-      yield* this.textAdapter.chatStream({
-        model: options.model,
-        messages: [{ role: "user", content: options.text }],
-        systemPrompts: [systemPrompt],
-        maxTokens: options.maxLength,
-        temperature: 0.3,
-        logger: options.logger
-      });
-    } catch (error) {
-      options.logger.errors(`${this.name}.summarizeStream fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.summarizeStream failed`),
-        source: `${this.name}.summarizeStream`
-      });
-      throw error;
-    }
-  }
-  buildSummarizationPrompt(options) {
-    let prompt = "You are a professional summarizer. ";
-    switch (options.style) {
-      case "bullet-points":
-        prompt += "Provide a summary in bullet point format. ";
-        break;
-      case "paragraph":
-        prompt += "Provide a summary in paragraph format. ";
-        break;
-      case "concise":
-        prompt += "Provide a very concise summary in 1-2 sentences. ";
-        break;
-      default:
-        prompt += "Provide a clear and concise summary. ";
-    }
-    if (options.focus && options.focus.length > 0) {
-      prompt += `Focus on the following aspects: ${options.focus.join(", ")}. `;
-    }
-    if (options.maxLength) {
-      prompt += `Keep the summary under ${options.maxLength} tokens. `;
-    }
-    return prompt;
-  }
-}
-export {
-  OpenAICompatibleSummarizeAdapter
-};
-//# 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 { BaseSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n  TextOptions,\n} from '@tanstack/ai'\n\n/**\n * Minimal interface for a text adapter that supports chatStream.\n * This allows the summarize adapter to work with any OpenAI-compatible\n * text adapter without tight coupling to a specific implementation.\n */\nexport interface ChatStreamCapable<TProviderOptions extends object> {\n  chatStream: (\n    options: TextOptions<TProviderOptions>,\n  ) => AsyncIterable<StreamChunk>\n}\n\n/**\n * OpenAI-Compatible Summarize Adapter\n *\n * A thin wrapper around a text adapter that adds summarization-specific prompting.\n * Delegates all API calls to the provided text adapter.\n *\n * Subclasses or instantiators provide a text adapter (or factory) at construction\n * time, allowing any OpenAI-compatible provider to get summarization for free by\n * reusing its text adapter.\n */\nexport class OpenAICompatibleSummarizeAdapter<\n  TModel extends string,\n  TProviderOptions extends object = Record<string, any>,\n> extends BaseSummarizeAdapter<TModel, TProviderOptions> {\n  readonly name: string\n\n  private textAdapter: ChatStreamCapable<TProviderOptions>\n\n  constructor(\n    textAdapter: ChatStreamCapable<TProviderOptions>,\n    model: TModel,\n    name: string = 'openai-compatible',\n  ) {\n    super({}, model)\n    this.name = name\n    this.textAdapter = textAdapter\n  }\n\n  async summarize(options: SummarizationOptions): Promise<SummarizationResult> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    let summary = ''\n    const id = generateId(this.name)\n    let model = options.model\n    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 }\n\n    options.logger.request(\n      `activity=summarize provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    try {\n      for await (const chunk of this.textAdapter.chatStream({\n        model: options.model,\n        messages: [{ role: 'user', content: options.text }],\n        systemPrompts: [systemPrompt],\n        maxTokens: options.maxLength,\n        temperature: 0.3,\n        logger: options.logger,\n      } satisfies TextOptions<TProviderOptions>)) {\n        if (chunk.type === 'TEXT_MESSAGE_CONTENT') {\n          if (chunk.content) {\n            summary = chunk.content\n          } else if (chunk.delta) {\n            // Append delta only when present — a content-less chunk with no\n            // delta would otherwise concat literal `'undefined'`.\n            summary += chunk.delta\n          }\n          model = chunk.model || model\n        }\n        if (chunk.type === 'RUN_FINISHED') {\n          if (chunk.usage) {\n            usage = chunk.usage\n          }\n        }\n        // Surface failures: the underlying chatStream emits RUN_ERROR instead\n        // of throwing, so without this branch summarize() would return an\n        // empty summary and pretend a failed run succeeded.\n        if (chunk.type === 'RUN_ERROR') {\n          const message =\n            (chunk.error && typeof chunk.error.message === 'string'\n              ? chunk.error.message\n              : null) ?? 'Summarization failed'\n          const code =\n            chunk.error && typeof chunk.error.code === 'string'\n              ? chunk.error.code\n              : undefined\n          const err = new Error(message)\n          if (code) {\n            ;(err as Error & { code?: string }).code = code\n          }\n          throw err\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      options.logger.errors(`${this.name}.summarize fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarize failed`),\n        source: `${this.name}.summarize`,\n      })\n      throw error\n    }\n\n    return { id, model, summary, usage }\n  }\n\n  async *summarizeStream(\n    options: SummarizationOptions,\n  ): AsyncIterable<StreamChunk> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    options.logger.request(\n      `activity=summarizeStream provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    try {\n      yield* this.textAdapter.chatStream({\n        model: options.model,\n        messages: [{ role: 'user', content: options.text }],\n        systemPrompts: [systemPrompt],\n        maxTokens: options.maxLength,\n        temperature: 0.3,\n        logger: options.logger,\n      } satisfies TextOptions<TProviderOptions>)\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.summarizeStream fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarizeStream failed`),\n        source: `${this.name}.summarizeStream`,\n      })\n      throw error\n    }\n  }\n\n  protected buildSummarizationPrompt(options: SummarizationOptions): string {\n    let prompt = 'You are a professional summarizer. '\n\n    switch (options.style) {\n      case 'bullet-points':\n        prompt += 'Provide a summary in bullet point format. '\n        break\n      case 'paragraph':\n        prompt += 'Provide a summary in paragraph format. '\n        break\n      case 'concise':\n        prompt += 'Provide a very concise summary in 1-2 sentences. '\n        break\n      default:\n        prompt += 'Provide a clear and concise summary. '\n    }\n\n    if (options.focus && options.focus.length > 0) {\n      prompt += `Focus on the following aspects: ${options.focus.join(', ')}. `\n    }\n\n    if (options.maxLength) {\n      prompt += `Keep the summary under ${options.maxLength} tokens. `\n    }\n\n    return prompt\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,34 +0,0 @@
-import { BaseTranscriptionAdapter } from '@tanstack/ai/adapters';
-import { TranscriptionOptions, TranscriptionResult } from '@tanstack/ai';
-import { default as OpenAI_SDK } from 'openai';
-import { OpenAICompatibleClientConfig } from '../types/config.js';
-/**
- * OpenAI-Compatible Transcription (Speech-to-Text) Adapter
- *
- * A generalized base class for providers that implement OpenAI-compatible audio
- * transcription APIs. Providers can extend this class and only need to:
- * - Set `baseURL` in the config
- * - Lock the generic type parameters to provider-specific types
- * - Override audio handling or response mapping methods as needed
- *
- * All methods that handle audio input or map response formats are `protected`
- * so subclasses can override them.
- */
-export declare class OpenAICompatibleTranscriptionAdapter<TModel extends string, TProviderOptions extends object = Record<string, any>> extends BaseTranscriptionAdapter<TModel, TProviderOptions> {
-    readonly name: string;
-    protected client: OpenAI_SDK;
-    constructor(config: OpenAICompatibleClientConfig, model: TModel, name?: string);
-    transcribe(options: TranscriptionOptions<TProviderOptions>): Promise<TranscriptionResult>;
-    protected prepareAudioFile(audio: string | File | Blob | ArrayBuffer): File;
-    /**
-     * Checks that the global `File` constructor is available.
-     * Throws a descriptive error in environments that lack it (e.g. Node < 20).
-     */
-    private ensureFileSupport;
-    /**
-     * Whether the adapter should default to verbose_json when no response format is specified.
-     * Override in provider-specific subclasses for model-specific behavior.
-     */
-    protected shouldDefaultToVerbose(_model: string): boolean;
-    protected mapResponseFormat(format?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt'): OpenAI_SDK.Audio.TranscriptionCreateParams['response_format'];
-}

package/dist/esm/adapters/transcription.js

@@ -1,131 +0,0 @@
-import { BaseTranscriptionAdapter } from "@tanstack/ai/adapters";
-import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
-import { generateId, base64ToArrayBuffer } from "@tanstack/ai-utils";
-import { createOpenAICompatibleClient } from "../utils/client.js";
-class OpenAICompatibleTranscriptionAdapter extends BaseTranscriptionAdapter {
-  constructor(config, model, name = "openai-compatible") {
-    super(model, {});
-    this.name = name;
-    this.client = createOpenAICompatibleClient(config);
-  }
-  async transcribe(options) {
-    const { model, audio, language, prompt, responseFormat, modelOptions } = options;
-    const file = this.prepareAudioFile(audio);
-    const request = {
-      model,
-      file,
-      language,
-      prompt,
-      response_format: this.mapResponseFormat(responseFormat),
-      ...modelOptions
-    };
-    const useVerbose = responseFormat === "verbose_json" || !responseFormat && this.shouldDefaultToVerbose(model);
-    try {
-      options.logger.request(
-        `activity=transcription provider=${this.name} model=${model} verbose=${useVerbose}`,
-        { provider: this.name, model }
-      );
-      if (useVerbose) {
-        const response = await this.client.audio.transcriptions.create({
-          ...request,
-          response_format: "verbose_json"
-        });
-        return {
-          id: generateId(this.name),
-          model,
-          text: response.text,
-          language: response.language,
-          duration: response.duration,
-          segments: response.segments?.map(
-            (seg) => ({
-              id: seg.id,
-              start: seg.start,
-              end: seg.end,
-              text: seg.text,
-              // The OpenAI SDK types `avg_logprob` as `number`, so call Math.exp
-              // directly. Previously this was guarded with `seg.avg_logprob ?`
-              // which treated `0` (perfect-confidence) as missing.
-              confidence: Math.exp(seg.avg_logprob)
-            })
-          ),
-          words: response.words?.map((w) => ({
-            word: w.word,
-            start: w.start,
-            end: w.end
-          }))
-        };
-      } else {
-        const response = await this.client.audio.transcriptions.create(request);
-        return {
-          id: generateId(this.name),
-          model,
-          text: typeof response === "string" ? response : response.text,
-          language
-        };
-      }
-    } catch (error) {
-      options.logger.errors(`${this.name}.transcribe fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.transcribe failed`),
-        source: `${this.name}.transcribe`
-      });
-      throw error;
-    }
-  }
-  prepareAudioFile(audio) {
-    if (typeof File !== "undefined" && audio instanceof File) {
-      return audio;
-    }
-    if (typeof Blob !== "undefined" && audio instanceof Blob) {
-      this.ensureFileSupport();
-      return new File([audio], "audio.mp3", {
-        type: audio.type || "audio/mpeg"
-      });
-    }
-    if (typeof ArrayBuffer !== "undefined" && audio instanceof ArrayBuffer) {
-      this.ensureFileSupport();
-      return new File([audio], "audio.mp3", { type: "audio/mpeg" });
-    }
-    if (typeof audio === "string") {
-      this.ensureFileSupport();
-      if (audio.startsWith("data:")) {
-        const parts = audio.split(",");
-        const header = parts[0];
-        const base64Data = parts[1] || "";
-        const mimeMatch = header?.match(/data:([^;]+)/);
-        const mimeType = mimeMatch?.[1] || "audio/mpeg";
-        const bytes2 = base64ToArrayBuffer(base64Data);
-        const extension = mimeType.split("/")[1] || "mp3";
-        return new File([bytes2], `audio.${extension}`, { type: mimeType });
-      }
-      const bytes = base64ToArrayBuffer(audio);
-      return new File([bytes], "audio.mp3", { type: "audio/mpeg" });
-    }
-    throw new Error("Invalid audio input type");
-  }
-  /**
-   * Checks that the global `File` constructor is available.
-   * Throws a descriptive error in environments that lack it (e.g. Node < 20).
-   */
-  ensureFileSupport() {
-    if (typeof File === "undefined") {
-      throw new Error(
-        "`File` is not available in this environment. Use Node.js 20 or newer, or pass a File object directly."
-      );
-    }
-  }
-  /**
-   * Whether the adapter should default to verbose_json when no response format is specified.
-   * Override in provider-specific subclasses for model-specific behavior.
-   */
-  shouldDefaultToVerbose(_model) {
-    return false;
-  }
-  mapResponseFormat(format) {
-    if (!format) return "json";
-    return format;
-  }
-}
-export {
-  OpenAICompatibleTranscriptionAdapter
-};
-//# sourceMappingURL=transcription.js.map