@kenkaiiii/gg-editor 0.1.0

package/dist/tools/normalize-loudness.js

@@ -0,0 +1,94 @@
+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 { applyLoudnorm, measureLoudness, PLATFORM_TARGETS, } from "../core/loudness.js";
+import { checkFfmpeg, probeMedia } from "../core/media/ffmpeg.js";
+const PlatformEnum = z.enum([
+    "youtube",
+    "spotify",
+    "apple-podcasts",
+    "podcast",
+    "broadcast-r128",
+    "tiktok",
+    "instagram",
+]);
+const NormalizeLoudnessParams = z.object({
+    input: z.string().describe("Source media file (audio or video)."),
+    output: z.string().describe("Where to write the normalized file."),
+    platform: PlatformEnum.optional().describe("Preset target. youtube/spotify/tiktok/instagram=-14 LUFS; podcast/apple=-16; broadcast-r128=-23."),
+    integratedLufs: z
+        .number()
+        .negative()
+        .optional()
+        .describe("Custom integrated loudness target. Overrides platform."),
+    truePeakDb: z.number().negative().optional().describe("True peak ceiling. Default -1 dBTP."),
+    loudnessRange: z.number().positive().optional().describe("LRA target. Default 11 LU."),
+});
+export function createNormalizeLoudnessTool(cwd) {
+    return {
+        name: "normalize_loudness",
+        description: "Two-pass EBU R128 loudness normalization (ffmpeg loudnorm). " +
+            "Writes a new file at the platform target. Default targets: youtube=-14, " +
+            "podcast=-16, broadcast-r128=-23 LUFS. Use BEFORE rendering to ensure your " +
+            "output meets the platform spec — loudness violations are the #1 reason " +
+            "uploads sound 'quiet' or 'too hot' to listeners.",
+        parameters: NormalizeLoudnessParams,
+        async execute({ input, output, platform, integratedLufs, truePeakDb, loudnessRange }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = resolvePath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "use a different output path");
+                }
+                let target;
+                if (integratedLufs !== undefined) {
+                    target = { integratedLufs, truePeakDb, loudnessRange };
+                }
+                else if (platform) {
+                    target = { ...PLATFORM_TARGETS[platform] };
+                    if (truePeakDb !== undefined)
+                        target.truePeakDb = truePeakDb;
+                    if (loudnessRange !== undefined)
+                        target.loudnessRange = loudnessRange;
+                }
+                else {
+                    return err("neither platform nor integratedLufs supplied", "pass platform=youtube|podcast|... OR integratedLufs=-14");
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                // Auto-detect mono → enable dual_mono so loudnorm measures correctly.
+                const probe = probeMedia(inAbs);
+                const dualMono = probe?.audioChannels === 1;
+                const measurement = await measureLoudness(inAbs, {
+                    signal: ctx.signal,
+                    dualMono,
+                });
+                await applyLoudnorm(inAbs, outAbs, measurement, target, {
+                    signal: ctx.signal,
+                    dualMono,
+                });
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    ...(dualMono ? { dualMono: true } : {}),
+                    source: {
+                        i: +measurement.inputI.toFixed(2),
+                        tp: +measurement.inputTp.toFixed(2),
+                        lra: +measurement.inputLra.toFixed(2),
+                    },
+                    target: {
+                        i: target.integratedLufs,
+                        tp: target.truePeakDb ?? -1,
+                        lra: target.loudnessRange ?? 11,
+                    },
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=normalize-loudness.js.map

package/dist/tools/normalize-loudness.js.map

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

package/dist/tools/open-page.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const OpenPageParams: z.ZodObject<{
+    name: z.ZodEnum<{
+        media: "media";
+        cut: "cut";
+        edit: "edit";
+        fusion: "fusion";
+        color: "color";
+        fairlight: "fairlight";
+        deliver: "deliver";
+    }>;
+}, z.core.$strip>;
+export declare function createOpenPageTool(host: VideoHost): AgentTool<typeof OpenPageParams>;
+export {};
+//# sourceMappingURL=open-page.d.ts.map

package/dist/tools/open-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-page.d.ts","sourceRoot":"","sources":["../../src/tools/open-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,cAAc;;;;;;;;;;iBAElB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAoBpF"}

package/dist/tools/open-page.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const OpenPageParams = z.object({
+    name: z.enum(["media", "cut", "edit", "fusion", "color", "fairlight", "deliver"]),
+});
+export function createOpenPageTool(host) {
+    return {
+        name: "open_page",
+        description: "Switch the host UI to a workspace page. Resolve only — Premiere has no page " +
+            "concept and will return error: not_supported. Use to guide the user's eyes: " +
+            "media for import, edit for cuts, color for grading, deliver for render.",
+        parameters: OpenPageParams,
+        async execute({ name }) {
+            try {
+                if (typeof host.openPage !== "function") {
+                    return err("not_supported", "page concept is Resolve-only");
+                }
+                await host.openPage(name);
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=open-page.js.map

package/dist/tools/open-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-page.js","sourceRoot":"","sources":["../../src/tools/open-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,8EAA8E;YAC9E,8EAA8E;YAC9E,yEAAyE;QAC3E,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACxC,OAAO,GAAG,CAAC,eAAe,EAAE,8BAA8B,CAAC,CAAC;gBAC9D,CAAC;gBACD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,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/overlay-watermark.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const OverlayWatermarkParams: z.ZodObject<{
+    input: z.ZodString;
+    watermark: z.ZodString;
+    output: z.ZodString;
+    position: z.ZodOptional<z.ZodEnum<{
+        center: "center";
+        "bottom-left": "bottom-left";
+        "bottom-right": "bottom-right";
+        "top-left": "top-left";
+        "top-right": "top-right";
+    }>>;
+    marginPx: z.ZodOptional<z.ZodNumber>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    scale: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createOverlayWatermarkTool(cwd: string): AgentTool<typeof OverlayWatermarkParams>;
+/**
+ * Build overlay x/y formulas from a named position. ffmpeg's overlay filter
+ * supports `W`/`H` (main video) and `w`/`h` (overlay dimensions).
+ */
+export declare function positionFormula(pos: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center", margin: number): {
+    x: string;
+    y: string;
+};
+export {};
+//# sourceMappingURL=overlay-watermark.d.ts.map

package/dist/tools/overlay-watermark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-watermark.d.ts","sourceRoot":"","sources":["../../src/tools/overlay-watermark.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;iBAgB1B,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CA0DhG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,QAAQ,EACzE,MAAM,EAAE,MAAM,GACb;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAa1B"}

package/dist/tools/overlay-watermark.js

@@ -0,0 +1,98 @@
+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";
+const OverlayWatermarkParams = z.object({
+    input: z.string().describe("Source video."),
+    watermark: z.string().describe("Image file (.png with transparency recommended)."),
+    output: z.string().describe("Output path."),
+    position: z
+        .enum(["top-left", "top-right", "bottom-left", "bottom-right", "center"])
+        .optional()
+        .describe("Default 'bottom-right'."),
+    marginPx: z.number().int().min(0).optional().describe("Pixels from each edge. Default 20."),
+    opacity: z.number().min(0).max(1).optional().describe("0-1. Default 0.85 (subtle but readable)."),
+    scale: z
+        .number()
+        .min(0.01)
+        .max(1)
+        .optional()
+        .describe("Watermark scale relative to input width. Default 0.15."),
+});
+export function createOverlayWatermarkTool(cwd) {
+    return {
+        name: "overlay_watermark",
+        description: "Composite a logo / watermark image over a video. PNG with transparency works best. " +
+            "Position presets cover the four corners + center. Default scale 15% of input width — " +
+            "big enough to read, small enough not to dominate.",
+        parameters: OverlayWatermarkParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const wmAbs = resolvePath(cwd, args.watermark);
+                const outAbs = resolvePath(cwd, args.output);
+                if (inAbs === outAbs || wmAbs === outAbs) {
+                    return err("output collides with an input");
+                }
+                const pos = args.position ?? "bottom-right";
+                const m = args.marginPx ?? 20;
+                const opacity = args.opacity ?? 0.85;
+                const scale = args.scale ?? 0.15;
+                const xy = positionFormula(pos, m);
+                // Scale watermark relative to MAIN width (W in overlay coordinate
+                // system; we use the [in] [wm] complex filter so scale=W*x:-1).
+                const filter = `[1:v]format=rgba,colorchannelmixer=aa=${opacity}[wm0];` +
+                    `[wm0][0:v]scale2ref=w=iw*${scale}:h=ow/mdar[wm][bg];` +
+                    `[bg][wm]overlay=${xy.x}:${xy.y}[v]`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const r = await runFfmpeg([
+                    "-i",
+                    inAbs,
+                    "-i",
+                    wmAbs,
+                    "-filter_complex",
+                    filter,
+                    "-map",
+                    "[v]",
+                    "-map",
+                    "0:a?",
+                    "-c:v",
+                    "libx264",
+                    "-crf",
+                    "20",
+                    "-c:a",
+                    "copy",
+                    outAbs,
+                ], { signal: ctx.signal });
+                if (r.code !== 0)
+                    return err(`ffmpeg exited ${r.code}`);
+                return compact({ ok: true, path: outAbs, position: pos });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Build overlay x/y formulas from a named position. ffmpeg's overlay filter
+ * supports `W`/`H` (main video) and `w`/`h` (overlay dimensions).
+ */
+export function positionFormula(pos, margin) {
+    switch (pos) {
+        case "top-left":
+            return { x: `${margin}`, y: `${margin}` };
+        case "top-right":
+            return { x: `W-w-${margin}`, y: `${margin}` };
+        case "bottom-left":
+            return { x: `${margin}`, y: `H-h-${margin}` };
+        case "bottom-right":
+            return { x: `W-w-${margin}`, y: `H-h-${margin}` };
+        case "center":
+            return { x: "(W-w)/2", y: "(H-h)/2" };
+    }
+}
+//# sourceMappingURL=overlay-watermark.js.map

package/dist/tools/overlay-watermark.js.map

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

package/dist/tools/pick-best-takes.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const PickBestTakesParams: z.ZodObject<{
+    transcriptPath: z.ZodString;
+    videoPath: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodOptional<z.ZodEnum<{
+        last: "last";
+        first: "first";
+        vision: "vision";
+    }>>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    visionDetail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    maxClusters: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createPickBestTakesTool(cwd: string): AgentTool<typeof PickBestTakesParams>;
+export {};
+//# sourceMappingURL=pick-best-takes.d.ts.map

package/dist/tools/pick-best-takes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-best-takes.d.ts","sourceRoot":"","sources":["../../src/tools/pick-best-takes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQrD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;iBA8BvB,CAAC;AAWH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CAwH1F"}

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

@@ -0,0 +1,147 @@
+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 { 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 = JSON.parse(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":"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"}

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-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,qBAAqB,CAAC;AAErD,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"}