vidspotai-shared 1.0.94 → 1.0.96

package/lib/schemas/demoSpec.schema.d.ts

@@ -37,6 +37,8 @@ export declare const DemoBrandSchema: z.ZodObject<{
     fonts: z.ZodDefault<z.ZodObject<{
         heading: z.ZodOptional<z.ZodString>;
         body: z.ZodOptional<z.ZodString>;
+        headingFileUrl: z.ZodOptional<z.ZodString>;
+        bodyFileUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type DemoBrand = z.infer<typeof DemoBrandSchema>;
@@ -173,6 +175,7 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         icon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     screenshotUrl: z.ZodOptional<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     durationMs: z.ZodNumber;
@@ -190,6 +193,7 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         right: "right";
     }>>;
     screenshotUrl: z.ZodOptional<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodString>;
     cards: z.ZodDefault<z.ZodArray<z.ZodObject<{
         title: z.ZodString;
         subtitle: z.ZodOptional<z.ZodString>;
@@ -228,15 +232,34 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         laptop: "laptop";
         tablet: "tablet";
     }>>;
-    screenshotUrls: z.ZodArray<z.ZodString>;
+    screenshotUrls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    videoUrl: z.ZodOptional<z.ZodString>;
     motion: z.ZodDefault<z.ZodEnum<{
         parallax: "parallax";
-        scroll: "scroll";
         tilt: "tilt";
+        scroll: "scroll";
         "zoom-in": "zoom-in";
         orbit: "orbit";
     }>>;
     headline: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    durationMs: z.ZodNumber;
+    caption: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        sub: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    narrationHint: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"mediaShot">;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodString>;
+    headline: z.ZodOptional<z.ZodString>;
+    motion: z.ZodDefault<z.ZodEnum<{
+        static: "static";
+        "slow-zoom": "slow-zoom";
+        drift: "drift";
+    }>>;
+    scrim: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     durationMs: z.ZodNumber;
@@ -362,11 +385,44 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>>;
     narrationHint: z.ZodOptional<z.ZodString>;
     type: z.ZodLiteral<"custom">;
-    tsx: z.ZodString;
+    intent: z.ZodOptional<z.ZodString>;
+    tsx: z.ZodDefault<z.ZodString>;
     props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>], "type">;
 export type DemoScene = z.infer<typeof DemoSceneSchema>;
 export type DemoSceneType = DemoScene["type"];
+/**
+ * Scenes reference a generated asset by `gen://<assetId>` in any media URL slot
+ * (`screenshotUrl`, `videoUrl`, `screenshotUrls[]`, custom-scene `props`). The
+ * asset-generation stage resolves each request, uploads the result to GCS, and
+ * substitutes the real URL into the scenes; the request entry keeps the resolved
+ * `url` so redeliveries and revisions NEVER re-pay the provider for the same id.
+ */
+export declare const GEN_ASSET_URI_PREFIX: "gen://";
+export declare const DemoGeneratedAssetSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>;
+    prompt: z.ZodString;
+    purpose: z.ZodOptional<z.ZodString>;
+    aspect: z.ZodOptional<z.ZodEnum<{
+        "9:16": "9:16";
+        "1:1": "1:1";
+        "4:5": "4:5";
+        "16:9": "16:9";
+    }>>;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        pending: "pending";
+    }>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DemoGeneratedAsset = z.infer<typeof DemoGeneratedAssetSchema>;
 export declare const DemoSpecSchema: z.ZodObject<{
     schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
     productName: z.ZodString;
@@ -386,6 +442,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
         fonts: z.ZodDefault<z.ZodObject<{
             heading: z.ZodOptional<z.ZodString>;
             body: z.ZodOptional<z.ZodString>;
+            headingFileUrl: z.ZodOptional<z.ZodString>;
+            bodyFileUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
     style: z.ZodDefault<z.ZodObject<{
@@ -490,6 +548,7 @@ export declare const DemoSpecSchema: z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         screenshotUrl: z.ZodOptional<z.ZodString>;
+        videoUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         durationMs: z.ZodNumber;
@@ -507,6 +566,7 @@ export declare const DemoSpecSchema: z.ZodObject<{
             right: "right";
         }>>;
         screenshotUrl: z.ZodOptional<z.ZodString>;
+        videoUrl: z.ZodOptional<z.ZodString>;
         cards: z.ZodDefault<z.ZodArray<z.ZodObject<{
             title: z.ZodString;
             subtitle: z.ZodOptional<z.ZodString>;
@@ -545,15 +605,34 @@ export declare const DemoSpecSchema: z.ZodObject<{
             laptop: "laptop";
             tablet: "tablet";
         }>>;
-        screenshotUrls: z.ZodArray<z.ZodString>;
+        screenshotUrls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        videoUrl: z.ZodOptional<z.ZodString>;
         motion: z.ZodDefault<z.ZodEnum<{
             parallax: "parallax";
-            scroll: "scroll";
             tilt: "tilt";
+            scroll: "scroll";
             "zoom-in": "zoom-in";
             orbit: "orbit";
         }>>;
         headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        durationMs: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            sub: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        narrationHint: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"mediaShot">;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        videoUrl: z.ZodOptional<z.ZodString>;
+        headline: z.ZodOptional<z.ZodString>;
+        motion: z.ZodDefault<z.ZodEnum<{
+            static: "static";
+            "slow-zoom": "slow-zoom";
+            drift: "drift";
+        }>>;
+        scrim: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         durationMs: z.ZodNumber;
@@ -679,9 +758,33 @@ export declare const DemoSpecSchema: z.ZodObject<{
         }, z.core.$strip>>;
         narrationHint: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<"custom">;
-        tsx: z.ZodString;
+        intent: z.ZodOptional<z.ZodString>;
+        tsx: z.ZodDefault<z.ZodString>;
         props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>], "type">>;
+    generatedAssets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        prompt: z.ZodString;
+        purpose: z.ZodOptional<z.ZodString>;
+        aspect: z.ZodOptional<z.ZodEnum<{
+            "9:16": "9:16";
+            "1:1": "1:1";
+            "4:5": "4:5";
+            "16:9": "16:9";
+        }>>;
+        durationSec: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            pending: "pending";
+        }>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type DemoSpec = z.infer<typeof DemoSpecSchema>;
 /** Sum of scene durations — the canonical total timeline length in ms. */

package/lib/schemas/demoSpec.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"demoSpec.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/demoSpec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAMnD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AASxD,uCAAuC;AACvC,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAiBH,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;;iBAOrB,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,cAAc;;;;;;;;;;;iBAMzB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc;;;;;;;iBAKzB,CAAC;AA0IH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAc1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAI9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEzE"}
+{"version":3,"file":"demoSpec.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/demoSpec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAMnD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AASxD,uCAAuC;AACvC,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAiBH,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;;iBAOrB,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,cAAc;;;;;;;;;;;iBAMzB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc;;;;;;;iBAKzB,CAAC;AA6LH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAe1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAI9C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AAEtD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;iBAoBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEzE"}

package/lib/schemas/demoSpec.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DemoSpecSchema = exports.DemoSceneSchema = exports.ChatTurnSchema = exports.DemoCardSchema = exports.StatSchema = exports.SceneCaptionSchema = exports.DemoStyleSchema = exports.VisualStyleSchema = exports.DemoBrandSchema = exports.DEMO_SPEC_SCHEMA_VERSION = void 0;
+exports.DemoSpecSchema = exports.DemoGeneratedAssetSchema = exports.GEN_ASSET_URI_PREFIX = exports.DemoSceneSchema = exports.ChatTurnSchema = exports.DemoCardSchema = exports.StatSchema = exports.SceneCaptionSchema = exports.DemoStyleSchema = exports.VisualStyleSchema = exports.DemoBrandSchema = exports.DEMO_SPEC_SCHEMA_VERSION = void 0;
 exports.demoSpecDurationMs = demoSpecDurationMs;
 const zod_1 = require("zod");
 const project_schema_1 = require("./project.schema");
@@ -149,6 +149,13 @@ const FeatureShowcaseSceneSchema = SceneBaseSchema.extend({
      * surface. Often MORE accurate + reliable than a coded replica (see plan §2.6).
      */
     screenshotUrl: zod_1.z.string().optional(),
+    /**
+     * Optional user-supplied video CLIP to play inside the surface (takes precedence
+     * over `screenshotUrl` when both are set). Sourced from `inputs.mediaAssets`; the
+     * render engine draws it via `<OffthreadVideo>`. Muted, cover-fit, loops to fill
+     * the scene duration.
+     */
+    videoUrl: zod_1.z.string().optional(),
 });
 /** Bold headline + an isolated UI component/screenshot beside it (LinkedNav style). */
 const SplitFeatureSceneSchema = SceneBaseSchema.extend({
@@ -160,6 +167,9 @@ const SplitFeatureSceneSchema = SceneBaseSchema.extend({
     side: zod_1.z.enum(["left", "right"]).default("right"),
     /** The isolated UI shown beside the headline: a screenshot or a small card set. */
     screenshotUrl: zod_1.z.string().optional(),
+    /** Optional user-supplied video clip shown in the device frame beside the headline
+     *  (takes precedence over `screenshotUrl`). Rendered via `<OffthreadVideo>`. */
+    videoUrl: zod_1.z.string().optional(),
     cards: zod_1.z.array(exports.DemoCardSchema).default([]),
 });
 /** Large animated words, text-led (kinetic typography / value-prop / LangEase intro). */
@@ -174,12 +184,43 @@ const BigStatementSceneSchema = SceneBaseSchema.extend({
 const DeviceMockupSceneSchema = SceneBaseSchema.extend({
     type: zod_1.z.literal("deviceMockup"),
     device: zod_1.z.enum(["browser", "laptop", "phone", "tablet"]).default("browser"),
-    /** One or more screenshots to showcase (scroll/parallax/zoom across them). */
-    screenshotUrls: zod_1.z.array(zod_1.z.string()).min(1),
+    /**
+     * Screenshots to showcase (scroll/parallax/zoom across them). May be empty when
+     * `videoUrl` supplies the media instead — the canonical way to play a user's
+     * product clip inside a device frame. At least one of `screenshotUrls`/`videoUrl`
+     * should be present; the render engine draws a neutral frame if both are empty.
+     */
+    screenshotUrls: zod_1.z.array(zod_1.z.string()).default([]),
+    /**
+     * Optional user-supplied video clip to play inside the device frame (the primary
+     * media when set; screenshots become supporting stills). Sourced from
+     * `inputs.mediaAssets`, rendered via `<OffthreadVideo>` (muted, loops to fill).
+     */
+    videoUrl: zod_1.z.string().optional(),
     /** Camera move applied to the mockup. */
     motion: zod_1.z.enum(["tilt", "parallax", "scroll", "zoom-in", "orbit"]).default("parallax"),
     headline: zod_1.z.string().optional(),
 });
+/**
+ * Full-bleed media moment — ONE image or clip fills the frame (cover-fit) under
+ * a slow camera move, with an optional headline over a readability scrim. The
+ * home for lifestyle/atmosphere media: user-uploaded photos/b-roll or
+ * planner-requested generated assets (`gen://` refs). Deliberately NOT framed in
+ * device chrome — this is emotional/contextual imagery, never "the product UI".
+ */
+const MediaShotSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("mediaShot"),
+    /** Image filling the frame (used when `videoUrl` is absent). */
+    imageUrl: zod_1.z.string().optional(),
+    /** Clip filling the frame (primary when set; muted, loops to fill). */
+    videoUrl: zod_1.z.string().optional(),
+    /** Optional big overlay line (kept short — this scene is media-led). */
+    headline: zod_1.z.string().optional(),
+    /** Camera move over the media. */
+    motion: zod_1.z.enum(["slow-zoom", "drift", "static"]).default("slow-zoom"),
+    /** Darkening gradient behind overlay text; disable for clean full-frame media. */
+    scrim: zod_1.z.boolean().default(true),
+});
 const ChatSceneSchema = SceneBaseSchema.extend({
     type: zod_1.z.literal("chat"),
     title: zod_1.z.string().default("AI Assistant"),
@@ -219,11 +260,20 @@ const CtaSceneSchema = SceneBaseSchema.extend({
 const CustomSceneSchema = SceneBaseSchema.extend({
     type: zod_1.z.literal("custom"),
     /**
-     * Raw Remotion TSX authored by the LLM. Rendered only by the Path B dynamic
-     * bundler inside a sandbox (no network/fs, whitelisted imports). Path A engines
-     * MUST skip/placeholder these. Empty until Phase 8.
+     * Natural-language description of what this scene should show/do. The PLANNER
+     * writes this when a product needs a layout the Layer-A templates don't cover;
+     * the Layer-B codegen agent (Phase 8) reads it as the authoring brief and fills
+     * `tsx`. Optional so hand-authored/pre-filled custom scenes need not carry it.
      */
-    tsx: zod_1.z.string(),
+    intent: zod_1.z.string().optional(),
+    /**
+     * Raw Remotion TSX authored by the Layer-B codegen agent. Rendered only by the
+     * Path B dynamic bundle (customSceneBundle.ts), after passing the AST allowlist
+     * + typecheck; the scene body executes only inside headless Chrome. Path A
+     * engines MUST placeholder these. May be empty when the planner emitted the
+     * scene as an `intent` for the codegen stage to fill (or when codegen failed).
+     */
+    tsx: zod_1.z.string().default(""),
     /** Optional prop bag injected into the custom component. */
     props: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
 });
@@ -234,6 +284,7 @@ exports.DemoSceneSchema = zod_1.z.discriminatedUnion("type", [
     SplitFeatureSceneSchema,
     BigStatementSceneSchema,
     DeviceMockupSceneSchema,
+    MediaShotSceneSchema,
     ChatSceneSchema,
     DashboardSceneSchema,
     DocAnalysisSceneSchema,
@@ -242,6 +293,36 @@ exports.DemoSceneSchema = zod_1.z.discriminatedUnion("type", [
     CtaSceneSchema,
     CustomSceneSchema,
 ]);
+// ─── generated media assets (planner-requested AI images/clips) ──────────────
+/**
+ * Scenes reference a generated asset by `gen://<assetId>` in any media URL slot
+ * (`screenshotUrl`, `videoUrl`, `screenshotUrls[]`, custom-scene `props`). The
+ * asset-generation stage resolves each request, uploads the result to GCS, and
+ * substitutes the real URL into the scenes; the request entry keeps the resolved
+ * `url` so redeliveries and revisions NEVER re-pay the provider for the same id.
+ */
+exports.GEN_ASSET_URI_PREFIX = "gen://";
+exports.DemoGeneratedAssetSchema = zod_1.z.object({
+    /** Stable id scenes reference as `gen://<id>`. */
+    id: zod_1.z.string(),
+    kind: zod_1.z.enum(["image", "video"]),
+    /**
+     * The full generation prompt, written by the PLANNER for THIS product:
+     * concrete subject + composition + lighting/mood + brand palette accents.
+     * Never contains readable text/UI copy (AI-rendered text artifacts).
+     */
+    prompt: zod_1.z.string(),
+    /** Why this asset exists / which beat it serves — audit + revise context. */
+    purpose: zod_1.z.string().optional(),
+    /** Output geometry; defaults to the spec aspect at generation time. */
+    aspect: project_schema_1.AspectSchema.optional(),
+    /** Video only: clip length in seconds (engine loops it to fill the scene). */
+    durationSec: zod_1.z.number().int().min(2).max(10).optional(),
+    /** Resolved by the generation stage — a durable GCS URL once ready. */
+    url: zod_1.z.string().optional(),
+    status: zod_1.z.enum(["pending", "ready", "failed"]).default("pending"),
+    error: zod_1.z.string().optional(),
+});
 // ─── top-level DemoSpec ──────────────────────────────────────────────────────
 exports.DemoSpecSchema = zod_1.z.object({
     schemaVersion: zod_1.z.literal(exports.DEMO_SPEC_SCHEMA_VERSION).default(exports.DEMO_SPEC_SCHEMA_VERSION),
@@ -269,6 +350,13 @@ exports.DemoSpecSchema = zod_1.z.object({
     audience: zod_1.z.string().optional(),
     /** Ordered scenes. Total duration = sum of scene.durationMs. */
     scenes: zod_1.z.array(exports.DemoSceneSchema).min(1),
+    /**
+     * Planner-requested AI-generated media (see DemoGeneratedAssetSchema). Most
+     * specs declare NONE — the planner reaches for generation only when no real
+     * asset can serve a beat (physical product, lifestyle/atmosphere imagery,
+     * abstract motion backdrop), never to fabricate product-UI "screenshots".
+     */
+    generatedAssets: zod_1.z.array(exports.DemoGeneratedAssetSchema).default([]),
 });
 /** Sum of scene durations — the canonical total timeline length in ms. */
 function demoSpecDurationMs(spec) {

package/lib/schemas/index.d.ts

@@ -3,6 +3,7 @@ export * from "./brief.schema";
 export * from "./videoPlan.schema";
 export * from "./brandKit.schema";
 export * from "./demoSpec.schema";
+export * from "./demoQuestion.schema";
 export * from "./agentPersona.schema";
 export * from "./agentRunJob.schema";
 export * from "./social.schema";

package/lib/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/lib/schemas/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./brief.schema"), exports);
 __exportStar(require("./videoPlan.schema"), exports);
 __exportStar(require("./brandKit.schema"), exports);
 __exportStar(require("./demoSpec.schema"), exports);
+__exportStar(require("./demoQuestion.schema"), exports);
 __exportStar(require("./agentPersona.schema"), exports);
 __exportStar(require("./agentRunJob.schema"), exports);
 __exportStar(require("./social.schema"), exports);

package/lib/schemas/videoPlan.schema.d.ts

@@ -676,12 +676,12 @@ export declare const VideoPlanSchema: z.ZodObject<{
         estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
         sceneIndices: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strip>>>;
-    script: z.ZodOptional<z.ZodObject<{
+    script: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
         fullText: z.ZodString;
         wordCount: z.ZodOptional<z.ZodNumber>;
         estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
         wpm: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     music: z.ZodOptional<z.ZodObject<{
         strategy: z.ZodEnum<{
             none: "none";

package/lib/schemas/videoPlan.schema.d.ts.map

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

package/lib/schemas/videoPlan.schema.js

@@ -489,8 +489,18 @@ exports.VideoPlanSchema = zod_1.z.object({
      * Stream L (L-1) — full narration script for L1+ videos. Generated before
      * scenes in script-first authoring (L-3); scenes' voiceoverLines are slices
      * of `script.fullText`. Absent on scene-first (S1/S2/M1) plans.
+     *
+     * Coercion: the planner LLM repeatedly emits `script` as a bare narration
+     * string instead of `{ fullText }` (observed in prod 2026-06-30 — failed all
+     * 3 retries with "expected object, received string", killing the whole
+     * project). A string is unambiguous (it IS the full text), so we normalize it
+     * to `{ fullText }` at the schema boundary rather than burning retries on a
+     * shape the model won't reliably fix. `wordCount`/`estimatedDurationMs` stay
+     * optional and get backfilled downstream.
      */
-    script: exports.ScriptSchema.optional(),
+    script: zod_1.z
+        .preprocess((v) => (typeof v === "string" ? { fullText: v } : v), exports.ScriptSchema)
+        .optional(),
     /** Music recommendation for the whole video. */
     music: zod_1.z
         .object({

package/lib/services/agent/providerFallback/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/providerFallback/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,eAAe,EACf,aAAa,EAEb,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;;;;;;GAYG;AAGH,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAM5D,CAAC;AAKF,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAQ5D,CAAC;AAQF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAQ7D,CAAC;AAKF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAM7D,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAExD,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAGjD,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,SAAS,aAAa,EAE7C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAuCT;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASjD;AA6CD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,eAAe,EAC5B,aAAa,EAAE,SAAS,eAAe,EAAE,GACxC,eAAe,EAAE,CAMnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,eAAe,EAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,mBAAwB,GAC7B,kBAAkB,GAAG,IAAI,CAyB3B"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/providerFallback/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,eAAe,EACf,aAAa,EAEb,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;;;;;;GAYG;AAGH,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAM5D,CAAC;AAKF,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAQ5D,CAAC;AAQF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAQ7D,CAAC;AAKF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAM7D,CAAC;AASF,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAIxD,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAGjD,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,SAAS,aAAa,EAE7C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAuCT;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASjD;AA6CD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,eAAe,EAC5B,aAAa,EAAE,SAAS,eAAe,EAAE,GACxC,eAAe,EAAE,CAMnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,eAAe,EAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,mBAAwB,GAC7B,kBAAkB,GAAG,IAAI,CAyB3B"}

package/lib/services/agent/providerFallback/chains.js

@@ -65,9 +65,17 @@ exports.T3_IMAGE_TO_VIDEO_CHAIN = [
     aiModels_1.EVideoGenModels.RUNWAY_GEN4_5,
     aiModels_1.EVideoGenModels.BYTEDANCE_SEEDANCE_2_0,
 ];
-// ── Video: avatar / talking-head (Kling-only today) ───────────────────
+// ── Video: avatar / talking-head ──────────────────────────────────────
+// Kling (byo-media) is the default; HeyGen/Tavus (hosted) are fallbacks. NOTE:
+// these engines take DIFFERENT inputs (byo-media vs hosted avatar+script), so a
+// fallback hop is only valid when the job carries the inputs the next engine
+// needs — the orchestrator must gate hops on capability, not blindly walk the
+// chain. Listed here so the chain is discoverable; wiring of capability-aware
+// fallback is Reach Phase 0b runtime work.
 exports.AVATAR_VIDEO_CHAIN = [
     aiModels_1.EVideoGenModels.KLING_AVATAR,
+    aiModels_1.EVideoGenModels.HEYGEN_AVATAR,
+    aiModels_1.EVideoGenModels.TAVUS_AVATAR,
 ];
 // ── Music: search/gen ─────────────────────────────────────────────────
 exports.MUSIC_CHAIN = [

package/lib/services/agent/taskPoller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskPoller.d.ts","sourceRoot":"","sources":["../../../src/services/agent/taskPoller.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKvE;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,EAAE,aAAa,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAmBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;gBAEhC,IAAI,GAAE,iBAAsB;IAOxC;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAwBnD,OAAO;IA0GrB;oFACgF;IAChF,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,cAAc;CAKvB"}
+{"version":3,"file":"taskPoller.d.ts","sourceRoot":"","sources":["../../../src/services/agent/taskPoller.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASvE;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,EAAE,aAAa,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAmBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;gBAEhC,IAAI,GAAE,iBAAsB;IAOxC;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAwBnD,OAAO;IA4HrB;oFACgF;IAChF,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,cAAc;CAKvB"}

package/lib/services/agent/taskPoller.js

@@ -4,6 +4,7 @@ exports.TaskPoller = void 0;
 const aiModels_1 = require("../../globals/aiModels");
 const types_1 = require("../../globals/types");
 const aiGenFactory_service_1 = require("../aiGen/aiGenFactory.service");
+const avatarProviderFactory_1 = require("../avatarGen/avatarProviderFactory");
 const rateLimiter_1 = require("../rateLimiter");
 const logger_1 = require("../../utils/logger");
 const DEFAULT_INITIAL_INTERVAL_MS = 10000;
@@ -69,12 +70,22 @@ class TaskPoller {
             // with 10 tasks × 6 polls/min = 60 polls/min before any new submit).
             const limiter = (0, rateLimiter_1.getAiGenModelRateLimiter)(input.modelKey);
             await limiter.waitUntilAvailableForOneShot();
-            const provider = (0, aiGenFactory_service_1.getAiGenProviderService)(input.modelKey);
-            const result = await provider.checkVideoStatus({
-                task: input.task,
-                modelKey: input.modelKey,
-                outputFilename: input.outputFilename ?? `agent-${input.ref}`,
-            });
+            // Hosted avatar engines (HeyGen/Tavus) are NOT in the generic video
+            // factory (getAiGenProviderService throws for them) — they live behind the
+            // dedicated avatar seam, which exposes its own poll method. Kling avatar
+            // (byo-media) and all video models stay on the generic path unchanged, so
+            // their behavior is byte-for-byte identical. Both seams return the same
+            // { status, videoUrl?, errorMessage? } shape.
+            const result = (0, avatarProviderFactory_1.isHostedAvatarModel)(input.modelKey)
+                ? await (0, avatarProviderFactory_1.getAvatarVideoProvider)(input.modelKey).checkStatus({
+                    providerTaskId: input.task,
+                    outputFilename: input.outputFilename ?? `agent-${input.ref}`,
+                })
+                : await (0, aiGenFactory_service_1.getAiGenProviderService)(input.modelKey).checkVideoStatus({
+                    task: input.task,
+                    modelKey: input.modelKey,
+                    outputFilename: input.outputFilename ?? `agent-${input.ref}`,
+                });
             switch (result.status) {
                 case types_1.EVideoSceneStatus.COMPLETED:
                     state.result = {

package/lib/services/agent/tools/generateAvatarVideo.tool.d.ts

@@ -1,17 +1,29 @@
 import { z } from "zod";
+import { EVideoGenModels } from "../../../globals/aiModels";
 import { ToolDefinition } from "../toolRegistry";
 /**
- * generate_avatar_video — wraps the existing kling-avatar pipeline so the
- * planner's `talking-head-avatar` scene strategy is executable. Accepts a
- * presenter face image URL plus either a pre-uploaded audio URL or raw TTS
- * text (in which case the tool synthesizes via ElevenLabs and uploads to GCS
- * before handing off, since Kling avatar requires a public sound_file URL).
+ * generate_avatar_video — drives avatar generation through the dedicated avatar
+ * provider seam (getAvatarVideoProvider / IAvatarVideoProvider), so the planner's
+ * `talking-head-avatar` scene strategy is executable. Avatar gen is handled by
+ * the avatar provider — NOT the generic video-gen provider. Two engine families:
  *
- * Returns a provider task id; the executor / monitor layer polls completion
- * exactly as it does for generate_video.
+ *  - byo-media (default kling-avatar): caller supplies a presenter face image
+ *    plus either a pre-uploaded audio URL or raw TTS text (the tool synthesizes
+ *    via ElevenLabs + uploads to GCS first, since the engine needs a public
+ *    audio URL).
+ *  - hosted (heygen-avatar / tavus-avatar, via `model`): caller supplies a
+ *    provider-hosted avatar id + a script; the engine runs its own TTS/lipsync,
+ *    so the tool does NO TTS and passes no audio.
+ *
+ * Returns a provider task id; the executor's TaskPoller polls completion — it
+ * routes hosted models through the avatar seam and everything else through the
+ * generic video factory, so this works for both families.
  */
 declare const InputSchema: z.ZodObject<{
-    inputImageUrl: z.ZodString;
+    model: z.ZodOptional<z.ZodEnum<typeof EVideoGenModels>>;
+    inputImageUrl: z.ZodOptional<z.ZodString>;
+    hostedAvatarId: z.ZodOptional<z.ZodString>;
+    hostedVoiceId: z.ZodOptional<z.ZodString>;
     ttsText: z.ZodOptional<z.ZodString>;
     inputAudioUrl: z.ZodOptional<z.ZodString>;
     voiceId: z.ZodOptional<z.ZodString>;
@@ -25,7 +37,7 @@ declare const InputSchema: z.ZodObject<{
 declare const OutputSchema: z.ZodObject<{
     status: z.ZodLiteral<"triggered">;
     taskId: z.ZodString;
-    audioUrl: z.ZodString;
+    audioUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const generateAvatarVideoTool: ToolDefinition<typeof InputSchema, typeof OutputSchema>;
 export {};

package/lib/services/agent/tools/generateAvatarVideo.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateAvatarVideo.tool.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/tools/generateAvatarVideo.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EAAgB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;;;GASG;AAEH,QAAA,MAAM,WAAW;;;;;;;;;;;iBAiCb,CAAC;AAEL,QAAA,MAAM,YAAY;;;;iBAIhB,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAClD,OAAO,WAAW,EAClB,OAAO,YAAY,CAoFpB,CAAC"}
+{"version":3,"file":"generateAvatarVideo.tool.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/tools/generateAvatarVideo.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAY5E,OAAO,EAAgB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AAEH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAwEb,CAAC;AAEL,QAAA,MAAM,YAAY;;;;iBAQhB,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAClD,OAAO,WAAW,EAClB,OAAO,YAAY,CAqIpB,CAAC"}