vidspotai-shared 1.0.55 → 1.0.56

package/lib/services/agent/eval/types.d.ts

@@ -1,196 +0,0 @@
-import { z } from "zod";
-/**
- * Eval set + replay infrastructure.
- *
- * The eval harness exists so we can measure agent quality every time we change
- * the planner prompt, the model routing, or a tool description — instead of
- * shipping blind. Every interactive agent run is also recorded as a trace so it
- * can be replayed offline against a candidate change.
- *
- * 50 hand-curated briefs target launch; a handful of seed briefs ship in code
- * so the harness is runnable from day one.
- */
-/** Rubric axes, scored 0-1 by the judge. */
-export declare const EvalRubricSchema: z.ZodObject<{
-    hookStrength: z.ZodNumber;
-    voVisualSync: z.ZodNumber;
-    pacingFit: z.ZodNumber;
-    brandSafety: z.ZodNumber;
-    costVsTier: z.ZodNumber;
-    intentMatch: z.ZodNumber;
-}, z.core.$strip>;
-export type EvalRubric = z.infer<typeof EvalRubricSchema>;
-export declare const EvalBriefSchema: z.ZodObject<{
-    id: z.ZodString;
-    niche: z.ZodString;
-    brief: z.ZodObject<{
-        rawPrompt: z.ZodString;
-        goal: z.ZodOptional<z.ZodString>;
-        niche: z.ZodOptional<z.ZodEnum<{
-            "ugc-ad": "ugc-ad";
-            "faceless-yt": "faceless-yt";
-            "product-demo": "product-demo";
-            "talking-head": "talking-head";
-            "social-recap": "social-recap";
-            "real-estate": "real-estate";
-            recipe: "recipe";
-            travel: "travel";
-            fitness: "fitness";
-            "podcast-clip": "podcast-clip";
-            education: "education";
-            news: "news";
-            other: "other";
-        }>>;
-        audience: z.ZodOptional<z.ZodString>;
-        tone: z.ZodOptional<z.ZodEnum<{
-            energetic: "energetic";
-            calm: "calm";
-            cinematic: "cinematic";
-            playful: "playful";
-            casual: "casual";
-            professional: "professional";
-            edgy: "edgy";
-            warm: "warm";
-            informational: "informational";
-        }>>;
-        hookStyle: z.ZodOptional<z.ZodEnum<{
-            question: "question";
-            "bold-claim": "bold-claim";
-            "pattern-interrupt": "pattern-interrupt";
-            story: "story";
-            stat: "stat";
-            demo: "demo";
-            "voiceover-only": "voiceover-only";
-        }>>;
-        pacing: z.ZodOptional<z.ZodEnum<{
-            medium: "medium";
-            fast: "fast";
-            slow: "slow";
-            "very-fast": "very-fast";
-        }>>;
-        durationSec: z.ZodOptional<z.ZodNumber>;
-        aspect: z.ZodOptional<z.ZodEnum<{
-            "9:16": "9:16";
-            "16:9": "16:9";
-            "1:1": "1:1";
-            "4:5": "4:5";
-        }>>;
-        voice: z.ZodOptional<z.ZodObject<{
-            gender: z.ZodOptional<z.ZodEnum<{
-                female: "female";
-                male: "male";
-                neutral: "neutral";
-            }>>;
-            ageRange: z.ZodOptional<z.ZodEnum<{
-                child: "child";
-                teen: "teen";
-                "young-adult": "young-adult";
-                adult: "adult";
-                senior: "senior";
-            }>>;
-            accent: z.ZodOptional<z.ZodString>;
-            language: z.ZodDefault<z.ZodString>;
-            voiceId: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        music: z.ZodOptional<z.ZodObject<{
-            moods: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-                energetic: "energetic";
-                calm: "calm";
-                cinematic: "cinematic";
-                uplifting: "uplifting";
-                tense: "tense";
-                dreamy: "dreamy";
-                dark: "dark";
-                playful: "playful";
-            }>>>;
-            bpmMin: z.ZodOptional<z.ZodNumber>;
-            bpmMax: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        cta: z.ZodOptional<z.ZodString>;
-        claims: z.ZodDefault<z.ZodObject<{
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            block: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-        references: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
-            analyzed: z.ZodOptional<z.ZodObject<{
-                durationMs: z.ZodNumber;
-                sceneCount: z.ZodNumber;
-                hookMs: z.ZodNumber;
-                cutsPerSecond: z.ZodNumber;
-                bpm: z.ZodOptional<z.ZodNumber>;
-                transcriptExcerpt: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>>;
-        tierBudget: z.ZodDefault<z.ZodEnum<{
-            T0: "T0";
-            T1: "T1";
-            T2: "T2";
-            T3: "T3";
-        }>>;
-        confidence: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    }, z.core.$strip>;
-    goodOutputNotes: z.ZodString;
-}, z.core.$strip>;
-export type EvalBrief = z.infer<typeof EvalBriefSchema>;
-export declare const ToolCallTraceSchema: z.ZodObject<{
-    ts: z.ZodNumber;
-    tool: z.ZodString;
-    input: z.ZodUnknown;
-    outcome: z.ZodUnion<readonly [z.ZodObject<{
-        ok: z.ZodLiteral<true>;
-        output: z.ZodUnknown;
-        durationMs: z.ZodNumber;
-    }, z.core.$strip>, z.ZodObject<{
-        ok: z.ZodLiteral<false>;
-        error: z.ZodObject<{
-            code: z.ZodString;
-            message: z.ZodString;
-        }, z.core.$strip>;
-        durationMs: z.ZodNumber;
-    }, z.core.$strip>]>;
-}, z.core.$strip>;
-export type ToolCallTrace = z.infer<typeof ToolCallTraceSchema>;
-export declare const AgentRunTraceSchema: z.ZodObject<{
-    agentRunId: z.ZodString;
-    briefId: z.ZodOptional<z.ZodString>;
-    startedAt: z.ZodString;
-    endedAt: z.ZodOptional<z.ZodString>;
-    modelRouting: z.ZodRecord<z.ZodString, z.ZodString>;
-    rngSeed: z.ZodString;
-    toolCalls: z.ZodArray<z.ZodObject<{
-        ts: z.ZodNumber;
-        tool: z.ZodString;
-        input: z.ZodUnknown;
-        outcome: z.ZodUnion<readonly [z.ZodObject<{
-            ok: z.ZodLiteral<true>;
-            output: z.ZodUnknown;
-            durationMs: z.ZodNumber;
-        }, z.core.$strip>, z.ZodObject<{
-            ok: z.ZodLiteral<false>;
-            error: z.ZodObject<{
-                code: z.ZodString;
-                message: z.ZodString;
-            }, z.core.$strip>;
-            durationMs: z.ZodNumber;
-        }, z.core.$strip>]>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type AgentRunTrace = z.infer<typeof AgentRunTraceSchema>;
-export declare const EvalScoreSchema: z.ZodObject<{
-    briefId: z.ZodString;
-    agentRunId: z.ZodString;
-    rubric: z.ZodObject<{
-        hookStrength: z.ZodNumber;
-        voVisualSync: z.ZodNumber;
-        pacingFit: z.ZodNumber;
-        brandSafety: z.ZodNumber;
-        costVsTier: z.ZodNumber;
-        intentMatch: z.ZodNumber;
-    }, z.core.$strip>;
-    score: z.ZodNumber;
-    judgeNotes: z.ZodString;
-    scoredAt: z.ZodString;
-}, z.core.$strip>;
-export type EvalScore = z.infer<typeof EvalScoreSchema>;
-//# sourceMappingURL=types.d.ts.map

package/lib/services/agent/eval/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/eval/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;GAUG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;;;;;;;iBAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAY9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/lib/services/agent/eval/types.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EvalScoreSchema = exports.AgentRunTraceSchema = exports.ToolCallTraceSchema = exports.EvalBriefSchema = exports.EvalRubricSchema = void 0;
-const zod_1 = require("zod");
-const brief_schema_1 = require("../../../schemas/brief.schema");
-/**
- * Eval set + replay infrastructure.
- *
- * The eval harness exists so we can measure agent quality every time we change
- * the planner prompt, the model routing, or a tool description — instead of
- * shipping blind. Every interactive agent run is also recorded as a trace so it
- * can be replayed offline against a candidate change.
- *
- * 50 hand-curated briefs target launch; a handful of seed briefs ship in code
- * so the harness is runnable from day one.
- */
-/** Rubric axes, scored 0-1 by the judge. */
-exports.EvalRubricSchema = zod_1.z.object({
-    hookStrength: zod_1.z.number().min(0).max(1),
-    voVisualSync: zod_1.z.number().min(0).max(1),
-    pacingFit: zod_1.z.number().min(0).max(1),
-    brandSafety: zod_1.z.number().min(0).max(1),
-    costVsTier: zod_1.z.number().min(0).max(1),
-    /** Did the result actually look like the niche/persona? Catches off-brief drift. */
-    intentMatch: zod_1.z.number().min(0).max(1),
-});
-exports.EvalBriefSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    niche: zod_1.z.string(),
-    brief: brief_schema_1.VideoBriefSchema,
-    /** Free-form rubric notes the judge prompt prepends — what "good" looks like for THIS brief. */
-    goodOutputNotes: zod_1.z.string(),
-});
-exports.ToolCallTraceSchema = zod_1.z.object({
-    ts: zod_1.z.number(),
-    tool: zod_1.z.string(),
-    input: zod_1.z.unknown(),
-    outcome: zod_1.z.union([
-        zod_1.z.object({ ok: zod_1.z.literal(true), output: zod_1.z.unknown(), durationMs: zod_1.z.number() }),
-        zod_1.z.object({
-            ok: zod_1.z.literal(false),
-            error: zod_1.z.object({ code: zod_1.z.string(), message: zod_1.z.string() }),
-            durationMs: zod_1.z.number(),
-        }),
-    ]),
-});
-exports.AgentRunTraceSchema = zod_1.z.object({
-    agentRunId: zod_1.z.string(),
-    briefId: zod_1.z.string().optional(),
-    startedAt: zod_1.z.string().datetime(),
-    endedAt: zod_1.z.string().datetime().optional(),
-    modelRouting: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
-    /** Deterministic RNG seed so re-runs (with the same models + tool stubs) are reproducible. */
-    rngSeed: zod_1.z.string(),
-    toolCalls: zod_1.z.array(exports.ToolCallTraceSchema),
-});
-exports.EvalScoreSchema = zod_1.z.object({
-    briefId: zod_1.z.string(),
-    agentRunId: zod_1.z.string(),
-    rubric: exports.EvalRubricSchema,
-    /** Weighted aggregate; weights live in the harness. */
-    score: zod_1.z.number().min(0).max(1),
-    judgeNotes: zod_1.z.string(),
-    scoredAt: zod_1.z.string().datetime(),
-});

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

@@ -1,50 +0,0 @@
-import { PlannedScene, VideoPlan } from "../../schemas/videoPlan.schema";
-import { ToolContext, ToolOutcome } from "./toolRegistry";
-export type RunToolFn = <O = unknown>(name: string, input: unknown, ctx: ToolContext) => Promise<ToolOutcome<O>>;
-/**
- * Executor — turns an approved VideoPlan into per-scene asset results.
- *
- * Plan-then-execute split (not free-form ReAct): the executor does NOT pick
- * tools. The plan dictates which tool runs per scene; the executor only does
- * the dispatch + per-scene parallelism + idempotency-key generation.
- *
- * Returns a SceneOutcome per scene, leaving composition (compose_scene),
- * critique (Critic.review), and render to the orchestrator above.
- */
-export interface SceneAssetResult {
-    /** Concrete asset URL for the visual track (image or video). */
-    visualUrl?: string;
-    /** Voiceover audio (base64 or url depending on host policy). */
-    voiceoverAudioBase64?: string;
-    /** Provider task id for async generations the host still needs to poll. */
-    pendingTaskId?: string;
-    /** Tool name used. */
-    tool: string;
-    /** Idempotency key the executor minted; useful for retries. */
-    idempotencyKey: string;
-}
-export interface SceneOutcome {
-    scene: PlannedScene;
-    ok: boolean;
-    result?: SceneAssetResult;
-    error?: {
-        code: string;
-        message: string;
-    };
-    durationMs: number;
-}
-export interface ExecutorOptions {
-    /** Max scenes to run in parallel. Generation providers rate-limit themselves; this guards on top. */
-    concurrency?: number;
-    /** Inject a recording wrapper (e.g. runToolRecorded) for eval / replay. */
-    runTool?: RunToolFn;
-}
-export declare class Executor {
-    private readonly concurrency;
-    private readonly runTool;
-    constructor(opts?: ExecutorOptions);
-    run(plan: VideoPlan, ctx: ToolContext): Promise<SceneOutcome[]>;
-    private runScene;
-    private runVisual;
-}
-//# sourceMappingURL=executor.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/services/agent/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAA6B,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,OAAO,EAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;gBAExB,IAAI,GAAE,eAAoB;IAKhC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAsBvD,QAAQ;YA4CR,SAAS;CAyKxB"}

package/lib/services/agent/executor.js

@@ -1,188 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Executor = void 0;
-const toolRegistry_1 = require("./toolRegistry");
-class Executor {
-    constructor(opts = {}) {
-        this.concurrency = opts.concurrency ?? 4;
-        this.runTool = opts.runTool ?? toolRegistry_1.runTool;
-    }
-    async run(plan, ctx) {
-        const queue = [...plan.scenes];
-        const results = new Array(plan.scenes.length);
-        const workers = [];
-        let cursor = 0;
-        const worker = async () => {
-            while (true) {
-                const i = cursor++;
-                if (i >= queue.length)
-                    return;
-                const scene = queue[i];
-                results[i] = await this.runScene(scene, ctx, plan.aspect);
-            }
-        };
-        for (let i = 0; i < Math.min(this.concurrency, queue.length); i++) {
-            workers.push(worker());
-        }
-        await Promise.all(workers);
-        return results;
-    }
-    async runScene(scene, ctx, aspect) {
-        const start = Date.now();
-        const idempotencyKey = `${ctx.agentRunId}:scene-${scene.sceneIndex}`;
-        const sceneCtx = { ...ctx, idempotencyKey };
-        const visualOutcome = await this.runVisual(scene, sceneCtx, aspect);
-        if (!visualOutcome.ok) {
-            return {
-                scene,
-                ok: false,
-                error: visualOutcome.error,
-                durationMs: Date.now() - start,
-            };
-        }
-        let voiceoverAudioBase64;
-        // talking-head-avatar bakes the VO into the rendered MP4; running TTS again
-        // here would just waste credits and create a duplicate audio track.
-        if (scene.voiceoverLine && scene.strategy !== "talking-head-avatar") {
-            const voOutcome = await this.runTool("generate_voiceover", { text: scene.voiceoverLine }, { ...sceneCtx, idempotencyKey: `${idempotencyKey}:vo` });
-            if (voOutcome.ok)
-                voiceoverAudioBase64 = voOutcome.output.audioBase64;
-            // Don't fail the whole scene on VO miss — host can re-run just the VO.
-        }
-        return {
-            scene,
-            ok: true,
-            result: {
-                ...visualOutcome.output,
-                voiceoverAudioBase64,
-                idempotencyKey,
-            },
-            durationMs: Date.now() - start,
-        };
-    }
-    async runVisual(scene, ctx, aspect) {
-        const durationSec = Math.max(2, Math.round(scene.durationMs / 1000));
-        const wrap = (tool, outcome) => outcome.ok
-            ? { ok: true, output: { tool, ...outcome.output } }
-            : { ok: false, error: outcome.error };
-        switch (scene.strategy) {
-            case "stock-video":
-            case "stock-image-ken-burns": {
-                const out = await this.runTool("search_stock", {
-                    query: scene.prompt,
-                    kind: scene.strategy === "stock-video" ? "video" : "image",
-                    aspectRatio: aspect,
-                    minDurationSec: scene.strategy === "stock-video" ? durationSec : undefined,
-                }, ctx);
-                if (!out.ok)
-                    return wrap("search_stock", out);
-                const url = out.output.assets[0]?.url;
-                if (!url)
-                    return {
-                        ok: false,
-                        error: { code: "NO_STOCK_RESULTS", message: `No stock results for: ${scene.prompt}` },
-                    };
-                return { ok: true, output: { tool: "search_stock", visualUrl: url } };
-            }
-            case "ai-image-static":
-            case "ai-image-motion": {
-                const out = await this.runTool("generate_image", { prompt: scene.prompt, modelKey: scene.preferredModel ?? "fal-flux-1.1-pro" }, ctx);
-                if (!out.ok)
-                    return wrap("generate_image", out);
-                return { ok: true, output: { tool: "generate_image", visualUrl: out.output.imageUrl } };
-            }
-            case "ai-image-to-video": {
-                const img = await this.runTool("generate_image", { prompt: scene.prompt }, { ...ctx, idempotencyKey: `${ctx.idempotencyKey}:img` });
-                if (!img.ok)
-                    return wrap("generate_image", img);
-                const animate = await this.runTool("animate_image", {
-                    imageUrl: img.output.imageUrl,
-                    motionHint: scene.prompt,
-                    durationSec,
-                    modelKey: scene.preferredModel,
-                }, ctx);
-                if (!animate.ok)
-                    return wrap("animate_image", animate);
-                return {
-                    ok: true,
-                    output: { tool: "animate_image", pendingTaskId: animate.output.taskId },
-                };
-            }
-            case "ai-text-to-video": {
-                const out = await this.runTool("generate_video", {
-                    prompt: scene.prompt,
-                    modelKey: scene.preferredModel ?? "kling-v2.6",
-                    durationSec,
-                }, ctx);
-                if (!out.ok)
-                    return wrap("generate_video", out);
-                return { ok: true, output: { tool: "generate_video", pendingTaskId: out.output.taskId } };
-            }
-            case "user-asset": {
-                // Per-user library search. The host injects the searcher at boot
-                // (see userLibrarySearcher bootstrap); if no match, fall back to
-                // stock so the scene still renders rather than failing hard.
-                const out = await this.runTool("search_user_library", { query: scene.prompt, limit: 5 }, ctx);
-                if (out.ok) {
-                    const first = out.output.assets[0];
-                    if (first) {
-                        return { ok: true, output: { tool: "search_user_library", visualUrl: first.url } };
-                    }
-                }
-                // No hits or searcher missing — fall back to stock-video as the
-                // closest cheap substitute so the executor still produces an asset.
-                const stock = await this.runTool("search_stock", {
-                    query: scene.prompt,
-                    kind: "video",
-                    aspectRatio: aspect,
-                    minDurationSec: durationSec,
-                }, ctx);
-                if (!stock.ok)
-                    return wrap("search_stock", stock);
-                const fallbackUrl = stock.output.assets[0]?.url;
-                if (!fallbackUrl) {
-                    return {
-                        ok: false,
-                        error: {
-                            code: "USER_ASSET_NO_MATCH",
-                            message: `No user-library match for "${scene.prompt}" and no stock fallback.`,
-                        },
-                    };
-                }
-                return { ok: true, output: { tool: "search_user_library", visualUrl: fallbackUrl } };
-            }
-            case "talking-head-avatar": {
-                if (!scene.avatarFaceUrl) {
-                    return {
-                        ok: false,
-                        error: {
-                            code: "AVATAR_FACE_REQUIRED",
-                            message: "talking-head-avatar requires scene.avatarFaceUrl (set on the user's brand kit).",
-                        },
-                    };
-                }
-                if (!scene.voiceoverLine) {
-                    return {
-                        ok: false,
-                        error: {
-                            code: "AVATAR_VO_REQUIRED",
-                            message: "talking-head-avatar requires scene.voiceoverLine for the lipsync audio.",
-                        },
-                    };
-                }
-                const out = await this.runTool("generate_avatar_video", {
-                    inputImageUrl: scene.avatarFaceUrl,
-                    ttsText: scene.voiceoverLine,
-                    mode: scene.tier === "T3" ? "pro" : "std",
-                }, ctx);
-                if (!out.ok)
-                    return wrap("generate_avatar_video", out);
-                return {
-                    ok: true,
-                    output: { tool: "generate_avatar_video", pendingTaskId: out.output.taskId },
-                };
-            }
-        }
-    }
-}
-exports.Executor = Executor;

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

@@ -1,15 +0,0 @@
-export * from "./toolRegistry";
-export * from "./tools";
-export * from "./modelRouter";
-export * from "./llmCaller";
-export * from "./llmCallerGateway";
-export * from "./personas";
-export * from "./llmCallerRegistry";
-export * from "./costPreflight";
-export * from "./planner";
-export * from "./beatSnap";
-export * from "./musicSelect";
-export * from "./executor";
-export * from "./critic";
-export * from "./eval";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/agent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/lib/services/agent/index.js

@@ -1,30 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./toolRegistry"), exports);
-__exportStar(require("./tools"), exports);
-__exportStar(require("./modelRouter"), exports);
-__exportStar(require("./llmCaller"), exports);
-__exportStar(require("./llmCallerGateway"), exports);
-__exportStar(require("./personas"), exports);
-__exportStar(require("./llmCallerRegistry"), exports);
-__exportStar(require("./costPreflight"), exports);
-__exportStar(require("./planner"), exports);
-__exportStar(require("./beatSnap"), exports);
-__exportStar(require("./musicSelect"), exports);
-__exportStar(require("./executor"), exports);
-__exportStar(require("./critic"), exports);
-__exportStar(require("./eval"), exports);

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

@@ -1,77 +0,0 @@
-import { z } from "zod";
-import { ModelChoice } from "./modelRouter";
-/**
- * Provider-agnostic LLM caller. The host (Express server / Firebase Functions)
- * wires a concrete implementation backed by Vercel AI Gateway, OpenRouter, or
- * direct SDKs. Agent code only ever sees this interface, which keeps it
- * portable and lets us A/B-test models against the eval set without code changes.
- */
-export interface LlmCaller {
-    /** Free-form chat completion. */
-    chat(req: ChatRequest): Promise<ChatResponse>;
-    /** Structured-output completion: result is validated against the provided Zod schema. */
-    structured<T extends z.ZodTypeAny>(req: StructuredRequest<T>): Promise<StructuredResponse<T>>;
-    /**
-     * Streaming structured completion. Returns an async iterable of raw text
-     * chunks AND a final promise that resolves to the validated structured
-     * response. Callers typically forward the chunks to a UI channel (SSE)
-     * for token-by-token rendering and await `result` for the parsed payload.
-     *
-     * Implementations that don't natively support streaming may fall back to
-     * a single chunk emission of the full text — the contract is unchanged.
-     */
-    structuredStream?<T extends z.ZodTypeAny>(req: StructuredRequest<T>): {
-        tokens: AsyncIterable<string>;
-        result: Promise<StructuredResponse<T>>;
-    };
-}
-export interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-    /** Optional inline images for vision-capable models. */
-    imageUrls?: string[];
-}
-export interface ChatRequest {
-    model: ModelChoice;
-    messages: ChatMessage[];
-    temperature?: number;
-    maxTokens?: number;
-    /** Stop sequences. */
-    stop?: string[];
-}
-export interface ChatResponse {
-    text: string;
-    /** Token counts when reported by the provider. */
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-    /** Provider request id, for tracing/replay. */
-    requestId?: string;
-}
-export interface StructuredRequest<T extends z.ZodTypeAny> {
-    model: ModelChoice;
-    messages: ChatMessage[];
-    schema: T;
-    /** Human-readable schema name shown to the model in the prompt. */
-    schemaName: string;
-    temperature?: number;
-    maxTokens?: number;
-}
-export interface StructuredResponse<T extends z.ZodTypeAny> {
-    data: z.infer<T>;
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-    requestId?: string;
-}
-/**
- * Stub LlmCaller for tests and offline development. Throws if anyone calls it
- * without the host having injected a real implementation.
- */
-export declare class UnconfiguredLlmCaller implements LlmCaller {
-    chat(): Promise<ChatResponse>;
-    structured<T extends z.ZodTypeAny>(): Promise<StructuredResponse<T>>;
-}
-//# sourceMappingURL=llmCaller.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"llmCaller.d.ts","sourceRoot":"","sources":["../../../src/services/agent/llmCaller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9C,yFAAyF;IACzF,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC/B,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAElC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACtC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACxB;QACD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU;IACvD,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC;IACV,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU;IACxD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IACrD,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAK7B,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAKrE"}

package/lib/services/agent/llmCaller.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnconfiguredLlmCaller = void 0;
-/**
- * Stub LlmCaller for tests and offline development. Throws if anyone calls it
- * without the host having injected a real implementation.
- */
-class UnconfiguredLlmCaller {
-    chat() {
-        throw new Error("LlmCaller not configured. Inject a concrete implementation at host boot.");
-    }
-    structured() {
-        throw new Error("LlmCaller not configured. Inject a concrete implementation at host boot.");
-    }
-}
-exports.UnconfiguredLlmCaller = UnconfiguredLlmCaller;