@kenkaiiii/gg-editor 0.1.0

package/dist/tools/compose-layered.js.map

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

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

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ComposeThumbnailParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    atSec: z.ZodNumber;
+    text: z.ZodString;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    fontColor: z.ZodOptional<z.ZodString>;
+    outlineColor: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodEnum<{
+        top: "top";
+        center: "center";
+        bottom: "bottom";
+    }>>;
+    fontFile: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createComposeThumbnailTool(cwd: string): AgentTool<typeof ComposeThumbnailParams>;
+/**
+ * Escape a string for ffmpeg drawtext's `text='...'` parameter.
+ *
+ * Rules (verified against real-world implementations — GVCLab/CutClaw,
+ * g0ldyy/comet, ehendrix23/tesla_dashcam):
+ *   1. `\\` first  → `\\\\`
+ *   2. `:`         → `\\:`
+ *   3. `'`         → `\\'`
+ *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions like timecode)
+ *   5. newlines    → literal `\\n` (drawtext renders `\\n` as a line break)
+ *
+ * Backslash MUST come first so subsequent escapes don't double-escape it.
+ */
+export declare function escapeDrawtextValue(text: string): string;
+export {};
+//# sourceMappingURL=compose-thumbnail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-thumbnail.d.ts","sourceRoot":"","sources":["../../src/tools/compose-thumbnail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAyB1B,CAAC;AAUH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAmEhG;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxD"}

package/dist/tools/compose-thumbnail.js

@@ -0,0 +1,130 @@
+import { existsSync, 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 ComposeThumbnailParams = z.object({
+    input: z.string().describe("Source video."),
+    output: z.string().describe("Thumbnail .jpg or .png."),
+    atSec: z.number().min(0).describe("Frame timestamp."),
+    text: z.string().min(1).describe("Headline text overlay."),
+    fontSize: z.number().int().min(8).optional().describe("Default 96."),
+    fontColor: z.string().optional().describe("Hex RRGGBB. Default 'white'."),
+    outlineColor: z
+        .string()
+        .optional()
+        .describe("Outline hex RRGGBB. Default 'black'. Use empty string to disable."),
+    position: z.enum(["top", "center", "bottom"]).optional().describe("Default 'bottom'."),
+    fontFile: z
+        .string()
+        .optional()
+        .describe("Path to a TTF font file. ffmpeg drawtext requires this on most systems. " +
+        "Default tries common system locations."),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Optional output width (height auto). Common: 1280 for YouTube."),
+});
+const SYSTEM_FONT_GUESSES = [
+    "/System/Library/Fonts/Helvetica.ttc",
+    "/System/Library/Fonts/Supplemental/Arial.ttf",
+    "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
+    "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf",
+    "C:\\Windows\\Fonts\\Arial.ttf",
+];
+export function createComposeThumbnailTool(cwd) {
+    return {
+        name: "compose_thumbnail",
+        description: "Pull a frame and burn a text headline on top, in one shot. YouTube/TikTok thumbnail " +
+            "generation. ffmpeg drawtext requires a TTF font path; we try common system locations " +
+            "(macOS Helvetica, DejaVu on Linux, Arial on Windows) when fontFile isn't given. Default " +
+            "is large white text with black outline at the bottom — readable at thumbnail scale.",
+        parameters: ComposeThumbnailParams,
+        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);
+                const fontFile = args.fontFile ? resolvePath(cwd, args.fontFile) : pickFont();
+                if (!fontFile) {
+                    return err("no system font found", "pass fontFile=<path-to-.ttf> (try ~/Library/Fonts on macOS or /usr/share/fonts on Linux)");
+                }
+                const fontSize = args.fontSize ?? 96;
+                const fontColor = args.fontColor ?? "white";
+                const outlineColor = args.outlineColor === "" ? "" : (args.outlineColor ?? "black");
+                const pos = args.position ?? "bottom";
+                const yExpr = pos === "top" ? "h*0.08" : pos === "center" ? "(h-text_h)/2" : "h-text_h-h*0.08";
+                const safeText = escapeDrawtextValue(args.text);
+                const drawText = `drawtext=fontfile=${escapeFilterPath(fontFile)}:` +
+                    `text='${safeText}':` +
+                    `fontsize=${fontSize}:` +
+                    `fontcolor=${fontColor}:` +
+                    `x=(w-text_w)/2:` +
+                    `y=${yExpr}` +
+                    (outlineColor ? `:bordercolor=${outlineColor}:borderw=4` : "");
+                const vf = args.width ? `scale=${args.width}:-1,${drawText}` : drawText;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const r = await runFfmpeg([
+                    "-ss",
+                    String(args.atSec),
+                    "-i",
+                    inAbs,
+                    "-frames:v",
+                    "1",
+                    "-vf",
+                    vf,
+                    "-q:v",
+                    "2",
+                    outAbs,
+                ], { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg drawtext exited ${r.code}`, "verify atSec is in range and ffmpeg has --enable-libfreetype");
+                }
+                return compact({ ok: true, path: outAbs, atSec: args.atSec, fontFile });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function pickFont() {
+    for (const p of SYSTEM_FONT_GUESSES) {
+        try {
+            if (existsSync(p))
+                return p;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return undefined;
+}
+function escapeFilterPath(p) {
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:").replace(/'/g, "\\'");
+}
+/**
+ * Escape a string for ffmpeg drawtext's `text='...'` parameter.
+ *
+ * Rules (verified against real-world implementations — GVCLab/CutClaw,
+ * g0ldyy/comet, ehendrix23/tesla_dashcam):
+ *   1. `\\` first  → `\\\\`
+ *   2. `:`         → `\\:`
+ *   3. `'`         → `\\'`
+ *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions like timecode)
+ *   5. newlines    → literal `\\n` (drawtext renders `\\n` as a line break)
+ *
+ * Backslash MUST come first so subsequent escapes don't double-escape it.
+ */
+export function escapeDrawtextValue(text) {
+    return text
+        .replace(/\\/g, "\\\\")
+        .replace(/:/g, "\\:")
+        .replace(/'/g, "\\'")
+        .replace(/%/g, "\\%")
+        .replace(/\r\n?|\n/g, "\\n");
+}
+//# sourceMappingURL=compose-thumbnail.js.map

package/dist/tools/compose-thumbnail.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Build the body for ffmpeg's concat-demuxer list file. Single-quotes the path
+ * and shell-escapes any embedded single quotes (`'` → `'\''`). Match the
+ * convention seen in real-world bash test fixtures (e.g. Xinrea/bili-shadowreplay).
+ */
+export declare function buildConcatListBody(paths: string[]): string;
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ConcatVideosParams: z.ZodObject<{
+    inputs: z.ZodArray<z.ZodString>;
+    output: z.ZodString;
+    lossless: z.ZodOptional<z.ZodBoolean>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createConcatVideosTool(cwd: string): AgentTool<typeof ConcatVideosParams>;
+export {};
+//# sourceMappingURL=concat-videos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concat-videos.d.ts","sourceRoot":"","sources":["../../src/tools/concat-videos.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3D;AACD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,QAAA,MAAM,kBAAkB;;;;;;iBAatB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAuExF"}

package/dist/tools/concat-videos.js

@@ -0,0 +1,79 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Build the body for ffmpeg's concat-demuxer list file. Single-quotes the path
+ * and shell-escapes any embedded single quotes (`'` → `'\''`). Match the
+ * convention seen in real-world bash test fixtures (e.g. Xinrea/bili-shadowreplay).
+ */
+export function buildConcatListBody(paths) {
+    return paths.map((p) => `file '${p.replace(/'/g, "'\\''")}'`).join("\n");
+}
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+const ConcatVideosParams = z.object({
+    inputs: z.array(z.string().min(1)).min(2).describe("Videos to join in order."),
+    output: z.string().describe("Concatenated output path."),
+    lossless: z
+        .boolean()
+        .optional()
+        .describe("If true, use the ffmpeg concat demuxer (no re-encode — fast, lossless). " +
+        "ALL sources must share codec, resolution, fps, sample rate. If you're not certain, " +
+        "leave false (default) — the filter-based concat re-encodes uniformly."),
+    videoCodec: z.string().optional().describe("When re-encoding: video codec. Default libx264."),
+    crf: z.number().int().min(0).max(51).optional().describe("When re-encoding: CRF. Default 20."),
+});
+export function createConcatVideosTool(cwd) {
+    return {
+        name: "concat_videos",
+        description: "Join videos end-to-end. Two modes: lossless (concat demuxer, requires uniform codec/" +
+            "resolution/fps/sample-rate) and re-encode (filter-based, always works). Common uses: " +
+            "intro + main + outro stitching, multi-take assembly, batch concat for upload.",
+        parameters: ConcatVideosParams,
+        async execute({ inputs, output, lossless, videoCodec, crf }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const absInputs = inputs.map((p) => resolvePath(cwd, p));
+                const outAbs = resolvePath(cwd, output);
+                for (const a of absInputs) {
+                    if (a === outAbs)
+                        return err("output path collides with an input", "pick a different output");
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                if (lossless) {
+                    // concat demuxer: build a list file `file 'path'\n` and feed it.
+                    const listPath = join(tmpdir(), `gg-concat-${Date.now()}.txt`);
+                    const body = buildConcatListBody(absInputs);
+                    writeFileSync(listPath, body, "utf8");
+                    const r = await runFfmpeg(["-f", "concat", "-safe", "0", "-i", listPath, "-c", "copy", outAbs], { signal: ctx.signal });
+                    if (r.code !== 0) {
+                        return err(`ffmpeg concat-demuxer exited ${r.code}`, "sources may differ in codec/res/fps; retry with lossless=false");
+                    }
+                    return compact({ ok: true, path: outAbs, mode: "lossless" });
+                }
+                // Filter-based concat (re-encode).
+                const args = [];
+                for (const p of absInputs)
+                    args.push("-i", p);
+                const n = absInputs.length;
+                const filterParts = [];
+                for (let i = 0; i < n; i++)
+                    filterParts.push(`[${i}:v:0][${i}:a:0]`);
+                const filter = `${filterParts.join("")}concat=n=${n}:v=1:a=1[outv][outa]`;
+                args.push("-filter_complex", filter, "-map", "[outv]", "-map", "[outa]", "-c:v", videoCodec ?? "libx264", "-crf", String(crf ?? 20), "-c:a", "aac", "-b:a", "192k", outAbs);
+                const r = await runFfmpeg(args, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg concat exited ${r.code}`);
+                }
+                return compact({ ok: true, path: outAbs, mode: "re-encode" });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=concat-videos.js.map

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

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

package/dist/tools/copy-grade.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CopyGradeParams: z.ZodObject<{
+    sourceClipId: z.ZodString;
+    targetClipIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare function createCopyGradeTool(host: VideoHost): AgentTool<typeof CopyGradeParams>;
+export {};
+//# sourceMappingURL=copy-grade.d.ts.map

package/dist/tools/copy-grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-grade.d.ts","sourceRoot":"","sources":["../../src/tools/copy-grade.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,eAAe;;;iBAMnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAkBtF"}

package/dist/tools/copy-grade.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const CopyGradeParams = z.object({
+    sourceClipId: z.string().min(1).describe("Hero clip whose grade you want to replicate."),
+    targetClipIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe("Clips that should receive the source's grade."),
+});
+export function createCopyGradeTool(host) {
+    return {
+        name: "copy_grade",
+        description: "Copy the current grade from one clip to many (Resolve only). " +
+            "On Resolve, the Color page may need to be open for copy_grade to take effect. " +
+            "Call open_page('color') first if it errors. Use after grading a hero shot to " +
+            "replicate across similar shots.",
+        parameters: CopyGradeParams,
+        async execute({ sourceClipId, targetClipIds }) {
+            try {
+                await host.copyGrade(sourceClipId, targetClipIds);
+                return compact({ sourceClipId, copied: targetClipIds.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=copy-grade.js.map

package/dist/tools/copy-grade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-grade.js","sourceRoot":"","sources":["../../src/tools/copy-grade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACxF,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,+CAA+C,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,+DAA+D;YAC/D,gFAAgF;YAChF,+EAA+E;YAC/E,iCAAiC;QACnC,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;gBAClD,OAAO,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,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/create-timeline.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CreateTimelineParams: z.ZodObject<{
+    name: z.ZodString;
+    fps: z.ZodNumber;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createCreateTimelineTool(host: VideoHost): AgentTool<typeof CreateTimelineParams>;
+export {};
+//# sourceMappingURL=create-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/create-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,oBAAoB;;;;;iBAKxB,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAyBhG"}

package/dist/tools/create-timeline.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const CreateTimelineParams = z.object({
+    name: z.string().min(1),
+    fps: z.number().positive(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+});
+export function createCreateTimelineTool(host) {
+    return {
+        name: "create_timeline",
+        description: "Create a new (empty) timeline / sequence on the host with a given name, fps, and " +
+            "optional resolution. Use before rough-cut workflows or when reformatting for " +
+            "shorts (9:16 / 1:1 / 4:5).\n\n" +
+            "Host caveats:\n" +
+            "  - Resolve: fps applies only if the project has no existing timelines (project fps locks once any timeline exists). width/height applied via custom timeline settings.\n" +
+            "  - Premiere: requires a .sqpreset file we don't currently ship; falls back to CLONING the active sequence and renaming. fps/width/height are IGNORED in the fallback path \u2014 the new sequence inherits the active one's settings. For a different fps/aspect on Premiere, use reformat_timeline + import_edl instead.",
+        parameters: CreateTimelineParams,
+        async execute({ name, fps, width, height }) {
+            try {
+                await host.createTimeline({ name, fps, width, height });
+                // Premiere fallback ignores fps/width/height; tell the agent so it
+                // doesn't assume those took effect.
+                if (host.name === "premiere" && (width || height || fps)) {
+                    return "ok:cloned-active-sequence; fps/width/height ignored on Premiere fallback";
+                }
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-timeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-timeline.js","sourceRoot":"","sources":["../../src/tools/create-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mFAAmF;YACnF,+EAA+E;YAC/E,gCAAgC;YAChC,iBAAiB;YACjB,2KAA2K;YAC3K,4TAA4T;QAC9T,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxD,mEAAmE;gBACnE,oCAAoC;gBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;oBACzD,OAAO,0EAA0E,CAAC;gBACpF,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const CrossfadeVideosParams: z.ZodObject<{
+    inputA: z.ZodString;
+    inputB: z.ZodString;
+    output: z.ZodString;
+    durationSec: z.ZodNumber;
+    transition: z.ZodOptional<z.ZodEnum<{
+        fade: "fade";
+        fadeblack: "fadeblack";
+        fadewhite: "fadewhite";
+        fadegrays: "fadegrays";
+        wipeleft: "wipeleft";
+        wiperight: "wiperight";
+        wipeup: "wipeup";
+        wipedown: "wipedown";
+        slideleft: "slideleft";
+        slideright: "slideright";
+        slideup: "slideup";
+        slidedown: "slidedown";
+        circleopen: "circleopen";
+        circleclose: "circleclose";
+        circlecrop: "circlecrop";
+        rectcrop: "rectcrop";
+        dissolve: "dissolve";
+        pixelize: "pixelize";
+        radial: "radial";
+        distance: "distance";
+        hblur: "hblur";
+        smoothleft: "smoothleft";
+        smoothright: "smoothright";
+        smoothup: "smoothup";
+        smoothdown: "smoothdown";
+        coverleft: "coverleft";
+        coverright: "coverright";
+        coverup: "coverup";
+        coverdown: "coverdown";
+        revealleft: "revealleft";
+        revealright: "revealright";
+        revealup: "revealup";
+        revealdown: "revealdown";
+        squeezeh: "squeezeh";
+        squeezev: "squeezev";
+        zoomin: "zoomin";
+    }>>;
+}, z.core.$strip>;
+export declare function createCrossfadeVideosTool(cwd: string): AgentTool<typeof CrossfadeVideosParams>;
+export {};
+//# sourceMappingURL=crossfade-videos.d.ts.map

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

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

package/dist/tools/crossfade-videos.js

@@ -0,0 +1,121 @@
+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, probeMedia, runFfmpeg } from "../core/media/ffmpeg.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([
+    // Plain fades
+    "fade",
+    "fadeblack",
+    "fadewhite",
+    "fadegrays",
+    // Wipes (full-edge sweeps)
+    "wipeleft",
+    "wiperight",
+    "wipeup",
+    "wipedown",
+    // Slides
+    "slideleft",
+    "slideright",
+    "slideup",
+    "slidedown",
+    // Geometric
+    "circleopen",
+    "circleclose",
+    "circlecrop",
+    "rectcrop",
+    // Stylised
+    "dissolve",
+    "pixelize",
+    "radial",
+    "distance",
+    "hblur",
+    // Soft directional
+    "smoothleft",
+    "smoothright",
+    "smoothup",
+    "smoothdown",
+    // Cover/reveal pairs
+    "coverleft",
+    "coverright",
+    "coverup",
+    "coverdown",
+    "revealleft",
+    "revealright",
+    "revealup",
+    "revealdown",
+    // Squeeze + zoom
+    "squeezeh",
+    "squeezev",
+    "zoomin",
+]);
+const CrossfadeVideosParams = z.object({
+    inputA: z.string().describe("First video (the one that fades OUT)."),
+    inputB: z.string().describe("Second video (the one that fades IN)."),
+    output: z.string().describe("Output path."),
+    durationSec: z.number().positive().describe("Crossfade duration. Typical 0.5–2s."),
+    transition: TransitionSchema.optional().describe("ffmpeg xfade transition. Default 'fade'."),
+});
+export function createCrossfadeVideosTool(cwd) {
+    return {
+        name: "crossfade_videos",
+        description: "Crossfade between two videos using ffmpeg's xfade. 16+ transition styles available; " +
+            "default 'fade' is the safe choice. Re-encodes both inputs into one output. " +
+            "Use sparingly — most pro edits use straight cuts. Crossfades signal 'time has passed'.",
+        parameters: CrossfadeVideosParams,
+        async execute({ inputA, inputB, output, durationSec, transition }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const aAbs = resolvePath(cwd, inputA);
+                const bAbs = resolvePath(cwd, inputB);
+                const outAbs = resolvePath(cwd, output);
+                if (aAbs === outAbs || bAbs === outAbs) {
+                    return err("output collides with an input");
+                }
+                const probeA = probeMedia(aAbs);
+                if (!probeA)
+                    return err(`probe failed for ${aAbs}`);
+                if (durationSec >= probeA.durationSec) {
+                    return err(`durationSec (${durationSec}) >= duration of inputA (${probeA.durationSec.toFixed(2)})`, "crossfade must fit inside the first clip");
+                }
+                const offset = +(probeA.durationSec - durationSec).toFixed(3);
+                const t = transition ?? "fade";
+                const filter = `[0:v][1:v]xfade=transition=${t}:duration=${durationSec}:offset=${offset}[v];` +
+                    `[0:a][1:a]acrossfade=d=${durationSec}[a]`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-i",
+                    aAbs,
+                    "-i",
+                    bAbs,
+                    "-filter_complex",
+                    filter,
+                    "-map",
+                    "[v]",
+                    "-map",
+                    "[a]",
+                    "-c:v",
+                    "libx264",
+                    "-crf",
+                    "20",
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    "192k",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(args, { signal: ctx.signal });
+                if (r.code !== 0)
+                    return err(`ffmpeg exited ${r.code}`);
+                return compact({ ok: true, path: outAbs, transition: t, durationSec });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=crossfade-videos.js.map

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

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

package/dist/tools/cut-at.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CutAtParams: z.ZodObject<{
+    track: z.ZodNumber;
+    frame: z.ZodNumber;
+}, z.core.$strip>;
+export declare function createCutAtTool(host: VideoHost): AgentTool<typeof CutAtParams>;
+export {};
+//# sourceMappingURL=cut-at.d.ts.map

package/dist/tools/cut-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-at.d.ts","sourceRoot":"","sources":["../../src/tools/cut-at.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,WAAW;;;iBAGf,CAAC;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,WAAW,CAAC,CAgB9E"}

package/dist/tools/cut-at.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const CutAtParams = z.object({
+    track: z.number().int().min(1),
+    frame: z.number().int().min(0),
+});
+export function createCutAtTool(host) {
+    return {
+        name: "cut_at",
+        description: "Razor-cut on a track at a frame. Splits one clip into two. " +
+            "If host returns unsupported, use write_edl + import_edl for bulk cuts.",
+        parameters: CutAtParams,
+        async execute({ track, frame }) {
+            try {
+                await host.cutAt(track, frame);
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message, "use write_edl + import_edl");
+            }
+        },
+    };
+}
+//# sourceMappingURL=cut-at.js.map

package/dist/tools/cut-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-at.js","sourceRoot":"","sources":["../../src/tools/cut-at.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,6DAA6D;YAC7D,wEAAwE;QAC1E,UAAU,EAAE,WAAW;QACvB,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}