vidspotai-shared 1.0.82 → 1.0.84

package/lib/services/index.d.ts

@@ -15,9 +15,21 @@ 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,eAAe,CAAC;AAC9B,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

@@ -31,8 +31,20 @@ __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"),
+};

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

@@ -0,0 +1,12 @@
+import { EnhanceTarget } from "../types";
+import { EnhancerProfile } from "./base";
+export { EnhancerProfile, BASE_PRESERVATION_CONTRACT } from "./base";
+export { VIDEO_PROFILE } from "./video.profile";
+export { IMAGE_PROFILE } from "./image.profile";
+export { AVATAR_PROFILE } from "./avatar.profile";
+export { AGENT_PROFILE } from "./agent.profile";
+/** Registry of every target profile, keyed by target. */
+export declare const ENHANCER_PROFILES: Record<EnhanceTarget, EnhancerProfile>;
+/** Resolve the profile for a target. Throws on an unknown target. */
+export declare function getProfile(target: EnhanceTarget): EnhancerProfile;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/promptEnhancer/profiles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAMzC,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAKpE,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAMjE"}

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENHANCER_PROFILES = exports.AGENT_PROFILE = exports.AVATAR_PROFILE = exports.IMAGE_PROFILE = exports.VIDEO_PROFILE = exports.BASE_PRESERVATION_CONTRACT = void 0;
+exports.getProfile = getProfile;
+const video_profile_1 = require("./video.profile");
+const image_profile_1 = require("./image.profile");
+const avatar_profile_1 = require("./avatar.profile");
+const agent_profile_1 = require("./agent.profile");
+var base_1 = require("./base");
+Object.defineProperty(exports, "BASE_PRESERVATION_CONTRACT", { enumerable: true, get: function () { return base_1.BASE_PRESERVATION_CONTRACT; } });
+var video_profile_2 = require("./video.profile");
+Object.defineProperty(exports, "VIDEO_PROFILE", { enumerable: true, get: function () { return video_profile_2.VIDEO_PROFILE; } });
+var image_profile_2 = require("./image.profile");
+Object.defineProperty(exports, "IMAGE_PROFILE", { enumerable: true, get: function () { return image_profile_2.IMAGE_PROFILE; } });
+var avatar_profile_2 = require("./avatar.profile");
+Object.defineProperty(exports, "AVATAR_PROFILE", { enumerable: true, get: function () { return avatar_profile_2.AVATAR_PROFILE; } });
+var agent_profile_2 = require("./agent.profile");
+Object.defineProperty(exports, "AGENT_PROFILE", { enumerable: true, get: function () { return agent_profile_2.AGENT_PROFILE; } });
+/** Registry of every target profile, keyed by target. */
+exports.ENHANCER_PROFILES = {
+    video: video_profile_1.VIDEO_PROFILE,
+    image: image_profile_1.IMAGE_PROFILE,
+    avatar: avatar_profile_1.AVATAR_PROFILE,
+    agent: agent_profile_1.AGENT_PROFILE,
+};
+/** Resolve the profile for a target. Throws on an unknown target. */
+function getProfile(target) {
+    const profile = exports.ENHANCER_PROFILES[target];
+    if (!profile) {
+        throw new Error(`[promptEnhancer] no profile registered for target "${target}"`);
+    }
+    return profile;
+}

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

@@ -0,0 +1,15 @@
+import { EnhancerProfile } from "./base";
+/**
+ * VIDEO profile — cinematic text-to-video / image-to-video prompts.
+ *
+ * The structure below is distilled from a set of gold-standard production
+ * prompts (aerial dogfight, Brooklyn tsunami, neutron-star flyby, Nike golf
+ * commercial). Those share a recognisable anatomy: a Style&Mood header, named
+ * subjects with stable descriptors + reference-image bindings, a Dynamic
+ * description of the action, a Static description of the unchanging set, a
+ * shot/timestamp breakdown, and explicit native-audio design. We teach that
+ * anatomy here so a sparse user prompt comes out at that level — without ever
+ * overriding what the user already specified.
+ */
+export declare const VIDEO_PROFILE: EnhancerProfile;
+//# sourceMappingURL=video.profile.d.ts.map

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

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

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

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIDEO_PROFILE = void 0;
+/**
+ * VIDEO profile — cinematic text-to-video / image-to-video prompts.
+ *
+ * The structure below is distilled from a set of gold-standard production
+ * prompts (aerial dogfight, Brooklyn tsunami, neutron-star flyby, Nike golf
+ * commercial). Those share a recognisable anatomy: a Style&Mood header, named
+ * subjects with stable descriptors + reference-image bindings, a Dynamic
+ * description of the action, a Static description of the unchanging set, a
+ * shot/timestamp breakdown, and explicit native-audio design. We teach that
+ * anatomy here so a sparse user prompt comes out at that level — without ever
+ * overriding what the user already specified.
+ */
+exports.VIDEO_PROFILE = {
+    target: "video",
+    defaultTemperature: 0.45,
+    defaultMaxTokens: 2200,
+    systemPrompt: [
+        "MEDIUM: text-to-video / image-to-video. The model generates a moving shot (or short",
+        "sequence of shots) from your prompt. It cannot read your mind about camera, light, lens, or",
+        "sound — so describe them. Quality comes from concrete, physically coherent cinematic detail.",
+        "",
+        "Compose the enhanced prompt using these sections, in this order. Include a section only when",
+        "it adds value; never output an empty heading. Use the user's own content to fill them and add",
+        "craft where they were silent.",
+        "",
+        "1. STYLE & MOOD — lead with it. Name the medium and realism level (e.g. 'photoreal cinematic',",
+        "   'stylised 2D'), the color grade / palette, the camera + lens + film-stock feel (e.g. 'ARRI",
+        "   ALEXA, 35mm, filmic grain'), the overall mood, and continuity (how many shots / cuts, or",
+        "   'one continuous handheld take'). Keep the user's chosen look if they gave one.",
+        "",
+        "2. SUBJECTS — define each recurring subject ONCE with stable, distinctive descriptors so the",
+        "   model keeps them consistent across the shot. When the user supplied reference images, bind",
+        "   each subject to its token exactly as given (e.g. 'PILOT: face exactly from @image 3'). When",
+        "   two subjects could be confused, add a disambiguator ('never confuse the two planes').",
+        "",
+        "3. DYNAMIC DESCRIPTION — the action as it unfolds: what moves, what changes, and the camera",
+        "   language driving it (locked-off, slow push-in, whip-pan, tracking, handheld micro-shake,",
+        "   focus hunt, banking). Keep the user's described events and their ORDER intact; render them",
+        "   in vivid, physically plausible motion.",
+        "",
+        "4. STATIC DESCRIPTION — the unchanging environment / set: location, time of day, weather,",
+        "   light direction, atmosphere. Include explicit exclusions when they matter ('no ground",
+        "   visible', 'only these two subjects exist in this space').",
+        "",
+        "5. SHOT / TIME BREAKDOWN — when the duration warrants more than one beat, break it into",
+        "   timestamped segments ('00:00–00:03 …') or numbered shots ('Shot 1 …'), each stating camera",
+        "   + subject + action. Budget the number of beats to the duration: roughly one distinct beat",
+        "   per 2–4 seconds; do not over-cut a short clip. Respect any cut count the user specified.",
+        "",
+        "6. NATIVE AUDIO — describe the diegetic sound design (impacts, ambience, foley, dialogue",
+        "   energy) or state 'No music.' if the user asked for none. Honour the user's audio wishes",
+        "   exactly. Omit this section entirely for silent / audio-less models.",
+        "",
+        "7. ASPECT RATIO — state it if known (e.g. '2.39:1', '9:16').",
+        "",
+        "RULES OF THE CRAFT:",
+        "- Concrete nouns over adjectives; describe light physically (key/fill/rim, color temperature,",
+        "  how it interacts with surfaces).",
+        "- One coherent world: do not stack contradictory styles or add subjects/props the user didn't",
+        "  ask for.",
+        "- Preserve every reference-image token and the role it was bound to. Never reassign a token.",
+        "- If the user's prompt is already detailed and well-structured, enhance lightly and keep their",
+        "  structure — do not rewrite a strong prompt into your template for its own sake.",
+        "",
+        "SHAPE OF A GREAT RESULT (illustrative — a sparse input lifted to production grade):",
+        "  User: 'a knight fights a dragon in a castle'",
+        "  Enhanced (abridged): 'Style & Mood: photoreal dark-fantasy cinematic, ARRI-style, cold",
+        "  steel-blue grade with ember-orange firelight, anamorphic 2.39:1, handheld with controlled",
+        "  micro-shake. SUBJECT — KNIGHT: battered plate armor, dented helm, longsword. SUBJECT —",
+        "  DRAGON: 12m wingspan, charcoal scales, molten throat-glow. Dynamic: low tracking shot as the",
+        "  knight charges across the courtyard, the dragon rears and unleashes a fire breath, the knight",
+        "  rolls behind a stone pillar that scorches black, then drives the sword up into the dragon's",
+        "  jaw. Static: ruined torch-lit castle courtyard at night, smoke and floating embers, rain",
+        "  catching the firelight. Native audio: roar, sword scrape, fire whoosh, rain, no music.'",
+        "  — note how every user element (knight, dragon, castle, fight) is preserved and only the",
+        "  silent gaps (grade, lens, light, camera, audio) were filled.",
+    ].join("\n"),
+};