digital-workers 2.1.3 → 2.4.0

package/dist/video.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Video generation functionality for digital workers
+ *
+ * This module provides video generation within a worker context,
+ * supporting various AI video generation models (Runway, Pika, etc.)
+ * with rich metadata about the generation process.
+ *
+ * @module
+ */
+/**
+ * Video resolution options
+ */
+export type VideoResolution = '480p' | '720p' | '1080p' | '4k';
+/**
+ * Video aspect ratio options
+ */
+export type VideoAspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '21:9';
+/**
+ * Supported video generation models
+ */
+export type VideoModel = 'runway-gen3' | 'runway-gen2' | 'pika-1.0' | 'pika-1.5' | 'stable-video' | 'minimax' | 'kling' | 'luma' | string;
+/**
+ * Video style presets
+ */
+export type VideoStyle = 'cinematic' | 'anime' | 'realistic' | 'cartoon' | 'documentary' | 'vintage' | 'noir' | 'fantasy' | 'sci-fi' | string;
+/**
+ * Options for video generation
+ */
+export interface VideoOptions {
+    /** Text prompt describing the video to generate */
+    prompt: string;
+    /** Video duration in seconds (default: 4) */
+    duration?: number;
+    /** Frames per second (default: 24) */
+    fps?: number;
+    /** Video resolution (default: '1080p') */
+    resolution?: VideoResolution;
+    /** Aspect ratio (default: '16:9') */
+    aspectRatio?: VideoAspectRatio;
+    /** Visual style preset */
+    style?: VideoStyle;
+    /** AI model to use */
+    model?: VideoModel;
+    /** Negative prompt - what to avoid */
+    negativePrompt?: string;
+    /** Guidance scale for generation (1-20) */
+    guidance?: number;
+    /** Random seed for reproducibility */
+    seed?: number;
+    /** Camera motion type */
+    motion?: 'static' | 'pan' | 'zoom' | 'orbit' | 'dolly' | 'handheld';
+    /** Motion intensity (0-1) */
+    motionIntensity?: number;
+    /** Whether to loop the video */
+    loop?: boolean;
+    /** Additional model-specific parameters */
+    modelParams?: Record<string, unknown>;
+}
+/**
+ * Metadata about the generated video
+ */
+export interface VideoMetadata {
+    /** Model used for generation */
+    model: string;
+    /** Video duration in seconds */
+    duration: number;
+    /** Video resolution */
+    resolution: string;
+    /** Frames per second */
+    fps: number;
+    /** Aspect ratio */
+    aspectRatio: string;
+    /** Generation time in milliseconds */
+    generationTime: number;
+    /** File size in bytes (if available) */
+    fileSize?: number;
+    /** Video format */
+    format?: string;
+    /** Style applied */
+    style?: string;
+    /** Seed used for generation */
+    seed?: number;
+    /** Cost in credits/tokens (if applicable) */
+    cost?: number;
+}
+/**
+ * Result of video generation
+ */
+export interface VideoResult {
+    /** URL of the generated video */
+    url: string;
+    /** Original prompt used */
+    prompt: string;
+    /** Generation metadata */
+    metadata: VideoMetadata;
+    /** Thumbnail URL (if available) */
+    thumbnail?: string;
+    /** Preview GIF URL (if available) */
+    preview?: string;
+    /** Status of generation */
+    status: 'completed' | 'processing' | 'failed';
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Options for video-from-image generation
+ */
+export interface VideoFromImageOptions extends Omit<VideoOptions, 'prompt'> {
+    /** Source image URL */
+    imageUrl: string;
+    /** Text prompt describing the desired motion/animation */
+    prompt: string;
+    /** How much the image can change (0-1) */
+    imageFidelity?: number;
+}
+/**
+ * Options for video extension
+ */
+export interface VideoExtendOptions {
+    /** Source video URL */
+    videoUrl: string;
+    /** Additional duration in seconds to add */
+    duration: number;
+    /** Prompt for the extension (optional) */
+    prompt?: string;
+    /** Direction to extend: beginning or end */
+    direction?: 'forward' | 'backward';
+    /** Overlap frames for smoother transition */
+    overlap?: number;
+}
+/**
+ * Options for video editing
+ */
+export interface VideoEditOptions {
+    /** Source video URL */
+    videoUrl: string;
+    /** Edit prompt describing changes */
+    prompt: string;
+    /** Specific region to edit (if supported) */
+    region?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Mask image URL for selective editing */
+    maskUrl?: string;
+    /** Edit strength (0-1) */
+    strength?: number;
+    /** Preserve audio from original */
+    preserveAudio?: boolean;
+}
+/**
+ * Generate a video from a text prompt.
+ *
+ * Creates AI-generated video content using models like Runway, Pika,
+ * Stable Video, and others. Returns the video URL with rich metadata
+ * about the generation process.
+ *
+ * @param prompt - Text description of the video to generate
+ * @param options - Generation options (duration, fps, resolution, model, etc.)
+ * @returns Promise resolving to VideoResult with URL and metadata
+ *
+ * @example
+ * ```ts
+ * // Basic video generation
+ * const result = await video('A serene mountain lake at sunset with gentle ripples')
+ * console.log(result.url) // URL of generated video
+ * console.log(result.metadata.duration) // Video duration in seconds
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With options
+ * const result = await video('A futuristic city with flying cars', {
+ *   duration: 8,
+ *   resolution: '4k',
+ *   style: 'cinematic',
+ *   model: 'runway-gen3',
+ *   motion: 'dolly',
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With negative prompt
+ * const result = await video('A happy golden retriever playing in a park', {
+ *   negativePrompt: 'blurry, distorted, extra limbs',
+ *   guidance: 12,
+ * })
+ * ```
+ */
+export declare function video(prompt: string, options?: Partial<VideoOptions>): Promise<VideoResult>;
+export declare namespace video {
+    var fromImage: (imageUrl: string, prompt: string, options?: Partial<Omit<VideoFromImageOptions, "imageUrl" | "prompt">>) => Promise<VideoResult>;
+    var extend: (videoUrl: string, duration: number, options?: Partial<Omit<VideoExtendOptions, "videoUrl" | "duration">>) => Promise<VideoResult>;
+    var edit: (videoUrl: string, prompt: string, options?: Partial<Omit<VideoEditOptions, "videoUrl" | "prompt">>) => Promise<VideoResult>;
+    var style: (stylePreset: VideoStyle) => (prompt: string, options?: Partial<Omit<VideoOptions, "style">>) => Promise<VideoResult>;
+    var variations: (prompt: string, count: number, options?: Partial<VideoOptions>) => Promise<VideoResult[]>;
+    var withMotion: (prompt: string, motion: "static" | "pan" | "zoom" | "orbit" | "dolly" | "handheld", options?: Partial<Omit<VideoOptions, "motion">>) => Promise<VideoResult>;
+    var loop: (prompt: string, options?: Partial<Omit<VideoOptions, "loop">>) => Promise<VideoResult>;
+}
+//# sourceMappingURL=video.d.ts.map

package/dist/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"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"}