@tanstack/ai/dist/esm/activities/generateLiveVideo/adapter.d.ts

Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.

import { LiveVideoGenerationOptions, LiveVideoGenerationResult } from '../../types.js';
/**
 * Configuration for live generation adapter instances.
 *
 * @experimental Live generation is an experimental feature and may change.
 */
export interface LiveVideoAdapterConfig {
    apiKey?: string;
    baseUrl?: string;
    timeout?: number;
    maxRetries?: number;
    headers?: Record<string, string>;
}
/**
 * Live 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. 'helios')
 * - TProviderOptions: Provider-specific options (already resolved)
 *
 * @experimental Live generation is an experimental feature and may change.
 */
export interface LiveVideoAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> {
    /** Discriminator for adapter kind - used to determine API shape */
    readonly kind: 'liveVideo';
    /** 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;
    };
    /**
     * Open a live video session from a prompt.
     *
     * Server adapters typically mint a short-lived token and return it with the
     * prompt so a browser can connect, set the prompt, and start streaming.
     */
    createLiveVideo: (options: LiveVideoGenerationOptions<TProviderOptions>) => Promise<LiveVideoGenerationResult>;
}
/**
 * A LiveVideoAdapter with any/unknown type parameters.
 * Useful as a constraint in generic functions and interfaces.
 */
export type AnyLiveVideoAdapter = LiveVideoAdapter<any, any>;
/**
 * Abstract base class for live generation adapters.
 * Extend this class to implement a live adapter for a specific provider.
 *
 * @experimental Live generation is an experimental feature and may change.
 */
export declare abstract class BaseLiveVideoAdapter<TModel extends string = string, TProviderOptions extends object = Record<string, unknown>> implements LiveVideoAdapter<TModel, TProviderOptions> {
    readonly kind: "liveVideo";
    abstract readonly name: string;
    readonly model: TModel;
    '~types': {
        providerOptions: TProviderOptions;
    };
    protected config: LiveVideoAdapterConfig;
    constructor(model: TModel, config?: LiveVideoAdapterConfig);
    abstract createLiveVideo(options: LiveVideoGenerationOptions<TProviderOptions>): Promise<LiveVideoGenerationResult>;
    protected generateId(): string;
}