videoclaw 3.0.0-alpha.1

package/dist/video/provider-platform/telemetry.js

@@ -0,0 +1,88 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export function createTelemetryRecord(input) {
+    return {
+        ...input,
+        recordedAt: new Date().toISOString(),
+    };
+}
+export function appendTelemetryRecord(logPath, record) {
+    mkdirSync(dirname(logPath), { recursive: true });
+    const sanitized = sanitizeTelemetryRecord(record);
+    appendFileSync(logPath, `${JSON.stringify(sanitized)}\n`, "utf8");
+}
+export function readTelemetryRecords(logPath) {
+    if (!existsSync(logPath)) {
+        return [];
+    }
+    return readFileSync(logPath, "utf8")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+function average(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+export function summarizeTelemetry(records) {
+    const byWorkflow = new Map();
+    for (const record of records) {
+        const workflowRecords = byWorkflow.get(record.workflow) ?? [];
+        workflowRecords.push(record);
+        byWorkflow.set(record.workflow, workflowRecords);
+    }
+    return {
+        totalRuns: records.length,
+        acceptedRuns: records.filter((record) => record.verdict === "accepted").length,
+        averageLatencyMs: average(records.map((record) => record.latencyMs)),
+        averageRetries: average(records.map((record) => record.retryCount)),
+        byWorkflow: Array.from(byWorkflow.entries()).map(([workflow, workflowRecords]) => ({
+            workflow,
+            runs: workflowRecords.length,
+            accepted: workflowRecords.filter((record) => record.verdict === "accepted").length,
+            averageLatencyMs: average(workflowRecords.map((record) => record.latencyMs)),
+        })),
+    };
+}
+export function markVerdict(record, verdict, failureCause) {
+    return {
+        ...record,
+        verdict,
+        failureCause,
+    };
+}
+const SECRET_ENV_KEYS = [
+    'USEAPI_API_TOKEN',
+    'GOOGLE_API_KEY',
+    'ELEVENLABS_API_KEY',
+    'KIE_API_KEY',
+    'OPENAI_API_KEY',
+    'ANTHROPIC_API_KEY',
+];
+/**
+ * Sanitize a telemetry record by redacting any metadata values
+ * that match known secret env var values. Prevents accidental
+ * secret leakage in telemetry logs.
+ */
+export function sanitizeTelemetryRecord(record) {
+    if (!record.metadata)
+        return record;
+    const secretValues = new Set(SECRET_ENV_KEYS
+        .map(key => process.env[key])
+        .filter((val) => typeof val === 'string' && val.length > 0));
+    if (secretValues.size === 0)
+        return record;
+    const sanitizedMetadata = {};
+    for (const [key, value] of Object.entries(record.metadata)) {
+        if (typeof value === 'string' && secretValues.has(value)) {
+            sanitizedMetadata[key] = '[REDACTED]';
+        }
+        else {
+            sanitizedMetadata[key] = value;
+        }
+    }
+    return { ...record, metadata: sanitizedMetadata };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/video/provider-platform/telemetry.js.map

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

package/dist/video/provider-platform/types.d.ts

@@ -0,0 +1,139 @@
+export type ProviderPath = "direct" | "useapi";
+export type VideoProvider = "veo" | "runway" | "seedance";
+export type RoutingPolicyTag = "balanced" | "trust-first" | "capability-first";
+export type NormalizedAspectRatio = "landscape" | "portrait";
+export type VideoWorkflowKind = "ad-creative-variants" | "product-demo-spokesperson" | "generic";
+export type VideoOperationKind = "text-to-video" | "image-to-video" | "frames-to-video" | "ingredients-to-video" | "video-to-video" | "extend" | "edit" | "add-audio";
+export type ProviderControl = "audio" | "first-frame" | "last-frame" | "reference-images" | "multi-shot" | "lip-sync" | "motion-control" | "reusable-elements" | "native-extend" | "native-edit" | "camera-grammar" | "world-consistency";
+/**
+ * Canonical, ordered list of every provider route id. The `ProviderRouteId`
+ * union is derived from this tuple so the runtime list and the compile-time
+ * type can never drift apart — `isProviderRouteId` validates external input
+ * (e.g. a project manifest's `routePreference`) against exactly these members.
+ */
+export declare const PROVIDER_ROUTE_IDS: readonly ["veo-useapi", "runway-useapi", "dreamina-useapi", "seedance-direct"];
+export type ProviderRouteId = (typeof PROVIDER_ROUTE_IDS)[number];
+/** Runtime guard: true when `value` is one of the known provider route ids. */
+export declare function isProviderRouteId(value: unknown): value is ProviderRouteId;
+export type ProviderHealthState = "healthy" | "degraded" | "offline" | "deprecated";
+export interface ProviderEscapeHatchOption {
+    name: string;
+    description: string;
+}
+export interface ProviderEscapeHatch {
+    name: string;
+    description: string;
+    options: ProviderEscapeHatchOption[];
+}
+export interface ProviderOperationSupport {
+    operation: VideoOperationKind;
+    aspectRatios: NormalizedAspectRatio[];
+    maxReferenceImages?: number;
+    notes?: string[];
+}
+export interface VideoProviderDescriptor {
+    id: ProviderRouteId;
+    provider: VideoProvider;
+    displayName: string;
+    path: ProviderPath;
+    summary: string;
+    controls: ProviderControl[];
+    operationSupport: ProviderOperationSupport[];
+    routingHints: {
+        latencyClass: "low" | "medium" | "high";
+        costClass: "free" | "low" | "medium" | "high";
+        trustClass: "direct" | "aggregator";
+        preferredWorkflows: VideoWorkflowKind[];
+    };
+    escapeHatches: ProviderEscapeHatch[];
+    notes?: string[];
+}
+export interface ProviderHealthStatus {
+    state: ProviderHealthState;
+    updatedAt: string;
+    notes?: string[];
+}
+export interface ProviderRoutingRequest {
+    operation: VideoOperationKind;
+    aspectRatio: NormalizedAspectRatio;
+    workflow: VideoWorkflowKind;
+    requiredControls?: ProviderControl[];
+    preferredProvider?: VideoProvider;
+    preferredPath?: ProviderPath;
+    allowProviders?: ProviderRouteId[];
+    denyProviders?: ProviderRouteId[];
+    preferLowCost?: boolean;
+    preferLowLatency?: boolean;
+    providerOptions?: Record<string, unknown>;
+}
+export interface ProviderRoutingPolicy {
+    tag: RoutingPolicyTag;
+    preferDirectForTrust: boolean;
+    preferUseApiWhenCapabilitiesUnlock: boolean;
+    allowDeprecatedProviders: boolean;
+    allowDegradedProviders: boolean;
+    providerOrder: ProviderRouteId[];
+}
+export interface VideoProviderRouteDecision {
+    route: VideoProviderDescriptor;
+    score: number;
+    reasons: string[];
+    retainedEscapeHatches: ProviderEscapeHatch[];
+}
+export interface VideoProviderRoutingResult {
+    primary: VideoProviderRouteDecision;
+    fallbacks: VideoProviderRouteDecision[];
+    filteredOut: Array<{
+        routeId: ProviderRouteId;
+        reason: string;
+    }>;
+}
+export type TelemetryVerdict = "accepted" | "rejected" | "needs-edit" | "error";
+export interface VideoRunTelemetryRecord {
+    runId: string;
+    recordedAt: string;
+    workflow: VideoWorkflowKind;
+    operation: VideoOperationKind;
+    routeId: ProviderRouteId;
+    provider: VideoProvider;
+    path: ProviderPath;
+    latencyMs: number;
+    estimatedCostUsd?: number;
+    actualCostUsd?: number;
+    retryCount: number;
+    outputDurationSeconds?: number;
+    verdict: TelemetryVerdict;
+    failureCause?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface BenchmarkScenario {
+    id: string;
+    workflow: VideoWorkflowKind;
+    description: string;
+    primaryGoal: string;
+    preferredRoutes: ProviderRouteId[];
+    metricBudgets: {
+        minimumApprovalRate: number;
+        maximumMedianLatencyMs: number;
+        maximumCostPerApprovedMinuteUsd: number;
+        maximumRetryRate: number;
+    };
+    humanRubric: string[];
+}
+export interface BenchmarkWorkflowScore {
+    workflow: VideoWorkflowKind;
+    scenarioIds: string[];
+    sampleSize: number;
+    approvalRate: number;
+    medianLatencyMs: number;
+    retryRate: number;
+    costPerApprovedMinuteUsd: number;
+    pass: boolean;
+    failedBudgets: string[];
+}
+export interface BenchmarkReport {
+    generatedAt: string;
+    scenarioCount: number;
+    scores: BenchmarkWorkflowScore[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/video/provider-platform/types.d.ts.map

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

package/dist/video/provider-platform/types.js

@@ -0,0 +1,17 @@
+/**
+ * Canonical, ordered list of every provider route id. The `ProviderRouteId`
+ * union is derived from this tuple so the runtime list and the compile-time
+ * type can never drift apart — `isProviderRouteId` validates external input
+ * (e.g. a project manifest's `routePreference`) against exactly these members.
+ */
+export const PROVIDER_ROUTE_IDS = [
+    "veo-useapi",
+    "runway-useapi",
+    "dreamina-useapi",
+    "seedance-direct",
+];
+/** Runtime guard: true when `value` is one of the known provider route ids. */
+export function isProviderRouteId(value) {
+    return typeof value === "string" && PROVIDER_ROUTE_IDS.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/video/provider-platform/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/video/provider-platform/types.ts"],"names":[],"mappings":"AAqCA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,iBAAiB;CACT,CAAC;AAIX,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChG,CAAC"}

package/dist/video/provider-status.d.ts

@@ -0,0 +1,12 @@
+import type { VideoProviderRuntimeDependencyStatus, VideoProviderStatusReport } from './types.js';
+type ExecutableName = VideoProviderRuntimeDependencyStatus['name'];
+interface BuildProviderStatusReportOptions {
+    workspaceRoot?: string;
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+    probeExecutable?: (name: ExecutableName) => string | undefined;
+    ignoreRuntimeDependencyIssues?: boolean;
+}
+export declare function buildProviderStatusReport(options?: BuildProviderStatusReportOptions): VideoProviderStatusReport;
+export {};
+//# sourceMappingURL=provider-status.d.ts.map

package/dist/video/provider-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-status.d.ts","sourceRoot":"","sources":["../../src/video/provider-status.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,oCAAoC,EACpC,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,KAAK,cAAc,GAAG,oCAAoC,CAAC,MAAM,CAAC,CAAC;AAEnE,UAAU,gCAAgC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AA6ED,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC,GAC7C,yBAAyB,CAqG3B"}

package/dist/video/provider-status.js

@@ -0,0 +1,169 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { DEFAULT_PROVIDER_REGISTRY } from './provider-platform/registry.js';
+const ROUTE_REQUIRED_ENV_VARS = {
+    'veo-useapi': ['USEAPI_API_TOKEN', 'USEAPI_ACCOUNT_EMAIL'],
+    'seedance-direct': ['SUTUI_API_KEY'],
+    'runway-useapi': ['USEAPI_API_TOKEN', 'USEAPI_ACCOUNT_EMAIL'],
+    'dreamina-useapi': ['USEAPI_API_TOKEN', 'VCLAW_DREAMINA_ACCOUNT'],
+};
+const ROUTE_REQUIRED_DEPENDENCIES = {
+    'veo-useapi': ['python3', 'bun', 'ffmpeg'],
+    'seedance-direct': ['python3', 'ffmpeg'],
+    // runway-useapi native transport is pure Node (fetch + fs), no python/bun
+    // shell-outs. ffmpeg is still useful for downstream stitching/post but is
+    // not strictly required for the route itself to deliver mp4s.
+    'runway-useapi': ['ffmpeg'],
+    // dreamina-useapi native transport is pure Node (fetch + fs), no python/bun
+    // shell-outs. ffmpeg is still useful for downstream stitching/post but is
+    // not strictly required for the route itself to deliver mp4s.
+    'dreamina-useapi': ['ffmpeg'],
+};
+const ROUTE_MATURITY = {
+    'veo-useapi': 'production',
+    'seedance-direct': 'production',
+    'runway-useapi': 'production',
+    'dreamina-useapi': 'production',
+};
+const ROUTE_ADAPTER_ENV_VAR = {
+    'veo-useapi': 'VCLAW_VEO_USEAPI_ADAPTER',
+    'seedance-direct': 'VCLAW_SEEDANCE_DIRECT_ADAPTER',
+    'runway-useapi': 'VCLAW_RUNWAY_USEAPI_ADAPTER',
+    'dreamina-useapi': 'VCLAW_DREAMINA_USEAPI_ADAPTER',
+};
+const ROUTE_COMMAND_ENV_VARS = {
+    'veo-useapi': ['VCLAW_VEO_USEAPI_SUBMIT_CMD', 'VCLAW_VEO_USEAPI_POLL_CMD', 'VCLAW_VEO_BUN_BIN'],
+    'seedance-direct': ['VCLAW_SEEDANCE_DIRECT_SUBMIT_CMD', 'VCLAW_SEEDANCE_DIRECT_POLL_CMD'],
+    'runway-useapi': ['VCLAW_RUNWAY_USEAPI_SUBMIT_CMD', 'VCLAW_RUNWAY_USEAPI_POLL_CMD', 'VCLAW_RUNWAY_USEAPI_CANCEL_CMD'],
+    'dreamina-useapi': ['VCLAW_DREAMINA_USEAPI_SUBMIT_CMD', 'VCLAW_DREAMINA_USEAPI_POLL_CMD', 'VCLAW_DREAMINA_USEAPI_CANCEL_CMD'],
+};
+function findExecutable(command) {
+    try {
+        const resolved = execFileSync('which', [command], { encoding: 'utf-8' }).trim();
+        return resolved || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readDotEnvLikeFile(path) {
+    if (!existsSync(path))
+        return {};
+    const out = {};
+    const raw = readFileSync(path, 'utf-8');
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#') || !trimmed.includes('='))
+            continue;
+        const [key, ...rest] = trimmed.split('=');
+        const value = rest.join('=').trim().replace(/^['"]|['"]$/g, '');
+        out[key.trim()] = value;
+    }
+    return out;
+}
+function hasRouteExecutionOverride(routeId, env) {
+    const names = [
+        ROUTE_ADAPTER_ENV_VAR[routeId],
+        ...(ROUTE_COMMAND_ENV_VARS[routeId] ?? []),
+    ];
+    return names.some((name) => {
+        const value = env[name];
+        return Boolean(value && value.trim() !== '');
+    });
+}
+export function buildProviderStatusReport(options = {}) {
+    const workspaceRoot = options.workspaceRoot ?? process.cwd();
+    const envLocalPath = `${workspaceRoot}/.env.local`;
+    const env = {
+        ...readDotEnvLikeFile(envLocalPath),
+        ...(options.env ?? process.env),
+    };
+    const now = options.now ?? new Date();
+    const probe = options.probeExecutable ?? findExecutable;
+    const ignoreRuntimeDependencyIssues = options.ignoreRuntimeDependencyIssues ?? false;
+    const dependencyNames = ['python3', 'bun', 'ffmpeg'];
+    const runtimeDependencies = dependencyNames.map((name) => ({
+        name,
+        available: Boolean(probe(name)),
+        path: probe(name),
+    }));
+    const availableDependencies = runtimeDependencies.filter((item) => item.available).map((item) => item.name);
+    const envSources = [];
+    if (existsSync(envLocalPath)) {
+        envSources.push(envLocalPath);
+    }
+    const workspaceIssues = [];
+    const workspaceOk = existsSync(workspaceRoot);
+    if (!workspaceOk) {
+        workspaceIssues.push('Workspace root does not exist.');
+    }
+    const routes = DEFAULT_PROVIDER_REGISTRY.map((route) => {
+        const requiredEnvVars = ROUTE_REQUIRED_ENV_VARS[route.id];
+        const availableEnvVars = requiredEnvVars.filter((name) => {
+            const value = env[name];
+            return Boolean(value && value.trim() !== '');
+        });
+        const missingEnvVars = requiredEnvVars.filter((name) => !availableEnvVars.includes(name));
+        const requiredDependencies = ROUTE_REQUIRED_DEPENDENCIES[route.id];
+        const executionOverride = hasRouteExecutionOverride(route.id, env);
+        const dependencyOverride = executionOverride || ignoreRuntimeDependencyIssues;
+        const presentDependencies = dependencyOverride
+            ? [...requiredDependencies]
+            : requiredDependencies.filter((name) => availableDependencies.includes(name));
+        const missingDependencies = dependencyOverride
+            ? []
+            : requiredDependencies.filter((name) => !presentDependencies.includes(name));
+        const issues = [];
+        const notes = [...(route.notes ?? [])];
+        if (missingEnvVars.length > 0) {
+            issues.push(`Missing environment variables: ${missingEnvVars.join(', ')}`);
+        }
+        if (missingDependencies.length > 0) {
+            issues.push(`Missing runtime dependencies: ${missingDependencies.join(', ')}`);
+        }
+        if (executionOverride) {
+            notes.push('Execution override configured; adapter command owns route-specific runtime checks.');
+        }
+        else if (ignoreRuntimeDependencyIssues) {
+            notes.push('Runtime dependency probes ignored for this explicit execution environment.');
+        }
+        let availability = 'available';
+        if (issues.length > 0) {
+            availability = 'unavailable';
+        }
+        else if (ROUTE_MATURITY[route.id] === 'scaffold') {
+            availability = 'degraded';
+            notes.push('Scaffold path only; keep out of default production routing.');
+        }
+        return {
+            routeId: route.id,
+            provider: route.provider,
+            displayName: route.displayName,
+            path: route.path,
+            availability,
+            maturity: ROUTE_MATURITY[route.id],
+            summary: route.summary,
+            supportedOperations: Array.from(new Set(route.operationSupport.map((support) => support.operation))),
+            requiredEnvVars,
+            availableEnvVars,
+            missingEnvVars,
+            requiredDependencies,
+            availableDependencies: presentDependencies,
+            missingDependencies,
+            issues,
+            notes,
+        };
+    });
+    return {
+        generatedAt: now.toISOString(),
+        workspace: {
+            root: workspaceRoot,
+            ok: workspaceOk,
+            issues: workspaceIssues,
+        },
+        envSources,
+        runtimeDependencies,
+        routes,
+    };
+}
+//# sourceMappingURL=provider-status.js.map

package/dist/video/provider-status.js.map

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

package/dist/video/providers/dreamina-useapi.d.ts

@@ -0,0 +1,170 @@
+export type DreaminaModel = 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-1.5-pro' | 'seedance-1.0-pro' | 'seedance-1.0-mini' | 'seedance-1.0-fast' | 'sora2';
+export type DreaminaRegion = 'US' | 'CA';
+export type DreaminaAspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9';
+export type DreaminaResolution = '720p' | '1080p';
+/**
+ * Valid duration depends on the model:
+ *   - seedance-2.0 / seedance-2.0-fast: 4-15
+ *   - seedance-1.5-pro: 5, 10, 12
+ *   - seedance-1.0-*: 5, 10
+ *   - sora2: 4, 8, 12
+ * UseAPI enforces server-side; we ship the common Seedance-2 set.
+ */
+export type DreaminaDurationSeconds = 4 | 5 | 8 | 10 | 12 | 15;
+/**
+ * Minimal `fetch` shape that allows tests to inject a mock without depending
+ * on a full DOM `Response` type. Compatible with both `globalThis.fetch` and
+ * the matching helper in `../native-dreamina.ts`.
+ */
+export type DreaminaFetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text: () => Promise<string>;
+    json: () => Promise<unknown>;
+}>;
+/**
+ * Dreamina Omni Reference budget (Seedance 2.0 via UseAPI's Dreamina proxy):
+ * up to 9 image refs + 3 video refs + 3 audio refs per submission — the same
+ * 9/3/3 reference budget Seedance enforces on every gateway. Emitted as the
+ * individual `omni_N_imageRef` / `omni_N_videoRef` / `omni_N_audioRef` fields.
+ */
+export declare const DREAMINA_MAX_IMAGE_REFS = 9;
+export declare const DREAMINA_MAX_VIDEO_REFS = 3;
+export declare const DREAMINA_MAX_AUDIO_REFS = 3;
+export interface SubmitDreaminaJobInput {
+    apiToken: string;
+    model: DreaminaModel;
+    prompt: string;
+    /**
+     * Dreamina account identifier, e.g. "CA:ai@3rdeye.co.uk". Optional on the API
+     * (auto-selected if omitted), but videoclaw always pins it so generations land
+     * on the configured CA 1080p account.
+     */
+    account?: string;
+    /** Video aspect ratio. Cannot be combined with firstFrameRef (image dictates ratio). */
+    ratio?: DreaminaAspectRatio;
+    duration?: DreaminaDurationSeconds;
+    resolution?: DreaminaResolution;
+    /**
+     * assetRef from POST /assets/<account> for the starting frame. Triggers
+     * `first_frame` (image-to-video) mode. When set, `ratio` is omitted because
+     * Dreamina auto-detects the ratio from the uploaded image.
+     */
+    firstFrameRef?: string;
+    /**
+     * Omni Reference (multi-character identity-lock): up to 9 image assetRefs,
+     * emitted as INDIVIDUAL `omni_1_imageRef`..`omni_9_imageRef` fields (NOT an
+     * array), per the UseAPI Dreamina contract. Mutually exclusive with the
+     * single-keyframe `firstFrameRef` frame-mode path: when any omni ref is
+     * present the builder emits the omni fields and drops `firstFrameRef`/`ratio`
+     * (Omni mode auto-detects the ratio from the references, like first_frame).
+     */
+    imageRefs?: string[];
+    /** Omni Reference videos: up to 3, emitted as omni_1_videoRef..omni_3_videoRef. */
+    videoRefs?: string[];
+    /** Omni Reference audios: up to 3, emitted as omni_1_audioRef..omni_3_audioRef. */
+    audioRefs?: string[];
+    /**
+     * Force a `ratio` in Omni Reference mode. Omni mode normally auto-detects the
+     * ratio from the references — but that defaults to landscape even for portrait
+     * refs, so a portrait project comes out 16:9. The Dreamina API DOES accept an
+     * explicit `ratio` alongside the omni_N fields (live-confirmed), so set this to
+     * pin the output orientation. Absent → ratio is dropped in Omni mode (legacy,
+     * byte-identical). Ignored outside Omni mode.
+     */
+    omniRatio?: DreaminaAspectRatio;
+    /**
+     * Opt-in: emit `audio: true` on the body. The Dreamina `/dreamina/videos`
+     * contract does NOT document an audio-generation parameter — the Omni Reference
+     * `omni_N_videoRef` (a black-frame voice video) is *expected* to drive the voice
+     * on its own. But the directly parallel Seedance-2 route (runway-useapi) needs an
+     * explicit `audio:true` for the voice to render, so this is an UNVERIFIED escape
+     * hatch: if a live Dreamina render with a bound voice comes back mute, set
+     * `VCLAW_DREAMINA_AUDIO=1` to send the flag. Default off → documented contract,
+     * byte-identical. Only emitted on the seedance-2.0 / seedance-2.0-fast models.
+     */
+    audio?: boolean;
+    /** Optional fetch override (defaults to global fetch). Used by tests + native wrapper. */
+    fetchImpl?: DreaminaFetchLike;
+}
+export interface SubmitDreaminaJobResult {
+    /** Namespaced jobid, e.g. "j0223...v-u12345-CA:user@example.com-bot:dreamina". Use as-is in poll. */
+    jobid: string;
+}
+/** POST https://api.useapi.net/v1/dreamina/videos — create video endpoint. */
+export declare function dreaminaVideosEndpoint(): string;
+/** GET https://api.useapi.net/v1/dreamina/videos/{jobid} — poll endpoint. */
+export declare function dreaminaVideoJobEndpoint(jobid: string): string;
+/** POST https://api.useapi.net/v1/dreamina/assets/{account} — upload an image/asset. */
+export declare function dreaminaAssetsEndpoint(account: string): string;
+export declare function buildDreaminaSubmitBody(input: SubmitDreaminaJobInput): Record<string, unknown>;
+export declare function submitDreaminaJob(input: SubmitDreaminaJobInput): Promise<SubmitDreaminaJobResult>;
+export type DreaminaPollStatus = 'pending' | 'completed' | 'failed';
+export interface DreaminaJobResponse {
+    /** Direct MP4 URL — clean master when available, watermarked fallback otherwise. */
+    videoUrl?: string;
+    videoUrlBackup?: string;
+    videoUrlWatermarked?: string;
+    watermarked?: boolean;
+    videoId?: string;
+    coverUrl?: string;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    hasAudio?: boolean;
+    assetId?: string;
+    [key: string]: unknown;
+}
+export interface PollDreaminaJobResult {
+    status: DreaminaPollStatus;
+    /** Direct MP4 URL of the completed video, when present. */
+    videoUrl: string | null;
+    /** Cover/thumbnail URL, when present. */
+    coverUrl: string | null;
+    /** Error summary on failure (e.g. "fail_code: 2043"). */
+    error: string | null;
+    raw: Record<string, unknown>;
+}
+/**
+ * Maps Dreamina's `status` string to videoclaw's tri-state. Dreamina reports
+ * `created` while a job is still generating; only `completed`/`failed` are
+ * terminal.
+ */
+export declare function mapDreaminaStatus(raw: string): DreaminaPollStatus;
+/** Parses a GET /videos/{jobid} response body into videoclaw's poll result. */
+export declare function parseDreaminaPollResponse(json: unknown): PollDreaminaJobResult;
+export interface PollDreaminaJobInput {
+    apiToken: string;
+    /** Namespaced jobid from SubmitDreaminaJobResult. */
+    jobid: string;
+    /** Optional fetch override (defaults to global fetch). */
+    fetchImpl?: DreaminaFetchLike;
+}
+export declare function pollDreaminaJob(input: PollDreaminaJobInput): Promise<PollDreaminaJobResult>;
+export interface UploadDreaminaAssetInput {
+    apiToken: string;
+    /** Dreamina account identifier, e.g. "CA:ai@3rdeye.co.uk". */
+    account: string;
+    /** Raw image bytes. */
+    bytes: Uint8Array;
+    /** Image MIME type (image/jpeg, image/png, image/webp). Defaults to image/jpeg. */
+    contentType?: string;
+    /** Optional fetch override (defaults to global fetch). */
+    fetchImpl?: DreaminaFetchLike;
+}
+export interface UploadDreaminaAssetResult {
+    /** assetRef used as firstFrameRef / endFrameRef / frame_N_imageRef in POST /videos. */
+    assetRef: string;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * Uploads raw image bytes to Dreamina and returns the `assetRef` to use as a
+ * keyframe (first frame) in a video generation request.
+ */
+export declare function uploadDreaminaAsset(input: UploadDreaminaAssetInput): Promise<UploadDreaminaAssetResult>;
+//# sourceMappingURL=dreamina-useapi.d.ts.map

package/dist/video/providers/dreamina-useapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamina-useapi.d.ts","sourceRoot":"","sources":["../../../src/video/providers/dreamina-useapi.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,OAAO,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AACnF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAClD;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,KACrF,OAAO,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B,CAAC,CAAC;AAIH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0C9F;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0BvG;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAKjE;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,CAqB9E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAajG;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA+B7G"}