@prestyj/editor 0.7.1

package/dist/tools/trim-dead-air.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+/**
+ * trim_dead_air — single-call wrapper that detects head/tail (or all) silence
+ * via `silencedetect` and produces a trimmed mp4. The agent normally chains
+ * `detect_silence` + `write_edl` + `import_edl` for full silence cleanup;
+ * this tool collapses the most-common case (chop the dead air at the start
+ * and end of a recording) into one call.
+ *
+ * Modes:
+ *   - "head-tail" (default): trim only leading and trailing silence
+ *   - "all": cut every silence run >= minSilenceSec, re-encode the keeps
+ *     concatenated. Same end-state as the EDL pipeline but produces a flat
+ *     file the user can drop into any NLE.
+ */
+declare const TrimDeadAirParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        "head-tail": "head-tail";
+    }>>;
+    minSilenceSec: z.ZodOptional<z.ZodNumber>;
+    thresholdDb: z.ZodOptional<z.ZodNumber>;
+    paddingSec: z.ZodOptional<z.ZodNumber>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+    audioBitrate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createTrimDeadAirTool(cwd: string): AgentTool<typeof TrimDeadAirParams>;
+/**
+ * Compute keep ranges from detected silences.
+ *
+ * mode='head-tail': only the leading silence (if any starts at ~0) and the
+ *   trailing silence (if any ends at totalSec) are removed; everything in
+ *   between is one big keep range.
+ * mode='all': inverse of all detected silences — every gap between silences
+ *   becomes a keep range.
+ *
+ * Padding extends each keep outward; clamped to [0, totalSec] and to its
+ * neighbours so adjacent keeps never overlap.
+ */
+export declare function computeKeeps(silences: Array<{
+    startSec: number;
+    endSec: number;
+}>, totalSec: number, mode: "head-tail" | "all", paddingSec: number): Array<{
+    startSec: number;
+    endSec: number;
+}>;
+/**
+ * Build an ffmpeg filter_complex that trims to N keep ranges and concats
+ * them into a single video+audio output labelled [v][a].
+ */
+export declare function buildTrimConcatFilter(keeps: Array<{
+    startSec: number;
+    endSec: number;
+}>): string;
+export {};
+//# sourceMappingURL=trim-dead-air.d.ts.map

package/dist/tools/trim-dead-air.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-dead-air.d.ts","sourceRoot":"","sources":["../../src/tools/trim-dead-air.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;iBAiCrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAgGtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,GAAG,KAAK,EACzB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAqBhG"}

package/dist/tools/trim-dead-air.js

@@ -0,0 +1,215 @@
+import { mkdirSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+import { parseSilenceDetect } from "../core/silence.js";
+/**
+ * trim_dead_air — single-call wrapper that detects head/tail (or all) silence
+ * via `silencedetect` and produces a trimmed mp4. The agent normally chains
+ * `detect_silence` + `write_edl` + `import_edl` for full silence cleanup;
+ * this tool collapses the most-common case (chop the dead air at the start
+ * and end of a recording) into one call.
+ *
+ * Modes:
+ *   - "head-tail" (default): trim only leading and trailing silence
+ *   - "all": cut every silence run >= minSilenceSec, re-encode the keeps
+ *     concatenated. Same end-state as the EDL pipeline but produces a flat
+ *     file the user can drop into any NLE.
+ */
+const TrimDeadAirParams = z.object({
+    input: z.string().describe("Source audio/video file (relative resolves to cwd)."),
+    output: z.string().describe("Output file path. Re-encoded; sets sensible H.264/AAC defaults."),
+    mode: z
+        .enum(["head-tail", "all"])
+        .optional()
+        .describe("head-tail (default) trims only leading and trailing silence — the universal 'before " +
+        "I started talking' / 'after I finished' cleanup. all removes every silence run >= " +
+        "minSilenceSec via concat-keep ranges (same end-state as detect_silence → write_edl → " +
+        "import_edl, but produces a flat file)."),
+    minSilenceSec: z
+        .number()
+        .min(0.1)
+        .optional()
+        .describe("Min silence duration to count. Default 0.5s."),
+    thresholdDb: z
+        .number()
+        .max(0)
+        .optional()
+        .describe("Silence threshold in dB. Default -30. Lower (e.g. -40) = stricter, only true silence " +
+        "counts; higher (-20) catches mumble."),
+    paddingSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Pad each kept segment outward by this much. Default 0.05 (50ms)."),
+    videoCodec: z.string().optional().describe("ffmpeg video codec. Default libx264."),
+    crf: z.number().int().min(0).max(51).optional().describe("x264 CRF. Default 20."),
+    audioBitrate: z.string().optional().describe("Audio bitrate. Default '192k'."),
+});
+export function createTrimDeadAirTool(cwd) {
+    return {
+        name: "trim_dead_air",
+        description: "Trim silence from a recording in one call. mode='head-tail' (default) chops only the " +
+            "leading/trailing dead air — the universal 'recording started early' fix. mode='all' " +
+            "removes every silence run >= minSilenceSec and concats the keeps into a flat file. For " +
+            "fine-grained per-cut control, use detect_silence → write_edl → import_edl instead. " +
+            "Returns {path, removedSec, kept}.",
+        parameters: TrimDeadAirParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const outAbs = safeOutputPath(cwd, args.output);
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is readable");
+                const totalSec = probe.durationSec;
+                const mode = args.mode ?? "head-tail";
+                const minSil = args.minSilenceSec ?? 0.5;
+                const threshDb = args.thresholdDb ?? -30;
+                const padSec = args.paddingSec ?? 0.05;
+                // Run silencedetect on the input.
+                const detect = await runFfmpeg(["-i", inAbs, "-af", `silencedetect=noise=${threshDb}dB:d=${minSil}`, "-f", "null", "-"], { signal: ctx.signal });
+                // silencedetect writes to stderr; non-zero exit on a normal run is unusual but tolerated.
+                const ranges = parseSilenceDetect(detect.stderr, totalSec);
+                // Compute keep ranges per mode.
+                const keeps = computeKeeps(ranges, totalSec, mode, padSec);
+                if (keeps.length === 0) {
+                    return err("no audible content remains after trim", "loosen thresholdDb (e.g. -40) or shorten minSilenceSec");
+                }
+                const removedSec = +(totalSec - keeps.reduce((a, k) => a + (k.endSec - k.startSec), 0)).toFixed(3);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                // Build trim+concat filter graph. For head-tail with one keep range, this is
+                // a single trim. For 'all' with N keeps it's N trim/atrim pairs concatted.
+                const videoCodec = args.videoCodec ?? "libx264";
+                const crf = args.crf ?? 20;
+                const audioBitrate = args.audioBitrate ?? "192k";
+                const filter = buildTrimConcatFilter(keeps);
+                const ffArgs = [
+                    "-i",
+                    inAbs,
+                    "-filter_complex",
+                    filter,
+                    "-map",
+                    "[v]",
+                    "-map",
+                    "[a]",
+                    "-c:v",
+                    videoCodec,
+                    "-crf",
+                    String(crf),
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    audioBitrate,
+                    outAbs,
+                ];
+                const r = await runFfmpeg(ffArgs, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg exited ${r.code}`, "check that the input has both video and audio streams");
+                }
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    mode,
+                    totalSec,
+                    removedSec,
+                    kept: keeps.length,
+                    keeps: keeps.map((k) => ({
+                        startSec: +k.startSec.toFixed(3),
+                        endSec: +k.endSec.toFixed(3),
+                    })),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Compute keep ranges from detected silences.
+ *
+ * mode='head-tail': only the leading silence (if any starts at ~0) and the
+ *   trailing silence (if any ends at totalSec) are removed; everything in
+ *   between is one big keep range.
+ * mode='all': inverse of all detected silences — every gap between silences
+ *   becomes a keep range.
+ *
+ * Padding extends each keep outward; clamped to [0, totalSec] and to its
+ * neighbours so adjacent keeps never overlap.
+ */
+export function computeKeeps(silences, totalSec, mode, paddingSec) {
+    if (totalSec <= 0)
+        return [];
+    const sorted = [...silences].sort((a, b) => a.startSec - b.startSec);
+    if (mode === "head-tail") {
+        let start = 0;
+        let end = totalSec;
+        const head = sorted[0];
+        if (head && head.startSec <= 0.05)
+            start = head.endSec;
+        const tail = sorted[sorted.length - 1];
+        if (tail && tail.endSec >= totalSec - 0.05)
+            end = tail.startSec;
+        start = Math.max(0, start - paddingSec);
+        end = Math.min(totalSec, end + paddingSec);
+        if (end <= start)
+            return [];
+        return [{ startSec: start, endSec: end }];
+    }
+    // mode === "all"
+    const keeps = [];
+    let cursor = 0;
+    for (const s of sorted) {
+        if (s.startSec > cursor) {
+            const start = Math.max(0, cursor - paddingSec);
+            const end = Math.min(totalSec, s.startSec + paddingSec);
+            if (end > start)
+                keeps.push({ startSec: start, endSec: end });
+        }
+        cursor = Math.max(cursor, s.endSec);
+    }
+    if (cursor < totalSec) {
+        const start = Math.max(0, cursor - paddingSec);
+        keeps.push({ startSec: start, endSec: totalSec });
+    }
+    // Stitch overlaps caused by padding.
+    const merged = [];
+    for (const k of keeps) {
+        const prev = merged[merged.length - 1];
+        if (prev && k.startSec <= prev.endSec) {
+            prev.endSec = Math.max(prev.endSec, k.endSec);
+        }
+        else {
+            merged.push({ ...k });
+        }
+    }
+    return merged;
+}
+/**
+ * Build an ffmpeg filter_complex that trims to N keep ranges and concats
+ * them into a single video+audio output labelled [v][a].
+ */
+export function buildTrimConcatFilter(keeps) {
+    if (keeps.length === 0)
+        throw new Error("buildTrimConcatFilter: at least one keep range required");
+    if (keeps.length === 1) {
+        const k = keeps[0];
+        return (`[0:v]trim=start=${k.startSec}:end=${k.endSec},setpts=PTS-STARTPTS[v];` +
+            `[0:a]atrim=start=${k.startSec}:end=${k.endSec},asetpts=PTS-STARTPTS[a]`);
+    }
+    const segs = [];
+    const labels = [];
+    keeps.forEach((k, i) => {
+        segs.push(`[0:v]trim=start=${k.startSec}:end=${k.endSec},setpts=PTS-STARTPTS[v${i}];` +
+            `[0:a]atrim=start=${k.startSec}:end=${k.endSec},asetpts=PTS-STARTPTS[a${i}]`);
+        labels.push(`[v${i}][a${i}]`);
+    });
+    segs.push(`${labels.join("")}concat=n=${keeps.length}:v=1:a=1[v][a]`);
+    return segs.join(";");
+}
+//# sourceMappingURL=trim-dead-air.js.map

package/dist/tools/trim-dead-air.js.map

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

package/dist/tools/trim-dead-air.test.d.ts

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

package/dist/tools/trim-dead-air.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-dead-air.test.d.ts","sourceRoot":"","sources":["../../src/tools/trim-dead-air.test.ts"],"names":[],"mappings":""}

package/dist/tools/trim-dead-air.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { buildTrimConcatFilter, computeKeeps } from "./trim-dead-air.js";
+describe("computeKeeps", () => {
+    it("head-tail trims leading and trailing silence", () => {
+        const sil = [
+            { startSec: 0, endSec: 1.5 },
+            { startSec: 28, endSec: 30 },
+        ];
+        const keeps = computeKeeps(sil, 30, "head-tail", 0);
+        expect(keeps).toEqual([{ startSec: 1.5, endSec: 28 }]);
+    });
+    it("head-tail keeps mid-recording silence intact", () => {
+        const sil = [
+            { startSec: 0, endSec: 1 },
+            { startSec: 10, endSec: 12 },
+            { startSec: 29, endSec: 30 },
+        ];
+        const keeps = computeKeeps(sil, 30, "head-tail", 0);
+        expect(keeps).toEqual([{ startSec: 1, endSec: 29 }]);
+    });
+    it("head-tail returns full duration when no silences detected", () => {
+        const keeps = computeKeeps([], 30, "head-tail", 0);
+        expect(keeps).toEqual([{ startSec: 0, endSec: 30 }]);
+    });
+    it("all mode emits keeps between every silence", () => {
+        const sil = [
+            { startSec: 5, endSec: 6 },
+            { startSec: 12, endSec: 13 },
+        ];
+        const keeps = computeKeeps(sil, 20, "all", 0);
+        expect(keeps).toEqual([
+            { startSec: 0, endSec: 5 },
+            { startSec: 6, endSec: 12 },
+            { startSec: 13, endSec: 20 },
+        ]);
+    });
+    it("padding extends keeps and merges overlaps", () => {
+        const sil = [
+            { startSec: 5, endSec: 5.1 },
+            { startSec: 5.3, endSec: 5.4 },
+        ];
+        // Padding of 0.2 makes the two surrounding keeps overlap, merging to one.
+        const keeps = computeKeeps(sil, 10, "all", 0.2);
+        expect(keeps.length).toBe(1);
+        expect(keeps[0].startSec).toBeCloseTo(0, 5);
+        expect(keeps[0].endSec).toBeCloseTo(10, 5);
+    });
+    it("returns empty when totalSec is 0", () => {
+        expect(computeKeeps([], 0, "head-tail", 0)).toEqual([]);
+    });
+});
+describe("buildTrimConcatFilter", () => {
+    it("single keep emits one trim + atrim labelled [v][a]", () => {
+        const f = buildTrimConcatFilter([{ startSec: 1, endSec: 5 }]);
+        expect(f).toContain("trim=start=1:end=5");
+        expect(f).toContain("atrim=start=1:end=5");
+        expect(f).toContain("[v]");
+        expect(f).toContain("[a]");
+    });
+    it("multiple keeps emit per-segment trims and a concat", () => {
+        const f = buildTrimConcatFilter([
+            { startSec: 0, endSec: 2 },
+            { startSec: 5, endSec: 8 },
+        ]);
+        expect(f).toContain("[v0]");
+        expect(f).toContain("[v1]");
+        expect(f).toContain("[a0]");
+        expect(f).toContain("[a1]");
+        expect(f).toContain("concat=n=2:v=1:a=1[v][a]");
+    });
+    it("throws on empty keep list", () => {
+        expect(() => buildTrimConcatFilter([])).toThrow();
+    });
+});
+//# sourceMappingURL=trim-dead-air.test.js.map

package/dist/tools/trim-dead-air.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-dead-air.test.js","sourceRoot":"","sources":["../../src/tools/trim-dead-air.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/verify-thumbnail-promise.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const VerifyThumbnailPromiseParams: z.ZodObject<{
+    thumbnail: z.ZodString;
+    video: z.ZodString;
+    windowSec: z.ZodOptional<z.ZodNumber>;
+    sampleCount: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * verify_thumbnail_promise — does the opening deliver on the thumbnail?
+ *
+ * Per MrBeast's manual: "match the clickbait expectations and
+ * front-load." Thumbnails that promise X but show X at minute 8 tank
+ * retention. ONE vision LLM call against thumbnail + N sampled frames.
+ */
+export declare function createVerifyThumbnailPromiseTool(cwd: string): AgentTool<typeof VerifyThumbnailPromiseParams>;
+/**
+ * Compute N sample timestamps evenly distributed across [0, windowSec].
+ *  - 1 sample → [0]
+ *  - 2 samples → [0, windowSec]
+ *  - 3 samples → [0, windowSec/2, windowSec]
+ *  - 4+ → endpoints + interior at equal stride
+ *
+ * Pure — exported for testing.
+ */
+export declare function sampleTimes(windowSec: number, n: number): number[];
+export {};
+//# sourceMappingURL=verify-thumbnail-promise.d.ts.map

package/dist/tools/verify-thumbnail-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-thumbnail-promise.d.ts","sourceRoot":"","sources":["../../src/tools/verify-thumbnail-promise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,4BAA4B;;;;;;;;;;iBAqBhC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,4BAA4B,CAAC,CAiEhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlE"}

package/dist/tools/verify-thumbnail-promise.js

@@ -0,0 +1,112 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg, probeMedia } from "../core/media/ffmpeg.js";
+import { runThumbnailPromise } from "../core/thumbnail-promise.js";
+const VerifyThumbnailPromiseParams = z.object({
+    thumbnail: z.string().describe("Path to the thumbnail .jpg/.png (relative resolves to cwd)."),
+    video: z.string().describe("Path to the source video the thumbnail accompanies."),
+    windowSec: z
+        .number()
+        .positive()
+        .max(120)
+        .optional()
+        .describe("How much of the opening to sample. Default 60s — short-form delivery's danger zone is " +
+        "the first minute."),
+    sampleCount: z
+        .number()
+        .int()
+        .min(1)
+        .max(8)
+        .optional()
+        .describe("Frames sampled within the window. Default 3 (taken at 0%, 50%, 100% of windowSec)."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+/**
+ * verify_thumbnail_promise — does the opening deliver on the thumbnail?
+ *
+ * Per MrBeast's manual: "match the clickbait expectations and
+ * front-load." Thumbnails that promise X but show X at minute 8 tank
+ * retention. ONE vision LLM call against thumbnail + N sampled frames.
+ */
+export function createVerifyThumbnailPromiseTool(cwd) {
+    return {
+        name: "verify_thumbnail_promise",
+        description: "Verify a thumbnail's visual promise is delivered in the first N seconds of the video " +
+            "(default 60s). Per MrBeast's manual: 'match clickbait expectations, front-load' — " +
+            "thumbnails that promise X but show X at minute 8 tank retention. ONE vision LLM " +
+            "call. Returns matches (0-1), what the thumbnail promises, what the opening actually " +
+            "shows, missing elements, and a one-line suggestion. ALWAYS run before declaring done " +
+            "on any short-form delivery. Pair with `audit_first_frame` and `analyze_hook` as the " +
+            "three short-form pre-render checks.",
+        parameters: VerifyThumbnailPromiseParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (!process.env.OPENAI_API_KEY) {
+                return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+            }
+            try {
+                const thumbAbs = resolvePath(cwd, args.thumbnail);
+                const videoAbs = resolvePath(cwd, args.video);
+                const probe = probeMedia(videoAbs);
+                if (!probe) {
+                    return err(`probe failed for ${videoAbs}`, "verify file exists and is media");
+                }
+                const windowSec = Math.min(args.windowSec ?? 60, probe.durationSec);
+                if (windowSec < 1) {
+                    return err("video shorter than 1s — nothing to verify against");
+                }
+                const sampleCount = Math.min(8, Math.max(1, args.sampleCount ?? 3));
+                const times = sampleTimes(windowSec, sampleCount);
+                const frames = await extractAtTimes(videoAbs, times, {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                if (frames.length === 0) {
+                    return err("could not extract opening frames");
+                }
+                const result = await runThumbnailPromise(thumbAbs, frames.map((f) => f.path), {
+                    model: args.model,
+                    detail: args.detail,
+                    windowSec,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    matches: +result.matches.toFixed(2),
+                    thumbnailPromise: result.thumbnailPromise,
+                    openingShows: result.openingShows,
+                    missing: result.missing,
+                    suggestion: result.suggestion,
+                    windowSec: +windowSec.toFixed(2),
+                    sampleCount: frames.length,
+                    sampledAt: times.map((t) => +t.toFixed(2)),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Compute N sample timestamps evenly distributed across [0, windowSec].
+ *  - 1 sample → [0]
+ *  - 2 samples → [0, windowSec]
+ *  - 3 samples → [0, windowSec/2, windowSec]
+ *  - 4+ → endpoints + interior at equal stride
+ *
+ * Pure — exported for testing.
+ */
+export function sampleTimes(windowSec, n) {
+    if (n <= 1 || windowSec <= 0)
+        return [0];
+    const out = [];
+    const step = windowSec / (n - 1);
+    for (let i = 0; i < n; i++)
+        out.push(+(i * step).toFixed(3));
+    return out;
+}
+//# sourceMappingURL=verify-thumbnail-promise.js.map

package/dist/tools/verify-thumbnail-promise.js.map

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

package/dist/tools/verify-thumbnail-promise.test.d.ts

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

package/dist/tools/verify-thumbnail-promise.test.d.ts.map

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

package/dist/tools/verify-thumbnail-promise.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from "vitest";
+import { createVerifyThumbnailPromiseTool, sampleTimes } from "./verify-thumbnail-promise.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("sampleTimes", () => {
+    it("returns single sample at 0 when n=1", () => {
+        expect(sampleTimes(60, 1)).toEqual([0]);
+    });
+    it("returns endpoints when n=2", () => {
+        expect(sampleTimes(60, 2)).toEqual([0, 60]);
+    });
+    it("returns 0/mid/end when n=3", () => {
+        expect(sampleTimes(60, 3)).toEqual([0, 30, 60]);
+    });
+    it("evenly distributes for n=5", () => {
+        const t = sampleTimes(40, 5);
+        expect(t).toHaveLength(5);
+        expect(t[0]).toBe(0);
+        expect(t[t.length - 1]).toBe(40);
+    });
+});
+describe("verify_thumbnail_promise tool", () => {
+    it("description names front-load + matches + always-run + algorithm pairing", () => {
+        const tool = createVerifyThumbnailPromiseTool("/tmp");
+        expect(tool.description).toMatch(/front-load|MrBeast/);
+        expect(tool.description).toMatch(/ALWAYS|matches/);
+        expect(tool.description).toMatch(/audit_first_frame|analyze_hook/);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createVerifyThumbnailPromiseTool("/tmp");
+        const r = await tool.execute({ thumbnail: "t.jpg", video: "v.mp4" }, ctx);
+        expect(r).toMatch(/error/);
+    });
+});
+//# sourceMappingURL=verify-thumbnail-promise.test.js.map

package/dist/tools/verify-thumbnail-promise.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-thumbnail-promise.test.js","sourceRoot":"","sources":["../../src/tools/verify-thumbnail-promise.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE9F,MAAM,GAAG,GAAG;IACV,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,UAAU,EAAE,IAAI;CAC2E,CAAC;AAE9F,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,IAAI,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAClC,MAAM,IAAI,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,MAAM,CAAC,CAAW,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/write-ass.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const WriteAssParams: z.ZodObject<{
+    output: z.ZodString;
+    cues: z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+        style: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fontName: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        primaryColor: z.ZodOptional<z.ZodString>;
+        outlineColor: z.ZodOptional<z.ZodString>;
+        shadowColor: z.ZodOptional<z.ZodString>;
+        bold: z.ZodOptional<z.ZodBoolean>;
+        italic: z.ZodOptional<z.ZodBoolean>;
+        underline: z.ZodOptional<z.ZodBoolean>;
+        alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>]>>;
+        outline: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodNumber>;
+        marginV: z.ZodOptional<z.ZodNumber>;
+        marginL: z.ZodOptional<z.ZodNumber>;
+        marginR: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    playResX: z.ZodOptional<z.ZodNumber>;
+    playResY: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createWriteAssTool(cwd: string): AgentTool<typeof WriteAssParams>;
+export {};
+//# sourceMappingURL=write-ass.d.ts.map

package/dist/tools/write-ass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-ass.d.ts","sourceRoot":"","sources":["../../src/tools/write-ass.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA2ChD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAalB,CAAC;AAeH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAkChF"}