@kenkaiiii/gg-editor 0.7.0 → 0.7.2

package/dist/tools/concat-videos.js.map

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

package/dist/tools/concat-videos.test.d.ts

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

package/dist/tools/concat-videos.test.d.ts.map

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

package/dist/tools/concat-videos.test.js

@@ -0,0 +1,103 @@
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import * as ffmpegMod from "../core/media/ffmpeg.js";
+import { buildConcatListBody, createConcatVideosTool } from "./concat-videos.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+/**
+ * The lossless branch writes an ffmpeg concat list file to os.tmpdir() and must
+ * clean it up via try/finally regardless of whether ffmpeg succeeded or failed.
+ * We snoop the path by intercepting runFfmpeg and pulling the value of the
+ * argument that follows `-i`.
+ */
+function captureListPathOn(mock) {
+    const ref = { current: () => undefined };
+    let captured;
+    mock.mockImplementation(async (args) => {
+        const i = args.indexOf("-i");
+        captured = i >= 0 ? args[i + 1] : undefined;
+        return { code: 0, stdout: "", stderr: "" };
+    });
+    ref.current = () => captured;
+    return ref;
+}
+describe("buildConcatListBody", () => {
+    it("single-quotes paths and escapes embedded single quotes", () => {
+        const body = buildConcatListBody(["/a/b.mp4", "/weird/it's.mp4"]);
+        expect(body).toBe("file '/a/b.mp4'\nfile '/weird/it'\\''s.mp4'");
+    });
+});
+describe("concat_videos temp-file cleanup", () => {
+    let workDir;
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        workDir = mkdtempSync(join(tmpdir(), "gg-concat-test-"));
+        // Make the inputs and output resolve to real-looking files so the
+        // pre-flight identity check doesn't trip.
+        writeFileSync(join(workDir, "a.mp4"), "");
+        writeFileSync(join(workDir, "b.mp4"), "");
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("removes the concat list file after a successful lossless run", async () => {
+        const ff = vi.spyOn(ffmpegMod, "runFfmpeg");
+        const captured = captureListPathOn(ff);
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(r).not.toMatch(/^error:/);
+        const listPath = captured.current();
+        expect(listPath).toBeDefined();
+        expect(listPath).toMatch(/gg-concat-/);
+        expect(existsSync(listPath)).toBe(false);
+    });
+    it("writes the concat list before invoking ffmpeg (sanity-check the body)", async () => {
+        let bodyAtFfmpegTime;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            const path = args[i + 1];
+            bodyAtFfmpegTime = readFileSync(path, "utf8");
+            return { code: 0, stdout: "", stderr: "" };
+        });
+        const tool = createConcatVideosTool(workDir);
+        await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(bodyAtFfmpegTime).toBeDefined();
+        expect(bodyAtFfmpegTime).toContain("file '");
+        expect(bodyAtFfmpegTime).toContain("a.mp4");
+        expect(bodyAtFfmpegTime).toContain("b.mp4");
+    });
+    it("removes the concat list file when ffmpeg returns a non-zero code", async () => {
+        let captured;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            captured = args[i + 1];
+            return { code: 1, stdout: "", stderr: "boom" };
+        });
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(r).toMatch(/^error: ffmpeg concat-demuxer exited 1/);
+        expect(captured).toBeDefined();
+        expect(existsSync(captured)).toBe(false);
+    });
+    it("removes the concat list file when runFfmpeg throws", async () => {
+        let captured;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            captured = args[i + 1];
+            throw new Error("spawn failed");
+        });
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        // The outer try/catch in the tool surfaces thrown errors as err()
+        // strings; the temp file must still be gone.
+        expect(r).toMatch(/^error: spawn failed/);
+        expect(captured).toBeDefined();
+        expect(existsSync(captured)).toBe(false);
+    });
+});
+//# sourceMappingURL=concat-videos.test.js.map

package/dist/tools/concat-videos.test.js.map

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

package/dist/tools/crossfade-videos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crossfade-videos.d.ts","sourceRoot":"","sources":["../../src/tools/crossfade-videos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAqDrD,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMzB,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CA4D9F"}
+{"version":3,"file":"crossfade-videos.d.ts","sourceRoot":"","sources":["../../src/tools/crossfade-videos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAsDrD,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMzB,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CA4D9F"}

package/dist/tools/crossfade-videos.js

@@ -3,6 +3,7 @@ import { dirname, resolve as resolvePath } from "node:path";
 import { z } from "zod";
 import { compact, err } from "../core/format.js";
 import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
 // xfade transitions verified against ffmpeg's filter manual + the wubloader
 // fixture list. ALL of these are accepted by mainline ffmpeg.
 const TransitionSchema = z.enum([
@@ -71,7 +72,7 @@ export function createCrossfadeVideosTool(cwd) {
             try {
                 const aAbs = resolvePath(cwd, inputA);
                 const bAbs = resolvePath(cwd, inputB);
-                const outAbs = resolvePath(cwd, output);
+                const outAbs = safeOutputPath(cwd, output);
                 if (aAbs === outAbs || bAbs === outAbs) {
                     return err("output collides with an input");
                 }

package/dist/tools/crossfade-videos.js.map

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

package/dist/tools/cut-filler-words.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cut-filler-words.d.ts","sourceRoot":"","sources":["../../src/tools/cut-filler-words.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;iBAyExB,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CA8G5F"}
+{"version":3,"file":"cut-filler-words.d.ts","sourceRoot":"","sources":["../../src/tools/cut-filler-words.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;iBA2ExB,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAwH5F"}

package/dist/tools/cut-filler-words.js

@@ -3,10 +3,11 @@ import { tmpdir } from "node:os";
 import { basename, dirname, extname, join, resolve as resolvePath } from "node:path";
 import { z } from "zod";
 import { buildEdl } from "../core/edl.js";
-import { DEFAULT_FILLERS, detectFillerRanges, keepRangesFromFillers, keepRangesToFrameRanges, summarizeFillers, } from "../core/filler-words.js";
+import { DEFAULT_FILLERS, detectFillerRanges, keepRangesFromFillers, keepRangesToFrameRanges, keepRangesToTimelineCuts, summarizeFillers, } from "../core/filler-words.js";
 import { compact, err } from "../core/format.js";
 import { probeMedia } from "../core/media/ffmpeg.js";
 import { safeOutputPath } from "../core/safe-paths.js";
+import { parseTranscript } from "../core/whisper.js";
 const CutFillerWordsParams = z.object({
     transcript: z
         .string()
@@ -25,9 +26,11 @@ const CutFillerWordsParams = z.object({
     aggressiveSingleWords: z
         .boolean()
         .optional()
-        .describe("When false, skip ambiguous single-word fillers (like, so, actually, basically, " +
-        "literally, honestly, right) — useful when the speaker uses them substantively. " +
-        "Default true."),
+        .describe("When true (tool default), include ambiguous single-word fillers (like, so, actually, " +
+        "basically, literally, honestly, right). When false, only the safe-list (um/uh/er/hmm/" +
+        "you know/i mean/kind of/sort of) is matched — useful when the speaker uses these " +
+        "words substantively. The underlying detectFillerRanges() library defaults to false; " +
+        "this tool preserves the historical aggressive=true behavior for the end user."),
     paddingStartMs: z
         .number()
         .min(0)
@@ -82,7 +85,10 @@ export function createCutFillerWordsTool(cwd) {
         description: "Detect and remove filler words ('um', 'uh', 'you know', 'i mean', …) from a " +
             "word-timestamped transcript. Emits an EDL of KEEP ranges (the parts to keep, with " +
             "small padding so cuts don't clip syllables). REQUIRES word-level timings — call " +
-            "transcribe(wordTimestamps=true) first. Returns {path, stats, keeps}; agent should " +
+            "transcribe(wordTimestamps=true) first. Returns {path, stats, keeps, timelineCutPoints}; " +
+            "⚠️ pass `timelineCutPoints` (NOT source transcript timestamps) to add_sfx_to_timeline / " +
+            "add_sfx_at_cuts — those tools work in TIMELINE space, and source-space points drift after " +
+            "every cut. Agent should " +
             "show the stats to the user, then import_edl(path) when approved. The single biggest " +
             "creator-time-saver on long-form talking-head content.",
         parameters: CutFillerWordsParams,
@@ -99,10 +105,10 @@ export function createCutFillerWordsTool(cwd) {
                 }
                 let transcript;
                 try {
-                    transcript = JSON.parse(raw);
+                    transcript = parseTranscript(raw);
                 }
                 catch (e) {
-                    return err(`transcript is not valid JSON: ${e.message}`, "regenerate via transcribe(wordTimestamps=true)");
+                    return err(e.message, "regenerate via transcribe(wordTimestamps=true)");
                 }
                 const hasWords = transcript.segments.some((s) => Array.isArray(s.words) && s.words.length > 0);
                 if (!hasWords) {
@@ -110,7 +116,9 @@ export function createCutFillerWordsTool(cwd) {
                 }
                 const fillers = detectFillerRanges(transcript, {
                     fillers: args.fillers,
-                    aggressiveSingleWords: args.aggressiveSingleWords,
+                    // Tool default is true (aggressive) to preserve existing user behavior;
+                    // the underlying library now defaults to false (conservative).
+                    aggressiveSingleWords: args.aggressiveSingleWords ?? true,
                     paddingStartMs: args.paddingStartMs,
                     paddingEndMs: args.paddingEndMs,
                     mergeGapMs: args.mergeGapMs,
@@ -120,6 +128,10 @@ export function createCutFillerWordsTool(cwd) {
                 const fps = args.frameRate ?? probe?.frameRate ?? 30;
                 const keeps = keepRangesFromFillers(fillers, totalSec);
                 const frameKeeps = keepRangesToFrameRanges(keeps, fps);
+                // Timeline-space cut points: where each junction lands AFTER the
+                // EDL is imported. Pass these to add_sfx_to_timeline /
+                // add_sfx_at_cuts — NOT the source-space filler timestamps.
+                const timelineCutPoints = keepRangesToTimelineCuts(keeps);
                 if (frameKeeps.length === 0) {
                     return err("no keep ranges produced — fillers may cover the entire transcript", "broaden vocabulary or check word timings");
                 }
@@ -150,6 +162,10 @@ export function createCutFillerWordsTool(cwd) {
                     keeps: keeps.length,
                     fps,
                     totalSec,
+                    // TIMELINE-space cut points (one per junction between keeps). Use
+                    // these for add_sfx_to_timeline / add_sfx_at_cuts. Source-space
+                    // timestamps from the transcript would drift after each cut.
+                    timelineCutPoints,
                     // Surface a short list so the agent can quote it back to the user.
                     sample: fillers.slice(0, 10).map((f) => ({
                         atSec: +f.startSec.toFixed(2),

package/dist/tools/cut-filler-words.js.map

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

package/dist/tools/detect-speaker-changes.js

@@ -3,6 +3,7 @@ import { resolve as resolvePath } from "node:path";
 import { z } from "zod";
 import { compact, err, summarizeList } from "../core/format.js";
 import { detectSpeakerChanges } from "../core/speaker-changes.js";
+import { parseTranscript } from "../core/whisper.js";
 const DetectSpeakerChangesParams = z.object({
     path: z.string().describe("Transcript JSON file (output of `transcribe`)."),
     minGapSec: z
@@ -24,7 +25,7 @@ export function createDetectSpeakerChangesTool(cwd) {
         async execute({ path, minGapSec }) {
             try {
                 const abs = resolvePath(cwd, path);
-                const t = JSON.parse(readFileSync(abs, "utf8"));
+                const t = parseTranscript(readFileSync(abs, "utf8"));
                 const candidates = detectSpeakerChanges(t, { minGapSec });
                 const s = summarizeList(candidates, 30);
                 return compact({

package/dist/tools/detect-speaker-changes.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-speaker-changes.js","sourceRoot":"","sources":["../../src/tools/detect-speaker-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC3E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,qFAAqF;YACrF,sFAAsF;YACtF,sFAAsF;YACtF,sFAAsF;YACtF,yFAAyF;YACzF,4DAA4D;QAC9D,UAAU,EAAE,0BAA0B;QACtC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAe,CAAC;gBAC9D,MAAM,UAAU,GAAG,oBAAoB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1D,MAAM,CAAC,GAAG,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,OAAO,CAAC;oBACb,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,SAAS,EAAE,SAAS,IAAI,GAAG;oBAC3B,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;iBACzF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"detect-speaker-changes.js","sourceRoot":"","sources":["../../src/tools/detect-speaker-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC3E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,qFAAqF;YACrF,sFAAsF;YACtF,sFAAsF;YACtF,sFAAsF;YACtF,yFAAyF;YACzF,4DAA4D;QAC9D,UAAU,EAAE,0BAA0B;QACtC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACnC,MAAM,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;gBACrD,MAAM,UAAU,GAAG,oBAAoB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1D,MAAM,CAAC,GAAG,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,OAAO,CAAC;oBACb,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,SAAS,EAAE,SAAS,IAAI,GAAG;oBAC3B,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;iBACzF,CAAC,CAAC;YACL,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/extract-audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-audio.d.ts","sourceRoot":"","sources":["../../src/tools/extract-audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,QAAA,MAAM,kBAAkB;;;;iBAItB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAsBxF"}
+{"version":3,"file":"extract-audio.d.ts","sourceRoot":"","sources":["../../src/tools/extract-audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,kBAAkB;;;;iBAItB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CA0BxF"}

package/dist/tools/extract-audio.js

@@ -2,6 +2,7 @@ import { resolve as resolvePath } from "node:path";
 import { z } from "zod";
 import { clip, err } from "../core/format.js";
 import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
 const ExtractAudioParams = z.object({
     input: z.string(),
     output: z.string().describe(".wav recommended for downstream analysis."),
@@ -16,14 +17,19 @@ export function createExtractAudioTool(cwd) {
         async execute({ input, output, sampleRate = 16000 }, ctx) {
             if (!checkFfmpeg())
                 return err("ffmpeg not on PATH", "install ffmpeg");
-            const inAbs = resolvePath(cwd, input);
-            const outAbs = resolvePath(cwd, output);
-            const r = await runFfmpeg(["-i", inAbs, "-vn", "-ac", "1", "-ar", String(sampleRate), "-c:a", "pcm_s16le", outAbs], { signal: ctx.signal });
-            if (r.code !== 0) {
-                const tail = r.stderr.split("\n").filter(Boolean).slice(-3).join(" | ");
-                return err(`ffmpeg exited ${r.code}: ${clip(tail, 200)}`);
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = safeOutputPath(cwd, output);
+                const r = await runFfmpeg(["-i", inAbs, "-vn", "-ac", "1", "-ar", String(sampleRate), "-c:a", "pcm_s16le", outAbs], { signal: ctx.signal });
+                if (r.code !== 0) {
+                    const tail = r.stderr.split("\n").filter(Boolean).slice(-3).join(" | ");
+                    return err(`ffmpeg exited ${r.code}: ${clip(tail, 200)}`);
+                }
+                return `ok:${outAbs}`;
+            }
+            catch (e) {
+                return err(e.message);
             }
-            return `ok:${outAbs}`;
         },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"extract-audio.js","sourceRoot":"","sources":["../../src/tools/extract-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,qFAAqF;YACrF,uCAAuC;QACzC,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,EAAE,GAAG;YACtD,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,MAAM,SAAS,CACvB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EACxF,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;YACF,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxE,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,MAAM,MAAM,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"extract-audio.js","sourceRoot":"","sources":["../../src/tools/extract-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,qFAAqF;YACrF,uCAAuC;QACzC,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,EAAE,GAAG;YACtD,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,MAAM,CAAC,GAAG,MAAM,SAAS,CACvB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EACxF,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;gBACF,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACjB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACxE,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBACD,OAAO,MAAM,MAAM,EAAE,CAAC;YACxB,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/face-reframe.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const FaceReframeParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    aspect: z.ZodEnum<{
+        "9:16": "9:16";
+        "1:1": "1:1";
+        "4:5": "4:5";
+        "16:9": "16:9";
+    }>;
+    strategy: z.ZodOptional<z.ZodEnum<{
+        face: "face";
+        motion: "motion";
+        static: "static";
+    }>>;
+    sampleFps: z.ZodOptional<z.ZodNumber>;
+    smoothingWindowSec: z.ZodOptional<z.ZodNumber>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * face_reframe — file-only face-tracked vertical reframe. Pairs with
+ * reformat_timeline (NLE-side timeline reflow) for the full short-form
+ * pipeline: NLE picks the timeline geometry, this tool bakes a follow-the-
+ * subject crop into a delivery-ready mp4.
+ */
+export declare function createFaceReframeTool(cwd: string): AgentTool<typeof FaceReframeParams>;
+export {};
+//# sourceMappingURL=face-reframe.d.ts.map

package/dist/tools/face-reframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-reframe.d.ts","sourceRoot":"","sources":["../../src/tools/face-reframe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOrD,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBA0CrB,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAqGtF"}

package/dist/tools/face-reframe.js

@@ -0,0 +1,143 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { analyzeReframe, buildReframeFilter } from "../core/face-reframe.js";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+import { findPython } from "../core/python.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const FaceReframeParams = z.object({
+    input: z.string().describe("Source video (relative resolves to cwd)."),
+    output: z
+        .string()
+        .describe("Output mp4 (relative resolves to cwd; sandbox-safe paths only). Re-encoded video; " +
+        "audio is copied through."),
+    aspect: z
+        .enum(["9:16", "1:1", "4:5", "16:9"])
+        .describe("Target aspect ratio. 9:16 for Reels/Shorts/TikTok; 1:1 for Instagram feed; 4:5 for " +
+        "vertical-feed; 16:9 for letterboxing odd footage to delivery. Aspect math is " +
+        "computed against source dimensions."),
+    strategy: z
+        .enum(["face", "motion", "static"])
+        .optional()
+        .describe("Tracking strategy. 'face' (default) follows the largest face per shot via MediaPipe; " +
+        "'static' centre-crops the whole video without analysis (cheap fallback). 'motion' " +
+        "is reserved — currently treated as 'face'."),
+    sampleFps: z
+        .number()
+        .positive()
+        .max(30)
+        .optional()
+        .describe("Frames-per-second to face-detect at. Default 5. Higher = smoother tracking + slower; " +
+        "lower = faster + jumpier. 5 is the sweet spot for talking-head shorts."),
+    smoothingWindowSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Smoothing window for the per-shot centre. Default 0.5s. The sidecar uses the median " +
+        "over each shot which already rejects spikes; this knob is informational right now."),
+    videoCodec: z.string().optional().describe("Default libx264."),
+    crf: z.number().int().min(0).max(51).optional().describe("Default 20."),
+});
+/**
+ * face_reframe — file-only face-tracked vertical reframe. Pairs with
+ * reformat_timeline (NLE-side timeline reflow) for the full short-form
+ * pipeline: NLE picks the timeline geometry, this tool bakes a follow-the-
+ * subject crop into a delivery-ready mp4.
+ */
+export function createFaceReframeTool(cwd) {
+    return {
+        name: "face_reframe",
+        description: "File-only face-tracked vertical reframe. Detects shots (PySceneDetect), tracks the " +
+            "largest face per shot (MediaPipe), low-pass smooths the centre, emits an ffmpeg " +
+            "crop filter that follows the subject. Falls back to centre crop when no face " +
+            "detected. Pair with reformat_timeline for the full short-form pipeline. REQUIRES " +
+            "python3 + `pip install opencv-python mediapipe scenedetect numpy` and ffmpeg on " +
+            "PATH. Output is a finished mp4 ready for burn_subtitles / normalize_loudness.",
+        parameters: FaceReframeParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (!findPython()) {
+                return err("Python 3 not on PATH", "install python3 and: pip install opencv-python mediapipe scenedetect numpy");
+            }
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const outAbs = safeOutputPath(cwd, args.output);
+                if (inAbs === outAbs) {
+                    return err("output and input are identical", "use a different output path");
+                }
+                let plan;
+                try {
+                    plan = await analyzeReframe(inAbs, {
+                        signal: ctx.signal,
+                        sampleFps: args.sampleFps,
+                        minDetectionConfidence: 0.5,
+                        smoothingWindowSec: args.smoothingWindowSec,
+                    });
+                }
+                catch (e) {
+                    const msg = e.message;
+                    if (/missing python dep/i.test(msg)) {
+                        return err(msg, "pip install opencv-python mediapipe scenedetect numpy");
+                    }
+                    return err(msg);
+                }
+                if (!plan.shots || plan.shots.length === 0) {
+                    return err("no shots detected and no fallback produced", "verify the input is a readable video file");
+                }
+                if (!plan.sourceWidth || !plan.sourceHeight) {
+                    return err("sidecar returned no source dimensions", "input may not be a video file");
+                }
+                // 'static' strategy bypasses tracking — pin every shot's centre to (0.5, 0.5).
+                const aspect = args.aspect;
+                const strategy = args.strategy ?? "face";
+                const planForFilter = strategy === "static"
+                    ? {
+                        ...plan,
+                        shots: plan.shots.map((s) => ({
+                            ...s,
+                            smoothedX: 0.5,
+                            smoothedY: 0.5,
+                            mode: "static",
+                        })),
+                    }
+                    : plan;
+                const { filter, outWidth, outHeight } = buildReframeFilter(planForFilter, aspect);
+                const codec = args.videoCodec ?? "libx264";
+                const crf = String(args.crf ?? 20);
+                const r = await runFfmpeg(["-i", inAbs, "-vf", filter, "-c:v", codec, "-crf", crf, "-c:a", "copy", outAbs], { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg failed: ${tail(r.stderr)}`);
+                }
+                const faceShots = planForFilter.shots.filter((s) => s.mode === "face").length;
+                const fallbackShots = planForFilter.shots.filter((s) => s.mode === "static").length;
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    aspect,
+                    outWidth,
+                    outHeight,
+                    shots: planForFilter.shots.length,
+                    faceShots,
+                    fallbackShots,
+                    totalSec: round(plan.totalSec, 3),
+                    sourceWidth: plan.sourceWidth,
+                    sourceHeight: plan.sourceHeight,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+function round(n, places) {
+    if (!Number.isFinite(n))
+        return n;
+    const m = 10 ** places;
+    return Math.round(n * m) / m;
+}
+//# sourceMappingURL=face-reframe.js.map

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

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

package/dist/tools/face-reframe.test.d.ts

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

package/dist/tools/face-reframe.test.d.ts.map

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