@prestyj/editor 0.7.1

package/dist/tools/bleep-words.js

@@ -0,0 +1,211 @@
+import { mkdirSync, readFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+import { parseTranscript } from "../core/whisper.js";
+/**
+ * bleep_words — compliance / brand-safety tool. Scan a word-timestamped
+ * transcript for any occurrence of `wordList`, then either mute (silence)
+ * or bleep-overlay each range in the source audio. Outputs a re-encoded
+ * mp4 with the same video stream copied through.
+ *
+ * Two modes:
+ *   - "mute" — `volume=enable='between(t,a,b)':volume=0` per range. Cleanest;
+ *      lands as silence under the speaker's mouth movements.
+ *   - "bleep" — same mute applied AND a bleep tone (sine wave at 1kHz by
+ *     default) amix'd over the muted region. The classic broadcast censor.
+ */
+const BleepWordsParams = z.object({
+    transcript: z
+        .string()
+        .describe("Path to a transcript JSON written by transcribe(wordTimestamps=true). " +
+        "REQUIRES word-level timings — without them this tool can't locate the words."),
+    input: z.string().describe("Source video/audio file the transcript was made from."),
+    output: z.string().describe("Output file (relative resolves to cwd). Re-encoded."),
+    wordList: z
+        .array(z.string())
+        .min(1)
+        .describe("Words / phrases to censor (case-insensitive, multi-word phrases supported). Each match " +
+        "becomes a muted (or bleeped) range in the audio."),
+    mode: z
+        .enum(["mute", "bleep"])
+        .optional()
+        .describe("mute = silence the range. bleep = silence and amix a tone over it. Default 'bleep'."),
+    toneFreqHz: z.number().positive().optional().describe("Bleep tone frequency. Default 1000."),
+    paddingMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Pad each match outward by this much (ms) so the censor catches the full syllable. Default 50."),
+});
+export function createBleepWordsTool(cwd) {
+    return {
+        name: "bleep_words",
+        description: "Censor specific words / phrases in a recording. REQUIRES transcribe(wordTimestamps=true). " +
+            "mode='bleep' overlays a 1kHz tone (broadcast-style); mode='mute' just silences. Multi-word " +
+            "phrases supported. Pair with read_transcript to verify what got matched. Returns {path, " +
+            "matched, ranges}.",
+        parameters: BleepWordsParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const transcriptAbs = resolvePath(cwd, args.transcript);
+                const inAbs = resolvePath(cwd, args.input);
+                const outAbs = safeOutputPath(cwd, args.output);
+                let transcript;
+                try {
+                    transcript = parseTranscript(readFileSync(transcriptAbs, "utf8"));
+                }
+                catch (e) {
+                    return err(`cannot read/parse transcript: ${e.message}`, "verify the JSON exists and was written by transcribe()");
+                }
+                const hasWords = transcript.segments.some((s) => Array.isArray(s.words) && s.words.length > 0);
+                if (!hasWords) {
+                    return err("transcript has no word-level timings", "rerun transcribe(wordTimestamps=true) — without word timings we can't locate words");
+                }
+                const padSec = (args.paddingMs ?? 50) / 1000;
+                const ranges = findRanges(transcript, args.wordList, padSec);
+                if (ranges.length === 0) {
+                    return err("no matches found", "verify wordList — match is case-insensitive");
+                }
+                const merged = mergeRanges(ranges);
+                const mode = args.mode ?? "bleep";
+                const toneHz = args.toneFreqHz ?? 1000;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const filter = buildBleepFilter(merged, mode, toneHz);
+                const ffArgs = [
+                    "-i",
+                    inAbs,
+                    "-filter_complex",
+                    filter,
+                    "-map",
+                    "0:v",
+                    "-map",
+                    "[aout]",
+                    "-c:v",
+                    "copy",
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    "192k",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(ffArgs, { signal: ctx.signal });
+                if (r.code !== 0)
+                    return err(`ffmpeg exited ${r.code}`, "verify input has audio");
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    mode,
+                    matched: ranges.length,
+                    ranges: merged.map((m) => ({
+                        startSec: +m.startSec.toFixed(3),
+                        endSec: +m.endSec.toFixed(3),
+                    })),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Find every word-list match in the transcript. Multi-word phrases are
+ * matched against contiguous word sequences. Case-insensitive, ignores
+ * surrounding punctuation.
+ */
+export function findRanges(transcript, wordList, paddingSec) {
+    const phrases = wordList
+        .map((w) => w.trim().toLowerCase())
+        .filter((w) => w.length > 0)
+        .map((w) => w.split(/\s+/));
+    if (phrases.length === 0)
+        return [];
+    const matches = [];
+    for (const seg of transcript.segments) {
+        const words = seg.words ?? [];
+        if (words.length === 0)
+            continue;
+        const norm = words.map((w) => w.text.toLowerCase().replace(/[^a-z0-9']/g, ""));
+        for (const phrase of phrases) {
+            for (let i = 0; i + phrase.length <= words.length; i++) {
+                let hit = true;
+                for (let k = 0; k < phrase.length; k++) {
+                    if (norm[i + k] !== phrase[k]) {
+                        hit = false;
+                        break;
+                    }
+                }
+                if (hit) {
+                    const s = Math.max(0, words[i].start - paddingSec);
+                    const e = words[i + phrase.length - 1].end + paddingSec;
+                    matches.push({ startSec: s, endSec: e, text: phrase.join(" ") });
+                }
+            }
+        }
+    }
+    return matches.sort((a, b) => a.startSec - b.startSec);
+}
+/** Merge overlapping or touching ranges. */
+export function mergeRanges(ranges) {
+    if (ranges.length === 0)
+        return [];
+    const out = [{ ...ranges[0] }];
+    for (let i = 1; i < ranges.length; i++) {
+        const prev = out[out.length - 1];
+        const cur = ranges[i];
+        if (cur.startSec <= prev.endSec) {
+            prev.endSec = Math.max(prev.endSec, cur.endSec);
+            prev.text = `${prev.text}/${cur.text}`;
+        }
+        else {
+            out.push({ ...cur });
+        }
+    }
+    return out;
+}
+/**
+ * Build a filter_complex that mutes (and optionally beeps over) the audio
+ * in every range. Output label: `[aout]`.
+ *
+ * mute mode:
+ *   [0:a]volume=enable='between(t,a1,b1)':volume=0,volume=enable='between(t,a2,b2)':volume=0[aout]
+ * bleep mode:
+ *   muted = same as mute
+ *   tones = sine sources, one per range, gated by adelay + atrim
+ *   [muted][tones...]amix=inputs=N+1:duration=first:dropout_transition=0[aout]
+ *   then sidechained back through volume…
+ *
+ * Simpler bleep: chain a sine source per range, mix all in. Below is the
+ * implementation:
+ */
+export function buildBleepFilter(ranges, mode, toneHz) {
+    if (ranges.length === 0)
+        throw new Error("buildBleepFilter: no ranges");
+    // Step 1: mute every range on the original audio.
+    const muteOps = ranges.map((r) => `volume=enable='between(t,${r.startSec},${r.endSec})':volume=0`);
+    const mutedExpr = `[0:a]${muteOps.join(",")}[muted]`;
+    if (mode === "mute") {
+        return `${mutedExpr};[muted]anull[aout]`;
+    }
+    // bleep: generate one sine tone clip per range, time-shift each, amix.
+    const toneExprs = [];
+    const toneLabels = [];
+    ranges.forEach((r, i) => {
+        const dur = +(r.endSec - r.startSec).toFixed(6);
+        // sine source: sine=frequency=F:duration=D, then adelay to startSec*1000ms.
+        toneExprs.push(`sine=frequency=${toneHz}:duration=${dur},` +
+            `adelay=${Math.round(r.startSec * 1000)}|${Math.round(r.startSec * 1000)},` +
+            `volume=0.5[tone${i}]`);
+        toneLabels.push(`[tone${i}]`);
+    });
+    const inputs = ranges.length + 1;
+    // amix duration=longest so the original tail isn't truncated.
+    const mixExpr = `[muted]${toneLabels.join("")}amix=inputs=${inputs}:duration=longest:dropout_transition=0,volume=${inputs}[aout]`;
+    return [mutedExpr, ...toneExprs, mixExpr].join(";");
+}
+//# sourceMappingURL=bleep-words.js.map

package/dist/tools/bleep-words.js.map

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

package/dist/tools/bleep-words.test.d.ts

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

package/dist/tools/bleep-words.test.d.ts.map

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

package/dist/tools/bleep-words.test.js

@@ -0,0 +1,96 @@
+import { describe, expect, it } from "vitest";
+import { buildBleepFilter, findRanges, mergeRanges } from "./bleep-words.js";
+function transcriptOf(words) {
+    return {
+        language: "en",
+        durationSec: 30,
+        segments: [
+            {
+                start: 0,
+                end: 30,
+                text: words.map((w) => w.text).join(" "),
+                words,
+            },
+        ],
+    };
+}
+describe("findRanges", () => {
+    it("matches a single word case-insensitively, strips punctuation", () => {
+        const t = transcriptOf([
+            { text: "hello", start: 0, end: 0.5 },
+            { text: "Damn,", start: 1, end: 1.4 },
+            { text: "world", start: 1.5, end: 2 },
+        ]);
+        const r = findRanges(t, ["damn"], 0);
+        expect(r).toEqual([{ startSec: 1, endSec: 1.4, text: "damn" }]);
+    });
+    it("matches multi-word phrases", () => {
+        const t = transcriptOf([
+            { text: "you", start: 0, end: 0.3 },
+            { text: "know", start: 0.3, end: 0.7 },
+            { text: "what", start: 0.7, end: 1 },
+        ]);
+        const r = findRanges(t, ["you know"], 0);
+        expect(r.length).toBe(1);
+        expect(r[0].startSec).toBe(0);
+        expect(r[0].endSec).toBe(0.7);
+        expect(r[0].text).toBe("you know");
+    });
+    it("applies padding on both sides", () => {
+        const t = transcriptOf([{ text: "bad", start: 5, end: 5.4 }]);
+        const r = findRanges(t, ["bad"], 0.05);
+        expect(r[0].startSec).toBeCloseTo(4.95, 5);
+        expect(r[0].endSec).toBeCloseTo(5.45, 5);
+    });
+    it("clamps negative starts to 0 (padding past start of file)", () => {
+        const t = transcriptOf([{ text: "shit", start: 0, end: 0.3 }]);
+        const r = findRanges(t, ["shit"], 0.5);
+        expect(r[0].startSec).toBe(0);
+    });
+    it("returns empty when no matches", () => {
+        const t = transcriptOf([{ text: "hello", start: 0, end: 0.5 }]);
+        expect(findRanges(t, ["nope"], 0)).toEqual([]);
+    });
+    it("ignores empty / whitespace entries in wordList", () => {
+        const t = transcriptOf([{ text: "x", start: 0, end: 1 }]);
+        expect(findRanges(t, ["", "   "], 0)).toEqual([]);
+    });
+});
+describe("mergeRanges", () => {
+    it("merges overlapping ranges", () => {
+        const merged = mergeRanges([
+            { startSec: 1, endSec: 2, text: "a" },
+            { startSec: 1.5, endSec: 2.5, text: "b" },
+        ]);
+        expect(merged).toEqual([{ startSec: 1, endSec: 2.5, text: "a/b" }]);
+    });
+    it("preserves disjoint ranges", () => {
+        const merged = mergeRanges([
+            { startSec: 1, endSec: 2, text: "a" },
+            { startSec: 5, endSec: 6, text: "b" },
+        ]);
+        expect(merged).toHaveLength(2);
+    });
+});
+describe("buildBleepFilter", () => {
+    it("mute mode emits volume=0 per range", () => {
+        const f = buildBleepFilter([{ startSec: 1, endSec: 2, text: "x" }], "mute", 1000);
+        expect(f).toContain("volume=enable='between(t,1,2)':volume=0");
+        expect(f).toContain("[aout]");
+        expect(f).not.toContain("sine=");
+    });
+    it("bleep mode emits a sine tone per range and amixes", () => {
+        const f = buildBleepFilter([
+            { startSec: 1, endSec: 2, text: "x" },
+            { startSec: 5, endSec: 5.5, text: "y" },
+        ], "bleep", 1000);
+        expect(f).toContain("sine=frequency=1000:duration=1");
+        expect(f).toContain("sine=frequency=1000:duration=0.5");
+        expect(f).toContain("amix=inputs=3");
+        expect(f).toContain("[aout]");
+    });
+    it("throws on empty range list", () => {
+        expect(() => buildBleepFilter([], "mute", 1000)).toThrow();
+    });
+});
+//# sourceMappingURL=bleep-words.test.js.map

package/dist/tools/bleep-words.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bleep-words.test.js","sourceRoot":"","sources":["../../src/tools/bleep-words.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG7E,SAAS,YAAY,CAAC,KAA0D;IAC9E,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE;YACR;gBACE,KAAK,EAAE,CAAC;gBACR,GAAG,EAAE,EAAE;gBACP,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACxC,KAAK;aACN;SACF;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,YAAY,CAAC;YACrB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;YACrC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;YACrC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,YAAY,CAAC;YACrB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;YACnC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;YACtC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;SACrC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC;YACzB,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACrC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;SAC1C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC;YACzB,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACrC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QAC/D,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,gBAAgB,CACxB;YACE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACrC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;SACxC,EACD,OAAO,EACP,IAAI,CACL,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/burn-subtitles.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const BurnSubtitlesParams: z.ZodObject<{
+    input: z.ZodString;
+    subtitles: z.ZodString;
+    output: z.ZodString;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createBurnSubtitlesTool(cwd: string): AgentTool<typeof BurnSubtitlesParams>;
+/**
+ * Escape a path for ffmpeg's `subtitles=` filter argument.
+ *
+ * Cross-platform rules (verified against RightNow-AI/openfang's clip skill
+ * + ffmpeg's filter manual):
+ *   - Forward slashes, never backslashes — ffmpeg's filtergraph parser
+ *     treats `\` as an escape; on Windows paths come in as `C:\foo` and
+ *     must become `C:/foo` first.
+ *   - The drive-letter colon (`C:`) MUST be escaped as `C\:` because the
+ *     filtergraph uses bare colons as arg separators.
+ *   - Single quotes inside the path get backslash-escaped.
+ *
+ * Result for a typical Windows abs path:
+ *   `C:\Users\me\subs.ass`  →  `C\:/Users/me/subs.ass`
+ */
+export declare function escapeFilterPath(p: string): string;
+export {};
+//# sourceMappingURL=burn-subtitles.d.ts.map

package/dist/tools/burn-subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/burn-subtitles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,QAAA,MAAM,mBAAmB;;;;;;iBAevB,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CAiD1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/tools/burn-subtitles.js

@@ -0,0 +1,92 @@
+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, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const BurnSubtitlesParams = z.object({
+    input: z.string().describe("Source video file."),
+    subtitles: z.string().describe("Path to .srt or .ass subtitle file."),
+    output: z.string().describe("Where to write the captioned video."),
+    videoCodec: z
+        .string()
+        .optional()
+        .describe("Output video codec. Default 'libx264'. Use 'libx265' for HEVC."),
+    crf: z
+        .number()
+        .int()
+        .min(0)
+        .max(51)
+        .optional()
+        .describe("Quality (lower=better). 18=visually lossless, 23=default, 28=acceptable web."),
+});
+export function createBurnSubtitlesTool(cwd) {
+    return {
+        name: "burn_subtitles",
+        description: "BAKE captions into a video as pixels — file-only, final-delivery tool. " +
+            "⚠️ When a host (Resolve / Premiere) is connected and the user is still editing, " +
+            "prefer `write_srt` + `import_subtitles` to attach the captions as a sidecar / subtitle " +
+            "track instead. The user can then tweak timing, scrub, undo. Use this pixel-burn tool " +
+            "ONLY when (a) the user has explicitly asked for a final flat mp4, OR (b) host=none, OR " +
+            "(c) the deliverable is a vertical Short with stylised burned captions (in which case " +
+            "pass an .ass produced by `write_ass` / `write_keyword_captions`). End-of-pipeline: " +
+            "run AFTER loudness normalisation and any cleanup.",
+        parameters: BurnSubtitlesParams,
+        async execute({ input, subtitles, output, videoCodec, crf }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const subAbs = resolvePath(cwd, subtitles);
+                const outAbs = safeOutputPath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "use a different output path");
+                }
+                // ffmpeg's `subtitles` filter parses .srt and .ass. We escape the
+                // path because the filter arg uses : and \ as separators.
+                const filter = `subtitles=${escapeFilterPath(subAbs)}`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-i",
+                    inAbs,
+                    "-vf",
+                    filter,
+                    "-c:v",
+                    videoCodec ?? "libx264",
+                    "-crf",
+                    String(crf ?? 18),
+                    "-c:a",
+                    "copy",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(args, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg exited ${r.code}`, "verify subtitle file is valid .srt or .ass");
+                }
+                return compact({ ok: true, path: outAbs });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Escape a path for ffmpeg's `subtitles=` filter argument.
+ *
+ * Cross-platform rules (verified against RightNow-AI/openfang's clip skill
+ * + ffmpeg's filter manual):
+ *   - Forward slashes, never backslashes — ffmpeg's filtergraph parser
+ *     treats `\` as an escape; on Windows paths come in as `C:\foo` and
+ *     must become `C:/foo` first.
+ *   - The drive-letter colon (`C:`) MUST be escaped as `C\:` because the
+ *     filtergraph uses bare colons as arg separators.
+ *   - Single quotes inside the path get backslash-escaped.
+ *
+ * Result for a typical Windows abs path:
+ *   `C:\Users\me\subs.ass`  →  `C\:/Users/me/subs.ass`
+ */
+export function escapeFilterPath(p) {
+    return p.replace(/\\/g, "/").replace(/:/g, "\\:").replace(/'/g, "\\'");
+}
+//# sourceMappingURL=burn-subtitles.js.map

package/dist/tools/burn-subtitles.js.map

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

package/dist/tools/clean-audio.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const CleanAudioParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    mode: z.ZodEnum<{
+        denoise: "denoise";
+        "denoise-strong": "denoise-strong";
+        rnnoise: "rnnoise";
+        dehum: "dehum";
+        deess: "deess";
+    }>;
+    rnnoiseModel: z.ZodOptional<z.ZodString>;
+    mainsHz: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<60>]>>;
+}, z.core.$strip>;
+export declare function createCleanAudioTool(cwd: string): AgentTool<typeof CleanAudioParams>;
+export {};
+//# sourceMappingURL=clean-audio.d.ts.map

package/dist/tools/clean-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-audio.d.ts","sourceRoot":"","sources":["../../src/tools/clean-audio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,gBAAgB;;;;;;;;;;;;iBAiBpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CA6BpF"}

package/dist/tools/clean-audio.js

@@ -0,0 +1,55 @@
+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 { applyCleanup } from "../core/audio-cleanup.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const CleanAudioParams = z.object({
+    input: z.string().describe("Source media file."),
+    output: z.string().describe("Where to write the cleaned file."),
+    mode: z
+        .enum(["denoise", "denoise-strong", "rnnoise", "dehum", "deess"])
+        .describe("Cleanup type: denoise (mild afftdn) / denoise-strong / rnnoise " +
+        "(needs rnnoiseModel) / dehum / deess."),
+    rnnoiseModel: z
+        .string()
+        .optional()
+        .describe("Path to an arnndn .rnnn model. Required for mode=rnnoise."),
+    mainsHz: z
+        .union([z.literal(50), z.literal(60)])
+        .optional()
+        .describe("Mains frequency for dehum. 50=most of world, 60=North America."),
+});
+export function createCleanAudioTool(cwd) {
+    return {
+        name: "clean_audio",
+        description: "Audio cleanup pass. Modes: denoise (afftdn mild — most podcasts), denoise-strong (loud HVAC/fan), " +
+            "rnnoise (RNN denoiser, needs model), dehum (50/60Hz mains buzz), deess (harsh sibilance). " +
+            "Run BEFORE normalize_loudness. Don't stack denoise modes — pick one.",
+        parameters: CleanAudioParams,
+        async execute({ input, output, mode, rnnoiseModel, mainsHz }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = safeOutputPath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "use a different output path");
+                }
+                const modelAbs = rnnoiseModel ? resolvePath(cwd, rnnoiseModel) : undefined;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                await applyCleanup(inAbs, outAbs, mode, {
+                    rnnoiseModel: modelAbs,
+                    mainsHz,
+                    signal: ctx.signal,
+                });
+                return compact({ ok: true, path: outAbs, mode });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=clean-audio.js.map

package/dist/tools/clean-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-audio.js","sourceRoot":"","sources":["../../src/tools/clean-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/D,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAChE,QAAQ,CACP,iEAAiE;QAC/D,uCAAuC,CAC1C;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;SACrC,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oGAAoG;YACpG,4FAA4F;YAC5F,sEAAsE;QACxE,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,GAAG;YAC/D,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC3C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;oBACrB,OAAO,GAAG,CAAC,sCAAsC,EAAE,6BAA6B,CAAC,CAAC;gBACpF,CAAC;gBACD,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC3E,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;oBACtC,YAAY,EAAE,QAAQ;oBACtB,OAAO;oBACP,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/clone-timeline.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CloneTimelineParams: z.ZodObject<{
+    newName: z.ZodString;
+}, z.core.$strip>;
+export declare function createCloneTimelineTool(host: VideoHost): AgentTool<typeof CloneTimelineParams>;
+export {};
+//# sourceMappingURL=clone-timeline.d.ts.map

package/dist/tools/clone-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/clone-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,mBAAmB;;iBAKvB,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CAkB9F"}

package/dist/tools/clone-timeline.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const CloneTimelineParams = z.object({
+    newName: z
+        .string()
+        .min(1)
+        .describe("Name for the duplicated timeline (e.g. 'Podcast — silence cut v1')."),
+});
+export function createCloneTimelineTool(host) {
+    return {
+        name: "clone_timeline",
+        description: "Duplicate the active timeline under a new name. Use as a SAFETY NET before destructive " +
+            "operations (import_edl, render, ripple_delete sequences, bulk replace_clip). On Resolve " +
+            "the clone becomes active so subsequent ops modify the copy. Premiere clones the " +
+            "sequence into the project bin (best-effort — older versions error).",
+        parameters: CloneTimelineParams,
+        async execute({ newName }) {
+            try {
+                const r = await host.cloneTimeline(newName);
+                return compact({ ok: true, name: r.name });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=clone-timeline.js.map

package/dist/tools/clone-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-timeline.js","sourceRoot":"","sources":["../../src/tools/clone-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,qEAAqE,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,yFAAyF;YACzF,0FAA0F;YAC1F,kFAAkF;YAClF,qEAAqE;QACvE,UAAU,EAAE,mBAAmB;QAC/B,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC5C,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/cluster-takes.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const ClusterTakesParams: z.ZodObject<{
+    path: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    window: z.ZodOptional<z.ZodNumber>;
+    minTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createClusterTakesTool(cwd: string): AgentTool<typeof ClusterTakesParams>;
+export {};
+//# sourceMappingURL=cluster-takes.d.ts.map

package/dist/tools/cluster-takes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-takes.d.ts","sourceRoot":"","sources":["../../src/tools/cluster-takes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,QAAA,MAAM,kBAAkB;;;;;iBAoBtB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CA+CxF"}