@tanstack/ai 0.0.2 → 0.1.0

package/dist/esm/activities/chat/tools/zod-converter.d.ts

@@ -0,0 +1,69 @@
+import { SchemaInput } from '../../../types.js';
+/**
+ * Options for schema conversion
+ */
+export interface ConvertSchemaOptions {
+    /**
+     * When true, transforms the schema to be compatible with OpenAI's structured output requirements:
+     * - All properties are added to the `required` array
+     * - Optional fields get null added to their type union
+     * - additionalProperties is set to false for all objects
+     *
+     * @default false
+     */
+    forStructuredOutput?: boolean;
+}
+/**
+ * Converts a schema (Zod or JSONSchema) to JSON Schema format compatible with LLM providers.
+ * If the input is already a JSONSchema object, it is returned as-is.
+ * If the input is a Zod schema, it is converted to JSON Schema.
+ *
+ * @param schema - Zod schema or JSONSchema object to convert
+ * @param options - Conversion options
+ * @returns JSON Schema object that can be sent to LLM providers
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * // Using Zod schema
+ * const zodSchema = z.object({
+ *   location: z.string().describe('City name'),
+ *   unit: z.enum(['celsius', 'fahrenheit']).optional()
+ * });
+ *
+ * const jsonSchema = convertZodToJsonSchema(zodSchema);
+ * // Returns:
+ * // {
+ * //   type: 'object',
+ * //   properties: {
+ * //     location: { type: 'string', description: 'City name' },
+ * //     unit: { type: 'string', enum: ['celsius', 'fahrenheit'] }
+ * //   },
+ * //   required: ['location']
+ * // }
+ *
+ * // For OpenAI structured output (all fields required, optional fields nullable)
+ * const structuredSchema = convertZodToJsonSchema(zodSchema, { forStructuredOutput: true });
+ * // Returns:
+ * // {
+ * //   type: 'object',
+ * //   properties: {
+ * //     location: { type: 'string', description: 'City name' },
+ * //     unit: { type: ['string', 'null'], enum: ['celsius', 'fahrenheit'] }
+ * //   },
+ * //   required: ['location', 'unit'],
+ * //   additionalProperties: false
+ * // }
+ *
+ * // Using JSONSchema directly (passes through unchanged)
+ * const rawSchema = {
+ *   type: 'object',
+ *   properties: { location: { type: 'string' } },
+ *   required: ['location']
+ * };
+ * const result = convertZodToJsonSchema(rawSchema);
+ * // Returns the same object
+ * ```
+ */
+export declare function convertZodToJsonSchema(schema: SchemaInput | undefined, options?: ConvertSchemaOptions): Record<string, any> | undefined;

package/dist/esm/activities/chat/tools/zod-converter.js

@@ -0,0 +1,99 @@
+import { toJSONSchema } from "zod";
+function isZodSchema(schema) {
+  return typeof schema === "object" && schema !== null && "_zod" in schema && typeof schema._zod === "object";
+}
+function makeStructuredOutputCompatible(schema, originalRequired = []) {
+  const result = { ...schema };
+  if (result.type === "object" && result.properties) {
+    const properties = { ...result.properties };
+    const allPropertyNames = Object.keys(properties);
+    for (const propName of allPropertyNames) {
+      const prop = properties[propName];
+      const wasOptional = !originalRequired.includes(propName);
+      if (prop.type === "object" && prop.properties) {
+        properties[propName] = makeStructuredOutputCompatible(
+          prop,
+          prop.required || []
+        );
+      } else if (prop.type === "array" && prop.items) {
+        properties[propName] = {
+          ...prop,
+          items: makeStructuredOutputCompatible(
+            prop.items,
+            prop.items.required || []
+          )
+        };
+      } else if (wasOptional) {
+        if (prop.type && !Array.isArray(prop.type)) {
+          properties[propName] = {
+            ...prop,
+            type: [prop.type, "null"]
+          };
+        } else if (Array.isArray(prop.type) && !prop.type.includes("null")) {
+          properties[propName] = {
+            ...prop,
+            type: [...prop.type, "null"]
+          };
+        }
+      }
+    }
+    result.properties = properties;
+    result.required = allPropertyNames;
+    result.additionalProperties = false;
+  }
+  if (result.type === "array" && result.items) {
+    result.items = makeStructuredOutputCompatible(
+      result.items,
+      result.items.required || []
+    );
+  }
+  return result;
+}
+function convertZodToJsonSchema(schema, options = {}) {
+  if (!schema) return void 0;
+  const { forStructuredOutput = false } = options;
+  if (!isZodSchema(schema)) {
+    if (forStructuredOutput && typeof schema === "object") {
+      return makeStructuredOutputCompatible(
+        schema,
+        schema.required || []
+      );
+    }
+    return schema;
+  }
+  const jsonSchema = toJSONSchema(schema, {
+    target: "openapi-3.0",
+    reused: "ref"
+  });
+  let result = jsonSchema;
+  if (typeof result === "object" && "$schema" in result) {
+    const { $schema, ...rest } = result;
+    result = rest;
+  }
+  if (typeof result === "object") {
+    const isZodObject = typeof schema === "object" && "def" in schema && schema.def.type === "object";
+    if (isZodObject && !result.type) {
+      result.type = "object";
+    }
+    if (Object.keys(result).length === 0) {
+      result.type = "object";
+    }
+    if ("properties" in result && !result.type) {
+      result.type = "object";
+    }
+    if (result.type === "object" && !("properties" in result)) {
+      result.properties = {};
+    }
+    if (result.type === "object" && !("required" in result)) {
+      result.required = [];
+    }
+    if (forStructuredOutput) {
+      result = makeStructuredOutputCompatible(result, result.required || []);
+    }
+  }
+  return result;
+}
+export {
+  convertZodToJsonSchema
+};
+//# sourceMappingURL=zod-converter.js.map

package/dist/esm/activities/chat/tools/zod-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-converter.js","sources":["../../../../../src/activities/chat/tools/zod-converter.ts"],"sourcesContent":["import { toJSONSchema } from 'zod'\nimport type { z } from 'zod'\nimport type { SchemaInput } from '../../../types'\n\n/**\n * Check if a value is a Zod schema by looking for Zod-specific internals.\n * Zod schemas have a `_zod` property that contains metadata.\n */\nfunction isZodSchema(schema: unknown): schema is z.ZodType {\n  return (\n    typeof schema === 'object' &&\n    schema !== null &&\n    '_zod' in schema &&\n    typeof (schema as any)._zod === 'object'\n  )\n}\n\n/**\n * Transform a JSON schema to be compatible with OpenAI's structured output requirements.\n * OpenAI requires:\n * - All properties must be in the `required` array\n * - Optional fields should have null added to their type union\n * - additionalProperties must be false for objects\n *\n * @param schema - JSON schema to transform\n * @param originalRequired - Original required array (to know which fields were optional)\n * @returns Transformed schema compatible with OpenAI structured output\n */\nfunction makeStructuredOutputCompatible(\n  schema: Record<string, any>,\n  originalRequired: Array<string> = [],\n): Record<string, any> {\n  const result = { ...schema }\n\n  // Handle object types\n  if (result.type === 'object' && result.properties) {\n    const properties = { ...result.properties }\n    const allPropertyNames = Object.keys(properties)\n\n    // Transform each property\n    for (const propName of allPropertyNames) {\n      const prop = properties[propName]\n      const wasOptional = !originalRequired.includes(propName)\n\n      // Recursively transform nested objects/arrays\n      if (prop.type === 'object' && prop.properties) {\n        properties[propName] = makeStructuredOutputCompatible(\n          prop,\n          prop.required || [],\n        )\n      } else if (prop.type === 'array' && prop.items) {\n        properties[propName] = {\n          ...prop,\n          items: makeStructuredOutputCompatible(\n            prop.items,\n            prop.items.required || [],\n          ),\n        }\n      } else if (wasOptional) {\n        // Make optional fields nullable by adding null to the type\n        if (prop.type && !Array.isArray(prop.type)) {\n          properties[propName] = {\n            ...prop,\n            type: [prop.type, 'null'],\n          }\n        } else if (Array.isArray(prop.type) && !prop.type.includes('null')) {\n          properties[propName] = {\n            ...prop,\n            type: [...prop.type, 'null'],\n          }\n        }\n      }\n    }\n\n    result.properties = properties\n    // ALL properties must be required for OpenAI structured output\n    result.required = allPropertyNames\n    // additionalProperties must be false\n    result.additionalProperties = false\n  }\n\n  // Handle array types with object items\n  if (result.type === 'array' && result.items) {\n    result.items = makeStructuredOutputCompatible(\n      result.items,\n      result.items.required || [],\n    )\n  }\n\n  return result\n}\n\n/**\n * Options for schema conversion\n */\nexport interface ConvertSchemaOptions {\n  /**\n   * When true, transforms the schema to be compatible with OpenAI's structured output requirements:\n   * - All properties are added to the `required` array\n   * - Optional fields get null added to their type union\n   * - additionalProperties is set to false for all objects\n   *\n   * @default false\n   */\n  forStructuredOutput?: boolean\n}\n\n/**\n * Converts a schema (Zod or JSONSchema) to JSON Schema format compatible with LLM providers.\n * If the input is already a JSONSchema object, it is returned as-is.\n * If the input is a Zod schema, it is converted to JSON Schema.\n *\n * @param schema - Zod schema or JSONSchema object to convert\n * @param options - Conversion options\n * @returns JSON Schema object that can be sent to LLM providers\n *\n * @example\n * ```typescript\n * import { z } from 'zod';\n *\n * // Using Zod schema\n * const zodSchema = z.object({\n *   location: z.string().describe('City name'),\n *   unit: z.enum(['celsius', 'fahrenheit']).optional()\n * });\n *\n * const jsonSchema = convertZodToJsonSchema(zodSchema);\n * // Returns:\n * // {\n * //   type: 'object',\n * //   properties: {\n * //     location: { type: 'string', description: 'City name' },\n * //     unit: { type: 'string', enum: ['celsius', 'fahrenheit'] }\n * //   },\n * //   required: ['location']\n * // }\n *\n * // For OpenAI structured output (all fields required, optional fields nullable)\n * const structuredSchema = convertZodToJsonSchema(zodSchema, { forStructuredOutput: true });\n * // Returns:\n * // {\n * //   type: 'object',\n * //   properties: {\n * //     location: { type: 'string', description: 'City name' },\n * //     unit: { type: ['string', 'null'], enum: ['celsius', 'fahrenheit'] }\n * //   },\n * //   required: ['location', 'unit'],\n * //   additionalProperties: false\n * // }\n *\n * // Using JSONSchema directly (passes through unchanged)\n * const rawSchema = {\n *   type: 'object',\n *   properties: { location: { type: 'string' } },\n *   required: ['location']\n * };\n * const result = convertZodToJsonSchema(rawSchema);\n * // Returns the same object\n * ```\n */\nexport function convertZodToJsonSchema(\n  schema: SchemaInput | undefined,\n  options: ConvertSchemaOptions = {},\n): Record<string, any> | undefined {\n  if (!schema) return undefined\n\n  const { forStructuredOutput = false } = options\n\n  // If it's not a Zod schema, assume it's already a JSONSchema and pass through\n  if (!isZodSchema(schema)) {\n    // Still apply structured output transformation if requested\n    if (forStructuredOutput && typeof schema === 'object') {\n      return makeStructuredOutputCompatible(\n        schema,\n        (schema as any).required || [],\n      )\n    }\n    return schema\n  }\n\n  // Use Alcyone Labs fork which is compatible with Zod v4\n  const jsonSchema = toJSONSchema(schema, {\n    target: 'openapi-3.0',\n    reused: 'ref',\n  })\n\n  // Remove $schema property as it's not needed for LLM providers\n  let result = jsonSchema\n  if (typeof result === 'object' && '$schema' in result) {\n    const { $schema, ...rest } = result\n    result = rest\n  }\n\n  // Ensure object schemas always have type: \"object\"\n  // This fixes cases where zod-to-json-schema doesn't set type for empty objects\n  if (typeof result === 'object') {\n    // Check if the input schema is a ZodObject by inspecting its internal structure\n    const isZodObject =\n      typeof schema === 'object' &&\n      'def' in schema &&\n      schema.def.type === 'object'\n\n    // If we know it's a ZodObject but result doesn't have type, set it\n    if (isZodObject && !result.type) {\n      result.type = 'object'\n    }\n\n    // If result is completely empty (no keys), it's likely an empty object schema\n    if (Object.keys(result).length === 0) {\n      result.type = 'object'\n    }\n\n    // If it has properties (even empty), it should be an object type\n    if ('properties' in result && !result.type) {\n      result.type = 'object'\n    }\n\n    // Ensure properties exists for object types (even if empty)\n    if (result.type === 'object' && !('properties' in result)) {\n      result.properties = {}\n    }\n\n    // Ensure required exists for object types (even if empty array)\n    if (result.type === 'object' && !('required' in result)) {\n      result.required = []\n    }\n\n    // Apply structured output transformation if requested\n    if (forStructuredOutput) {\n      result = makeStructuredOutputCompatible(result, result.required || [])\n    }\n  }\n\n  return result\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/activities/generateImage/adapter.d.ts

@@ -0,0 +1,68 @@
+import { ImageGenerationOptions, ImageGenerationResult } from '../../types.js';
+/**
+ * Configuration for image adapter instances
+ */
+export interface ImageAdapterConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Image adapter interface with pre-resolved generics.
+ *
+ * An adapter is created by a provider function: `provider('model')` → `adapter`
+ * All type resolution happens at the provider call site, not in this interface.
+ *
+ * Generic parameters:
+ * - TModel: The specific model name (e.g., 'dall-e-3')
+ * - TProviderOptions: Base provider-specific options (already resolved)
+ * - TModelProviderOptionsByName: Map from model name to its specific provider options
+ * - TModelSizeByName: Map from model name to its supported sizes
+ */
+export interface ImageAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string> = Record<string, string>> {
+    /** Discriminator for adapter kind - used by generate() to determine API shape */
+    readonly kind: 'image';
+    /** Adapter name identifier */
+    readonly name: string;
+    /** The model this adapter is configured for */
+    readonly model: TModel;
+    /**
+     * @internal Type-only properties for inference. Not assigned at runtime.
+     */
+    '~types': {
+        providerOptions: TProviderOptions;
+        modelProviderOptionsByName: TModelProviderOptionsByName;
+        modelSizeByName: TModelSizeByName;
+    };
+    /**
+     * Generate images from a prompt
+     */
+    generateImages: (options: ImageGenerationOptions<TProviderOptions>) => Promise<ImageGenerationResult>;
+}
+/**
+ * An ImageAdapter with any/unknown type parameters.
+ * Useful as a constraint in generic functions and interfaces.
+ */
+export type AnyImageAdapter = ImageAdapter<any, any, any, any>;
+/**
+ * Abstract base class for image generation adapters.
+ * Extend this class to implement an image adapter for a specific provider.
+ *
+ * Generic parameters match ImageAdapter - all pre-resolved by the provider function.
+ */
+export declare abstract class BaseImageAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string> = Record<string, string>> implements ImageAdapter<TModel, TProviderOptions, TModelProviderOptionsByName, TModelSizeByName> {
+    readonly kind: "image";
+    abstract readonly name: string;
+    readonly model: TModel;
+    '~types': {
+        providerOptions: TProviderOptions;
+        modelProviderOptionsByName: TModelProviderOptionsByName;
+        modelSizeByName: TModelSizeByName;
+    };
+    protected config: ImageAdapterConfig;
+    constructor(config: ImageAdapterConfig | undefined, model: TModel);
+    abstract generateImages(options: ImageGenerationOptions<TProviderOptions>): Promise<ImageGenerationResult>;
+    protected generateId(): string;
+}

package/dist/esm/activities/generateImage/adapter.js

@@ -0,0 +1,14 @@
+class BaseImageAdapter {
+  constructor(config = {}, model) {
+    this.kind = "image";
+    this.config = config;
+    this.model = model;
+  }
+  generateId() {
+    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+  }
+}
+export {
+  BaseImageAdapter
+};
+//# sourceMappingURL=adapter.js.map

package/dist/esm/activities/generateImage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sources":["../../../../src/activities/generateImage/adapter.ts"],"sourcesContent":["import type { ImageGenerationOptions, ImageGenerationResult } from '../../types'\n\n/**\n * Configuration for image adapter instances\n */\nexport interface ImageAdapterConfig {\n  apiKey?: string\n  baseUrl?: string\n  timeout?: number\n  maxRetries?: number\n  headers?: Record<string, string>\n}\n\n/**\n * Image adapter interface with pre-resolved generics.\n *\n * An adapter is created by a provider function: `provider('model')` → `adapter`\n * All type resolution happens at the provider call site, not in this interface.\n *\n * Generic parameters:\n * - TModel: The specific model name (e.g., 'dall-e-3')\n * - TProviderOptions: Base provider-specific options (already resolved)\n * - TModelProviderOptionsByName: Map from model name to its specific provider options\n * - TModelSizeByName: Map from model name to its supported sizes\n */\nexport interface ImageAdapter<\n  TModel extends string = string,\n  TProviderOptions extends object = Record<string, unknown>,\n  TModelProviderOptionsByName extends Record<string, any> = Record<string, any>,\n  TModelSizeByName extends Record<string, string> = Record<string, string>,\n> {\n  /** Discriminator for adapter kind - used by generate() to determine API shape */\n  readonly kind: 'image'\n  /** Adapter name identifier */\n  readonly name: string\n  /** The model this adapter is configured for */\n  readonly model: TModel\n\n  /**\n   * @internal Type-only properties for inference. Not assigned at runtime.\n   */\n  '~types': {\n    providerOptions: TProviderOptions\n    modelProviderOptionsByName: TModelProviderOptionsByName\n    modelSizeByName: TModelSizeByName\n  }\n\n  /**\n   * Generate images from a prompt\n   */\n  generateImages: (\n    options: ImageGenerationOptions<TProviderOptions>,\n  ) => Promise<ImageGenerationResult>\n}\n\n/**\n * An ImageAdapter with any/unknown type parameters.\n * Useful as a constraint in generic functions and interfaces.\n */\nexport type AnyImageAdapter = ImageAdapter<any, any, any, any>\n\n/**\n * Abstract base class for image generation adapters.\n * Extend this class to implement an image adapter for a specific provider.\n *\n * Generic parameters match ImageAdapter - all pre-resolved by the provider function.\n */\nexport abstract class BaseImageAdapter<\n  TModel extends string = string,\n  TProviderOptions extends object = Record<string, unknown>,\n  TModelProviderOptionsByName extends Record<string, any> = Record<string, any>,\n  TModelSizeByName extends Record<string, string> = Record<string, string>,\n> implements ImageAdapter<\n  TModel,\n  TProviderOptions,\n  TModelProviderOptionsByName,\n  TModelSizeByName\n> {\n  readonly kind = 'image' as const\n  abstract readonly name: string\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: TProviderOptions\n    modelProviderOptionsByName: TModelProviderOptionsByName\n    modelSizeByName: TModelSizeByName\n  }\n\n  protected config: ImageAdapterConfig\n\n  constructor(config: ImageAdapterConfig = {}, model: TModel) {\n    this.config = config\n    this.model = model\n  }\n\n  abstract generateImages(\n    options: ImageGenerationOptions<TProviderOptions>,\n  ): Promise<ImageGenerationResult>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AAmEO,MAAe,iBAUpB;AAAA,EAcA,YAAY,SAA6B,CAAA,GAAI,OAAe;AAb5D,SAAS,OAAO;AAcd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAMU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,EAC9E;AACF;"}

package/dist/esm/activities/generateImage/index.d.ts

@@ -0,0 +1,89 @@
+import { ImageAdapter } from './adapter.js';
+import { ImageGenerationResult } from '../../types.js';
+/** The adapter kind this activity handles */
+export declare const kind: "image";
+/**
+ * Extract model-specific provider options from an ImageAdapter via ~types.
+ * If the model has specific options defined in ModelProviderOptions (and not just via index signature),
+ * use those; otherwise fall back to base provider options.
+ */
+export type ImageProviderOptionsForModel<TAdapter, TModel extends string> = TAdapter extends ImageAdapter<any, infer BaseOptions, infer ModelOptions, any> ? string extends keyof ModelOptions ? BaseOptions : TModel extends keyof ModelOptions ? ModelOptions[TModel] : BaseOptions : object;
+/**
+ * Extract model-specific size options from an ImageAdapter via ~types.
+ * If the model has specific sizes defined, use those; otherwise fall back to string.
+ */
+export type ImageSizeForModel<TAdapter, TModel extends string> = TAdapter extends ImageAdapter<any, any, any, infer SizeByName> ? string extends keyof SizeByName ? string : TModel extends keyof SizeByName ? SizeByName[TModel] : string : string;
+/**
+ * Options for the image activity.
+ * The model is extracted from the adapter's model property.
+ *
+ * @template TAdapter - The image adapter type
+ */
+export interface ImageActivityOptions<TAdapter extends ImageAdapter<string, object, any, any>> {
+    /** The image adapter to use (must be created with a model) */
+    adapter: TAdapter & {
+        kind: typeof kind;
+    };
+    /** Text description of the desired image(s) */
+    prompt: string;
+    /** Number of images to generate (default: 1) */
+    numberOfImages?: number;
+    /** Image size in WIDTHxHEIGHT format (e.g., "1024x1024") */
+    size?: ImageSizeForModel<TAdapter, TAdapter['model']>;
+    /** Provider-specific options for image generation */
+    modelOptions?: ImageProviderOptionsForModel<TAdapter, TAdapter['model']>;
+}
+/** Result type for the image activity */
+export type ImageActivityResult = Promise<ImageGenerationResult>;
+/**
+ * Image activity - generates images from text prompts.
+ *
+ * Uses AI image generation models to create images based on natural language descriptions.
+ *
+ * @example Generate a single image
+ * ```ts
+ * import { generateImage } from '@tanstack/ai'
+ * import { openaiImage } from '@tanstack/ai-openai'
+ *
+ * const result = await generateImage({
+ *   adapter: openaiImage('dall-e-3'),
+ *   prompt: 'A serene mountain landscape at sunset'
+ * })
+ *
+ * console.log(result.images[0].url)
+ * ```
+ *
+ * @example Generate multiple images
+ * ```ts
+ * const result = await generateImage({
+ *   adapter: openaiImage('dall-e-2'),
+ *   prompt: 'A cute robot mascot',
+ *   numberOfImages: 4,
+ *   size: '512x512'
+ * })
+ *
+ * result.images.forEach((image, i) => {
+ *   console.log(`Image ${i + 1}: ${image.url}`)
+ * })
+ * ```
+ *
+ * @example With provider-specific options
+ * ```ts
+ * const result = await generateImage({
+ *   adapter: openaiImage('dall-e-3'),
+ *   prompt: 'A professional headshot photo',
+ *   size: '1024x1024',
+ *   modelOptions: {
+ *     quality: 'hd',
+ *     style: 'natural'
+ *   }
+ * })
+ * ```
+ */
+export declare function generateImage<TAdapter extends ImageAdapter<string, object, any, any>>(options: ImageActivityOptions<TAdapter>): ImageActivityResult;
+/**
+ * Create typed options for the generateImage() function without executing.
+ */
+export declare function createImageOptions<TAdapter extends ImageAdapter<string, object, any, any>>(options: ImageActivityOptions<TAdapter>): ImageActivityOptions<TAdapter>;
+export type { ImageAdapter, ImageAdapterConfig, AnyImageAdapter, } from './adapter.js';
+export { BaseImageAdapter } from './adapter.js';

package/dist/esm/activities/generateImage/index.js

@@ -0,0 +1,15 @@
+const kind = "image";
+async function generateImage(options) {
+  const { adapter, ...rest } = options;
+  const model = adapter.model;
+  return adapter.generateImages({ ...rest, model });
+}
+function createImageOptions(options) {
+  return options;
+}
+export {
+  createImageOptions,
+  generateImage,
+  kind
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/activities/generateImage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/activities/generateImage/index.ts"],"sourcesContent":["/**\n * Image Activity\n *\n * Generates images from text prompts.\n * This is a self-contained module with implementation, types, and JSDoc.\n */\n\nimport type { ImageAdapter } from './adapter'\nimport type { ImageGenerationResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'image' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/**\n * Extract model-specific provider options from an ImageAdapter via ~types.\n * If the model has specific options defined in ModelProviderOptions (and not just via index signature),\n * use those; otherwise fall back to base provider options.\n */\nexport type ImageProviderOptionsForModel<TAdapter, TModel extends string> =\n  TAdapter extends ImageAdapter<any, infer BaseOptions, infer ModelOptions, any>\n    ? string extends keyof ModelOptions\n      ? // ModelOptions is Record<string, unknown> or has index signature - use BaseOptions\n        BaseOptions\n      : // ModelOptions has explicit keys - check if TModel is one of them\n        TModel extends keyof ModelOptions\n        ? ModelOptions[TModel]\n        : BaseOptions\n    : object\n\n/**\n * Extract model-specific size options from an ImageAdapter via ~types.\n * If the model has specific sizes defined, use those; otherwise fall back to string.\n */\nexport type ImageSizeForModel<TAdapter, TModel extends string> =\n  TAdapter extends ImageAdapter<any, any, any, infer SizeByName>\n    ? string extends keyof SizeByName\n      ? // SizeByName has index signature - fall back to string\n        string\n      : // SizeByName has explicit keys - check if TModel is one of them\n        TModel extends keyof SizeByName\n        ? SizeByName[TModel]\n        : string\n    : string\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the image activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The image adapter type\n */\nexport interface ImageActivityOptions<\n  TAdapter extends ImageAdapter<string, object, any, any>,\n> {\n  /** The image adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** Text description of the desired image(s) */\n  prompt: string\n  /** Number of images to generate (default: 1) */\n  numberOfImages?: number\n  /** Image size in WIDTHxHEIGHT format (e.g., \"1024x1024\") */\n  size?: ImageSizeForModel<TAdapter, TAdapter['model']>\n  /** Provider-specific options for image generation */\n  modelOptions?: ImageProviderOptionsForModel<TAdapter, TAdapter['model']>\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/** Result type for the image activity */\nexport type ImageActivityResult = Promise<ImageGenerationResult>\n\n// ===========================\n// Activity Implementation\n// ===========================\n\n/**\n * Image activity - generates images from text prompts.\n *\n * Uses AI image generation models to create images based on natural language descriptions.\n *\n * @example Generate a single image\n * ```ts\n * import { generateImage } from '@tanstack/ai'\n * import { openaiImage } from '@tanstack/ai-openai'\n *\n * const result = await generateImage({\n *   adapter: openaiImage('dall-e-3'),\n *   prompt: 'A serene mountain landscape at sunset'\n * })\n *\n * console.log(result.images[0].url)\n * ```\n *\n * @example Generate multiple images\n * ```ts\n * const result = await generateImage({\n *   adapter: openaiImage('dall-e-2'),\n *   prompt: 'A cute robot mascot',\n *   numberOfImages: 4,\n *   size: '512x512'\n * })\n *\n * result.images.forEach((image, i) => {\n *   console.log(`Image ${i + 1}: ${image.url}`)\n * })\n * ```\n *\n * @example With provider-specific options\n * ```ts\n * const result = await generateImage({\n *   adapter: openaiImage('dall-e-3'),\n *   prompt: 'A professional headshot photo',\n *   size: '1024x1024',\n *   modelOptions: {\n *     quality: 'hd',\n *     style: 'natural'\n *   }\n * })\n * ```\n */\nexport async function generateImage<\n  TAdapter extends ImageAdapter<string, object, any, any>,\n>(options: ImageActivityOptions<TAdapter>): ImageActivityResult {\n  const { adapter, ...rest } = options\n  const model = adapter.model\n\n  return adapter.generateImages({ ...rest, model })\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the generateImage() function without executing.\n */\nexport function createImageOptions<\n  TAdapter extends ImageAdapter<string, object, any, any>,\n>(options: ImageActivityOptions<TAdapter>): ImageActivityOptions<TAdapter> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  ImageAdapter,\n  ImageAdapterConfig,\n  AnyImageAdapter,\n} from './adapter'\nexport { BaseImageAdapter } from './adapter'\n"],"names":[],"mappings":"AAeO,MAAM,OAAO;AAsHpB,eAAsB,cAEpB,SAA8D;AAC9D,QAAM,EAAE,SAAS,GAAG,KAAA,IAAS;AAC7B,QAAM,QAAQ,QAAQ;AAEtB,SAAO,QAAQ,eAAe,EAAE,GAAG,MAAM,OAAO;AAClD;AASO,SAAS,mBAEd,SAAyE;AACzE,SAAO;AACT;"}

package/dist/esm/activities/generateSpeech/adapter.d.ts

@@ -0,0 +1,62 @@
+import { TTSOptions, TTSResult } from '../../types.js';
+/**
+ * Configuration for TTS adapter instances
+ */
+export interface TTSAdapterConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+/**
+ * TTS adapter interface with pre-resolved generics.
+ *
+ * An adapter is created by a provider function: `provider('model')` → `adapter`
+ * All type resolution happens at the provider call site, not in this interface.
+ *
+ * Generic parameters:
+ * - TModel: The specific model name (e.g., 'tts-1')
+ * - TProviderOptions: Provider-specific options (already resolved)
+ */
+export interface TTSAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> {
+    /** Discriminator for adapter kind - used to determine API shape */
+    readonly kind: 'tts';
+    /** Adapter name identifier */
+    readonly name: string;
+    /** The model this adapter is configured for */
+    readonly model: TModel;
+    /**
+     * @internal Type-only properties for inference. Not assigned at runtime.
+     */
+    '~types': {
+        providerOptions: TProviderOptions;
+    };
+    /**
+     * Generate speech from text
+     */
+    generateSpeech: (options: TTSOptions<TProviderOptions>) => Promise<TTSResult>;
+}
+/**
+ * A TTSAdapter with any/unknown type parameters.
+ * Useful as a constraint in generic functions and interfaces.
+ */
+export type AnyTTSAdapter = TTSAdapter<any, any>;
+/**
+ * Abstract base class for text-to-speech adapters.
+ * Extend this class to implement a TTS adapter for a specific provider.
+ *
+ * Generic parameters match TTSAdapter - all pre-resolved by the provider function.
+ */
+export declare abstract class BaseTTSAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> implements TTSAdapter<TModel, TProviderOptions> {
+    readonly kind: "tts";
+    abstract readonly name: string;
+    readonly model: TModel;
+    '~types': {
+        providerOptions: TProviderOptions;
+    };
+    protected config: TTSAdapterConfig;
+    constructor(config: TTSAdapterConfig | undefined, model: TModel);
+    abstract generateSpeech(options: TTSOptions<TProviderOptions>): Promise<TTSResult>;
+    protected generateId(): string;
+}

package/dist/esm/activities/generateSpeech/adapter.js

@@ -0,0 +1,14 @@
+class BaseTTSAdapter {
+  constructor(config = {}, model) {
+    this.kind = "tts";
+    this.config = config;
+    this.model = model;
+  }
+  generateId() {
+    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+  }
+}
+export {
+  BaseTTSAdapter
+};
+//# sourceMappingURL=adapter.js.map

package/dist/esm/activities/generateSpeech/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sources":["../../../../src/activities/generateSpeech/adapter.ts"],"sourcesContent":["import type { TTSOptions, TTSResult } from '../../types'\n\n/**\n * Configuration for TTS adapter instances\n */\nexport interface TTSAdapterConfig {\n  apiKey?: string\n  baseUrl?: string\n  timeout?: number\n  maxRetries?: number\n  headers?: Record<string, string>\n}\n\n/**\n * TTS adapter interface with pre-resolved generics.\n *\n * An adapter is created by a provider function: `provider('model')` → `adapter`\n * All type resolution happens at the provider call site, not in this interface.\n *\n * Generic parameters:\n * - TModel: The specific model name (e.g., 'tts-1')\n * - TProviderOptions: Provider-specific options (already resolved)\n */\nexport interface TTSAdapter<\n  TModel extends string = string,\n  TProviderOptions extends object = Record<string, unknown>,\n> {\n  /** Discriminator for adapter kind - used to determine API shape */\n  readonly kind: 'tts'\n  /** Adapter name identifier */\n  readonly name: string\n  /** The model this adapter is configured for */\n  readonly model: TModel\n\n  /**\n   * @internal Type-only properties for inference. Not assigned at runtime.\n   */\n  '~types': {\n    providerOptions: TProviderOptions\n  }\n\n  /**\n   * Generate speech from text\n   */\n  generateSpeech: (options: TTSOptions<TProviderOptions>) => Promise<TTSResult>\n}\n\n/**\n * A TTSAdapter with any/unknown type parameters.\n * Useful as a constraint in generic functions and interfaces.\n */\nexport type AnyTTSAdapter = TTSAdapter<any, any>\n\n/**\n * Abstract base class for text-to-speech adapters.\n * Extend this class to implement a TTS adapter for a specific provider.\n *\n * Generic parameters match TTSAdapter - all pre-resolved by the provider function.\n */\nexport abstract class BaseTTSAdapter<\n  TModel extends string = string,\n  TProviderOptions extends object = Record<string, unknown>,\n> implements TTSAdapter<TModel, TProviderOptions> {\n  readonly kind = 'tts' as const\n  abstract readonly name: string\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: TProviderOptions\n  }\n\n  protected config: TTSAdapterConfig\n\n  constructor(config: TTSAdapterConfig = {}, model: TModel) {\n    this.config = config\n    this.model = model\n  }\n\n  abstract generateSpeech(\n    options: TTSOptions<TProviderOptions>,\n  ): Promise<TTSResult>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AA2DO,MAAe,eAG4B;AAAA,EAYhD,YAAY,SAA2B,CAAA,GAAI,OAAe;AAX1D,SAAS,OAAO;AAYd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAMU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,EAC9E;AACF;"}

package/dist/esm/activities/generateSpeech/index.d.ts

@@ -0,0 +1,69 @@
+import { TTSAdapter } from './adapter.js';
+import { TTSResult } from '../../types.js';
+/** The adapter kind this activity handles */
+export declare const kind: "tts";
+/**
+ * Extract provider options from a TTSAdapter via ~types.
+ */
+export type TTSProviderOptions<TAdapter> = TAdapter extends TTSAdapter<any, any> ? TAdapter['~types']['providerOptions'] : object;
+/**
+ * Options for the TTS activity.
+ * The model is extracted from the adapter's model property.
+ *
+ * @template TAdapter - The TTS adapter type
+ */
+export interface TTSActivityOptions<TAdapter extends TTSAdapter<string, object>> {
+    /** The TTS adapter to use (must be created with a model) */
+    adapter: TAdapter & {
+        kind: typeof kind;
+    };
+    /** The text to convert to speech */
+    text: string;
+    /** The voice to use for generation */
+    voice?: string;
+    /** The output audio format */
+    format?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm';
+    /** The speed of the generated audio (0.25 to 4.0) */
+    speed?: number;
+    /** Provider-specific options for TTS generation */
+    modelOptions?: TTSProviderOptions<TAdapter>;
+}
+/** Result type for the TTS activity */
+export type TTSActivityResult = Promise<TTSResult>;
+/**
+ * TTS activity - generates speech from text.
+ *
+ * Uses AI text-to-speech models to create audio from natural language text.
+ *
+ * @example Generate speech from text
+ * ```ts
+ * import { generateSpeech } from '@tanstack/ai'
+ * import { openaiTTS } from '@tanstack/ai-openai'
+ *
+ * const result = await generateSpeech({
+ *   adapter: openaiTTS('tts-1-hd'),
+ *   text: 'Hello, welcome to TanStack AI!',
+ *   voice: 'nova'
+ * })
+ *
+ * console.log(result.audio) // base64-encoded audio
+ * ```
+ *
+ * @example With format and speed options
+ * ```ts
+ * const result = await generateSpeech({
+ *   adapter: openaiTTS('tts-1'),
+ *   text: 'This is slower speech.',
+ *   voice: 'alloy',
+ *   format: 'wav',
+ *   speed: 0.8
+ * })
+ * ```
+ */
+export declare function generateSpeech<TAdapter extends TTSAdapter<string, object>>(options: TTSActivityOptions<TAdapter>): TTSActivityResult;
+/**
+ * Create typed options for the generateSpeech() function without executing.
+ */
+export declare function createSpeechOptions<TAdapter extends TTSAdapter<string, object>>(options: TTSActivityOptions<TAdapter>): TTSActivityOptions<TAdapter>;
+export type { TTSAdapter, TTSAdapterConfig, AnyTTSAdapter } from './adapter.js';
+export { BaseTTSAdapter } from './adapter.js';

package/dist/esm/activities/generateSpeech/index.js

@@ -0,0 +1,15 @@
+const kind = "tts";
+async function generateSpeech(options) {
+  const { adapter, ...rest } = options;
+  const model = adapter.model;
+  return adapter.generateSpeech({ ...rest, model });
+}
+function createSpeechOptions(options) {
+  return options;
+}
+export {
+  createSpeechOptions,
+  generateSpeech,
+  kind
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/activities/generateSpeech/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/activities/generateSpeech/index.ts"],"sourcesContent":["/**\n * TTS Activity\n *\n * Generates speech audio from text using text-to-speech models.\n * This is a self-contained module with implementation, types, and JSDoc.\n */\n\nimport type { TTSAdapter } from './adapter'\nimport type { TTSResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'tts' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/**\n * Extract provider options from a TTSAdapter via ~types.\n */\nexport type TTSProviderOptions<TAdapter> =\n  TAdapter extends TTSAdapter<any, any>\n    ? TAdapter['~types']['providerOptions']\n    : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the TTS activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The TTS adapter type\n */\nexport interface TTSActivityOptions<\n  TAdapter extends TTSAdapter<string, object>,\n> {\n  /** The TTS adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** The text to convert to speech */\n  text: string\n  /** The voice to use for generation */\n  voice?: string\n  /** The output audio format */\n  format?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm'\n  /** The speed of the generated audio (0.25 to 4.0) */\n  speed?: number\n  /** Provider-specific options for TTS generation */\n  modelOptions?: TTSProviderOptions<TAdapter>\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/** Result type for the TTS activity */\nexport type TTSActivityResult = Promise<TTSResult>\n\n// ===========================\n// Activity Implementation\n// ===========================\n\n/**\n * TTS activity - generates speech from text.\n *\n * Uses AI text-to-speech models to create audio from natural language text.\n *\n * @example Generate speech from text\n * ```ts\n * import { generateSpeech } from '@tanstack/ai'\n * import { openaiTTS } from '@tanstack/ai-openai'\n *\n * const result = await generateSpeech({\n *   adapter: openaiTTS('tts-1-hd'),\n *   text: 'Hello, welcome to TanStack AI!',\n *   voice: 'nova'\n * })\n *\n * console.log(result.audio) // base64-encoded audio\n * ```\n *\n * @example With format and speed options\n * ```ts\n * const result = await generateSpeech({\n *   adapter: openaiTTS('tts-1'),\n *   text: 'This is slower speech.',\n *   voice: 'alloy',\n *   format: 'wav',\n *   speed: 0.8\n * })\n * ```\n */\nexport async function generateSpeech<\n  TAdapter extends TTSAdapter<string, object>,\n>(options: TTSActivityOptions<TAdapter>): TTSActivityResult {\n  const { adapter, ...rest } = options\n  const model = adapter.model\n\n  return adapter.generateSpeech({ ...rest, model })\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the generateSpeech() function without executing.\n */\nexport function createSpeechOptions<\n  TAdapter extends TTSAdapter<string, object>,\n>(options: TTSActivityOptions<TAdapter>): TTSActivityOptions<TAdapter> {\n  return options\n}\n\n// Re-export adapter types\nexport type { TTSAdapter, TTSAdapterConfig, AnyTTSAdapter } from './adapter'\nexport { BaseTTSAdapter } from './adapter'\n"],"names":[],"mappings":"AAeO,MAAM,OAAO;AAkFpB,eAAsB,eAEpB,SAA0D;AAC1D,QAAM,EAAE,SAAS,GAAG,KAAA,IAAS;AAC7B,QAAM,QAAQ,QAAQ;AAEtB,SAAO,QAAQ,eAAe,EAAE,GAAG,MAAM,OAAO;AAClD;AASO,SAAS,oBAEd,SAAqE;AACrE,SAAO;AACT;"}

package/dist/esm/activities/generateTranscription/adapter.d.ts

@@ -0,0 +1,62 @@
+import { TranscriptionOptions, TranscriptionResult } from '../../types.js';
+/**
+ * Configuration for transcription adapter instances
+ */
+export interface TranscriptionAdapterConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Transcription adapter interface with pre-resolved generics.
+ *
+ * An adapter is created by a provider function: `provider('model')` → `adapter`
+ * All type resolution happens at the provider call site, not in this interface.
+ *
+ * Generic parameters:
+ * - TModel: The specific model name (e.g., 'whisper-1')
+ * - TProviderOptions: Provider-specific options (already resolved)
+ */
+export interface TranscriptionAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> {
+    /** Discriminator for adapter kind - used to determine API shape */
+    readonly kind: 'transcription';
+    /** Adapter name identifier */
+    readonly name: string;
+    /** The model this adapter is configured for */
+    readonly model: TModel;
+    /**
+     * @internal Type-only properties for inference. Not assigned at runtime.
+     */
+    '~types': {
+        providerOptions: TProviderOptions;
+    };
+    /**
+     * Transcribe audio to text
+     */
+    transcribe: (options: TranscriptionOptions<TProviderOptions>) => Promise<TranscriptionResult>;
+}
+/**
+ * A TranscriptionAdapter with any/unknown type parameters.
+ * Useful as a constraint in generic functions and interfaces.
+ */
+export type AnyTranscriptionAdapter = TranscriptionAdapter<any, any>;
+/**
+ * Abstract base class for audio transcription adapters.
+ * Extend this class to implement a transcription adapter for a specific provider.
+ *
+ * Generic parameters match TranscriptionAdapter - all pre-resolved by the provider function.
+ */
+export declare abstract class BaseTranscriptionAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> implements TranscriptionAdapter<TModel, TProviderOptions> {
+    readonly kind: "transcription";
+    abstract readonly name: string;
+    readonly model: TModel;
+    '~types': {
+        providerOptions: TProviderOptions;
+    };
+    protected config: TranscriptionAdapterConfig;
+    constructor(config: TranscriptionAdapterConfig | undefined, model: TModel);
+    abstract transcribe(options: TranscriptionOptions<TProviderOptions>): Promise<TranscriptionResult>;
+    protected generateId(): string;
+}