@kenkaiiii/gg-editor 0.1.0

package/dist/tools/apply-lut.js

@@ -0,0 +1,33 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const ApplyLutParams = z.object({
+    clipId: z.string().min(1).describe("Clip id from get_timeline."),
+    lutPath: z.string().min(1).describe(".cube/.dat LUT file (relative path resolves to cwd)."),
+    nodeIndex: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-based node index. Default 1 (always exists)."),
+});
+export function createApplyLutTool(host, cwd) {
+    return {
+        name: "apply_lut",
+        description: "Apply a LUT to a clip's grading node (Resolve only). " +
+            "Premiere has no scriptable equivalent — the tool will return an error there. " +
+            "Use as the base of a per-clip grade, then layer set_primary_correction on top.",
+        parameters: ApplyLutParams,
+        async execute({ clipId, lutPath, nodeIndex }) {
+            try {
+                const abs = resolvePath(cwd, lutPath);
+                await host.applyLut(clipId, abs, nodeIndex);
+                return compact({ clipId, lutPath: abs, nodeIndex: nodeIndex ?? 1 });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=apply-lut.js.map

package/dist/tools/apply-lut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-lut.js","sourceRoot":"","sources":["../../src/tools/apply-lut.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;AAGjD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC3F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,GAAW;IAC7D,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,uDAAuD;YACvD,+EAA+E;YAC/E,gFAAgF;QAClF,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;YAC1C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC5C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,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/burn-subtitles.d.ts

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

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

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

package/dist/tools/burn-subtitles.js

@@ -0,0 +1,87 @@
+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 BurnSubtitlesParams = z.object({
+    input: z.string().describe("Source video file."),
+    subtitles: z.string().describe("Path to .srt or .ass subtitle file."),
+    output: z.string().describe("Where to write the captioned video."),
+    videoCodec: z
+        .string()
+        .optional()
+        .describe("Output video codec. Default 'libx264'. Use 'libx265' for HEVC."),
+    crf: z
+        .number()
+        .int()
+        .min(0)
+        .max(51)
+        .optional()
+        .describe("Quality (lower=better). 18=visually lossless, 23=default, 28=acceptable web."),
+});
+export function createBurnSubtitlesTool(cwd) {
+    return {
+        name: "burn_subtitles",
+        description: "Hardcode subtitles into a video. Accepts both .srt and .ass — for styled vertical captions " +
+            "you'll want .ass via write_ass. The output is a fresh re-encode (subtitles can't be burned " +
+            "without re-encoding video). Audio is copied unchanged. End-of-pipeline tool: run AFTER " +
+            "loudness normalization and any cleanup.",
+        parameters: BurnSubtitlesParams,
+        async execute({ input, subtitles, output, videoCodec, crf }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const subAbs = resolvePath(cwd, subtitles);
+                const outAbs = resolvePath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "use a different output path");
+                }
+                // ffmpeg's `subtitles` filter parses .srt and .ass. We escape the
+                // path because the filter arg uses : and \ as separators.
+                const filter = `subtitles=${escapeFilterPath(subAbs)}`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-i",
+                    inAbs,
+                    "-vf",
+                    filter,
+                    "-c:v",
+                    videoCodec ?? "libx264",
+                    "-crf",
+                    String(crf ?? 18),
+                    "-c:a",
+                    "copy",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(args, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg exited ${r.code}`, "verify subtitle file is valid .srt or .ass");
+                }
+                return compact({ ok: true, path: outAbs });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Escape a path for ffmpeg's `subtitles=` filter argument.
+ *
+ * Cross-platform rules (verified against RightNow-AI/openfang's clip skill
+ * + ffmpeg's filter manual):
+ *   - Forward slashes, never backslashes — ffmpeg's filtergraph parser
+ *     treats `\` as an escape; on Windows paths come in as `C:\foo` and
+ *     must become `C:/foo` first.
+ *   - The drive-letter colon (`C:`) MUST be escaped as `C\:` because the
+ *     filtergraph uses bare colons as arg separators.
+ *   - Single quotes inside the path get backslash-escaped.
+ *
+ * Result for a typical Windows abs path:
+ *   `C:\Users\me\subs.ass`  →  `C\:/Users/me/subs.ass`
+ */
+export function escapeFilterPath(p) {
+    return p.replace(/\\/g, "/").replace(/:/g, "\\:").replace(/'/g, "\\'");
+}
+//# sourceMappingURL=burn-subtitles.js.map

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

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

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

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

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

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

package/dist/tools/clean-audio.js

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

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

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

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

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

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

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

package/dist/tools/clone-timeline.js

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

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

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

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

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

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

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

package/dist/tools/cluster-takes.js

@@ -0,0 +1,71 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { clip, compact, err, summarizeList } from "../core/format.js";
+import { clusterSegments } from "../core/clustering.js";
+const ClusterTakesParams = z.object({
+    path: z.string().describe("Transcript JSON file written by `transcribe`."),
+    threshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("Jaccard similarity 0-1 to count as same take. Default 0.6 (loose); 0.8 = strict."),
+    window: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Only compare segments within N positions of each other. Default 100."),
+    minTokens: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Skip segments with fewer than N meaningful tokens. Default 4."),
+});
+export function createClusterTakesTool(cwd) {
+    return {
+        name: "cluster_takes",
+        description: "Find repeated takes in a transcript — groups of segments that are likely the same line " +
+            "said multiple times (re-takes). Use to pick the BEST take per cluster: read each cluster's " +
+            "members, then call score_shot at their timestamps to evaluate visual quality, then write_edl " +
+            "with the winners. Token-based similarity (free, deterministic, no API call).",
+        parameters: ClusterTakesParams,
+        async execute({ path, threshold, window, minTokens }) {
+            try {
+                const abs = resolvePath(cwd, path);
+                const t = JSON.parse(readFileSync(abs, "utf8"));
+                if (!t.segments || t.segments.length === 0) {
+                    return err("transcript has no segments", "verify the file is from `transcribe`");
+                }
+                const clusters = clusterSegments(t.segments, { threshold, window, minTokens });
+                // Compact view: one entry per cluster with size + member timestamps + truncated text.
+                // Cap members per cluster to 5 so context stays predictable.
+                const compactClusters = clusters.map((c) => ({
+                    id: c.id,
+                    size: c.members.length,
+                    members: c.members.slice(0, 5).map((m) => ({
+                        start: +m.start.toFixed(2),
+                        end: +m.end.toFixed(2),
+                        text: clip(m.text, 80),
+                    })),
+                    ...(c.members.length > 5 ? { truncated: c.members.length - 5 } : {}),
+                }));
+                const summary = summarizeList(compactClusters, 30);
+                return compact({
+                    totalSegments: t.segments.length,
+                    clustersFound: clusters.length,
+                    totalRetakes: clusters.reduce((sum, c) => sum + c.members.length, 0),
+                    ...(summary.omitted > 0
+                        ? { omitted: summary.omitted, head: summary.head, tail: summary.tail }
+                        : { clusters: compactClusters }),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=cluster-takes.js.map

package/dist/tools/cluster-takes.js.map

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

package/dist/tools/color-match.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ColorMatchParams: z.ZodObject<{
+    referenceVideo: z.ZodString;
+    referenceAtSec: z.ZodNumber;
+    targetVideo: z.ZodString;
+    targetAtSec: z.ZodNumber;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createColorMatchTool(cwd: string): AgentTool<typeof ColorMatchParams>;
+export {};
+//# sourceMappingURL=color-match.d.ts.map

package/dist/tools/color-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-match.d.ts","sourceRoot":"","sources":["../../src/tools/color-match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,QAAA,MAAM,gBAAgB;;;;;;;;;;iBAOpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAsCpF"}

package/dist/tools/color-match.js

@@ -0,0 +1,55 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { deriveColorMatch } from "../core/color-match.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+const ColorMatchParams = z.object({
+    referenceVideo: z.string().describe("Reference video file (the look you want)."),
+    referenceAtSec: z.number().min(0).describe("Time in the reference to sample."),
+    targetVideo: z.string().describe("Target video file (clip you want to match)."),
+    targetAtSec: z.number().min(0).describe("Time in the target to sample."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low (cheap)."),
+    model: z.string().optional().describe("OpenAI model id. Default gpt-4o-mini."),
+});
+export function createColorMatchTool(cwd) {
+    return {
+        name: "color_match",
+        description: "Vision-derived CDL: compares a reference frame to a target frame and emits " +
+            "slope/offset/power/saturation values that bring the target toward the reference. " +
+            "READ-ONLY — returns the CDL; agent then pipes it to set_primary_correction " +
+            "(or rejects it if confidence is low). NOT a substitute for ColorChecker matching — " +
+            "this is for 'similar shots that feel off'. ALWAYS check `confidence`; below 0.4 means " +
+            "the model is guessing and you should skip applying.",
+        parameters: ColorMatchParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (!process.env.OPENAI_API_KEY) {
+                return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+            }
+            try {
+                const refAbs = resolvePath(cwd, args.referenceVideo);
+                const tgtAbs = resolvePath(cwd, args.targetVideo);
+                const [refFrame] = await extractAtTimes(refAbs, [args.referenceAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const [tgtFrame] = await extractAtTimes(tgtAbs, [args.targetAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const cdl = await deriveColorMatch(refFrame.path, tgtFrame.path, {
+                    detail: args.detail,
+                    model: args.model,
+                    signal: ctx.signal,
+                });
+                return compact({ cdl });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=color-match.js.map

package/dist/tools/color-match.js.map

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

package/dist/tools/compose-layered.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ComposeLayeredParams: z.ZodObject<{
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    layers: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        sourcePath: z.ZodString;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        lane: z.ZodDefault<z.ZodNumber>;
+        recordOffsetFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            keyframes: z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                value: z.ZodNumber;
+                interp: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeIn: "easeIn";
+                    easeOut: "easeOut";
+                    smooth: "smooth";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+        volumeDb: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            keyframes: z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                value: z.ZodNumber;
+                interp: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeIn: "easeIn";
+                    easeOut: "easeOut";
+                    smooth: "smooth";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+    fcpxmlOutput: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createComposeLayeredTool(host: VideoHost, cwd: string): AgentTool<typeof ComposeLayeredParams>;
+export {};
+//# sourceMappingURL=compose-layered.d.ts.map

package/dist/tools/compose-layered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-layered.d.ts","sourceRoot":"","sources":["../../src/tools/compose-layered.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA4CxD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBxB,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAyCxC"}

package/dist/tools/compose-layered.js

@@ -0,0 +1,103 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+const LayerSchema = z.object({
+    reel: z.string().describe("Source identifier — same reel = same asset."),
+    sourcePath: z.string().describe("Absolute (or cwd-relative) source media path."),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    /** 0 = main spine, 1+ = stacked above. */
+    lane: z.number().int().min(0).default(0),
+    /** Frame on the timeline where this layer's clip starts. */
+    recordOffsetFrame: z.number().int().min(0),
+    clipName: z.string().optional(),
+    /** Static or animated opacity 0..1. Pass a number for static; an object for keyframed. */
+    opacity: z
+        .union([
+        z.number().min(0).max(1),
+        z.object({
+            keyframes: z.array(z.object({
+                frame: z.number().int().min(0),
+                value: z.number().min(0).max(1),
+                interp: z.enum(["linear", "easeIn", "easeOut", "smooth"]).optional(),
+            })),
+        }),
+    ])
+        .optional(),
+    /** Static volume in dB; pass an object for keyframed ramps. */
+    volumeDb: z
+        .union([
+        z.number(),
+        z.object({
+            keyframes: z.array(z.object({
+                frame: z.number().int().min(0),
+                value: z.number(),
+                interp: z.enum(["linear", "easeIn", "easeOut", "smooth"]).optional(),
+            })),
+        }),
+    ])
+        .optional(),
+});
+const ComposeLayeredParams = z.object({
+    title: z.string().describe("Project name on the rebuilt timeline."),
+    frameRate: z.number().positive(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+    layers: z
+        .array(LayerSchema)
+        .min(1)
+        .describe("Multi-track composition. Spine clips (lane=0) lay out in array order; lane>=1 " +
+        "clips sit at their recordOffsetFrame above the spine."),
+    fcpxmlOutput: z
+        .string()
+        .optional()
+        .describe("Optional .fcpxml output path. Defaults to a tempfile."),
+    dryRun: z.boolean().optional(),
+});
+export function createComposeLayeredTool(host, cwd) {
+    return {
+        name: "compose_layered",
+        description: "Build a multi-track timeline (B-roll + lower-thirds + main A-roll) by emitting an " +
+            "FCPXML with lane='N' clips and importing it. One call replaces the active timeline " +
+            "with the composed result. DESTRUCTIVE — clone_timeline first if you need a safety " +
+            "net. Use insert_broll for single-clip layer additions.",
+        parameters: ComposeLayeredParams,
+        async execute({ title, frameRate, width, height, layers, fcpxmlOutput, dryRun }) {
+            try {
+                const events = layers.map((l) => {
+                    const sourcePath = resolvePath(cwd, l.sourcePath);
+                    return {
+                        reel: l.reel,
+                        sourcePath,
+                        sourceInFrame: l.sourceInFrame,
+                        sourceOutFrame: l.sourceOutFrame,
+                        lane: l.lane,
+                        recordOffsetFrame: l.recordOffsetFrame,
+                        clipName: l.clipName,
+                        opacity: l.opacity,
+                        volumeDb: l.volumeDb,
+                    };
+                });
+                const xml = buildFcpxml({ title, frameRate, width, height, events });
+                const outAbs = fcpxmlOutput
+                    ? resolvePath(cwd, fcpxmlOutput)
+                    : join(mkdtempSync(join(tmpdir(), "gg-compose-")), "composed.fcpxml");
+                if (fcpxmlOutput)
+                    mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, xml, "utf8");
+                if (dryRun) {
+                    return compact({ ok: true, path: outAbs, layers: layers.length, dryRun: true });
+                }
+                await host.importTimeline(outAbs);
+                return compact({ ok: true, path: outAbs, layers: layers.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=compose-layered.js.map