vidspotai-shared 1.0.82-dev.0 → 1.0.82

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

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CA8SpE,CAAC"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAqUpE,CAAC"}

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

@@ -23,7 +23,16 @@ exports.googleConfigs = {
             inputVideoUrl: {},
             negative_prompt: {},
             audio: {},
-            seed: {},
+            // REMOVED — `seed` is Vertex-AI-only. On the Gemini Developer API the SDK
+            // throws "seed parameter is not supported in Gemini API" client-side.
+            // Kept for reference; restore only under a Vertex (vertexai:true) client.
+            // seed: {},
+            // NOTE (applies to all Veo 3.x): on the Gemini API only "allow_all" is
+            // actually honored — "allow_adult"/"dont_allow" are Veo-2 legacy and
+            // return 400 "<value> for personGeneration is currently not supported".
+            // allowedValues is kept as the union so validateParams doesn't hard-throw
+            // on a planner-emitted value; google.service.ts forwards ONLY allow_all
+            // and silently drops the rest (allow_all is the API default anyway).
             personGeneration: { allowedValues: ["allow_all", "allow_adult", "dont_allow"] },
             promptOptimizer: {},
         },
@@ -37,14 +46,18 @@ exports.googleConfigs = {
             6: ["720p"],
             8: ["720p", "1080p", "4k"],
         },
-        // Gemini Developer API paid Tier 2 ceiling (verified 2026-06-09 via
+        // SINGLE-KEY Tier-2 baseline (verified 2026-06-09 via
         // aistudio.google.com/rate-limit): 4 req/min, ~50/day per Veo model on the
-        // shared `predict_long_running_requests_per_model` quota. The previous `50`
-        // was fictional (Google 429s long before that). NOTE: the real binding
-        // constraint in prod is the DAILY cap (~50/model/day) which this per-minute
-        // limiter does not model — watch for it under load. Raise after a tier-3
-        // upgrade / quota increase.
+        // shared `predict_long_running_requests_per_model` quota. The DAILY cap is
+        // enforced (requestPerDay) — the limiter's day-gate fast-fails
+        // (VIDEO_PROVIDER_RATE_LIMITED) rather than blocking for hours, so a
+        // daily-exhausted job silently spills to another model in the tier chain.
+        // NOTE: these are per-key Tier-2 numbers. The multi-key pool (googleKeyPool)
+        // scales the model-level limiter to the SUM across keys (each tier-scaled) —
+        // e.g. a Tier-1 + Tier-2 pool → 6/min, 60/day. See googleApiKeys.ts for the
+        // decision record.
         requestPerMin: 4,
+        requestPerDay: 50,
         cost: {
             // Vertex: $0.40/s @ 720p/1080p, $0.60/s @ 4k.
             perResolution: { "720p": 0.40, "1080p": 0.40, "4k": 0.60 },
@@ -70,7 +83,9 @@ exports.googleConfigs = {
             inputVideoUrl: {},
             negative_prompt: {},
             audio: {},
-            seed: {},
+            // REMOVED — `seed` is Vertex-AI-only; the Gemini API SDK throws
+            // "seed parameter is not supported in Gemini API" client-side. See veo-3.1.
+            // seed: {},
             personGeneration: { allowedValues: ["allow_all", "allow_adult", "dont_allow"] },
             promptOptimizer: {},
         },
@@ -82,6 +97,7 @@ exports.googleConfigs = {
         },
         // Tier 2 ceiling: 4 RPM / ~50 RPD per model (see veo-3.1 note above).
         requestPerMin: 4,
+        requestPerDay: 50,
         cost: {
             perResolution: { "720p": 0.10, "1080p": 0.12 },
         },
@@ -103,9 +119,15 @@ exports.googleConfigs = {
             // lastFrameImageUrl: {},
             // Lite also does NOT support reference images or video extension per the
             // Gemini API spec — only 3.1 and 3.1-fast do.
-            negative_prompt: {},
+            // REMOVED — veo-3.1-lite returns 400 "negativePrompt isn't supported by
+            // this model" (unlike veo-3.1 / veo-3.1-fast, which accept it). The request
+            // builder gates negativePrompt on this field being declared, so leaving it
+            // out is what stops the param from being forwarded. Kept for reference.
+            // negative_prompt: {},
             audio: {},
-            seed: {},
+            // REMOVED — `seed` is Vertex-AI-only; the Gemini API SDK throws
+            // "seed parameter is not supported in Gemini API" client-side. See veo-3.1.
+            // seed: {},
             personGeneration: { allowedValues: ["allow_all", "allow_adult", "dont_allow"] },
             promptOptimizer: {},
         },
@@ -117,6 +139,7 @@ exports.googleConfigs = {
         },
         // Tier 2 ceiling: 4 RPM / ~50 RPD per model (see veo-3.1 note above).
         requestPerMin: 4,
+        requestPerDay: 50,
         cost: {
             perResolution: { "720p": 0.05, "1080p": 0.08 },
         },

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

@@ -641,18 +641,18 @@ export declare const ClipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>], "type">;
 export declare const TrackKindSchema: z.ZodEnum<{
-    text: "text";
     audio: "audio";
     video: "video";
+    text: "text";
     caption: "caption";
     fx: "fx";
 }>;
 export declare const TrackSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
-        text: "text";
         audio: "audio";
         video: "video";
+        text: "text";
         caption: "caption";
         fx: "fx";
     }>;
@@ -700,9 +700,9 @@ export declare const ProjectSchema: z.ZodObject<{
     tracks: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
-            text: "text";
             audio: "audio";
             video: "video";
+            text: "text";
             caption: "caption";
             fx: "fx";
         }>;

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

@@ -167,8 +167,8 @@ export declare const TextOverlaySchema: z.ZodObject<{
     fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
     sizePct: z.ZodOptional<z.ZodNumber>;
     weight: z.ZodOptional<z.ZodEnum<{
-        bold: "bold";
         regular: "regular";
+        bold: "bold";
         black: "black";
         medium: "medium";
     }>>;
@@ -290,8 +290,8 @@ export declare const PlannedSceneSchema: z.ZodObject<{
         fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
         sizePct: z.ZodOptional<z.ZodNumber>;
         weight: z.ZodOptional<z.ZodEnum<{
-            bold: "bold";
             regular: "regular";
+            bold: "bold";
             black: "black";
             medium: "medium";
         }>>;
@@ -453,8 +453,8 @@ export declare const VideoPlanSchema: z.ZodObject<{
             fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
             sizePct: z.ZodOptional<z.ZodNumber>;
             weight: z.ZodOptional<z.ZodEnum<{
-                bold: "bold";
                 regular: "regular";
+                bold: "bold";
                 black: "black";
                 medium: "medium";
             }>>;

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

@@ -69,8 +69,8 @@ export declare const TextEditSchema: z.ZodObject<{
         fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
         sizePct: z.ZodOptional<z.ZodNumber>;
         weight: z.ZodOptional<z.ZodEnum<{
-            bold: "bold";
             regular: "regular";
+            bold: "bold";
             black: "black";
             medium: "medium";
         }>>;
@@ -164,8 +164,8 @@ export declare const EditRequestSchema: z.ZodObject<{
             fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
             sizePct: z.ZodOptional<z.ZodNumber>;
             weight: z.ZodOptional<z.ZodEnum<{
-                bold: "bold";
                 regular: "regular";
+                bold: "bold";
                 black: "black";
                 medium: "medium";
             }>>;

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

@@ -1,5 +1,5 @@
 import { ToolContext, ToolOutcome } from "../toolRegistry";
-import { AgentRunTrace } from "./types";
+import { AgentRunTrace, ToolCallTrace } from "./types";
 export declare function setTracePersistence(fn: (trace: AgentRunTrace) => Promise<void>): void;
 export declare function startTrace(opts: {
     agentRunId: string;
@@ -8,6 +8,18 @@ export declare function startTrace(opts: {
     rngSeed: string;
 }): AgentRunTrace;
 export declare function getTrace(agentRunId: string): AgentRunTrace | undefined;
+/**
+ * Returns a size-bounded copy of `toolCalls` safe to persist in a Firestore
+ * doc, plus whether anything was dropped/summarized. Strategy:
+ *   1. Any individually-huge entry keeps its metadata (ts/tool/ok/durationMs +
+ *      error) but its `input`/`output` payloads are replaced with a marker.
+ *   2. The array is then trimmed to the most RECENT entries that fit under the
+ *      total byte budget (recent calls are the most useful for a post-mortem).
+ */
+export declare function capToolCallsForFirestore(toolCalls: ToolCallTrace[]): {
+    toolCalls: ToolCallTrace[];
+    truncated: boolean;
+};
 export declare function endTrace(agentRunId: string): Promise<AgentRunTrace | undefined>;
 /**
  * Drop-in replacement for runTool that records the call in the active trace.

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

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/eval/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAA8B,MAAM,SAAS,CAAC;AAcpE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAErF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CAWhB;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAgBrF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CASzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACxD,OAAO,CAAC,CAAC,CAAC,CAiBZ"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/eval/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAe,MAAM,SAAS,CAAC;AAcpE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAErF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CAWhB;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE;AAiBD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG;IACpE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB,CAyCA;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAgBrF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CASzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACxD,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setTracePersistence = setTracePersistence;
 exports.startTrace = startTrace;
 exports.getTrace = getTrace;
+exports.capToolCallsForFirestore = capToolCallsForFirestore;
 exports.endTrace = endTrace;
 exports.runToolRecorded = runToolRecorded;
 exports.trackStage = trackStage;
@@ -36,6 +37,64 @@ function startTrace(opts) {
 function getTrace(agentRunId) {
     return traces.get(agentRunId);
 }
+/** Approx serialized byte size of a JSON-able value (Firestore counts UTF-8 bytes). */
+function jsonByteLen(value) {
+    return Buffer.byteLength(JSON.stringify(value ?? null), "utf8");
+}
+// Firestore rejects ANY document over 1,048,576 bytes. For multi-scene agent
+// runs the serialized `toolCalls` array (full provider input/output payloads
+// inline) routinely blows past that — which previously failed the whole trace
+// persist with "trace persist failed" AND, on a {merge:true} write to the run
+// doc, poisoned the terminal-status flip the frontend listener depends on. The
+// FULL trace already ships to Loki + GCS via the recorder, so the Firestore
+// copy only needs to stay queryable and under the cap.
+const FIRESTORE_TOOLCALLS_BUDGET_BYTES = 800000; // headroom for the rest of the doc
+const PER_TOOLCALL_MAX_BYTES = 100000; // any single entry larger than this is summarized
+/**
+ * Returns a size-bounded copy of `toolCalls` safe to persist in a Firestore
+ * doc, plus whether anything was dropped/summarized. Strategy:
+ *   1. Any individually-huge entry keeps its metadata (ts/tool/ok/durationMs +
+ *      error) but its `input`/`output` payloads are replaced with a marker.
+ *   2. The array is then trimmed to the most RECENT entries that fit under the
+ *      total byte budget (recent calls are the most useful for a post-mortem).
+ */
+function capToolCallsForFirestore(toolCalls) {
+    let truncated = false;
+    const summarizeOutcome = (outcome) => outcome.ok
+        ? {
+            ok: true,
+            output: `[truncated ${jsonByteLen(outcome.output)} bytes]`,
+            durationMs: outcome.durationMs,
+        }
+        : outcome; // failure outcomes carry only {code, message} — already small
+    const shrunk = toolCalls.map((call) => {
+        if (jsonByteLen(call) <= PER_TOOLCALL_MAX_BYTES)
+            return call;
+        truncated = true;
+        return {
+            ts: call.ts,
+            tool: call.tool,
+            input: `[truncated ${jsonByteLen(call.input)} bytes]`,
+            outcome: summarizeOutcome(call.outcome),
+        };
+    });
+    // Keep newest-first under the budget, then restore chronological order.
+    const kept = [];
+    let total = 0;
+    for (let i = shrunk.length - 1; i >= 0; i--) {
+        const entry = shrunk[i];
+        if (!entry)
+            continue;
+        const size = jsonByteLen(entry);
+        if (total + size > FIRESTORE_TOOLCALLS_BUDGET_BYTES) {
+            truncated = true;
+            break;
+        }
+        total += size;
+        kept.unshift(entry);
+    }
+    return { toolCalls: kept, truncated };
+}
 async function endTrace(agentRunId) {
     const trace = traces.get(agentRunId);
     if (!trace)

package/lib/services/agent/tools/composeScene.tool.d.ts

@@ -29,9 +29,9 @@ declare const InputSchema: z.ZodObject<{
         tracks: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
-                text: "text";
                 audio: "audio";
                 video: "video";
+                text: "text";
                 caption: "caption";
                 fx: "fx";
             }>;
@@ -662,9 +662,9 @@ declare const OutputSchema: z.ZodObject<{
         tracks: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
-                text: "text";
                 audio: "audio";
                 video: "video";
+                text: "text";
                 caption: "caption";
                 fx: "fx";
             }>;

package/lib/services/agent/tools/estimateCost.tool.d.ts

@@ -29,9 +29,9 @@ declare const InputSchema: z.ZodObject<{
         tracks: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
-                text: "text";
                 audio: "audio";
                 video: "video";
+                text: "text";
                 caption: "caption";
                 fx: "fx";
             }>;

package/lib/services/agent/tools/planVideo.tool.d.ts

@@ -209,8 +209,8 @@ declare const OutputSchema: z.ZodObject<{
                 fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
                 sizePct: z.ZodOptional<z.ZodNumber>;
                 weight: z.ZodOptional<z.ZodEnum<{
-                    bold: "bold";
                     regular: "regular";
+                    bold: "bold";
                     black: "black";
                     medium: "medium";
                 }>>;

package/lib/services/agent/tools/render.tool.d.ts

@@ -44,9 +44,9 @@ declare const InputSchema: z.ZodObject<{
         tracks: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
-                text: "text";
                 audio: "audio";
                 video: "video";
+                text: "text";
                 caption: "caption";
                 fx: "fx";
             }>;

package/lib/services/aiGen/helpers.d.ts

@@ -14,5 +14,13 @@ export declare function modelSupportsLastFrame(modelKey: string): boolean;
  * a model that can't do it. Derived from the configs so it never drifts.
  */
 export declare function getModelsSupportingLastFrame(): string[];
+/**
+ * Generic capability probe: does the model's config DECLARE this field? Source
+ * of truth for "should we send this optional param to the provider", so a model
+ * that doesn't list e.g. `negative_prompt` never has it forwarded (and never
+ * eats an opaque provider 400 like veo-3.1-lite's "negativePrompt isn't
+ * supported by this model"). Same pattern as modelSupportsLastFrame, generalized.
+ */
+export declare function modelDeclaresField(modelKey: string, field: string): boolean;
 export declare function validateParams(params: VideoGenerationParams): boolean;
 //# sourceMappingURL=helpers.d.ts.map

package/lib/services/aiGen/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/services/aiGen/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAqJrE"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/services/aiGen/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAqJrE"}

package/lib/services/aiGen/helpers.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.modelSupportsLastFrame = modelSupportsLastFrame;
 exports.getModelsSupportingLastFrame = getModelsSupportingLastFrame;
+exports.modelDeclaresField = modelDeclaresField;
 exports.validateParams = validateParams;
 const aiModels_1 = require("../../globals/aiModels");
 /**
@@ -24,6 +25,17 @@ function modelSupportsLastFrame(modelKey) {
 function getModelsSupportingLastFrame() {
     return Object.keys(aiModels_1.aiModelConfigs).filter((key) => modelSupportsLastFrame(key));
 }
+/**
+ * Generic capability probe: does the model's config DECLARE this field? Source
+ * of truth for "should we send this optional param to the provider", so a model
+ * that doesn't list e.g. `negative_prompt` never has it forwarded (and never
+ * eats an opaque provider 400 like veo-3.1-lite's "negativePrompt isn't
+ * supported by this model"). Same pattern as modelSupportsLastFrame, generalized.
+ */
+function modelDeclaresField(modelKey, field) {
+    const cfg = aiModels_1.aiModelConfigs[modelKey];
+    return !!cfg?.fields && field in cfg.fields;
+}
 function validateParams(params) {
     const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
     if (!modelConfig) {

package/lib/services/aiGen/providers/google/google.service.d.ts

@@ -2,6 +2,7 @@ import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
 import { CreditUsageParams, ImageGenerationParams, ImageGenerationResult, MusicGenerationParams, MusicGenerationResult, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
 export declare class GoogleService extends BaseAiGenProviderService {
     private ai;
+    private keyPool;
     private static readonly MAX_RETRY_ATTEMPTS;
     constructor();
     /**

package/lib/services/aiGen/providers/google/google.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA2MlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAO/C;;;;OAIG;YACW,kBAAkB;IA+B1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyG3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoG3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAwG5B;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqEjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BvI"}
+{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA+NlB,qBAAa,aAAc,SAAQ,wBAAwB;IAKzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAQ/C;;;;OAIG;YACW,kBAAkB;IA+B1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAiJ3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyG3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAwG5B;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqEjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BvI"}

package/lib/services/aiGen/providers/google/google.service.js

@@ -18,6 +18,8 @@ const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
 const google_auth_library_1 = require("google-auth-library");
 const fs_1 = require("fs");
 const promises_2 = require("stream/promises");
+const googleApiKeys_1 = require("./googleApiKeys");
+const googleKeyPool_1 = require("./googleKeyPool");
 // Codes from undici / Node net layer that indicate a transient network failure
 // the request never reached the server, or the server hung up mid-flight.
 // Retrying these is safe (idempotent at the API layer for our use cases) and usually succeeds.
@@ -178,6 +180,19 @@ function classifyGoogleApiError(err) {
             /internal (server|error)/i.test(msg)) {
             return new errors_1.UserFacingError("Google's video service had a temporary problem. Please try again in a few minutes.", errors_1.USER_FACING_ERROR_CODES.PROVIDER_UNAVAILABLE);
         }
+        // HTTP 503 / status UNAVAILABLE — Google's video backend is temporarily
+        // overloaded or down ("The service is currently unavailable."). Same class
+        // as code 13 INTERNAL above: a transient provider outage, not our bug and
+        // not moderation. Without this branch it fell through to `return null` and
+        // got re-thrown as a raw ApiError → logged at `error` (paging Slack) with
+        // the raw provider JSON as the scene's errorMessage. Surface it as
+        // PROVIDER_UNAVAILABLE so the user gets a "try again" message and it logs
+        // warn (Loki) instead.
+        if (httpCode === 503 ||
+            status === "UNAVAILABLE" ||
+            /service is currently unavailable|temporarily unavailable/i.test(msg)) {
+            return new errors_1.UserFacingError("Google's video service is temporarily unavailable. Please try again in a few minutes.", errors_1.USER_FACING_ERROR_CODES.PROVIDER_UNAVAILABLE);
+        }
     }
     catch {
         // Not JSON — fall through to non-JSON checks.
@@ -191,6 +206,7 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
     constructor() {
         super();
         this.ai = new genai_1.GoogleGenAI({ apiKey: process.env.GOOGLE_API_KEY });
+        this.keyPool = (0, googleKeyPool_1.getGoogleKeyPool)();
     }
     /**
      * Retries `fn` on transient network errors (undici "fetch failed", ECONNRESET, ETIMEDOUT,
@@ -256,9 +272,35 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
                 aspectRatio: params.aspectRatio,
                 resolution: params.resolution,
                 durationSeconds: params.duration,
-                ...(params.seed !== undefined ? { seed: params.seed } : {}),
-                ...(params.personGeneration ? { personGeneration: params.personGeneration } : {}),
-                ...(params.negativePrompt ? { negativePrompt: params.negativePrompt } : {}),
+                // REMOVED for the Gemini Developer API backend — kept for reference.
+                // `seed` is NOT supported by Veo on the Gemini API (Mldev): this client
+                // is `new GoogleGenAI({ apiKey })`, whose SDK transformer
+                // (generateVideosConfigToMldev) throws *client-side*
+                // "seed parameter is not supported in Gemini API" before any request is
+                // sent — so it can never reach Google and was failing every job that
+                // carried a seed. Like `generateAudio`, it is a Vertex-AI-only field.
+                // Restore this line if/when this client switches to Vertex (vertexai:true).
+                // ...(params.seed !== undefined ? { seed: params.seed } : {}),
+                // personGeneration on the Gemini API Veo backend: "allow_all" is the
+                // ONLY supported value for Veo 3.x (and it is also the default).
+                // "allow_adult" and "dont_allow" are Veo-2-only legacy values — sending
+                // either returns 400 "<value> for personGeneration is currently not
+                // supported", which is NOT matched by classifyGoogleApiError and so
+                // leaks to logger.error → Slack while failing the job. Since allow_all
+                // is the default, forward the param only when it's explicitly allow_all
+                // (a no-op that documents intent); drop any other requested value
+                // rather than hard-fail. Restoring allow_adult/dont_allow would require
+                // a Veo-2 model or an allowlisted Vertex project.
+                ...(params.personGeneration === "allow_all"
+                    ? { personGeneration: "allow_all" }
+                    : {}),
+                // negativePrompt support is MODEL-SPECIFIC on the Gemini API: veo-3.1 and
+                // veo-3.1-fast accept it, veo-3.1-lite returns 400 "negativePrompt isn't
+                // supported by this model". Gate on the model config declaring the field
+                // (negative_prompt) so we never forward it to a model that rejects it.
+                ...(params.negativePrompt && (0, helpers_2.modelDeclaresField)(params.modelKey, "negative_prompt")
+                    ? { negativePrompt: params.negativePrompt }
+                    : {}),
                 // REMOVED for the Gemini Developer API backend — kept for reference.
                 // `generateAudio` is a Vertex-AI-only config field. This client is
                 // constructed with `new GoogleGenAI({ apiKey })` (the Mldev / Gemini
@@ -299,16 +341,29 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
                 }));
             }
         }
-        const operation = await this.withTransientRetry("generateVideos", () => this.ai.models.generateVideos(request));
+        // Route this submit to a key with budget (priority order). The per-key
+        // caps are the single-key Tier-2 numbers in the model config; the
+        // model-level limiter already gated the aggregate (per-key × key count).
+        const keyEntry = await this.keyPool.pickForSubmit(modelId, modelConfig.requestPerMin ?? 0, modelConfig.requestPerDay ?? 0);
+        const operation = await this.withTransientRetry("generateVideos", () => keyEntry.client.models.generateVideos(request));
         if (!operation || !operation.name) {
             throw new Error("Failed to initiate video generation task");
         }
-        return { task: operation.name, status: types_1.EVideoSceneStatus.TRIGGERED };
+        // Tag the task with the issuing key so poll + download re-select the same
+        // (project-scoped) client. Single-key pool → bare name (legacy format).
+        return {
+            task: (0, googleApiKeys_1.encodeVeoTask)(keyEntry.id, operation.name, this.keyPool.size),
+            status: types_1.EVideoSceneStatus.TRIGGERED,
+        };
     }
     async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
+        // Re-select the key that submitted this task (Veo operations are
+        // project-scoped). Un-tagged / unknown ids fall back to the legacy client.
+        const { keyId, operationName } = (0, googleApiKeys_1.decodeVeoTask)(task);
+        const client = this.keyPool.clientById(keyId) ?? this.ai;
         const operation = new genai_1.GenerateVideosOperation();
-        operation.name = task;
-        const result = await this.withTransientRetry("getVideosOperation", () => this.ai.operations.getVideosOperation({ operation }));
+        operation.name = operationName;
+        const result = await this.withTransientRetry("getVideosOperation", () => client.operations.getVideosOperation({ operation }));
         if (result.done) {
             if (result.error) {
                 // A long-running operation can finish with an error (e.g. gRPC 13

package/lib/services/aiGen/providers/google/googleApiKeys.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pure (SDK-free, Redis-free) helpers for the Google AI Studio API key pool.
+ *
+ * ── DECISION RECORD (2026-06-15) ────────────────────────────────────────────
+ * Problem: Veo on a single Gemini Developer API key is quota-starved — Tier 2
+ * is ~4 req/min and ~50/day per Veo model — which serialized bursts of jobs
+ * into a multi-hour queue (~370 min observed avg latency).
+ *
+ * Chosen fix (today): a multi-key pool over TWO Google AI Studio keys that live
+ * in SEPARATE GCP projects / billing accounts, so their quotas are independent
+ * and ADD UP. Keys are used in PRIORITY order:
+ *   - key[0] = the NEW key (vidspotai project), currently **Tier 1** (2/min,
+ *     10/day per Veo model). Used FIRST, deliberately, to drive usage and
+ *     promote its billing account up the tier ladder.
+ *   - key[1] = the CURRENT key, **Tier 2** (4/min, 50/day). Used once key[0]
+ *     is out of per-minute / per-day budget.
+ * Aggregate Veo budget = T1 + T2 = 6/min, 60/day. When BOTH are exhausted, the
+ * job-start capacity selector (videoJobProcessor) spills to another provider.
+ *
+ * When key[1]'s account is billed it moves to Tier 3; bump its tier in
+ * GOOGLE_API_KEY_TIERS then (no code change — the ladder below handles it).
+ *
+ * Vertex AI (DEFERRED, on record for the future): Veo is also available via
+ * Vertex, where quota is **per-project** and the current billing account is
+ * Tier-2-per-project — so we could create multiple projects under one account
+ * to scale further. We are NOT doing Vertex now: the two AI-Studio keys across
+ * two billing accounts already cover our needed headroom, and the Vertex path
+ * needs a different output flow (GCS `gs://` URIs rather than the Files API)
+ * that we'd rather build + test deliberately when the extra capacity is needed.
+ *
+ * ── CONFIG ──────────────────────────────────────────────────────────────────
+ *   GOOGLE_API_KEYS       — comma-separated keys in PRIORITY order. Falls back
+ *                           to the single legacy GOOGLE_API_KEY when unset.
+ *   GOOGLE_API_KEY_TIERS  — comma-separated tier numbers (1/2/3) aligned to
+ *                           GOOGLE_API_KEYS. Missing/extra entries default to 2.
+ *   GOOGLE_API_KEY        — legacy single key; also the client used to poll
+ *                           tasks submitted before the pool existed (un-tagged).
+ *
+ * Per-key budget is derived from the model config's Tier-2 baseline
+ * (requestPerMin / requestPerDay) scaled by each key's tier (see TIER_FACTORS);
+ * the pool gives us the SUM across keys.
+ */
+/** Parse the configured keys in priority order, de-duped, empties removed. */
+export declare function parseGoogleApiKeys(): string[];
+/** Tier per key (aligned to parseGoogleApiKeys order); defaults to 2. */
+export declare function parseGoogleApiKeyTiers(): number[];
+/** Number of configured Google keys (>= 1 so callers can multiply safely). */
+export declare function googleApiKeyCount(): number;
+/** Per-key rate cap for a given Tier-2 baseline and tier. */
+export declare function scaleLimitForTier(baseline: number | undefined, tier: number, kind: "rpm" | "rpd"): number;
+/**
+ * Aggregate multiplier across all configured keys, for scaling a Google
+ * model's Tier-2 baseline into the pool-wide budget. Returns 1 for a single
+ * default key (legacy behavior unchanged).
+ */
+export declare function googleAggregateFactor(kind: "rpm" | "rpd"): number;
+/** Stable id for the key at a given priority index. */
+export declare function googleKeyId(index: number): string;
+/**
+ * Tag a Veo operation name with the id of the key that created it, so polling
+ * + download can re-select the same project-scoped client. With a single key
+ * we return the bare operation name (no tag) — byte-for-byte the legacy format,
+ * so nothing changes until a real pool is configured.
+ */
+export declare function encodeVeoTask(keyId: string, operationName: string, poolSize: number): string;
+/** Reverse of encodeVeoTask. `keyId` is undefined for legacy/un-tagged tasks. */
+export declare function decodeVeoTask(task: string): {
+    keyId?: string;
+    operationName: string;
+};
+//# sourceMappingURL=googleApiKeys.d.ts.map

package/lib/services/aiGen/providers/google/googleApiKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"googleApiKeys.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/googleApiKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAoBH,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAa7C;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAUjD;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAIjE;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAIrF"}