@tanstack/ai 0.36.0 → 0.38.0

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

@@ -0,0 +1,145 @@
+import { ModelInputModalitiesByName, VideoGenerationOptions, VideoJobResult, VideoStatusResult, VideoUrlResult } from '../../types.js';
+/**
+ * Structured description of the durations a video model accepts.
+ *
+ * Tagged union so the same shape can express discrete enums (OpenAI Sora,
+ * Veo), continuous ranges, mixed shapes, and models with no duration field.
+ * Consumed by `VideoAdapter.availableDurations()`.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type DurationOptions<T extends string | number | undefined> = {
+    kind: 'discrete';
+    values: ReadonlyArray<NonNullable<T>>;
+} | {
+    kind: 'range';
+    min: number;
+    max: number;
+    step?: number;
+    unit: 'seconds';
+} | {
+    kind: 'mixed';
+    values: ReadonlyArray<NonNullable<T>>;
+    range?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+} | {
+    kind: 'none';
+};
+/**
+ * Configuration for video adapter instances
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export interface VideoAdapterConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Video 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.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ *
+ * Generic parameters:
+ * - TModel: The specific model name (e.g., 'sora-2')
+ * - TProviderOptions: Provider-specific options (already resolved)
+ * - TModelProviderOptionsByName: Map from model name to its specific provider options
+ * - TModelSizeByName: Map from model name to its supported sizes
+ * - TModelInputModalitiesByName: Map from model name to the non-text prompt
+ *   modalities it accepts (constrains the `prompt` part types at compile time)
+ * - TModelDurationByName: Map from model name to its supported duration
+ *   union. Defaults to `Record<string, number>` so adapters that haven't
+ *   declared a map keep today's `duration?: number` typing.
+ */
+export interface VideoAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string | undefined> = Record<string, string>, TModelInputModalitiesByName extends ModelInputModalitiesByName = ModelInputModalitiesByName, TModelDurationByName extends Record<string, string | number | undefined> = Record<string, number>> {
+    /** Discriminator for adapter kind - used to determine API shape */
+    readonly kind: 'video';
+    /** 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;
+        modelInputModalitiesByName: TModelInputModalitiesByName;
+        modelDurationByName: TModelDurationByName;
+    };
+    /**
+     * Create a new video generation job.
+     * Returns a job ID that can be used to poll for status and retrieve the video.
+     */
+    createVideoJob: (options: VideoGenerationOptions<TProviderOptions, TModelSizeByName[TModel], TModelDurationByName[TModel]>) => Promise<VideoJobResult>;
+    /**
+     * Get the current status of a video generation job.
+     */
+    getVideoStatus: (jobId: string) => Promise<VideoStatusResult>;
+    /**
+     * Get the URL to download/view the generated video.
+     * Should only be called after status is 'completed'.
+     */
+    getVideoUrl: (jobId: string) => Promise<VideoUrlResult>;
+    /**
+     * Describe the durations this adapter's model accepts. Returns a tagged
+     * union so consumers can render UI / coerce input without provider-specific
+     * knowledge.
+     */
+    availableDurations: () => DurationOptions<TModelDurationByName[TModel]>;
+    /**
+     * Coerce a raw seconds value to the closest valid duration for this model.
+     * Returns `undefined` for models with no duration field.
+     */
+    snapDuration: (seconds: number) => TModelDurationByName[TModel] | undefined;
+}
+/**
+ * A VideoAdapter with any/unknown type parameters.
+ * Useful as a constraint in generic functions and interfaces.
+ */
+export type AnyVideoAdapter = VideoAdapter<any, any, any, any, any, any>;
+/**
+ * Abstract base class for video generation adapters.
+ * Extend this class to implement a video adapter for a specific provider.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ *
+ * Generic parameters match VideoAdapter - all pre-resolved by the provider function.
+ */
+export declare abstract class BaseVideoAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelSizeByName extends Record<string, string | undefined> = Record<string, string>, TModelInputModalitiesByName extends ModelInputModalitiesByName = ModelInputModalitiesByName, TModelDurationByName extends Record<string, string | number | undefined> = Record<string, number>> implements VideoAdapter<TModel, TProviderOptions, TModelProviderOptionsByName, TModelSizeByName, TModelInputModalitiesByName, TModelDurationByName> {
+    readonly kind: "video";
+    abstract readonly name: string;
+    readonly model: TModel;
+    '~types': {
+        providerOptions: TProviderOptions;
+        modelProviderOptionsByName: TModelProviderOptionsByName;
+        modelSizeByName: TModelSizeByName;
+        modelInputModalitiesByName: TModelInputModalitiesByName;
+        modelDurationByName: TModelDurationByName;
+    };
+    protected config: VideoAdapterConfig;
+    constructor(config: VideoAdapterConfig | undefined, model: TModel);
+    abstract createVideoJob(options: VideoGenerationOptions<TProviderOptions, TModelSizeByName[TModel], TModelDurationByName[TModel]>): Promise<VideoJobResult>;
+    abstract getVideoStatus(jobId: string): Promise<VideoStatusResult>;
+    abstract getVideoUrl(jobId: string): Promise<VideoUrlResult>;
+    /**
+     * Default implementation returns `{ kind: 'none' }`. Adapters that have
+     * declared their per-model duration map should override this.
+     */
+    availableDurations(): DurationOptions<TModelDurationByName[TModel]>;
+    /**
+     * Default implementation returns `undefined`. Adapters that have declared
+     * their per-model duration map should override.
+     */
+    snapDuration(_seconds: number): TModelDurationByName[TModel] | undefined;
+    protected generateId(): string;
+}

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

@@ -0,0 +1,30 @@
+class BaseVideoAdapter {
+  kind = "video";
+  model;
+  config;
+  constructor(config = {}, model) {
+    this.config = config;
+    this.model = model;
+  }
+  /**
+   * Default implementation returns `{ kind: 'none' }`. Adapters that have
+   * declared their per-model duration map should override this.
+   */
+  availableDurations() {
+    return { kind: "none" };
+  }
+  /**
+   * Default implementation returns `undefined`. Adapters that have declared
+   * their per-model duration map should override.
+   */
+  snapDuration(_seconds) {
+    return void 0;
+  }
+  generateId() {
+    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+  }
+}
+export {
+  BaseVideoAdapter
+};
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sources":["../../../../src/activities/generateVideo/adapter.ts"],"sourcesContent":["import type {\n  ModelInputModalitiesByName,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '../../types'\n\n/**\n * Structured description of the durations a video model accepts.\n *\n * Tagged union so the same shape can express discrete enums (OpenAI Sora,\n * Veo), continuous ranges, mixed shapes, and models with no duration field.\n * Consumed by `VideoAdapter.availableDurations()`.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type DurationOptions<T extends string | number | undefined> =\n  | { kind: 'discrete'; values: ReadonlyArray<NonNullable<T>> }\n  | { kind: 'range'; min: number; max: number; step?: number; unit: 'seconds' }\n  | {\n      kind: 'mixed'\n      values: ReadonlyArray<NonNullable<T>>\n      range?: { min: number; max: number; step?: number }\n    }\n  | { kind: 'none' }\n\n/**\n * Configuration for video adapter instances\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface VideoAdapterConfig {\n  apiKey?: string\n  baseUrl?: string\n  timeout?: number\n  maxRetries?: number\n  headers?: Record<string, string>\n}\n\n/**\n * Video 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 * @experimental Video generation is an experimental feature and may change.\n *\n * Generic parameters:\n * - TModel: The specific model name (e.g., 'sora-2')\n * - TProviderOptions: 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 * - TModelInputModalitiesByName: Map from model name to the non-text prompt\n *   modalities it accepts (constrains the `prompt` part types at compile time)\n * - TModelDurationByName: Map from model name to its supported duration\n *   union. Defaults to `Record<string, number>` so adapters that haven't\n *   declared a map keep today's `duration?: number` typing.\n */\nexport interface VideoAdapter<\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 | undefined> = Record<\n    string,\n    string\n  >,\n  TModelInputModalitiesByName extends ModelInputModalitiesByName =\n    ModelInputModalitiesByName,\n  TModelDurationByName extends Record<string, string | number | undefined> =\n    Record<string, number>,\n> {\n  /** Discriminator for adapter kind - used to determine API shape */\n  readonly kind: 'video'\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    modelInputModalitiesByName: TModelInputModalitiesByName\n    modelDurationByName: TModelDurationByName\n  }\n\n  /**\n   * Create a new video generation job.\n   * Returns a job ID that can be used to poll for status and retrieve the video.\n   */\n  createVideoJob: (\n    options: VideoGenerationOptions<\n      TProviderOptions,\n      TModelSizeByName[TModel],\n      TModelDurationByName[TModel]\n    >,\n  ) => Promise<VideoJobResult>\n\n  /**\n   * Get the current status of a video generation job.\n   */\n  getVideoStatus: (jobId: string) => Promise<VideoStatusResult>\n\n  /**\n   * Get the URL to download/view the generated video.\n   * Should only be called after status is 'completed'.\n   */\n  getVideoUrl: (jobId: string) => Promise<VideoUrlResult>\n\n  /**\n   * Describe the durations this adapter's model accepts. Returns a tagged\n   * union so consumers can render UI / coerce input without provider-specific\n   * knowledge.\n   */\n  availableDurations: () => DurationOptions<TModelDurationByName[TModel]>\n\n  /**\n   * Coerce a raw seconds value to the closest valid duration for this model.\n   * Returns `undefined` for models with no duration field.\n   */\n  snapDuration: (seconds: number) => TModelDurationByName[TModel] | undefined\n}\n\n/**\n * A VideoAdapter with any/unknown type parameters.\n * Useful as a constraint in generic functions and interfaces.\n */\nexport type AnyVideoAdapter = VideoAdapter<any, any, any, any, any, any>\n\n/**\n * Abstract base class for video generation adapters.\n * Extend this class to implement a video adapter for a specific provider.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * Generic parameters match VideoAdapter - all pre-resolved by the provider function.\n */\nexport abstract class BaseVideoAdapter<\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 | undefined> = Record<\n    string,\n    string\n  >,\n  TModelInputModalitiesByName extends ModelInputModalitiesByName =\n    ModelInputModalitiesByName,\n  TModelDurationByName extends Record<string, string | number | undefined> =\n    Record<string, number>,\n> implements VideoAdapter<\n  TModel,\n  TProviderOptions,\n  TModelProviderOptionsByName,\n  TModelSizeByName,\n  TModelInputModalitiesByName,\n  TModelDurationByName\n> {\n  readonly kind = 'video' 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    modelInputModalitiesByName: TModelInputModalitiesByName\n    modelDurationByName: TModelDurationByName\n  }\n\n  protected config: VideoAdapterConfig\n\n  constructor(config: VideoAdapterConfig = {}, model: TModel) {\n    this.config = config\n    this.model = model\n  }\n\n  abstract createVideoJob(\n    options: VideoGenerationOptions<\n      TProviderOptions,\n      TModelSizeByName[TModel],\n      TModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult>\n\n  abstract getVideoStatus(jobId: string): Promise<VideoStatusResult>\n\n  abstract getVideoUrl(jobId: string): Promise<VideoUrlResult>\n\n  /**\n   * Default implementation returns `{ kind: 'none' }`. Adapters that have\n   * declared their per-model duration map should override this.\n   */\n  availableDurations(): DurationOptions<TModelDurationByName[TModel]> {\n    return { kind: 'none' }\n  }\n\n  /**\n   * Default implementation returns `undefined`. Adapters that have declared\n   * their per-model duration map should override.\n   */\n  snapDuration(_seconds: number): TModelDurationByName[TModel] | undefined {\n    return undefined\n  }\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AA6IO,MAAe,iBAmBpB;AAAA,EACS,OAAO;AAAA,EAEP;AAAA,EAWC;AAAA,EAEV,YAAY,SAA6B,CAAA,GAAI,OAAe;AAC1D,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,qBAAoE;AAClE,WAAO,EAAE,MAAM,OAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,UAA4D;AACvE,WAAO;AAAA,EACT;AAAA,EAEU,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/generateVideo/index.d.ts

@@ -0,0 +1,223 @@
+import { DebugOption } from '../../logger/types.js';
+import { GenerationMiddleware } from '../middleware.js';
+import { VideoAdapter } from './adapter.js';
+import { MediaPrompt, MediaPromptFor, StreamChunk, TokenUsage, VideoJobResult, VideoStatusResult, VideoUrlResult } from '../../types.js';
+/** The adapter kind this activity handles */
+export declare const kind: "video";
+/**
+ * Extract provider options from a VideoAdapter via ~types.
+ */
+export type VideoProviderOptions<TAdapter> = TAdapter extends VideoAdapter<any, any, any, any> ? TAdapter['~types']['providerOptions'] : object;
+/**
+ * Extract the size type for a VideoAdapter's model via ~types.
+ */
+export type VideoSizeForAdapter<TAdapter> = TAdapter extends VideoAdapter<infer TModel, any, any, infer TSizeMap> ? TModel extends keyof TSizeMap ? TSizeMap[TModel] : string : string;
+/**
+ * Extract the prompt type a model accepts from a VideoAdapter via ~types.
+ * Mirrors `ImagePromptForModel`: models in the adapter's input-modality map
+ * get a `prompt` narrowed to text + their supported part types; adapters
+ * without a map fall back to the full MediaPrompt.
+ */
+export type VideoPromptForAdapter<TAdapter> = TAdapter extends VideoAdapter<infer TModel, any, any, any, infer ModsByName> ? string extends keyof ModsByName ? MediaPrompt : TModel extends keyof ModsByName ? MediaPromptFor<ModsByName[TModel][number]> : MediaPrompt : MediaPrompt;
+/**
+ * Extract the duration type for a VideoAdapter's model via ~types.
+ * Mirrors `VideoSizeForAdapter`. Falls back to `number` for adapters that
+ * haven't declared per-model duration constraints.
+ */
+export type VideoDurationForAdapter<TAdapter> = TAdapter extends VideoAdapter<infer TModel, any, any, any, any, infer TDurationMap> ? TModel extends keyof TDurationMap ? TDurationMap[TModel] : number : number;
+/**
+ * Base options shared by all video activity operations.
+ * The model is extracted from the adapter's model property.
+ */
+interface VideoActivityBaseOptions<TAdapter extends VideoAdapter<string, any, any, any>> {
+    /** The video adapter to use (must be created with a model) */
+    adapter: TAdapter & {
+        kind: typeof kind;
+    };
+}
+/**
+ * Options for creating a new video generation job.
+ * The model is extracted from the adapter's model property.
+ *
+ * @template TAdapter - The video adapter type
+ * @template TStream - Whether to stream the output
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type VideoCreateOptions<TAdapter extends VideoAdapter<string, any, any, any>, TStream extends boolean = false> = VideoActivityBaseOptions<TAdapter> & {
+    /** Request type - create a new job (default if not specified) */
+    request?: 'create';
+    /**
+     * Description of the desired video. Either a plain string, or — for models
+     * that support image-conditioned generation — an ordered array of content
+     * parts interleaving text with image inputs. Image parts may carry
+     * `metadata.role` (`'start_frame' | 'end_frame' | 'reference' |
+     * 'character'`) to disambiguate intent; positional fallback otherwise. The
+     * accepted part types are narrowed per model via the adapter's
+     * input-modality map.
+     */
+    prompt: VideoPromptForAdapter<TAdapter>;
+    /** Video size — format depends on the provider (e.g., "16:9", "1280x720") */
+    size?: VideoSizeForAdapter<TAdapter>;
+    /**
+     * Video duration in seconds. Adapters that declare a per-model duration
+     * map narrow this to the model's valid union (e.g. `4 | 6 | 8` for Veo 3).
+     * Pass `adapter.snapDuration(seconds)` to coerce raw seconds to a valid
+     * value.
+     */
+    duration?: VideoDurationForAdapter<TAdapter>;
+    /**
+     * Whether to stream the video generation lifecycle.
+     * When true, returns an AsyncIterable<StreamChunk> that handles the full
+     * job lifecycle: create job, poll for status, yield updates, and yield final result.
+     * When false or not provided, returns a Promise<VideoJobResult>.
+     *
+     * @default false
+     */
+    stream?: TStream;
+    /** Polling interval in milliseconds (stream mode only). @default 2000 */
+    pollingInterval?: number;
+    /** Maximum time to wait before timing out in milliseconds (stream mode only). @default 600000 */
+    maxDuration?: number;
+    /** Custom run ID (stream mode only) */
+    runId?: string;
+    /**
+     * Enable debug logging. Pass `true` to enable all categories, `false` to
+     * silence everything including errors, or a `DebugConfig` object for granular
+     * control and/or a custom `Logger`.
+     */
+    debug?: DebugOption;
+    /**
+     * Observe-only middleware notified on start, usage, success, and error. Pass
+     * `otelMiddleware()` to emit OpenTelemetry spans, or implement the
+     * `GenerationMiddleware` contract for a custom backend. In streaming mode the
+     * span covers the full create→poll→complete lifecycle; in non-streaming mode
+     * it covers job submission. An abandoned stream fires `onAbort`.
+     */
+    middleware?: Array<GenerationMiddleware>;
+} & ({} extends VideoProviderOptions<TAdapter> ? {
+    /** Provider-specific options for video generation */ modelOptions?: VideoProviderOptions<TAdapter>;
+} : {
+    /** Provider-specific options for video generation */ modelOptions: VideoProviderOptions<TAdapter>;
+});
+/**
+ * Options for polling the status of a video generation job.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export interface VideoStatusOptions<TAdapter extends VideoAdapter<string, any, any, any>> extends VideoActivityBaseOptions<TAdapter> {
+    /** Request type - get job status */
+    request: 'status';
+    /** The job ID to check status for */
+    jobId: string;
+}
+/**
+ * Options for getting the URL of a completed video.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export interface VideoUrlOptions<TAdapter extends VideoAdapter<string, any, any, any>> extends VideoActivityBaseOptions<TAdapter> {
+    /** Request type - get video URL */
+    request: 'url';
+    /** The job ID to get URL for */
+    jobId: string;
+}
+/**
+ * Union type for all video activity options.
+ * Discriminated by the `request` field.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type VideoActivityOptions<TAdapter extends VideoAdapter<string, any, any, any>, TRequest extends 'create' | 'status' | 'url' = 'create', TStream extends boolean = false> = TRequest extends 'status' ? VideoStatusOptions<TAdapter> : TRequest extends 'url' ? VideoUrlOptions<TAdapter> : VideoCreateOptions<TAdapter, TStream>;
+/**
+ * Result type for the video activity, based on request type and streaming.
+ * - If stream is true (create request): AsyncIterable<StreamChunk>
+ * - Otherwise: Promise<VideoJobResult | VideoStatusResult | VideoUrlResult>
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type VideoActivityResult<TRequest extends 'create' | 'status' | 'url' = 'create', TStream extends boolean = false> = TRequest extends 'status' ? Promise<VideoStatusResult> : TRequest extends 'url' ? Promise<VideoUrlResult> : TStream extends true ? AsyncIterable<StreamChunk> : Promise<VideoJobResult>;
+/**
+ * Generate video - creates a video generation job from a text prompt.
+ *
+ * Uses AI video generation models to create videos based on natural language descriptions.
+ * Unlike image generation, video generation is asynchronous and requires polling for completion.
+ *
+ * When `stream: true` is passed, handles the full job lifecycle automatically:
+ * create job → poll for status → stream updates → yield final result.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ *
+ * @example Create a video generation job
+ * ```ts
+ * import { generateVideo } from '@tanstack/ai'
+ * import { openaiVideo } from '@tanstack/ai-openai'
+ *
+ * // Start a video generation job
+ * const { jobId } = await generateVideo({
+ *   adapter: openaiVideo('sora-2'),
+ *   prompt: 'A cat chasing a dog in a sunny park'
+ * })
+ *
+ * console.log('Job started:', jobId)
+ * ```
+ *
+ * @example Stream the full video generation lifecycle
+ * ```ts
+ * import { generateVideo, toServerSentEventsResponse } from '@tanstack/ai'
+ * import { openaiVideo } from '@tanstack/ai-openai'
+ *
+ * const stream = generateVideo({
+ *   adapter: openaiVideo('sora-2'),
+ *   prompt: 'A cat chasing a dog in a sunny park',
+ *   stream: true,
+ *   pollingInterval: 3000,
+ * })
+ *
+ * return toServerSentEventsResponse(stream)
+ * ```
+ */
+export declare function generateVideo<TAdapter extends VideoAdapter<string, any, any, any>, TStream extends boolean = false>(options: VideoCreateOptions<TAdapter, TStream>): VideoActivityResult<'create', TStream>;
+/**
+ * Get video job status - returns the current status, progress, and URL if available.
+ *
+ * This function combines status checking and URL retrieval. If the job is completed,
+ * it will automatically fetch and include the video URL.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ *
+ * @example Check job status
+ * ```ts
+ * import { getVideoJobStatus } from '@tanstack/ai'
+ * import { openaiVideo } from '@tanstack/ai-openai'
+ *
+ * const result = await getVideoJobStatus({
+ *   adapter: openaiVideo('sora-2'),
+ *   jobId: 'job-123'
+ * })
+ *
+ * console.log('Status:', result.status)
+ * console.log('Progress:', result.progress)
+ * if (result.url) {
+ *   console.log('Video URL:', result.url)
+ * }
+ * ```
+ */
+export declare function getVideoJobStatus<TAdapter extends VideoAdapter<string, any, any, any>>(options: {
+    adapter: TAdapter & {
+        kind: typeof kind;
+    };
+    jobId: string;
+}): Promise<{
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    progress?: number;
+    url?: string;
+    error?: string;
+    usage?: TokenUsage;
+}>;
+/**
+ * Create typed options for the generateVideo() function without executing.
+ */
+export declare function createVideoOptions<TAdapter extends VideoAdapter<string, any, any, any>, TStream extends boolean = false>(options: VideoCreateOptions<TAdapter, TStream>): VideoCreateOptions<TAdapter, TStream>;
+export type { VideoAdapter, VideoAdapterConfig, AnyVideoAdapter, } from './adapter.js';
+export { BaseVideoAdapter } from './adapter.js';