@kenkaiiii/gg-editor 0.7.0 → 0.7.2

package/dist/tools/face-reframe.test.js

@@ -0,0 +1,139 @@
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import * as faceCore from "../core/face-reframe.js";
+import * as ffmpegMod from "../core/media/ffmpeg.js";
+import * as pythonMod from "../core/python.js";
+import { createFaceReframeTool } from "./face-reframe.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+const samplePlan = {
+    shots: [
+        {
+            startSec: 0,
+            endSec: 2,
+            frames: [],
+            smoothedX: 0.4,
+            smoothedY: 0.5,
+            mode: "face",
+        },
+        {
+            startSec: 2,
+            endSec: 5,
+            frames: [],
+            smoothedX: 0.6,
+            smoothedY: 0.5,
+            mode: "static",
+        },
+    ],
+    totalSec: 5,
+    fps: 30,
+    sourceWidth: 1920,
+    sourceHeight: 1080,
+};
+describe("face_reframe tool", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns ffmpeg-missing error when ffmpeg is absent", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(false);
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16" }, ctx);
+        expect(r).toMatch(/^error: ffmpeg not on PATH/);
+    });
+    it("returns python-missing error when findPython fails", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue(undefined);
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16" }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/Python 3 not on PATH/);
+        expect(r).toMatch(/mediapipe/);
+    });
+    it("composes ffmpeg args from the analysis plan", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(faceCore, "analyzeReframe").mockResolvedValue(samplePlan);
+        const ffSpy = vi
+            .spyOn(ffmpegMod, "runFfmpeg")
+            .mockResolvedValue({ code: 0, stdout: "", stderr: "" });
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16" }, ctx);
+        expect(typeof r).toBe("string");
+        const parsed = JSON.parse(r);
+        expect(parsed.ok).toBe(true);
+        expect(parsed.aspect).toBe("9:16");
+        expect(parsed.shots).toBe(2);
+        expect(parsed.faceShots).toBe(1);
+        expect(parsed.fallbackShots).toBe(1);
+        expect(parsed.outWidth).toBe(606);
+        expect(parsed.outHeight).toBe(1080);
+        // Inspect ffmpeg invocation.
+        expect(ffSpy).toHaveBeenCalledTimes(1);
+        const ffArgs = ffSpy.mock.calls[0][0];
+        expect(ffArgs).toContain("-i");
+        expect(ffArgs).toContain("/tmp/in.mp4");
+        expect(ffArgs).toContain("-vf");
+        const vfIdx = ffArgs.indexOf("-vf");
+        const vf = ffArgs[vfIdx + 1];
+        expect(vf).toMatch(/^crop=606:1080:x='/);
+        expect(vf).toContain("between(t\\,0\\,2)");
+        expect(vf).toContain("between(t\\,2\\,5)");
+        expect(ffArgs).toContain("-c:a");
+        expect(ffArgs).toContain("copy");
+        expect(ffArgs).toContain("-c:v");
+        expect(ffArgs).toContain("libx264"); // default codec
+        expect(ffArgs).toContain("-crf");
+        expect(ffArgs).toContain("20"); // default crf
+    });
+    it("static strategy ignores per-shot smoothedX and centres every crop", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(faceCore, "analyzeReframe").mockResolvedValue(samplePlan);
+        const ffSpy = vi
+            .spyOn(ffmpegMod, "runFfmpeg")
+            .mockResolvedValue({ code: 0, stdout: "", stderr: "" });
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16", strategy: "static" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.faceShots).toBe(0);
+        expect(parsed.fallbackShots).toBe(2);
+        const vf = ffSpy.mock.calls[0][0][ffSpy.mock.calls[0][0].indexOf("-vf") + 1];
+        // Both shots collapse to the centre X (657 for 1920×1080 → 9:16 crop 606).
+        expect(vf).toContain("\\,657\\,");
+        // No off-centre 4-digit X values from the original plan (e.g. 1314).
+        expect(vf).not.toMatch(/\\,1\d{3}\\,/);
+    });
+    it("propagates ffmpeg failure as err()", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(faceCore, "analyzeReframe").mockResolvedValue(samplePlan);
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockResolvedValue({
+            code: 1,
+            stdout: "",
+            stderr: "Could not open codec\nframe= 0 fps=0\nMaybe try -c:v libx264",
+        });
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16" }, ctx);
+        expect(r).toMatch(/^error: ffmpeg failed/);
+        expect(r).toMatch(/Could not open codec|libx264/);
+    });
+    it("propagates a missing-dep sidecar error with the pip-install fix", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(faceCore, "analyzeReframe").mockRejectedValue(new Error("missing python dep: mediapipe; install: pip install opencv-python mediapipe scenedetect numpy"));
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "in.mp4", output: "out.mp4", aspect: "9:16" }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/mediapipe/);
+        expect(r).toMatch(/pip install opencv-python mediapipe scenedetect numpy/);
+    });
+    it("rejects identical input and output paths", async () => {
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        const tool = createFaceReframeTool("/tmp");
+        const r = await tool.execute({ input: "x.mp4", output: "x.mp4", aspect: "9:16" }, ctx);
+        expect(r).toMatch(/output and input are identical/);
+    });
+});
+//# sourceMappingURL=face-reframe.test.js.map

package/dist/tools/face-reframe.test.js.map

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

package/dist/tools/find-viral-moments.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const FindViralMomentsParams: z.ZodObject<{
+    transcript: z.ZodString;
+    maxClips: z.ZodOptional<z.ZodNumber>;
+    durationRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    scoreThreshold: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * find_viral_moments — long-form transcript → top-N standalone-Shorts
+ * candidates. The Opus ClipAnything / Submagic Magic Clips equivalent.
+ *
+ * Algorithm:
+ *   1. Slide windows of `maxSec*2` (default 120s) with 30s overlap.
+ *   2. ONE LLM call per window proposing up to 3 candidates.
+ *   3. Score each via `score_clip` (transcript-only, cheap path).
+ *   4. Dedup overlaps (>50% → keep higher score).
+ *   5. Sort desc, take top maxClips.
+ */
+export declare function createFindViralMomentsTool(cwd: string): AgentTool<typeof FindViralMomentsParams>;
+export {};
+//# sourceMappingURL=find-viral-moments.d.ts.map

package/dist/tools/find-viral-moments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-viral-moments.d.ts","sourceRoot":"","sources":["../../src/tools/find-viral-moments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,QAAA,MAAM,sBAAsB;;;;;;iBAwB1B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CA+HhG"}

package/dist/tools/find-viral-moments.js

@@ -0,0 +1,176 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { scoreClipInternal } from "../core/clip-scoring.js";
+import { compact, err } from "../core/format.js";
+import { buildSlidingWindows, dedupCandidates, normalizeCandidates, proposeCandidates, } from "../core/viral-moments.js";
+import { parseTranscript } from "../core/whisper.js";
+const FindViralMomentsParams = z.object({
+    transcript: z.string().describe("Path to a transcript JSON written by `transcribe`."),
+    maxClips: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Top-N to return after dedup. Default 5."),
+    durationRange: z
+        .tuple([z.number().min(1), z.number().min(1)])
+        .optional()
+        .describe("[minSec, maxSec] for accepted clips. Default [20, 45] — Jenny Hoyos's 30–34s sweet " +
+        "spot for Shorts retention (per youtube-algorithm-primer skill, Marketing Examined " +
+        "May 2024). Widen to [20, 60] when the user explicitly wants longer cuts."),
+    scoreThreshold: z
+        .number()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Minimum 0-100 score to keep. Default 50 — anything lower won't perform."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+/**
+ * find_viral_moments — long-form transcript → top-N standalone-Shorts
+ * candidates. The Opus ClipAnything / Submagic Magic Clips equivalent.
+ *
+ * Algorithm:
+ *   1. Slide windows of `maxSec*2` (default 120s) with 30s overlap.
+ *   2. ONE LLM call per window proposing up to 3 candidates.
+ *   3. Score each via `score_clip` (transcript-only, cheap path).
+ *   4. Dedup overlaps (>50% → keep higher score).
+ *   5. Sort desc, take top maxClips.
+ */
+export function createFindViralMomentsTool(cwd) {
+    return {
+        name: "find_viral_moments",
+        description: "Find the top N viral-clip candidates inside a long-form transcript. Slides windows " +
+            "over the transcript, proposes 3 candidates per window via LLM, scores each via " +
+            "`score_clip`, dedups overlaps, returns ranked list with suggested title + caption + " +
+            "hook line. The 'long video to Shorts' orchestrator — Opus ClipAnything / Submagic " +
+            "Magic Clips equivalent. Default duration window [20, 45]s targets Jenny Hoyos's " +
+            "30–34s sweet spot. Output feeds `cut_at` + `render_multi_format` directly.",
+        parameters: FindViralMomentsParams,
+        async execute(args, ctx) {
+            try {
+                if (!process.env.OPENAI_API_KEY) {
+                    return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+                }
+                const transcriptAbs = resolvePath(cwd, args.transcript);
+                let raw;
+                try {
+                    raw = readFileSync(transcriptAbs, "utf8");
+                }
+                catch (e) {
+                    return err(`cannot read transcript ${transcriptAbs}: ${e.message}`, "verify the transcript JSON exists");
+                }
+                let t;
+                try {
+                    t = parseTranscript(raw);
+                }
+                catch (e) {
+                    return err(e.message);
+                }
+                if (t.segments.length === 0) {
+                    return err("transcript has no segments", "rerun transcribe(...)");
+                }
+                const [minSec, maxSec] = args.durationRange ?? [20, 45];
+                if (maxSec <= minSec)
+                    return err("durationRange[1] must be > durationRange[0]");
+                const maxClips = args.maxClips ?? 5;
+                const threshold = args.scoreThreshold ?? 50;
+                // Build windows: maxSec*2 wide with 30s overlap (or 25% of width
+                // for very small maxSec to avoid degenerate cases).
+                const windowSec = maxSec * 2;
+                const overlapSec = Math.min(30, Math.max(1, windowSec * 0.25));
+                const windows = buildSlidingWindows(t, windowSec, overlapSec);
+                if (windows.length === 0) {
+                    return err("no windows produced", "verify transcript.durationSec > 0");
+                }
+                // Propose candidates per window. One LLM call per window.
+                const proposals = [];
+                for (const w of windows) {
+                    if (ctx.signal?.aborted)
+                        return err("aborted");
+                    try {
+                        const cands = await proposeCandidates(w, {
+                            model: args.model,
+                            durationRange: [minSec, maxSec],
+                            signal: ctx.signal,
+                        });
+                        proposals.push(...cands);
+                    }
+                    catch (e) {
+                        // One bad window shouldn't kill the whole pass — log via
+                        // returning a partial. We surface count of dropped windows
+                        // implicitly through `totalScored`.
+                        void e.message;
+                    }
+                }
+                const normalized = normalizeCandidates(proposals, t.durationSec, minSec, maxSec);
+                if (normalized.length === 0) {
+                    return compact({ candidates: [], totalScored: 0, dropped: 0 });
+                }
+                // Score every candidate via the same engine as score_clip.
+                const scored = [];
+                for (const c of normalized) {
+                    if (ctx.signal?.aborted)
+                        return err("aborted");
+                    try {
+                        const text = sliceText(t, c.startSec, c.endSec);
+                        if (!text)
+                            continue;
+                        const s = await scoreClipInternal(text, c.startSec, c.endSec, [], {
+                            model: args.model,
+                            signal: ctx.signal,
+                        });
+                        scored.push({
+                            ...c,
+                            score: s.score,
+                            hook: s.hook,
+                            flow: s.flow,
+                            engagement: s.engagement,
+                            trend: s.trend,
+                            durationSec: s.durationSec,
+                        });
+                    }
+                    catch (e) {
+                        void e.message;
+                    }
+                }
+                const aboveThreshold = scored.filter((s) => s.score >= threshold);
+                const deduped = dedupCandidates(aboveThreshold);
+                const top = deduped.slice(0, maxClips);
+                return compact({
+                    candidates: top.map((c) => ({
+                        startSec: +c.startSec.toFixed(2),
+                        endSec: +c.endSec.toFixed(2),
+                        durationSec: +c.durationSec.toFixed(2),
+                        score: c.score,
+                        hook: +c.hook.toFixed(2),
+                        flow: +c.flow.toFixed(2),
+                        engagement: +c.engagement.toFixed(2),
+                        trend: +c.trend.toFixed(2),
+                        suggestedTitle: c.suggestedTitle,
+                        suggestedCaption: c.suggestedCaption,
+                        hookLine: c.hookLine,
+                        why: c.why,
+                    })),
+                    totalScored: scored.length,
+                    dropped: scored.length - top.length,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function sliceText(t, startSec, endSec) {
+    const parts = [];
+    for (const seg of t.segments) {
+        if (seg.end <= startSec || seg.start >= endSec)
+            continue;
+        parts.push(seg.text.trim());
+    }
+    return parts.join(" ").trim();
+}
+//# sourceMappingURL=find-viral-moments.js.map

package/dist/tools/find-viral-moments.js.map

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

package/dist/tools/find-viral-moments.test.d.ts

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

package/dist/tools/find-viral-moments.test.d.ts.map

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

package/dist/tools/find-viral-moments.test.js

@@ -0,0 +1,144 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createFindViralMomentsTool } from "./find-viral-moments.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+function writeTranscript(dir, payload) {
+    const p = join(dir, "t.json");
+    writeFileSync(p, JSON.stringify(payload), "utf8");
+    return p;
+}
+describe("find_viral_moments tool", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        delete process.env.OPENAI_API_KEY;
+    });
+    it("description names the orchestrator role + downstream tools", () => {
+        const tool = createFindViralMomentsTool("/tmp");
+        expect(tool.description).toMatch(/score_clip|render_multi_format|cut_at/);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createFindViralMomentsTool("/tmp");
+        const r = await tool.execute({ transcript: "x.json" }, ctx);
+        expect(r).toMatch(/^error:.*OPENAI_API_KEY/);
+    });
+    it("errors on empty transcript", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, { language: "en", durationSec: 60, segments: [] });
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        expect(r).toMatch(/no segments/);
+    });
+    it("errors on durationRange[1] <= durationRange[0]", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 60,
+            segments: [{ start: 0, end: 60, text: "hello" }],
+        });
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", durationRange: [60, 20] }, ctx);
+        expect(r).toMatch(/^error:.*durationRange/);
+    });
+    it("returns ranked candidates after proposal+score+dedup", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 200,
+            segments: Array.from({ length: 10 }, (_, i) => ({
+                start: i * 20,
+                end: (i + 1) * 20,
+                text: `segment ${i} content here`,
+            })),
+        });
+        let call = 0;
+        const proposalContent = JSON.stringify({
+            candidates: [
+                {
+                    startSec: 0,
+                    endSec: 40,
+                    hookLine: "open strong",
+                    suggestedTitle: "Hot take",
+                    suggestedCaption: "watch",
+                    why: "punchy",
+                },
+            ],
+        });
+        const scoreContent = JSON.stringify({
+            hook: 0.9,
+            flow: 0.7,
+            engagement: 0.8,
+            trend: 0.6,
+            why: "good",
+        });
+        vi.stubGlobal("fetch", vi.fn(async (_url, init) => {
+            call++;
+            const body = JSON.parse(init?.body ?? "{}");
+            const sys = body.messages[0]?.content ?? "";
+            const isProposal = sys.includes("short-form-video selector");
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({
+                    choices: [{ message: { content: isProposal ? proposalContent : scoreContent } }],
+                }),
+                text: async () => "",
+            };
+        }));
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", maxClips: 3, durationRange: [20, 60], scoreThreshold: 30 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.candidates.length).toBeGreaterThan(0);
+        expect(parsed.candidates[0].score).toBeGreaterThan(0);
+        expect(parsed.candidates[0].suggestedTitle).toBe("Hot take");
+        expect(call).toBeGreaterThan(1); // at least one proposal + one score
+    });
+    it("threshold drops low-scoring candidates", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 100,
+            segments: [{ start: 0, end: 100, text: "a long discussion about taxes and forms" }],
+        });
+        vi.stubGlobal("fetch", vi.fn(async (_url, init) => {
+            const body = JSON.parse(init?.body ?? "{}");
+            const sys = body.messages[0]?.content ?? "";
+            const isProposal = sys.includes("short-form-video selector");
+            const content = isProposal
+                ? JSON.stringify({
+                    candidates: [
+                        {
+                            startSec: 0,
+                            endSec: 30,
+                            hookLine: "x",
+                            suggestedTitle: "y",
+                            suggestedCaption: "z",
+                            why: "w",
+                        },
+                    ],
+                })
+                : JSON.stringify({ hook: 0.1, flow: 0.1, engagement: 0.1, trend: 0.1, why: "weak" });
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({ choices: [{ message: { content } }] }),
+                text: async () => "",
+            };
+        }));
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", scoreThreshold: 90 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.candidates).toEqual([]);
+        expect(parsed.totalScored).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=find-viral-moments.test.js.map

package/dist/tools/find-viral-moments.test.js.map

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

package/dist/tools/generate-gif.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-gif.d.ts","sourceRoot":"","sources":["../../src/tools/generate-gif.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,iBAAiB;;;;;;;iBAsBrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAgFtF"}
+{"version":3,"file":"generate-gif.d.ts","sourceRoot":"","sources":["../../src/tools/generate-gif.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,iBAAiB;;;;;;;iBAsBrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAsFtF"}

package/dist/tools/generate-gif.js

@@ -1,4 +1,4 @@
-import { mkdirSync } from "node:fs";
+import { mkdirSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve as resolvePath } from "node:path";
 import { z } from "zod";
@@ -55,45 +55,52 @@ export function createGenerateGifTool(cwd) {
                 mkdirSync(dirname(outAbs), { recursive: true });
                 const palettePath = join(tmpdir(), `gg-gif-palette-${Date.now()}.png`);
                 const filterChain = `fps=${fps},scale=${width}:-1:flags=lanczos`;
-                // Pass 1: palettegen
-                const p1 = await runFfmpeg([
-                    "-ss",
-                    String(start),
-                    "-t",
-                    String(dur),
-                    "-i",
-                    inAbs,
-                    "-vf",
-                    `${filterChain},palettegen=stats_mode=diff`,
-                    palettePath,
-                ], { signal: ctx.signal });
-                if (p1.code !== 0)
-                    return err(`palettegen exited ${p1.code}`);
-                // Pass 2: paletteuse
-                const p2 = await runFfmpeg([
-                    "-ss",
-                    String(start),
-                    "-t",
-                    String(dur),
-                    "-i",
-                    inAbs,
-                    "-i",
-                    palettePath,
-                    "-lavfi",
-                    `${filterChain} [x]; [x][1:v] paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle`,
-                    outAbs,
-                ], { signal: ctx.signal });
-                if (p2.code !== 0)
-                    return err(`paletteuse exited ${p2.code}`);
-                return compact({
-                    ok: true,
-                    path: outAbs,
-                    startSec: start,
-                    durationSec: dur,
-                    fps,
-                    width,
-                    ...(resolved.redirected ? { redirected: true, reason: resolved.reason } : {}),
-                });
+                // The palette PNG is a temp scratch artifact between the two ffmpeg
+                // passes — always clean it up, including on early-return / thrown errors.
+                try {
+                    // Pass 1: palettegen
+                    const p1 = await runFfmpeg([
+                        "-ss",
+                        String(start),
+                        "-t",
+                        String(dur),
+                        "-i",
+                        inAbs,
+                        "-vf",
+                        `${filterChain},palettegen=stats_mode=diff`,
+                        palettePath,
+                    ], { signal: ctx.signal });
+                    if (p1.code !== 0)
+                        return err(`palettegen exited ${p1.code}`);
+                    // Pass 2: paletteuse
+                    const p2 = await runFfmpeg([
+                        "-ss",
+                        String(start),
+                        "-t",
+                        String(dur),
+                        "-i",
+                        inAbs,
+                        "-i",
+                        palettePath,
+                        "-lavfi",
+                        `${filterChain} [x]; [x][1:v] paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle`,
+                        outAbs,
+                    ], { signal: ctx.signal });
+                    if (p2.code !== 0)
+                        return err(`paletteuse exited ${p2.code}`);
+                    return compact({
+                        ok: true,
+                        path: outAbs,
+                        startSec: start,
+                        durationSec: dur,
+                        fps,
+                        width,
+                        ...(resolved.redirected ? { redirected: true, reason: resolved.reason } : {}),
+                    });
+                }
+                finally {
+                    rmSync(palettePath, { force: true });
+                }
             }
             catch (e) {
                 return err(e.message);