vidspotai-shared 1.0.69-dev.0 → 1.0.69

package/lib/services/agent/stitchedVideoCritic.gemini.js

@@ -1,198 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildGeminiCriticInvoker = buildGeminiCriticInvoker;
-exports.buildGeminiPerSceneCriticInvoker = buildGeminiPerSceneCriticInvoker;
-const genai_1 = require("@google/genai");
-const zod_1 = require("zod");
-const logger_1 = require("../../utils/logger");
-const stitchedVideoCritic_1 = require("./stitchedVideoCritic");
-const perSceneCritic_1 = require("./perSceneCritic");
-/**
- * AG-26 / AG-34: Gemini invoker for the stitched-video critic.
- *
- * Earlier attempt tried to proxy through the Vercel AI Gateway with an
- * `input_audio_video` content part — gateway returned 400 because that
- * type doesn't exist. Switched to Gemini's official `@google/genai` SDK
- * + Files API for clean video upload. Same dependency `aiGen/google/`
- * providers already use.
- *
- * Video upload flow:
- *   1. Download the stitched MP4 from the supplied URL.
- *   2. Upload to Gemini File API (handles up to 2GB; we stay <20MB).
- *   3. Wait for the file to reach ACTIVE state (~1-2s for short clips).
- *   4. Generate content with the file ref + structured-output JSON schema.
- *
- * Cost: Gemini 2.5 Flash tokenizes ~258 tok/sec of video. A 15s clip ≈
- * 3.9k input tokens → ~$0.0003 at $0.075/1M input. Output JSON ≈ 300 tok
- * → ~$0.0001. Total ~$0.0004/critique.
- */
-const DEFAULT_MODEL = "gemini-2.5-flash";
-/** Sleep helper for the file-state poll loop. */
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-function buildGeminiCriticInvoker(config) {
-    const model = config.model ?? DEFAULT_MODEL;
-    const timeoutMs = config.timeoutMs ?? 180000;
-    const ai = new genai_1.GoogleGenAI({ apiKey: config.apiKey });
-    return async (args) => {
-        const deadline = Date.now() + timeoutMs;
-        const remain = () => Math.max(1000, deadline - Date.now());
-        // 1. Download the MP4 into memory.
-        const controller = new AbortController();
-        const dlTimeout = setTimeout(() => controller.abort(), remain());
-        let buf;
-        try {
-            const r = await fetch(args.videoUrl, { signal: controller.signal });
-            if (!r.ok) {
-                throw new Error(`stitchedCritic.gemini: video fetch ${r.status} ${r.statusText}`);
-            }
-            buf = Buffer.from(await r.arrayBuffer());
-        }
-        finally {
-            clearTimeout(dlTimeout);
-        }
-        // 2. Upload to Gemini Files API. The SDK accepts a Blob.
-        const ab = new ArrayBuffer(buf.byteLength);
-        new Uint8Array(ab).set(buf);
-        const blob = new Blob([ab], { type: "video/mp4" });
-        const uploaded = await ai.files.upload({
-            file: blob,
-            config: { mimeType: "video/mp4" },
-        });
-        if (!uploaded.name) {
-            throw new Error("stitchedCritic.gemini: upload returned no file name");
-        }
-        // 3. Poll until the file becomes ACTIVE — Gemini processes the video
-        // (frame extraction etc.) before it's usable in a generateContent call.
-        // 1s poll cadence; bail when state is FAILED or we hit the deadline.
-        let file = uploaded;
-        while (file.state === "PROCESSING") {
-            if (Date.now() > deadline) {
-                throw new Error("stitchedCritic.gemini: file processing timed out");
-            }
-            await sleep(1000);
-            file = await ai.files.get({ name: uploaded.name });
-        }
-        if (file.state !== "ACTIVE") {
-            throw new Error(`stitchedCritic.gemini: file state=${file.state}, error=${JSON.stringify(file.error ?? {})}`);
-        }
-        // 4. generateContent with structured-output JSON. responseSchema as a
-        // JSON-schema dict drives Gemini's structured-output mode.
-        const jsonSchema = zod_1.z.toJSONSchema(args.responseSchema, { target: "draft-7" });
-        const resp = await ai.models.generateContent({
-            model,
-            contents: [
-                {
-                    role: "user",
-                    parts: [
-                        { text: args.prompt },
-                        { fileData: { fileUri: file.uri, mimeType: file.mimeType ?? "video/mp4" } },
-                    ],
-                },
-            ],
-            config: {
-                responseMimeType: "application/json",
-                responseSchema: jsonSchema,
-                temperature: 0.2,
-            },
-        });
-        const text = resp.text;
-        if (!text) {
-            throw new Error("stitchedCritic.gemini: empty response");
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(text);
-        }
-        catch {
-            throw new Error(`stitchedCritic.gemini: non-JSON response: ${text.slice(0, 300)}`);
-        }
-        const reparsed = stitchedVideoCritic_1.StitchedVideoReviewSchema.safeParse(parsed);
-        if (!reparsed.success) {
-            throw new Error(`stitchedCritic.gemini: schema validation failed: ${reparsed.error.message}`);
-        }
-        logger_1.logger.info("stitchedCritic.gemini ok", {
-            score: reparsed.data.score,
-            shippable: reparsed.data.shippable,
-            findings: reparsed.data.findings.length,
-        });
-        return reparsed.data;
-    };
-}
-/**
- * AG-43: Gemini invoker for the per-scene critic. Same upload/poll/generate
- * flow as the stitched-critic invoker; differs only in the response schema
- * (PerSceneReviewSchema). Kept as a separate factory so the typing stays
- * tight at the call site.
- */
-function buildGeminiPerSceneCriticInvoker(config) {
-    const model = config.model ?? DEFAULT_MODEL;
-    const timeoutMs = config.timeoutMs ?? 90000;
-    const ai = new genai_1.GoogleGenAI({ apiKey: config.apiKey });
-    return async (args) => {
-        const deadline = Date.now() + timeoutMs;
-        const controller = new AbortController();
-        const dlTimeout = setTimeout(() => controller.abort(), Math.max(1000, deadline - Date.now()));
-        let buf;
-        try {
-            const r = await fetch(args.videoUrl, { signal: controller.signal });
-            if (!r.ok)
-                throw new Error(`perSceneCritic.gemini: fetch ${r.status} ${r.statusText}`);
-            buf = Buffer.from(await r.arrayBuffer());
-        }
-        finally {
-            clearTimeout(dlTimeout);
-        }
-        const ab = new ArrayBuffer(buf.byteLength);
-        new Uint8Array(ab).set(buf);
-        const blob = new Blob([ab], { type: "video/mp4" });
-        const uploaded = await ai.files.upload({ file: blob, config: { mimeType: "video/mp4" } });
-        if (!uploaded.name)
-            throw new Error("perSceneCritic.gemini: upload returned no name");
-        let file = uploaded;
-        while (file.state === "PROCESSING") {
-            if (Date.now() > deadline)
-                throw new Error("perSceneCritic.gemini: file processing timed out");
-            await sleep(1000);
-            file = await ai.files.get({ name: uploaded.name });
-        }
-        if (file.state !== "ACTIVE") {
-            throw new Error(`perSceneCritic.gemini: file state=${file.state}, error=${JSON.stringify(file.error ?? {})}`);
-        }
-        const jsonSchema = zod_1.z.toJSONSchema(args.responseSchema, { target: "draft-7" });
-        const resp = await ai.models.generateContent({
-            model,
-            contents: [
-                {
-                    role: "user",
-                    parts: [
-                        { text: args.prompt },
-                        { fileData: { fileUri: file.uri, mimeType: file.mimeType ?? "video/mp4" } },
-                    ],
-                },
-            ],
-            config: { responseMimeType: "application/json", responseSchema: jsonSchema, temperature: 0.2 },
-        });
-        const text = resp.text;
-        if (!text)
-            throw new Error("perSceneCritic.gemini: empty response");
-        let parsed;
-        try {
-            parsed = JSON.parse(text);
-        }
-        catch {
-            throw new Error(`perSceneCritic.gemini: non-JSON: ${text.slice(0, 300)}`);
-        }
-        const reparsed = perSceneCritic_1.PerSceneReviewSchema.safeParse(parsed);
-        if (!reparsed.success)
-            throw new Error(`perSceneCritic.gemini: schema validation: ${reparsed.error.message}`);
-        logger_1.logger.info("perSceneCritic.gemini ok", {
-            sceneIndex: reparsed.data.sceneIndex,
-            score: reparsed.data.score,
-            shippable: reparsed.data.shippable,
-            recommendRegenerate: reparsed.data.recommendRegenerate,
-        });
-        return reparsed.data;
-    };
-}

package/lib/services/agent/stitchedVideoCritic.js

@@ -1,162 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StitchedVideoReviewSchema = exports.StitchedVideoFindingSchema = void 0;
-exports.buildStitchedCriticPrompt = buildStitchedCriticPrompt;
-exports.runStitchedVideoCritic = runStitchedVideoCritic;
-const logger_1 = require("../../utils/logger");
-/**
- * AG-26: Stitched-video critic — the gate that catches everything the
- * per-scene critic misses.
- *
- * The existing `Critic` operates on per-scene asset URLs + the plan. That
- * misses anything that only becomes visible once the scenes are concatenated:
- *   - voiceover clipped / cut off / audibly truncated
- *   - jarring cuts (no rhythm, no music bed to disguise it)
- *   - character drift visible only when scenes play back-to-back
- *   - brand text degradation across cuts (the human eye notices "Hydropure
- *     → HydraPure → HydrraPure" instantly when watching; per-frame critique
- *     gives each scene a pass)
- *   - missing or 404 music track
- *   - overall pacing / hook → reveal → CTA arc as a viewer experiences it
- *
- * Implementation: call Gemini 2.5 Flash with the stitched MP4 file_uri.
- * Gemini accepts video + audio natively, tokenizes ~258 tok/sec of video,
- * so a 15s clip is ~4k input tokens → ~$0.0003 / critique. Essentially free.
- *
- * Returns structured findings in the same shape as the per-scene Critic so
- * the orchestrator can merge both into a single review.
- */
-const zod_1 = require("zod");
-exports.StitchedVideoFindingSchema = zod_1.z.object({
-    severity: zod_1.z.enum(["pass", "warn", "fail"]),
-    dimension: zod_1.z.enum([
-        "hookStrength",
-        "voiceoverClarity",
-        "voiceoverEmotionMatch",
-        "voiceoverPacing",
-        "audioMixBalance",
-        "musicPresence",
-        "characterContinuity",
-        "brandTextLegibility",
-        "pacingFit",
-        "cutRhythm",
-        "ctaPresence",
-        // AG-43: physical action coherence — flagged sealed-bottle drinking miss
-        // on Test 1 fresh run. Checks state-of-object vs action compatibility.
-        "actionPlausibility",
-        "overallImpression",
-    ]),
-    message: zod_1.z.string().min(4),
-    sceneIndexHint: zod_1.z.number().int().nonnegative().optional(),
-});
-exports.StitchedVideoReviewSchema = zod_1.z.object({
-    score: zod_1.z.number().min(0).max(10).describe("Overall production-readiness 0-10."),
-    shippable: zod_1.z.boolean().describe("Could this be sent to a paying customer as-is?"),
-    summary: zod_1.z.string().min(10).max(800),
-    findings: zod_1.z.array(exports.StitchedVideoFindingSchema),
-});
-/**
- * Build the rubric prompt the Gemini call receives alongside the video. Kept
- * outside the API caller so unit tests can snapshot it.
- */
-function buildStitchedCriticPrompt(input) {
-    const { plan, whisperTranscript, audioStats, groundTruth } = input;
-    const planLines = plan.scenes
-        .map((s) => `  scene ${s.sceneIndex} (${s.durationMs}ms, ${s.strategy}, tier=${s.tier}): VO="${s.voiceoverLine ?? "(none)"}" OST="${s.onScreenText ?? "(none)"}"`)
-        .join("\n");
-    const audioSection = audioStats
-        ? `Audio measurements (from ffmpeg):\n  meanDb=${audioStats.meanDb ?? "?"} maxDb=${audioStats.maxDb ?? "?"} longestSilenceMs=${audioStats.longestSilenceMs ?? "?"}\n`
-        : "";
-    const truthLines = [];
-    if (groundTruth) {
-        truthLines.push("GROUND TRUTH about the file you're watching (from the stitcher — these are facts, not the plan):");
-        if (groundTruth.hasAudio !== undefined)
-            truthLines.push(`  hasAudio       = ${groundTruth.hasAudio}`);
-        if (groundTruth.hasVoiceover !== undefined)
-            truthLines.push(`  hasVoiceover   = ${groundTruth.hasVoiceover}`);
-        if (groundTruth.hasMusic !== undefined)
-            truthLines.push(`  hasMusic       = ${groundTruth.hasMusic}  ${groundTruth.hasMusic === false ? "(music was planned but NOT rendered — flag musicPresence=fail)" : ""}`);
-        if (groundTruth.notes?.length)
-            truthLines.push(`  stitcher notes : ${groundTruth.notes.join(" | ")}`);
-        truthLines.push("Do NOT describe audio elements that ground truth says are absent. If hasMusic=false you must score musicPresence=fail and not invent music descriptions.");
-        truthLines.push("");
-    }
-    const truthSection = truthLines.join("\n");
-    const transcriptSection = whisperTranscript
-        ? `\nWhisper transcript of the audio (ground truth — diff against the planned VO lines above):\n"""\n${whisperTranscript}\n"""\n`
-        : "";
-    return [
-        "You are a senior creative reviewer for AI-generated short-form video ads.",
-        "You will WATCH the attached video (including audio) end to end, then score it",
-        "against the plan + rubric below. Be ruthless — a 9/10 means production-ready",
-        "for a paying customer; a 5/10 means major issues; a 2/10 means the executor",
-        "technically succeeded but the output is not usable.",
-        "",
-        `Plan: ${plan.scenes.length} scenes, total ${Math.round(plan.totalDurationMs / 1000)}s, aspect ${plan.aspect}, persona ${plan.persona}.`,
-        `Music: strategy=${plan.music?.strategy ?? "none"} url=${plan.music?.url ?? "(none)"}.`,
-        `Voice: id=${plan.voiceId ?? "(default)"} style=${plan.voiceStyle ?? "(default)"}.`,
-        "",
-        "Per-scene spec the executor was supposed to render:",
-        planLines,
-        "",
-        truthSection,
-        audioSection,
-        transcriptSection,
-        "Rubric — score each dimension pass / warn / fail:",
-        "  - hookStrength       : does the first 2-3s grab attention (pattern interrupt / problem statement)?",
-        "  - voiceoverClarity   : is every spoken word audibly clear, not clipped, no chop mid-sentence?",
-        "  - voiceoverEmotionMatch : does the delivery match the brief's intent (excited UGC vs calm explainer)?",
-        "  - voiceoverPacing    : does the speech fit the cuts naturally, or is it racing / dragging?",
-        "  - audioMixBalance    : voice and music balanced; voice not buried, music not drowning?",
-        "  - musicPresence      : if plan called for music, is it actually there? (silent music = fail)",
-        "  - characterContinuity: same person across scenes (when applicable) or jarring identity drift?",
-        "  - brandTextLegibility: any brand/product text on screen rendered correctly (no misspellings, no mangled letters)?",
-        "  - pacingFit          : cuts feel like the persona (UGC=fast, talking-head=medium)?",
-        "  - cutRhythm          : transitions feel intentional vs choppy?",
-        "  - ctaPresence        : closing CTA combines brand + verb, viewer leaves with both?",
-        "  - actionPlausibility : every visible action must be physically possible given the state of objects on screen. Examples that MUST be flagged FAIL: drinking from a bottle with the cap still on; pouring from a sealed container; using a phone with a blank/dark screen; walking through a closed door; lifting a heavy object with no hand contact; the brand label on the product becomes a different word or garbles between scenes. If the prior scene didn't establish the enabling state (cap twisted off, screen turned on), grade the action's scene FAIL with sceneIndexHint pointing to the violator. Pay specific attention to caps, lids, seals, buttons, doors, switches.",
-        "  - overallImpression  : would a marketing director ship this as-is?",
-        "",
-        "Output JSON exactly matching the response schema. score: weighted 0-10 over all",
-        "dimensions; shippable: boolean (would a paying customer accept this?); summary:",
-        "2-4 sentences; findings: array of {severity, dimension, message, sceneIndexHint?}.",
-        "Always include at least one finding per dimension that warns or fails. Use",
-        "sceneIndexHint when a finding maps to a specific scene.",
-    ].join("\n");
-}
-/**
- * Run the critic. Caller passes an `invokeGemini` function so this module
- * stays decoupled from the LLM gateway. Real wiring lives in
- * `agent/stitchedVideoCritic.gemini.ts` (added separately so tests can mock
- * the boundary).
- *
- * Soft-fails: on any error returns a single warn finding with the error
- * message so the orchestrator can still surface "we couldn't auto-review"
- * to the user without crashing the run.
- */
-async function runStitchedVideoCritic(input, invokeGemini) {
-    try {
-        const prompt = buildStitchedCriticPrompt(input);
-        return await invokeGemini({
-            prompt,
-            videoUrl: input.videoUrl,
-            responseSchema: exports.StitchedVideoReviewSchema,
-        });
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        logger_1.logger.warn("stitchedVideoCritic failed; returning soft-fail review", { err: msg });
-        return {
-            score: 0,
-            shippable: false,
-            summary: `Stitched-video critic failed to run: ${msg}. Manual review required.`,
-            findings: [
-                {
-                    severity: "warn",
-                    dimension: "overallImpression",
-                    message: `Critic call failed: ${msg}`,
-                },
-            ],
-        };
-    }
-}

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

@@ -1,65 +0,0 @@
-import { TVideoJobTask } from "../../globals/types";
-/**
- * TaskPoller — shared async-task polling primitive.
- *
- * Used by the agent executor's host (executeProject) to drain pendingTaskIds
- * emitted by animate_image / generate_video / generate_avatar_video. The
- * legacy form-driven videoJobProcessor still uses its own sceneMonitor for
- * now; both paths will converge here once sceneMonitor is refactored.
- *
- * Design notes:
- * - Backoff: exponential 10s → 30s → 60s caps (provider rate-limit friendly).
- * - Timeout: per-model (aiModelConfigs[*].pollTimeoutMs) with 15-min fallback.
- * - Retry: per-task transient errors retried up to 3x before marking failed.
- * - Partial success: returns one result per input task; never throws on
- *   per-task failure. Caller decides how to react.
- */
-export interface PollableTask {
-    /** Stable id used in the result map. Caller supplies (e.g. scene index). */
-    ref: string;
-    /** Provider task handle (provider-shaped — string or struct). */
-    task: TVideoJobTask;
-    /** Model the task was triggered on. Drives provider routing + poll timing. */
-    modelKey: string;
-    /** Output filename hint forwarded to the provider's checkVideoStatus. */
-    outputFilename?: string;
-}
-export type PolledTaskStatus = "completed" | "failed" | "timed-out";
-export interface PolledTaskResult {
-    ref: string;
-    status: PolledTaskStatus;
-    videoUrl?: string;
-    errorMessage?: string;
-    durationMs: number;
-}
-export interface TaskPollerOptions {
-    /** Initial poll interval. Doubles each cycle (capped at maxIntervalMs). */
-    initialIntervalMs?: number;
-    /** Maximum interval between cycles. */
-    maxIntervalMs?: number;
-    /** Per-task hard timeout. Falls back to aiModelConfigs[modelKey].pollTimeoutMs, then 15 min. */
-    timeoutMs?: number;
-    /** Per-task transient-error retry budget. */
-    maxRetriesPerTask?: number;
-}
-export declare class TaskPoller {
-    private readonly initialIntervalMs;
-    private readonly maxIntervalMs;
-    private readonly maxRetries;
-    private readonly timeoutOverrideMs?;
-    constructor(opts?: TaskPollerOptions);
-    /**
-     * Poll every task in `tasks` until each one settles (completed / failed /
-     * timed-out). Returns one PolledTaskResult per input in input order.
-     *
-     * Tasks share a single backoff loop — providers are polled together each
-     * cycle, parallelism is bounded by getAiGenProviderService rate limiters.
-     */
-    pollAll(tasks: PollableTask[]): Promise<PolledTaskResult[]>;
-    private pollOne;
-    /** Idempotent release of the submit-time concurrent slot. Called from
-     *  every settle branch (completed / failed / timed-out / retries-exhausted). */
-    private releaseSlot;
-    private resolveTimeout;
-}
-//# sourceMappingURL=taskPoller.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

package/lib/services/agent/taskPoller.js

@@ -1,176 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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 rateLimiter_1 = require("../rateLimiter");
-const logger_1 = require("../../utils/logger");
-const DEFAULT_INITIAL_INTERVAL_MS = 10000;
-const DEFAULT_MAX_INTERVAL_MS = 60000;
-const DEFAULT_TIMEOUT_MS = 15 * 60 * 1000;
-const DEFAULT_MAX_RETRIES = 3;
-class TaskPoller {
-    constructor(opts = {}) {
-        this.initialIntervalMs = opts.initialIntervalMs ?? DEFAULT_INITIAL_INTERVAL_MS;
-        this.maxIntervalMs = opts.maxIntervalMs ?? DEFAULT_MAX_INTERVAL_MS;
-        this.maxRetries = opts.maxRetriesPerTask ?? DEFAULT_MAX_RETRIES;
-        this.timeoutOverrideMs = opts.timeoutMs;
-    }
-    /**
-     * Poll every task in `tasks` until each one settles (completed / failed /
-     * timed-out). Returns one PolledTaskResult per input in input order.
-     *
-     * Tasks share a single backoff loop — providers are polled together each
-     * cycle, parallelism is bounded by getAiGenProviderService rate limiters.
-     */
-    async pollAll(tasks) {
-        if (tasks.length === 0)
-            return [];
-        const states = tasks.map((t) => ({
-            input: t,
-            startedAt: Date.now(),
-            retries: 0,
-        }));
-        let intervalMs = this.initialIntervalMs;
-        while (states.some((s) => !s.result)) {
-            await Promise.all(states.map((state) => (state.result ? Promise.resolve() : this.pollOne(state))));
-            if (states.every((s) => s.result))
-                break;
-            await sleep(intervalMs);
-            intervalMs = Math.min(intervalMs * 2, this.maxIntervalMs);
-        }
-        return states.map((s) => s.result);
-    }
-    async pollOne(state) {
-        const { input, startedAt } = state;
-        const elapsed = Date.now() - startedAt;
-        const timeoutMs = this.resolveTimeout(input.modelKey);
-        if (elapsed > timeoutMs) {
-            state.result = {
-                ref: input.ref,
-                status: "timed-out",
-                errorMessage: `Poll window expired after ${Math.floor(elapsed / 1000)}s — provider task may still be running`,
-                durationMs: elapsed,
-            };
-            this.releaseSlot(state);
-            logger_1.logger.warn("TaskPoller timed out", {
-                ref: input.ref,
-                modelKey: input.modelKey,
-                elapsedSec: Math.floor(elapsed / 1000),
-            });
-            return;
-        }
-        try {
-            // Per-poll rate gate — counts against per-min / per-day quota but
-            // NOT the concurrent cap (the in-flight task already holds a slot
-            // from submit). Without this, N in-flight tasks polling every 10s
-            // can blow past providers' per-minute submit budgets (Veo 50/min
-            // 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}`,
-            });
-            switch (result.status) {
-                case types_1.EVideoSceneStatus.COMPLETED:
-                    state.result = {
-                        ref: input.ref,
-                        status: "completed",
-                        videoUrl: result.videoUrl,
-                        durationMs: Date.now() - startedAt,
-                    };
-                    this.releaseSlot(state);
-                    return;
-                case types_1.EVideoSceneStatus.FAILED:
-                    state.result = {
-                        ref: input.ref,
-                        status: "failed",
-                        errorMessage: result.errorMessage ?? "Provider reported failure with no details",
-                        durationMs: Date.now() - startedAt,
-                    };
-                    this.releaseSlot(state);
-                    return;
-                default:
-                    return; // still in progress; next cycle picks it back up
-            }
-        }
-        catch (err) {
-            state.retries++;
-            // Surface enough context to diagnose. Previously this logged only
-            // err.message; for bare `Error` instances that yields the useless
-            // string "Error" with no clue whether the failure is in the provider
-            // API, the CDN download, GCS upload, or signed-URL minting.
-            const isErr = err instanceof Error;
-            const msg = isErr ? err.message || err.toString() : String(err);
-            const errName = isErr ? err.name : typeof err;
-            const errCode = isErr ? err.code : undefined;
-            const httpStatus = isErr
-                ? err.response?.status
-                : undefined;
-            const stackHead = isErr && err.stack
-                ? err.stack.split("\n").slice(0, 4).join(" | ")
-                : undefined;
-            logger_1.logger.warn("TaskPoller transient error", {
-                ref: input.ref,
-                modelKey: input.modelKey,
-                attempt: state.retries,
-                errName,
-                errCode,
-                httpStatus,
-                err: msg,
-                stackHead,
-            });
-            if (state.retries >= this.maxRetries) {
-                logger_1.logger.error("TaskPoller: retries exhausted", {
-                    ref: input.ref,
-                    modelKey: input.modelKey,
-                    attempts: state.retries,
-                    errName,
-                    errCode,
-                    httpStatus,
-                    lastErr: err instanceof Error ? err.stack ?? err.message : String(err),
-                });
-                state.result = {
-                    ref: input.ref,
-                    status: "failed",
-                    errorMessage: `Status check failed after ${this.maxRetries} retries: ${errName}: ${msg}`,
-                    durationMs: Date.now() - startedAt,
-                };
-                this.releaseSlot(state);
-            }
-        }
-    }
-    /** Idempotent release of the submit-time concurrent slot. Called from
-     *  every settle branch (completed / failed / timed-out / retries-exhausted). */
-    releaseSlot(state) {
-        if (state.slotReleased)
-            return;
-        state.slotReleased = true;
-        try {
-            (0, rateLimiter_1.getAiGenModelRateLimiter)(state.input.modelKey).releaseSlot();
-        }
-        catch (err) {
-            // Unknown modelKey — log and move on. Better to leak a slot than
-            // throw out of the poll loop.
-            logger_1.logger.warn("TaskPoller release slot failed", {
-                ref: state.input.ref,
-                modelKey: state.input.modelKey,
-                err: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    resolveTimeout(modelKey) {
-        if (this.timeoutOverrideMs)
-            return this.timeoutOverrideMs;
-        const cfg = aiModels_1.aiModelConfigs[modelKey];
-        return cfg?.pollTimeoutMs ?? DEFAULT_TIMEOUT_MS;
-    }
-}
-exports.TaskPoller = TaskPoller;
-function sleep(ms) {
-    return new Promise((res) => setTimeout(res, ms));
-}

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

@@ -1,60 +0,0 @@
-/**
- * AG-40 — role-default style guide for text overlays.
- *
- * The planner picks a role per overlay (headline, cta, watermark, etc.). This
- * file is the single source of truth for "what does role X look like". Each
- * role's defaults are tuned for vertical 9:16 (1080×1920) but scale by
- * fraction-of-frame so they work on 16:9 / 1:1 too. Per-overlay overrides
- * still win at render time — this is "the polish default the planner can
- * trust to look OK without thinking".
- *
- * Why a style guide vs. ad-hoc per-scene styling: the previous one-string
- * `onScreenText` model produced overlays that ran off the side of the frame
- * (see Test 1 closing scene — "HydraPure — Order" with the H cut off) and
- * looked uniformly amateurish (every caption was the same bold-white-bottom
- * block). Roles let the renderer treat a headline differently from a
- * disclaimer differently from a watermark, automatically.
- */
-import type { TextRole, TextPosition, TextOverlay } from "../../schemas/videoPlan.schema";
-export interface ResolvedTextStyle {
-    position: TextPosition;
-    /** Fraction of frame height — multiplied by output H at render time. */
-    fontSizeFraction: number;
-    weight: "regular" | "medium" | "bold" | "black";
-    color: string;
-    /** Background color (CSS-ish) or undefined for transparent. */
-    bgColor?: string;
-    /** Background alpha 0-1; only used if bgColor set. */
-    bgAlpha?: number;
-    /** Stroke width in px at output resolution. */
-    strokeWidth: number;
-    strokeColor: string;
-    animation: "none" | "fade" | "pop" | "type" | "slide-up" | "word-pop" | "highlight-current";
-    /**
-     * Max horizontal fraction of frame for word-wrap. Lower = narrower column,
-     * forces wrapping sooner. Watermarks get a small fraction so they hug the
-     * corner; headlines get a wide one so single-line slogans fit.
-     */
-    maxWidthFraction: number;
-    /** Padding from edge (fraction of min(W,H)). */
-    edgePaddingFraction: number;
-    /**
-     * If set, this is the default "persist across scenes" behavior for the role.
-     * Watermarks default to true (sticky brand mark); everything else false.
-     */
-    persistAcrossScenesDefault?: boolean;
-    /** Caller hint: which font weights should be tried in order. */
-    preferredFonts: string[];
-}
-export declare const TEXT_ROLE_STYLES: Record<TextRole, ResolvedTextStyle>;
-/**
- * Merge per-overlay overrides with role defaults. Per-overlay wins for any
- * field the LLM chose to set; role default fills the rest.
- */
-export declare function resolveOverlayStyle(overlay: TextOverlay): ResolvedTextStyle;
-/**
- * Cheat sheet the planner gets in its system prompt so it knows when to use
- * which role and the soft per-role word-count caps that keep frames clean.
- */
-export declare const TEXT_ROLE_CHEAT_SHEET: string;
-//# sourceMappingURL=textOverlayStyles.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"textOverlayStyles.d.ts","sourceRoot":"","sources":["../../../src/services/agent/textOverlayStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EACL,MAAM,GACN,MAAM,GACN,KAAK,GACL,MAAM,GACN,UAAU,GACV,UAAU,GACV,mBAAmB,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gEAAgE;IAChE,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AASD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAyGhE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,CAY3E;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAmB1B,CAAC"}