vidspotai-shared 1.0.82-dev.0 → 1.0.83

package/lib/services/editor/planToProject.types.d.ts

@@ -0,0 +1,94 @@
+import type { Clip } from "../../schemas/project.schema";
+import type { VideoPlan } from "../../schemas/videoPlan.schema";
+/**
+ * Input/outcome types for planToProject. Kept separate from the translator so
+ * callers (executor host, regen handlers) can import the shapes without pulling
+ * the full builder.
+ */
+export interface SceneRenderOutcome {
+    /** Resolved URL for the scene's visual asset (image or video). */
+    visualUrl?: string;
+    /**
+     * AG-2 / L-4 extend chain. When a scene's visual was built as a source clip +
+     * N native extensions (too-long scene on an extend-capable model), the host's
+     * resolveExtendChain fills this with the sub-clips in render order. When
+     * present (length ≥ 2) planToProject lays them out as adjacent video clips
+     * spanning the scene's time window, which the renderer concatenates. A single
+     * resolved clip falls back to the `visualUrl` path.
+     */
+    clips?: Array<{
+        visualUrl: string;
+        durationSec: number;
+        taskId?: string;
+    }>;
+    /** Resolved URL for the scene's voiceover. */
+    voiceoverUrl?: string;
+    /**
+     * VO duration in ms used by planToProject to size the clip's display
+     * window. When set from a probed actual mp3 (preferred), reflects real
+     * playback length; when set from the wpm estimator it can undershoot
+     * emotive/punctuated lines by 400–900ms and the editor's Remotion Audio
+     * truncates at endAt. Caller should set the actual when available.
+     */
+    voiceoverDurationMs?: number;
+    /** Resolved URL for an external captions file (.vtt/.srt) if any. */
+    captionsUrl?: string;
+    /** Word-level caption timing (start/end ms within scene). */
+    captionWords?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    /** Final model key the executor landed on (may differ from preferredModel). */
+    modelKey?: string;
+    /** Provider chain walked, primary first; recorded in provenance. */
+    attemptedProviders?: string[];
+    /** P-UNS-2: stock attribution to record in clip provenance (Unsplash credit). */
+    attribution?: {
+        name: string;
+        url?: string;
+    };
+    /** Provider idempotency key (used for reuse on regen). */
+    generationId?: string;
+    /** Credits actually spent on this scene. */
+    creditsSpent?: number;
+    /** Content hash of the visual asset, when computed. */
+    assetHash?: string;
+}
+export interface PlanToProjectInput {
+    plan: VideoPlan;
+    outcomes?: Record<number, SceneRenderOutcome | undefined>;
+    projectId: string;
+    name?: string;
+    agentRunId?: string;
+    /** When set, overrides plan.music.url (caller can swap to CDN-hosted version). */
+    musicUrl?: string;
+    /** Music duration in ms; falls back to plan.music.durationSec*1000 if unset. */
+    musicDurationMs?: number;
+    /** Project createdAt; defaults to now. */
+    createdAt?: string;
+    /** Project updatedAt; defaults to now. */
+    updatedAt?: string;
+    /**
+     * Stage 7 (lock enforcement) — clips from the prior project that must be
+     * reproduced verbatim, displacing any freshly-built clip with the same id.
+     * Supply the output of `computePreservedClips(priorProject, allowedMutations)`.
+     * A locked/user-placed clip carries edits (trim, volume, text, position)
+     * that exist nowhere in the plan, so it cannot be rebuilt — only kept as-is.
+     * Empty / unset on a first run or when nothing is protected (a no-op).
+     */
+    preserveClips?: Clip[];
+    /**
+     * Gap #1 follow-up (skip-generation). Scene indices whose visual is frozen
+     * (preserved verbatim — see `preserveClips`). For these we DON'T build a
+     * placeholder visual clip from plan+outcome: the executor skipped generation
+     * so there's no real URL, and a placeholder twin would either be redundantly
+     * overridden (single-clip ids match) or — worse — leak a stray PLACEHOLDER
+     * clip when the preserved visual is an extend-chain (ids `-0`/`-1` don't
+     * match the rebuilt single `scene-N-visual`). Instead we skip the build and
+     * let the preserve-override inject the real clip(s), anchoring transitions on
+     * the preserved ids. Derive via `computeFrozenScenes(preserveClips).visual`.
+     */
+    frozenVisualScenes?: ReadonlySet<number>;
+}
+//# sourceMappingURL=planToProject.types.d.ts.map

package/lib/services/editor/planToProject.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planToProject.types.d.ts","sourceRoot":"","sources":["../../../src/services/editor/planToProject.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iFAAiF;IACjF,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC;IACvB;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C"}

package/lib/services/editor/planToProject.types.js

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

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

@@ -8,6 +8,7 @@ import { IImageJobModel } from "../models/image.model";
 import { INotificationModel } from "../models/notification.model";
 import { IRefModel } from "../models/ref.model";
 import { IMediaUploadModel } from "../models/mediaUpload.model";
+import { ISocialAccountModel, ISocialAnalyticsModel, ISocialInboxItemModel, ISocialPostModel } from "../models/social.model";
 import { IShareModel } from "../models/share.model";
 import { IUserModel } from "../models/user.model";
 import { IVideoJobModel } from "../models/video.model";
@@ -50,6 +51,10 @@ export declare class FirestoreService {
     static agentRunsCol: CollectionReference<IAgentRunModel, DocumentData>;
     static sharesCol: CollectionReference<IShareModel, DocumentData>;
     static mediaUploadsCol: CollectionReference<IMediaUploadModel, DocumentData>;
+    static socialAccountsCol: CollectionReference<ISocialAccountModel, DocumentData>;
+    static socialPostsCol: CollectionReference<ISocialPostModel, DocumentData>;
+    static socialAnalyticsCol: CollectionReference<ISocialAnalyticsModel, DocumentData>;
+    static socialInboxCol: CollectionReference<ISocialInboxItemModel, DocumentData>;
     /** Add new document with generated ID */
     static appendNewRecord<T>(collectionRef: CollectionReference<T>, data: T): Promise<DocumentReference<T>>;
     /** Add or overwrite a document with a specific ID */

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

@@ -1 +1 @@
-{"version":3,"file":"firestore.service.d.ts","sourceRoot":"","sources":["../../src/services/firestore.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAEhB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD;;;;GAIG;AACH,qBAAa,gBAAgB;IAE3B,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,gBAAgB,wDAEqC;IAE5D,MAAM,CAAC,OAAO,+CAEqC;IAEnD,MAAM,CAAC,QAAQ,gDAEqC;IAEpD,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;qBAEqC;IAEtD,MAAM,CAAC,aAAa,uDAEuC;IAE3D,MAAM,CAAC,gBAAgB,0DAEuC;IAE9D,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,cAAc,uDAEsC;IAE3D,MAAM,CAAC,gBAAgB,wDAEqC;IAE5D,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,SAAS,iDAEqC;IAErD,MAAM,CAAC,eAAe,uDAEqC;IAI3D,yCAAyC;WAC5B,eAAe,CAAC,CAAC,EAC5B,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,qDAAqD;WACxC,OAAO,CAAC,CAAC,EACpB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,0CAA0C;WAC7B,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAKlC,kCAAkC;WACrB,WAAW,CAAC,CAAC,EACxB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAO5C,+BAA+B;WAClB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrE,+CAA+C;WAClC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAS3E,gCAAgC;WACnB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACnD,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QAChC,cAAc,CAAC,EAAE,gBAAgB,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAsBlC,8CAA8C;WACjC,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAwB,GACrD,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,MAAM,CAAC,aAAa;IA2B5B,0CAA0C;WAC7B,cAAc,CACzB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAIhB,sBAAsB;WACT,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC;IAKhB,kCAAkC;WACrB,cAAc,CAAC,CAAC,EAC3B,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC;CAGd"}
+{"version":3,"file":"firestore.service.d.ts","sourceRoot":"","sources":["../../src/services/firestore.service.ts"],"names":[],"mappings":"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"}

package/lib/services/firestore.service.js

@@ -156,3 +156,16 @@ FirestoreService.sharesCol = firebase_1.firestore
 FirestoreService.mediaUploadsCol = firebase_1.firestore
     .collection("mediaUploads")
     .withConverter(collectionConverter());
+// 🔹 X8 Social Suite — see notes/SOCIAL_SUITE_PLAN.md
+FirestoreService.socialAccountsCol = firebase_1.firestore
+    .collection("socialAccounts")
+    .withConverter(collectionConverter());
+FirestoreService.socialPostsCol = firebase_1.firestore
+    .collection("socialPosts")
+    .withConverter(collectionConverter());
+FirestoreService.socialAnalyticsCol = firebase_1.firestore
+    .collection("socialAnalytics")
+    .withConverter(collectionConverter());
+FirestoreService.socialInboxCol = firebase_1.firestore
+    .collection("socialInbox")
+    .withConverter(collectionConverter());

package/lib/services/index.d.ts

@@ -10,13 +10,26 @@ export * from "./notification.service";
 export * from "./credits/pricing";
 export * from "./analytics.service";
 export * from "./tts";
+export * from "./translation";
 export * from "./musicGen";
 export * from "./audioAnalysis";
 export * from "./asr";
 export * from "./agent";
+export * from "./promptEnhancer";
 export * from "./assetCache.service";
 export * from "./apiUsageCounter.service";
 export * from "./editor/designToProject";
 export * from "./editor/projectToDesign";
 export * from "./editor/planToProject";
+export * from "./editor/captionStyleHint";
+export * from "./stock";
+export * from "./crypto";
+export * from "./socialOAuth";
+export * from "./socialPublish";
+export * from "./socialMetrics";
+export * from "./socialEngage";
+export * from "./socialFormat";
+export * from "./socialAI";
+export * from "./socialInsights";
+export * from "./socialAccounts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/lib/services/index.js

@@ -26,12 +26,25 @@ __exportStar(require("./notification.service"), exports);
 __exportStar(require("./credits/pricing"), exports);
 __exportStar(require("./analytics.service"), exports);
 __exportStar(require("./tts"), exports);
+__exportStar(require("./translation"), exports);
 __exportStar(require("./musicGen"), exports);
 __exportStar(require("./audioAnalysis"), exports);
 __exportStar(require("./asr"), exports);
 __exportStar(require("./agent"), exports);
+__exportStar(require("./promptEnhancer"), exports);
 __exportStar(require("./assetCache.service"), exports);
 __exportStar(require("./apiUsageCounter.service"), exports);
 __exportStar(require("./editor/designToProject"), exports);
 __exportStar(require("./editor/projectToDesign"), exports);
 __exportStar(require("./editor/planToProject"), exports);
+__exportStar(require("./editor/captionStyleHint"), exports);
+__exportStar(require("./stock"), exports);
+__exportStar(require("./crypto"), exports);
+__exportStar(require("./socialOAuth"), exports);
+__exportStar(require("./socialPublish"), exports);
+__exportStar(require("./socialMetrics"), exports);
+__exportStar(require("./socialEngage"), exports);
+__exportStar(require("./socialFormat"), exports);
+__exportStar(require("./socialAI"), exports);
+__exportStar(require("./socialInsights"), exports);
+__exportStar(require("./socialAccounts"), exports);

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

@@ -0,0 +1,18 @@
+/**
+ * Modular Prompt Enhancer.
+ *
+ * Rewrites a user's raw prompt into a richer, production-grade prompt for a
+ * downstream generative model — preserving everything the user asked for and
+ * only adding craft where they were silent. Target-aware (video / image /
+ * avatar / agent) via per-target profiles, sharing one engine and the agent's
+ * LLM infrastructure.
+ *
+ * Step 1 ships the enhancer itself; wiring it into the individual pipelines is
+ * a separate, later step.
+ */
+export * from "./types";
+export * from "./schema";
+export * from "./models";
+export * from "./profiles";
+export * from "./promptEnhancer.service";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/promptEnhancer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC"}

package/lib/services/promptEnhancer/index.js

@@ -0,0 +1,33 @@
+"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 });
+/**
+ * Modular Prompt Enhancer.
+ *
+ * Rewrites a user's raw prompt into a richer, production-grade prompt for a
+ * downstream generative model — preserving everything the user asked for and
+ * only adding craft where they were silent. Target-aware (video / image /
+ * avatar / agent) via per-target profiles, sharing one engine and the agent's
+ * LLM infrastructure.
+ *
+ * Step 1 ships the enhancer itself; wiring it into the individual pipelines is
+ * a separate, later step.
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./profiles"), exports);
+__exportStar(require("./promptEnhancer.service"), exports);

package/lib/services/promptEnhancer/models.d.ts

@@ -0,0 +1,54 @@
+import { ModelChoice } from "../agent/modelRouter";
+/**
+ * Model selection for the Prompt Enhancer — deliberately INDEPENDENT of the
+ * agent's role-based ModelRouter.
+ *
+ * The enhancer is a cross-pipeline, single-call task with its own quality/speed
+ * balance, so it should not inherit the "planner" role's model (that model is
+ * tuned for heavyweight VideoPlan generation). Keeping a dedicated policy here
+ * means we can retune the enhancer without perturbing planner/critic routing,
+ * and vice versa.
+ *
+ * Every model below is registered in MODEL_CAPABILITIES and dispatchable by the
+ * native ProviderRoutingLlmCaller (anthropic / openai / google) — see
+ * llmModelRegistry.ts. The gateway has been deprecated (LLM_NATIVE_MIGRATION_PLAN
+ * Phase 5), so a model whose provider has no native caller would throw at
+ * dispatch time. Models picked from the latest frontier tiers (2026-06).
+ */
+export interface EnhancerModelPolicy {
+    /** Default model — optimised for the speed/cost/quality balance. */
+    primary: ModelChoice;
+    /** Cross-provider fallback when the primary exhausts transient retries. */
+    fallback?: ModelChoice;
+    /** Used when `EnhanceOptions.premium` is set — top quality. */
+    premium: ModelChoice;
+    /** Cross-provider fallback for the premium model. */
+    premiumFallback?: ModelChoice;
+}
+/**
+ * Default policy (latest frontier tiers, chosen for this task after comparing
+ * the registry's quality/speed/cost guidance):
+ *
+ * primary = gemini-3.5-flash (Q4/S4, $1.5/$9): current frontier Flash, beats
+ *   3.1 Pro on agentic benches, strong vision (good for reference-image
+ *   prompts), 1M ctx. The right balance for a critical-path call — fast and
+ *   cheap without the Q3 quality of the older 2.5-flash. Its only weakness vs
+ *   the Q5 tier — strict adherence to many simultaneous constraints — is
+ *   covered by the schema's enumerate-then-honour preservation guard.
+ *
+ * premium = claude-sonnet-4-6 (Q4/S4, $3/$15): a strong, well-balanced quality
+ *   lift over the Flash primary — excellent cinematic prose + reliable
+ *   preservation — without the cost/latency of the Q5 Opus tier (overkill for
+ *   prompt rewriting). Opt in (premium:true) for high-value jobs; the video
+ *   pipeline can pass it since video prompts are the most demanding downstream.
+ *
+ * fallbacks are cross-provider so a single provider's rate-limit/outage degrades
+ * gracefully: flash(google)→gpt-5.4-mini(openai); sonnet(anthropic)→3.1-pro(google).
+ */
+export declare const DEFAULT_ENHANCER_MODELS: EnhancerModelPolicy;
+/** Resolve the (primary, fallback) pair for a call, honouring the premium flag. */
+export declare function pickEnhancerModel(policy: EnhancerModelPolicy, premium?: boolean): {
+    model: ModelChoice;
+    fallbackModel?: ModelChoice;
+};
+//# sourceMappingURL=models.d.ts.map

package/lib/services/promptEnhancer/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/services/promptEnhancer/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,OAAO,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,+DAA+D;IAC/D,OAAO,EAAE,WAAW,CAAC;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,uBAAuB,EAAE,mBAKrC,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,OAAO,GAChB;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,aAAa,CAAC,EAAE,WAAW,CAAA;CAAE,CAKrD"}

package/lib/services/promptEnhancer/models.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ENHANCER_MODELS = void 0;
+exports.pickEnhancerModel = pickEnhancerModel;
+/**
+ * Default policy (latest frontier tiers, chosen for this task after comparing
+ * the registry's quality/speed/cost guidance):
+ *
+ * primary = gemini-3.5-flash (Q4/S4, $1.5/$9): current frontier Flash, beats
+ *   3.1 Pro on agentic benches, strong vision (good for reference-image
+ *   prompts), 1M ctx. The right balance for a critical-path call — fast and
+ *   cheap without the Q3 quality of the older 2.5-flash. Its only weakness vs
+ *   the Q5 tier — strict adherence to many simultaneous constraints — is
+ *   covered by the schema's enumerate-then-honour preservation guard.
+ *
+ * premium = claude-sonnet-4-6 (Q4/S4, $3/$15): a strong, well-balanced quality
+ *   lift over the Flash primary — excellent cinematic prose + reliable
+ *   preservation — without the cost/latency of the Q5 Opus tier (overkill for
+ *   prompt rewriting). Opt in (premium:true) for high-value jobs; the video
+ *   pipeline can pass it since video prompts are the most demanding downstream.
+ *
+ * fallbacks are cross-provider so a single provider's rate-limit/outage degrades
+ * gracefully: flash(google)→gpt-5.4-mini(openai); sonnet(anthropic)→3.1-pro(google).
+ */
+exports.DEFAULT_ENHANCER_MODELS = {
+    primary: { modelId: "gemini-3.5-flash", provider: "google", vision: true },
+    fallback: { modelId: "gpt-5.4-mini", provider: "openai", vision: true },
+    premium: { modelId: "claude-sonnet-4-6", provider: "anthropic", vision: true },
+    premiumFallback: { modelId: "gemini-3.1-pro", provider: "google", vision: true },
+};
+/** Resolve the (primary, fallback) pair for a call, honouring the premium flag. */
+function pickEnhancerModel(policy, premium) {
+    if (premium) {
+        return { model: policy.premium, fallbackModel: policy.premiumFallback };
+    }
+    return { model: policy.primary, fallbackModel: policy.fallback };
+}

package/lib/services/promptEnhancer/profiles/agent.profile.d.ts

@@ -0,0 +1,14 @@
+import { EnhancerProfile } from "./base";
+/**
+ * AGENT profile — creative-brief clarifier.
+ *
+ * The agent pipeline already has a Planner that decomposes a brief into scenes
+ * (with per-scene prompts, tiers, models, overlays, etc.). So the enhancer's
+ * job here is NOT to write shots — that would fight the Planner. It is to take
+ * a thin one-liner and turn it into a sharp, complete CREATIVE BRIEF the
+ * Planner can plan well from: clear concept, intended outcome, audience, tone,
+ * a high-level arc, and must-include elements. Think "better brief", not
+ * "storyboard".
+ */
+export declare const AGENT_PROFILE: EnhancerProfile;
+//# sourceMappingURL=agent.profile.d.ts.map

package/lib/services/promptEnhancer/profiles/agent.profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.profile.d.ts","sourceRoot":"","sources":["../../../../src/services/promptEnhancer/profiles/agent.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,eAyB3B,CAAC"}

package/lib/services/promptEnhancer/profiles/agent.profile.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_PROFILE = void 0;
+/**
+ * AGENT profile — creative-brief clarifier.
+ *
+ * The agent pipeline already has a Planner that decomposes a brief into scenes
+ * (with per-scene prompts, tiers, models, overlays, etc.). So the enhancer's
+ * job here is NOT to write shots — that would fight the Planner. It is to take
+ * a thin one-liner and turn it into a sharp, complete CREATIVE BRIEF the
+ * Planner can plan well from: clear concept, intended outcome, audience, tone,
+ * a high-level arc, and must-include elements. Think "better brief", not
+ * "storyboard".
+ */
+exports.AGENT_PROFILE = {
+    target: "agent",
+    defaultTemperature: 0.5,
+    defaultMaxTokens: 900,
+    systemPrompt: [
+        "MEDIUM: a creative brief for an autonomous video-planning agent. A downstream Planner will",
+        "break your brief into scenes, pick models, and write per-scene prompts — so DO NOT write a",
+        "shot list, timestamps, or per-scene prompts. Produce a sharper, more complete BRIEF.",
+        "",
+        "Expand a thin request into a brief that covers, in fluent prose:",
+        "- CORE CONCEPT: the single idea the video communicates, stated crisply.",
+        "- OUTCOME / GOAL: what it should make the viewer feel or do (sell, teach, entertain, convert).",
+        "- AUDIENCE: who it is for, if inferable.",
+        "- TONE & STYLE: the mood and visual register (honour the user's words; suggest a fit if silent).",
+        "- HIGH-LEVEL ARC: hook → development → payoff/CTA, described at the level of intent, not shots.",
+        "- MUST-INCLUDE: any specific elements, products, names, or facts the user named — preserved",
+        "  exactly.",
+        "",
+        "RULES:",
+        "- Preserve the user's stated goal and every concrete element; only fill gaps (audience, tone,",
+        "  arc) where they were silent.",
+        "- Do not over-specify: leave room for the Planner to make scene-level decisions.",
+        "- Do not invent products, brands, claims, or facts the user didn't provide.",
+        "- Keep it a brief — a tight paragraph or two, not a screenplay.",
+    ].join("\n"),
+};

package/lib/services/promptEnhancer/profiles/avatar.profile.d.ts

@@ -0,0 +1,13 @@
+import { EnhancerProfile } from "./base";
+/**
+ * AVATAR profile — talking-head performance hints.
+ *
+ * The avatar pipeline animates a FIXED portrait image driven by FIXED audio
+ * (TTS or uploaded). The prompt is a small performance/motion directive, not a
+ * scene. The classic failure mode is treating it like a video prompt: inventing
+ * cuts, camera moves through space, new environments, or extra characters —
+ * all of which fight the lip-sync model and corrupt identity. So this profile
+ * is deliberately narrow: expression, micro-gesture, gaze, and delivery only.
+ */
+export declare const AVATAR_PROFILE: EnhancerProfile;
+//# sourceMappingURL=avatar.profile.d.ts.map

package/lib/services/promptEnhancer/profiles/avatar.profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.profile.d.ts","sourceRoot":"","sources":["../../../../src/services/promptEnhancer/profiles/avatar.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,eA0B5B,CAAC"}

package/lib/services/promptEnhancer/profiles/avatar.profile.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVATAR_PROFILE = void 0;
+/**
+ * AVATAR profile — talking-head performance hints.
+ *
+ * The avatar pipeline animates a FIXED portrait image driven by FIXED audio
+ * (TTS or uploaded). The prompt is a small performance/motion directive, not a
+ * scene. The classic failure mode is treating it like a video prompt: inventing
+ * cuts, camera moves through space, new environments, or extra characters —
+ * all of which fight the lip-sync model and corrupt identity. So this profile
+ * is deliberately narrow: expression, micro-gesture, gaze, and delivery only.
+ */
+exports.AVATAR_PROFILE = {
+    target: "avatar",
+    defaultTemperature: 0.4,
+    defaultMaxTokens: 600,
+    systemPrompt: [
+        "MEDIUM: talking-head avatar. A single fixed portrait is animated to speak fixed audio. Your",
+        "prompt is a SHORT performance directive for that one person — how they deliver the line — not",
+        "a scene description.",
+        "",
+        "Describe only:",
+        "- EXPRESSION & EMOTION: the felt emotional tone of the delivery (warm, urgent, reassuring,",
+        "  excited) and how it reads on the face.",
+        "- MICRO-MOVEMENT: natural head tilts and nods, eyebrow motion, blinks, subtle shoulder shift,",
+        "  hand gestures only if framing clearly includes the hands. Keep it lifelike and restrained.",
+        "- GAZE: eye contact with camera vs. natural glances; steadiness.",
+        "- ENERGY & PACING: how animated the delivery is, matched to the spoken content's tone.",
+        "- FRAMING STABILITY: keep the framing and background as-is and steady.",
+        "",
+        "HARD CONSTRAINTS — these protect the lip-sync and identity:",
+        "- Do NOT change the person's identity, face, hair, age, clothing, or the background. The",
+        "  portrait is fixed.",
+        "- Do NOT invent scene cuts, camera moves through space, new locations, props, or other people.",
+        "- Do NOT write any audio, dialogue, or voiceover — the audio is already provided and fixed.",
+        "- Keep it concise (a few sentences). Over-direction degrades the result.",
+        "- Preserve any delivery/emotion notes the user gave, and any reference-image binding.",
+    ].join("\n"),
+};

package/lib/services/promptEnhancer/profiles/base.d.ts

@@ -0,0 +1,28 @@
+import { EnhanceTarget } from "../types";
+/**
+ * A target profile = the knowledge of what a "great" prompt looks like for one
+ * generative medium, plus its default sampling knobs. Model selection is
+ * handled centrally by the enhancer's own policy (models.ts), NOT per profile,
+ * so the quality/speed balance is tuned in one place. The engine composes
+ * BASE_PRESERVATION_CONTRACT + profile.systemPrompt to form the system message,
+ * so each profile only carries the medium-specific rules.
+ */
+export interface EnhancerProfile {
+    target: EnhanceTarget;
+    /** Default sampling temperature. Lower = more faithful to the user, higher = more inventive. */
+    defaultTemperature: number;
+    /** Default max output tokens. */
+    defaultMaxTokens: number;
+    /**
+     * The medium-specific system prompt: the structure, vocabulary, and rules
+     * that define a production-grade prompt for this target. Prepended with the
+     * universal BASE_PRESERVATION_CONTRACT by the engine.
+     */
+    systemPrompt: string;
+}
+/**
+ * The universal contract every profile inherits. This is the heart of the
+ * feature: enhance ON TOP of the user's requirements, never instead of them.
+ */
+export declare const BASE_PRESERVATION_CONTRACT: string;
+//# sourceMappingURL=base.d.ts.map

package/lib/services/promptEnhancer/profiles/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/services/promptEnhancer/profiles/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,gGAAgG;IAChG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QA2B3B,CAAC"}

package/lib/services/promptEnhancer/profiles/base.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_PRESERVATION_CONTRACT = void 0;
+/**
+ * The universal contract every profile inherits. This is the heart of the
+ * feature: enhance ON TOP of the user's requirements, never instead of them.
+ */
+exports.BASE_PRESERVATION_CONTRACT = [
+    "You are VidSpot's Prompt Enhancer — an expert prompt engineer for generative-media models.",
+    "You take a user's raw prompt and rewrite it into a richer, production-grade prompt that",
+    "produces the highest-quality result, WITHOUT changing what the user actually wants.",
+    "",
+    "THE PRESERVATION CONTRACT — non-negotiable, overrides every other instruction:",
+    "1. The user's prompt is the source of truth. Preserve every requirement they stated or clearly",
+    "   implied: subjects, named entities, actions and events, the order things happen in, style and",
+    "   mood words they chose, brand names, numbers (durations, counts, timestamps), reference-image",
+    "   bindings (e.g. '@image 2', 'Person A'), aspect ratio, and explicit exclusions ('no music',",
+    "   'no ground'). These survive verbatim in meaning.",
+    "2. You only ADD where the user was silent or vague. Fill those gaps with craft — but never",
+    "   invent a constraint the user didn't ask for (do not add a specific brand, logo, named",
+    "   location, on-screen text, or character that wasn't requested or implied).",
+    "3. Never 'improve' a choice the user already made. If they said 'teal grade' or 'handheld', keep",
+    "   it exactly — do not swap it for something you think is better.",
+    "4. Do not contradict the user. If an addition would clash with a stated requirement, drop the",
+    "   addition. The user always wins.",
+    "5. Match the user's register and scope. A short, simple request gets tasteful enhancement, not a",
+    "   wall of unrelated cinematic jargon. Do not pad. Every added detail must earn its place by",
+    "   improving the generated result.",
+    "6. Write in the medium's idiom (defined below). Output the prompt text only — no preamble, no",
+    "   markdown headings unless the medium's format calls for them, no meta-commentary.",
+    "",
+    "Be concrete: prefer specific nouns and physically grounded description over vague adjectives",
+    "('a low tungsten key light raking across her face' beats 'nice lighting'). Grounded, coherent",
+    "detail is what lifts generation quality.",
+].join("\n");

package/lib/services/promptEnhancer/profiles/image.profile.d.ts

@@ -0,0 +1,11 @@
+import { EnhancerProfile } from "./base";
+/**
+ * IMAGE profile — single still-frame prompts.
+ *
+ * Crucially NOT a video prompt: no motion, no temporal beats, no shot
+ * breakdown, no audio. A still lives or dies on composition, light, lens, and
+ * material detail. We carry over the reference-image binding discipline (image
+ * gen often uses character/style refs) but everything else is frame-craft.
+ */
+export declare const IMAGE_PROFILE: EnhancerProfile;
+//# sourceMappingURL=image.profile.d.ts.map

package/lib/services/promptEnhancer/profiles/image.profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.profile.d.ts","sourceRoot":"","sources":["../../../../src/services/promptEnhancer/profiles/image.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,eA8B3B,CAAC"}

package/lib/services/promptEnhancer/profiles/image.profile.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGE_PROFILE = void 0;
+/**
+ * IMAGE profile — single still-frame prompts.
+ *
+ * Crucially NOT a video prompt: no motion, no temporal beats, no shot
+ * breakdown, no audio. A still lives or dies on composition, light, lens, and
+ * material detail. We carry over the reference-image binding discipline (image
+ * gen often uses character/style refs) but everything else is frame-craft.
+ */
+exports.IMAGE_PROFILE = {
+    target: "image",
+    defaultTemperature: 0.5,
+    defaultMaxTokens: 1200,
+    systemPrompt: [
+        "MEDIUM: text-to-image. The model renders ONE still frame. There is no motion, no time, and no",
+        "sound — never write camera moves, beats, timestamps, or audio. Pour all the detail into the",
+        "single frame.",
+        "",
+        "Describe, weaving these dimensions into fluent prose (not headed sections):",
+        "- SUBJECT: the focal subject(s) with specific, distinctive detail. Preserve reference-image",
+        "  bindings exactly (e.g. 'the woman from @image 1').",
+        "- COMPOSITION & FRAMING: shot size (extreme close-up … wide), angle, lens (e.g. '85mm',",
+        "  'wide 24mm'), depth of field, where the subject sits in the frame, rule-of-thirds / symmetry.",
+        "- LIGHTING: direction and quality (soft window light, hard rim, golden-hour backlight), key/",
+        "  fill/rim, color temperature, how light falls on surfaces and casts shadow.",
+        "- COLOR & GRADE: palette and mood grade the user chose, or a fitting one if they were silent.",
+        "- MATERIAL & TEXTURE DETAIL: skin, fabric, metal, surface micro-detail that reads as real.",
+        "- SETTING & BACKGROUND: environment and atmosphere, kept subordinate to the subject.",
+        "- RENDER QUALITY: realism level and finish (e.g. 'photorealistic, sharp focus, fine detail')",
+        "  — match the user's stated style; don't force photoreal onto an illustrative request.",
+        "- ASPECT RATIO: state it if known.",
+        "",
+        "RULES:",
+        "- Concrete and physical over vague adjectives. One coherent look; no contradictory styles.",
+        "- Do not add subjects, props, text, logos, or a brand the user didn't ask for.",
+        "- Keep the positive prompt clean — do not write negatives ('no blur'); the pipeline handles a",
+        "  separate negative prompt.",
+        "- If the user's prompt is already rich, enhance lightly and keep their phrasing.",
+    ].join("\n"),
+};