vidspotai-shared 1.0.82 → 1.0.83

package/lib/schemas/social.schema.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialConnectRequestSchema = exports.SocialHookScoreRequestSchema = exports.SocialSuggestRequestSchema = exports.SocialInboxDraftSchema = exports.SocialInboxUpdateSchema = exports.SocialInboxReplySchema = exports.SocialPublishRequestSchema = exports.SocialPublishTargetSchema = exports.SocialProviderSchema = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../globals/types");
+/**
+ * X8 Social Suite — request-validation schemas for the `/v1/social/*` API.
+ * These validate untrusted client input at the Cloud Function boundary; the
+ * Firestore *models* (models/social.model.ts) are the persisted shape.
+ */
+exports.SocialProviderSchema = zod_1.z.nativeEnum(types_1.ESocialProvider);
+/** One publish target: which connected account + optional per-platform overrides. */
+exports.SocialPublishTargetSchema = zod_1.z.object({
+    socialAccountId: zod_1.z.string().min(1),
+    /** Per-platform caption override; falls back to the request-level caption. */
+    caption: zod_1.z.string().max(5000).optional(),
+    /** Provider visibility (e.g. "public" | "unlisted" | "private"). */
+    privacy: zod_1.z.string().max(40).optional(),
+    /** First comment to auto-post after publish (hashtags/links). */
+    firstComment: zod_1.z.string().max(2000).optional(),
+    /**
+     * Auto-format aspect chosen for this platform (e.g. "9:16" | "1:1" | "16:9").
+     * Persisted onto the target variant so a future render step can crop/letterbox
+     * the source to the platform's recommended spec (B2). No re-render happens yet
+     * — the source video is published as-is and this records intent.
+     */
+    format: zod_1.z
+        .string()
+        .regex(/^\d{1,2}:\d{1,2}$/)
+        .max(8)
+        .optional(),
+});
+/** Body for POST /v1/social/publish. */
+exports.SocialPublishRequestSchema = zod_1.z
+    .object({
+    /** Source video in our system. Optional iff an explicit mediaUrl is given. */
+    videoJobId: zod_1.z.string().min(1).optional(),
+    /** Explicit media URL when not publishing a videoJob. */
+    mediaUrl: zod_1.z.string().url().optional(),
+    /** Default caption; overridable per target. */
+    caption: zod_1.z.string().max(5000).default(""),
+    /** Title (used by YouTube). */
+    title: zod_1.z.string().max(200).optional(),
+    /** At least one target account. */
+    targets: zod_1.z.array(exports.SocialPublishTargetSchema).min(1).max(50),
+    /** Unix ms to publish at; omit/past = publish now. */
+    scheduledAt: zod_1.z.number().int().positive().optional(),
+    /** Client-supplied idempotency key to dedupe double-submits. */
+    idempotencyKey: zod_1.z.string().min(8).max(200),
+})
+    .refine((v) => Boolean(v.videoJobId) || Boolean(v.mediaUrl), {
+    message: "Either videoJobId or mediaUrl is required",
+    path: ["videoJobId"],
+});
+/** Body for POST /v1/social/inbox/:id/reply — reply to a comment/mention. */
+exports.SocialInboxReplySchema = zod_1.z.object({
+    message: zod_1.z.string().min(1).max(2000),
+});
+/** Body for PATCH /v1/social/inbox/:id — update handling state / moderation. */
+exports.SocialInboxUpdateSchema = zod_1.z.object({
+    /** New handling state (unread → read → replied, or hidden). */
+    status: zod_1.z.enum(["unread", "read", "replied", "hidden"]).optional(),
+    /** When true/false, also hide/unhide the comment on the provider. */
+    hidden: zod_1.z.boolean().optional(),
+});
+/** Body for POST /v1/social/inbox/:id/draft — AI brand-voice reply draft. */
+exports.SocialInboxDraftSchema = zod_1.z.object({
+    /** Optional brand-voice / tone steer (e.g. "warm, concise, no emojis"). */
+    tone: zod_1.z.string().max(200).optional(),
+});
+/**
+ * Body for POST /v1/social/compose/suggest — E1 AI caption/hashtag/title.
+ * Either `videoJobId` (we read the video's title/prompt to ground the copy) or
+ * a free-text `context` is the source material; both optional (the model can
+ * write generic copy from the platform list alone). `providers` drives the
+ * per-platform variants returned.
+ */
+exports.SocialSuggestRequestSchema = zod_1.z.object({
+    /** Source video to ground the copy in (owner-checked server-side). */
+    videoJobId: zod_1.z.string().min(1).optional(),
+    /** Free-text description of the video when no videoJobId is available. */
+    context: zod_1.z.string().max(2000).optional(),
+    /** Platforms to tailor variants for (the composer's selected targets). */
+    providers: zod_1.z.array(exports.SocialProviderSchema).min(1).max(8),
+    /** Optional brand-voice / tone steer. */
+    tone: zod_1.z.string().max(200).optional(),
+    /** Language to write the copy in (ISO-639-1 / locale). Defaults to "en". */
+    language: zod_1.z.string().max(20).optional(),
+});
+/**
+ * Body for POST /v1/social/compose/score — E4 hook / caption score predictor.
+ * Grades arbitrary copy the user already has (typed or AI-written). `provider`
+ * tunes the rubric to one platform's norms; `videoJobId` (owner-checked) grounds
+ * the relevance score in what the video actually delivers.
+ */
+exports.SocialHookScoreRequestSchema = zod_1.z.object({
+    /** The hook / caption opener to grade. */
+    hook: zod_1.z.string().min(1).max(600),
+    /** Platform the copy targets (optional — tunes the rubric). */
+    provider: exports.SocialProviderSchema.optional(),
+    /** Source video to judge relevance against (owner-checked server-side). */
+    videoJobId: zod_1.z.string().min(1).optional(),
+    /** Free-text description of the video when no videoJobId is available. */
+    context: zod_1.z.string().max(2000).optional(),
+    /** Language the copy is written in (ISO-639-1 / locale). Defaults to "en". */
+    language: zod_1.z.string().max(20).optional(),
+});
+/** Body for POST /v1/social/connect/:provider (start OAuth). */
+exports.SocialConnectRequestSchema = zod_1.z.object({
+    /** Optional post-connect redirect path inside the app. */
+    returnTo: zod_1.z.string().max(500).optional(),
+    /** Request business-tier scopes (premium G-features) when the account supports it. */
+    requestBusinessScopes: zod_1.z.boolean().optional(),
+});

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

@@ -232,6 +232,25 @@ export declare const SceneLayoutSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type SceneLayout = z.infer<typeof SceneLayoutSchema>;
+/**
+ * CH-8 — persisted caption styling. Set by the chat `change_caption_style`
+ * tool ("make captions yellow", "bigger captions"). Lives on the plan (and
+ * optionally per-scene) so planToProject can apply it when building
+ * CaptionClips and the look survives every caption regen — without it, a
+ * regen resets to the renderer defaults. Every field maps 1:1 onto a
+ * CaptionClip property the renderer already consumes (CaptionClipView), so
+ * applying it is render-time only, never an AI regeneration. Colors are
+ * free-form CSS strings (hex or named). CH-1 added `fontWeight` (100–900),
+ * which the renderer now honours (falling back to 800 when unset).
+ */
+export declare const CaptionStyleSchema: z.ZodObject<{
+    fontFamily: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    fontWeight: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+    highlightColor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CaptionStyle = z.infer<typeof CaptionStyleSchema>;
 export declare const PlannedSceneSchema: z.ZodObject<{
     sceneIndex: z.ZodNumber;
     intent: z.ZodString;
@@ -256,7 +275,15 @@ export declare const PlannedSceneSchema: z.ZodObject<{
     prompt: z.ZodString;
     durationMs: z.ZodNumber;
     voiceoverLine: z.ZodOptional<z.ZodString>;
+    autoCaptions: z.ZodOptional<z.ZodBoolean>;
     voiceStyle: z.ZodOptional<z.ZodString>;
+    captionStyle: z.ZodOptional<z.ZodObject<{
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        fontWeight: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        highlightColor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     onScreenText: z.ZodOptional<z.ZodString>;
     overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
         text: z.ZodString;
@@ -331,6 +358,7 @@ export declare const PlannedSceneSchema: z.ZodObject<{
     avatarFaceUrl: z.ZodOptional<z.ZodString>;
     characterAnchorSceneIndex: z.ZodOptional<z.ZodNumber>;
     bibleEntityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    lastFramePrompt: z.ZodOptional<z.ZodString>;
     allowTrailingSilence: z.ZodOptional<z.ZodBoolean>;
     layout: z.ZodOptional<z.ZodObject<{
         composition: z.ZodEnum<{
@@ -354,6 +382,15 @@ export declare const PlannedSceneSchema: z.ZodObject<{
             gradient: "gradient";
         }>>;
     }, z.core.$strip>>;
+    broll: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        assetUrl: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        startMs: z.ZodDefault<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /**
  * Soft validator output. Unlike planner-rejection strings, warnings travel
@@ -378,6 +415,37 @@ export declare const PlannerWarningSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PlannerWarning = z.infer<typeof PlannerWarningSchema>;
+/**
+ * Stream L (L-1) — chapter structure for M1+ videos. A chapter groups a run of
+ * consecutive scenes under a titled section. Built two ways depending on tier:
+ *   - M1: the planner emits chapters directly alongside scenes (mixed pacing).
+ *   - L1/L2: `chapter_outline` (L-4) derives chapters from the script first,
+ *     then L-3 explodes each chapter's narration into scenes and back-fills
+ *     `sceneIndices`.
+ * Absent on S1/S2 plans (short-form has no chapter concept).
+ */
+export declare const ChapterSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    narration: z.ZodOptional<z.ZodString>;
+    estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
+    sceneIndices: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type Chapter = z.infer<typeof ChapterSchema>;
+/**
+ * Stream L (L-1) — full narration script for L1+ videos. Script-first authoring
+ * (L-3) generates this BEFORE scenes: `generate_script` produces the canonical
+ * narration, `chapter_outline` segments it, then each segment is exploded into
+ * scenes whose `voiceoverLine`s are sentence-boundary slices of `fullText`.
+ * Absent on S1/S2/M1 plans (those are scene-first).
+ */
+export declare const ScriptSchema: z.ZodObject<{
+    fullText: z.ZodString;
+    wordCount: z.ZodOptional<z.ZodNumber>;
+    estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
+    wpm: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Script = z.infer<typeof ScriptSchema>;
 export declare const VideoPlanSchema: z.ZodObject<{
     briefId: z.ZodOptional<z.ZodString>;
     persona: z.ZodEnum<{
@@ -395,6 +463,14 @@ export declare const VideoPlanSchema: z.ZodObject<{
     }>;
     totalDurationMs: z.ZodNumber;
     totalEstimatedCredits: z.ZodNumber;
+    lengthTier: z.ZodOptional<z.ZodEnum<{
+        S1: "S1";
+        S2: "S2";
+        M1: "M1";
+        L1: "L1";
+        L2: "L2";
+        L3: "L3";
+    }>>;
     scenes: z.ZodArray<z.ZodObject<{
         sceneIndex: z.ZodNumber;
         intent: z.ZodString;
@@ -419,7 +495,15 @@ export declare const VideoPlanSchema: z.ZodObject<{
         prompt: z.ZodString;
         durationMs: z.ZodNumber;
         voiceoverLine: z.ZodOptional<z.ZodString>;
+        autoCaptions: z.ZodOptional<z.ZodBoolean>;
         voiceStyle: z.ZodOptional<z.ZodString>;
+        captionStyle: z.ZodOptional<z.ZodObject<{
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontSize: z.ZodOptional<z.ZodNumber>;
+            fontWeight: z.ZodOptional<z.ZodNumber>;
+            color: z.ZodOptional<z.ZodString>;
+            highlightColor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         onScreenText: z.ZodOptional<z.ZodString>;
         overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
             text: z.ZodString;
@@ -494,6 +578,7 @@ export declare const VideoPlanSchema: z.ZodObject<{
         avatarFaceUrl: z.ZodOptional<z.ZodString>;
         characterAnchorSceneIndex: z.ZodOptional<z.ZodNumber>;
         bibleEntityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        lastFramePrompt: z.ZodOptional<z.ZodString>;
         allowTrailingSilence: z.ZodOptional<z.ZodBoolean>;
         layout: z.ZodOptional<z.ZodObject<{
             composition: z.ZodEnum<{
@@ -517,6 +602,28 @@ export declare const VideoPlanSchema: z.ZodObject<{
                 gradient: "gradient";
             }>>;
         }, z.core.$strip>>;
+        broll: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            assetUrl: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<{
+                image: "image";
+                video: "video";
+            }>>;
+            startMs: z.ZodDefault<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    chapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        narration: z.ZodOptional<z.ZodString>;
+        estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
+        sceneIndices: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    script: z.ZodOptional<z.ZodObject<{
+        fullText: z.ZodString;
+        wordCount: z.ZodOptional<z.ZodNumber>;
+        estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
+        wpm: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     music: z.ZodOptional<z.ZodObject<{
         strategy: z.ZodEnum<{
@@ -536,6 +643,13 @@ export declare const VideoPlanSchema: z.ZodObject<{
     voiceId: z.ZodOptional<z.ZodString>;
     voiceStyle: z.ZodOptional<z.ZodString>;
     notes: z.ZodOptional<z.ZodString>;
+    captionStyle: z.ZodOptional<z.ZodObject<{
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        fontWeight: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        highlightColor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     bible: z.ZodOptional<z.ZodObject<{
         characters: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAc5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;iBASjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;EASnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8B5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAqC5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2F7B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"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

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VideoPlanSchema = exports.PlannerWarningSchema = exports.PlannedSceneSchema = exports.SceneLayoutSchema = exports.TextOverlaySchema = exports.TextBgStyleSchema = exports.TextAnimationSchema = exports.TextPositionSchema = exports.TextRoleSchema = exports.TransitionKindSchema = exports.SceneAssetStrategySchema = exports.AgentVisualBibleSchema = exports.BibleEntitySchema = void 0;
+exports.VideoPlanSchema = exports.ScriptSchema = exports.ChapterSchema = exports.PlannerWarningSchema = exports.PlannedSceneSchema = exports.CaptionStyleSchema = exports.SceneLayoutSchema = exports.TextOverlaySchema = exports.TextBgStyleSchema = exports.TextAnimationSchema = exports.TextPositionSchema = exports.TextRoleSchema = exports.TransitionKindSchema = exports.SceneAssetStrategySchema = exports.AgentVisualBibleSchema = exports.BibleEntitySchema = void 0;
 const zod_1 = require("zod");
 const agentPersona_schema_1 = require("./agentPersona.schema");
+const brief_schema_1 = require("./brief.schema");
 const project_schema_1 = require("./project.schema");
 /**
  * VideoPlan — the planner LLM's structured output. Reviewed by the user as a
@@ -209,6 +210,24 @@ exports.SceneLayoutSchema = zod_1.z.object({
     ])
         .optional(),
 });
+/**
+ * CH-8 — persisted caption styling. Set by the chat `change_caption_style`
+ * tool ("make captions yellow", "bigger captions"). Lives on the plan (and
+ * optionally per-scene) so planToProject can apply it when building
+ * CaptionClips and the look survives every caption regen — without it, a
+ * regen resets to the renderer defaults. Every field maps 1:1 onto a
+ * CaptionClip property the renderer already consumes (CaptionClipView), so
+ * applying it is render-time only, never an AI regeneration. Colors are
+ * free-form CSS strings (hex or named). CH-1 added `fontWeight` (100–900),
+ * which the renderer now honours (falling back to 800 when unset).
+ */
+exports.CaptionStyleSchema = zod_1.z.object({
+    fontFamily: zod_1.z.string().min(1).max(80).optional(),
+    fontSize: zod_1.z.number().int().min(8).max(200).optional(),
+    fontWeight: zod_1.z.number().int().min(100).max(900).optional(),
+    color: zod_1.z.string().min(1).max(40).optional(),
+    highlightColor: zod_1.z.string().min(1).max(40).optional(),
+});
 exports.PlannedSceneSchema = zod_1.z.object({
     sceneIndex: zod_1.z.number().int().nonnegative(),
     /** Plain-English description of what this scene shows. */
@@ -229,6 +248,16 @@ exports.PlannedSceneSchema = zod_1.z.object({
     // the per-scene capability validator); this just keeps the model honest.
     durationMs: zod_1.z.number().min(500),
     voiceoverLine: zod_1.z.string().optional(),
+    /**
+     * AG-3: word-timed auto-captions for this scene's voiceover. When true (and
+     * the scene actually produces a voiceoverLine), the host transcribes the
+     * generated VO audio post-landing via generate_captions (AssemblyAI →
+     * Whisper fallback) and renders a karaoke-style caption clip on the caption
+     * track. No effect on scenes without a voiceoverLine. Common for UGC ads,
+     * social recaps, faceless-YT, fitness — where on-screen captions drive
+     * retention + accessibility.
+     */
+    autoCaptions: zod_1.z.boolean().optional(),
     /**
      * AG-44: per-scene voice delivery override. Tone can shift across the arc
      * (frustrated → curious → excited), so a single global voiceStyle is too
@@ -238,6 +267,14 @@ exports.PlannedSceneSchema = zod_1.z.object({
      * ElevenLabs voice_settings.
      */
     voiceStyle: zod_1.z.string().optional(),
+    /**
+     * CH-8: per-scene caption-style override. Set by `change_caption_style` when
+     * the user restyles a single scene's captions. Takes precedence over the
+     * plan-level `captionStyle` in planToProject (per-scene > plan > defaults).
+     * Like the plan-level field this is a post-hoc user edit — the planner/LLM
+     * must not set it.
+     */
+    captionStyle: exports.CaptionStyleSchema.optional(),
     /**
      * AG-40 legacy: a single bottom-center caption string. Kept for back-compat
      * with traces / replay scripts. Prefer `overlays[]` for new plans — it lets
@@ -280,6 +317,19 @@ exports.PlannedSceneSchema = zod_1.z.object({
      * image-gen call to lock identity.
      */
     bibleEntityIds: zod_1.z.array(zod_1.z.string()).default([]),
+    /**
+     * AG-1 Phase 2 — first-last-frame (FLF) interpolation. When set (and the
+     * scene uses strategy=ai-image-to-video with an FLF-capable preferredModel),
+     * the executor generates a SECOND image from this prompt — the END
+     * composition — and the model animates FROM `prompt`'s frame TO this one,
+     * the cleanest way to direct motion between two specific compositions
+     * (e.g. wide establishing shot → product close-up; doors closed → open).
+     * This is a full image prompt for the END state, NOT a motion verb. The
+     * executor silently ignores it on non-FLF models / non-i2v strategies, so
+     * a stray value never breaks a plan; the planner should only set it when
+     * the scene genuinely has two distinct anchor compositions.
+     */
+    lastFramePrompt: zod_1.z.string().optional(),
     /**
      * User-set escape hatch for the trailing-silence warning. When true, the
      * trailing-silence validator skips this scene — useful for visual-led
@@ -296,6 +346,23 @@ exports.PlannedSceneSchema = zod_1.z.object({
      * vision pass's content classification (center / edges / face / broll).
      */
     layout: exports.SceneLayoutSchema.optional(),
+    /**
+     * CH-6 — B-roll overlays for this scene. Each entry overlays a secondary
+     * clip ON TOP of the scene's main visual (a true second video lane; see
+     * TRACK_ID.broll in planToProject), e.g. a product close-up cutaway over a
+     * talking-head. `assetUrl` points at an existing asset (a recent generation
+     * or upload) — the chat add_broll tool overlays user assets without
+     * generating. startMs/durationMs position the overlay within the scene
+     * window (durationMs defaults to "rest of scene").
+     */
+    broll: zod_1.z
+        .array(zod_1.z.object({
+        assetUrl: zod_1.z.string().url(),
+        kind: zod_1.z.enum(["video", "image"]).default("video"),
+        startMs: zod_1.z.number().int().nonnegative().default(0),
+        durationMs: zod_1.z.number().int().positive().optional(),
+    }))
+        .optional(),
 });
 /**
  * Soft validator output. Unlike planner-rejection strings, warnings travel
@@ -319,6 +386,51 @@ exports.PlannerWarningSchema = zod_1.z.object({
     })
         .optional(),
 });
+/**
+ * Stream L (L-1) — chapter structure for M1+ videos. A chapter groups a run of
+ * consecutive scenes under a titled section. Built two ways depending on tier:
+ *   - M1: the planner emits chapters directly alongside scenes (mixed pacing).
+ *   - L1/L2: `chapter_outline` (L-4) derives chapters from the script first,
+ *     then L-3 explodes each chapter's narration into scenes and back-fills
+ *     `sceneIndices`.
+ * Absent on S1/S2 plans (short-form has no chapter concept).
+ */
+exports.ChapterSchema = zod_1.z.object({
+    /** Stable id, CH_<n>, referenced by scenes / chapter markers. */
+    id: zod_1.z.string().regex(/^CH_\d+$/, "id must be CH_<n>"),
+    /** Short section title (e.g. "Why latency matters"). Drives YT chapter markers. */
+    title: zod_1.z.string(),
+    /**
+     * Narration text for this chapter (L1+ script-first authoring). The slice of
+     * `VideoPlan.script.fullText` that belongs to this section; scenes are
+     * exploded from it (L-3). Optional for M1 plans that aren't script-first.
+     */
+    narration: zod_1.z.string().optional(),
+    /** Estimated spoken duration in ms (from chapter_outline, L-4). */
+    estimatedDurationMs: zod_1.z.number().nonnegative().optional(),
+    /**
+     * Scene indices belonging to this chapter, in render order. Empty until L-3
+     * explodes the chapter into scenes; back-filled at that point.
+     */
+    sceneIndices: zod_1.z.array(zod_1.z.number().int().nonnegative()).default([]),
+});
+/**
+ * Stream L (L-1) — full narration script for L1+ videos. Script-first authoring
+ * (L-3) generates this BEFORE scenes: `generate_script` produces the canonical
+ * narration, `chapter_outline` segments it, then each segment is exploded into
+ * scenes whose `voiceoverLine`s are sentence-boundary slices of `fullText`.
+ * Absent on S1/S2/M1 plans (those are scene-first).
+ */
+exports.ScriptSchema = zod_1.z.object({
+    /** Canonical full narration text — the source of truth for L1+ voiceover. */
+    fullText: zod_1.z.string(),
+    /** Word count, drives the duration estimate. */
+    wordCount: zod_1.z.number().int().nonnegative().optional(),
+    /** Estimated spoken duration in ms at `wpm`. */
+    estimatedDurationMs: zod_1.z.number().nonnegative().optional(),
+    /** Words-per-minute used for the estimate (typical narration ≈ 150). */
+    wpm: zod_1.z.number().int().positive().optional(),
+});
 exports.VideoPlanSchema = zod_1.z.object({
     briefId: zod_1.z.string().optional(),
     /** Persona the router selected (UGC ad / faceless YT / etc.). */
@@ -326,8 +438,28 @@ exports.VideoPlanSchema = zod_1.z.object({
     aspect: project_schema_1.AspectSchema,
     totalDurationMs: zod_1.z.number().positive(),
     totalEstimatedCredits: zod_1.z.number().nonnegative(),
+    /**
+     * Stream L (L-1) — length tier this plan was authored for. Stamped from
+     * `brief.lengthTier` (or derived via `deriveLengthTier`) so downstream
+     * consumers (executor cost guardrails L-6, editor chapter UI) don't have to
+     * re-derive it. Optional for back-compat with pre-L plans (treat absent as
+     * "S2").
+     */
+    lengthTier: brief_schema_1.LengthTierSchema.optional(),
     /** Scene list, in render order. */
     scenes: zod_1.z.array(exports.PlannedSceneSchema).min(1),
+    /**
+     * Stream L (L-1) — chapter structure for M1+ videos. Groups scenes into
+     * titled sections; drives YT chapter markers and the script-first explode
+     * (L-3). Absent on short-form (S1/S2) plans.
+     */
+    chapters: zod_1.z.array(exports.ChapterSchema).optional(),
+    /**
+     * 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.
+     */
+    script: exports.ScriptSchema.optional(),
     /** Music recommendation for the whole video. */
     music: zod_1.z
         .object({
@@ -379,6 +511,14 @@ exports.VideoPlanSchema = zod_1.z.object({
     voiceStyle: zod_1.z.string().optional(),
     /** Free-form planner notes — e.g. why a particular tier mix was chosen. */
     notes: zod_1.z.string().optional(),
+    /**
+     * CH-8 — caption styling applied to every CaptionClip at planToProject time.
+     * Set by the chat `change_caption_style` tool; absent → renderer defaults
+     * (Poppins / 48 / white). Persisting here (not just on the rendered project)
+     * keeps the look stable across caption regens. ORCHESTRATOR/LLM must NOT set
+     * this in the planner — it's a post-hoc user edit.
+     */
+    captionStyle: exports.CaptionStyleSchema.optional(),
     /**
      * AG-12 — Visual Bible built by the BibleBuilder pre-pass and threaded
      * into every scene that references entity ids. Optional because legacy

package/lib/services/agent/chatAgent.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 /**
  * Slice 2 — in-editor chat agent.
  *
@@ -45,12 +46,35 @@ export type ChatTurnEvent = {
 export interface ChatTurnTool {
     name: string;
     description: string;
-    /** JSON Schema (draft-07) for tool input. Must be an object schema. */
+    /** JSON Schema for tool input. Must be an object schema. Derived from `schema`
+     *  when the tool is built via {@link defineTool}; may also be hand-authored. */
     inputSchema: Record<string, unknown>;
+    /** Optional Zod schema. When present, `runChatTurn` validates the model's raw
+     *  tool arguments against it before calling `run` — on failure it returns a
+     *  structured `{ error, issues }` tool_result so the model can self-correct,
+     *  rather than letting malformed args reach `run`. The single source of truth
+     *  behind both `inputSchema` and this validation when built via `defineTool`. */
+    schema?: z.ZodType;
     /** Execute the tool against its parsed input. Return value is JSON-serialized
      *  back to the model as the tool_result content. */
     run: (input: unknown) => Promise<unknown> | unknown;
 }
+/**
+ * Build a {@link ChatTurnTool} from a single Zod schema — the schema is the one
+ * source of truth for BOTH the Anthropic `input_schema` (derived here via Zod 4's
+ * native `z.toJSONSchema`) AND the runtime validation `runChatTurn` performs
+ * before dispatch. This kills the drift that hand-writing a JSON Schema next to a
+ * separate `input as {...}` cast invites, and hands `run` already-validated,
+ * fully-typed input (`z.infer<S>`) instead of `unknown`.
+ */
+export interface ToolSpec<S extends z.ZodType> {
+    name: string;
+    description: string;
+    schema: S;
+    /** Runs against ALREADY-VALIDATED, typed input. */
+    run: (input: z.infer<S>) => Promise<unknown> | unknown;
+}
+export declare function defineTool<S extends z.ZodType>(spec: ToolSpec<S>): ChatTurnTool;
 export interface ChatTurnRequest {
     apiKey: string;
     model: string;

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

@@ -1 +1 @@
-{"version":3,"file":"chatAgent.d.ts","sourceRoot":"","sources":["../../../src/services/agent/chatAgent.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;wDACoD;IACpD,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAKD;;;;;;GAMG;AACH,wBAAuB,WAAW,CAChC,GAAG,EAAE,eAAe,GACnB,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAkI3C"}
+{"version":3,"file":"chatAgent.d.ts","sourceRoot":"","sources":["../../../src/services/agent/chatAgent.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;oFACgF;IAChF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;qFAIiF;IACjF,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACnB;wDACoD;IACpD,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,mDAAmD;IACnD,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACxD;AAaD,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAQ/E;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqGD;;;;;;GAMG;AACH,wBAAuB,WAAW,CAChC,GAAG,EAAE,eAAe,GACnB,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CA4K3C"}