@prestyj/editor 0.7.1

package/dist/core/thumbnail-compose.js

@@ -0,0 +1,101 @@
+/**
+ * Pure helper for composing a single thumbnail frame: pull a frame at
+ * `atSec` and burn a headline on top with ffmpeg drawtext.
+ *
+ * Extracted from compose-thumbnail.ts so `compose_thumbnail_variants`
+ * can call the same logic three times without duplicating the drawtext
+ * filter construction.
+ */
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { runFfmpeg } from "./media/ffmpeg.js";
+const SYSTEM_FONT_GUESSES = [
+    "/System/Library/Fonts/Helvetica.ttc",
+    "/System/Library/Fonts/Supplemental/Arial.ttf",
+    "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
+    "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf",
+    "C:\\Windows\\Fonts\\Arial.ttf",
+];
+/**
+ * Burn a headline onto a single frame from the source video and write
+ * it to disk. Returns the resolved font path so callers can surface it
+ * in their output.
+ *
+ * Throws on:
+ *   - no system font found (and none provided)
+ *   - ffmpeg drawtext exit ≠ 0
+ */
+export async function composeThumbnailFrame(opts, cwd = process.cwd()) {
+    const fontFile = opts.fontFile ? resolvePath(cwd, opts.fontFile) : pickFont();
+    if (!fontFile) {
+        throw new Error("no system font found — pass fontFile=<path-to-.ttf> (~/Library/Fonts on macOS, /usr/share/fonts on Linux)");
+    }
+    const fontSize = opts.fontSize ?? 96;
+    const fontColor = opts.fontColor ?? "white";
+    const outlineColor = opts.outlineColor === "" ? "" : (opts.outlineColor ?? "black");
+    const pos = opts.position ?? "bottom";
+    const yExpr = pos === "top" ? "h*0.08" : pos === "center" ? "(h-text_h)/2" : "h-text_h-h*0.08";
+    const safeText = escapeDrawtextValue(opts.text);
+    const drawText = `drawtext=fontfile=${escapeFilterPath(fontFile)}:` +
+        `text='${safeText}':` +
+        `fontsize=${fontSize}:` +
+        `fontcolor=${fontColor}:` +
+        `x=(w-text_w)/2:` +
+        `y=${yExpr}` +
+        (outlineColor ? `:bordercolor=${outlineColor}:borderw=4` : "");
+    const vf = opts.width ? `scale=${opts.width}:-1,${drawText}` : drawText;
+    mkdirSync(dirname(opts.output), { recursive: true });
+    const r = await runFfmpeg([
+        "-ss",
+        String(opts.atSec),
+        "-i",
+        opts.input,
+        "-frames:v",
+        "1",
+        "-vf",
+        vf,
+        "-q:v",
+        "2",
+        opts.output,
+    ], { signal: opts.signal });
+    if (r.code !== 0) {
+        throw new Error(`ffmpeg drawtext exited ${r.code} — verify atSec is in range and ffmpeg has --enable-libfreetype`);
+    }
+    return { ok: true, path: opts.output, fontFile };
+}
+export function pickFont() {
+    for (const p of SYSTEM_FONT_GUESSES) {
+        try {
+            if (existsSync(p))
+                return p;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return undefined;
+}
+function escapeFilterPath(p) {
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:").replace(/'/g, "\\'");
+}
+/**
+ * Escape a string for ffmpeg drawtext's `text='...'` parameter.
+ *
+ * Rules (verified against real-world implementations):
+ *   1. `\\` first  → `\\\\`
+ *   2. `:`         → `\\:`
+ *   3. `'`         → `\\'`
+ *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions)
+ *   5. newlines    → literal `\\n` (drawtext renders as a line break)
+ *
+ * Backslash MUST come first so subsequent escapes don't double-escape.
+ */
+export function escapeDrawtextValue(text) {
+    return text
+        .replace(/\\/g, "\\\\")
+        .replace(/:/g, "\\:")
+        .replace(/'/g, "\\'")
+        .replace(/%/g, "\\%")
+        .replace(/\r\n?|\n/g, "\\n");
+}
+//# sourceMappingURL=thumbnail-compose.js.map

package/dist/core/thumbnail-compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-compose.js","sourceRoot":"","sources":["../../src/core/thumbnail-compose.ts"],"names":[],"mappings":"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"}

package/dist/core/thumbnail-promise.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Thumbnail-promise verifier.
+ *
+ * The thumbnail makes a visual promise (a man underwater, a huge pile
+ * of money, a broken phone). Per the MrBeast manual: "match the
+ * clickbait expectations and front-load." If the promised element
+ * doesn't show up until minute 8, retention craters before the payoff.
+ *
+ * This module asks the vision model to:
+ *   1. Look at the thumbnail FIRST and identify the visual promise.
+ *   2. Look at N sampled frames from the opening window.
+ *   3. Score how well those frames deliver on (or build up to) the
+ *      promise.
+ *
+ * One LLM call, structured JSON out. Pure parser exported for tests.
+ */
+export interface ThumbnailPromiseResult {
+    /** 0..1 — how well the opening delivers on the thumbnail's visual promise. */
+    matches: number;
+    /** ≤200 char description of what the thumbnail is promising. */
+    thumbnailPromise: string;
+    /** ≤200 char description of what the opening frames actually show. */
+    openingShows: string;
+    /** Up to 4 specific elements promised by the thumbnail but missing from the opening. */
+    missing: string[];
+    /** ≤200 char actionable suggestion. */
+    suggestion: string;
+}
+export interface VerifyOptions {
+    apiKey?: string;
+    model?: string;
+    detail?: "low" | "high";
+    /** Window length used to sample frames; surfaced in the prompt for context. */
+    windowSec: number;
+    signal?: AbortSignal;
+}
+/**
+ * Run ONE vision call against the thumbnail + N opening frames.
+ */
+export declare function runThumbnailPromise(thumbnailPath: string, framePaths: string[], opts: VerifyOptions): Promise<ThumbnailPromiseResult>;
+/**
+ * Parse the model's JSON. Robust to missing keys; clamps `matches` to
+ * [0, 1] and caps strings. Pure — exported for testing.
+ */
+export declare function parsePromiseResponse(content: string): ThumbnailPromiseResult;
+//# sourceMappingURL=thumbnail-promise.d.ts.map

package/dist/core/thumbnail-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-promise.d.ts","sourceRoot":"","sources":["../../src/core/thumbnail-promise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,sBAAsB,CAAC,CA+DjC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAoB5E"}

package/dist/core/thumbnail-promise.js

@@ -0,0 +1,133 @@
+/**
+ * Thumbnail-promise verifier.
+ *
+ * The thumbnail makes a visual promise (a man underwater, a huge pile
+ * of money, a broken phone). Per the MrBeast manual: "match the
+ * clickbait expectations and front-load." If the promised element
+ * doesn't show up until minute 8, retention craters before the payoff.
+ *
+ * This module asks the vision model to:
+ *   1. Look at the thumbnail FIRST and identify the visual promise.
+ *   2. Look at N sampled frames from the opening window.
+ *   3. Score how well those frames deliver on (or build up to) the
+ *      promise.
+ *
+ * One LLM call, structured JSON out. Pure parser exported for tests.
+ */
+import { readFileSync } from "node:fs";
+import { resolveApiKey } from "./auth/api-keys.js";
+const SYSTEM = `You verify that a YouTube thumbnail's visual promise is delivered in the OPENING N seconds of the video.
+
+Process:
+  1. Look at the THUMBNAIL FIRST. What concrete visual element is it promising? (e.g. "man underwater", "huge pile of money", "broken phone screen", "1000 mousetraps".) The promise is what would make a scroller click.
+  2. Then look at the N sampled OPENING FRAMES (in order). They were sampled across the first windowSec seconds of the video.
+  3. Decide: does the promised element appear in the opening? Is it CLEARLY building toward the promise? Or is the opening a logo slate / unrelated b-roll?
+
+Output JSON with these EXACT keys:
+{
+  "matches":          <0..1>,
+  "thumbnailPromise": "<≤200 char>",
+  "openingShows":     "<≤200 char>",
+  "missing":          [<≤80 char>, ...],   // 0-4 entries; promised elements absent in opening
+  "suggestion":       "<≤200 char>"
+}
+
+Scoring rubric:
+  1.0 = promised element is on-screen within the opening window.
+  0.7 = element is clearly being built up to (visible in last sampled frame, or directly referenced).
+  0.4 = related but indirect — a tease without the payoff.
+  0.0 = no connection. Logo slate, unrelated b-roll, or completely different content.
+
+Be honest. A thumbnail that promises X but shows X at minute 8 must score low even if the eventual payoff is good — retention is decided in seconds.`;
+/**
+ * Run ONE vision call against the thumbnail + N opening frames.
+ */
+export async function runThumbnailPromise(thumbnailPath, framePaths, opts) {
+    const apiKey = opts.apiKey ?? resolveApiKey("OPENAI_API_KEY", "openai");
+    if (!apiKey)
+        throw new Error("OPENAI_API_KEY required for verify_thumbnail_promise.");
+    const model = opts.model ?? "gpt-4o-mini";
+    const detail = opts.detail ?? "low";
+    const thumbB64 = readFileSync(thumbnailPath).toString("base64");
+    const thumbMime = thumbnailPath.toLowerCase().endsWith(".png") ? "image/png" : "image/jpeg";
+    const userContent = [
+        { type: "text", text: "THUMBNAIL:" },
+        {
+            type: "image_url",
+            image_url: { url: `data:${thumbMime};base64,${thumbB64}`, detail },
+        },
+        {
+            type: "text",
+            text: `OPENING FRAMES (${framePaths.length} samples across the first ${opts.windowSec}s):`,
+        },
+    ];
+    for (let i = 0; i < framePaths.length; i++) {
+        const p = framePaths[i];
+        const mime = p.toLowerCase().endsWith(".png") ? "image/png" : "image/jpeg";
+        const b64 = readFileSync(p).toString("base64");
+        userContent.push({ type: "text", text: `FRAME ${i + 1}/${framePaths.length}:` });
+        userContent.push({
+            type: "image_url",
+            image_url: { url: `data:${mime};base64,${b64}`, detail },
+        });
+    }
+    const body = {
+        model,
+        messages: [
+            { role: "system", content: SYSTEM },
+            { role: "user", content: userContent },
+        ],
+        response_format: { type: "json_object" },
+        max_tokens: 2000,
+        temperature: 0,
+    };
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+        signal: opts.signal,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`OpenAI HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    const data = (await res.json());
+    const content = data.choices[0]?.message?.content;
+    if (!content)
+        throw new Error("verify_thumbnail_promise: empty model response");
+    return parsePromiseResponse(content);
+}
+/**
+ * Parse the model's JSON. Robust to missing keys; clamps `matches` to
+ * [0, 1] and caps strings. Pure — exported for testing.
+ */
+export function parsePromiseResponse(content) {
+    const start = content.indexOf("{");
+    const end = content.lastIndexOf("}");
+    if (start < 0 || end < start) {
+        throw new Error("verify_thumbnail_promise: no JSON object in response");
+    }
+    const parsed = JSON.parse(content.slice(start, end + 1));
+    const missing = Array.isArray(parsed.missing)
+        ? parsed.missing
+            .map((v) => String(v ?? "").slice(0, 100))
+            .filter((v) => v.length > 0)
+            .slice(0, 4)
+        : [];
+    return {
+        matches: clamp01(Number(parsed.matches)),
+        thumbnailPromise: String(parsed.thumbnailPromise ?? "").slice(0, 240),
+        openingShows: String(parsed.openingShows ?? "").slice(0, 240),
+        missing,
+        suggestion: String(parsed.suggestion ?? "").slice(0, 240),
+    };
+}
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+//# sourceMappingURL=thumbnail-promise.js.map

package/dist/core/thumbnail-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-promise.js","sourceRoot":"","sources":["../../src/core/thumbnail-promise.ts"],"names":[],"mappings":"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"}

package/dist/core/thumbnail-promise.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thumbnail-promise.test.d.ts.map

package/dist/core/thumbnail-promise.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-promise.test.d.ts","sourceRoot":"","sources":["../../src/core/thumbnail-promise.test.ts"],"names":[],"mappings":""}

package/dist/core/thumbnail-promise.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import { parsePromiseResponse } from "./thumbnail-promise.js";
+describe("parsePromiseResponse", () => {
+    it("parses a complete response", () => {
+        const content = JSON.stringify({
+            matches: 0.7,
+            thumbnailPromise: "man underwater",
+            openingShows: "man near pool",
+            missing: ["actually being submerged"],
+            suggestion: "cut to underwater shot at 0:02",
+        });
+        const r = parsePromiseResponse(content);
+        expect(r.matches).toBeCloseTo(0.7);
+        expect(r.thumbnailPromise).toBe("man underwater");
+        expect(r.missing).toEqual(["actually being submerged"]);
+    });
+    it("clamps matches to [0,1]", () => {
+        const r = parsePromiseResponse(JSON.stringify({
+            matches: 5,
+            thumbnailPromise: "",
+            openingShows: "",
+            missing: [],
+            suggestion: "",
+        }));
+        expect(r.matches).toBe(1);
+        const r2 = parsePromiseResponse(JSON.stringify({
+            matches: -0.5,
+            thumbnailPromise: "",
+            openingShows: "",
+            missing: [],
+            suggestion: "",
+        }));
+        expect(r2.matches).toBe(0);
+    });
+    it("caps missing at 4 entries", () => {
+        const r = parsePromiseResponse(JSON.stringify({
+            matches: 0.5,
+            missing: ["a", "b", "c", "d", "e", "f"],
+        }));
+        expect(r.missing).toHaveLength(4);
+    });
+    it("tolerates missing keys", () => {
+        const r = parsePromiseResponse(JSON.stringify({}));
+        expect(r.matches).toBe(0);
+        expect(r.thumbnailPromise).toBe("");
+        expect(r.missing).toEqual([]);
+    });
+    it("throws on non-JSON", () => {
+        expect(() => parsePromiseResponse("not json")).toThrow();
+    });
+});
+//# sourceMappingURL=thumbnail-promise.test.js.map

package/dist/core/thumbnail-promise.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-promise.test.js","sourceRoot":"","sources":["../../src/core/thumbnail-promise.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,OAAO,EAAE,GAAG;YACZ,gBAAgB,EAAE,gBAAgB;YAClC,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,CAAC,0BAA0B,CAAC;YACrC,UAAU,EAAE,gCAAgC;SAC7C,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,oBAAoB,CAC5B,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,CAAC;YACV,gBAAgB,EAAE,EAAE;YACpB,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;SACf,CAAC,CACH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,oBAAoB,CAC7B,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,CAAC,GAAG;YACb,gBAAgB,EAAE,EAAE;YACpB,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;SACf,CAAC,CACH,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,oBAAoB,CAC5B,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;SACxC,CAAC,CACH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/core/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAWA,wBAAgB,iBAAiB,IAAI,MAAM,CAa1C"}

package/dist/core/version.js

@@ -0,0 +1,26 @@
+/**
+ * Read the package version from the shipped package.json. Used by
+ * banners + the TUI so the version label always matches the installed
+ * artifact, no matter what the dev's local 0.1.0 placeholder said.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+let cached;
+export function getPackageVersion() {
+    if (cached)
+        return cached;
+    // dist/core/version.js → ../../package.json
+    // src/core/version.ts (during tests) → ../../package.json
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkgPath = join(here, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        cached = pkg.version ?? "0.0.0";
+    }
+    catch {
+        cached = "0.0.0";
+    }
+    return cached;
+}
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAA0B,CAAC;AAE/B,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,0DAA0D;IAC1D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC9E,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/viral-moments.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Long-form → multi-shorts orchestrator.
+ *
+ * The "1 hour podcast → 10 shorts" pipeline. Slides a window across a
+ * transcript, asks the LLM to nominate up to 3 candidate clips inside
+ * each window, then `score_clip`'s every nominee, dedups overlaps, and
+ * returns the top-N.
+ *
+ * Pure helpers + the LLM proposal step live here so the tool wrapper
+ * can stay thin. The ranking + dedup pass is plain TS — easy to unit
+ * test without the network.
+ */
+import type { Transcript } from "./whisper.js";
+export interface ViralCandidate {
+    startSec: number;
+    endSec: number;
+    hookLine: string;
+    suggestedTitle: string;
+    suggestedCaption: string;
+    why: string;
+}
+export interface ScoredCandidate extends ViralCandidate {
+    score: number;
+    hook: number;
+    flow: number;
+    engagement: number;
+    trend: number;
+    durationSec: number;
+}
+export interface WindowSpec {
+    startSec: number;
+    endSec: number;
+    /** Transcript text within this window, already extracted. */
+    text: string;
+}
+/**
+ * Slice the transcript into overlapping windows. Each window covers
+ * `windowSec` seconds with `overlapSec` spillover into the next so a
+ * clip straddling a boundary can still be proposed by at least one
+ * window. The dedup step later collapses duplicates.
+ *
+ * Pure — exported for unit testing.
+ */
+export declare function buildSlidingWindows(t: Transcript, windowSec: number, overlapSec: number): WindowSpec[];
+/**
+ * Dedup overlapping candidates: when two candidates overlap > 50% (of
+ * the smaller), keep the higher-scoring one. Stable / sort-agnostic —
+ * the function sorts internally before walking.
+ *
+ * Pure — exported for testing.
+ */
+export declare function dedupCandidates(cands: ScoredCandidate[]): ScoredCandidate[];
+/**
+ * Clamp candidate ranges to [0, totalSec] and to the requested duration
+ * range. Drops candidates that fall outside or are degenerate.
+ */
+export declare function normalizeCandidates(cands: ViralCandidate[], totalSec: number, minSec: number, maxSec: number): ViralCandidate[];
+export interface ProposeOptions {
+    apiKey?: string;
+    model?: string;
+    durationRange: [number, number];
+    signal?: AbortSignal;
+}
+export declare function proposeCandidates(window: WindowSpec, opts: ProposeOptions): Promise<ViralCandidate[]>;
+/**
+ * Tolerant parser. Drops malformed entries silently (we'd rather skip a
+ * bad candidate than blow up the whole window).
+ */
+export declare function parseProposalResponse(content: string): ViralCandidate[];
+//# sourceMappingURL=viral-moments.d.ts.map

package/dist/core/viral-moments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viral-moments.d.ts","sourceRoot":"","sources":["../../src/core/viral-moments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,UAAU,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,UAAU,EAAE,CAiBd;AAWD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAS3E;AAeD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,cAAc,EAAE,CAYlB;AAiBD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAqC3B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CA+BvE"}