vidspotai-shared 1.0.68 → 1.0.69-dev.0

package/lib/services/aiGen/providers/pixverse/pixverse.service.js

@@ -26,6 +26,96 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
         const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
         const modelId = modelConfig.modelId;
         const traceId = crypto_1.default.randomUUID();
+        // Extend a previously-generated PixVerse video. Takes the prior video_id;
+        // returns a new task whose status is polled via the same /result/{id} endpoint.
+        if (params.endpoint === "extend") {
+            if (!params.sourceTaskId) {
+                throw new Error("sourceTaskId (prior PixVerse video_id) is required for video extension");
+            }
+            const extendBody = {
+                video_id: Number(params.sourceTaskId),
+                model: modelId,
+                quality: params.resolution,
+            };
+            if (params.prompt)
+                extendBody.prompt = params.prompt;
+            if (params.negativePrompt)
+                extendBody.negative_prompt = params.negativePrompt;
+            if (params.seed !== undefined)
+                extendBody.seed = params.seed;
+            const resp = await fetch(`${this.baseUrl}/extend/generate`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "API-KEY": process.env.PIXVERSE_API_KEY,
+                    "Ai-trace-id": traceId,
+                },
+                body: JSON.stringify(extendBody),
+            });
+            if (!resp.ok) {
+                const errText = await resp.text();
+                throw new Error(`PixVerse extendVideo failed (${resp.status}): ${errText}`);
+            }
+            const data = await resp.json();
+            if (data.ErrCode !== 0) {
+                throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
+            }
+            const videoId = data?.Resp?.video_id;
+            if (!videoId)
+                throw new Error("PixVerse extend did not return video_id");
+            return { task: String(videoId), status: types_1.EVideoSceneStatus.TRIGGERED };
+        }
+        // Pixverse "Effects" — POST /video/template/generate. Requires both a numeric
+        // template_id (resolved upstream from a slug via PIXVERSE_TEMPLATES_BY_SLUG) and
+        // a customer_img_url. Most templates ignore prompt; some accept a style hint.
+        if (params.endpoint === "effect") {
+            if (!params.templateId) {
+                throw new Error("templateId is required for Pixverse effect generation");
+            }
+            if (!params.inputImageUrl) {
+                throw new Error("inputImageUrl is required for Pixverse effect generation");
+            }
+            const templateIdNum = Number(params.templateId);
+            if (!Number.isFinite(templateIdNum)) {
+                throw new Error(`templateId must be a numeric Pixverse template id (got "${params.templateId}")`);
+            }
+            const effectBody = {
+                template_id: templateIdNum,
+                customer_img_url: params.inputImageUrl,
+                model: modelId,
+                quality: params.resolution,
+                duration: params.duration,
+            };
+            if (params.prompt)
+                effectBody.prompt = params.prompt;
+            if (params.seed !== undefined)
+                effectBody.seed = params.seed;
+            if (params.watermark !== undefined)
+                effectBody.water_mark = !params.watermark;
+            if (params.motionMode)
+                effectBody.motion_mode = params.motionMode;
+            const resp = await fetch(`${this.baseUrl}/template/generate`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "API-KEY": process.env.PIXVERSE_API_KEY,
+                    "Ai-trace-id": traceId,
+                },
+                body: JSON.stringify(effectBody),
+            });
+            if (!resp.ok) {
+                const errText = await resp.text();
+                throw new Error(`PixVerse effect generation failed (${resp.status}): ${errText}`);
+            }
+            const data = await resp.json();
+            if (data.ErrCode !== 0) {
+                throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
+            }
+            const videoId = data?.Resp?.video_id;
+            if (!videoId)
+                throw new Error("PixVerse effect did not return video_id");
+            return { task: String(videoId), status: types_1.EVideoSceneStatus.TRIGGERED };
+        }
         const body = {
             aspect_ratio: params.aspectRatio,
             duration: params.duration,
@@ -45,7 +135,37 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
         if (params.multiClip !== undefined) {
             body.generate_multi_clip_switch = Boolean(params.multiClip);
         }
-        const resp = await fetch(`${this.baseUrl}/text/generate`, {
+        if (params.seed !== undefined)
+            body.seed = params.seed;
+        if (params.motionMode)
+            body.motion_mode = params.motionMode;
+        if (params.watermark !== undefined)
+            body.water_mark = !params.watermark; // API field is "remove watermark"
+        if (params.style)
+            body.style = params.style;
+        if (params.templateId)
+            body.template_id = params.templateId;
+        if (params.thinkingType)
+            body.thinking_type = params.thinkingType;
+        if (params.soundEffect) {
+            body.sound_effect_switch = params.soundEffect.switch;
+            if (params.soundEffect.content)
+                body.sound_effect_content = params.soundEffect.content;
+        }
+        if (params.lipSync) {
+            body.lip_sync_switch = params.lipSync.switch;
+            if (params.lipSync.ttsContent)
+                body.lip_sync_tts_content = params.lipSync.ttsContent;
+            if (params.lipSync.ttsSpeakerId)
+                body.lip_sync_tts_speaker_id = params.lipSync.ttsSpeakerId;
+        }
+        // I2V switches endpoint and adds the image reference.
+        const isImageToVideo = !!params.inputImageUrl;
+        if (isImageToVideo) {
+            body.image_url = params.inputImageUrl;
+        }
+        const endpoint = isImageToVideo ? `${this.baseUrl}/image/generate` : `${this.baseUrl}/text/generate`;
+        const resp = await fetch(endpoint, {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -180,7 +300,10 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
             return (0, helpers_2.getCreditsFromCost)(cost, !multiClip);
         }
         catch (err) {
-            logger_1.logger.error(`PixVerse credit calculation failed`, err);
+            logger_1.logger.error(`PixVerse credit calculation failed`, {
+                params,
+                err: err instanceof Error ? err.stack ?? err.message : String(err),
+            });
             return 10;
         }
     }

package/lib/services/aiGen/providers/runway/cameraAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { CameraControl } from "../../canonicalAdapters/cameraControl.types";
+export declare function applyRunwayCameraControl(prompt: string | undefined, c: CameraControl): string;
+//# sourceMappingURL=cameraAdapter.d.ts.map

package/lib/services/aiGen/providers/runway/cameraAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/cameraAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,6CAA6C,CAAC;AAmCrD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,CAAC,EAAE,aAAa,GACf,MAAM,CAMR"}

package/lib/services/aiGen/providers/runway/cameraAdapter.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRunwayCameraControl = applyRunwayCameraControl;
+/**
+ * Runway gen4 doesn't expose a structured camera-control field — moves are
+ * inferred from prompt text. We translate the canonical preset/intensity into
+ * a short bracketed clause prepended to the prompt. Matches Runway's own
+ * cinematography vocabulary so the model parses it reliably.
+ */
+const PRESET_TO_PHRASE = {
+    static: "static camera",
+    pan_left: "camera pans left",
+    pan_right: "camera pans right",
+    tilt_up: "camera tilts up",
+    tilt_down: "camera tilts down",
+    zoom_in: "camera zooms in",
+    zoom_out: "camera zooms out",
+    dolly_in: "camera dollies in",
+    dolly_out: "camera dollies out",
+    orbit_left: "camera orbits left around subject",
+    orbit_right: "camera orbits right around subject",
+    roll_left: "camera rolls counter-clockwise",
+    roll_right: "camera rolls clockwise",
+    tracking: "tracking shot following subject",
+    handheld: "handheld camera",
+    push_in: "slow push in",
+    pull_out: "slow pull out",
+};
+function intensityWord(i) {
+    if (i === undefined)
+        return "";
+    if (i <= 0.33)
+        return "subtle ";
+    if (i >= 0.67)
+        return "strong ";
+    return "";
+}
+function applyRunwayCameraControl(prompt, c) {
+    if (!c.preset)
+        return prompt ?? "";
+    const phrase = PRESET_TO_PHRASE[c.preset];
+    if (!phrase)
+        return prompt ?? "";
+    const clause = `[${intensityWord(c.intensity)}${phrase}]`;
+    return prompt ? `${clause} ${prompt}` : clause;
+}

package/lib/services/aiGen/providers/runway/runway.service.d.ts

@@ -1,5 +1,5 @@
 import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
-import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
+import { CreditUsageParams, ImageGenerationParams, ImageGenerationResult, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
 export declare class RunwayService extends BaseAiGenProviderService {
     private readonly baseUrl;
     private readonly apiKey;
@@ -7,6 +7,16 @@ export declare class RunwayService extends BaseAiGenProviderService {
     private request;
     generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
     checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult>;
-    getCreditUsed({ modelKey, duration, multiClip }: CreditUsageParams): number;
+    getCreditUsed({ modelKey, duration, multiClip, numImages, aspectRatio }: CreditUsageParams): number;
+    /**
+     * Runway Gen-4 Image (text-to-image). Async — POST returns a task id,
+     * we poll /tasks/{id} until SUCCEEDED, then rehost the time-limited URL
+     * into our GCS bucket so the asset persists.
+     *
+     * UI passes aspectRatio as `"1:1" | "16:9" | "9:16" | "4:3" | "3:4"`;
+     * Runway requires concrete pixel ratios (`"1920:1080"` etc.) per the
+     * Gen-4 Image spec.
+     */
+    generateImage(params: ImageGenerationParams): Promise<ImageGenerationResult>;
 }
 //# sourceMappingURL=runway.service.d.ts.map

package/lib/services/aiGen/providers/runway/runway.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/runway.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAGlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAgCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqD3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4DjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,SAAiB,EAAE,EAAE,iBAAiB,GAAG,MAAM;CASxF"}
+{"version":3,"file":"runway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/runway.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAgCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6G3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4DjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,SAAiB,EAAE,SAAa,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM;IA0BnH;;;;;;;;OAQG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;CA0ElC"}

package/lib/services/aiGen/providers/runway/runway.service.js

@@ -12,6 +12,7 @@ const helpers_1 = require("../../../../utils/helpers");
 const logger_1 = require("../../../../utils/logger");
 const helpers_2 = require("../../helpers");
 const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+const cameraAdapter_1 = require("./cameraAdapter");
 class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
     constructor() {
         super();
@@ -46,37 +47,90 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId;
         if (!modelId)
             throw new Error(`Unknown modelKey: ${params.modelKey}`);
+        // Common optional fields. Runway accepts these on all three endpoints.
+        const common = {};
+        if (params.seed !== undefined)
+            common.seed = params.seed;
+        if (params.publicFigureThreshold) {
+            common.contentModeration = { publicFigureThreshold: params.publicFigureThreshold };
+        }
+        // Camera-control: Runway has no structured camera field — synthesize a
+        // bracketed clause and prepend to the prompt.
+        const effectivePrompt = params.cameraControl
+            ? (0, cameraAdapter_1.applyRunwayCameraControl)(params.prompt, params.cameraControl)
+            : params.prompt;
         let run;
-        // TEXT → VIDEO (gen4.5)
+        // gen4.5 — supports BOTH text_to_video and image_to_video (Runway docs).
+        // Branch on whether the caller supplied a source still.
         if (modelId === "gen4.5") {
-            const ratio = (params.aspectRatio || "1280x720").replace("x", ":");
-            const body = {
-                model: "gen4.5",
-                promptText: params.prompt,
-                ratio,
-                duration: params.duration || 5,
-            };
-            run = await this.request("/text_to_video", "POST", body);
+            if (params.inputImageUrl) {
+                // IMAGE → VIDEO
+                const ratio = mapAspectToRunwayVideoRatio(params.aspectRatio, "gen4.5");
+                const promptImage = [
+                    { uri: params.inputImageUrl, position: "first" },
+                ];
+                if (params.lastFrameImageUrl) {
+                    promptImage.push({ uri: params.lastFrameImageUrl, position: "last" });
+                }
+                const body = {
+                    model: "gen4.5",
+                    promptText: effectivePrompt,
+                    promptImage,
+                    ratio,
+                    duration: params.duration || 5,
+                    ...common,
+                };
+                run = await this.request("/image_to_video", "POST", body);
+            }
+            else {
+                // TEXT → VIDEO. gen4.5 T2V only accepts "1280:720" / "720:1280".
+                const ratio = mapAspectToRunwayVideoRatio(params.aspectRatio, "gen4.5_t2v");
+                const body = {
+                    model: "gen4.5",
+                    promptText: effectivePrompt,
+                    ratio,
+                    duration: params.duration || 5,
+                    ...common,
+                };
+                run = await this.request("/text_to_video", "POST", body);
+            }
         }
-        // IMAGE → VIDEO (gen4_turbo)
+        // IMAGE → VIDEO (gen4_turbo). Supports first + optional last-frame.
         else if (modelId === "gen4_turbo") {
+            const promptImage = [
+                { uri: params.inputImageUrl, position: "first" },
+            ];
+            if (params.lastFrameImageUrl) {
+                promptImage.push({ uri: params.lastFrameImageUrl, position: "last" });
+            }
+            // AG-16: agent/tool layer sends aspectRatio as "9:16" / "16:9" / etc;
+            // Runway video endpoints expect pixel ratios like "720:1280". Image-gen
+            // already translates via mapAspectToRunwayRatio — apply the same here so
+            // I2V scenes don't 400 on a perfectly valid request.
+            const ratio = mapAspectToRunwayVideoRatio(params.aspectRatio, "gen4_turbo");
             const body = {
                 model: "gen4_turbo",
-                promptText: params.prompt,
-                promptImage: [{ uri: params.inputImageUrl, position: "first" }],
-                ratio: params.aspectRatio,
+                promptText: effectivePrompt,
+                promptImage,
+                ratio,
                 duration: params.duration,
+                ...common,
             };
             run = await this.request("/image_to_video", "POST", body);
         }
-        // VIDEO → VIDEO (gen4_aleph)
+        // VIDEO → VIDEO (gen4_aleph). Supports references[] for character/style consistency.
         else if (modelId === "gen4_aleph") {
+            const ratio = mapAspectToRunwayVideoRatio(params.aspectRatio, "gen4_aleph");
             const body = {
                 model: "gen4_aleph",
-                promptText: params.prompt,
+                promptText: effectivePrompt,
                 videoUri: params.inputVideoUrl,
-                ratio: params.aspectRatio,
+                ratio,
+                ...common,
             };
+            if (params.referenceImageUrls?.length) {
+                body.references = params.referenceImageUrls.map((uri) => ({ type: "image", uri }));
+            }
             run = await this.request("/video_to_video", "POST", body);
         }
         else {
@@ -127,14 +181,163 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         // Still processing
         return { status: types_1.EVideoSceneStatus.PENDING };
     }
-    getCreditUsed({ modelKey, duration = 5, multiClip = false }) {
+    getCreditUsed({ modelKey, duration = 5, multiClip = false, numImages = 1, aspectRatio }) {
         const modelConfig = aiModels_1.aiModelConfigs[modelKey];
-        const perSecond = modelConfig.cost?.perSecond;
+        const cost = modelConfig?.cost;
+        const applyFloor = !multiClip;
+        // Image-gen — per-aspect price table (Gen-4 Image). Falls back to `fixed`.
+        if (cost?.perAspect && aspectRatio) {
+            const perImage = cost.perAspect[aspectRatio] ?? cost.fixed;
+            if (perImage !== undefined) {
+                return (0, helpers_1.getCreditsFromCost)(perImage * Math.max(1, numImages), applyFloor);
+            }
+        }
+        // Image-gen — flat per-image cost (Runway Gen-4 Image / Turbo).
+        if (cost?.fixed !== undefined) {
+            return (0, helpers_1.getCreditsFromCost)(cost.fixed * Math.max(1, numImages), applyFloor);
+        }
+        const perSecond = cost?.perSecond;
         if (perSecond === undefined || perSecond === null) {
-            logger_1.logger.warn(`Runway getCreditUsed: no perSecond cost config for modelKey="${modelKey}" — returning fallback`, { modelKey, duration });
-            return (0, helpers_1.getCreditsFromCost)(1.0, !multiClip);
+            logger_1.logger.warn(`Runway getCreditUsed: no cost config for modelKey="${modelKey}" — returning fallback`, { modelKey, duration });
+            return (0, helpers_1.getCreditsFromCost)(1.0, applyFloor);
+        }
+        return (0, helpers_1.getCreditsFromCost)(perSecond * duration, applyFloor);
+    }
+    /**
+     * Runway Gen-4 Image (text-to-image). Async — POST returns a task id,
+     * we poll /tasks/{id} until SUCCEEDED, then rehost the time-limited URL
+     * into our GCS bucket so the asset persists.
+     *
+     * UI passes aspectRatio as `"1:1" | "16:9" | "9:16" | "4:3" | "3:4"`;
+     * Runway requires concrete pixel ratios (`"1920:1080"` etc.) per the
+     * Gen-4 Image spec.
+     */
+    async generateImage(params) {
+        const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
+        const modelId = modelConfig?.modelId;
+        if (!modelId)
+            throw new Error(`Unknown Runway image modelKey: ${params.modelKey}`);
+        const ratio = mapAspectToRunwayRatio(params.aspectRatio, params.dimensions);
+        const body = {
+            promptText: params.prompt,
+            ratio,
+            model: modelId,
+        };
+        if (params.seed !== undefined)
+            body.seed = params.seed;
+        const refs = [
+            ...(params.inputImageUrl ? [params.inputImageUrl] : []),
+            ...(params.inputImageUrls ?? []),
+        ];
+        if (refs.length > 0) {
+            // Runway requires a `tag` per reference; we assign positional tags so the
+            // model can disambiguate when the prompt mentions multiple subjects.
+            body.referenceImages = refs.map((uri, i) => ({ uri, tag: `ref${i + 1}` }));
+        }
+        const run = await this.request("/text_to_image", "POST", body);
+        // Poll. Runway image-gen is typically 5–20s; cap at 60s with 1.5s pulses.
+        const deadline = Date.now() + 60000;
+        let outputUri;
+        while (Date.now() < deadline) {
+            const status = await this.request(`/tasks/${run.id}`, "GET");
+            if (status.status === "SUCCEEDED" && status.output?.length) {
+                outputUri = status.output[0];
+                break;
+            }
+            if (status.status === "FAILED" || status.status === "CANCELLED") {
+                throw new Error(`Runway image generation failed: ${status.failure ?? "unknown"} (${status.failureCode ?? "no code"})`);
+            }
+            await new Promise((r) => setTimeout(r, 1500));
         }
-        return (0, helpers_1.getCreditsFromCost)(perSecond * duration, !multiClip);
+        if (!outputUri) {
+            throw new Error("Runway image generation timed out after 60s");
+        }
+        // Rehost in GCS — the Runway-hosted URL expires.
+        const imgResp = await axios_1.default.get(outputUri, {
+            responseType: "arraybuffer",
+            timeout: 60000,
+        });
+        if (imgResp.status !== 200) {
+            throw new Error(`Runway image download failed: ${imgResp.status}`);
+        }
+        const contentType = imgResp.headers["content-type"] ?? "image/png";
+        const ext = (contentType.split("/")[1] ?? "png").toLowerCase();
+        const ts = Date.now();
+        const path = `images/runway/${ts}-${Math.random().toString(36).slice(2, 8)}.${ext}`;
+        const file = (0, firebase_1.getBucket)().file(path);
+        await file.save(Buffer.from(imgResp.data), { contentType });
+        const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
+        return {
+            imageUrl: signed,
+            providerRequestId: run.id,
+        };
     }
 }
 exports.RunwayService = RunwayService;
+/**
+ * Map a high-level aspect ratio (or explicit `WxH` dimensions) to one of the
+ * pixel ratios the Runway Gen-4 Image API accepts. Falls back to 1024:1024
+ * for unrecognized inputs.
+ */
+function mapAspectToRunwayRatio(aspectRatio, dimensions) {
+    if (dimensions) {
+        const [w, h] = dimensions.split("x").map((n) => parseInt(n, 10));
+        if (Number.isFinite(w) && Number.isFinite(h))
+            return `${w}:${h}`;
+    }
+    switch (aspectRatio) {
+        case "16:9":
+            return "1920:1080";
+        case "9:16":
+            return "1080:1920";
+        case "4:3":
+            return "1360:768";
+        case "3:4":
+            return "768:1360";
+        case "1:1":
+        default:
+            return "1024:1024";
+    }
+}
+/**
+ * AG-16: aspectRatio translation for Runway VIDEO endpoints (gen4_turbo,
+ * gen4_aleph). Agent / tool layer sends "9:16" / "16:9" / etc; Runway expects
+ * pixel ratios from its model-specific allowed list (e.g. gen4_turbo accepts
+ * "1280:720", "720:1280", "960:960", ...). Defaults to landscape if the
+ * canonical aspect doesn't map to anything the chosen model supports.
+ */
+function mapAspectToRunwayVideoRatio(aspectRatio, flavor) {
+    // AG-24: pass through ONLY if it looks like a real pixel ratio (≥100 on at
+    // least one side). The previous regex `/^\d+[:x]\d+$/` greedily matched
+    // canonical ratios like "9:16" too, short-circuiting the mapping below and
+    // sending "9:16" straight to Runway — which rejected it.
+    if (aspectRatio) {
+        const m = aspectRatio.match(/^(\d+)[:x](\d+)$/);
+        if (m && (parseInt(m[1], 10) >= 100 || parseInt(m[2], 10) >= 100)) {
+            return `${m[1]}:${m[2]}`;
+        }
+    }
+    // gen4.5 T2V is constrained to 2 ratios per Runway docs (1280:720 + 720:1280).
+    // Coerce anything else to the closest landscape/portrait.
+    if (flavor === "gen4.5_t2v") {
+        return aspectRatio === "9:16" || aspectRatio === "3:4"
+            ? "720:1280"
+            : "1280:720";
+    }
+    switch (aspectRatio) {
+        case "16:9":
+            return "1280:720";
+        case "9:16":
+            return "720:1280";
+        case "1:1":
+            return "960:960";
+        case "4:3":
+            return "1104:832";
+        case "3:4":
+            return "832:1104";
+        case "21:9":
+            return "1584:672";
+        default:
+            return "1280:720";
+    }
+}