@kenkaiiii/gg-editor 0.1.0

package/dist/tools/transcribe.js

@@ -0,0 +1,116 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { detectApiKey, detectLocalWhisper, transcribe } from "../core/whisper.js";
+const TranscribeParams = z.object({
+    input: z.string().describe("Audio/video file path (.wav recommended; ≤25MB for API backend)."),
+    output: z
+        .string()
+        .describe("Where to save the full transcript JSON. Used by read_transcript later."),
+    backend: z.enum(["local", "api", "whisperx", "auto"]).optional(),
+    modelPath: z
+        .string()
+        .optional()
+        .describe("Path to whisper.cpp ggml model. Required for local backend."),
+    apiModel: z
+        .enum(["whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe", "gpt-4o-transcribe-diarize"])
+        .optional()
+        .describe("OpenAI transcription model. Default 'whisper-1' — the only one with word/segment " +
+        "timestamps (needed for burn_subtitles). 'gpt-4o-transcribe' has higher accuracy but " +
+        "text-only (no segments). 'gpt-4o-transcribe-diarize' returns speaker-labelled " +
+        "segments without needing whisperx/HF_TOKEN — prefer this for speaker analysis."),
+    language: z.string().optional().describe("ISO-639-1 code (e.g. 'en'). Auto-detected if omitted."),
+    wordTimestamps: z
+        .boolean()
+        .optional()
+        .describe("Request per-word timestamps (needed for word-by-word burned captions). " +
+        "Local whisper.cpp uses -ml=1 mode; OpenAI uses timestamp_granularities=word. " +
+        "Only effective with whisper-1 backend (gpt-4o-* don't support word-level timing)."),
+    diarize: z
+        .boolean()
+        .optional()
+        .describe("Local diarization via whisperx + pyannote. Requires `whisperx` on PATH and " +
+        "HF_TOKEN env (free Hugging Face account). For server-side diarization with no " +
+        "local install, set apiModel='gpt-4o-transcribe-diarize' instead. " +
+        "Use this BEFORE detect_speaker_changes — if diarization succeeds you don't need the heuristic."),
+    whisperxModel: z
+        .string()
+        .optional()
+        .describe("whisperx model size (tiny/base/small/medium/large-v3). Default 'base'."),
+    chunkingStrategy: z
+        .enum(["auto"])
+        .optional()
+        .describe("Server-side chunking for the gpt-4o-transcribe family. 'auto' lets OpenAI " +
+        "normalize loudness, run VAD, and process clips up to ~25 min within the 25MB cap. " +
+        "Auto-enabled for gpt-4o-transcribe-diarize on inputs >30s."),
+});
+export function createTranscribeTool(cwd) {
+    return {
+        name: "transcribe",
+        description: "Transcribe audio/video to text with timestamps. Writes full transcript JSON to `output`; " +
+            "returns compact summary (lang, segment count, duration) plus head/tail samples. " +
+            "Use read_transcript to query the file by time/text. " +
+            "Backends: 'local' (whisper.cpp), 'api' (OpenAI — see apiModel for model choice), " +
+            "or 'whisperx' (local diarization). For speaker labels without a local install, " +
+            "use backend='api' + apiModel='gpt-4o-transcribe-diarize'.",
+        parameters: TranscribeParams,
+        async execute(args, ctx) {
+            const { input, output, backend, modelPath, language } = args;
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = resolvePath(cwd, output);
+                const want = backend === "auto" ? undefined : backend;
+                const local = detectLocalWhisper();
+                const haveApiKey = !!detectApiKey();
+                if (!want && !local && !haveApiKey) {
+                    return err("no transcription backend available", "install whisper.cpp + pass modelPath, or set OPENAI_API_KEY");
+                }
+                const t = await transcribe(inAbs, {
+                    backend: want,
+                    modelPath,
+                    apiModel: args.apiModel,
+                    language,
+                    wordTimestamps: args.wordTimestamps,
+                    diarize: args.diarize,
+                    whisperxModel: args.whisperxModel,
+                    chunkingStrategy: args.chunkingStrategy,
+                    signal: ctx.signal,
+                });
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, JSON.stringify(t), "utf8");
+                // LLM-shaped summary. Don't dump 500 segments inline — agent uses
+                // read_transcript to query the saved file.
+                const head = t.segments.slice(0, 3).map((s) => ({
+                    start: +s.start.toFixed(2),
+                    end: +s.end.toFixed(2),
+                    text: s.text,
+                }));
+                const tail = t.segments.length > 6
+                    ? t.segments.slice(-3).map((s) => ({
+                        start: +s.start.toFixed(2),
+                        end: +s.end.toFixed(2),
+                        text: s.text,
+                    }))
+                    : [];
+                const wordsTotal = t.segments.reduce((acc, s) => acc + (s.words?.length ?? 0), 0);
+                const speakers = new Set(t.segments.map((s) => s.speaker).filter((x) => !!x));
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    lang: t.language,
+                    dur: +t.durationSec.toFixed(2),
+                    segments: t.segments.length,
+                    ...(args.wordTimestamps ? { words: wordsTotal } : {}),
+                    ...(speakers.size > 0 ? { speakers: [...speakers].sort() } : {}),
+                    head,
+                    ...(tail.length > 0 ? { tail } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/tools/transcribe.js.map

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

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const TransitionVideosParams: z.ZodObject<{
+    inputA: z.ZodString;
+    inputB: z.ZodString;
+    output: z.ZodString;
+    preset: z.ZodEnum<{
+        dissolve: "dissolve";
+        pixelize: "pixelize";
+        radial: "radial";
+        crossfade: "crossfade";
+        "dip-to-black": "dip-to-black";
+        "dip-to-white": "dip-to-white";
+        "smash-cut": "smash-cut";
+        "whip-left": "whip-left";
+        "whip-right": "whip-right";
+        "slide-left": "slide-left";
+        "slide-right": "slide-right";
+        "wipe-left": "wipe-left";
+        "wipe-right": "wipe-right";
+        "circle-open": "circle-open";
+        "circle-close": "circle-close";
+        "zoom-in": "zoom-in";
+    }>;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createTransitionVideosTool(cwd: string): AgentTool<typeof TransitionVideosParams>;
+export {};
+//# sourceMappingURL=transition-videos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transition-videos.d.ts","sourceRoot":"","sources":["../../src/tools/transition-videos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4DrD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;iBAiB1B,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CA6DhG"}

package/dist/tools/transition-videos.js

@@ -0,0 +1,129 @@
+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";
+/**
+ * Transition presets that wrap ffmpeg's `xfade` filter with content-creator
+ * friendly names + sensible default durations. Two new presets vs the
+ * underlying xfade list:
+ *   - smash-cut : 1-frame xfade (≈ a hard cut with imperceptible blend)
+ *   - whip-left/right : very-fast wipe simulating a whip-pan transition
+ *
+ * The remaining presets are 1:1 aliases of xfade names that creators tend
+ * to call by friendlier labels (dip-to-black, dip-to-white).
+ */
+const PresetSchema = z.enum([
+    "crossfade",
+    "dip-to-black",
+    "dip-to-white",
+    "smash-cut",
+    "whip-left",
+    "whip-right",
+    "slide-left",
+    "slide-right",
+    "wipe-left",
+    "wipe-right",
+    "circle-open",
+    "circle-close",
+    "zoom-in",
+    "dissolve",
+    "pixelize",
+    "radial",
+]);
+const PRESETS = {
+    crossfade: { xfade: "fade", defaultDurationSec: 0.5 },
+    "dip-to-black": { xfade: "fadeblack", defaultDurationSec: 0.5 },
+    "dip-to-white": { xfade: "fadewhite", defaultDurationSec: 0.5 },
+    // 1-frame xfade is the cleanest way to do a smash cut while still letting
+    // the audio acrossfade ride underneath.
+    "smash-cut": { xfade: "fade", defaultDurationSec: 0.04 },
+    "whip-left": { xfade: "wipeleft", defaultDurationSec: 0.15 },
+    "whip-right": { xfade: "wiperight", defaultDurationSec: 0.15 },
+    "slide-left": { xfade: "slideleft", defaultDurationSec: 0.5 },
+    "slide-right": { xfade: "slideright", defaultDurationSec: 0.5 },
+    "wipe-left": { xfade: "wipeleft", defaultDurationSec: 0.4 },
+    "wipe-right": { xfade: "wiperight", defaultDurationSec: 0.4 },
+    "circle-open": { xfade: "circleopen", defaultDurationSec: 0.6 },
+    "circle-close": { xfade: "circleclose", defaultDurationSec: 0.6 },
+    "zoom-in": { xfade: "zoomin", defaultDurationSec: 0.5 },
+    dissolve: { xfade: "dissolve", defaultDurationSec: 0.5 },
+    pixelize: { xfade: "pixelize", defaultDurationSec: 0.4 },
+    radial: { xfade: "radial", defaultDurationSec: 0.5 },
+};
+const TransitionVideosParams = z.object({
+    inputA: z.string(),
+    inputB: z.string(),
+    output: z.string(),
+    preset: PresetSchema.describe("Transition style. crossfade/dip-to-black/dip-to-white = soft cuts. " +
+        "whip-left/right = fast wipe (energetic). smash-cut = 1-frame blend " +
+        "for jump-cuts. zoom-in / circle-open = stylised reveal."),
+    durationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Override duration. Defaults: 0.5s for crossfade, 0.04s for smash-cut, " +
+        "0.15s for whip presets."),
+});
+export function createTransitionVideosTool(cwd) {
+    return {
+        name: "transition_videos",
+        description: "Transition between two videos using a named preset (smash-cut, whip-left/right, " +
+            "dip-to-black/white, crossfade, …). Wraps ffmpeg xfade with creator-friendly " +
+            "presets + sensible default durations. For raw xfade names use crossfade_videos.",
+        parameters: TransitionVideosParams,
+        async execute({ inputA, inputB, output, preset, durationSec }, 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}`);
+                const spec = PRESETS[preset];
+                const dur = durationSec ?? spec.defaultDurationSec;
+                if (dur >= probeA.durationSec) {
+                    return err(`durationSec (${dur}) >= duration of inputA (${probeA.durationSec.toFixed(2)})`, "transition must fit inside the first clip");
+                }
+                const offset = +(probeA.durationSec - dur).toFixed(3);
+                const filter = `[0:v][1:v]xfade=transition=${spec.xfade}:duration=${dur}:offset=${offset}[v];` +
+                    `[0:a][1:a]acrossfade=d=${dur}[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, preset, durationSec: dur });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transition-videos.js.map

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

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

package/dist/tools/write-ass.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteAssParams: z.ZodObject<{
+    output: z.ZodString;
+    cues: z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+        style: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fontName: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        primaryColor: z.ZodOptional<z.ZodString>;
+        outlineColor: z.ZodOptional<z.ZodString>;
+        shadowColor: z.ZodOptional<z.ZodString>;
+        bold: z.ZodOptional<z.ZodBoolean>;
+        italic: z.ZodOptional<z.ZodBoolean>;
+        underline: z.ZodOptional<z.ZodBoolean>;
+        alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>]>>;
+        outline: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodNumber>;
+        marginV: z.ZodOptional<z.ZodNumber>;
+        marginL: z.ZodOptional<z.ZodNumber>;
+        marginR: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    playResX: z.ZodOptional<z.ZodNumber>;
+    playResY: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createWriteAssTool(cwd: string): AgentTool<typeof WriteAssParams>;
+export {};
+//# sourceMappingURL=write-ass.d.ts.map

package/dist/tools/write-ass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-ass.d.ts","sourceRoot":"","sources":["../../src/tools/write-ass.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA0CrD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAalB,CAAC;AAeH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAkChF"}

package/dist/tools/write-ass.js

@@ -0,0 +1,101 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildAss } from "../core/ass.js";
+const StyleSchema = z.object({
+    name: z.string().min(1),
+    fontName: z.string().optional(),
+    fontSize: z.number().int().positive().optional(),
+    primaryColor: z.string().optional().describe("Hex RRGGBB or RRGGBBAA (CSS-style alpha)."),
+    outlineColor: z.string().optional(),
+    shadowColor: z.string().optional(),
+    bold: z.boolean().optional(),
+    italic: z.boolean().optional(),
+    underline: z.boolean().optional(),
+    alignment: z
+        .union([
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(4),
+        z.literal(5),
+        z.literal(6),
+        z.literal(7),
+        z.literal(8),
+        z.literal(9),
+    ])
+        .optional()
+        .describe("Numpad-layout alignment. 2=bottom-center, 5=center, 8=top-center."),
+    outline: z.number().min(0).optional(),
+    shadow: z.number().min(0).optional(),
+    marginV: z.number().int().min(0).optional(),
+    marginL: z.number().int().min(0).optional(),
+    marginR: z.number().int().min(0).optional(),
+});
+const CueSchema = z.object({
+    start: z.number().min(0),
+    end: z.number().positive(),
+    text: z.string(),
+    style: z.string().optional(),
+});
+const WriteAssParams = z.object({
+    output: z.string().describe("Output .ass file path (relative resolves to cwd)."),
+    cues: z.array(CueSchema).min(1),
+    styles: z
+        .array(StyleSchema)
+        .optional()
+        .describe("Subtitle styles. Must include one named 'Default' (auto-injected when omitted). " +
+        "Add per-cue style overrides via cue.style."),
+    playResX: z.number().int().positive().optional(),
+    playResY: z.number().int().positive().optional(),
+    title: z.string().optional(),
+});
+const VERTICAL_DEFAULT_STYLE = {
+    name: "Default",
+    fontName: "Arial",
+    fontSize: 72,
+    primaryColor: "FFFFFF",
+    outlineColor: "000000",
+    bold: true,
+    alignment: 2, // bottom-center
+    outline: 4,
+    shadow: 1,
+    marginV: 220, // sits about a third up from the bottom on a 1920-tall canvas
+};
+export function createWriteAssTool(cwd) {
+    return {
+        name: "write_ass",
+        description: "Write an Advanced SubStation Alpha (.ass) subtitle file — supports font, color, " +
+            "position, bold/italic, outline, and per-cue style overrides. Use this for " +
+            "BURNED-IN vertical captions (TikTok / Reels / Shorts). ffmpeg can hardcode them: " +
+            "`ffmpeg -i in.mp4 -vf subtitles=cap.ass -c:a copy out.mp4`. Pair with transcribe " +
+            "(wordTimestamps=true) + read_transcript (includeWords=true) for word-by-word " +
+            "highlight captions. For sentence-level sidecar SRTs, use write_srt instead.",
+        parameters: WriteAssParams,
+        async execute({ output, cues, styles, playResX, playResY, title }) {
+            try {
+                const styleList = styles ?? [VERTICAL_DEFAULT_STYLE];
+                if (!styleList.find((s) => s.name === "Default")) {
+                    // The agent passed styles but forgot Default; inject the vertical preset.
+                    styleList.push(VERTICAL_DEFAULT_STYLE);
+                }
+                const ass = buildAss({
+                    title,
+                    playResX,
+                    playResY,
+                    styles: styleList,
+                    cues,
+                });
+                const abs = resolvePath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, ass, "utf8");
+                return compact({ ok: true, path: abs, cues: cues.length, styles: styleList.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-ass.js.map

package/dist/tools/write-ass.js.map

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

package/dist/tools/write-edl.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteEdlParams: z.ZodObject<{
+    output: z.ZodString;
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        track: z.ZodDefault<z.ZodEnum<{
+            V: "V";
+            A: "A";
+            B: "B";
+            A1: "A1";
+            A2: "A2";
+        }>>;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    dropFrame: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createWriteEdlTool(cwd: string): AgentTool<typeof WriteEdlParams>;
+export {};
+//# sourceMappingURL=write-edl.d.ts.map

package/dist/tools/write-edl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-edl.d.ts","sourceRoot":"","sources":["../../src/tools/write-edl.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAiBrD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;iBAYlB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAgChF"}

package/dist/tools/write-edl.js

@@ -0,0 +1,59 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildEdl, totalRecordFrames } from "../core/edl.js";
+import { compact, err } from "../core/format.js";
+const EventSchema = z.object({
+    reel: z
+        .string()
+        .describe("Source clip identifier (≤8 chars best). NLEs match this to a media pool item."),
+    track: z.enum(["V", "A", "B", "A1", "A2"]).default("V"),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    clipName: z
+        .string()
+        .optional()
+        .describe("Optional human label for the * FROM CLIP NAME comment."),
+});
+const WriteEdlParams = z.object({
+    output: z.string().describe("Output .edl path (relative paths resolve to cwd)."),
+    title: z.string(),
+    frameRate: z.number().positive(),
+    events: z
+        .array(EventSchema)
+        .min(1)
+        .describe("Ordered list of kept segments. They are laid out contiguously on the record timeline " +
+        "in the order given (event N starts where N-1 ends)."),
+    dropFrame: z.boolean().optional(),
+});
+export function createWriteEdlTool(cwd) {
+    return {
+        name: "write_edl",
+        description: "Write a CMX 3600 EDL file from a decision list. Events are placed contiguously " +
+            "on the record timeline in the order given. Use this to BUILD a rebuilt timeline " +
+            "(silence cut, take selection, reordering) then call import_edl to load it into " +
+            "the host. This is the canonical workaround for Resolve's missing razor.\n\n" +
+            "Output is one-line confirmation only (LLM-optimized).",
+        parameters: WriteEdlParams,
+        async execute({ output, title, frameRate, events, dropFrame }) {
+            try {
+                const text = buildEdl({ title, frameRate, events, dropFrame });
+                const abs = resolvePath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                const totalFrames = totalRecordFrames(events);
+                return compact({
+                    ok: true,
+                    path: abs,
+                    events: events.length,
+                    recordFrames: totalFrames,
+                    recordSec: +(totalFrames / frameRate).toFixed(2),
+                });
+            }
+            catch (e) {
+                return err(e.message, "verify event sourceOutFrame > sourceInFrame and frameRate > 0");
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-edl.js.map

package/dist/tools/write-edl.js.map

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

package/dist/tools/write-fcpxml.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteFcpxmlParams: z.ZodObject<{
+    output: z.ZodString;
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    events: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        sourcePath: z.ZodString;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+        sourceDurationFrames: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createWriteFcpxmlTool(cwd: string): AgentTool<typeof WriteFcpxmlParams>;
+export {};
+//# sourceMappingURL=write-fcpxml.d.ts.map

package/dist/tools/write-fcpxml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-fcpxml.d.ts","sourceRoot":"","sources":["../../src/tools/write-fcpxml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAarD,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;iBAOrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAgCtF"}

package/dist/tools/write-fcpxml.js

@@ -0,0 +1,52 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildFcpxml, totalRecordFramesFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+const EventSchema = z.object({
+    reel: z.string().describe("Source identifier — same reel = same asset in the FCPXML."),
+    sourcePath: z.string().describe("Absolute path to the source media file."),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    clipName: z.string().optional(),
+    sourceDurationFrames: z.number().int().positive().optional(),
+});
+const WriteFcpxmlParams = z.object({
+    output: z.string().describe("Output .fcpxml path (relative resolves to cwd)."),
+    title: z.string(),
+    frameRate: z.number().positive(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+    events: z.array(EventSchema).min(1),
+});
+export function createWriteFcpxmlTool(cwd) {
+    return {
+        name: "write_fcpxml",
+        description: "Write an FCPXML 1.10 timeline file from a decision list. Preferred over EDL for " +
+            "Premiere imports (preserves clip names, frame-rational time, multi-source assets). " +
+            "Both Premiere and Resolve import FCPXML cleanly. Use this for high-fidelity " +
+            "interchange — write_edl is the lowest-common-denominator alternative.",
+        parameters: WriteFcpxmlParams,
+        async execute({ output, title, frameRate, width, height, events }) {
+            try {
+                const text = buildFcpxml({ title, frameRate, width, height, events });
+                const abs = resolvePath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                const totalFrames = totalRecordFramesFcpxml(events);
+                return compact({
+                    ok: true,
+                    path: abs,
+                    events: events.length,
+                    assets: new Set(events.map((e) => e.reel)).size,
+                    recordFrames: totalFrames,
+                    recordSec: +(totalFrames / frameRate).toFixed(2),
+                });
+            }
+            catch (e) {
+                return err(e.message, "verify event sourceOutFrame > sourceInFrame, frameRate > 0, events non-empty");
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-fcpxml.js.map

package/dist/tools/write-fcpxml.js.map

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