@prestyj/editor 0.7.1

package/dist/tools/pick-best-takes.js

@@ -0,0 +1,148 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { clusterSegments } from "../core/clustering.js";
+import { compact, err, summarizeList } from "../core/format.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+import { parseTranscript } from "../core/whisper.js";
+import { scoreFrames } from "../core/vision.js";
+const PickBestTakesParams = z.object({
+    transcriptPath: z.string().describe("Transcript JSON file from `transcribe`."),
+    videoPath: z
+        .string()
+        .optional()
+        .describe("Video file. Required if strategy uses vision. Optional if strategy='last' or 'first'."),
+    strategy: z
+        .enum(["last", "first", "vision"])
+        .optional()
+        .describe("How to pick within a cluster. " +
+        "'last' (default) — pick the latest take (speakers warm up). " +
+        "'first' — pick the earliest take. " +
+        "'vision' — score frames via score_shot, pick highest visual quality."),
+    threshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("Cluster similarity threshold. Default 0.6."),
+    visionDetail: z.enum(["low", "high"]).optional(),
+    maxClusters: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Cap clusters processed (default 30)."),
+});
+export function createPickBestTakesTool(cwd) {
+    return {
+        name: "pick_best_takes",
+        description: "Composite: cluster transcript re-takes, then pick the best take per cluster using a " +
+            "configurable strategy ('last', 'first', or 'vision'). Returns picks + dropped segments " +
+            "with reasoning, ready to feed into write_edl/write_fcpxml. " +
+            "Replaces manual orchestration of cluster_takes -> score_shot -> winner-picking.",
+        parameters: PickBestTakesParams,
+        async execute(args, ctx) {
+            try {
+                const { transcriptPath, videoPath, strategy = "last", threshold = 0.6, visionDetail, maxClusters = 30, } = args;
+                // Load transcript
+                const tAbs = resolvePath(cwd, transcriptPath);
+                const t = parseTranscript(readFileSync(tAbs, "utf8"));
+                if (!t.segments || t.segments.length === 0) {
+                    return err("transcript has no segments");
+                }
+                // Cluster
+                const clusters = clusterSegments(t.segments, { threshold });
+                const limited = clusters.slice(0, maxClusters);
+                if (limited.length === 0) {
+                    return compact({
+                        clustersFound: 0,
+                        picks: [],
+                        note: "no multi-take clusters detected; nothing to pick",
+                    });
+                }
+                // Apply strategy
+                const picks = [];
+                if (strategy === "last" || strategy === "first") {
+                    for (const c of limited) {
+                        const indexes = c.memberIndexes;
+                        const pickedIndex = strategy === "last" ? indexes[indexes.length - 1] : indexes[0];
+                        const pickedTake = c.members[strategy === "last" ? indexes.length - 1 : 0];
+                        picks.push({
+                            cluster: c.id,
+                            pickedIndex,
+                            pickedTake: round3(pickedTake),
+                            droppedIndexes: indexes.filter((i) => i !== pickedIndex),
+                            reason: strategy === "last" ? "latest take (speaker warmed up)" : "earliest take",
+                        });
+                    }
+                }
+                else {
+                    // strategy === "vision"
+                    if (!videoPath)
+                        return err("videoPath required for strategy='vision'");
+                    if (!checkFfmpeg())
+                        return err("ffmpeg not on PATH", "install ffmpeg");
+                    if (!process.env.OPENAI_API_KEY)
+                        return err("OPENAI_API_KEY not set");
+                    // Build a flat list of (clusterIdx, memberIdx, midSec) to score in one batch
+                    const flat = [];
+                    for (let ci = 0; ci < limited.length; ci++) {
+                        const c = limited[ci];
+                        for (let mi = 0; mi < c.members.length; mi++) {
+                            const m = c.members[mi];
+                            flat.push({
+                                clusterIdx: ci,
+                                memberIdx: mi,
+                                midSec: (m.start + m.end) / 2,
+                            });
+                        }
+                    }
+                    const vAbs = resolvePath(cwd, videoPath);
+                    const frames = await extractAtTimes(vAbs, flat.map((f) => f.midSec), { maxWidth: 1280, signal: ctx.signal });
+                    const scores = await scoreFrames(frames, {
+                        detail: visionDetail,
+                        signal: ctx.signal,
+                    });
+                    // Group scores by cluster, pick max
+                    for (let ci = 0; ci < limited.length; ci++) {
+                        const c = limited[ci];
+                        const clusterScores = flat
+                            .map((f, i) => ({ ...f, score: scores[i].score, why: scores[i].why }))
+                            .filter((x) => x.clusterIdx === ci);
+                        const winner = clusterScores.reduce((best, cur) => cur.score > best.score ? cur : best);
+                        const pickedIndex = c.memberIndexes[winner.memberIdx];
+                        picks.push({
+                            cluster: c.id,
+                            pickedIndex,
+                            pickedTake: round3(c.members[winner.memberIdx]),
+                            droppedIndexes: c.memberIndexes.filter((i) => i !== pickedIndex),
+                            reason: `vision: ${winner.why}`,
+                            score: winner.score,
+                        });
+                    }
+                }
+                // Compact output
+                const summary = summarizeList(picks, 30);
+                return compact({
+                    clustersFound: clusters.length,
+                    processed: limited.length,
+                    strategy,
+                    picks: summary.omitted > 0 ? summary.head.concat(summary.tail) : picks,
+                    ...(summary.omitted > 0 ? { omitted: summary.omitted } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function round3(seg) {
+    return {
+        start: +seg.start.toFixed(2),
+        end: +seg.end.toFixed(2),
+        text: seg.text.length > 80 ? seg.text.slice(0, 79) + "…" : seg.text,
+    };
+}
+//# sourceMappingURL=pick-best-takes.js.map

package/dist/tools/pick-best-takes.js.map

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

package/dist/tools/post-tools.test.d.ts

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

package/dist/tools/post-tools.test.d.ts.map

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

package/dist/tools/post-tools.test.js

@@ -0,0 +1,83 @@
+import { describe, expect, it } from "vitest";
+import { escapeFilterPath } from "./burn-subtitles.js";
+import { escapeDrawtextValue } from "./compose-thumbnail.js";
+import { buildConcatListBody } from "./concat-videos.js";
+import { positionFormula } from "./overlay-watermark.js";
+describe("positionFormula", () => {
+    it("top-left places at (margin, margin)", () => {
+        expect(positionFormula("top-left", 20)).toEqual({ x: "20", y: "20" });
+    });
+    it("top-right offsets x by W-w-margin", () => {
+        expect(positionFormula("top-right", 20)).toEqual({ x: "W-w-20", y: "20" });
+    });
+    it("bottom-left offsets y by H-h-margin", () => {
+        expect(positionFormula("bottom-left", 30)).toEqual({ x: "30", y: "H-h-30" });
+    });
+    it("bottom-right offsets both x and y", () => {
+        expect(positionFormula("bottom-right", 10)).toEqual({
+            x: "W-w-10",
+            y: "H-h-10",
+        });
+    });
+    it("center centers via (W-w)/2 and (H-h)/2", () => {
+        expect(positionFormula("center", 0)).toEqual({ x: "(W-w)/2", y: "(H-h)/2" });
+    });
+});
+describe("buildConcatListBody", () => {
+    it("emits one `file '<path>'` line per input", () => {
+        expect(buildConcatListBody(["/a.mp4", "/b.mp4"])).toBe("file '/a.mp4'\nfile '/b.mp4'");
+    });
+    it("shell-escapes embedded single quotes (POSIX form)", () => {
+        // Real-world fixture from Xinrea/bili-shadowreplay: paths with a single
+        // quote need ' → '\\'' escaping inside single-quoted shell strings, which
+        // ffmpeg's concat demuxer parses with the same convention.
+        expect(buildConcatListBody(["/dir/it's-fine.mp4"])).toBe("file '/dir/it'\\''s-fine.mp4'");
+    });
+    it("preserves spaces and other special chars unchanged", () => {
+        expect(buildConcatListBody(["/Users/me/My Files/clip [1].mp4"])).toBe("file '/Users/me/My Files/clip [1].mp4'");
+    });
+});
+describe("escapeDrawtextValue", () => {
+    // Rules cross-checked against real-world fixtures: GVCLab/CutClaw,
+    // g0ldyy/comet, ehendrix23/tesla_dashcam, nickslevine/budok-ai.
+    it("passes plain text unchanged", () => {
+        expect(escapeDrawtextValue("Hello World")).toBe("Hello World");
+    });
+    it("escapes single quotes", () => {
+        expect(escapeDrawtextValue("don't stop")).toBe("don\\'t stop");
+    });
+    it("escapes colons (drawtext arg separator)", () => {
+        expect(escapeDrawtextValue("note: hello")).toBe("note\\: hello");
+    });
+    it("escapes percent signs (drawtext expansion delimiter)", () => {
+        expect(escapeDrawtextValue("50% off")).toBe("50\\% off");
+    });
+    it("escapes backslash FIRST so other escapes don't double up", () => {
+        expect(escapeDrawtextValue("path\\to")).toBe("path\\\\to");
+    });
+    it("converts newlines to drawtext's literal \\n", () => {
+        expect(escapeDrawtextValue("line1\nline2")).toBe("line1\\nline2");
+        expect(escapeDrawtextValue("line1\r\nline2")).toBe("line1\\nline2");
+    });
+    it("handles a kitchen-sink string in correct order", () => {
+        // Order matters: backslash first, then colon, quote, percent, newline.
+        const out = escapeDrawtextValue("50% off: don't \\stop\nnow");
+        expect(out).toBe("50\\% off\\: don\\'t \\\\stop\\nnow");
+    });
+});
+describe("escapeFilterPath (subtitles= filter)", () => {
+    // Cross-platform rules verified against RightNow-AI/openfang's clip skill.
+    it("converts Windows backslashes to forward slashes", () => {
+        expect(escapeFilterPath("C:\\Users\\me\\subs.ass")).toBe("C\\:/Users/me/subs.ass");
+    });
+    it("escapes the drive-letter colon", () => {
+        expect(escapeFilterPath("D:/path/to/subs.srt")).toBe("D\\:/path/to/subs.srt");
+    });
+    it("escapes single quotes", () => {
+        expect(escapeFilterPath("/Users/me/it's-here.ass")).toBe("/Users/me/it\\'s-here.ass");
+    });
+    it("is a no-op for plain Unix paths", () => {
+        expect(escapeFilterPath("/tmp/subs.srt")).toBe("/tmp/subs.srt");
+    });
+});
+//# sourceMappingURL=post-tools.test.js.map

package/dist/tools/post-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tools.test.js","sourceRoot":"","sources":["../../src/tools/post-tools.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAClD,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,wEAAwE;QACxE,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,mBAAmB,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,IAAI,CACnE,wCAAwC,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,mEAAmE;IACnE,gEAAgE;IAEhE,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClE,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,uEAAuE;QACvE,MAAM,GAAG,GAAG,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,2EAA2E;IAE3E,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/pre-render-check.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const PreRenderCheckParams: z.ZodObject<{
+    loudnessSource: z.ZodOptional<z.ZodString>;
+    loudnessTarget: z.ZodOptional<z.ZodEnum<{
+        youtube: "youtube";
+        spotify: "spotify";
+        "apple-podcasts": "apple-podcasts";
+        podcast: "podcast";
+        "broadcast-r128": "broadcast-r128";
+        tiktok: "tiktok";
+        instagram: "instagram";
+    }>>;
+    expectCaptions: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+interface CheckIssue {
+    severity: "ok" | "warn" | "block";
+    note: string;
+}
+export declare function createPreRenderCheckTool(host: VideoHost, cwd: string): AgentTool<typeof PreRenderCheckParams>;
+export type { CheckIssue };
+//# sourceMappingURL=pre-render-check.d.ts.map

package/dist/tools/pre-render-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-render-check.d.ts","sourceRoot":"","sources":["../../src/tools/pre-render-check.ts"],"names":[],"mappings":"AACA,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;AAIxD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;iBAwBxB,CAAC;AAEH,UAAU,UAAU;IAClB,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,oBAAoB,CAAC,CA6GxC;AAGD,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/tools/pre-render-check.js

@@ -0,0 +1,134 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact } from "../core/format.js";
+import { measureLoudness, PLATFORM_TARGETS } from "../core/loudness.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+const PreRenderCheckParams = z.object({
+    loudnessSource: z
+        .string()
+        .optional()
+        .describe("If supplied, measure loudness on this rendered preview / mixed audio file. " +
+        "Skipped when omitted (timeline-only checks still run)."),
+    loudnessTarget: z
+        .enum([
+        "youtube",
+        "spotify",
+        "apple-podcasts",
+        "podcast",
+        "broadcast-r128",
+        "tiktok",
+        "instagram",
+    ])
+        .optional()
+        .describe("Platform target for loudness comparison. Omit to skip loudness verdict."),
+    expectCaptions: z
+        .boolean()
+        .optional()
+        .describe("If true, warn when no captions/subtitles markers are present. Default false."),
+});
+export function createPreRenderCheckTool(host, cwd) {
+    return {
+        name: "pre_render_check",
+        description: "Composite QA pass before render. READ-ONLY. Verifies: timeline isn't empty; no red " +
+            "PAUSE markers (user-requested holds); loudness within ±1 LU + TP < -1 dBTP of " +
+            "platform target; (optional) captions present. Returns severity-tagged issues. " +
+            "Block-level issues mean DON'T render until resolved. Run this before every final render.",
+        parameters: PreRenderCheckParams,
+        async execute({ loudnessSource, loudnessTarget, expectCaptions }, ctx) {
+            const issues = [];
+            // Timeline state
+            try {
+                const tl = await host.getTimeline();
+                if (!tl.clips || tl.clips.length === 0) {
+                    issues.push({ severity: "block", note: "timeline is empty" });
+                }
+                if (expectCaptions) {
+                    const hasCaptionsClip = tl.clips.some((c) => c.trackKind === "audio" || c.name.toLowerCase().includes("subtitle"));
+                    if (!hasCaptionsClip) {
+                        issues.push({
+                            severity: "warn",
+                            note: "expectCaptions=true but no audio/subtitle track detected",
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                issues.push({
+                    severity: "warn",
+                    note: `getTimeline failed: ${e.message}`,
+                });
+            }
+            // Markers — surface unresolved PAUSE markers as block-level
+            try {
+                const markers = await host.getMarkers();
+                const paused = markers.filter((m) => (m.note ?? "").toUpperCase().includes("PAUSE"));
+                if (paused.length > 0) {
+                    issues.push({
+                        severity: "block",
+                        note: `${paused.length} unresolved PAUSE marker(s); resolve before rendering`,
+                    });
+                }
+            }
+            catch {
+                // No NLE attached — ignore.
+            }
+            // Loudness verdict (when source supplied)
+            let loudness;
+            if (loudnessSource) {
+                if (!checkFfmpeg()) {
+                    issues.push({
+                        severity: "warn",
+                        note: "ffmpeg not on PATH \u2014 loudness check skipped",
+                    });
+                }
+                else {
+                    try {
+                        const abs = resolvePath(cwd, loudnessSource);
+                        const m = await measureLoudness(abs, { signal: ctx.signal });
+                        const tgt = loudnessTarget ? PLATFORM_TARGETS[loudnessTarget] : undefined;
+                        let verdict = "ok";
+                        if (tgt) {
+                            const iDelta = Math.abs(m.inputI - tgt.integratedLufs);
+                            const tpCeiling = tgt.truePeakDb ?? -1;
+                            if (iDelta > 1) {
+                                verdict = "off-target";
+                                issues.push({
+                                    severity: "block",
+                                    note: `integrated loudness ${m.inputI.toFixed(1)} LUFS off target ${tgt.integratedLufs} by ${iDelta.toFixed(1)} LU \u2014 run normalize_loudness`,
+                                });
+                            }
+                            if (m.inputTp > tpCeiling) {
+                                verdict = "off-target";
+                                issues.push({
+                                    severity: "block",
+                                    note: `true peak ${m.inputTp.toFixed(1)} dBTP exceeds ${tpCeiling} \u2014 run normalize_loudness`,
+                                });
+                            }
+                        }
+                        loudness = {
+                            i: +m.inputI.toFixed(2),
+                            tp: +m.inputTp.toFixed(2),
+                            lra: +m.inputLra.toFixed(2),
+                            verdict,
+                        };
+                    }
+                    catch (e) {
+                        issues.push({
+                            severity: "warn",
+                            note: `loudness measure failed: ${e.message}`,
+                        });
+                    }
+                }
+            }
+            const blocked = issues.some((i) => i.severity === "block");
+            const warned = issues.some((i) => i.severity === "warn");
+            const status = blocked ? "block" : warned ? "warn" : "ok";
+            return compact({
+                status,
+                ...(loudness ? { loudness } : {}),
+                issues,
+            });
+        },
+    };
+}
+//# sourceMappingURL=pre-render-check.js.map

package/dist/tools/pre-render-check.js.map

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

package/dist/tools/probe-media.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const ProbeMediaParams: z.ZodObject<{
+    filePath: z.ZodString;
+}, z.core.$strip>;
+export declare function createProbeMediaTool(cwd: string): AgentTool<typeof ProbeMediaParams>;
+export {};
+//# sourceMappingURL=probe-media.d.ts.map

package/dist/tools/probe-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-media.d.ts","sourceRoot":"","sources":["../../src/tools/probe-media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,QAAA,MAAM,gBAAgB;;iBAEpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAsBpF"}

package/dist/tools/probe-media.js

@@ -0,0 +1,32 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfprobe, probeMedia } from "../core/media/ffmpeg.js";
+const ProbeMediaParams = z.object({
+    filePath: z.string(),
+});
+export function createProbeMediaTool(cwd) {
+    return {
+        name: "probe_media",
+        description: "Probe a media file via ffprobe. Use BEFORE editing to verify framerate, duration, " +
+            "resolution, codecs.",
+        parameters: ProbeMediaParams,
+        async execute({ filePath }) {
+            if (!checkFfprobe())
+                return err("ffprobe not on PATH", "install ffmpeg");
+            const abs = resolvePath(cwd, filePath);
+            const p = probeMedia(abs);
+            if (!p)
+                return err(`probe failed for ${abs}`);
+            return compact({
+                dur: +p.durationSec.toFixed(3),
+                w: p.width,
+                h: p.height,
+                fps: p.frameRate ? +p.frameRate.toFixed(3) : undefined,
+                v: p.videoCodec,
+                a: p.audioCodec,
+            });
+        },
+    };
+}
+//# sourceMappingURL=probe-media.js.map

package/dist/tools/probe-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-media.js","sourceRoot":"","sources":["../../src/tools/probe-media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oFAAoF;YACpF,qBAAqB;QACvB,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE;YACxB,IAAI,CAAC,YAAY,EAAE;gBAAE,OAAO,GAAG,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC;gBAAE,OAAO,GAAG,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YAC9C,OAAO,OAAO,CAAC;gBACb,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC9B,CAAC,EAAE,CAAC,CAAC,KAAK;gBACV,CAAC,EAAE,CAAC,CAAC,MAAM;gBACX,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;gBACtD,CAAC,EAAE,CAAC,CAAC,UAAU;gBACf,CAAC,EAAE,CAAC,CAAC,UAAU;aAChB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/punch-in.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const PunchInParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    ranges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        startSec: z.ZodNumber;
+        endSec: z.ZodNumber;
+        zoom: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    cutPoints: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    defaultZoom: z.ZodOptional<z.ZodNumber>;
+    holdSec: z.ZodOptional<z.ZodNumber>;
+    rampSec: z.ZodOptional<z.ZodNumber>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * punch_in — digital zoom on a list of ranges. The single best
+ * disguise for jump cuts on a single-camera talking head: cut the
+ * filler / silence, then punch in slightly on the kept side, and the
+ * head-jerk vanishes.
+ *
+ * Also takes `cutPoints` to auto-generate punches after every cut —
+ * pair with `cut_filler_words` or `detect_silence` for a one-shot
+ * "clean up the talking head" pipeline.
+ */
+export declare function createPunchInTool(cwd: string): AgentTool<typeof PunchInParams>;
+export {};
+//# sourceMappingURL=punch-in.d.ts.map

package/dist/tools/punch-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"punch-in.d.ts","sourceRoot":"","sources":["../../src/tools/punch-in.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiBhD,QAAA,MAAM,aAAa;;;;;;;;;;;;;;iBAuCjB,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,aAAa,CAAC,CAqF9E"}