vidspotai-shared 1.0.68 → 1.0.69-dev.0

package/lib/services/audioAnalysis/onsetDetection.service.js

@@ -0,0 +1,140 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectOnsets = detectOnsets;
+const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("../../utils/logger");
+let decodePromise;
+async function loadDecode() {
+    if (!decodePromise) {
+        decodePromise = Promise.resolve().then(() => __importStar(require("audio-decode"))).then((m) => (m.default ?? m));
+    }
+    return decodePromise;
+}
+const TIMEOUT_MS = 12000;
+const MAX_DOWNLOAD_BYTES = 30 * 1024 * 1024; // 30MB cap; longer tracks are rare and bloat memory.
+const cache = new Map();
+let essentiaPromise;
+function isEnabled() {
+    return process.env.ENABLE_ONSET_DETECTION === "true";
+}
+async function loadEssentia() {
+    if (essentiaPromise)
+        return essentiaPromise;
+    essentiaPromise = (async () => {
+        // Dynamic require — keeps the WASM module out of the cold-start path
+        // for callers that never invoke onset detection (the default until
+        // the commercial license is in place).
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require("essentia.js");
+        const wasm = mod.EssentiaWASM;
+        const inst = new mod.Essentia(wasm);
+        return inst;
+    })();
+    return essentiaPromise;
+}
+async function downloadAudio(url) {
+    const res = await axios_1.default.get(url, {
+        responseType: "arraybuffer",
+        timeout: 8000,
+        maxContentLength: MAX_DOWNLOAD_BYTES,
+    });
+    return Buffer.from(res.data);
+}
+function mixToMono(channels) {
+    if (channels.length === 1)
+        return channels[0];
+    const len = channels[0].length;
+    const out = new Float32Array(len);
+    for (let i = 0; i < len; i++) {
+        let sum = 0;
+        for (const ch of channels)
+            sum += ch[i];
+        out[i] = sum / channels.length;
+    }
+    return out;
+}
+async function runDetection(audioUrl) {
+    const buf = await downloadAudio(audioUrl);
+    const decode = await loadDecode();
+    const decoded = await decode(buf);
+    const mono = mixToMono(decoded.channelData);
+    const essentia = (await loadEssentia());
+    const signal = essentia.arrayToVector(mono);
+    const result = essentia.RhythmExtractor2013(signal);
+    const beats = [];
+    const beatVec = result.beats_position;
+    for (let i = 0; i < beatVec.size(); i++)
+        beats.push(beatVec.get(i));
+    if (!beats.length || !result.bpm)
+        return undefined;
+    return { bpm: Math.round(result.bpm), onsets: beats };
+}
+function withTimeout(p, ms) {
+    return new Promise((resolve) => {
+        const t = setTimeout(() => resolve(undefined), ms);
+        p.then((v) => {
+            clearTimeout(t);
+            resolve(v);
+        }, (err) => {
+            clearTimeout(t);
+            logger_1.logger.warn("onsetDetection: withTimeout rejected", {
+                err: err?.stack ?? err?.message ?? String(err),
+            });
+            resolve(undefined);
+        });
+    });
+}
+async function detectOnsets(audioUrl) {
+    if (!isEnabled())
+        return undefined;
+    const hit = cache.get(audioUrl);
+    if (hit)
+        return hit;
+    const analysis = await withTimeout(runDetection(audioUrl), TIMEOUT_MS);
+    if (analysis) {
+        cache.set(audioUrl, analysis);
+        if (cache.size > 100) {
+            // Drop oldest entry to bound memory; Map preserves insertion order.
+            const firstKey = cache.keys().next().value;
+            if (firstKey)
+                cache.delete(firstKey);
+        }
+    }
+    return analysis;
+}

package/lib/services/bullmq.service.d.ts

@@ -22,7 +22,12 @@ declare class BullMQService {
         jobId?: string;
         delay?: number;
     }): Promise<void>;
-    startWorkers(queueNames: string[], processor: (job: Job) => Promise<void>): void;
+    startWorkers(queueNames: string[], processor: (job: Job) => Promise<void>, perQueueOptions?: Record<string, {
+        lockDuration?: number;
+        stalledInterval?: number;
+        maxStalledCount?: number;
+        concurrency?: number;
+    }>): void;
 }
 export declare const bullmq: BullMQService;
 export type BullMQJob = Job;

package/lib/services/bullmq.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bullmq.service.d.ts","sourceRoot":"","sources":["../../src/services/bullmq.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE1C,UAAU,oBAAoB;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO;WAQO,WAAW,CAAC,OAAO,EAAE,oBAAoB;IAOvD,sDAAsD;IACzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBlC,gBAAgB;IACH,MAAM,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUpC,YAAY,CACjB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;CAmDzC;AAWD,eAAO,MAAM,MAAM,eAGjB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC"}
+{"version":3,"file":"bullmq.service.d.ts","sourceRoot":"","sources":["../../src/services/bullmq.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE1C,UAAU,oBAAoB;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO;WAQO,WAAW,CAAC,OAAO,EAAE,oBAAoB;IAOvD,sDAAsD;IACzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBlC,gBAAgB;IACH,MAAM,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUpC,YAAY,CACjB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,eAAe,CAAC,EAAE,MAAM,CACtB,MAAM,EACN;QACE,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CACF;CA+FJ;AASD,eAAO,MAAM,MAAM,eAGjB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC"}

package/lib/services/bullmq.service.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.bullmq = void 0;
 // libs/bullmqService.ts
 const bullmq_1 = require("bullmq");
+const logger_1 = require("../utils/logger");
+const redisOptions_1 = require("./redisOptions");
 class BullMQService {
     constructor({ redisOptions, concurrency = 10, }) {
         this.queues = new Map();
@@ -32,10 +34,12 @@ class BullMQService {
             testQueueClient.ping();
             await testQueue.close();
             this.initialized = true;
-            console.log("✅ BullMQService initialized and connected to Redis");
+            logger_1.logger.info("BullMQService initialized and connected to Redis");
         }
         catch (err) {
-            console.error("❌ BullMQService failed to connect to Redis", err);
+            logger_1.logger.error("BullMQService failed to connect to Redis", {
+                err: err instanceof Error ? err.stack ?? err.message : String(err),
+            });
             throw err;
         }
     }
@@ -48,7 +52,7 @@ class BullMQService {
         this.queues.set(queueName, queue);
         await queue.add(opts?.jobId || "default", data, { delay: opts?.delay });
     }
-    startWorkers(queueNames, processor) {
+    startWorkers(queueNames, processor, perQueueOptions) {
         const start = async () => {
             if (!this.initialized)
                 await this.init();
@@ -56,44 +60,88 @@ class BullMQService {
                 const queue = this.queues.get(queueName) ??
                     new bullmq_1.Queue(queueName, { connection: this.redisOptions });
                 this.queues.set(queueName, queue);
+                const overrides = perQueueOptions?.[queueName] ?? {};
                 const worker = new bullmq_1.Worker(queueName, async (job) => processor(job), {
                     connection: this.redisOptions,
-                    concurrency: this.concurrency,
+                    concurrency: overrides.concurrency ?? this.concurrency,
+                    // N5 (agent refactor Stage 2). Explicit lock semantics:
+                    //   - lockDuration: 60s default. BullMQ auto-renews while the
+                    //     worker is alive; bumped above the 30s default so a slow
+                    //     Firestore write or GC pause can't drop the lock mid-job.
+                    //     Per-queue override required for long CPU-bound jobs
+                    //     (render: Remotion blocks the event loop, lock renewal
+                    //     heartbeat misses, scheduler rescues → duplicate render).
+                    //   - stalledInterval: 30s. How often the scheduler checks for
+                    //     jobs whose lock expired (worker crashed or got SIGKILL'd).
+                    //   - maxStalledCount: 1. A crashed job gets exactly one
+                    //     handoff to a fresh worker; if that one also crashes the
+                    //     job moves to failed instead of looping forever on a
+                    //     poison payload. Agent reruns rely on the providerTaskCache
+                    //     replay (N4) for cheap resume rather than re-submission.
+                    lockDuration: overrides.lockDuration ?? 60000,
+                    stalledInterval: overrides.stalledInterval ?? 30000,
+                    maxStalledCount: overrides.maxStalledCount ?? 1,
+                });
+                worker.on("completed", (job) => logger_1.logger.info(`BullMQ job completed`, {
+                    queueName,
+                    jobId: job.id,
+                }));
+                // Job-level failure (processor threw or exhausted retries). Routes to
+                // Slack via the winston error transport so a stuck provider or a
+                // bad payload always surfaces. Stack tail truncated to keep Slack
+                // payloads under their block-size limits.
+                worker.on("failed", (job, err) => {
+                    logger_1.logger.error(`BullMQ job failed`, {
+                        queueName,
+                        jobId: job?.id,
+                        jobName: job?.name,
+                        userId: job?.data?.userId,
+                        attemptsMade: job?.attemptsMade,
+                        failedReason: job?.failedReason,
+                        err: err?.stack ?? err?.message ?? String(err),
+                    });
+                });
+                // Worker-shell failure (Redis lost, malformed payload, processor
+                // import error, etc.). Without this handler these crashes are silent.
+                worker.on("error", (err) => {
+                    logger_1.logger.error(`BullMQ worker error`, {
+                        queueName,
+                        err: err?.stack ?? err?.message ?? String(err),
+                    });
                 });
-                worker.on("completed", (job) => console.log(`✅ [${queueName}] Job ${job.id} completed`));
-                worker.on("failed", (job, err) => console.error(`❌ [${queueName}] Job ${job?.id} failed:`, err));
                 this.workers.push(worker);
             }
-            console.log(`🚀 Started workers for queues: ${queueNames.join(", ")}`);
+            logger_1.logger.info(`Started workers for queues`, { queueNames });
             // Setup graceful shutdown
             const graceful = async () => {
                 if (this.shuttingDown)
                     return;
                 this.shuttingDown = true;
-                console.log("🛑 Shutting down BullMQ workers gracefully...");
+                logger_1.logger.info("Shutting down BullMQ workers gracefully...");
                 for (const worker of this.workers) {
                     await worker.close();
-                    console.log(`✅ Worker for queue ${worker.name} closed`);
+                    logger_1.logger.info(`Worker for queue closed`, { queueName: worker.name });
                 }
-                console.log("✅ All workers closed. Exiting process.");
+                logger_1.logger.info("All workers closed. Exiting process.");
                 process.exit(0);
             };
             process.on("SIGINT", graceful);
             process.on("SIGTERM", graceful);
         };
         start().catch((err) => {
-            console.error("❌ Failed to start workers:", err);
+            logger_1.logger.error("BullMQ failed to start workers — process exiting", {
+                queueNames,
+                err: err?.stack ?? err?.message ?? String(err),
+            });
             process.exit(1);
         });
     }
 }
 const redisOptions = {
+    ...redisOptions_1.sharedRedisOptions,
     host: process.env.REDIS_HOST,
     port: Number(process.env.REDIS_PORT),
     password: process.env.REDIS_PASSWORD,
-    // username: process.env.REDIS_USERNAME,
-    // tls: {},
-    maxRetriesPerRequest: null, // REQUIRED for BullMQ stability
 };
 exports.bullmq = BullMQService.getInstance({
     redisOptions,

package/lib/services/credit.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credit.service.d.ts","sourceRoot":"","sources":["../../src/services/credit.service.ts"],"names":[],"mappings":"AAGA,qBAAa,aAAa;WACX,cAAc,CACzB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;WAyBH,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;CAoBjB"}
+{"version":3,"file":"credit.service.d.ts","sourceRoot":"","sources":["../../src/services/credit.service.ts"],"names":[],"mappings":"AAaA,qBAAa,aAAa;WACX,cAAc,CACzB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;WAwDH,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;CAoBjB"}

package/lib/services/credit.service.js

@@ -1,29 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreditService = void 0;
+const firestore_1 = require("firebase-admin/firestore");
+const types_1 = require("../globals/types");
 const firebase_1 = require("../libs/firebase");
+const logger_1 = require("../utils/logger");
 const firestore_service_1 = require("./firestore.service");
+const notification_service_1 = require("./notification.service");
+// Once balance drops below this fraction of total, fire CREDITS_LOW. The
+// throttle below stops it from re-firing more often than once per 24h so users
+// who linger near the threshold don't see daily spam.
+const CREDITS_LOW_THRESHOLD = 0.2;
+const CREDITS_LOW_THROTTLE_MS = 24 * 60 * 60 * 1000;
 class CreditService {
     static async consumeCredits(userId, creditsToConsume) {
-        await firebase_1.firestore.runTransaction(async (tx) => {
+        // Capture the post-consume balance so we can fire CREDITS_LOW outside the
+        // transaction (notification writes must not interleave with the credit
+        // mutation — that would risk transaction abort + retry firing duplicate
+        // notifications).
+        const postState = await firebase_1.firestore.runTransaction(async (tx) => {
             const userRef = firestore_service_1.FirestoreService.usersCol.doc(userId);
             const snap = await tx.get(userRef);
             if (!snap.exists) {
                 throw new Error("USER_NOT_FOUND");
             }
-            const credits = snap.data()?.credits;
-            const consumed = credits?.consumed ?? 0;
-            const total = credits?.total ?? 0;
-            // console.log(`Consuming ${creditsToConsume} credits for user ${userId}`);
-            // console.log(`Current credits: ${consumed}/${total}`);
-            // 🔒 HARD INVARIANT
+            const data = snap.data();
+            const consumed = data.credits?.consumed ?? 0;
+            const total = data.credits?.total ?? 0;
             if (consumed + creditsToConsume > total) {
                 throw new Error("INSUFFICIENT_CREDITS");
             }
             tx.update(userRef, {
                 "credits.consumed": consumed + creditsToConsume,
             });
+            const newRemaining = total - (consumed + creditsToConsume);
+            const lastNotifiedMs = data.lastCreditsLowNotifiedAt?.toMillis?.() ?? 0;
+            return { total, newRemaining, lastNotifiedMs };
         });
+        const { total, newRemaining, lastNotifiedMs } = postState;
+        if (total > 0 && newRemaining < total * CREDITS_LOW_THRESHOLD) {
+            const sinceLast = Date.now() - lastNotifiedMs;
+            if (sinceLast > CREDITS_LOW_THROTTLE_MS) {
+                const pct = Math.max(0, Math.round((newRemaining / total) * 100));
+                await notification_service_1.NotificationService.create({
+                    userId,
+                    type: types_1.ENotificationType.CREDITS_LOW,
+                    severity: types_1.ENotificationSeverity.WARNING,
+                    title: "You're running low on credits",
+                    body: `${newRemaining} of ${total} credits remaining (${pct}%). Top up to avoid interrupting jobs.`,
+                    link: "/dashboard/pricing",
+                    data: { remaining: newRemaining, total },
+                });
+                await firestore_service_1.FirestoreService.usersCol.doc(userId).update({
+                    lastCreditsLowNotifiedAt: firestore_1.FieldValue.serverTimestamp(),
+                }).catch((err) => {
+                    logger_1.logger.warn("credit.service: lastCreditsLowNotifiedAt write failed", {
+                        userId,
+                        err: err instanceof Error ? err.stack ?? err.message : String(err),
+                    });
+                    return undefined;
+                });
+            }
+        }
     }
     static async refundCredits(userId, creditsToRefund) {
         if (creditsToRefund <= 0)

package/lib/services/credits/pricing.d.ts

@@ -0,0 +1,58 @@
+import { Clip, Project } from "../../schemas/project.schema";
+import { PlannedScene } from "../../schemas/videoPlan.schema";
+/**
+ * Per-component pricing model for agent regen endpoints (Stage 6).
+ *
+ * Charging granularity matches generation granularity: regen the VO of a
+ * single clip → only VO cost is charged. Regen the visual → only visual.
+ * Music + overlays + captions have their own (mostly free) rates.
+ *
+ * Rates are conservative upper bounds used by the budget guard before a
+ * regen is dispatched. The *actual* spend is reconciled from provider
+ * receipts inside the executor and written back to `clip.provenance.creditsSpent`.
+ */
+export declare const CREDITS_PER_USD = 100;
+export declare const BUDGET_GUARD_THRESHOLD_USD = 0.5;
+export type RegenComponent = "visual" | "voiceover" | "music" | "overlays" | "captions";
+export interface RegenCostEstimate {
+    component: RegenComponent;
+    amountUsd: number;
+    amountCredits: number;
+    breakdown: Record<string, number>;
+    exceedsBudgetGuard: boolean;
+    budgetGuardThresholdUsd: number;
+}
+/**
+ * Estimate the cost of regenerating one component of a clip / scene.
+ * Pass either a `clip` (existing Project clip) or a `scene` (PlannedScene)
+ * — both expose tier + duration, just from different sources.
+ */
+export declare function estimateRegenCost(args: {
+    component: RegenComponent;
+    clip?: Clip;
+    scene?: PlannedScene;
+    /** For voiceover regens: the new VO line text (used to count chars). */
+    voiceoverLine?: string;
+    /** When the VO line text changes, captions must also be re-cut. */
+    captionsAlsoChange?: boolean;
+}): RegenCostEstimate;
+/** History entry appended to `project.metadata.history[]` on each regen. */
+export interface RegenHistoryEntry {
+    ts: string;
+    action: "regenerate";
+    component: RegenComponent;
+    clipId?: string;
+    sceneIndex?: number;
+    modelKey?: string;
+    estimatedCreditsSpent: number;
+    estimatedUsd: number;
+    actualCreditsSpent?: number;
+}
+/**
+ * Append a regen entry to `project.metadata.history[]`, returning the
+ * mutated project. Caller persists. Caps history at the most recent 200
+ * entries to keep the Firestore doc well under the 1 MiB limit (see
+ * Risk #2 in notes/AGENT_EDITOR_ROUND_TRIP.md).
+ */
+export declare function appendRegenHistory(project: Project, entry: RegenHistoryEntry): Project;
+//# sourceMappingURL=pricing.d.ts.map

package/lib/services/credits/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/services/credits/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAQ,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,eAAe,MAAM,CAAC;AAGnC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,OAAO,GACP,UAAU,GACV,UAAU,CAAC;AAqBf,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GAAG,iBAAiB,CA6BpB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAUT"}

package/lib/services/credits/pricing.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUDGET_GUARD_THRESHOLD_USD = exports.CREDITS_PER_USD = void 0;
+exports.estimateRegenCost = estimateRegenCost;
+exports.appendRegenHistory = appendRegenHistory;
+/**
+ * Per-component pricing model for agent regen endpoints (Stage 6).
+ *
+ * Charging granularity matches generation granularity: regen the VO of a
+ * single clip → only VO cost is charged. Regen the visual → only visual.
+ * Music + overlays + captions have their own (mostly free) rates.
+ *
+ * Rates are conservative upper bounds used by the budget guard before a
+ * regen is dispatched. The *actual* spend is reconciled from provider
+ * receipts inside the executor and written back to `clip.provenance.creditsSpent`.
+ */
+// VidSpot convention: 1 credit ≈ $0.01 USD. The product surface (Stripe
+// plans, dashboard chips) all speak credits; the budget guard speaks USD
+// because the spec threshold ($0.50) is product-facing.
+exports.CREDITS_PER_USD = 100;
+// $0.50 user-confirmation threshold per Decision 4 (notes/AGENT_EDITOR_ROUND_TRIP.md §12).
+exports.BUDGET_GUARD_THRESHOLD_USD = 0.5;
+// Per-second visual cost by tier (USD). Coarse upper bounds — the executor
+// reconciles to the provider's true charge after the fact.
+const TIER_PER_SECOND_USD = {
+    T0: 0.005, // stock (per-call cost amortised over duration)
+    T1: 0.1, // image-to-video
+    T2: 0.03, // image-gen still
+    T3: 0.8, // premium text-to-video
+};
+// ElevenLabs creator-tier ballpark. Real rate varies by plan; conservative bound.
+const ELEVENLABS_USD_PER_1K_CHARS = 0.18;
+// Tiny GPT-4o-mini call to rewrite an overlay line.
+const OVERLAY_LLM_USD_PER_CALL = 0.005;
+// Local Whisper, Jamendo: free at the moment.
+const CAPTION_USD_PER_MINUTE = 0;
+const MUSIC_SEARCH_USD = 0;
+const clipDurationMs = (c) => Math.max(0, c.display.to - c.display.from);
+const sceneDurationMs = (s) => s.durationMs;
+function visualUsd(args) {
+    if (!args.tier)
+        return 0;
+    return (args.durationMs / 1000) * TIER_PER_SECOND_USD[args.tier];
+}
+function voiceoverUsd(charCount) {
+    return (charCount / 1000) * ELEVENLABS_USD_PER_1K_CHARS;
+}
+function captionsUsd(durationMs) {
+    return (durationMs / 60000) * CAPTION_USD_PER_MINUTE;
+}
+function toEstimate(component, breakdown) {
+    const amountUsd = Object.values(breakdown).reduce((s, v) => s + v, 0);
+    return {
+        component,
+        amountUsd,
+        amountCredits: Math.ceil(amountUsd * exports.CREDITS_PER_USD),
+        breakdown,
+        exceedsBudgetGuard: amountUsd > exports.BUDGET_GUARD_THRESHOLD_USD,
+        budgetGuardThresholdUsd: exports.BUDGET_GUARD_THRESHOLD_USD,
+    };
+}
+/**
+ * Estimate the cost of regenerating one component of a clip / scene.
+ * Pass either a `clip` (existing Project clip) or a `scene` (PlannedScene)
+ * — both expose tier + duration, just from different sources.
+ */
+function estimateRegenCost(args) {
+    const { component } = args;
+    const tier = args.clip?.provenance?.tier ?? args.scene?.tier;
+    const durationMs = (args.clip ? clipDurationMs(args.clip) : undefined) ??
+        (args.scene ? sceneDurationMs(args.scene) : 0);
+    switch (component) {
+        case "visual":
+            return toEstimate("visual", {
+                visual: visualUsd({ tier, durationMs }),
+            });
+        case "voiceover": {
+            const chars = args.voiceoverLine?.length ?? 0;
+            const breakdown = {
+                voiceover: voiceoverUsd(chars),
+            };
+            if (args.captionsAlsoChange) {
+                breakdown.captions = captionsUsd(durationMs);
+            }
+            return toEstimate("voiceover", breakdown);
+        }
+        case "music":
+            return toEstimate("music", { music: MUSIC_SEARCH_USD });
+        case "overlays":
+            return toEstimate("overlays", { overlays: OVERLAY_LLM_USD_PER_CALL });
+        case "captions":
+            return toEstimate("captions", { captions: captionsUsd(durationMs) });
+    }
+}
+/**
+ * Append a regen entry to `project.metadata.history[]`, returning the
+ * mutated project. Caller persists. Caps history at the most recent 200
+ * entries to keep the Firestore doc well under the 1 MiB limit (see
+ * Risk #2 in notes/AGENT_EDITOR_ROUND_TRIP.md).
+ */
+function appendRegenHistory(project, entry) {
+    const meta = (project.metadata ?? {});
+    const existing = Array.isArray(meta.history)
+        ? meta.history
+        : [];
+    const next = [...existing, entry].slice(-200);
+    return {
+        ...project,
+        metadata: { ...meta, history: next },
+    };
+}

package/lib/services/editor/designToProject.d.ts

@@ -0,0 +1,75 @@
+import type { Project } from "../../schemas/project.schema";
+/**
+ * Inverse of `projectToDesign`. Converts the editor's IDesign-shaped
+ * autosave blob into the canonical Project JSON the Remotion renderer
+ * consumes.
+ *
+ * The shared package can't import `@designcombo/types` (editor-only),
+ * so the input shape is declared inline as a permissive interface — we
+ * read what we need and ignore unknown fields. Producers (the editor's
+ * autosave hook) are not formally validated here; the resulting Project
+ * is validated by `ProjectSchema.parse()` downstream.
+ *
+ * Round-trip contract: designToProject(projectToDesign(p)) deeply
+ * equals p (covered by tests in this package). To preserve fields the
+ * editor's IDesign can't represent natively (provenance, locked, clip
+ * motion, ducking, caption words), the translator pair stashes them
+ * inside `metadata.*` on the design item; designToProject pulls them
+ * back here.
+ */
+interface DesignTrack {
+    id: string;
+    type: string;
+    items?: string[];
+    index?: number;
+}
+interface DesignItemBase {
+    id: string;
+    name?: string;
+    type: string;
+    display?: {
+        from?: number;
+        to?: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+interface DesignItemDetails extends DesignItemBase {
+    details?: Record<string, unknown>;
+}
+interface DesignBackground {
+    type?: "color" | "image" | "transparent";
+    value?: string;
+}
+interface DesignTransition {
+    id?: string;
+    fromId?: string;
+    toId?: string;
+    kind?: string;
+    duration?: number;
+}
+export interface EditorDesignInput {
+    id?: string;
+    fps?: number;
+    size?: {
+        width?: number;
+        height?: number;
+    };
+    duration?: number;
+    background?: DesignBackground;
+    tracks?: DesignTrack[];
+    trackItemIds?: string[];
+    trackItemsMap?: Record<string, DesignItemBase>;
+    trackItemDetailsMap?: Record<string, DesignItemDetails>;
+    transitionIds?: string[];
+    transitionsMap?: Record<string, DesignTransition>;
+    /** Server-write-zone field: editor passes it back as-is on autosave. */
+    agentRunId?: string;
+}
+export declare function designToProject(design: unknown, meta: {
+    id: string;
+    name: string;
+    createdAt?: string;
+    updatedAt?: string;
+}): Project;
+export {};
+//# sourceMappingURL=designToProject.d.ts.map

package/lib/services/editor/designToProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designToProject.d.ts","sourceRoot":"","sources":["../../../src/services/editor/designToProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EAIR,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;;;;;;;;;GAiBG;AAEH,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,iBAAkB,SAAQ,cAAc;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAClD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+BD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CA4FT"}