vidspotai-shared 1.0.53 → 1.0.55

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

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { ToolDefinition } from "../toolRegistry";
+/**
+ * Per-user asset library search — massive cost saver and consistency boost
+ * for serial creators. Looks across previously generated images, voiceovers,
+ * stock pulls, and uploads owned by the requesting user.
+ *
+ * The actual library backing (Firestore + GCS index, vector embeddings for
+ * semantic search) is host-side; tool layer accepts an injected searcher.
+ */
+export interface UserLibraryAsset {
+    id: string;
+    kind: "image" | "video" | "audio" | "stock-image" | "stock-video";
+    url: string;
+    prompt?: string;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    createdAt: string;
+}
+export type UserLibrarySearchFn = (params: {
+    userId: string;
+    query: string;
+    kind?: UserLibraryAsset["kind"];
+    limit: number;
+}) => Promise<UserLibraryAsset[]>;
+export declare function setUserLibrarySearch(fn: UserLibrarySearchFn): void;
+declare const InputSchema: z.ZodObject<{
+    query: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        audio: "audio";
+        video: "video";
+        image: "image";
+        "stock-video": "stock-video";
+        "stock-image": "stock-image";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    assets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            audio: "audio";
+            video: "video";
+            image: "image";
+            "stock-video": "stock-video";
+            "stock-image": "stock-image";
+        }>;
+        url: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const searchUserLibraryTool: ToolDefinition<typeof InputSchema, typeof OutputSchema>;
+export {};
+//# sourceMappingURL=searchUserLibrary.tool.d.ts.map

package/lib/services/agent/tools/searchUserLibrary.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchUserLibrary.tool.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/tools/searchUserLibrary.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAGlC,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,CAElE;AAED,QAAA,MAAM,WAAW;;;;;;;;;;iBASf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;iBAahB,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAChD,OAAO,WAAW,EAClB,OAAO,YAAY,CA2BpB,CAAC"}

package/lib/services/agent/tools/searchUserLibrary.tool.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchUserLibraryTool = void 0;
+exports.setUserLibrarySearch = setUserLibrarySearch;
+const zod_1 = require("zod");
+const toolRegistry_1 = require("../toolRegistry");
+let injectedSearch = null;
+function setUserLibrarySearch(fn) {
+    injectedSearch = fn;
+}
+const InputSchema = zod_1.z.object({
+    query: zod_1.z
+        .string()
+        .min(1)
+        .describe("Free-text query — semantic match against asset prompts and tags."),
+    kind: zod_1.z
+        .enum(["image", "video", "audio", "stock-image", "stock-video"])
+        .optional(),
+    limit: zod_1.z.number().int().min(1).max(20).default(8),
+});
+const OutputSchema = zod_1.z.object({
+    assets: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        kind: zod_1.z.enum(["image", "video", "audio", "stock-image", "stock-video"]),
+        url: zod_1.z.string().url(),
+        prompt: zod_1.z.string().optional(),
+        width: zod_1.z.number().optional(),
+        height: zod_1.z.number().optional(),
+        durationMs: zod_1.z.number().optional(),
+        createdAt: zod_1.z.string(),
+    })),
+});
+exports.searchUserLibraryTool = {
+    name: "search_user_library",
+    description: [
+        "Search the requesting user's previously-generated/uploaded assets before",
+        "spending credits to make a new one. Always try this BEFORE generate_image",
+        "or search_stock when the brief calls for something the user has likely",
+        "produced before (their product photos, recurring characters, brand b-roll).",
+        "Returns ranked candidates; the agent picks the best fit by prompt/durationMs/aspect.",
+    ].join(" "),
+    inputSchema: InputSchema,
+    outputSchema: OutputSchema,
+    idempotent: true,
+    handler: async (input, ctx) => {
+        if (!injectedSearch) {
+            throw new Error("search_user_library: no searcher wired. Host must call setUserLibrarySearch() at boot.");
+        }
+        const assets = await injectedSearch({
+            userId: ctx.userId,
+            query: input.query,
+            kind: input.kind,
+            limit: input.limit,
+        });
+        return { assets };
+    },
+};
+(0, toolRegistry_1.registerTool)(exports.searchUserLibraryTool);

package/lib/services/aiGen/canonicalAdapters/cameraControl.types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Canonical camera-control schema. Translated per-provider by adapters that
+ * live alongside each provider's service. The set is the union of camera
+ * primitives across Kling (typed presets + vector), Runway (named presets +
+ * motion intensity), MiniMax Director (in-prompt commands), Seedance (in-prompt),
+ * and Pixverse V6 (lens-control prompt vocabulary).
+ *
+ * Providers that don't expose camera control (Veo, OpenAI, Wan T2V) ignore the
+ * field with a logged warning rather than throwing.
+ */
+export type CameraPreset = "static" | "pan_left" | "pan_right" | "tilt_up" | "tilt_down" | "zoom_in" | "zoom_out" | "dolly_in" | "dolly_out" | "orbit_left" | "orbit_right" | "roll_left" | "roll_right" | "tracking" | "handheld" | "push_in" | "pull_out";
+/**
+ * Six-axis vector control (mirrors Kling's `camera_control.config` shape).
+ * Each axis is in [-10, 10]. Adapters that don't support fine-grained vector
+ * control fall back to the closest preset.
+ */
+export interface CameraVector {
+    horizontal?: number;
+    vertical?: number;
+    pan?: number;
+    tilt?: number;
+    roll?: number;
+    zoom?: number;
+}
+export interface CameraControl {
+    preset?: CameraPreset;
+    vector?: CameraVector;
+    /** 0..1 — strength of the camera move; provider-mapped. */
+    intensity?: number;
+}
+//# sourceMappingURL=cameraControl.types.d.ts.map

package/lib/services/aiGen/canonicalAdapters/cameraControl.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraControl.types.d.ts","sourceRoot":"","sources":["../../../../src/services/aiGen/canonicalAdapters/cameraControl.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,UAAU,GACV,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/lib/services/aiGen/canonicalAdapters/cameraControl.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/services/aiGen/canonicalAdapters/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./cameraControl.types";
+export * from "./multiShot.types";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/aiGen/canonicalAdapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/aiGen/canonicalAdapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/lib/services/aiGen/canonicalAdapters/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cameraControl.types"), exports);
+__exportStar(require("./multiShot.types"), exports);

package/lib/services/aiGen/canonicalAdapters/multiShot.types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Canonical multi-shot schema. Per-provider adapters translate this into:
+ *   Kling v3.0 → `multi_prompt[]` (per-shot prompts) + companion `shot_type`
+ *                (v3.0 only — v2.x has no public multi-shot API)
+ *   Seedance   → concatenated prompt with "--- CUT ---" separators
+ *   Pixverse   → `generate_multi_clip_switch=true` + concatenated prompt (≤2 shots)
+ *   others     → throw UnsupportedCapabilityError (gated by IModelSchema.fields.multiShot)
+ */
+export interface Shot {
+    prompt: string;
+    /** Seconds. Sum of all shot durations should match the request `duration`. */
+    duration?: number;
+    /** Optional first-frame image for this shot (Kling supports per-shot start frames). */
+    startFrame?: string;
+}
+/** 1..6 shots. Providers enforce their own caps in the adapter. */
+export type MultiShot = Shot[];
+export declare class UnsupportedCapabilityError extends Error {
+    readonly capability: string;
+    readonly modelKey: string;
+    constructor(capability: string, modelKey: string);
+}
+//# sourceMappingURL=multiShot.types.d.ts.map

package/lib/services/aiGen/canonicalAdapters/multiShot.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiShot.types.d.ts","sourceRoot":"","sources":["../../../../src/services/aiGen/canonicalAdapters/multiShot.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,IAAI,EAAE,CAAC;AAE/B,qBAAa,0BAA2B,SAAQ,KAAK;aAEjC,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBADhB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAKnC"}

package/lib/services/aiGen/canonicalAdapters/multiShot.types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnsupportedCapabilityError = void 0;
+class UnsupportedCapabilityError extends Error {
+    constructor(capability, modelKey) {
+        super(`Capability "${capability}" is not supported by model "${modelKey}".`);
+        this.capability = capability;
+        this.modelKey = modelKey;
+        this.name = "UnsupportedCapabilityError";
+    }
+}
+exports.UnsupportedCapabilityError = UnsupportedCapabilityError;

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

@@ -0,0 +1,18 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, SfxGenerationParams, SfxGenerationResult } from "../types";
+/**
+ * ElevenLabs aiGen provider — currently only sound-effects.
+ * (TTS lives in the separate `services/tts/` subsystem.)
+ */
+export declare class ElevenLabsAiGenService extends BaseAiGenProviderService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor();
+    /**
+     * ElevenLabs Sound Effects. Sync — POST /v1/sound-generation returns mp3 binary.
+     * Body: { text, duration_seconds?, prompt_influence?, loop? }
+     */
+    generateSoundEffects(params: SfxGenerationParams): Promise<SfxGenerationResult>;
+    getCreditUsed({ modelKey, duration, multiClip }: CreditUsageParams): number;
+}
+//# sourceMappingURL=elevenlabs.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/elevenlabs/elevenlabs.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,wBAAwB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAWhC;;;OAGG;IACG,oBAAoB,CACxB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAwD/B,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAiB,EAAE,EAAE,iBAAiB,GAAG,MAAM;CAkBpF"}

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

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElevenLabsAiGenService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const aiModels_1 = require("../../../../globals/aiModels");
+const firebase_1 = require("../../../../libs/firebase");
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+const helpers_1 = require("../../../../utils/helpers");
+/**
+ * ElevenLabs aiGen provider — currently only sound-effects.
+ * (TTS lives in the separate `services/tts/` subsystem.)
+ */
+class ElevenLabsAiGenService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super();
+        this.baseUrl = "https://api.elevenlabs.io/v1";
+        const raw = process.env.ELEVENLABS_API_KEY?.trim();
+        if (!raw) {
+            throw new Error("Missing ELEVENLABS_API_KEY in environment variables");
+        }
+        this.apiKey = raw;
+    }
+    /**
+     * ElevenLabs Sound Effects. Sync — POST /v1/sound-generation returns mp3 binary.
+     * Body: { text, duration_seconds?, prompt_influence?, loop? }
+     */
+    async generateSoundEffects(params) {
+        const body = {
+            text: params.prompt,
+            ...(params.durationSec !== undefined
+                ? { duration_seconds: params.durationSec }
+                : {}),
+            ...(params.promptInfluence !== undefined
+                ? { prompt_influence: params.promptInfluence }
+                : {}),
+            ...(params.loop !== undefined ? { loop: params.loop } : {}),
+        };
+        try {
+            const resp = await axios_1.default.post(`${this.baseUrl}/sound-generation`, body, {
+                headers: {
+                    "xi-api-key": this.apiKey,
+                    "Content-Type": "application/json",
+                    Accept: "audio/mpeg",
+                },
+                responseType: "arraybuffer",
+                timeout: 120000,
+            });
+            const buffer = Buffer.from(resp.data);
+            const path = `sfx/elevenlabs/${params.outputFilename}.mp3`;
+            const file = (0, firebase_1.getBucket)().file(path);
+            await file.save(buffer, { contentType: "audio/mpeg" });
+            const [signed] = await file.getSignedUrl({
+                action: "read",
+                expires: "03-09-2491",
+            });
+            return {
+                audioUrl: signed,
+                mimeType: "audio/mpeg",
+                extension: "mp3",
+                durationSec: params.durationSec,
+            };
+        }
+        catch (err) {
+            if (err.response?.data) {
+                let detail = "";
+                try {
+                    const bodyStr = Buffer.from(err.response.data).toString("utf8");
+                    const parsed = JSON.parse(bodyStr);
+                    detail = parsed?.detail?.message ?? parsed?.detail ?? bodyStr;
+                }
+                catch {
+                    detail = Buffer.from(err.response.data).toString("utf8");
+                }
+                throw new Error(`ElevenLabs SFX ${err.response.status}: ${detail} [promptLen=${params.prompt?.length ?? 0}]`);
+            }
+            throw err;
+        }
+    }
+    getCreditUsed({ modelKey, duration, multiClip = false }) {
+        const modelConfig = aiModels_1.aiModelConfigs[modelKey];
+        const isSfx = modelConfig?.type?.some((t) => t === "sound-effects");
+        if (isSfx && modelConfig?.cost) {
+            const perSecond = modelConfig.cost.perSecond;
+            const fixed = modelConfig.cost.fixed;
+            // Prefer per-second when caller knows the requested duration; otherwise
+            // fall back to the worst-case fixed ceiling so we never under-charge.
+            const cost = typeof duration === "number" && typeof perSecond === "number"
+                ? perSecond * duration
+                : fixed;
+            if (typeof cost === "number") {
+                return (0, helpers_1.getCreditsFromCost)(cost, !multiClip);
+            }
+        }
+        return (0, helpers_1.getCreditsFromCost)(0.08, !multiClip);
+    }
+}
+exports.ElevenLabsAiGenService = ElevenLabsAiGenService;

package/lib/services/aiGen/providers/fal/falImage.service.d.ts

@@ -0,0 +1,9 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, ImageGenerationParams, ImageGenerationResult } from "../types";
+export declare class FalImageProviderService extends BaseAiGenProviderService {
+    private readonly apiKey;
+    generateImage(params: ImageGenerationParams): Promise<ImageGenerationResult>;
+    getCreditUsed(params: CreditUsageParams): number;
+    private mapAspectToImageSize;
+}
+//# sourceMappingURL=falImage.service.d.ts.map

package/lib/services/aiGen/providers/fal/falImage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falImage.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/fal/falImage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAkClB,qBAAa,uBAAwB,SAAQ,wBAAwB;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEhE,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA8CjC,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAiBhD,OAAO,CAAC,oBAAoB;CAwB7B"}

package/lib/services/aiGen/providers/fal/falImage.service.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FalImageProviderService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+/**
+ * fal.ai image-generation provider.
+ *
+ * Wraps the synchronous fal subscription API. Supports Flux 1.1 Pro and other
+ * fal-hosted image models — the model id is passed via params.modelKey and
+ * mapped to the fal endpoint via FAL_MODEL_ENDPOINTS below.
+ *
+ * NOTE: this is a thin wrapper. Production hardening (retries, structured
+ * errors, signed URL refresh, queue mode for slow models) is intentionally
+ * deferred until after the agent tool layer is wired and we have eval data.
+ */
+const FAL_MODEL_ENDPOINTS = {
+    "fal-flux-1.1-pro": "https://fal.run/fal-ai/flux-pro/v1.1",
+    "fal-flux-1.1-pro-ultra": "https://fal.run/fal-ai/flux-pro/v1.1-ultra",
+    "fal-flux-schnell": "https://fal.run/fal-ai/flux/schnell",
+};
+class FalImageProviderService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super(...arguments);
+        this.apiKey = process.env.FAL_API_KEY;
+    }
+    async generateImage(params) {
+        if (!this.apiKey) {
+            throw new Error("FAL_API_KEY not set — fal image provider cannot generate");
+        }
+        const endpoint = FAL_MODEL_ENDPOINTS[params.modelKey];
+        if (!endpoint) {
+            throw new Error(`Unknown fal model key: ${params.modelKey}`);
+        }
+        const payload = {
+            prompt: params.prompt,
+            image_size: this.mapAspectToImageSize(params.dimensions, params.aspectRatio),
+        };
+        const headers = {
+            Authorization: `Key ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        if (params.idempotencyKey) {
+            headers["X-Fal-Idempotency-Key"] = params.idempotencyKey;
+        }
+        const { data } = await axios_1.default.post(endpoint, payload, {
+            headers,
+            timeout: 60000,
+        });
+        const first = data.images?.[0];
+        if (!first?.url) {
+            throw new Error("fal returned no image");
+        }
+        return {
+            imageUrl: first.url,
+            width: first.width,
+            height: first.height,
+            providerRequestId: data.request_id,
+        };
+    }
+    getCreditUsed(params) {
+        // Image-gen models live outside the existing video/text enum tables until
+        // the EImageGenModels enum is promoted to a real enum and registered in
+        // aiModelConfigs. Until then, key off the raw string.
+        const key = params.modelKey;
+        switch (key) {
+            case "fal-flux-1.1-pro-ultra":
+                return 6;
+            case "fal-flux-1.1-pro":
+                return 4;
+            case "fal-flux-schnell":
+                return 1;
+            default:
+                return 4;
+        }
+    }
+    mapAspectToImageSize(dimensions, aspectRatio) {
+        if (dimensions) {
+            const parts = dimensions.split("x").map((n) => parseInt(n, 10));
+            const w = parts[0];
+            const h = parts[1];
+            if (Number.isFinite(w) && Number.isFinite(h)) {
+                return { width: w, height: h };
+            }
+        }
+        switch (aspectRatio) {
+            case "9:16":
+                return "portrait_16_9";
+            case "16:9":
+                return "landscape_16_9";
+            case "4:5":
+                return "portrait_4_3";
+            case "1:1":
+            default:
+                return "square_hd";
+        }
+    }
+}
+exports.FalImageProviderService = FalImageProviderService;

package/lib/services/aiGen/providers/fal/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./falImage.service";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/aiGen/providers/fal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/fal/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/lib/services/aiGen/providers/fal/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./falImage.service"), exports);

package/lib/services/aiGen/providers/kling/cameraAdapter.d.ts

@@ -0,0 +1,4 @@
+import type { CameraControl as CanonicalCameraControl } from "../../canonicalAdapters/cameraControl.types";
+import type { CameraControl as KlingCameraControl } from "./types";
+export declare function toKlingCameraControl(c: CanonicalCameraControl): KlingCameraControl | undefined;
+//# sourceMappingURL=cameraAdapter.d.ts.map

package/lib/services/aiGen/providers/kling/cameraAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/cameraAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,IAAI,sBAAsB,EAExC,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAc,MAAM,SAAS,CAAC;AAgC/E,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,sBAAsB,GACxB,kBAAkB,GAAG,SAAS,CAsBhC"}

package/lib/services/aiGen/providers/kling/cameraAdapter.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toKlingCameraControl = toKlingCameraControl;
+/**
+ * Map canonical camera presets → Kling's small named-type vocabulary.
+ * Kling exposes only 5 named types (down_back, forward_up, right_turn_forward,
+ * left_turn_forward, simple); everything else falls through to "simple" + a
+ * synthesized vector that approximates the move.
+ */
+const PRESET_TO_KLING_TYPE = {
+    pull_out: "down_back",
+    push_in: "forward_up",
+    orbit_right: "right_turn_forward",
+    orbit_left: "left_turn_forward",
+};
+/** Synth a vector for presets that don't have a Kling named type. */
+const PRESET_TO_VECTOR = {
+    static: { horizontal: 0, vertical: 0, pan: 0, tilt: 0, roll: 0, zoom: 0 },
+    pan_left: { pan: -8 },
+    pan_right: { pan: 8 },
+    tilt_up: { tilt: 8 },
+    tilt_down: { tilt: -8 },
+    zoom_in: { zoom: 8 },
+    zoom_out: { zoom: -8 },
+    dolly_in: { vertical: 8 },
+    dolly_out: { vertical: -8 },
+    roll_left: { roll: -8 },
+    roll_right: { roll: 8 },
+    tracking: { horizontal: 6 },
+    handheld: { vertical: 2, horizontal: 2 },
+};
+function toKlingCameraControl(c) {
+    // Direct vector takes precedence — caller knows what they want.
+    if (c.vector) {
+        return { type: "simple", config: c.vector };
+    }
+    if (c.preset) {
+        const namedType = PRESET_TO_KLING_TYPE[c.preset];
+        if (namedType)
+            return { type: namedType };
+        const baseVec = PRESET_TO_VECTOR[c.preset];
+        if (baseVec) {
+            const intensity = Math.max(0, Math.min(1, c.intensity ?? 1));
+            const scaled = {};
+            for (const [k, v] of Object.entries(baseVec)) {
+                if (typeof v === "number")
+                    scaled[k] = Math.round(v * intensity * 10) / 10;
+            }
+            return { type: "simple", config: scaled };
+        }
+    }
+    return undefined;
+}

package/lib/services/aiGen/providers/pexels/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./pexels.service";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/aiGen/providers/pexels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pexels/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/lib/services/aiGen/providers/pexels/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pexels.service"), exports);

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

@@ -0,0 +1,11 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, StockSearchParams, StockSearchResult } from "../types";
+export declare class PexelsProviderService extends BaseAiGenProviderService {
+    private readonly apiKey;
+    searchStock(params: StockSearchParams): Promise<StockSearchResult>;
+    /** Free assets — registers as 0 credits regardless of model. */
+    getCreditUsed(_params: CreditUsageParams): number;
+    private aspectToOrientation;
+    private pickBestVideoFile;
+}
+//# sourceMappingURL=pexels.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pexels.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pexels/pexels.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAwDlB,qBAAa,qBAAsB,SAAQ,wBAAwB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IAEnE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuExE,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIjD,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,iBAAiB;CAY1B"}