vidspotai-shared 1.0.82-dev.0 → 1.0.83

package/lib/services/agent/executor/voice.d.ts

@@ -0,0 +1,17 @@
+import { VoiceStyle } from "../../../schemas/brief.schema";
+export declare function sanitizeVoiceId(voiceId: string | undefined): string | undefined;
+/**
+ * AG-31: map a brief-level voice style adjective to ElevenLabs voice_settings.
+ * `style` is the exaggeration param (use sparingly above 0.5 — artifacts);
+ * `stability` is the consistency knob (low = more emotive, high = monotone);
+ * `speed` is rate (0.7-1.2). Defaults match ElevenLabs' own (style=0,
+ * stability=0.5, speed=1.0). Tuning per persona is conservative — we'd rather
+ * be slightly flat than artifact-laden.
+ */
+export declare function resolveVoiceSettings(style: VoiceStyle | undefined): {
+    style?: number;
+    stability?: number;
+    speed?: number;
+};
+export declare function normalizeVoiceStyle(raw: string | undefined): VoiceStyle | undefined;
+//# sourceMappingURL=voice.d.ts.map

package/lib/services/agent/executor/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/executor/voice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAkB3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBxD;AAgDD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,UAAU,GAAG,SAAS,CAKxB"}

package/lib/services/agent/executor/voice.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeVoiceId = sanitizeVoiceId;
+exports.resolveVoiceSettings = resolveVoiceSettings;
+exports.normalizeVoiceStyle = normalizeVoiceStyle;
+const voices_1 = require("../../../globals/ttsModels/voices");
+const logger_1 = require("../../../utils/logger");
+/**
+ * Voice resolution helpers for the executor's TTS step: strip hallucinated
+ * voice IDs, map a (normalized) voice-style adjective onto ElevenLabs
+ * voice_settings, and canonicalise freeform style synonyms.
+ */
+/**
+ * AG-37: planners (LLMs) keep inventing voice IDs like "female-young-adult-en"
+ * or "narrator-1" that look reasonable but don't exist in any catalog. When
+ * those flow into ElevenLabs the API returns a 400 and the silent-fail VO
+ * outcome path drops the VO entirely — final video ships muted. Strip
+ * unknown IDs here so the provider falls back to its default voice instead.
+ */
+const ELEVENLABS_VOICE_IDS = new Set(voices_1.ELEVENLABS_VOICES.map((v) => v.id));
+function sanitizeVoiceId(voiceId) {
+    if (!voiceId)
+        return undefined;
+    if (ELEVENLABS_VOICE_IDS.has(voiceId))
+        return voiceId;
+    // Heuristic for non-ElevenLabs providers (openai = "alloy"/"echo"/..., minimax = "male-qn-qingse").
+    // Only strip strings that look like LLM-invented descriptive labels (contain a hyphen + recognisable word).
+    if (/^(female|male|narrator|presenter|voice)[-_]/i.test(voiceId)) {
+        logger_1.logger.warn("executor: stripping invalid voiceId (LLM hallucination)", { voiceId });
+        return undefined;
+    }
+    return voiceId;
+}
+/**
+ * AG-31: map a brief-level voice style adjective to ElevenLabs voice_settings.
+ * `style` is the exaggeration param (use sparingly above 0.5 — artifacts);
+ * `stability` is the consistency knob (low = more emotive, high = monotone);
+ * `speed` is rate (0.7-1.2). Defaults match ElevenLabs' own (style=0,
+ * stability=0.5, speed=1.0). Tuning per persona is conservative — we'd rather
+ * be slightly flat than artifact-laden.
+ */
+function resolveVoiceSettings(style) {
+    switch (style) {
+        case "calm":
+            return { style: 0.15, stability: 0.7, speed: 0.95 };
+        case "warm":
+            return { style: 0.25, stability: 0.6, speed: 1.0 };
+        case "casual":
+            return { style: 0.3, stability: 0.5, speed: 1.0 };
+        case "excited":
+            return { style: 0.55, stability: 0.35, speed: 1.05 };
+        case "energetic":
+            return { style: 0.6, stability: 0.35, speed: 1.08 };
+        case "happy":
+            return { style: 0.5, stability: 0.4, speed: 1.05 };
+        case "serious":
+            return { style: 0.2, stability: 0.75, speed: 0.95 };
+        case "dramatic":
+            return { style: 0.65, stability: 0.4, speed: 0.95 };
+        case "whisper":
+            return { style: 0.2, stability: 0.85, speed: 0.9 };
+        case "neutral":
+        case undefined:
+        default:
+            return {};
+    }
+}
+/**
+ * AG-4: canonical VoiceStyle values that resolveVoiceSettings actually maps.
+ * Anything outside this set falls through to `{}` (flat delivery).
+ */
+const CANONICAL_VOICE_STYLES = new Set([
+    "neutral", "calm", "warm", "casual", "excited",
+    "energetic", "happy", "serious", "dramatic", "whisper",
+]);
+/**
+ * AG-4: map a freeform voice-style adjective onto the canonical VoiceStyle
+ * vocabulary so per-scene emotional beats actually reach voice_settings.
+ * The planner is prompted to emit canonical values, but LLMs drift toward
+ * synonyms ('whispered', 'authoritative', 'frustrated', 'curious'); without
+ * this they silently no-op to default delivery. Unknown words → undefined
+ * (same as today). Case/whitespace-insensitive.
+ */
+const VOICE_STYLE_SYNONYMS = {
+    // whisper
+    whispered: "whisper", hushed: "whisper", soft: "whisper",
+    quiet: "whisper", intimate: "whisper", reflective: "whisper",
+    // calm
+    thoughtful: "calm", curious: "calm", intrigued: "calm", sad: "calm",
+    somber: "calm", melancholy: "calm", contemplative: "calm", gentle: "calm",
+    // warm
+    reassuring: "warm", friendly: "warm", soothing: "warm", inviting: "warm",
+    // casual
+    conversational: "casual", relaxed: "casual", chill: "casual",
+    informal: "casual", "laid-back": "casual",
+    // serious
+    authoritative: "serious", confident: "serious", assertive: "serious",
+    skeptical: "serious", professional: "serious", commanding: "serious",
+    // dramatic
+    frustrated: "dramatic", urgent: "dramatic", intense: "dramatic",
+    tense: "dramatic", angry: "dramatic",
+    // energetic
+    enthusiastic: "energetic", hyped: "energetic", lively: "energetic",
+    upbeat: "energetic", peppy: "energetic",
+    // happy
+    joyful: "happy", playful: "happy", cheerful: "happy", delighted: "happy",
+    // excited
+    thrilled: "excited", eager: "excited", animated: "excited",
+    // neutral
+    monotone: "neutral", deadpan: "neutral", flat: "neutral", robotic: "neutral",
+};
+function normalizeVoiceStyle(raw) {
+    if (!raw)
+        return undefined;
+    const key = raw.trim().toLowerCase();
+    if (CANONICAL_VOICE_STYLES.has(key))
+        return key;
+    return VOICE_STYLE_SYNONYMS[key];
+}

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

@@ -0,0 +1,101 @@
+import type { RunToolFn } from "./executor";
+import { ToolContext } from "./toolRegistry";
+/** One extension step in a chain (the source clip is implicit / step 0). */
+export interface ExtendChainStep {
+    /**
+     * Seconds to extend by. The provider clamps to its native increment, so this
+     * drives cost + the time-window split, not a frame-exact length.
+     */
+    extraDurationSec: number;
+    /**
+     * Optional continuation prompt. Omitted by default so the provider continues
+     * the source clip's motion naturally (a fresh prompt risks a visible cut).
+     */
+    prompt?: string;
+}
+/** Output of `planExtendChain` — how to build a too-long scene's visual. */
+export interface ExtendChainPlan {
+    /** Seconds for the initial clip (the model's max legal single-clip length). */
+    initialDurationSec: number;
+    /** Ordered extension segments fired after the initial clip completes. */
+    segments: ExtendChainStep[];
+}
+/** A resolved visual sub-clip (source or one extension), in render order. */
+export interface SceneClip {
+    /** Final asset URL for this sub-clip. */
+    visualUrl: string;
+    /** Provider task id this clip came from (trace / reuse). */
+    taskId?: string;
+    /** Nominal seconds for this sub-clip; drives the planToProject window split. */
+    durationSec: number;
+}
+/**
+ * Decide whether a video scene needs an extend chain, and slice the extra
+ * seconds into provider-legal extension steps. Returns `null` when:
+ *   - the model has no declared duration constraint (unconstrained → one clip),
+ *   - the target already fits one clip (within snap tolerance), or
+ *   - the model has no native extension endpoint (caller clamps as before — a
+ *     non-extend model can't continue a clip, so the extra seconds are dropped
+ *     by the existing capability/snap path).
+ *
+ * `targetDurationSec` is the scene's full requested length (scene.durationMs/1000).
+ */
+export declare function planExtendChain(modelKey: string, targetDurationSec: number): ExtendChainPlan | null;
+/** Poll result shape the host's TaskPoller wrapper returns. */
+export interface ExtendPollResult {
+    status: "completed" | "failed" | "timed-out";
+    videoUrl?: string;
+    errorMessage?: string;
+}
+/** Injected capabilities resolveExtendChain needs (host wires real impls). */
+export interface ExtendChainDeps {
+    /** Tool dispatcher (same one the executor uses) — runs `extend_video`. */
+    runTool: RunToolFn;
+    /** Polls a single provider task to completion (TaskPoller wrapper host-side). */
+    pollTask: (args: {
+        ref: string;
+        taskId: string;
+        modelKey: string;
+        outputFilename?: string;
+    }) => Promise<ExtendPollResult>;
+}
+export interface ResolveExtendChainArgs {
+    sceneIndex: number;
+    /** Extend-capable model the whole chain runs on (no cross-provider fallback). */
+    modelKey: string;
+    /** Task id of the already-triggered initial clip. */
+    initialTaskId: string;
+    /** Nominal seconds of the initial clip (from planExtendChain.initialDurationSec). */
+    initialDurationSec: number;
+    /** Ordered extension segments (from planExtendChain.segments). */
+    segments: ExtendChainStep[];
+    /** Tool context for the extend_video calls. */
+    ctx: ToolContext;
+    /** Filename hint prefix for the poller (e.g. `${projectId}-scene${i}`). */
+    outputFilenamePrefix?: string;
+}
+export type ResolveExtendChainResult = {
+    ok: true;
+    clips: SceneClip[];
+} | {
+    ok: false;
+    /** Clips that DID resolve before the failure (may be empty). */
+    clips: SceneClip[];
+    error: {
+        code: string;
+        message: string;
+        failedTaskId?: string;
+    };
+};
+/**
+ * Run an extend chain to completion, enforcing source-task ordering: poll the
+ * current task → on completion, fire the next extension → poll that → repeat.
+ * Returns the source + extension clips in render order.
+ *
+ * Failure is partial-tolerant: if a mid-chain task fails/times out we stop and
+ * return the clips resolved so far with ok:false, so the caller can decide to
+ * ship a shorter scene rather than lose the whole thing. A failed SOURCE clip
+ * (no clips resolved) is a hard scene failure.
+ */
+export declare function resolveExtendChain(deps: ExtendChainDeps, args: ResolveExtendChainArgs): Promise<ResolveExtendChainResult>;
+//# sourceMappingURL=extendChain.d.ts.map

package/lib/services/agent/extendChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extendChain.d.ts","sourceRoot":"","sources":["../../../src/services/agent/extendChain.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAgD7C,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,GACxB,eAAe,GAAG,IAAI,CA2BxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,EAAE,SAAS,CAAC;IACnB,iFAAiF;IACjF,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,GAAG,EAAE,WAAW,CAAC;IACjB,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,gEAAgE;IAChE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,CAAC;AAEN;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CAiFnC"}

package/lib/services/agent/extendChain.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planExtendChain = planExtendChain;
+exports.resolveExtendChain = resolveExtendChain;
+const logger_1 = require("../../utils/logger");
+const tierHelpers_1 = require("../../globals/aiModels/tierHelpers");
+const extendVideo_tool_1 = require("./tools/extendVideo.tool");
+/**
+ * AG-2 / Stream L (L-4) — extend-chain orchestration.
+ *
+ * A single scene can ask for more seconds than the chosen video model emits in
+ * one clip (e.g. a 16s continuous establishing shot on Kling, whose max single
+ * clip is ~10s). For extend-capable providers (Kling / Pixverse) we don't drop
+ * the extra seconds or fall back to a different provider (which would visibly
+ * change the look) — we generate the initial clip at the model's max legal
+ * length, then call the provider's NATIVE extension endpoint N times, each
+ * continuing the PREVIOUS provider task.
+ *
+ * The hard part is ordering: `extend_video` takes a `previousTaskId` that must
+ * already be COMPLETE on the provider before the extension can start. The agent
+ * executor is otherwise fire-and-forget (it triggers every scene's generation
+ * in parallel and returns `pendingTaskId`s for the host to poll afterwards), so
+ * the chain can't live in that parallel fan-out.
+ *
+ * Split of responsibilities:
+ *   - `planExtendChain` (pure)        — decides whether a scene needs a chain
+ *                                       and how to slice the extra seconds. The
+ *                                       executor calls this at trigger time and
+ *                                       emits the segments on the SceneOutcome.
+ *   - `resolveExtendChain` (injected) — runs the chain SEQUENTIALLY: poll the
+ *                                       source → fire one extend → poll it →
+ *                                       repeat. The host injects `pollTask`
+ *                                       (a TaskPoller wrapper) + `runTool`.
+ *
+ * Keeping both here (in `shared`) rather than in the node worker means the
+ * decision logic is unit-testable and exercised by the eval harness's executor.
+ */
+/** Provider extension request bounds (mirror extendVideo.tool's InputSchema). */
+const EXTEND_MIN_SEC = 2;
+const EXTEND_MAX_SEC = 10;
+/** Preferred per-extension increment (Kling ~4-5s, Pixverse ~5-8s natively). */
+const PREFERRED_STEP_SEC = 5;
+/**
+ * Hard cap on extensions per scene. A mis-planned 60s "scene" should not fan
+ * into a dozen paid provider calls — beyond this we get as close as we can and
+ * log the shortfall. maxClip + MAX_EXTENSIONS×EXTEND_MAX covers ~70s, well past
+ * any sane single continuous shot.
+ */
+const MAX_EXTENSIONS = 6;
+/** Don't chain for a sub-second overflow — snapping absorbs it. */
+const CHAIN_TOLERANCE_SEC = 0.5;
+/**
+ * Decide whether a video scene needs an extend chain, and slice the extra
+ * seconds into provider-legal extension steps. Returns `null` when:
+ *   - the model has no declared duration constraint (unconstrained → one clip),
+ *   - the target already fits one clip (within snap tolerance), or
+ *   - the model has no native extension endpoint (caller clamps as before — a
+ *     non-extend model can't continue a clip, so the extra seconds are dropped
+ *     by the existing capability/snap path).
+ *
+ * `targetDurationSec` is the scene's full requested length (scene.durationMs/1000).
+ */
+function planExtendChain(modelKey, targetDurationSec) {
+    const allowed = (0, tierHelpers_1.getModelAllowedDurations)(modelKey);
+    if (!allowed || allowed.length === 0)
+        return null; // unconstrained
+    const maxClip = allowed[allowed.length - 1]; // getModelAllowedDurations sorts ascending
+    const remaining = targetDurationSec - maxClip;
+    if (remaining <= CHAIN_TOLERANCE_SEC)
+        return null; // fits one clip
+    if (!(0, extendVideo_tool_1.modelSupportsExtend)(modelKey))
+        return null; // can't extend on this model
+    let n = Math.ceil(remaining / PREFERRED_STEP_SEC);
+    n = Math.min(Math.max(n, 1), MAX_EXTENSIONS);
+    const per = clamp(Math.round(remaining / n), EXTEND_MIN_SEC, EXTEND_MAX_SEC);
+    const segments = Array.from({ length: n }, () => ({
+        extraDurationSec: per,
+    }));
+    const achievable = maxClip + n * per;
+    if (achievable + CHAIN_TOLERANCE_SEC < targetDurationSec) {
+        logger_1.logger.warn("extendChain: requested duration exceeds chain ceiling — clamping", {
+            modelKey,
+            targetDurationSec,
+            maxClip,
+            extensions: n,
+            perSec: per,
+            achievableSec: achievable,
+        });
+    }
+    return { initialDurationSec: maxClip, segments };
+}
+/**
+ * Run an extend chain to completion, enforcing source-task ordering: poll the
+ * current task → on completion, fire the next extension → poll that → repeat.
+ * Returns the source + extension clips in render order.
+ *
+ * Failure is partial-tolerant: if a mid-chain task fails/times out we stop and
+ * return the clips resolved so far with ok:false, so the caller can decide to
+ * ship a shorter scene rather than lose the whole thing. A failed SOURCE clip
+ * (no clips resolved) is a hard scene failure.
+ */
+async function resolveExtendChain(deps, args) {
+    const { runTool, pollTask } = deps;
+    const { sceneIndex, modelKey, segments, ctx } = args;
+    const prefix = args.outputFilenamePrefix ?? `scene${sceneIndex}`;
+    const clips = [];
+    let currentTaskId = args.initialTaskId;
+    let currentDurationSec = args.initialDurationSec;
+    // Step 0 is the source clip; steps 1..N are the extensions. We poll the
+    // current task, record its clip, then (if more remain) fire the next extend.
+    for (let step = 0; step <= segments.length; step++) {
+        const poll = await pollTask({
+            ref: `${sceneIndex}.${step}`,
+            taskId: currentTaskId,
+            modelKey,
+            outputFilename: `${prefix}-ext${step}`,
+        });
+        if (poll.status !== "completed" || !poll.videoUrl) {
+            logger_1.logger.warn("extendChain: chain task did not complete — stopping", {
+                sceneIndex,
+                step,
+                status: poll.status,
+                taskId: currentTaskId,
+                error: poll.errorMessage,
+            });
+            return {
+                ok: false,
+                clips,
+                error: {
+                    code: step === 0 ? "EXTEND_SOURCE_FAILED" : "EXTEND_STEP_FAILED",
+                    message: `Extend chain ${step === 0 ? "source" : `step ${step}`} ${poll.status}` +
+                        (poll.errorMessage ? `: ${poll.errorMessage}` : ""),
+                    failedTaskId: currentTaskId,
+                },
+            };
+        }
+        clips.push({
+            visualUrl: poll.videoUrl,
+            taskId: currentTaskId,
+            durationSec: currentDurationSec,
+        });
+        // All steps resolved — done.
+        if (step === segments.length)
+            break;
+        // Fire the next extension, continuing the task we just confirmed complete.
+        const seg = segments[step];
+        const extendOut = await runTool("extend_video", {
+            previousTaskId: currentTaskId,
+            modelKey,
+            extraDurationSec: seg.extraDurationSec,
+            ...(seg.prompt ? { prompt: seg.prompt } : {}),
+        }, { ...ctx, idempotencyKey: `${ctx.idempotencyKey ?? ctx.agentRunId}:ext${step + 1}` });
+        if (!extendOut.ok) {
+            logger_1.logger.warn("extendChain: extend_video call failed — stopping", {
+                sceneIndex,
+                step: step + 1,
+                sourceTaskId: currentTaskId,
+                error: extendOut.error,
+            });
+            return {
+                ok: false,
+                clips,
+                error: {
+                    code: "EXTEND_TRIGGER_FAILED",
+                    message: `extend_video step ${step + 1} failed: ${extendOut.error?.message ?? extendOut.error?.code ?? "unknown"}`,
+                    failedTaskId: currentTaskId,
+                },
+            };
+        }
+        currentTaskId = extendOut.output.taskId;
+        currentDurationSec = seg.extraDurationSec;
+    }
+    return { ok: true, clips };
+}
+function clamp(v, lo, hi) {
+    return Math.max(lo, Math.min(hi, v));
+}

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

@@ -2,13 +2,19 @@ export * from "./toolRegistry";
 export * from "./tools";
 export * from "./modelRouter";
 export * from "./llmCaller";
-export * from "./llmCallerGateway";
+export * from "./llmRetry";
+export * from "./llmModelRegistry";
 export * from "./llmCallerAnthropic";
+export * from "./llmCallerOpenai";
+export * from "./llmCallerGemini";
+export * from "./llmCallerRouting";
+export * from "./llmCallerFactory";
 export * from "./personas";
 export * from "./llmCallerRegistry";
 export * from "./costPreflight";
 export * from "./planner";
 export * from "./planMutations";
+export * from "./priorProject";
 export * from "./bibleBuilder";
 export * from "./referenceImageRenderer";
 export * from "./bibleImageVision";
@@ -16,6 +22,10 @@ export * from "./sceneLayoutVision";
 export * from "./beatSnap";
 export * from "./musicSelect";
 export * from "./executor";
+export * from "./extendChain";
+export * from "./editExisting";
+export * from "./repurpose";
+export * from "./covers";
 export * from "./providerTaskCache";
 export * from "./planDiff";
 export * from "./taskPoller";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/agent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/agent/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/lib/services/agent/index.js

@@ -18,13 +18,19 @@ __exportStar(require("./toolRegistry"), exports);
 __exportStar(require("./tools"), exports);
 __exportStar(require("./modelRouter"), exports);
 __exportStar(require("./llmCaller"), exports);
-__exportStar(require("./llmCallerGateway"), exports);
+__exportStar(require("./llmRetry"), exports);
+__exportStar(require("./llmModelRegistry"), exports);
 __exportStar(require("./llmCallerAnthropic"), exports);
+__exportStar(require("./llmCallerOpenai"), exports);
+__exportStar(require("./llmCallerGemini"), exports);
+__exportStar(require("./llmCallerRouting"), exports);
+__exportStar(require("./llmCallerFactory"), exports);
 __exportStar(require("./personas"), exports);
 __exportStar(require("./llmCallerRegistry"), exports);
 __exportStar(require("./costPreflight"), exports);
 __exportStar(require("./planner"), exports);
 __exportStar(require("./planMutations"), exports);
+__exportStar(require("./priorProject"), exports);
 __exportStar(require("./bibleBuilder"), exports);
 __exportStar(require("./referenceImageRenderer"), exports);
 __exportStar(require("./bibleImageVision"), exports);
@@ -32,6 +38,10 @@ __exportStar(require("./sceneLayoutVision"), exports);
 __exportStar(require("./beatSnap"), exports);
 __exportStar(require("./musicSelect"), exports);
 __exportStar(require("./executor"), exports);
+__exportStar(require("./extendChain"), exports);
+__exportStar(require("./editExisting"), exports);
+__exportStar(require("./repurpose"), exports);
+__exportStar(require("./covers"), exports);
 __exportStar(require("./providerTaskCache"), exports);
 __exportStar(require("./planDiff"), exports);
 __exportStar(require("./taskPoller"), exports);

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

@@ -2,9 +2,10 @@ import { z } from "zod";
 import { ModelChoice } from "./modelRouter";
 /**
  * Provider-agnostic LLM caller. The host (Express server / Firebase Functions)
- * wires a concrete implementation backed by Vercel AI Gateway, OpenRouter, or
- * direct SDKs. Agent code only ever sees this interface, which keeps it
- * portable and lets us A/B-test models against the eval set without code changes.
+ * wires a concrete implementation — the native ProviderRoutingLlmCaller, which
+ * dispatches per request to a provider's own SDK (Anthropic / OpenAI / Gemini).
+ * Agent code only ever sees this interface, which keeps it portable and lets us
+ * A/B-test models against the eval set without code changes.
  */
 export interface LlmCaller {
     /** Free-form chat completion. */
@@ -30,11 +31,9 @@ export interface LlmCaller {
      * emitting the final structured payload.
      *
      * Only implemented by callers that natively support tool-use loops (today:
-     * `AnthropicLlmCaller`). `GatewayLlmCaller` does NOT implement this because
-     * Anthropic's built-in server tools are not exposable through the OpenAI-
-     * compatible Vercel AI Gateway. If a future need warrants it, we can add
-     * a custom-tools-only variant on the gateway (e.g. Tavily passed as a
-     * regular OpenAI-format tool) — see deferred work in `llmCallerAnthropic.ts`.
+     * `AnthropicLlmCaller`, for Anthropic's built-in server tools). The
+     * dispatcher routes structuredWithTools to the Anthropic caller and throws
+     * if a non-Anthropic provider is asked for it. OpenAI/Gemini callers omit it.
      */
     structuredWithTools?<T extends z.ZodTypeAny>(req: StructuredWithToolsRequest<T>): Promise<StructuredResponse<T>>;
 }

package/lib/services/agent/llmCaller.d.ts.map

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