@kenkaiiii/gg-editor 0.1.0

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

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const CutFillerWordsParams: z.ZodObject<{
+    transcript: z.ZodString;
+    sourceVideo: z.ZodString;
+    fillers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    aggressiveSingleWords: z.ZodOptional<z.ZodBoolean>;
+    paddingStartMs: z.ZodOptional<z.ZodNumber>;
+    paddingEndMs: z.ZodOptional<z.ZodNumber>;
+    mergeGapMs: z.ZodOptional<z.ZodNumber>;
+    edlOutput: z.ZodOptional<z.ZodString>;
+    reel: z.ZodOptional<z.ZodString>;
+    frameRate: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * cut_filler_words — the canonical "podcast / interview / vlog" cleanup
+ * step. Read a word-timestamped transcript, find every filler-word
+ * range, emit an EDL of KEEP ranges, write it, return stats.
+ *
+ * The agent's job is then to surface the stats ("removed 47 fillers,
+ * 8.3s total — top: um (24), uh (15)"), wait for user OK, then call
+ * import_edl(path) to apply the cuts.
+ */
+export declare function createCutFillerWordsTool(cwd: string): AgentTool<typeof CutFillerWordsParams>;
+export {};
+//# sourceMappingURL=cut-filler-words.d.ts.map

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

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

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

@@ -0,0 +1,165 @@
+import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, extname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildEdl } from "../core/edl.js";
+import { DEFAULT_FILLERS, detectFillerRanges, keepRangesFromFillers, keepRangesToFrameRanges, summarizeFillers, } from "../core/filler-words.js";
+import { compact, err } from "../core/format.js";
+import { probeMedia } from "../core/media/ffmpeg.js";
+const CutFillerWordsParams = z.object({
+    transcript: z
+        .string()
+        .describe("Path to a transcript JSON written by `transcribe(wordTimestamps=true)`. Must include " +
+        "word-level timings — without them this tool can't locate the fillers. Returns an error otherwise."),
+    sourceVideo: z
+        .string()
+        .describe("The video the transcript was made from. Used as the source media in the emitted EDL " +
+        "(reel name + frame rate detection)."),
+    fillers: z
+        .array(z.string())
+        .optional()
+        .describe(`Custom filler vocabulary (case-insensitive, supports multi-word phrases). Defaults to ` +
+        `[${DEFAULT_FILLERS.join(", ")}]. Override when the speaker's verbal tics differ — ` +
+        `e.g. ["right?", "obviously"].`),
+    aggressiveSingleWords: z
+        .boolean()
+        .optional()
+        .describe("When false, skip ambiguous single-word fillers (like, so, actually, basically, " +
+        "literally, honestly, right) — useful when the speaker uses them substantively. " +
+        "Default true."),
+    paddingStartMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Lead-in padding so the cut doesn't clip the previous word's tail. Default 20ms."),
+    paddingEndMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Lead-out padding so the cut doesn't clip the next word's head. Default 20ms."),
+    mergeGapMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Adjacent fillers within this gap merge into one cut (avoids 3-frame keep clips). Default 150ms."),
+    edlOutput: z
+        .string()
+        .optional()
+        .describe("Path for the emitted .edl file (relative resolves to cwd). Defaults to a tempfile."),
+    reel: z
+        .string()
+        .optional()
+        .describe("EDL reel name. Default = source video basename without extension (truncated to 8 chars)."),
+    frameRate: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Override frame rate. Auto-detected from probe if omitted; 30 if probe fails."),
+    /**
+     * Returns the EDL path + summary stats but does NOT call import_edl.
+     * The agent typically chains this tool to `import_edl(path)` separately
+     * (so the user can review filler choices first).
+     */
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe("If true (default), return the EDL path + stats without importing. The agent should " +
+        "surface stats to the user before calling import_edl. Pass false to skip the review step."),
+});
+/**
+ * cut_filler_words — the canonical "podcast / interview / vlog" cleanup
+ * step. Read a word-timestamped transcript, find every filler-word
+ * range, emit an EDL of KEEP ranges, write it, return stats.
+ *
+ * The agent's job is then to surface the stats ("removed 47 fillers,
+ * 8.3s total — top: um (24), uh (15)"), wait for user OK, then call
+ * import_edl(path) to apply the cuts.
+ */
+export function createCutFillerWordsTool(cwd) {
+    return {
+        name: "cut_filler_words",
+        description: "Detect and remove filler words ('um', 'uh', 'you know', 'i mean', …) from a " +
+            "word-timestamped transcript. Emits an EDL of KEEP ranges (the parts to keep, with " +
+            "small padding so cuts don't clip syllables). REQUIRES word-level timings — call " +
+            "transcribe(wordTimestamps=true) first. Returns {path, stats, keeps}; agent should " +
+            "show the stats to the user, then import_edl(path) when approved. The single biggest " +
+            "creator-time-saver on long-form talking-head content.",
+        parameters: CutFillerWordsParams,
+        async execute(args) {
+            try {
+                const transcriptAbs = resolvePath(cwd, args.transcript);
+                const sourceAbs = resolvePath(cwd, args.sourceVideo);
+                let raw;
+                try {
+                    raw = readFileSync(transcriptAbs, "utf8");
+                }
+                catch (e) {
+                    return err(`cannot read transcript ${transcriptAbs}: ${e.message}`, "verify the transcript JSON exists");
+                }
+                let transcript;
+                try {
+                    transcript = JSON.parse(raw);
+                }
+                catch (e) {
+                    return err(`transcript is not valid JSON: ${e.message}`, "regenerate via transcribe(wordTimestamps=true)");
+                }
+                const hasWords = transcript.segments.some((s) => Array.isArray(s.words) && s.words.length > 0);
+                if (!hasWords) {
+                    return err("transcript has no word-level timings", "rerun transcribe(wordTimestamps=true) — without word timings we can't locate fillers");
+                }
+                const fillers = detectFillerRanges(transcript, {
+                    fillers: args.fillers,
+                    aggressiveSingleWords: args.aggressiveSingleWords,
+                    paddingStartMs: args.paddingStartMs,
+                    paddingEndMs: args.paddingEndMs,
+                    mergeGapMs: args.mergeGapMs,
+                });
+                const probe = probeMedia(sourceAbs);
+                const totalSec = probe?.durationSec ?? transcript.durationSec;
+                const fps = args.frameRate ?? probe?.frameRate ?? 30;
+                const keeps = keepRangesFromFillers(fillers, totalSec);
+                const frameKeeps = keepRangesToFrameRanges(keeps, fps);
+                if (frameKeeps.length === 0) {
+                    return err("no keep ranges produced — fillers may cover the entire transcript", "broaden vocabulary or check word timings");
+                }
+                const reelName = args.reel ?? basename(sourceAbs, extname(sourceAbs)).replace(/[^A-Za-z0-9_]/g, "_");
+                const edl = buildEdl({
+                    title: `${basename(sourceAbs)} (filler-cut)`,
+                    frameRate: fps,
+                    events: frameKeeps.map((k) => ({
+                        reel: reelName,
+                        track: "B",
+                        sourceInFrame: k.startFrame,
+                        sourceOutFrame: k.endFrame,
+                        clipName: basename(sourceAbs),
+                    })),
+                });
+                const outAbs = args.edlOutput
+                    ? resolvePath(cwd, args.edlOutput)
+                    : join(mkdtempSync(join(tmpdir(), "gg-fillercut-")), "fillers.edl");
+                if (args.edlOutput)
+                    mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, edl, "utf8");
+                const stats = summarizeFillers(fillers);
+                const dryRun = args.dryRun ?? true;
+                return compact({
+                    path: outAbs,
+                    dryRun,
+                    stats,
+                    keeps: keeps.length,
+                    fps,
+                    totalSec,
+                    // Surface a short list so the agent can quote it back to the user.
+                    sample: fillers.slice(0, 10).map((f) => ({
+                        atSec: +f.startSec.toFixed(2),
+                        text: f.text,
+                    })),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=cut-filler-words.js.map

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

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

package/dist/tools/detect-silence.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const DetectSilenceParams: z.ZodObject<{
+    input: z.ZodString;
+    noiseDb: z.ZodOptional<z.ZodNumber>;
+    minDurationSec: z.ZodOptional<z.ZodNumber>;
+    paddingSec: z.ZodOptional<z.ZodNumber>;
+    returnKeeps: z.ZodOptional<z.ZodBoolean>;
+    frameRate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createDetectSilenceTool(cwd: string): AgentTool<typeof DetectSilenceParams>;
+export {};
+//# sourceMappingURL=detect-silence.d.ts.map

package/dist/tools/detect-silence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-silence.d.ts","sourceRoot":"","sources":["../../src/tools/detect-silence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASrD,QAAA,MAAM,mBAAmB;;;;;;;iBA4BvB,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CAmF1F"}

package/dist/tools/detect-silence.js

@@ -0,0 +1,98 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { keepRangesFromSilences, parseSilenceDetect, silencesToFrameRanges, } from "../core/silence.js";
+const DetectSilenceParams = z.object({
+    input: z.string().describe("Media file (video or audio). ffmpeg reads the audio stream."),
+    noiseDb: z
+        .number()
+        .optional()
+        .describe("Threshold in dB below which is silent (default -30, more negative = stricter)."),
+    minDurationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Minimum silence length to report (default 0.5s)."),
+    paddingSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Padding around keep-ranges so cuts don't slice syllables (default 0.1s)."),
+    returnKeeps: z
+        .boolean()
+        .optional()
+        .describe("If true (default), return KEEP ranges (the inverse) plus frame-aligned versions — " +
+        "feed straight into write_edl. If false, return raw silence ranges only."),
+    frameRate: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Used to add frame-aligned ranges. Auto-detected from probe if omitted."),
+});
+export function createDetectSilenceTool(cwd) {
+    return {
+        name: "detect_silence",
+        description: "Find silent regions in an audio/video file via ffmpeg silencedetect. " +
+            "Default returns KEEP ranges (the parts to keep, with optional padding) plus frame-aligned " +
+            "versions ready for write_edl. " +
+            "Workflow: probe_media → detect_silence → write_edl(events=keeps) → import_edl.",
+        parameters: DetectSilenceParams,
+        async execute({ input, noiseDb = -30, minDurationSec = 0.5, paddingSec = 0.1, returnKeeps = true, frameRate, }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            const abs = resolvePath(cwd, input);
+            // Probe for fps + duration. fps is needed for frame alignment; duration
+            // closes any unterminated trailing silence the filter omits.
+            const probe = probeMedia(abs);
+            if (!probe)
+                return err(`probe failed for ${abs}`, "verify file exists and is media");
+            const fps = frameRate ?? probe.frameRate ?? 30;
+            const totalSec = probe.durationSec;
+            // Run silencedetect. "-f null -" discards output; the filter writes to stderr.
+            const r = await runFfmpeg([
+                "-i",
+                abs,
+                "-af",
+                `silencedetect=noise=${noiseDb}dB:d=${minDurationSec}`,
+                "-f",
+                "null",
+                "-",
+            ], { signal: ctx.signal });
+            if (r.code !== 0) {
+                return err(`ffmpeg exited ${r.code}`, "check input file is valid media");
+            }
+            const silences = parseSilenceDetect(r.stderr, totalSec);
+            if (!returnKeeps) {
+                const summary = summarizeList(silences, 30);
+                return compact({
+                    ranges: silences,
+                    totalSec,
+                    fps,
+                    count: summary.total,
+                    omitted: summary.omitted,
+                    ...(summary.omitted > 0 ? { head: summary.head, tail: summary.tail } : {}),
+                });
+            }
+            const keeps = keepRangesFromSilences(silences, totalSec, paddingSec);
+            const keepFrames = silencesToFrameRanges(keeps, fps);
+            // Pair keep seconds with their frame-aligned versions for direct EDL use.
+            const events = keeps.map((k, i) => ({
+                startSec: k.startSec,
+                endSec: k.endSec,
+                startFrame: keepFrames[i]?.startFrame ?? 0,
+                endFrame: keepFrames[i]?.endFrame ?? 0,
+            }));
+            const summary = summarizeList(events, 30);
+            return compact({
+                totalSec,
+                fps,
+                silences: silences.length,
+                keeps: summary.total,
+                omitted: summary.omitted,
+                ...(summary.omitted > 0 ? { head: summary.head, tail: summary.tail } : { events }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=detect-silence.js.map

package/dist/tools/detect-silence.js.map

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

package/dist/tools/detect-speaker-changes.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const DetectSpeakerChangesParams: z.ZodObject<{
+    path: z.ZodString;
+    minGapSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createDetectSpeakerChangesTool(cwd: string): AgentTool<typeof DetectSpeakerChangesParams>;
+export {};
+//# sourceMappingURL=detect-speaker-changes.d.ts.map

package/dist/tools/detect-speaker-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-speaker-changes.d.ts","sourceRoot":"","sources":["../../src/tools/detect-speaker-changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,0BAA0B;;;iBAO9B,CAAC;AAEH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,0BAA0B,CAAC,CA2B9C"}

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

@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+import { detectSpeakerChanges } from "../core/speaker-changes.js";
+const DetectSpeakerChangesParams = z.object({
+    path: z.string().describe("Transcript JSON file (output of `transcribe`)."),
+    minGapSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Minimum silence gap to flag as a candidate speaker change. Default 1.5s."),
+});
+export function createDetectSpeakerChangesTool(cwd) {
+    return {
+        name: "detect_speaker_changes",
+        description: "Heuristic v1: silence-gap candidates for speaker boundaries. Returns inter-segment " +
+            "gaps > minGapSec as CANDIDATES — not assignments. Reasonable for fast-cut interview " +
+            "audio with clear handoffs; UNRELIABLE for natural overlap, rapid back-and-forth, or " +
+            "single-speaker monologues with dramatic pauses. For real diarization, run the audio " +
+            "through whisperx/AssemblyAI first and import that transcript instead — read_transcript " +
+            "supports a `speaker` filter when the JSON includes labels.",
+        parameters: DetectSpeakerChangesParams,
+        async execute({ path, minGapSec }) {
+            try {
+                const abs = resolvePath(cwd, path);
+                const t = JSON.parse(readFileSync(abs, "utf8"));
+                const candidates = detectSpeakerChanges(t, { minGapSec });
+                const s = summarizeList(candidates, 30);
+                return compact({
+                    total: s.total,
+                    minGapSec: minGapSec ?? 1.5,
+                    ...(s.omitted > 0 ? { head: s.head, tail: s.tail, omitted: s.omitted } : { candidates }),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=detect-speaker-changes.js.map

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

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

package/dist/tools/dry-run.d.ts

@@ -0,0 +1,23 @@
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+/**
+ * Wrap a host-mutating tool so that when `dryRun` is true, the tool returns
+ * a "would-have" string instead of executing.
+ *
+ * The agent still sees the call go through with a structured result, so
+ * downstream reasoning ("now I'll add a marker noting the cleanup") still
+ * works — but no host state changes. Rendering is also short-circuited.
+ *
+ * dry-run does NOT skip:
+ *   - file writes the user explicitly invoked (write_edl, write_fcpxml)
+ *   - read-only ops (host_info, get_timeline, probe_media, etc.)
+ *   - analysis (transcribe, detect_silence, cluster_takes, score_shot)
+ *
+ * dry-run DOES skip:
+ *   - cut_at, ripple_delete, add_marker, append_clip
+ *   - import_edl
+ *   - render
+ */
+export declare function wrapDryRun<T extends AgentTool>(tool: T, dryRun: boolean): T;
+/** Names of tools that mutate the host (and are subject to dry-run). */
+export declare const HOST_MUTATING_TOOLS: Set<string>;
+//# sourceMappingURL=dry-run.d.ts.map

package/dist/tools/dry-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/tools/dry-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAqB3E;AAED,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,aAqB9B,CAAC"}

package/dist/tools/dry-run.js

@@ -0,0 +1,66 @@
+import { compact } from "../core/format.js";
+/**
+ * Wrap a host-mutating tool so that when `dryRun` is true, the tool returns
+ * a "would-have" string instead of executing.
+ *
+ * The agent still sees the call go through with a structured result, so
+ * downstream reasoning ("now I'll add a marker noting the cleanup") still
+ * works — but no host state changes. Rendering is also short-circuited.
+ *
+ * dry-run does NOT skip:
+ *   - file writes the user explicitly invoked (write_edl, write_fcpxml)
+ *   - read-only ops (host_info, get_timeline, probe_media, etc.)
+ *   - analysis (transcribe, detect_silence, cluster_takes, score_shot)
+ *
+ * dry-run DOES skip:
+ *   - cut_at, ripple_delete, add_marker, append_clip
+ *   - import_edl
+ *   - render
+ */
+export function wrapDryRun(tool, dryRun) {
+    if (!dryRun)
+        return tool;
+    const original = tool.execute.bind(tool);
+    const wrapped = {
+        ...tool,
+        execute: async (args, ctx) => {
+            // For tools that have validation logic (e.g. ripple_delete checks
+            // endFrame > startFrame), we still want validation errors to surface.
+            // Easiest path: execute the tool but if it succeeds, override the
+            // result with a dry-run notice. Trade-off: we still call the host.
+            // Better: short-circuit immediately and just describe.
+            void ctx;
+            return compact({
+                dryRun: true,
+                skipped: tool.name,
+                wouldHaveCalled: tool.name,
+                args,
+            });
+        },
+    };
+    return wrapped;
+}
+/** Names of tools that mutate the host (and are subject to dry-run). */
+export const HOST_MUTATING_TOOLS = new Set([
+    "cut_at",
+    "ripple_delete",
+    "add_marker",
+    "append_clip",
+    "import_edl",
+    "render",
+    "create_timeline",
+    "import_to_media_pool",
+    "open_page",
+    "set_clip_speed",
+    "import_subtitles",
+    "apply_lut",
+    "set_primary_correction",
+    "copy_grade",
+    "replace_clip",
+    "insert_broll",
+    "smart_reframe",
+    "clone_timeline",
+    "add_track",
+    "set_clip_volume",
+]);
+//# sourceMappingURL=dry-run.js.map

package/dist/tools/dry-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../src/tools/dry-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAsB,IAAO,EAAE,MAAe;IACtE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG;QACd,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EAAE,IAAoC,EAAE,GAAmC,EAAE,EAAE;YAC3F,kEAAkE;YAClE,sEAAsE;YACtE,kEAAkE;YAClE,mEAAmE;YACnE,uDAAuD;YACvD,KAAK,GAAG,CAAC;YACT,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,eAAe,EAAE,IAAI,CAAC,IAAI;gBAC1B,IAAI;aACL,CAAC,CAAC;QACL,CAAC;KACG,CAAC;IACP,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACzC,QAAQ;IACR,eAAe;IACf,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,iBAAiB;IACjB,sBAAsB;IACtB,WAAW;IACX,gBAAgB;IAChB,kBAAkB;IAClB,WAAW;IACX,wBAAwB;IACxB,YAAY;IACZ,cAAc;IACd,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,iBAAiB;CAClB,CAAC,CAAC"}

package/dist/tools/dry-run.test.d.ts

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

package/dist/tools/dry-run.test.d.ts.map

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

package/dist/tools/dry-run.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { HOST_MUTATING_TOOLS, wrapDryRun } from "./dry-run.js";
+const stubTool = {
+    name: "stub",
+    description: "stub",
+    parameters: z.object({ x: z.number() }),
+    async execute(args) {
+        return `executed with x=${args.x}`;
+    },
+};
+const ctx = { signal: new AbortController().signal, toolCallId: "t1" };
+describe("HOST_MUTATING_TOOLS", () => {
+    it("includes the canonical mutating ops", () => {
+        for (const name of [
+            "cut_at",
+            "ripple_delete",
+            "add_marker",
+            "append_clip",
+            "import_edl",
+            "render",
+        ]) {
+            expect(HOST_MUTATING_TOOLS.has(name)).toBe(true);
+        }
+    });
+    it("excludes file/analysis tools", () => {
+        for (const name of [
+            "host_info",
+            "get_timeline",
+            "write_edl",
+            "write_fcpxml",
+            "probe_media",
+            "extract_audio",
+            "transcribe",
+            "score_shot",
+            "cluster_takes",
+            "pick_best_takes",
+        ]) {
+            expect(HOST_MUTATING_TOOLS.has(name)).toBe(false);
+        }
+    });
+});
+describe("wrapDryRun", () => {
+    it("returns the tool unchanged when dryRun=false", async () => {
+        const wrapped = wrapDryRun(stubTool, false);
+        expect(wrapped).toBe(stubTool);
+        const r = await wrapped.execute({ x: 7 }, ctx);
+        expect(r).toBe("executed with x=7");
+    });
+    it("short-circuits with dryRun=true and includes args", async () => {
+        const wrapped = wrapDryRun(stubTool, true);
+        const r = await wrapped.execute({ x: 42 }, ctx);
+        expect(typeof r).toBe("string");
+        const parsed = JSON.parse(r);
+        expect(parsed.dryRun).toBe(true);
+        expect(parsed.skipped).toBe("stub");
+        expect(parsed.wouldHaveCalled).toBe("stub");
+        expect(parsed.args).toEqual({ x: 42 });
+    });
+    it("preserves tool name + parameters when wrapped", () => {
+        const wrapped = wrapDryRun(stubTool, true);
+        expect(wrapped.name).toBe("stub");
+        expect(wrapped.parameters).toBe(stubTool.parameters);
+    });
+});
+//# sourceMappingURL=dry-run.test.js.map

package/dist/tools/dry-run.test.js.map

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

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const DuckAudioParams: z.ZodObject<{
+    voice: z.ZodString;
+    background: z.ZodString;
+    output: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    ratio: z.ZodOptional<z.ZodNumber>;
+    attackMs: z.ZodOptional<z.ZodNumber>;
+    releaseMs: z.ZodOptional<z.ZodNumber>;
+    voiceGain: z.ZodOptional<z.ZodNumber>;
+    bgGain: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createDuckAudioTool(cwd: string): AgentTool<typeof DuckAudioParams>;
+export {};
+//# sourceMappingURL=duck-audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duck-audio.d.ts","sourceRoot":"","sources":["../../src/tools/duck-audio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,eAAe;;;;;;;;;;iBA+BnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAkClF"}