vidspotai-shared 1.0.55 → 1.0.57

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

@@ -1,39 +0,0 @@
-import { z } from "zod";
-import { ChatRequest, ChatResponse, LlmCaller, StructuredRequest, StructuredResponse } from "./llmCaller";
-/**
- * Vercel AI Gateway LlmCaller — OpenAI-compatible /v1/chat/completions surface.
- * Single endpoint, multi-provider routing via "{provider}/{modelId}" model id.
- *
- * No SDK dependency: pure fetch keeps the shared package light. Structured
- * output uses JSON-schema response_format (supported by gateway across
- * Anthropic / OpenAI / Google providers — gateway normalises it).
- */
-export interface GatewayConfig {
-    /** Full base url, e.g. "https://ai-gateway.vercel.sh/v1". */
-    baseUrl: string;
-    /** Bearer token. */
-    apiKey: string;
-    /** Default request timeout in ms. */
-    timeoutMs?: number;
-    /** Optional fetch impl override (tests). */
-    fetchImpl?: typeof fetch;
-}
-export declare class GatewayLlmCaller implements LlmCaller {
-    private readonly cfg;
-    private readonly fetchImpl;
-    private readonly timeoutMs;
-    constructor(cfg: GatewayConfig);
-    chat(req: ChatRequest): Promise<ChatResponse>;
-    structured<T extends z.ZodTypeAny>(req: StructuredRequest<T>): Promise<StructuredResponse<T>>;
-    structuredStream<T extends z.ZodTypeAny>(req: StructuredRequest<T>): {
-        tokens: AsyncIterable<string>;
-        result: Promise<StructuredResponse<T>>;
-    };
-    private createStreamingIterator;
-    private modelId;
-    private encodeMessage;
-    private toDataUri;
-    private usage;
-    private post;
-}
-//# sourceMappingURL=llmCallerGateway.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"llmCallerGateway.d.ts","sourceRoot":"","sources":["../../../src/services/agent/llmCallerGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAGrB;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAYD,qBAAa,gBAAiB,YAAW,SAAS;IAIpC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEN,GAAG,EAAE,aAAa;IAKzC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB7C,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IA8CjC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACxB;QACD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;KACxC;YAoBc,uBAAuB;IAoHtC,OAAO,CAAC,OAAO;YAID,aAAa;YAqBb,SAAS;IAcvB,OAAO,CAAC,KAAK;YAQC,IAAI;CA2BnB"}

package/lib/services/agent/llmCallerGateway.js

@@ -1,246 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GatewayLlmCaller = void 0;
-const zod_1 = require("zod");
-class GatewayLlmCaller {
-    constructor(cfg) {
-        this.cfg = cfg;
-        this.fetchImpl = cfg.fetchImpl ?? fetch;
-        this.timeoutMs = cfg.timeoutMs ?? 60000;
-    }
-    async chat(req) {
-        const messages = await Promise.all(req.messages.map((m) => this.encodeMessage(m)));
-        const raw = await this.post({
-            model: this.modelId(req.model),
-            messages,
-            temperature: req.temperature,
-            max_tokens: req.maxTokens,
-            stop: req.stop,
-        });
-        const text = raw.choices?.[0]?.message?.content ?? "";
-        return {
-            text: typeof text === "string" ? text : JSON.stringify(text),
-            usage: this.usage(raw),
-            requestId: raw.id,
-        };
-    }
-    async structured(req) {
-        const jsonSchema = zod_1.z.toJSONSchema(req.schema, { target: "draft-7" });
-        const messages = await Promise.all(req.messages.map((m) => this.encodeMessage(m)));
-        const raw = await this.post({
-            model: this.modelId(req.model),
-            messages,
-            temperature: req.temperature,
-            max_tokens: req.maxTokens,
-            response_format: {
-                type: "json_schema",
-                json_schema: {
-                    name: req.schemaName,
-                    schema: jsonSchema,
-                    strict: true,
-                },
-            },
-        });
-        const txt = raw.choices?.[0]?.message?.content ?? "";
-        if (!txt || typeof txt !== "string") {
-            throw new Error(`GatewayLlmCaller.structured: empty response for schema ${req.schemaName}`);
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(txt);
-        }
-        catch {
-            throw new Error(`GatewayLlmCaller.structured: model returned non-JSON for schema ${req.schemaName}: ${txt.slice(0, 200)}`);
-        }
-        const result = req.schema.safeParse(parsed);
-        if (!result.success) {
-            throw new Error(`GatewayLlmCaller.structured: schema validation failed for ${req.schemaName}: ${result.error.message}`);
-        }
-        return {
-            data: result.data,
-            usage: this.usage(raw),
-            requestId: raw.id,
-        };
-    }
-    structuredStream(req) {
-        // We fan one upstream stream out to two consumers: the caller iterates
-        // `tokens` to forward chunks to the UI, while we accumulate the same
-        // chunks into a buffer that we parse + Zod-validate at end-of-stream.
-        let resolveResult;
-        let rejectResult;
-        const result = new Promise((resolve, reject) => {
-            resolveResult = resolve;
-            rejectResult = reject;
-        });
-        const self = this;
-        const tokens = {
-            [Symbol.asyncIterator]() {
-                return self.createStreamingIterator(req, resolveResult, rejectResult);
-            },
-        };
-        return { tokens, result };
-    }
-    async *createStreamingIterator(req, resolveResult, rejectResult) {
-        const jsonSchema = zod_1.z.toJSONSchema(req.schema, { target: "draft-7" });
-        const messages = await Promise.all(req.messages.map((m) => this.encodeMessage(m)));
-        const ctrl = new AbortController();
-        const t = setTimeout(() => ctrl.abort(), this.timeoutMs);
-        let accumulated = "";
-        let requestId;
-        let usage;
-        try {
-            const res = await this.fetchImpl(`${this.cfg.baseUrl.replace(/\/$/, "")}/chat/completions`, {
-                method: "POST",
-                headers: {
-                    "content-type": "application/json",
-                    authorization: `Bearer ${this.cfg.apiKey}`,
-                },
-                body: JSON.stringify({
-                    model: this.modelId(req.model),
-                    messages,
-                    temperature: req.temperature,
-                    max_tokens: req.maxTokens,
-                    stream: true,
-                    response_format: {
-                        type: "json_schema",
-                        json_schema: {
-                            name: req.schemaName,
-                            schema: jsonSchema,
-                            strict: true,
-                        },
-                    },
-                }),
-                signal: ctrl.signal,
-            });
-            if (!res.ok || !res.body) {
-                const text = await res.text().catch(() => "");
-                const err = new Error(`GatewayLlmCaller.structuredStream: ${res.status} ${res.statusText} — ${text.slice(0, 500)}`);
-                rejectResult(err);
-                throw err;
-            }
-            const reader = res.body.getReader();
-            const decoder = new TextDecoder();
-            let buf = "";
-            while (true) {
-                const { value, done } = await reader.read();
-                if (done)
-                    break;
-                buf += decoder.decode(value, { stream: true });
-                let nl;
-                while ((nl = buf.indexOf("\n")) !== -1) {
-                    const line = buf.slice(0, nl).trim();
-                    buf = buf.slice(nl + 1);
-                    if (!line || !line.startsWith("data:"))
-                        continue;
-                    const payload = line.slice(5).trim();
-                    if (payload === "[DONE]")
-                        break;
-                    try {
-                        const obj = JSON.parse(payload);
-                        if (obj.id)
-                            requestId = obj.id;
-                        if (obj.usage) {
-                            usage = {
-                                promptTokens: obj.usage.prompt_tokens,
-                                completionTokens: obj.usage.completion_tokens,
-                            };
-                        }
-                        const delta = obj.choices?.[0]?.delta?.content ?? "";
-                        if (delta) {
-                            accumulated += delta;
-                            yield delta;
-                        }
-                    }
-                    catch {
-                        // skip malformed line
-                    }
-                }
-            }
-            let parsed;
-            try {
-                parsed = JSON.parse(accumulated);
-            }
-            catch {
-                const err = new Error(`GatewayLlmCaller.structuredStream: model returned non-JSON for ${req.schemaName}: ${accumulated.slice(0, 200)}`);
-                rejectResult(err);
-                throw err;
-            }
-            const validated = req.schema.safeParse(parsed);
-            if (!validated.success) {
-                const err = new Error(`GatewayLlmCaller.structuredStream: schema validation failed for ${req.schemaName}: ${validated.error.message}`);
-                rejectResult(err);
-                throw err;
-            }
-            resolveResult({ data: validated.data, usage, requestId });
-        }
-        catch (e) {
-            rejectResult(e);
-            throw e;
-        }
-        finally {
-            clearTimeout(t);
-        }
-    }
-    modelId(m) {
-        return `${m.provider}/${m.modelId}`;
-    }
-    async encodeMessage(m) {
-        if (!m.imageUrls?.length) {
-            return { role: m.role, content: m.content };
-        }
-        // Fetch + base64-encode each URL into a data URI. The gateway's Anthropic
-        // translator rejects raw https URLs ("URL sources are not supported"); data
-        // URIs round-trip through every provider's OpenAI-compat shim correctly.
-        const dataUris = await Promise.all(m.imageUrls.map((u) => this.toDataUri(u)));
-        return {
-            role: m.role,
-            content: [
-                { type: "text", text: m.content },
-                ...dataUris.map((url) => ({ type: "image_url", image_url: { url } })),
-            ],
-        };
-    }
-    async toDataUri(url) {
-        if (url.startsWith("data:"))
-            return url;
-        const res = await this.fetchImpl(url);
-        if (!res.ok) {
-            throw new Error(`GatewayLlmCaller.toDataUri: ${res.status} ${res.statusText} fetching ${url}`);
-        }
-        const contentType = res.headers.get("content-type")?.split(";")[0]?.trim() || "image/jpeg";
-        const buf = Buffer.from(await res.arrayBuffer());
-        return `data:${contentType};base64,${buf.toString("base64")}`;
-    }
-    usage(raw) {
-        if (!raw.usage)
-            return undefined;
-        return {
-            promptTokens: raw.usage.prompt_tokens,
-            completionTokens: raw.usage.completion_tokens,
-        };
-    }
-    async post(body) {
-        const ctrl = new AbortController();
-        const t = setTimeout(() => ctrl.abort(), this.timeoutMs);
-        try {
-            const res = await this.fetchImpl(`${this.cfg.baseUrl.replace(/\/$/, "")}/chat/completions`, {
-                method: "POST",
-                headers: {
-                    "content-type": "application/json",
-                    authorization: `Bearer ${this.cfg.apiKey}`,
-                },
-                body: JSON.stringify(body),
-                signal: ctrl.signal,
-            });
-            if (!res.ok) {
-                const text = await res.text().catch(() => "");
-                throw new Error(`GatewayLlmCaller: ${res.status} ${res.statusText} — ${text.slice(0, 500)}`);
-            }
-            return (await res.json());
-        }
-        finally {
-            clearTimeout(t);
-        }
-    }
-}
-exports.GatewayLlmCaller = GatewayLlmCaller;

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

@@ -1,4 +0,0 @@
-import { LlmCaller } from "./llmCaller";
-export declare function setLlmCaller(caller: LlmCaller): void;
-export declare function getLlmCaller(): LlmCaller;
-//# sourceMappingURL=llmCallerRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"llmCallerRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/agent/llmCallerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,aAAa,CAAC;AAY/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/lib/services/agent/llmCallerRegistry.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setLlmCaller = setLlmCaller;
-exports.getLlmCaller = getLlmCaller;
-const llmCaller_1 = require("./llmCaller");
-/**
- * Singleton LlmCaller accessor. Host wires a concrete impl at boot
- * (e.g. GatewayLlmCaller); agent code reads via getLlmCaller().
- *
- * Throwing UnconfiguredLlmCaller is the default so tests fail loud
- * if the host forgets to wire.
- */
-let instance = new llmCaller_1.UnconfiguredLlmCaller();
-function setLlmCaller(caller) {
-    instance = caller;
-}
-function getLlmCaller() {
-    return instance;
-}

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

@@ -1,41 +0,0 @@
-/**
- * Model router — picks the right LLM per agent role.
- *
- * Roles split because their cost/quality profiles differ wildly:
- *   - router     : single classification call, pick persona from first message
- *   - planner    : structured-output, must produce valid VideoPlan
- *   - executor   : narrow tool-routing loop, mostly mechanical
- *   - critic     : vision QA across scenes, rubric-following
- *   - reference  : ingest a TikTok/Reel URL, extract structure
- *
- * The actual LLM call is delegated to an injected LlmCaller (wired to
- * Vercel AI Gateway / OpenRouter at the host layer) — this keeps the
- * agent code provider-agnostic and easy to A/B test against the eval set.
- */
-export type AgentRole = "router" | "planner" | "executor" | "critic" | "reference";
-export interface ModelChoice {
-    /** Logical model id, e.g. "claude-sonnet-4.6", "claude-haiku-4.5", "gpt-5". */
-    modelId: string;
-    /** Provider key for the LLM gateway, e.g. "anthropic", "openai", "google". */
-    provider: string;
-    /** Vision input supported. */
-    vision?: boolean;
-}
-export interface ModelRoutingPolicy {
-    /** Default per-role model. */
-    primary: Record<AgentRole, ModelChoice>;
-    /** Fallback if primary is unavailable / rate-limited. Optional per-role. */
-    fallback?: Partial<Record<AgentRole, ModelChoice>>;
-    /** Premium tier upgrade — Premium-budget briefs route planner to this model. */
-    premiumPlanner?: ModelChoice;
-}
-export declare const DEFAULT_MODEL_ROUTING: ModelRoutingPolicy;
-export declare class ModelRouter {
-    private readonly policy;
-    constructor(policy?: ModelRoutingPolicy);
-    pickFor(role: AgentRole, opts?: {
-        premium?: boolean;
-    }): ModelChoice;
-    fallbackFor(role: AgentRole): ModelChoice | undefined;
-}
-//# sourceMappingURL=modelRouter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"modelRouter.d.ts","sourceRoot":"","sources":["../../../src/services/agent/modelRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACnD,gFAAgF;IAChF,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,EAAE,kBAwBnC,CAAC;AAEF,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,kBAA0C;IAE/E,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW;IAOnE,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;CAGtD"}

package/lib/services/agent/modelRouter.js

@@ -1,57 +0,0 @@
-"use strict";
-/**
- * Model router — picks the right LLM per agent role.
- *
- * Roles split because their cost/quality profiles differ wildly:
- *   - router     : single classification call, pick persona from first message
- *   - planner    : structured-output, must produce valid VideoPlan
- *   - executor   : narrow tool-routing loop, mostly mechanical
- *   - critic     : vision QA across scenes, rubric-following
- *   - reference  : ingest a TikTok/Reel URL, extract structure
- *
- * The actual LLM call is delegated to an injected LlmCaller (wired to
- * Vercel AI Gateway / OpenRouter at the host layer) — this keeps the
- * agent code provider-agnostic and easy to A/B test against the eval set.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModelRouter = exports.DEFAULT_MODEL_ROUTING = void 0;
-exports.DEFAULT_MODEL_ROUTING = {
-    primary: {
-        router: { modelId: "claude-haiku-4-5", provider: "anthropic" },
-        planner: { modelId: "claude-sonnet-4-6", provider: "anthropic" },
-        executor: { modelId: "claude-haiku-4-5", provider: "anthropic" },
-        critic: {
-            modelId: "claude-sonnet-4-6",
-            provider: "anthropic",
-            vision: true,
-        },
-        reference: {
-            modelId: "gemini-2.5-pro",
-            provider: "google",
-            vision: true,
-        },
-    },
-    fallback: {
-        router: { modelId: "gpt-5-mini", provider: "openai" },
-        planner: { modelId: "gpt-5", provider: "openai" },
-        executor: { modelId: "deepseek-chat", provider: "deepseek" },
-        critic: { modelId: "gpt-5", provider: "openai", vision: true },
-        reference: { modelId: "claude-sonnet-4-6", provider: "anthropic" },
-    },
-    premiumPlanner: { modelId: "claude-opus-4-7", provider: "anthropic" },
-};
-class ModelRouter {
-    constructor(policy = exports.DEFAULT_MODEL_ROUTING) {
-        this.policy = policy;
-    }
-    pickFor(role, opts) {
-        if (role === "planner" && opts?.premium && this.policy.premiumPlanner) {
-            return this.policy.premiumPlanner;
-        }
-        return this.policy.primary[role];
-    }
-    fallbackFor(role) {
-        return this.policy.fallback?.[role];
-    }
-}
-exports.ModelRouter = ModelRouter;

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

@@ -1,23 +0,0 @@
-import { VideoPlan } from "../../schemas/videoPlan.schema";
-/**
- * selectMusicForPlan — runs once after the planner returns and before the
- * beat-snap pass, attaching a real track URL + bpm to plan.music.
- *
- * Why post-planner instead of letting the planner call search_music itself:
- * the planner is a single structured-output call, not a tool-using agent.
- * Adding a tool-call cycle here would double LLM latency and cost for a
- * step that is fully mechanical — query string → provider → URL.
- *
- * No-ops when:
- *   - plan.music.strategy === "none"
- *   - plan.music.url is already set (user / brand kit pre-selected a track)
- *   - all music providers are unconfigured (curated catalog should always
- *     be available, so this branch should be rare in practice).
- *
- * On failure (no provider returns a hit) we leave plan.music.url unset and
- * the snap pass falls back to BPM math; the editor can still attach music
- * downstream. Not surfacing this as an error — music is enhancement, not
- * a blocker.
- */
-export declare function selectMusicForPlan(plan: VideoPlan): Promise<VideoPlan>;
-//# sourceMappingURL=musicSelect.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"musicSelect.d.ts","sourceRoot":"","sources":["../../../src/services/agent/musicSelect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAyC5E"}

package/lib/services/agent/musicSelect.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.selectMusicForPlan = selectMusicForPlan;
-const audioAnalysis_1 = require("../audioAnalysis");
-const musicGen_1 = require("../musicGen");
-const beatSnap_1 = require("./beatSnap");
-const personas_1 = require("./personas");
-/**
- * selectMusicForPlan — runs once after the planner returns and before the
- * beat-snap pass, attaching a real track URL + bpm to plan.music.
- *
- * Why post-planner instead of letting the planner call search_music itself:
- * the planner is a single structured-output call, not a tool-using agent.
- * Adding a tool-call cycle here would double LLM latency and cost for a
- * step that is fully mechanical — query string → provider → URL.
- *
- * No-ops when:
- *   - plan.music.strategy === "none"
- *   - plan.music.url is already set (user / brand kit pre-selected a track)
- *   - all music providers are unconfigured (curated catalog should always
- *     be available, so this branch should be rare in practice).
- *
- * On failure (no provider returns a hit) we leave plan.music.url unset and
- * the snap pass falls back to BPM math; the editor can still attach music
- * downstream. Not surfacing this as an error — music is enhancement, not
- * a blocker.
- */
-async function selectMusicForPlan(plan) {
-    if (!plan.music || plan.music.strategy === "none" || plan.music.url)
-        return plan;
-    const personaDefaultBpm = personas_1.PERSONA_PACKS[plan.persona]?.defaultBpm;
-    const bpmTarget = plan.music.bpm ?? personaDefaultBpm;
-    const totalSec = Math.ceil(plan.totalDurationMs / 1000);
-    const result = await (0, musicGen_1.searchAllMusicSources)({
-        query: plan.music.query,
-        mood: plan.music.moodTag,
-        bpmTarget,
-        durationSecMin: totalSec,
-        limit: 5,
-    });
-    const track = result.tracks[0];
-    if (!track)
-        return plan;
-    // Onset detection runs best-effort: timeout / disabled / WASM error all
-    // resolve to undefined and the snap pass falls back to BPM math. When it
-    // succeeds we get both a corrected BPM (essentia is more accurate than
-    // the provider's metadata) and a list of transient timestamps.
-    const onsetAnalysis = await (0, audioAnalysis_1.detectOnsets)(track.url);
-    return {
-        ...plan,
-        music: {
-            ...plan.music,
-            url: track.url,
-            bpm: onsetAnalysis?.bpm
-                ?? track.bpm
-                ?? plan.music.bpm
-                ?? (0, beatSnap_1.resolveBpm)(plan)
-                ?? personaDefaultBpm,
-            durationSec: track.durationSec,
-            source: track.source,
-            attribution: track.attribution,
-            onsets: onsetAnalysis?.onsets,
-        },
-    };
-}

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

@@ -1,60 +0,0 @@
-import { AgentPersona, AgentPersonaSchema } from "../../schemas/agentPersona.schema";
-import { LlmCaller } from "./llmCaller";
-import { ModelRouter } from "./modelRouter";
-export type { AgentPersona };
-export { AgentPersonaSchema };
-/**
- * Vertical agent personas. Each persona = curated planner system prompt
- * + recommended tier mix + critic rubric. Router LLM picks the persona
- * from the user's first message (single classification call, Haiku-tier).
- *
- * Why personas: vertical specialisation is what makes a small model and
- * a small team feel like a domain expert. invideo / Captions both win
- * on this. v1 ships 5; v2 adds general + niche personas.
- */
-export interface PersonaPack {
-    id: AgentPersona;
-    /** Short user-facing label. */
-    label: string;
-    /** Single-sentence pitch shown in persona picker. */
-    blurb: string;
-    /** Default brief axes the persona pre-fills (used when LLM confidence is low). */
-    defaults: {
-        aspect: "16:9" | "9:16" | "1:1";
-        durationSec: number;
-        tone: string;
-        pacing: "slow" | "medium" | "fast" | "very-fast";
-        hookStyle: string;
-        tierBudget: "T0" | "T1" | "T2" | "T3";
-    };
-    /** Planner system-prompt addendum: niche-specific structural priors. */
-    plannerPrompt: string;
-    /**
-     * Default BPM for the beat-snap pass when neither the user nor the planner
-     * specifies one. Personas where steady BPM cuts feel right (recap, UGC) set
-     * a value; cinematic / educational personas leave it undefined so cuts stay
-     * free-form.
-     */
-    defaultBpm?: number;
-    /** Critic rubric weights (override the global judge). */
-    criticEmphasis: Partial<{
-        hookStrength: number;
-        voVisualSync: number;
-        pacingFit: number;
-        brandSafety: number;
-        costVsTier: number;
-        intentMatch: number;
-    }>;
-}
-export declare const PERSONA_PACKS: Record<AgentPersona, PersonaPack>;
-export declare class PersonaRouter {
-    private readonly llm;
-    private readonly router;
-    constructor(llm: LlmCaller, router?: ModelRouter);
-    route(rawPrompt: string): Promise<{
-        persona: AgentPersona;
-        confidence: number;
-        reason: string;
-    }>;
-}
-//# sourceMappingURL=personas.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../../src/services/agent/personas.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,YAAY,CAAC;IACjB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;QACjD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CA8G3D,CAAC;AAQF,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,GAAG,EAAE,SAAS,EACd,MAAM,GAAE,WAA+B;IAGpD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACtC,OAAO,EAAE,YAAY,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CA2BH"}