ugcinc 4.0.2 → 4.1.1

package/dist/types.d.ts

@@ -1,6 +1,5 @@
-import type { ImageEditorElement, ImageEditorNodeConfig, DimensionPresetKey, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, TimeValue, TimeMode, SegmentTimelinePosition, DeduplicationInput } from './render/types';
 /**
- * API response types
+ * API Response Types
  */
 export interface SuccessResponse<T> {
     code: 200;
@@ -15,2217 +14,3 @@ export interface ErrorResponse {
     data?: never;
 }
 export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
-/**
- * Account types
- */
-export interface Account {
-    id: string;
-    org_id: string;
-    type: string;
-    tag: string | null;
-    org_group: string | null;
-    user_group: string | null;
-    username: string | null;
-    nick_name: string | null;
-    pfp_url: string | null;
-    bio: string | null;
-    warmup_enabled: boolean | null;
-    warmup_version: 'original' | 'v1_smart' | 'v2_smart' | null;
-    post_version: 'original' | 'v1_custom' | null;
-    description: string | null;
-    keywords: string | null;
-    profiles: string | null;
-    niches: string | null;
-    age_range: string | null;
-    sex: string | null;
-    status: 'uninitialized' | 'pending' | 'initialized' | 'setup' | 'warming' | 'warmed' | 'needs_replacement' | 'error' | 'failed' | 'deleted';
-    phone_type: 'physical_iphone' | 'physical_android' | 'emulated_android' | 'social_api' | null;
-    oneup_social_network_id?: string | null;
-    oneup_category_id?: string | null;
-    metadata?: {
-        pending_info_change?: {
-            nick_name?: string;
-            pfp_url?: string;
-            bio?: string;
-            requested_at?: string;
-        };
-        failure_reason?: string;
-        error_type?: 'needs_replacement' | 'change_account';
-        [key: string]: unknown;
-    } | null;
-}
-export interface AccountStat {
-    id: string;
-    account_id: string;
-    followers: number | null;
-    following: number | null;
-    views: number | null;
-    likes: number | null;
-    created_at: string;
-}
-export interface AccountTask {
-    id: string;
-    account_id: string;
-    type: string;
-    status: string;
-    scheduled_time: string | null;
-    edit_profile_info: EditProfileInfo | null;
-    created_at: string;
-}
-export interface EditProfileInfo {
-    avatarUrl?: string;
-    nickName?: string;
-    bio?: string;
-}
-/**
- * Task types
- */
-export type TaskType = 'warmup_scroll' | 'warmup_search_term' | 'warmup_search_profile' | 'edit_profile' | 'update_posts';
-export interface Task {
-    id: string;
-    account_id: string;
-    type: TaskType;
-    status: string;
-    scheduled_time: string | null;
-    duration: number | null;
-    keywords: string | null;
-    edit_profile_info: EditProfileInfo | null;
-    created_at: string;
-}
-/**
- * Post types
- */
-export type PostType = 'video' | 'slideshow';
-export type PostStatus = 'scheduled' | 'pending' | 'complete' | 'failed' | 'retrying' | 'deleting' | 'deleted' | 'hidden' | 'require-approval';
-export interface Post {
-    id: string;
-    account_id: string;
-    type: PostType;
-    status: PostStatus;
-    social_id: string | null;
-    caption: string | null;
-    title: string | null;
-    media_urls: string[] | null;
-    music_post_id: string | null;
-    social_audio_id: string | null;
-    scheduled_at: string | null;
-    postUrl?: string;
-}
-export interface PostStat {
-    id: string;
-    post_id: string;
-    views: number | null;
-    likes: number | null;
-    comments: number | null;
-    shares: number | null;
-    saves: number | null;
-    created_at: string;
-}
-/**
- * Request parameter types
- */
-export interface GetAccountsParams {
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-    status?: 'uninitialized' | 'pending' | 'initialized' | 'setup' | 'warming' | 'warmed' | 'needs_replacement' | 'error' | 'failed' | 'deleted';
-}
-export interface GetAccountStatsParams {
-    accountIds?: string[];
-    startDate?: string;
-    endDate?: string;
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-}
-export interface GetAccountStatusParams {
-    accountIds?: string[];
-    includeCompleted?: boolean;
-}
-/**
- * Individual account info update for bulk operations
- */
-export interface AccountInfoUpdate {
-    accountId: string;
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-    keywords?: string;
-    profiles?: string;
-    description?: string;
-    warmupVersion?: 'original' | 'v1_smart' | 'v2_smart';
-    postVersion?: 'original' | 'v1_custom';
-    phoneType?: 'physical_iphone' | 'physical_android' | 'emulated_android' | 'social_api';
-}
-/**
- * Parameters for updating account info (bulk)
- */
-export interface UpdateAccountInfoParams {
-    updates: AccountInfoUpdate[];
-}
-/**
- * Result for individual account info update
- */
-export interface AccountInfoUpdateResult {
-    accountId: string;
-    success: boolean;
-    account?: Account;
-    error?: string;
-}
-/**
- * Response for bulk account info updates
- */
-export interface UpdateAccountInfoResponse {
-    message: string;
-    successful: number;
-    failed: number;
-    results: AccountInfoUpdateResult[];
-}
-/**
- * Individual account social update for bulk operations
- */
-export interface AccountSocialUpdate {
-    accountId: string;
-    avatarUrl?: string;
-    nickName?: string;
-    bio?: string;
-}
-/**
- * Parameters for updating account social profile (bulk)
- */
-export interface UpdateAccountSocialParams {
-    updates: AccountSocialUpdate[];
-}
-/**
- * Result for individual account social update
- */
-export interface AccountSocialUpdateResult {
-    accountId: string;
-    success: boolean;
-    error?: string;
-}
-/**
- * Response for bulk account social updates
- */
-export interface UpdateAccountSocialResponse {
-    message: string;
-    successful: number;
-    failed: number;
-    results: AccountSocialUpdateResult[];
-}
-export interface DeleteAccountPostsParams {
-    accountIds: string[];
-}
-export interface DeleteAccountPostsResponse {
-    message: string;
-    successful: number;
-    failed: number;
-    errors?: Array<{
-        accountId: string;
-        error: string;
-    }>;
-}
-export interface ResetWarmupParams {
-    accountId: string;
-    delete_activity?: boolean;
-}
-export interface ResetWarmupResponse {
-    message: string;
-    tasks_affected: number;
-    action: 'deleted' | 'reset';
-}
-export interface GetTasksParams {
-    accountIds?: string[];
-    startDate?: string;
-    endDate?: string;
-    taskType?: TaskType;
-}
-export interface GetPostsParams {
-    accountIds?: string[];
-    postIds?: string[];
-    startDate?: string;
-    endDate?: string;
-}
-export interface CreateSlideshowParams {
-    accountId: string | null;
-    caption?: string;
-    title?: string;
-    socialAudioId?: string;
-    postTime?: string;
-    imageUrls: string[];
-    strict?: boolean;
-    tag?: string;
-    user_group?: string;
-    org_group?: string;
-}
-export interface GetPostStatsParams {
-    postIds?: string[];
-    startDate?: string;
-    endDate?: string;
-}
-export interface GetPostStatusParams {
-    postId: string;
-}
-export interface CreateVideoParams {
-    accountId: string | null;
-    caption?: string;
-    socialAudioId?: string;
-    postTime?: string;
-    videoUrl: string;
-    strict?: boolean;
-    tag?: string;
-    user_group?: string;
-    org_group?: string;
-}
-export interface DeletePostsParams {
-    postIds: string[];
-}
-export interface DeletePostsResponse {
-    deleted: number;
-    deleting: number;
-    deletedIds: string[];
-    deletingIds: string[];
-    errors?: Array<{
-        postId: string;
-        error: string;
-    }>;
-}
-export interface RetryPostsParams {
-    postIds: string[];
-}
-export interface SetPostStatusParams {
-    postIds: string[];
-    status: string;
-}
-export interface SetPostStatusResponse {
-    updated: number;
-    ids: string[];
-}
-export interface RefreshStatsParams {
-    org_group?: string;
-}
-export interface RefreshStatsError {
-    accountId: string;
-    username: string;
-    error: string;
-}
-export interface RefreshStatsResponse {
-    accounts_refreshed: number;
-    accounts_failed: number;
-    total_accounts: number;
-    account_stats: AccountStat[];
-    post_stats: PostStat[];
-    post_stats_count: number;
-    errors?: RefreshStatsError[];
-}
-export interface DailyAggregatedStat {
-    date: Date | string;
-    followers: number;
-    following: number;
-    views: number;
-    likes: number;
-    posts: number;
-}
-export interface GetDailyAggregatedStatsParams {
-    startDate: string;
-    endDate: string;
-    accountIds?: string[];
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-}
-export interface DailyAccountStat {
-    date: Date | string;
-    account_id: string;
-    followers: number;
-    following: number;
-    views: number;
-    likes: number;
-}
-export interface GetDailyAccountStatsParams {
-    startDate: string;
-    endDate: string;
-    accountIds?: string[];
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-}
-export interface DailyPostStat {
-    date: Date | string;
-    post_id: string;
-    account_id: string;
-    caption: string | null;
-    media_urls: string[] | null;
-    social_id: string | null;
-    account_username: string | null;
-    account_type: string;
-    views: number;
-    likes: number;
-    comments: number;
-    shares: number;
-    saves: number;
-    views_change: number;
-    likes_change: number;
-    comments_change: number;
-    shares_change: number;
-    saves_change: number;
-}
-export interface GetDailyPostStatsParams {
-    startDate: string;
-    endDate: string;
-    accountIds?: string[];
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-}
-export interface TopAccount {
-    account_id: string;
-    username: string | null;
-    nick_name: string | null;
-    pfp_url: string | null;
-    type: string;
-    tag: string | null;
-    followers: number | null;
-    following: number | null;
-    views: number | null;
-    likes: number | null;
-    created_at: string;
-}
-export interface GetTopAccountsParams {
-    metric: 'followers' | 'following' | 'views' | 'likes';
-    limit?: number;
-    accountIds?: string[];
-    tag?: string;
-    org_group?: string;
-    user_group?: string;
-}
-export interface TopPost {
-    post_id: string;
-    account_id: string;
-    caption: string | null;
-    media_urls: string[] | null;
-    type: string;
-    social_id: string | null;
-    views: number | null;
-    likes: number | null;
-    comments: number | null;
-    shares: number | null;
-    saves: number | null;
-    created_at: string;
-}
-export interface GetTopPostsParams {
-    metric: 'views' | 'likes' | 'comments' | 'shares' | 'saves';
-    limit?: number;
-    postIds?: string[];
-}
-/**
- * Organization and API Key types
- */
-export interface ApiKey {
-    id: string;
-    name: string;
-    created_at: string;
-}
-export interface DeleteApiKeyParams {
-    apiKeyId: string;
-}
-export interface EditApiKeyParams {
-    apiKeyId: string;
-    name: string;
-}
-/**
- * Render types
- */
-interface BaseEditorConfig {
-    width: number;
-    height: number;
-    fps: number;
-    duration: number;
-}
-export type { VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, TimeValue, TimeMode, SegmentTimelinePosition, DeduplicationInput };
-export interface CropBoundary {
-    elementId?: string;
-    inputRef?: string;
-}
-export interface CropAxisConfig {
-    enabled: boolean;
-    mode: 'all-elements' | 'between-elements';
-    startBoundary?: CropBoundary;
-    endBoundary?: CropBoundary;
-    paddingStart?: number;
-    paddingEnd?: number;
-    minSize?: number;
-}
-export interface DynamicCropConfig {
-    vertical?: CropAxisConfig;
-    horizontal?: CropAxisConfig;
-}
-export type { ImageEditorElement, ImageEditorNodeConfig, DimensionPresetKey };
-export interface ImageEditorNodeInput extends Record<string, unknown> {
-    type: 'image-composer';
-    config: ImageEditorNodeConfig;
-    imageUrls: Record<string, string>;
-    textValues: Record<string, string>;
-}
-export interface ImageEditorNodeOutput extends Record<string, unknown>, NodeOutputValues {
-    width?: number;
-    height?: number;
-    aspectRatio?: string;
-}
-export interface VideoEditorNodeInput extends Record<string, unknown> {
-    type: 'video-composer';
-    editor: VideoEditorNodeConfig;
-}
-export interface EditorConfig extends BaseEditorConfig {
-    channels: Array<{
-        id: string;
-        segments: EditorSegment[];
-    }>;
-}
-export interface EditorChannel {
-    id: string;
-    segments: EditorSegment[];
-}
-/**
- * Base properties for all segments
- */
-export interface BaseSegmentProps {
-    /** Unique segment identifier */
-    id: string;
-    /** Public URL to media file */
-    source: string;
-    /** Sequence order within channel (0-based) */
-    order: number;
-    /** Time offset after previous segment starts */
-    offset: TimeValue;
-    /** Trim from start in milliseconds (default: 0) */
-    startTrim?: number;
-    /** Trim from end in milliseconds (default: 0) */
-    endTrim?: number;
-    /** Override segment duration (auto-calculated if omitted) */
-    duration?: TimeValue;
-    /**
-     * Overlay support - if parentId is set, this segment's timing is relative to the parent.
-     * The segment will appear on top of the parent segment during the specified time range.
-     */
-    /** ID of the parent segment this overlays (timing calculated relative to parent) */
-    parentId?: string;
-    /** Start time as fraction of parent duration (0-1, default: 0). Only used when parentId is set. */
-    relativeStart?: number;
-    /** End time as fraction of parent duration (0-1, default: 1). Only used when parentId is set. */
-    relativeEnd?: number;
-    /**
-     * Fade-in effect - applies a black overlay that smoothly fades out over the specified duration.
-     * The segment and all its overlays will appear to fade in from black.
-     */
-    /** Duration in milliseconds for the fade-in effect (0 or undefined = no fade) */
-    fadeIn?: number;
-}
-/**
- * Border radius configuration for individual corners.
- * All values in pixels, default 0 (no rounding).
- */
-export interface BorderRadiusConfig {
-    /** Top-left corner radius in pixels */
-    topLeft?: number;
-    /** Top-right corner radius in pixels */
-    topRight?: number;
-    /** Bottom-right corner radius in pixels */
-    bottomRight?: number;
-    /** Bottom-left corner radius in pixels */
-    bottomLeft?: number;
-}
-/**
- * Vertical anchor for Y positioning (parent element)
- * Specifies which vertical edge of the reference element to anchor to
- */
-export type VerticalAnchor = 'top' | 'bottom';
-/**
- * Horizontal anchor for X positioning (parent element)
- * Specifies which horizontal edge of the reference element to anchor to
- */
-export type HorizontalAnchor = 'left' | 'right';
-/**
- * Self anchor for X positioning
- * Specifies which horizontal edge of THIS element to use for positioning
- */
-export type HorizontalSelfAnchor = 'left' | 'center' | 'right';
-/**
- * Self anchor for Y positioning
- * Specifies which vertical edge of THIS element to use for positioning
- */
-export type VerticalSelfAnchor = 'top' | 'middle' | 'bottom';
-/** @deprecated Use VerticalAnchor or HorizontalAnchor instead */
-export type PositionAnchor = 'top' | 'bottom' | 'left' | 'right';
-/**
- * Relative X position configuration
- * When set, the segment's X position is calculated relative to another segment
- */
-export interface RelativePositionConfigX {
-    /** ID of the segment to position relative to */
-    elementId: string;
-    /** Which horizontal edge of the reference segment to anchor to */
-    anchor: HorizontalAnchor;
-    /** Which horizontal edge of THIS segment to use (default: opposite of anchor) */
-    selfAnchor?: HorizontalSelfAnchor;
-    /** Offset in pixels from the anchor point */
-    offset: number;
-}
-/**
- * Relative Y position configuration
- * When set, the segment's Y position is calculated relative to another segment
- */
-export interface RelativePositionConfigY {
-    /** ID of the segment to position relative to */
-    elementId: string;
-    /** Which vertical edge of the reference segment to anchor to */
-    anchor: VerticalAnchor;
-    /** Which vertical edge of THIS segment to use (default: opposite of anchor) */
-    selfAnchor?: VerticalSelfAnchor;
-    /** Offset in pixels from the anchor point */
-    offset: number;
-}
-/** @deprecated Use RelativePositionConfigX and RelativePositionConfigY instead */
-export interface RelativePositionConfig {
-    /** ID of the segment to position relative to */
-    elementId: string;
-    /** Which edge of the reference segment to anchor to */
-    anchor: PositionAnchor;
-    /** Offset in pixels from the anchor point (positive = away from reference) */
-    offset: number;
-}
-/**
- * Visual segment properties (video, image, text, editor)
- */
-export interface VisualSegmentProps extends BaseSegmentProps {
-    /** Horizontal position from left edge in pixels */
-    xOffset: number;
-    /** Vertical position from top edge in pixels */
-    yOffset: number;
-    /** Width in pixels */
-    width: number;
-    /** Height in pixels */
-    height: number;
-    /** Layer order - higher values appear on top (default: 0) */
-    zIndex?: number;
-    /** Scale multiplier (1.0 = 100%, 2.0 = 200%) (default: 1) */
-    scale?: number;
-    /** Rotation in degrees clockwise (default: 0) */
-    rotation?: number;
-    /** Opacity percentage 0-100 (default: 100) */
-    opacity?: number;
-    /**
-     * Relative X positioning - when set, xOffset is calculated from the reference segment
-     *
-     * @example
-     * // Position this segment to the right of another segment
-     * relativePositionX: { elementId: 'message-1', anchor: 'right', offset: 10 }
-     */
-    relativePositionX?: RelativePositionConfigX;
-    /**
-     * Relative Y positioning - when set, yOffset is calculated from the reference segment
-     * This is useful for stacking elements like text messages where the reference element's
-     * height may vary based on text content.
-     *
-     * @example
-     * // Position this segment below another segment with a 10px gap
-     * relativePositionY: { elementId: 'message-1', anchor: 'bottom', offset: 10 }
-     */
-    relativePositionY?: RelativePositionConfigY;
-    /** @deprecated Use relativePositionX and relativePositionY instead */
-    relativePosition?: RelativePositionConfig;
-}
-/**
- * Video segment - displays video content with optional audio
- * Only available for video output type
- */
-export interface VideoSegment extends VisualSegmentProps {
-    type: 'video';
-    /** How video fits in bounds: cover (fill+crop), contain (fit+letterbox), fill (stretch) (default: 'cover') */
-    fit?: 'cover' | 'contain' | 'fill';
-    /** Playback speed multiplier (0.5 = half speed, 2.0 = double speed) (default: 1) */
-    speed?: number;
-    /** Audio volume percentage 0-100 (0 = muted, 100 = full) (default: 100) */
-    volume?: number;
-    /** Corner radius - single number for all corners, or object for individual corners (default: 0) */
-    borderRadius?: number | BorderRadiusConfig;
-}
-/**
- * Audio segment - background audio or music
- * Only available for video output type
- */
-export interface AudioSegment extends BaseSegmentProps {
-    type: 'audio';
-    /** Audio volume percentage 0-100 (default: 100) */
-    volume?: number;
-}
-/**
- * Image segment - static images or animated GIFs
- * Available for both video and image output types
- */
-export interface ImageSegment extends VisualSegmentProps {
-    type: 'image';
-    /** How image fits in bounds (default: 'contain') */
-    fit?: 'cover' | 'contain' | 'fill';
-    /** Loop animated GIFs (default: false) */
-    loop?: boolean;
-    /** Corner radius - single number for all corners, or object for individual corners (default: 0) */
-    borderRadius?: number | BorderRadiusConfig;
-}
-/**
- * Text segment - rich text overlays with full typography control
- * Available for both video and image output types
- */
-export interface TextSegment extends VisualSegmentProps {
-    type: 'text';
-    source: '';
-    /** The text content (supports emojis) */
-    text: string;
-    /** Horizontal alignment (default: 'left') */
-    alignment?: 'left' | 'center' | 'right' | 'justify';
-    /** Vertical alignment within bounds (default: 'top') */
-    verticalAlign?: 'top' | 'middle' | 'bottom';
-    /** Text direction (default: 'ltr') */
-    direction?: 'ltr' | 'rtl';
-    /** Inner padding in pixels - uniform for all sides (default: 0). Overridden by individual padding values if set. */
-    padding?: number;
-    /** Top padding in pixels (overrides uniform padding) */
-    paddingTop?: number;
-    /** Right padding in pixels (overrides uniform padding) */
-    paddingRight?: number;
-    /** Bottom padding in pixels (overrides uniform padding) */
-    paddingBottom?: number;
-    /** Left padding in pixels (overrides uniform padding) */
-    paddingLeft?: number;
-    /** Font family (default: 'tiktok') */
-    fontType?: 'tiktok' | 'apple' | 'arial';
-    /** Font size in pixels (default: 40) */
-    fontSize?: number;
-    /** Font weight (default: 'normal') */
-    fontWeight?: 'normal' | 'bold';
-    /** Line height multiplier (default: 1.2) */
-    lineHeight?: number;
-    /** Letter spacing in pixels (default: 0) */
-    letterSpacing?: number;
-    /** How text wraps to new lines (default: 'word') */
-    textWrap?: 'word' | 'char' | 'none';
-    /** How words break across lines (default: 'normal') */
-    wordBreak?: 'normal' | 'break-all' | 'break-word';
-    /** Automatic hyphenation (default: 'none') */
-    hyphenation?: 'none' | 'auto';
-    /** Maximum lines (0 = unlimited) (default: 0) */
-    maxLines?: number;
-    /** How overflow is handled (default: 'clip') */
-    textOverflow?: 'clip' | 'ellipsis';
-    /** Ellipsis string for overflow (default: '...') */
-    ellipsis?: string;
-    /** Text color (default: '#FFFFFF') */
-    color?: string;
-    /** Background color in hex format #RRGGBB (default: transparent) */
-    backgroundColor?: string;
-    /** Background opacity 0-100 (default: 100) */
-    backgroundOpacity?: number;
-    /** Border radius for background box - individual corners (default: 0) */
-    backgroundBorderRadius?: BorderRadiusConfig;
-    /** Text outline color (default: none) */
-    strokeColor?: string;
-    /** Outline width in pixels (default: 0) */
-    strokeWidth?: number;
-    /** When true, box shrinks to fit content (width becomes max width) */
-    autoWidth?: boolean;
-    /** Which side the box anchors to when autoWidth is true (default: 'left') */
-    boxAlign?: 'left' | 'center' | 'right';
-}
-/**
- * Editor segment - nested composition (editor within editor)
- * Only available for video output type
- */
-export interface EditorSegment_Nested extends VisualSegmentProps {
-    type: 'editor';
-    /** Nested editor configuration */
-    editor: EditorConfig;
-    /** How rendered video fits in bounds (default: 'contain') */
-    fit?: 'cover' | 'contain' | 'fill';
-    /** Playback speed of nested composition (default: 1) */
-    speed?: number;
-    /** Audio volume of nested composition 0-100 (default: 100) */
-    volume?: number;
-}
-export type EditorSegment = VideoSegment | AudioSegment | ImageSegment | TextSegment | EditorSegment_Nested;
-export type StaticSegment = ImageSegment | TextSegment;
-/**
- * Automation types
- */
-export type MediaType = 'video' | 'image' | 'audio' | 'text';
-/**
- * Base port type - all possible value types without array modifier
- */
-export type BasePortType = 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'object' | 'account' | 'date' | 'social_audio';
-/**
- * Structured port type descriptor
- * Replaces string-based types like 'image[]' with explicit { type, isArray }
- */
-export interface PortType {
-    type: BasePortType;
-    isArray: boolean;
-}
-/**
- * Helper to create a PortType descriptor
- */
-export declare function portType({ type, isArray }: {
-    type: BasePortType;
-    isArray: boolean;
-}): PortType;
-/**
- * Format a PortType for display (e.g., { type: 'image', isArray: true } -> 'image[]')
- */
-export declare function formatPortType(port: PortType): string;
-/**
- * @deprecated Legacy string-based port type. Use PortType interface instead.
- * Kept for backwards compatibility with existing saved automations.
- */
-export type LegacyPortType = 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'object' | 'account' | 'date' | 'social_audio' | 'image[]' | 'video[]' | 'audio[]' | 'text[]' | 'number[]' | 'boolean[]' | 'object[]' | 'account[]' | 'social_audio[]';
-/**
- * @deprecated Check if a value is a legacy string port type.
- * Use for runtime detection during migration.
- */
-export declare function isLegacyPortType(value: unknown): value is LegacyPortType;
-/**
- * @deprecated Convert legacy string port type to structured PortType.
- * Use for migrating old code and data.
- */
-export declare function fromLegacyPortType(legacy: LegacyPortType): PortType;
-/**
- * @deprecated Convert structured PortType to legacy string format.
- * Use only for backwards compatibility with systems expecting string types.
- */
-export declare function toLegacyPortType(port: PortType): LegacyPortType;
-/**
- * @deprecated Normalize port type - accepts either legacy string or structured format,
- * always returns structured PortType. Use at read boundaries during migration.
- */
-export declare function normalizePortType(value: LegacyPortType | PortType): PortType;
-/**
- * @deprecated Normalize an array of port types or a single port type.
- * Handles PortType | PortType[] | LegacyPortType | LegacyPortType[] formats.
- */
-export declare function normalizePortTypes(value: LegacyPortType | PortType | LegacyPortType[] | PortType[]): PortType | PortType[];
-/**
- * Selection order configuration for media nodes
- */
-export type SelectionMode = 'random' | 'sequential';
-export type ExhaustionBehavior = 'restart' | 'error';
-export interface SelectionConfig {
-    mode?: SelectionMode;
-    enforceUniqueness?: boolean;
-    exhaustionBehavior?: ExhaustionBehavior;
-}
-export interface SelectionState {
-    usedIndices: number[];
-    currentIndex: number;
-}
-/**
- * Output mode for source nodes (image, video, audio, text)
- * - 'per-input': Generate a unique value for each consumer input (default)
- * - 'single': Use the same value for all consumer inputs
- */
-export type OutputMode = 'per-input' | 'single';
-/**
- * Standard node output format.
- * All nodes output their values in the _values array.
- * - For per-input mode: _values contains N values (one per consumer)
- * - For single mode: _values contains 1 value
- *
- * Downstream nodes always read from _values using resolveValueAtIteration().
- */
-export interface NodeOutputValues {
-    _values: unknown[];
-    _outputMode: OutputMode;
-}
-/**
- * Schema definition for a property within an array item
- */
-export interface PropertySchema {
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    /** For arrays - the item type */
-    items?: 'string' | 'number' | 'boolean' | 'object';
-    /** For nested objects or array of objects */
-    itemSchema?: Record<string, PropertySchema>;
-}
-export interface NodePort {
-    id: string;
-    type: PortType | PortType[];
-    required: boolean;
-    /** Schema of array items (when this port outputs an array) */
-    itemSchema?: Record<string, PropertySchema>;
-}
-/**
- * Port definition for resolved/dynamic ports.
- * Stored in node config when the automation is saved.
- */
-export interface ResolvedPort {
-    id: string;
-    type: PortType | PortType[];
-    required: boolean;
-    /** Schema of array items (when this port outputs an array) */
-    itemSchema?: Record<string, PropertySchema>;
-}
-/**
- * Resolved ports for nodes with dynamic inputs/outputs.
- * Stored in node config when the automation is saved, allowing validation
- * without needing to resolve ports at validation time.
- * Note: Uses simplified ResolvedPort type for database compatibility.
- */
-export interface ResolvedPorts {
-    inputs: ResolvedPort[];
-    outputs: ResolvedPort[];
-}
-/**
- * Functional category for automation nodes
- * - trigger: Nodes that start an automation (manual-trigger, recurrence)
- * - source: Nodes that provide input data (image, video, audio, social-audio, text, account)
- * - generator: Nodes that transform or generate content (image-composer, video-composer, generate-image, llm, compose-workflow)
- * - terminal: Nodes that end an automation (output, auto-post, save-to-media)
- */
-export type NodeCategory = 'trigger' | 'source' | 'generator' | 'terminal';
-export interface NodeControlConfig {
-    type: string;
-    label: string;
-    description: string;
-    /** UI display category for grouping in add node modal */
-    category: string;
-    /** Functional category for node behavior classification */
-    nodeCategory: NodeCategory;
-    inputs: NodePort[];
-    outputs: NodePort[];
-    /**
-     * If true, this node supports generating multiple unique outputs per run
-     * when outputMode is 'per-input'. Used for source nodes like image, audio, text.
-     */
-    supportsPerInputMode?: boolean;
-    /**
-     * @deprecated Use nodeCategory === 'trigger' instead
-     * If true, this is an initializer node (starts an automation).
-     * Only one initializer node is allowed per automation.
-     * Manual Trigger and Recurrence nodes are initializers.
-     */
-    isInitializer?: boolean;
-}
-export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'for-each-value' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm' | 'collect' | 'destructure';
-export interface OutputSchemaProperty {
-    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
-    items?: 'string' | 'number' | 'boolean';
-    properties?: Record<string, OutputSchemaProperty>;
-}
-/**
- * LLM output field definition for structured outputs
- */
-export interface LLMOutputField {
-    /** Required - becomes the output port ID */
-    name: string;
-    /** Optional - guides LLM on expected content */
-    description?: string;
-    /** Output type (includes 'object' for top-level objects) */
-    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
-    /** For array types - the item type (including 'object' for arrays of objects) */
-    items?: 'string' | 'number' | 'boolean' | 'object';
-    /** For array of objects or top-level objects - nested field definitions (max 3 levels of nesting) */
-    objectSchema?: LLMOutputField[];
-    /** Exact array length constraint */
-    length?: number;
-    /** Minimum array length constraint */
-    minLength?: number;
-    /** Maximum array length constraint */
-    maxLength?: number;
-    /** Whether this output is optional (can be omitted by the LLM) */
-    optional?: boolean;
-}
-/**
- * API Keys configuration for LLM providers (user can bring their own)
- */
-export interface LLMApiKeys {
-    openai?: string;
-    claude?: string;
-    gemini?: string;
-    groq?: string;
-}
-/**
- * LLM Node Configuration
- */
-export interface LLMNodeConfig {
-    provider: 'groq' | 'openai' | 'claude' | 'gemini';
-    model: string;
-    temperature?: number;
-    maxTokens?: number;
-    systemPrompt: string;
-    outputFields: LLMOutputField[];
-    useStructuredOutput?: boolean;
-    imageInputRefs?: string[];
-    videoInputRefs?: string[];
-    apiKeys?: LLMApiKeys;
-}
-/**
- * Image Generation Model IDs
- * Text-only models take just a prompt, edit models require an image input
- */
-export type ImageGenerationTextModel = 'fal-ai/gemini-3-pro-image-preview' | 'fal-ai/nano-banana-pro' | 'fal-ai/nano-banana' | 'fal-ai/gpt-image-1/text-to-image';
-export type ImageGenerationEditModel = 'fal-ai/gemini-3-pro-image-preview/edit' | 'fal-ai/nano-banana-pro/edit' | 'fal-ai/nano-banana/edit' | 'fal-ai/gpt-image-1/edit-image';
-export type ImageGenerationModel = ImageGenerationTextModel | ImageGenerationEditModel;
-/**
- * Type guard to check if model is an edit/inpaint model
- */
-export declare function isEditModel(model: ImageGenerationModel): model is ImageGenerationEditModel;
-/**
- * Image Generation Node Configuration
- */
-export interface ImageGenerationNodeConfig {
-    /** Selected model ID */
-    model: ImageGenerationModel;
-    /** Custom fal.ai API key (optional - uses platform key if not provided) */
-    apiKey?: string;
-    /** Image aspect ratio (e.g., "1:1", "16:9", "9:16") */
-    aspectRatio?: string;
-    /** Number of images to generate (default: 1) */
-    numImages?: number;
-}
-export interface WorkflowNodeDefinition {
-    id: string;
-    type: NodeTypeEnum;
-    name?: string;
-    x?: number;
-    y?: number;
-    inputs: Record<string, {
-        sourceNodeId: string;
-        sourceOutputId: string;
-    }>;
-    config?: {
-        urls?: string[];
-        selectionConfig?: SelectionConfig;
-        selectionState?: SelectionState;
-        outputMode?: OutputMode;
-        textOptions?: string[];
-        videoEditor?: VideoEditorNodeConfig;
-        imageEditor?: ImageEditorNodeConfig;
-        imageGeneration?: ImageGenerationNodeConfig;
-        llm?: LLMNodeConfig;
-        outputSchema?: Record<string, OutputSchemaProperty>;
-        provider?: 'groq' | 'openai' | 'claude' | 'gemini';
-        model?: string;
-        temperature?: number;
-        maxTokens?: number;
-        useWebSearch?: boolean;
-        useStructuredOutput?: boolean;
-        manualTriggerConfig?: ManualTriggerNodeConfig;
-        recurrenceConfig?: RecurrenceNodeConfig;
-        workflowTemplateId?: string;
-        workflowVariableNameToIdMap?: Record<string, string>;
-        workflowPassThrough?: Record<string, boolean>;
-        /** Resolved ports from the sub-workflow template (for validation) */
-        resolvedPorts?: ResolvedPorts;
-        outputConfig?: OutputNodeConfig;
-        accountConfig?: AccountNodeConfig;
-        mediaConfig?: MediaNodeConfig;
-        autoPostConfig?: AutoPostNodeConfig;
-        saveToMediaConfig?: SaveToMediaNodeConfig;
-        deduplicateConfig?: DeduplicateNodeConfig;
-        videoImportConfig?: VideoImportNodeConfig;
-        videoGeneration?: VideoGenerationNodeConfig;
-        customModelConfig?: CustomModelNodeConfig;
-        forEachConfig?: ForEachNodeConfig;
-        randomConfig?: RandomNodeConfig;
-        ifConfig?: IfNodeConfig;
-        randomRouteConfig?: RandomRouteNodeConfig;
-        branchConfig?: BranchNodeConfig;
-        autoCaptionConfig?: AutoCaptionNodeConfig;
-        screenshotAnimationConfig?: ScreenshotAnimationNodeConfig;
-        createDmConfig?: CreateDmNodeConfig;
-        collectConfig?: CollectNodeConfig;
-        destructureConfig?: DestructureNodeConfig;
-    };
-}
-export interface OutputInput {
-    id: string;
-    title?: string;
-    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account' | 'boolean' | 'object';
-    /** Individual tag for this input (overrides global tag) */
-    tag?: string;
-    /** Whether this input accepts an array */
-    isArray?: boolean;
-    /** Schema of array items (when isArray is true) */
-    itemSchema?: Record<string, PropertySchema>;
-}
-export interface OutputNodeConfig {
-    inputs: OutputInput[];
-    /** Which input is the main visual preview for the workflow */
-    mainPreviewInputId?: string;
-    saveToMedia?: boolean;
-    globalTag?: string;
-    makeUnique?: boolean;
-    createPost?: boolean;
-    requireReview?: boolean;
-}
-/**
- * Level 3 (deepest) object schema field - primitives only, no further nesting
- */
-export interface ObjectSchemaFieldLevel3 {
-    name: string;
-    type: 'string' | 'number' | 'boolean';
-}
-/**
- * Level 2 object schema field - can contain primitives, arrays of primitives, or Level 3 nested objects
- */
-export interface ObjectSchemaFieldLevel2 {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    /** For arrays - the item type (primitives only at this level) */
-    items?: 'string' | 'number' | 'boolean';
-    /** For nested objects at level 2 - can only contain primitive fields */
-    objectSchema?: ObjectSchemaFieldLevel3[];
-}
-/**
- * Level 1 (top-level) object schema field - can contain primitives, arrays (including of objects), or Level 2 nested objects
- */
-export interface ObjectSchemaField {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    /** For arrays - the item type */
-    items?: 'string' | 'number' | 'boolean' | 'object';
-    /** For nested objects or array of objects at level 1 - can contain up to one more level of nesting */
-    objectSchema?: ObjectSchemaFieldLevel2[];
-}
-/**
- * Manual Trigger node output definition
- */
-export interface ManualTriggerOutput {
-    id: string;
-    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account' | 'boolean' | 'object';
-    isArray?: boolean;
-    /** Schema for object types - describes the structure of the object */
-    objectSchema?: ObjectSchemaField[];
-}
-/**
- * Iteration mode for trigger nodes with account iteration
- * - 'fan-out': Spawn all runs simultaneously (one per account)
- * - 'sequential': One account per trigger fire, cycling through the collection
- */
-export type TriggerIterationMode = 'fan-out' | 'sequential';
-/**
- * Behavior when sequential iteration exhausts all accounts
- * - 'repeat': Start from the beginning of the collection
- * - 'stop': Stop the automation (disable schedule for recurrence)
- */
-export type IterationExhaustionBehavior = 'repeat' | 'stop';
-/**
- * Selection mode for collection inputs
- * - 'specific': Use hardcoded IDs configured at design time
- * - 'by-tag': Query items by tag at runtime (allows dynamic collections)
- */
-export type CollectionSelectionMode = 'specific' | 'by-tag';
-/**
- * Account iteration configuration for trigger nodes
- * When enabled, the trigger iterates over a collection of accounts
- */
-export interface TriggerCollectionConfig {
-    /** Whether account iteration is enabled */
-    enabled: boolean;
-    /** Selection mode: 'specific' uses accountIds, 'by-tag' queries at runtime */
-    selectionMode?: CollectionSelectionMode;
-    /** Account IDs to iterate over (used when selectionMode is 'specific' or undefined) */
-    accountIds?: string[];
-    /** Tag to query accounts by at runtime (used when selectionMode is 'by-tag') */
-    accountTag?: string;
-}
-/**
- * Manual Trigger node configuration - defines outputs that users provide when running
- */
-export interface ManualTriggerNodeConfig {
-    outputs: ManualTriggerOutput[];
-}
-/**
- * Days of the week for recurrence scheduling
- */
-export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
-/**
- * Recurrence media output port definition
- * Each output is a named port with a specific media type and its own selection config
- */
-export interface RecurrenceMediaOutput {
-    /** Unique ID for this output port (e.g., "background-image", "overlay") */
-    id: string;
-    /** Media type for this port */
-    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio';
-    /** Selection mode for this output's media source */
-    selectionMode: 'specific' | 'by-tag';
-    /** Media IDs for this output (used when selectionMode is 'specific') */
-    selectedMediaIds?: string[];
-    /** Tag to query media by at runtime (used when selectionMode is 'by-tag') */
-    mediaTag?: string;
-}
-/**
- * Media input configuration for recurrence nodes
- * Each output has its own selection configuration
- */
-export interface RecurrenceMediaConfig {
-    /** Whether media input is enabled */
-    enabled: boolean;
-    /** Named output ports - each has its own selection config */
-    outputs: RecurrenceMediaOutput[];
-}
-/**
- * Recurrence node configuration - defines when the automation runs on a schedule
- */
-export interface RecurrenceNodeConfig {
-    frequencyType: 'per-day' | 'periodic';
-    runsPerDay: number;
-    periodDays: number;
-    daysOfWeek: DayOfWeek[];
-    timingType: 'specific' | 'random-window';
-    specificTimes: string[];
-    randomWindowStart: string;
-    randomWindowEnd: string;
-    timezone: string;
-    /** Optional collection input for iterating over multiple accounts */
-    collectionInput?: TriggerCollectionConfig;
-    /** Optional media input for providing media to downstream nodes */
-    mediaInput?: RecurrenceMediaConfig;
-}
-/**
- * Account node configuration - source node for selecting accounts to post from
- */
-export interface AccountNodeConfig {
-    /** List of account IDs to choose from */
-    accountIds: string[];
-    /** Selection mode */
-    selectionConfig?: {
-        mode?: 'random' | 'sequential';
-    };
-}
-/**
- * Media node enabled type (image, video, or audio)
- * Note: text is NOT supported in the regular media node
- */
-export type MediaNodeEnabledType = 'image' | 'video' | 'audio';
-/**
- * Recurrence media enabled type
- * Includes all media types that can be output from recurrence nodes
- */
-export type RecurrenceMediaEnabledType = 'image' | 'video' | 'audio' | 'text' | 'social_audio';
-/**
- * Media node output definition
- * Each output is a named port with a specific media type
- */
-export interface MediaNodeOutput {
-    /** Unique ID for this output port (e.g., "image-1", "background-video") */
-    id: string;
-    /** Base media type for this port */
-    type: MediaNodeEnabledType;
-    /** If true, output is an array of URLs; if false, single URL */
-    isArray: boolean;
-    /** Selected media IDs for this output */
-    selectedMediaIds: string[];
-    /** Selection configuration for this output (only used when isArray is false) */
-    selectionConfig?: SelectionConfig;
-}
-/**
- * Media node configuration - consolidated source node for image, video, and audio
- */
-export interface MediaNodeConfig {
-    /** Output ports for this media node */
-    outputs: MediaNodeOutput[];
-}
-/**
- * Scheduling mode for post nodes
- * - 'scheduled': Post immediately when automation runs
- * - 'queue': Automatically schedule based on queue constraints
- */
-export type PostSchedulingMode = 'scheduled' | 'queue';
-/**
- * Post scheduling configuration for post nodes
- */
-export interface PostSchedulingConfig {
-    /** Main scheduling mode ('scheduled' = post now, 'queue' = auto-schedule) */
-    mode: PostSchedulingMode;
-    /** Minimum hours between posts for this account (min 1) */
-    minDistanceHours?: number;
-    /** Maximum posts per day for this account (min 1) */
-    maxPostsPerDay?: number;
-    /** Minimum time of day for posting (HH:mm format, e.g., '09:00') */
-    randomWindowStart?: string;
-    /** Maximum time of day for posting (HH:mm format, e.g., '21:00') */
-    randomWindowEnd?: string;
-    /** Timezone for time window (IANA timezone, e.g., 'America/New_York') */
-    timezone?: string;
-    /** If true, post will be created with 'require-approval' status instead of being posted */
-    requireApproval?: boolean;
-}
-/**
- * Auto Post mode - video or slideshow
- */
-export type AutoPostMode = 'video' | 'slideshow';
-/**
- * Auto Post input type for slideshow mode
- * - 'static': Individual image input ports (image1, image2, etc.)
- * - 'variable': Single 'images' port accepting an array
- */
-export type AutoPostInputType = 'static' | 'variable';
-/**
- * Auto Post input definition (for slideshow static mode)
- */
-export interface AutoPostInput {
-    id: string;
-}
-/**
- * Auto Post node configuration - posts a video or slideshow to social media
- */
-export interface AutoPostNodeConfig {
-    /** Post mode - video or slideshow */
-    mode: AutoPostMode;
-    /** Input type for slideshow mode (defaults to 'static') */
-    inputType?: AutoPostInputType;
-    /** Dynamic image inputs (only used in slideshow mode with inputType='static') */
-    inputs?: AutoPostInput[];
-    /** Scheduling configuration */
-    scheduling?: PostSchedulingConfig;
-    /** Social audio configuration */
-    socialAudio?: {
-        /** If true, read from input port; if false, use selectedIds */
-        isVariable: boolean;
-        /** Selected social audio IDs (when isVariable is false) - one is randomly chosen when posting */
-        selectedIds?: string[];
-    };
-}
-/**
- * Save To Media node input definition
- */
-export interface SaveToMediaInput {
-    id: string;
-    title?: string;
-    type: 'image' | 'video' | 'audio' | 'text';
-    /** Optional individual tag for this input (overrides global tag) */
-    tag?: string;
-}
-/**
- * Save To Media node configuration - saves outputs to media library
- */
-export interface SaveToMediaNodeConfig {
-    /** Dynamic inputs to save */
-    inputs: SaveToMediaInput[];
-    /** Global tag applied to all saved items */
-    globalTag?: string;
-    /** If true, append date in mm-dd-yy format to tag */
-    includeDateTag?: boolean;
-    /** If true, append run ID to make tags unique */
-    makeUnique?: boolean;
-}
-/**
- * Deduplicate node configuration - makes videos unique for social platforms
- */
-export interface DeduplicateNodeConfig {
-    /** Deduplication settings - preset level or custom config */
-    deduplication: DeduplicationInput;
-}
-/**
- * For-each output property configuration
- * Maps a property path from the item object to an output port.
- * For media array elements (image[], video[], audio[]), use empty propertyPath
- * with the corresponding media type.
- */
-export interface ForEachOutputProperty {
-    /** The output port ID (lowercase, hyphens/underscores only) */
-    portId: string;
-    /** The property path to extract from each item (e.g., "startMs", "data.value"). Empty string means the whole element. */
-    propertyPath: string;
-    /** The output type for the port */
-    type: 'text' | 'object' | 'object[]' | 'image' | 'video' | 'audio' | 'account' | 'social_audio' | 'boolean';
-}
-/**
- * For-each input port configuration
- * Defines passthrough inputs that capture single values before expansion
- * and pass them unchanged to all iterations (Mode 2: Single-Value Passthrough)
- */
-export interface ForEachInputPort {
-    /** The port ID (lowercase, hyphens/underscores only) */
-    id: string;
-    /** Display title for the port */
-    title: string;
-    /** The port type */
-    type: 'image' | 'video' | 'audio' | 'text' | 'object' | 'account' | 'social_audio' | 'boolean';
-}
-/**
- * For-each node configuration
- */
-export interface ForEachNodeConfig {
-    /** Properties to extract from each item and expose as separate outputs */
-    outputProperties?: ForEachOutputProperty[];
-    /** Input ports for single-value passthrough (Mode 2) */
-    inputPorts?: ForEachInputPort[];
-    /** Whether to expose the full item object as an output (default: false) */
-    exposeItem?: boolean;
-    /** Whether to expose the iteration index as an output (default: false) */
-    exposeIndex?: boolean;
-}
-/**
- * Random node value type - determines the type for all inputs and outputs
- */
-export type RandomValueType = 'image' | 'video' | 'audio' | 'text' | 'object' | 'account' | 'boolean';
-/**
- * Random node input port configuration (for multi-input mode)
- * Each input has an associated probability weight
- */
-export interface RandomInputPort {
-    /** The port ID (lowercase, hyphens/underscores only) */
-    id: string;
-    /** Probability weight as integer (0-100, all must sum to 100) */
-    probability: number;
-    /** Whether this input comes from a variable (input port) vs static default value. Defaults to false. */
-    isVariable?: boolean;
-    /** Default value when isVariable is false (type depends on valueType) */
-    defaultValue?: unknown;
-}
-/**
- * Random node mode
- * - 'array': Select a random element from an array input
- * - 'multi-input': Select from multiple individual inputs with weighted probabilities
- */
-export type RandomNodeMode = 'array' | 'multi-input';
-/**
- * Random node configuration - randomly selects from array or weighted inputs
- */
-export interface RandomNodeConfig {
-    /** Selection mode */
-    mode: RandomNodeMode;
-    /** Type for all inputs/outputs (enforced to be uniform) */
-    valueType: RandomValueType;
-    /** Whether to expose the selected index as an output (array mode only, default: false) */
-    exposeIndex?: boolean;
-    /** Input ports with probability weights (multi-input mode only) */
-    inputPorts?: RandomInputPort[];
-}
-/**
- * If node logic operators
- */
-export type IfLogicOperator = 'and' | 'or' | 'xor' | 'nor';
-/**
- * If node boolean input - receives boolean values for logic evaluation
- */
-export interface IfBooleanInput {
-    /** The input port ID (lowercase, hyphens/underscores only) */
-    id: string;
-}
-/**
- * If node passthrough input - values that get routed to true/false outputs
- */
-export interface IfPassthroughInput {
-    /** The input port ID (lowercase, hyphens/underscores only) */
-    id: string;
-    /** The value type */
-    type: 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'account' | 'object';
-    /** Whether this is an array type */
-    isArray?: boolean;
-}
-/**
- * If node configuration - conditional branching based on boolean logic
- */
-export interface IfNodeConfig {
-    /** Logic operator to combine boolean inputs */
-    logicOperator: IfLogicOperator;
-    /** Boolean inputs for logic evaluation (at least one required) */
-    booleanInputs: IfBooleanInput[];
-    /** Passthrough inputs that get routed to true/false outputs (at least one required) */
-    passthroughInputs: IfPassthroughInput[];
-}
-/**
- * Random Branch branch definition
- */
-export interface RandomRouteBranch {
-    /** Unique ID for this branch (e.g., "branch-1") */
-    id: string;
-    /** Probability weight (0-100, all branches must sum to 100) */
-    probability: number;
-}
-/**
- * Object field definition for Random Branch passthrough input default values
- */
-export interface RandomRouteObjectField {
-    /** Field name */
-    name: string;
-    /** Field type */
-    type: 'string' | 'number' | 'boolean';
-}
-/**
- * Random Branch passthrough input definition
- */
-export interface RandomRoutePassthroughInput {
-    /** The input port ID (lowercase, hyphens/underscores only) */
-    id: string;
-    /** The value type */
-    type: 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'account' | 'object';
-    /** Whether this is an array type */
-    isArray?: boolean;
-    /** Whether this input comes from a variable (input port) vs static default value. Defaults to false. */
-    isVariable?: boolean;
-    /** Default value when isVariable is false (type depends on type field) */
-    defaultValue?: unknown;
-    /** Object schema for object type (when type is 'object') */
-    objectSchema?: RandomRouteObjectField[];
-}
-/**
- * Random Branch node configuration - routes inputs to a randomly selected branch based on probability
- */
-export interface RandomRouteNodeConfig {
-    /** Output branches with probability weights (must sum to 100) */
-    branches: RandomRouteBranch[];
-    /** Passthrough inputs that get routed to one branch's outputs */
-    passthroughInputs: RandomRoutePassthroughInput[];
-}
-/**
- * Branch node branch definition
- */
-export interface BranchDefinition {
-    /** The key to match against (e.g., "happy", "sad", "neutral") */
-    key: string;
-}
-/**
- * Per-branch value configuration - each branch can independently be variable or static
- */
-export type BranchValueConfig = {
-    isVariable: true;
-} | {
-    isVariable: false;
-    value: unknown;
-};
-/**
- * Branch node passthrough input definition
- */
-export interface BranchPassthroughInput {
-    /** The input port ID (lowercase, hyphens/underscores only) */
-    id: string;
-    /** The value type */
-    type: 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'account' | 'object';
-    /** Whether this is an array type */
-    isArray?: boolean;
-    /** Per-branch value configuration. Key is branch key. Each branch can be variable (input port) or static (value). */
-    branchValues?: Record<string, BranchValueConfig>;
-    /** Object schema for object type (when type is 'object') */
-    objectSchema?: RandomRouteObjectField[];
-}
-/**
- * Branch node configuration - routes inputs to a branch based on key match
- */
-export interface BranchNodeConfig {
-    /** Output branches with keys to match against */
-    branches: BranchDefinition[];
-    /** Passthrough inputs that get routed to the matched branch's outputs */
-    passthroughInputs: BranchPassthroughInput[];
-    /** Optional default branch key if no match is found */
-    defaultBranchKey?: string;
-    /** Output mode - 'single' broadcasts one output to all consumers, 'per-input' creates one per consumer */
-    outputMode?: OutputMode;
-}
-/**
- * Supported platforms for video import
- * Note: YouTube is not yet implemented
- */
-export type VideoImportPlatform = 'youtube' | 'tiktok' | 'instagram';
-/**
- * Video quality options for video import
- */
-export type VideoImportQuality = '360' | '480' | '720' | '1080' | '1440' | '2160';
-/**
- * Video Import node configuration - imports videos from social media platforms
- * Note: URL is received via input port, not stored in config
- */
-export interface VideoImportNodeConfig {
-    /** Platform to import from */
-    platform: VideoImportPlatform;
-    /** Video quality preference */
-    videoQuality?: VideoImportQuality;
-}
-/**
- * Auto Caption preset styles
- */
-export type AutoCaptionPreset = 'hormozi' | 'minimal' | 'bold-pop' | 'clean' | 'neon';
-/**
- * Auto Caption font weight options
- */
-export type AutoCaptionFontWeight = 'normal' | 'bold' | 'black';
-/**
- * Auto Caption position options
- */
-export type AutoCaptionPosition = 'top' | 'center' | 'bottom';
-/**
- * Auto Caption node configuration - adds TikTok-style captions to videos
- */
-export interface AutoCaptionNodeConfig {
-    /** Preset style (if set, other values are derived from preset) */
-    preset?: AutoCaptionPreset;
-    /** Google Font name */
-    fontName?: string;
-    /** Font size in pixels (20-150) */
-    fontSize?: number;
-    /** Font weight */
-    fontWeight?: AutoCaptionFontWeight;
-    /** Main text color */
-    fontColor?: string;
-    /** Highlighted/active word color */
-    highlightColor?: string;
-    /** Text stroke/outline color */
-    strokeColor?: string;
-    /** Stroke width in pixels (0-10) */
-    strokeWidth?: number;
-    /** Background color behind text */
-    backgroundColor?: string;
-    /** Vertical position */
-    position?: AutoCaptionPosition;
-    /** Vertical offset in pixels from position anchor */
-    yOffset?: number;
-    /** Maximum width as percentage of video width (0-100) */
-    maxWidth?: number;
-    /** Words per subtitle segment (1-12) */
-    wordsPerSubtitle?: number;
-    /** Enable bounce animation effect */
-    enableAnimation?: boolean;
-    /** Language code for transcription */
-    language?: string;
-}
-/**
- * Screenshot Animation node configuration - creates an iPhone screenshot animation video
- */
-export interface ScreenshotAnimationNodeConfig {
-    /** Duration to hold at end after animation completes (ms) - default 500 */
-    holdDurationMs?: number;
-}
-/**
- * Message in a Create DM conversation
- */
-export interface CreateDmMessage {
-    /** Who sent this message */
-    sender: 'user' | 'recipient';
-    /** Message text content */
-    text: string;
-    /** Whether this message has an associated image (story reply for IG, sender image for iMessage) */
-    hasImage?: boolean;
-}
-/**
- * Create DM node configuration - renders fake DM conversations for iMessage or Instagram
- */
-export interface CreateDmNodeConfig {
-    /** Platform to render */
-    platform: 'imessage' | 'instagram';
-    /** Whether platform comes from input port */
-    platformIsVariable?: boolean;
-    /** Light or dark mode */
-    lightMode: boolean;
-    /** Whether light mode comes from input port */
-    lightModeIsVariable?: boolean;
-    /** Username displayed in header */
-    username: string;
-    /** Whether username comes from input port */
-    usernameIsVariable?: boolean;
-    /** Status bar time */
-    time: string;
-    /** Whether status bar time comes from input port */
-    timeIsVariable?: boolean;
-    /** Profile picture URL (fallback if profilePic input not connected) */
-    profilePicUrl?: string;
-    /** Whether profile pic comes from input port */
-    profilePicIsVariable?: boolean;
-    /** Source of messages: 'config' uses static messages, 'input' uses messages from input port */
-    messagesSource: 'config' | 'input';
-    /** Static messages (used when messagesSource === 'config') */
-    messages?: CreateDmMessage[];
-    /** Image attachment URL (story reply for IG, sender image for iMessage) */
-    imageAttachmentUrl?: string;
-    /** Whether image attachment comes from input port */
-    imageAttachmentIsVariable?: boolean;
-    /** iMessage-specific settings */
-    imessage?: {
-        senderBubbleColor?: string;
-        showReadReceipt: boolean;
-        readReceiptText: string;
-        /** Whether read receipt time comes from input port */
-        readReceiptTimeIsVariable?: boolean;
-        unreadBadgeText: string;
-        /** Whether unread badge comes from input port */
-        unreadBadgeIsVariable?: boolean;
-        messageHeaderTimestampText: string;
-        /** Whether message header time comes from input port */
-        messageHeaderTimeIsVariable?: boolean;
-    };
-    /** Instagram-specific settings */
-    instagram?: {
-        userHasStory: boolean;
-    };
-}
-/**
- * Collect node configuration - collects outputs from for-each loop into an array
- * Note: Most config is set during expansion, not by user
- */
-export interface CollectNodeConfig {
-    /** Expected number of items to collect (set during for-each expansion) */
-    expectedCount?: number;
-    /** Template ID of the for-each loop this collects from (for validation) */
-    forEachTemplateId?: string;
-}
-/**
- * Destructure node selection - defines which indexes to extract from an array
- */
-export interface DestructureSelection {
-    /** Port ID for this selection output (lowercase, hyphens/underscores only) */
-    portId: string;
-    /** Index expression: single index "0", comma-separated "0, 2, 4", ranges "0-3", or mixed "0, 2-4, 7" */
-    indexExpr: string;
-    /** Optional property path to extract from selected items (e.g., "messages", "data.items") */
-    propertyPath?: string;
-    /** If true, read indexExpr from input port (idx-{portId}) instead of using static value */
-    isVariable?: boolean;
-}
-/**
- * Destructure node configuration - extracts specific elements from an array
- */
-export interface DestructureNodeConfig {
-    /** List of selections - each becomes an output port */
-    selections: DestructureSelection[];
-}
-/**
- * Video Generation Model IDs
- * Text-to-video models take just a prompt, image-to-video models require an image input
- */
-export type VideoGenerationTextToVideoModel = 'fal-ai/veo3.1' | 'fal-ai/veo3' | 'fal-ai/veo3/fast' | 'fal-ai/kling-video/v2.6/pro/text-to-video' | 'fal-ai/kling-video/v2.5/pro/text-to-video' | 'fal-ai/luma-dream-machine/ray-2' | 'fal-ai/luma-dream-machine/ray-2-flash' | 'fal-ai/minimax/hailuo-2.3/pro/text-to-video' | 'wan/v2.6/text-to-video' | 'fal-ai/sora-2/text-to-video';
-export type VideoGenerationImageToVideoModel = 'fal-ai/veo3.1/image-to-video' | 'fal-ai/veo3/image-to-video' | 'fal-ai/kling-video/v2.6/pro/image-to-video' | 'fal-ai/kling-video/v2.5/pro/image-to-video' | 'fal-ai/luma-dream-machine/ray-2/image-to-video' | 'fal-ai/luma-dream-machine/ray-2-flash/image-to-video' | 'fal-ai/minimax/hailuo-2.3/pro/image-to-video' | 'wan/v2.6/image-to-video' | 'fal-ai/sora-2/image-to-video/pro';
-export type VideoGenerationModel = VideoGenerationTextToVideoModel | VideoGenerationImageToVideoModel;
-/**
- * Type guard to check if model is an image-to-video model
- */
-export declare function isImageToVideoModel(model: VideoGenerationModel): model is VideoGenerationImageToVideoModel;
-/**
- * Video Generation node configuration - AI video generation
- */
-export interface VideoGenerationNodeConfig {
-    /** Selected model ID */
-    model: VideoGenerationModel;
-    /** Custom fal.ai API key (optional - uses platform key if not provided) */
-    apiKey?: string;
-    /** Video aspect ratio (e.g., "16:9", "9:16", "1:1") */
-    aspectRatio?: string;
-    /** Video duration in seconds (model-dependent) */
-    duration?: number;
-}
-/**
- * Custom Model input parameter type
- */
-export type CustomModelParamType = 'string' | 'number' | 'boolean' | 'image' | 'video' | 'audio';
-/**
- * Custom Model input parameter definition
- */
-export interface CustomModelInputParam {
-    /** Parameter name (used as port ID) */
-    name: string;
-    /** Parameter type */
-    type: CustomModelParamType;
-    /** Whether this parameter is required */
-    required: boolean;
-    /** Description from OpenAPI schema */
-    description?: string;
-    /** Default value */
-    default?: unknown;
-}
-/**
- * Custom Model node configuration - call any fal.ai model
- */
-export interface CustomModelNodeConfig {
-    /** fal.ai model ID (e.g., "fal-ai/flux/dev") */
-    modelId: string;
-    /** Display name for the model */
-    modelName: string;
-    /** Expected output type (determines how to extract result) */
-    outputType: 'image' | 'video' | 'audio';
-    /** Dynamic input parameters parsed from OpenAPI schema */
-    inputParams: CustomModelInputParam[];
-    /** Custom fal.ai API key (optional - uses platform key if not provided) */
-    apiKey?: string;
-}
-export interface CanvasState {
-    zoom: number;
-    panX: number;
-    panY: number;
-}
-export interface WorkflowDefinition {
-    nodes: WorkflowNodeDefinition[];
-    canvasState?: CanvasState;
-}
-/**
- * Template node as stored in the database
- */
-export interface TemplateNode {
-    id: string;
-    template_id: string;
-    node_id: string;
-    type: NodeTypeEnum;
-    name: string | null;
-    x: number;
-    y: number;
-    inputs: Record<string, {
-        sourceNodeId: string;
-        sourceOutputId: string;
-    }>;
-    config: WorkflowNodeDefinition['config'] | null;
-    cached_output: Record<string, unknown> | null;
-    cached_at: string | null;
-    cached_run_id: string | null;
-    cached_variable_inputs: Record<string, string> | null;
-    preview_outputs: Record<string, string> | null;
-    created_at: string;
-    updated_at: string;
-}
-export interface AutomationTemplate {
-    id: string;
-    org_id: string;
-    name: string;
-    description: string | null;
-    canvas_state: CanvasState | null;
-    nodes: TemplateNode[];
-    preview_output: string | null;
-    output_schema: Record<string, {
-        type: string;
-    }> | null;
-    recurrence_enabled: boolean;
-    next_run_at: string | null;
-    last_run_at: string | null;
-    created_at: string;
-    updated_at: string;
-}
-export interface AutomationRun {
-    id: string;
-    template_id: string;
-    org_id: string;
-    tag: string | null;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    variable_inputs: Record<string, string> | null;
-    save_as_preview: boolean | null;
-    create_post: boolean | null;
-    require_review: boolean | null;
-    review_status: 'pending_review' | 'approved' | 'rejected' | null;
-    created_at: string;
-    completed_at: string | null;
-}
-/**
- * @deprecated NodeRun is part of the old execution model.
- * Use ExecutorNode from the new edge-based execution model instead.
- */
-export interface NodeRun {
-    id: string;
-    automation_run_id: string;
-    template_node_id: string;
-    type: NodeTypeEnum;
-    node_state: 'pending' | 'running' | 'completed' | 'failed';
-    input_data: Record<string, unknown> | null;
-    output_data: Record<string, unknown> | null;
-    created_at: string;
-    completed_at: string | null;
-    /** Sub-workflow node runs (only present for workflow nodes) */
-    subNodes?: NodeRun[];
-}
-/**
- * Executor node from the edge-based execution model.
- * Each executor represents one instance of a template node during execution.
- */
-export interface ExecutorNode {
-    id: string;
-    template_node_id: string;
-    executor_index: number;
-    type: NodeTypeEnum;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    output_value: unknown | null;
-    error_message: string | null;
-    created_at: string;
-    completed_at: string | null;
-}
-/**
- * Execution edge from the edge-based execution model.
- * Represents a data flow connection between two executors.
- */
-export interface ExecutionEdge {
-    id: string;
-    source_executor_id: string;
-    source_port: string;
-    target_executor_id: string;
-    target_port: string;
-    value: unknown | null;
-}
-/**
- * Media types
- */
-export interface UserMedia {
-    id: string;
-    org_id: string;
-    name: string | null;
-    tag: string | null;
-    type: 'video' | 'image' | 'audio' | 'text' | null;
-    url: string | null;
-    preview_url: string | null;
-    content: string | null;
-    source_id: string | null;
-    created_at: string;
-    media_type: 'user_media';
-}
-export interface MediaUse {
-    id: string;
-    user_media_id: string;
-    name: string;
-    source_id: string | null;
-    created_at: string;
-}
-export interface SocialAudio {
-    id: string;
-    org_id: string;
-    name: string | null;
-    tag: string | null;
-    social_post_link: string | null;
-    social_audio_link: string | null;
-    platform_type: 'tiktok' | null;
-    preview_url: string | null;
-    audio_url: string | null;
-    created_at: string;
-    media_type: 'social_audio';
-    type: 'social_audio';
-}
-export type Media = UserMedia | SocialAudio;
-export interface GetMediaParams {
-    ids?: string[];
-    tag?: string;
-}
-export interface GetSocialAudioParams {
-    ids?: string[];
-    tag?: string;
-}
-export interface UploadMediaParams {
-    files: File[];
-    tag?: string;
-}
-export interface UploadMediaResponse {
-    data: UserMedia[];
-    failed?: Array<{
-        name: string;
-        error: string;
-    }>;
-    message: string;
-}
-export interface MediaTagUpdate {
-    id: string;
-    tag: string;
-}
-export interface UpdateMediaTagsParams {
-    updates: MediaTagUpdate[];
-}
-export interface MediaTagUpdateResult {
-    id: string;
-    success: boolean;
-    media?: Media;
-    error?: string;
-}
-export interface UpdateMediaTagsResponse {
-    results: MediaTagUpdateResult[];
-}
-/**
- * @deprecated Use UpdateMediaTagsParams instead for bulk operations
- */
-export interface UpdateMediaTagParams {
-    id: string;
-    tag: string;
-}
-export interface DeleteMediaParams {
-    ids: string[];
-}
-export interface DeleteMediaResponse {
-    deleted: string[];
-    failed?: Array<{
-        id: string;
-        message: string;
-    }>;
-    message: string;
-}
-export interface CreateSocialAudioParams {
-    url: string;
-    tag?: string;
-}
-export interface ImportTextParams {
-    texts: Array<{
-        content: string;
-        name?: string;
-        tag?: string;
-    }>;
-}
-export interface ImportTextResponse {
-    data: UserMedia[];
-    message: string;
-}
-export interface CreateMediaFromUrlParams {
-    urls: string[];
-    names?: string[];
-    previewUrls?: (string | undefined)[];
-    tag?: string;
-    sourceIds?: string[];
-    useName?: string;
-}
-export interface GetMediaUseParams {
-    name: string;
-}
-export interface GetMediaUseResponse {
-    sourceIds: string[];
-    entries: MediaUse[];
-}
-export interface FilterMediaParams {
-    source_ids: string[];
-    name: string;
-}
-export interface FilterMediaResponse {
-    available: string[];
-    used_count: number;
-    available_count: number;
-}
-export interface GetUploadTokenParams {
-    filename: string;
-    contentType?: string;
-}
-export interface UploadTokenResponse {
-    clientToken: string;
-    pathname: string;
-}
-/**
- * Comment types
- */
-export type CommentStatus = 'scheduled' | 'pending' | 'verifying' | 'completed' | 'failed';
-export interface Comment {
-    id: string;
-    accountId: string;
-    postUrl: string;
-    commentText: string;
-    status: CommentStatus;
-    commentUrl?: string | null;
-    error?: string | null;
-    createdAt?: string;
-    completedAt?: string | null;
-}
-export interface CreateCommentParams {
-    accountId: string;
-    postUrl: string;
-    commentText: string;
-}
-export interface CreateCommentResponse {
-    commentId: string;
-}
-export interface GetCommentsParams {
-    commentIds?: string[];
-    accountIds?: string[];
-    tag?: string;
-}
-/**
- * Validation error types for automation workflows
- */
-export type ValidationErrorType = 'missing_trigger' | 'missing_terminal' | 'missing_required_input' | 'type_mismatch' | 'empty_media_pool' | 'empty_account_pool';
-/**
- * Structured validation error with location info for UI highlighting
- */
-export interface ValidationError {
-    type: ValidationErrorType;
-    nodeId?: string;
-    portId?: string;
-    message: string;
-}
-/**
- * Exported node representation for debugging
- */
-export interface ExportedNode {
-    nodeId: string;
-    type: string;
-    name: string | null;
-    position: {
-        x: number;
-        y: number;
-    };
-    inputs: Record<string, {
-        sourceNodeId: string;
-        sourceOutputId: string;
-    }>;
-    config: Record<string, unknown>;
-}
-/**
- * Exported connection representation
- */
-export interface ExportedConnection {
-    from: {
-        nodeId: string;
-        port: string;
-    };
-    to: {
-        nodeId: string;
-        port: string;
-    };
-}
-/**
- * Exported template data
- */
-export interface ExportedTemplate {
-    id: string;
-    name: string;
-    description: string | null;
-    canvasState: {
-        zoom: number;
-        panX: number;
-        panY: number;
-    } | null;
-    outputSchema: Record<string, {
-        type: string;
-    }> | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Full automation export (template + nodes + connections)
- */
-export interface AutomationExport {
-    template: ExportedTemplate;
-    nodes: ExportedNode[];
-    connections: ExportedConnection[];
-}
-/**
- * Exported executor data
- */
-export interface ExportedExecutor {
-    id: string;
-    nodeTemplateId: string;
-    executorIndex: number;
-    type: string;
-    status: string;
-    outputValue: unknown;
-    errorMessage: string | null;
-    createdAt: string;
-    completedAt: string | null;
-}
-/**
- * Exported edge data
- */
-export interface ExportedEdge {
-    sourceExecutorId: string;
-    sourceNodeId: string;
-    sourcePort: string;
-    targetExecutorId: string;
-    targetNodeId: string;
-    targetPort: string;
-    value: unknown;
-}
-/**
- * Exported run data
- */
-export interface ExportedRun {
-    id: string;
-    templateId: string;
-    templateName: string;
-    status: string;
-    variableInputs: Record<string, string> | null;
-    createdAt: string;
-    completedAt: string | null;
-}
-/**
- * Full automation run export
- */
-export interface AutomationRunExport {
-    run: ExportedRun;
-    template: ExportedTemplate;
-    nodes: ExportedNode[];
-    connections: ExportedConnection[];
-    execution: {
-        executors: ExportedExecutor[];
-        edges: ExportedEdge[];
-    };
-}
-/**
- * Account object that flows through edges for posting
- */
-export interface AccountData {
-    id: string;
-    username: string;
-    platform: 'tiktok';
-    displayName?: string;
-    profilePicUrl?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Output structure for flow control nodes (if, random-route).
- * Contains values for selected ports and list of skipped port IDs.
- */
-export interface FlowControlOutput {
-    values: Record<string, unknown>;
-    skippedPorts: string[];
-}
-/**
- * Node types array for runtime use
- */
-export declare const NodeTypes: readonly ["social-audio", "text", "media", "video-import", "image-composer", "video-composer", "generate-image", "generate-video", "custom-model", "llm", "output", "manual-trigger", "recurrence", "compose-workflow", "account", "auto-post", "save-to-media", "deduplicate", "for-each", "for-each-value", "transcript", "auto-caption", "screenshot-animation", "random", "random-route", "branch", "if", "not", "create-dm", "collect", "destructure"];
-/**
- * Node type enum derived from NodeTypes const array
- * This is the canonical type - use this instead of the string union NodeTypeEnum
- */
-export type NodeType = typeof NodeTypes[number];
-/**
- * Context passed to executor-based node execution.
- * Replaces the complex outputMap/iteration/portOffsets pattern with simple inputs.
- */
-export interface ExecutorContext {
-    /** Database ID of this executor */
-    executorId: string;
-    /** Run ID this executor belongs to */
-    runId: string;
-    /** Template node ID this executor was created from */
-    templateNodeId: string;
-    /** Index of this executor (0, 1, 2...) for the same template node */
-    executorIndex: number;
-    /** Node type */
-    type: NodeType;
-    /** Node config (includes assignedValue for source nodes) */
-    config: Record<string, unknown>;
-    /** Input values read from incoming edges (portId -> value) */
-    inputs: Record<string, unknown>;
-}
-/**
- * Executor for synchronous nodes.
- * Much simpler than the old NodeControlConfig - just takes context and returns output.
- */
-export interface NodeExecutor<TOutput = unknown> {
-    type: NodeType;
-    /**
-     * Execute the node and return a single output value.
-     * For multi-output nodes (like LLM), return an object with output fields.
-     */
-    execute: (ctx: ExecutorContext) => Promise<TOutput>;
-}
-/**
- * Async job status for executor-based async nodes
- */
-export type ExecutorAsyncJobStatus<TOutput = unknown> = {
-    status: 'pending';
-} | {
-    status: 'completed';
-    output: TOutput;
-} | {
-    status: 'failed';
-    error: string;
-};
-/**
- * Executor for asynchronous nodes (video-editor, generate-image, workflow).
- * Uses submit/poll pattern for durable workflows.
- */
-export interface AsyncNodeExecutor<TOutput = unknown> extends Omit<NodeExecutor<TOutput>, 'execute'> {
-    isAsync: true;
-    /** Submit job - returns job ID for polling */
-    submitJob: (ctx: ExecutorContext) => Promise<{
-        jobId: string;
-    }>;
-    /** Check job status - called by orchestrator with workflow sleep between calls */
-    checkStatus: (jobId: string, ctx: ExecutorContext) => Promise<ExecutorAsyncJobStatus<TOutput>>;
-}
-/**
- * Type guard to check if an executor is async
- */
-export declare function isAsyncExecutor<T>(executor: NodeExecutor<T> | AsyncNodeExecutor<T>): executor is AsyncNodeExecutor<T>;