vidspotai-shared 1.0.53 → 1.0.54

package/lib/globals/aiModels/providers/alibaba.d.ts

@@ -0,0 +1,4 @@
+import { TAiGenModel } from "../enums";
+import { IModelSchema } from "../types";
+export declare const alibabaConfigs: Partial<Record<TAiGenModel, IModelSchema>>;
+//# sourceMappingURL=alibaba.d.ts.map

package/lib/globals/aiModels/providers/alibaba.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alibaba.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/alibaba.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAaxC,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAiLrE,CAAC"}

package/lib/globals/aiModels/providers/alibaba.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.alibabaConfigs = void 0;
+const wanCommonFields = {
+    prompt: { required: true },
+    aspectRatio: { allowedValues: ["16:9", "9:16", "1:1", "4:3", "3:4"] },
+    resolution: { allowedValues: ["480p", "720p", "1080p"] },
+    duration: { allowedValues: [5, 10] },
+    negative_prompt: {},
+    seed: {},
+    watermark: {},
+    promptOptimizer: {},
+};
+exports.alibabaConfigs = {
+    // --- Wan 2.7 i2v --- (image2video; supports first-last-frame interpolation)
+    "alibaba-wan-2.7-i2v": {
+        modelId: "wan2.7-i2v-plus",
+        type: ["image-to-video"],
+        tier: "T3",
+        fields: {
+            ...wanCommonFields,
+            inputImageUrl: { required: true },
+            lastFrameImageUrl: {}, // FLF interpolation
+        },
+        cost: {
+            table: {
+                "832x480": { 5: 0.10, 10: 0.20 },
+                "1280x720": { 5: 0.20, 10: 0.40 },
+                "1920x1080": { 5: 0.40, 10: 0.80 },
+            },
+        },
+    },
+    // --- Wan 2.6 t2v ---
+    "alibaba-wan-2.6-t2v": {
+        modelId: "wan2.6-t2v-plus",
+        type: ["text-to-video"],
+        tier: "T3",
+        fields: { ...wanCommonFields },
+        cost: {
+            table: {
+                "832x480": { 5: 0.08, 10: 0.16 },
+                "1280x720": { 5: 0.18, 10: 0.36 },
+                "1920x1080": { 5: 0.36, 10: 0.72 },
+            },
+        },
+    },
+    // --- Wan 2.5 t2v ---
+    "alibaba-wan-2.5-t2v": {
+        modelId: "wan2.5-t2v-plus",
+        type: ["text-to-video"],
+        tier: "T2",
+        fields: { ...wanCommonFields },
+        cost: {
+            table: {
+                "832x480": { 5: 0.06, 10: 0.12 },
+                "1280x720": { 5: 0.14, 10: 0.28 },
+                "1920x1080": { 5: 0.28, 10: 0.56 },
+            },
+        },
+    },
+    // --- Wan 2.2 t2v ---
+    "alibaba-wan-2.2-t2v": {
+        modelId: "wan2.2-t2v-plus",
+        type: ["text-to-video"],
+        tier: "T2",
+        fields: { ...wanCommonFields },
+        cost: {
+            table: {
+                "832x480": { 5: 0.05, 10: 0.10 },
+                "1280x720": { 5: 0.10, 10: 0.20 },
+                "1920x1080": { 5: 0.20, 10: 0.40 },
+            },
+        },
+    },
+    // --- Wan 2.2 s2v --- (sound2video; audio drives motion, optional image for visual reference)
+    "alibaba-wan-2.2-s2v": {
+        modelId: "wan2.2-s2v",
+        type: ["audio-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: {},
+            inputAudioUrl: { required: true },
+            inputImageUrl: {}, // optional visual reference
+            duration: { allowedValues: [5, 10] },
+            seed: {},
+            watermark: {},
+        },
+        cost: {
+            table: {
+                // Pricing varies less by size for s2v; use a flat-ish table keyed on duration.
+                "auto": { 5: 0.18, 10: 0.36 },
+            },
+        },
+    },
+    // ───────────────────────────────────────────────────────────────────────
+    // Image-gen — Qwen-Image + Kolors (both via DashScope text2image / image2image)
+    // ───────────────────────────────────────────────────────────────────────
+    "alibaba-qwen-image-2.0-pro": {
+        modelId: "qwen-image-2.0-pro",
+        type: ["text-to-image"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["1:1", "9:16", "16:9", "3:4", "4:3", "2:3", "3:2"] },
+            numImages: { default: 1 },
+            seed: {},
+            watermark: {},
+            promptOptimizer: {},
+            negativePrompt: {},
+        },
+        cost: { fixed: 0.04 },
+    },
+    "alibaba-qwen-image-2.0": {
+        modelId: "qwen-image-2.0",
+        type: ["text-to-image"],
+        tier: "T1",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["1:1", "9:16", "16:9", "3:4", "4:3", "2:3", "3:2"] },
+            numImages: { default: 1 },
+            seed: {},
+            watermark: {},
+            promptOptimizer: {},
+            negativePrompt: {},
+        },
+        cost: { fixed: 0.02 },
+    },
+    // Qwen-Image edit — instruction edit (1–3 reference images)
+    "alibaba-qwen-image-edit-max": {
+        modelId: "qwen-image-edit-max",
+        type: ["image-to-image"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            inputImageUrls: { required: true },
+            seed: {},
+            watermark: {},
+            promptOptimizer: {},
+        },
+        cost: { fixed: 0.05 },
+    },
+    "alibaba-qwen-image-edit-plus": {
+        modelId: "qwen-image-edit-plus",
+        type: ["image-to-image"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            inputImageUrls: { required: true },
+            seed: {},
+            watermark: {},
+            promptOptimizer: {},
+        },
+        cost: { fixed: 0.04 },
+    },
+    "alibaba-qwen-image-edit": {
+        modelId: "qwen-image-edit",
+        type: ["image-to-image"],
+        tier: "T1",
+        fields: {
+            prompt: { required: true },
+            inputImageUrls: { required: true },
+            seed: {},
+            watermark: {},
+            promptOptimizer: {},
+        },
+        cost: { fixed: 0.03 },
+    },
+    // Kolors (Kling) — hosted on DashScope; routed to AlibabaService in factory.
+    "kling-kolors": {
+        modelId: "kolors-v2",
+        type: ["text-to-image"],
+        tier: "T1",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["1:1", "9:16", "16:9", "3:4", "4:3"] },
+            numImages: { default: 1 },
+            seed: {},
+            watermark: {},
+            negativePrompt: {},
+        },
+        cost: { fixed: 0.03 },
+    },
+};

package/lib/globals/aiModels/providers/elevenlabs.d.ts

@@ -0,0 +1,13 @@
+import { IModelSchema } from "../types";
+/**
+ * ElevenLabs sound-effects model configs. Sync — POST /v1/sound-generation
+ * returns mp3 binary inline.
+ *
+ * Pricing: ElevenLabs charges ~40 character-credits per second of generated
+ * audio on Creator/Pro tiers (~$0.0036/sec ≈ $0.08 for the 22s max clip).
+ * Cost block exposes both `perSecond` (preferred when caller knows duration)
+ * and `fixed` (worst-case ceiling, used when duration is absent).
+ * Verified 2026-05-11 against ElevenLabs Creator-tier credit conversion.
+ */
+export declare const elevenlabsConfigs: Record<string, IModelSchema>;
+//# sourceMappingURL=elevenlabs.d.ts.map

package/lib/globals/aiModels/providers/elevenlabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/elevenlabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAW1D,CAAC"}

package/lib/globals/aiModels/providers/elevenlabs.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.elevenlabsConfigs = void 0;
+/**
+ * ElevenLabs sound-effects model configs. Sync — POST /v1/sound-generation
+ * returns mp3 binary inline.
+ *
+ * Pricing: ElevenLabs charges ~40 character-credits per second of generated
+ * audio on Creator/Pro tiers (~$0.0036/sec ≈ $0.08 for the 22s max clip).
+ * Cost block exposes both `perSecond` (preferred when caller knows duration)
+ * and `fixed` (worst-case ceiling, used when duration is absent).
+ * Verified 2026-05-11 against ElevenLabs Creator-tier credit conversion.
+ */
+exports.elevenlabsConfigs = {
+    "elevenlabs-sound-effects": {
+        modelId: "eleven_text_to_sound_v2",
+        type: ["sound-effects"],
+        tier: "T1",
+        fields: {
+            prompt: { required: true },
+            // ElevenLabs SFX duration range: 0.5–22 seconds
+        },
+        cost: { perSecond: 0.0036, fixed: 0.08 },
+    },
+};

package/lib/globals/aiModels/providers/pixverseTemplates.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pixverse Effects / Template registry.
+ *
+ * Pixverse exposes a curated library of "Effects" templates (Hug, Kiss, Squish,
+ * AI Baby Podcast, etc.) accessible via POST /openapi/v2/video/template/generate
+ * with a numeric `template_id` plus a `customer_img_url`. Most templates are
+ * image-to-video — the user supplies a face/photo and the template animates it.
+ *
+ * Real IDs must be pulled from the Pixverse dashboard / template library API
+ * (each template's ID is the numeric `template_id` shown in the docs UI).
+ * The few entries below are placeholders documenting the shape — populate
+ * with real IDs before exposing in the frontend.
+ */
+export interface IPixverseEffectTemplate {
+    /** Numeric Pixverse template_id (sent to /template/generate). */
+    templateId: number;
+    /** Slug used in the API surface (kebab-case, stable). */
+    slug: string;
+    /** Display label shown to users. */
+    name: string;
+    /** Coarse grouping for the picker UI. */
+    category: "couple" | "transform" | "stylize" | "podcast" | "selfie" | "anime" | "other";
+    /** Whether the template requires a user-supplied image (almost always true). */
+    requiresImage: boolean;
+    /** Optional default Pixverse model to pair with this template. */
+    preferredModelId?: "v5" | "v5.5" | "v5.6";
+}
+/**
+ * Curated list — POPULATE WITH REAL PIXVERSE TEMPLATE IDs from the dashboard.
+ * Slugs are stable; templateIds are placeholder zeros until filled in.
+ */
+export declare const PIXVERSE_EFFECT_TEMPLATES: IPixverseEffectTemplate[];
+export declare const PIXVERSE_TEMPLATES_BY_SLUG: Record<string, IPixverseEffectTemplate>;
+export declare function getPixverseTemplateBySlug(slug: string): IPixverseEffectTemplate | undefined;
+export declare function listPixverseTemplates(category?: IPixverseEffectTemplate["category"]): IPixverseEffectTemplate[];
+//# sourceMappingURL=pixverseTemplates.d.ts.map

package/lib/globals/aiModels/providers/pixverseTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixverseTemplates.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/pixverseTemplates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EACJ,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,CAAC;IACZ,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAAuB,EAY9D,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CACR,CAAC;AAExE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAE3F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,GAAG,uBAAuB,EAAE,CAG/G"}

package/lib/globals/aiModels/providers/pixverseTemplates.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Pixverse Effects / Template registry.
+ *
+ * Pixverse exposes a curated library of "Effects" templates (Hug, Kiss, Squish,
+ * AI Baby Podcast, etc.) accessible via POST /openapi/v2/video/template/generate
+ * with a numeric `template_id` plus a `customer_img_url`. Most templates are
+ * image-to-video — the user supplies a face/photo and the template animates it.
+ *
+ * Real IDs must be pulled from the Pixverse dashboard / template library API
+ * (each template's ID is the numeric `template_id` shown in the docs UI).
+ * The few entries below are placeholders documenting the shape — populate
+ * with real IDs before exposing in the frontend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PIXVERSE_TEMPLATES_BY_SLUG = exports.PIXVERSE_EFFECT_TEMPLATES = void 0;
+exports.getPixverseTemplateBySlug = getPixverseTemplateBySlug;
+exports.listPixverseTemplates = listPixverseTemplates;
+/**
+ * Curated list — POPULATE WITH REAL PIXVERSE TEMPLATE IDs from the dashboard.
+ * Slugs are stable; templateIds are placeholder zeros until filled in.
+ */
+exports.PIXVERSE_EFFECT_TEMPLATES = [
+    // --- Couple / interaction effects ---
+    { templateId: 0, slug: "hug", name: "Hug", category: "couple", requiresImage: true, preferredModelId: "v5.6" },
+    { templateId: 0, slug: "kiss", name: "Kiss", category: "couple", requiresImage: true, preferredModelId: "v5.6" },
+    { templateId: 0, slug: "squish", name: "Squish", category: "transform", requiresImage: true, preferredModelId: "v5.6" },
+    // --- Podcast / narration effects ---
+    { templateId: 0, slug: "ai-baby-podcast", name: "AI Baby Podcast", category: "podcast", requiresImage: true, preferredModelId: "v5.6" },
+    // --- Stylize / transform ---
+    { templateId: 0, slug: "anime-me", name: "Anime Me", category: "anime", requiresImage: true, preferredModelId: "v5.5" },
+    { templateId: 0, slug: "muscle", name: "Muscle Up", category: "transform", requiresImage: true, preferredModelId: "v5.6" },
+];
+exports.PIXVERSE_TEMPLATES_BY_SLUG = Object.fromEntries(exports.PIXVERSE_EFFECT_TEMPLATES.map((t) => [t.slug, t]));
+function getPixverseTemplateBySlug(slug) {
+    return exports.PIXVERSE_TEMPLATES_BY_SLUG[slug];
+}
+function listPixverseTemplates(category) {
+    if (!category)
+        return exports.PIXVERSE_EFFECT_TEMPLATES;
+    return exports.PIXVERSE_EFFECT_TEMPLATES.filter((t) => t.category === category);
+}

package/lib/globals/aiModels/tierHelpers.d.ts

@@ -0,0 +1,27 @@
+import type { Tier } from "../../schemas/project.schema";
+import type { GenerationType, IModelSchema } from "./types";
+/**
+ * Helpers for the agent planner to query models by tier and capability.
+ * Designed to be cheap and side-effect free — safe to call inside hot planner loops.
+ */
+export interface ModelMatch {
+    modelKey: string;
+    config: IModelSchema;
+}
+/** Return every model whose tier matches. Optionally filter by GenerationType. */
+export declare function getModelsByTier(tier: Tier, type?: GenerationType): ModelMatch[];
+/** Return the cheapest model satisfying (tier, type). Uses cost.fixed → cost.perSecond → 0. */
+export declare function getCheapestModel(tier: Tier, type: GenerationType): ModelMatch | undefined;
+/** Return all models supporting a generation type, regardless of tier. */
+export declare function getModelsByType(type: GenerationType): ModelMatch[];
+/**
+ * Build a compact, planner-readable summary of the model catalog grouped by
+ * tier. Injected into the planner system prompt so the LLM can pick a concrete
+ * `preferredModel` per scene with cost/quality awareness — e.g. cheap Kling
+ * for b-roll, premium Veo for hero shots.
+ *
+ * Token budget matters here: ~10–20 lines, no JSON, sorted cheapest-first per
+ * tier so the planner's default tendency aligns with cost minimization.
+ */
+export declare function summarizeModelsForPlanner(type?: GenerationType): string;
+//# sourceMappingURL=tierHelpers.d.ts.map

package/lib/globals/aiModels/tierHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierHelpers.d.ts","sourceRoot":"","sources":["../../../src/globals/aiModels/tierHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE,CAQ/E;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,cAAc,GACnB,UAAU,GAAG,SAAS,CAIxB;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAMlE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,GAAE,cAAgC,GACrC,MAAM,CAaR"}

package/lib/globals/aiModels/tierHelpers.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModelsByTier = getModelsByTier;
+exports.getCheapestModel = getCheapestModel;
+exports.getModelsByType = getModelsByType;
+exports.summarizeModelsForPlanner = summarizeModelsForPlanner;
+const index_1 = require("./index");
+/** Return every model whose tier matches. Optionally filter by GenerationType. */
+function getModelsByTier(tier, type) {
+    const matches = [];
+    for (const [modelKey, config] of Object.entries(index_1.aiModelConfigs)) {
+        if (config.tier !== tier)
+            continue;
+        if (type && !config.type.includes(type))
+            continue;
+        matches.push({ modelKey, config });
+    }
+    return matches;
+}
+/** Return the cheapest model satisfying (tier, type). Uses cost.fixed → cost.perSecond → 0. */
+function getCheapestModel(tier, type) {
+    const candidates = getModelsByTier(tier, type);
+    if (candidates.length === 0)
+        return undefined;
+    return candidates.sort((a, b) => costScore(a.config) - costScore(b.config))[0];
+}
+/** Return all models supporting a generation type, regardless of tier. */
+function getModelsByType(type) {
+    const matches = [];
+    for (const [modelKey, config] of Object.entries(index_1.aiModelConfigs)) {
+        if (config.type.includes(type))
+            matches.push({ modelKey, config });
+    }
+    return matches;
+}
+function costScore(c) {
+    if (c.cost?.fixed != null)
+        return c.cost.fixed;
+    if (c.cost?.perSecond != null)
+        return c.cost.perSecond;
+    return Number.POSITIVE_INFINITY;
+}
+/**
+ * Build a compact, planner-readable summary of the model catalog grouped by
+ * tier. Injected into the planner system prompt so the LLM can pick a concrete
+ * `preferredModel` per scene with cost/quality awareness — e.g. cheap Kling
+ * for b-roll, premium Veo for hero shots.
+ *
+ * Token budget matters here: ~10–20 lines, no JSON, sorted cheapest-first per
+ * tier so the planner's default tendency aligns with cost minimization.
+ */
+function summarizeModelsForPlanner(type = "text-to-video") {
+    const lines = [];
+    for (const tier of ["T0", "T1", "T2", "T3"]) {
+        const matches = getModelsByTier(tier, type);
+        if (matches.length === 0)
+            continue;
+        matches.sort((a, b) => costScore(a.config) - costScore(b.config));
+        lines.push(`  ${tier}:`);
+        for (const m of matches) {
+            const cost = formatCost(m.config);
+            lines.push(`    - ${m.modelKey}${cost ? ` (${cost})` : ""}`);
+        }
+    }
+    return lines.length ? lines.join("\n") : "";
+}
+function formatCost(c) {
+    if (c.cost?.fixed != null)
+        return `$${c.cost.fixed.toFixed(2)} fixed`;
+    if (c.cost?.perSecond != null)
+        return `$${c.cost.perSecond.toFixed(2)}/s`;
+    return "";
+}

package/lib/globals/ttsModels/providers/minimax.d.ts

@@ -0,0 +1,8 @@
+import { ITtsProviderConfig } from "../types";
+/**
+ * MiniMax Speech-02-HD — high-fidelity multilingual TTS.
+ * API: POST https://api.minimax.io/v1/t2a_v2 returns hex-encoded audio inline.
+ * Pricing: roughly $0.10 per 1K chars (T2A HD tier).
+ */
+export declare const minimaxTtsConfig: ITtsProviderConfig;
+//# sourceMappingURL=minimax.d.ts.map

package/lib/globals/ttsModels/providers/minimax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimax.d.ts","sourceRoot":"","sources":["../../../../src/globals/ttsModels/providers/minimax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAS9B,CAAC"}

package/lib/globals/ttsModels/providers/minimax.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minimaxTtsConfig = void 0;
+/**
+ * MiniMax Speech-02-HD — high-fidelity multilingual TTS.
+ * API: POST https://api.minimax.io/v1/t2a_v2 returns hex-encoded audio inline.
+ * Pricing: roughly $0.10 per 1K chars (T2A HD tier).
+ */
+exports.minimaxTtsConfig = {
+    name: "MiniMax Speech-02 HD",
+    costPer1KChars: 0.1,
+    defaultVoiceId: "male-qn-qingse",
+    modelId: "speech-02-hd",
+    wordsPerSecond: 2.5,
+    maxCharsPerRequest: 5000,
+    durationSafetyBufferSeconds: 100,
+    concurrentRequests: 5,
+};

package/lib/globals/ttsModels/providers/openai.d.ts

@@ -0,0 +1,8 @@
+import { ITtsProviderConfig } from "../types";
+/**
+ * OpenAI gpt-4o-mini-tts — cheap, fast TTS with optional `instructions` styling.
+ * API: POST https://api.openai.com/v1/audio/speech returns mp3 binary directly.
+ * Pricing: ~$0.015/1K chars (gpt-4o-mini-tts).
+ */
+export declare const openaiTtsConfig: ITtsProviderConfig;
+//# sourceMappingURL=openai.d.ts.map

package/lib/globals/ttsModels/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/globals/ttsModels/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,kBAS7B,CAAC"}

package/lib/globals/ttsModels/providers/openai.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openaiTtsConfig = void 0;
+/**
+ * OpenAI gpt-4o-mini-tts — cheap, fast TTS with optional `instructions` styling.
+ * API: POST https://api.openai.com/v1/audio/speech returns mp3 binary directly.
+ * Pricing: ~$0.015/1K chars (gpt-4o-mini-tts).
+ */
+exports.openaiTtsConfig = {
+    name: "OpenAI gpt-4o-mini-tts",
+    costPer1KChars: 0.015,
+    defaultVoiceId: "alloy",
+    modelId: "gpt-4o-mini-tts",
+    wordsPerSecond: 2.5,
+    maxCharsPerRequest: 4096,
+    durationSafetyBufferSeconds: 60,
+    concurrentRequests: 5,
+};

package/lib/models/agent.model.d.ts

@@ -0,0 +1,117 @@
+import { VideoBrief } from "../schemas/brief.schema";
+import { VideoPlan } from "../schemas/videoPlan.schema";
+import { AgentPersona } from "../schemas/agentPersona.schema";
+import { CriticReport } from "../services/agent/critic";
+/**
+ * BrandKit — set-once-per-user identity. Auto-injected into every brief by
+ * the agent so brand consistency lifts free across runs. Lives at
+ * /brandKits/{userId} (single doc per user).
+ */
+export interface IBrandKitModel {
+    userId: string;
+    brandName?: string;
+    logoUrl?: string;
+    primaryColorHex?: string;
+    secondaryColorHex?: string;
+    fontFamily?: string;
+    /** Preferred TTS voice id. */
+    voiceId?: string;
+    /** Music tempo / mood preference. */
+    musicMoods?: string[];
+    /** Phrases the agent must never produce. */
+    bannedClaims?: string[];
+    /** Phrases the agent should prefer. */
+    preferredClaims?: string[];
+    /**
+     * Presenter face still URL — set once by the user; required for the
+     * talking-head-avatar strategy. Planner injects into PlannedScene.avatarFaceUrl.
+     */
+    presenterFaceUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * StyleMemory — per-user record of recent accepted/rejected scene decisions.
+ * Used as few-shot examples by the planner to bias future plans toward
+ * choices the user has previously accepted. Lives at /styleMemory/{userId}
+ * (single doc per user, like the brand kit).
+ *
+ * Capped to MAX_STYLE_MEMORY_ENTRIES per side; older entries fall off when
+ * `recordSceneDecision` is called.
+ */
+export declare const MAX_STYLE_MEMORY_ENTRIES = 10;
+export interface IStyleMemoryEntry {
+    /** Snapshot of the planner's PlannedScene for this decision. */
+    scene: unknown;
+    /** Project this came from. */
+    projectId: string;
+    /** Which scene index in that project. */
+    sceneIndex: number;
+    /** ISO timestamp the decision was recorded. */
+    recordedAt: string;
+}
+export interface IStyleMemoryModel {
+    userId: string;
+    /** Scenes the user shipped without changes. */
+    acceptedScenes: IStyleMemoryEntry[];
+    /** Scenes the user explicitly rejected (regenerated, deleted, swapped). */
+    rejectedScenes: IStyleMemoryEntry[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * AgentProject — one chat session / one Project JSON in flight. Holds the
+ * current Brief and VideoPlan. Multiple AgentRuns may attach to a single
+ * project (each "regenerate scene" is a new run).
+ */
+export interface IAgentProjectModel {
+    id: string;
+    userId: string;
+    title?: string;
+    brief?: VideoBrief;
+    plan?: VideoPlan;
+    /** Latest Project JSON (Remotion editor schema). */
+    projectJson?: unknown;
+    status: "draft" | "planned" | "executing" | "ready-to-render" | "rendered" | "failed";
+    /** Persona persisted across the session. */
+    persona?: AgentPersona;
+    /** Latest critic report from execute. */
+    criticReport?: CriticReport;
+    /** Most recent render output for this project. */
+    lastRender?: {
+        renderJobId: string;
+        mp4Url: string;
+        durationMs: number;
+        quality: "draft" | "standard" | "premium";
+        renderedAt: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * AgentRun — one planner+executor+critic invocation. Stored for replay,
+ * eval, and debugging. The recorder writes to this collection at end of run.
+ */
+export interface IAgentRunModel {
+    id: string;
+    userId: string;
+    projectId: string;
+    persona?: AgentPersona;
+    brief?: VideoBrief;
+    plan?: VideoPlan;
+    /** Logged tool calls in order. Shape mirrors the trace recorder's ToolCallTrace. */
+    toolCalls: Array<{
+        ts: number;
+        tool: string;
+        input: unknown;
+        outcome: unknown;
+    }>;
+    /** RNG seed used (replay reproducibility). */
+    rngSeed?: number;
+    status: "running" | "succeeded" | "failed" | "aborted";
+    startedAt: string;
+    endedAt?: string;
+    totalCost?: number;
+    errorMessage?: string;
+}
+//# sourceMappingURL=agent.model.d.ts.map

package/lib/models/agent.model.d.ts.map

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

package/lib/models/agent.model.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_STYLE_MEMORY_ENTRIES = void 0;
+/**
+ * StyleMemory — per-user record of recent accepted/rejected scene decisions.
+ * Used as few-shot examples by the planner to bias future plans toward
+ * choices the user has previously accepted. Lives at /styleMemory/{userId}
+ * (single doc per user, like the brand kit).
+ *
+ * Capped to MAX_STYLE_MEMORY_ENTRIES per side; older entries fall off when
+ * `recordSceneDecision` is called.
+ */
+exports.MAX_STYLE_MEMORY_ENTRIES = 10;

package/lib/models/analytics.model.d.ts

@@ -17,6 +17,9 @@ export interface IAnalyticsDailyModel {
     totalDurationSeconds: number;
     jobLatencyMsSum: number;
     jobLatencyMsCount: number;
+    /** Try-example / sample short-circuit count. Tracked separately so the
+     * jobs* fields stay real-generation-only. May be absent on historical docs. */
+    samplesCompleted?: number;
     updatedAt: FieldValue;
 }
 /** Cross-model daily rollup for summary cards. */
@@ -30,6 +33,7 @@ export interface IAnalyticsDailyGlobalModel {
     totalCreditsUsed: number;
     jobLatencyMsSum: number;
     jobLatencyMsCount: number;
+    samplesCompleted?: number;
     updatedAt: FieldValue;
 }
 //# sourceMappingURL=analytics.model.d.ts.map

package/lib/models/analytics.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.model.d.ts","sourceRoot":"","sources":["../../src/models/analytics.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACvB"}
+{"version":3,"file":"analytics.model.d.ts","sourceRoot":"","sources":["../../src/models/analytics.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B;mFAC+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACvB"}