@kenkaiiii/gg-editor 0.1.0

package/dist/tools/duck-audio.js

@@ -0,0 +1,73 @@
+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 { duckAudio } from "../core/ducking.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+const DuckAudioParams = z.object({
+    voice: z.string().describe("Voice / dialogue track (audio or video file)."),
+    background: z.string().describe("Music or ambient track to duck."),
+    output: z.string().describe("Mixed output path."),
+    threshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("Sidechain threshold (linear amplitude, 0-1). Voice ABOVE this triggers ducking. " +
+        "Default 0.02 matches typical dialogue average energy. Try 0.012 for very quiet voices, " +
+        "0.05 if music keeps ducking on background noise."),
+    ratio: z
+        .number()
+        .min(1)
+        .optional()
+        .describe("Compression ratio. Default 8 (heavy duck — typical podcast)."),
+    attackMs: z.number().min(0).optional().describe("Attack in ms. Default 5."),
+    releaseMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Release in ms. Default 250 — music breathes back gradually."),
+    voiceGain: z.number().min(0).optional().describe("Voice level multiplier. Default 1."),
+    bgGain: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Background level multiplier (pre-duck). Default 1."),
+});
+export function createDuckAudioTool(cwd) {
+    return {
+        name: "duck_audio",
+        description: "Sidechain ducking: lower a music/ambient track when voice is present (then bring it " +
+            "back when silent). Standard podcast/YouTube technique. Defaults are tuned for spoken " +
+            "voice over music. Output is a single mixed audio file. Run AFTER take selection / " +
+            "filler removal but BEFORE normalize_loudness.",
+        parameters: DuckAudioParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const voiceAbs = resolvePath(cwd, args.voice);
+                const bgAbs = resolvePath(cwd, args.background);
+                const outAbs = resolvePath(cwd, args.output);
+                if (voiceAbs === outAbs || bgAbs === outAbs) {
+                    return err("output path collides with an input", "use a different output path");
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const r = await duckAudio(voiceAbs, bgAbs, outAbs, {
+                    threshold: args.threshold,
+                    ratio: args.ratio,
+                    attackMs: args.attackMs,
+                    releaseMs: args.releaseMs,
+                    voiceGain: args.voiceGain,
+                    bgGain: args.bgGain,
+                    signal: ctx.signal,
+                });
+                return compact({ ok: true, path: r.output });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=duck-audio.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ExtractAudioParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createExtractAudioTool(cwd: string): AgentTool<typeof ExtractAudioParams>;
+export {};
+//# sourceMappingURL=extract-audio.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/extract-audio.js

@@ -0,0 +1,30 @@
+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";
+const ExtractAudioParams = z.object({
+    input: z.string(),
+    output: z.string().describe(".wav recommended for downstream analysis."),
+    sampleRate: z.number().int().optional().describe("Default 16000 (whisper-friendly)."),
+});
+export function createExtractAudioTool(cwd) {
+    return {
+        name: "extract_audio",
+        description: "Extract a video's audio as mono WAV (default 16kHz). First step for transcription, " +
+            "silence detection, or audio analysis.",
+        parameters: ExtractAudioParams,
+        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)}`);
+            }
+            return `ok:${outAbs}`;
+        },
+    };
+}
+//# sourceMappingURL=extract-audio.js.map

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

@@ -0,0 +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"}

package/dist/tools/extract-frame.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ExtractFrameParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    atSec: z.ZodNumber;
+    quality: z.ZodOptional<z.ZodNumber>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createExtractFrameTool(cwd: string): AgentTool<typeof ExtractFrameParams>;
+export {};
+//# sourceMappingURL=extract-frame.d.ts.map

package/dist/tools/extract-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-frame.d.ts","sourceRoot":"","sources":["../../src/tools/extract-frame.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,QAAA,MAAM,kBAAkB;;;;;;iBAiBtB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAoCxF"}

package/dist/tools/extract-frame.js

@@ -0,0 +1,63 @@
+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 ExtractFrameParams = z.object({
+    input: z.string().describe("Source video file."),
+    output: z.string().describe(".jpg or .png path for the extracted frame."),
+    atSec: z.number().min(0).describe("Timestamp in seconds where to grab the frame."),
+    quality: z
+        .number()
+        .int()
+        .min(1)
+        .max(31)
+        .optional()
+        .describe("JPEG quality 1-31 (lower=better, ffmpeg convention). Default 2."),
+    maxWidth: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Optional max width — preserves aspect, scales down."),
+});
+export function createExtractFrameTool(cwd) {
+    return {
+        name: "extract_frame",
+        description: "Pull a single frame as a JPEG/PNG file. Use AFTER score_shot to save the chosen " +
+            "hero frame as a thumbnail. Pair with score_shot(times=[...]) to find the moment, " +
+            "then this tool to save it.",
+        parameters: ExtractFrameParams,
+        async execute({ input, output, atSec, quality, maxWidth }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = resolvePath(cwd, output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-ss",
+                    String(atSec),
+                    "-i",
+                    inAbs,
+                    "-frames:v",
+                    "1",
+                    "-q:v",
+                    String(quality ?? 2),
+                ];
+                if (maxWidth)
+                    args.push("-vf", `scale=${maxWidth}:-1`);
+                args.push(outAbs);
+                const r = await runFfmpeg(args, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg exited ${r.code}`, "verify atSec is within file duration");
+                }
+                return compact({ ok: true, path: outAbs, atSec });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=extract-frame.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-frame.js","sourceRoot":"","sources":["../../src/tools/extract-frame.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,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAClF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,kFAAkF;YAClF,mFAAmF;YACnF,4BAA4B;QAC9B,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG;YAC5D,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,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,IAAI,GAAG;oBACX,KAAK;oBACL,MAAM,CAAC,KAAK,CAAC;oBACb,IAAI;oBACJ,KAAK;oBACL,WAAW;oBACX,GAAG;oBACH,MAAM;oBACN,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;iBACrB,CAAC;gBACF,IAAI,QAAQ;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,KAAK,CAAC,CAAC;gBACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClB,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACjB,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,sCAAsC,CAAC,CAAC;gBAChF,CAAC;gBACD,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,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/generate-gif.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const GenerateGifParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    fps: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createGenerateGifTool(cwd: string): AgentTool<typeof GenerateGifParams>;
+export {};
+//# sourceMappingURL=generate-gif.d.ts.map

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

@@ -0,0 +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;AAIrD,QAAA,MAAM,iBAAiB;;;;;;;iBAsBrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAuEtF"}

package/dist/tools/generate-gif.js

@@ -0,0 +1,94 @@
+import { mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, 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 GenerateGifParams = z.object({
+    input: z.string().describe("Source video file."),
+    output: z.string().describe("Output .gif path."),
+    startSec: z.number().min(0).optional().describe("Source-in seconds. Default 0."),
+    durationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Length to capture. Default 5s. Cap at 15s — GIFs balloon fast."),
+    fps: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .optional()
+        .describe("Output GIF fps. Default 12 (good quality:size ratio for social previews)."),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Output width in pixels (height auto). Default 480."),
+});
+export function createGenerateGifTool(cwd) {
+    return {
+        name: "generate_gif",
+        description: "Two-pass GIF generation (palettegen → paletteuse) for high-quality output at small file " +
+            "sizes. Use for social previews, README embeds, Twitter posts. Default 480px @ 12fps for " +
+            "5 seconds. Cap at 15s — GIFs >5MB stop autoplaying on most platforms.",
+        parameters: GenerateGifParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const outAbs = resolvePath(cwd, args.output);
+                if (!/\.gif$/i.test(outAbs)) {
+                    return err("output must end in .gif", `got: ${outAbs}`);
+                }
+                const start = args.startSec ?? 0;
+                const dur = args.durationSec ?? 5;
+                const fps = args.fps ?? 12;
+                const width = args.width ?? 480;
+                if (dur > 15) {
+                    return err(`durationSec ${dur} > 15s`, "GIFs over 15s rarely autoplay; use a smaller window");
+                }
+                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 });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-gif.js.map

package/dist/tools/generate-gif.js.map

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

package/dist/tools/get-markers.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const GetMarkersParams: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    color: z.ZodOptional<z.ZodString>;
+    contains: z.ZodOptional<z.ZodString>;
+    startFrame: z.ZodOptional<z.ZodNumber>;
+    endFrame: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createGetMarkersTool(host: VideoHost): AgentTool<typeof GetMarkersParams>;
+export {};
+//# sourceMappingURL=get-markers.d.ts.map

package/dist/tools/get-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-markers.d.ts","sourceRoot":"","sources":["../../src/tools/get-markers.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;AAGxD,QAAA,MAAM,gBAAgB;;;;;;iBAgBpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CA8CxF"}

package/dist/tools/get-markers.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+import { RESOLVE_TO_PREMIERE_INDEX } from "../core/marker-colors.js";
+const GetMarkersParams = z.object({
+    full: z
+        .boolean()
+        .optional()
+        .describe("Return all markers (no summarization). Pass when total is small."),
+    color: z
+        .string()
+        .optional()
+        .describe("Filter by marker color (case-insensitive, e.g. 'red' / 'green' / 'purple'). " +
+        "Premiere returns numeric color indices; Resolve returns names. The filter matches " +
+        "either by string equality or by the Resolve color name → Premiere index map."),
+    contains: z.string().optional().describe("Substring filter on marker note (case-insensitive)."),
+    startFrame: z.number().int().min(0).optional().describe("Lower frame bound (inclusive)."),
+    endFrame: z.number().int().min(0).optional().describe("Upper frame bound (exclusive)."),
+});
+export function createGetMarkersTool(host) {
+    return {
+        name: "get_markers",
+        description: "Read existing markers from the active timeline. Call at session start to see prior " +
+            "editorial decisions. Filter by color, note substring, or frame range so you don't " +
+            "blow context on unrelated markers.",
+        parameters: GetMarkersParams,
+        async execute({ full, color, contains, startFrame, endFrame }) {
+            try {
+                const all = await host.getMarkers();
+                const needle = contains?.toLowerCase();
+                const wantColor = color?.toLowerCase();
+                const wantIndex = wantColor !== undefined ? RESOLVE_TO_PREMIERE_INDEX[wantColor] : undefined;
+                const filtered = all.filter((m) => {
+                    if (startFrame !== undefined && m.frame < startFrame)
+                        return false;
+                    if (endFrame !== undefined && m.frame >= endFrame)
+                        return false;
+                    if (needle && !(m.note ?? "").toLowerCase().includes(needle))
+                        return false;
+                    if (wantColor !== undefined) {
+                        const c = m.color;
+                        if (typeof c === "string") {
+                            if (c.toLowerCase() !== wantColor)
+                                return false;
+                        }
+                        else if (typeof c === "number") {
+                            if (wantIndex === undefined || c !== wantIndex)
+                                return false;
+                        }
+                        else {
+                            return false;
+                        }
+                    }
+                    return true;
+                });
+                if (full)
+                    return compact({ markers: filtered, total: filtered.length });
+                const s = summarizeList(filtered, 20);
+                return compact({
+                    total: s.total,
+                    omitted: s.omitted,
+                    head: s.head,
+                    tail: s.tail,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-markers.js.map

package/dist/tools/get-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-markers.js","sourceRoot":"","sources":["../../src/tools/get-markers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8EAA8E;QAC5E,oFAAoF;QACpF,8EAA8E,CACjF;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,qFAAqF;YACrF,oFAAoF;YACpF,oCAAoC;QACtC,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;YAC3D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,QAAQ,EAAE,WAAW,EAAE,CAAC;gBACvC,MAAM,SAAS,GAAG,KAAK,EAAE,WAAW,EAAE,CAAC;gBACvC,MAAM,SAAS,GACb,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAE7E,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;oBAChC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,GAAG,UAAU;wBAAE,OAAO,KAAK,CAAC;oBACnE,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ;wBAAE,OAAO,KAAK,CAAC;oBAChE,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAAE,OAAO,KAAK,CAAC;oBAC3E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;wBAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;wBAClB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;4BAC1B,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS;gCAAE,OAAO,KAAK,CAAC;wBAClD,CAAC;6BAAM,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;4BACjC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;gCAAE,OAAO,KAAK,CAAC;wBAC/D,CAAC;6BAAM,CAAC;4BACN,OAAO,KAAK,CAAC;wBACf,CAAC;oBACH,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;gBAEH,IAAI,IAAI;oBAAE,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxE,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACtC,OAAO,OAAO,CAAC;oBACb,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,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/get-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 GetTimelineParams: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createGetTimelineTool(host: VideoHost): AgentTool<typeof GetTimelineParams>;
+export {};
+//# sourceMappingURL=get-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/get-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,iBAAiB;;iBAKrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAiC1F"}

package/dist/tools/get-timeline.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+const GetTimelineParams = z.object({
+    full: z
+        .boolean()
+        .optional()
+        .describe("Return all clips/markers (no summarization). Bloats context — use sparingly."),
+});
+export function createGetTimelineTool(host) {
+    return {
+        name: "get_timeline",
+        description: "Read the current timeline: name, fps, duration (frames), clips, markers. " +
+            "Long timelines are summarized (head + tail) by default; pass full=true to get everything.",
+        parameters: GetTimelineParams,
+        async execute({ full }) {
+            try {
+                const t = await host.getTimeline();
+                if (full) {
+                    return compact({
+                        name: t.name,
+                        fps: t.frameRate,
+                        dur: t.durationFrames,
+                        clips: t.clips,
+                        markers: t.markers,
+                    });
+                }
+                const cs = summarizeList(t.clips, 20);
+                const ms = summarizeList(t.markers, 20);
+                return compact({
+                    name: t.name,
+                    fps: t.frameRate,
+                    dur: t.durationFrames,
+                    clips: { total: cs.total, omitted: cs.omitted, head: cs.head, tail: cs.tail },
+                    markers: { total: ms.total, omitted: ms.omitted, head: ms.head, tail: ms.tail },
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-timeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-timeline.js","sourceRoot":"","sources":["../../src/tools/get-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,2EAA2E;YAC3E,2FAA2F;QAC7F,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,OAAO,CAAC;wBACb,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,GAAG,EAAE,CAAC,CAAC,SAAS;wBAChB,GAAG,EAAE,CAAC,CAAC,cAAc;wBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,OAAO,EAAE,CAAC,CAAC,OAAO;qBACnB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,EAAE,CAAC,CAAC,SAAS;oBAChB,GAAG,EAAE,CAAC,CAAC,cAAc;oBACrB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;oBAC7E,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;iBAChF,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/grade-skin-tones.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const GradeSkinTonesParams: z.ZodObject<{
+    referenceVideo: z.ZodString;
+    referenceAtSec: z.ZodNumber;
+    targetVideo: z.ZodString;
+    targetAtSec: z.ZodNumber;
+    output: z.ZodString;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * grade_skin_tones — file-only skin-tone match across clips. Derives a
+ * vision-tuned grade from REFERENCE vs TARGET frames and bakes it into a
+ * graded output via ffmpeg (colorbalance + selectivecolor + eq). Works on
+ * every host (no NLE required); the agent can then `replace_clip` the
+ * graded file onto the timeline.
+ *
+ * NOT a deterministic match (no ColorChecker). Use when "shots feel off"
+ * (different camera, location, white balance drift). Below confidence 0.4
+ * the grade is unreliable — surface the result and let the user grade
+ * manually.
+ */
+export declare function createGradeSkinTonesTool(cwd: string): AgentTool<typeof GradeSkinTonesParams>;
+export {};
+//# sourceMappingURL=grade-skin-tones.d.ts.map

package/dist/tools/grade-skin-tones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-skin-tones.d.ts","sourceRoot":"","sources":["../../src/tools/grade-skin-tones.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;iBAmBxB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAmD5F"}

package/dist/tools/grade-skin-tones.js

@@ -0,0 +1,92 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+import { applySkinGrade, deriveSkinGrade } from "../core/skin-grade.js";
+const GradeSkinTonesParams = z.object({
+    referenceVideo: z.string().describe("Reference video file (skin 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 (face-forward)."),
+    output: z
+        .string()
+        .min(1)
+        .describe("Output graded file (relative resolves to cwd). Re-encoded; audio is copied."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    model: z.string().optional().describe("OpenAI model id. Default gpt-4o-mini."),
+    videoCodec: z.string().optional().describe("ffmpeg video codec. Default libx264."),
+    crf: z
+        .number()
+        .int()
+        .min(0)
+        .max(51)
+        .optional()
+        .describe("x264 CRF. Default 18 (visually lossless)."),
+});
+/**
+ * grade_skin_tones — file-only skin-tone match across clips. Derives a
+ * vision-tuned grade from REFERENCE vs TARGET frames and bakes it into a
+ * graded output via ffmpeg (colorbalance + selectivecolor + eq). Works on
+ * every host (no NLE required); the agent can then `replace_clip` the
+ * graded file onto the timeline.
+ *
+ * NOT a deterministic match (no ColorChecker). Use when "shots feel off"
+ * (different camera, location, white balance drift). Below confidence 0.4
+ * the grade is unreliable — surface the result and let the user grade
+ * manually.
+ */
+export function createGradeSkinTonesTool(cwd) {
+    return {
+        name: "grade_skin_tones",
+        description: "File-only skin-tone match: bakes a vision-derived grade (colorbalance + selectivecolor " +
+            "+ eq, tuned for reds/yellows where skin lives) into a new video file. Works in every " +
+            "host. Returns {path, confidence, why, grade}. ALWAYS check `confidence`; below 0.4 " +
+            "means the model is guessing — show the user, don't apply blindly. Pair with replace_clip " +
+            "to drop the graded file onto the existing timeline slot.",
+        parameters: GradeSkinTonesParams,
+        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 outAbs = resolvePath(cwd, args.output);
+                if (outAbs === tgtAbs) {
+                    return err("output and target are identical", "use a different output path");
+                }
+                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 grade = await deriveSkinGrade(refFrame.path, tgtFrame.path, {
+                    detail: args.detail,
+                    model: args.model,
+                    signal: ctx.signal,
+                });
+                await applySkinGrade(tgtAbs, outAbs, grade, {
+                    videoCodec: args.videoCodec,
+                    crf: args.crf,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    path: outAbs,
+                    confidence: grade.confidence,
+                    why: grade.why,
+                    grade,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=grade-skin-tones.js.map

package/dist/tools/grade-skin-tones.js.map

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