@kenkaiiii/gg-editor 0.1.0

package/dist/tools/add-fades.js

@@ -0,0 +1,88 @@
+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";
+const AddFadesParams = z.object({
+    input: z.string().describe("Source video file."),
+    output: z.string().describe("Output path."),
+    fadeInSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Video + audio fade-in duration. 0 disables. Default 0."),
+    fadeOutSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Video + audio fade-out duration. 0 disables. Default 0."),
+    videoCodec: z.string().optional().describe("Default libx264."),
+    crf: z.number().int().min(0).max(51).optional().describe("Default 20."),
+});
+export function createAddFadesTool(cwd) {
+    return {
+        name: "add_fades",
+        description: "Add fade-in / fade-out to both video and audio. Standard polish on outputs that don't " +
+            "live inside a longer timeline. Defaults to 0/0 (no-op) unless you specify durations. " +
+            "Re-encodes (fades can't be applied losslessly).",
+        parameters: AddFadesParams,
+        async execute({ input, output, fadeInSec = 0, fadeOutSec = 0, videoCodec, crf }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (fadeInSec === 0 && fadeOutSec === 0) {
+                return err("both fadeInSec and fadeOutSec are 0", "specify at least one duration > 0");
+            }
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = resolvePath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "pick a different output");
+                }
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`);
+                const dur = probe.durationSec;
+                if (fadeOutSec > 0 && fadeOutSec >= dur) {
+                    return err(`fadeOutSec (${fadeOutSec}) >= duration (${dur.toFixed(2)})`, "fade-out must fit inside the clip");
+                }
+                const vfilters = [];
+                const afilters = [];
+                if (fadeInSec > 0) {
+                    vfilters.push(`fade=in:st=0:d=${fadeInSec}`);
+                    afilters.push(`afade=in:st=0:d=${fadeInSec}`);
+                }
+                if (fadeOutSec > 0) {
+                    const start = +(dur - fadeOutSec).toFixed(3);
+                    vfilters.push(`fade=out:st=${start}:d=${fadeOutSec}`);
+                    afilters.push(`afade=out:st=${start}:d=${fadeOutSec}`);
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-i",
+                    inAbs,
+                    "-vf",
+                    vfilters.join(","),
+                    "-af",
+                    afilters.join(","),
+                    "-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 exited ${r.code}`);
+                return compact({ ok: true, path: outAbs, fadeInSec, fadeOutSec });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=add-fades.js.map

package/dist/tools/add-fades.js.map

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

package/dist/tools/add-marker.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const AddMarkerParams: z.ZodObject<{
+    frame: z.ZodNumber;
+    note: z.ZodString;
+    color: z.ZodOptional<z.ZodEnum<{
+        green: "green";
+        red: "red";
+        purple: "purple";
+        orange: "orange";
+        yellow: "yellow";
+        white: "white";
+        blue: "blue";
+        cyan: "cyan";
+        pink: "pink";
+        fuchsia: "fuchsia";
+        rose: "rose";
+        lavender: "lavender";
+        sky: "sky";
+        mint: "mint";
+        lemon: "lemon";
+        sand: "sand";
+        cocoa: "cocoa";
+        cream: "cream";
+    }>>;
+    durationFrames: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createAddMarkerTool(host: VideoHost): AgentTool<typeof AddMarkerParams>;
+export {};
+//# sourceMappingURL=add-marker.d.ts.map

package/dist/tools/add-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-marker.d.ts","sourceRoot":"","sources":["../../src/tools/add-marker.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;AAMxD,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBAiCnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAgBtF"}

package/dist/tools/add-marker.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+// Color set verified against Resolve's marker palette (samuelgursky/
+// davinci-resolve-mcp). The first 8 are also accepted by Premiere (mapped to
+// numeric colorIndex 0–7). The remaining 10 are Resolve-only — Premiere will
+// snap them to the closest of its 8 indices via the bridge color map.
+const AddMarkerParams = z.object({
+    frame: z.number().int().min(0),
+    note: z.string().describe("Reasoning/label for the marker."),
+    color: z
+        .enum([
+        // Universal (work in both Resolve + Premiere)
+        "blue",
+        "red",
+        "green",
+        "yellow",
+        "cyan",
+        "purple",
+        "orange",
+        "white",
+        // Resolve-only — Premiere snaps to the closest of its 8 indices
+        "pink",
+        "fuchsia",
+        "rose",
+        "lavender",
+        "sky",
+        "mint",
+        "lemon",
+        "sand",
+        "cocoa",
+        "cream",
+    ])
+        .optional()
+        .describe("Marker color. blue/red/green/yellow/cyan/purple/orange/white work in both NLEs. " +
+        "pink/fuchsia/rose/lavender/sky/mint/lemon/sand/cocoa/cream are Resolve-only and snap " +
+        "to the closest 8-color value on Premiere."),
+    durationFrames: z.number().int().min(0).optional(),
+});
+export function createAddMarkerTool(host) {
+    return {
+        name: "add_marker",
+        description: "Drop a marker on the timeline with a note. Audit trail — every editorial decision " +
+            "(kept/cut/skipped) gets one. The human reviews them after.",
+        parameters: AddMarkerParams,
+        async execute({ frame, note, color, durationFrames }) {
+            try {
+                await host.addMarker({ frame, note, color, durationFrames });
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=add-marker.js.map

package/dist/tools/add-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-marker.js","sourceRoot":"","sources":["../../src/tools/add-marker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,qEAAqE;AACrE,6EAA6E;AAC7E,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5D,KAAK,EAAE,CAAC;SACL,IAAI,CAAC;QACJ,8CAA8C;QAC9C,MAAM;QACN,KAAK;QACL,OAAO;QACP,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,gEAAgE;QAChE,MAAM;QACN,SAAS;QACT,MAAM;QACN,UAAU;QACV,KAAK;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF;QAChF,uFAAuF;QACvF,2CAA2C,CAC9C;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,oFAAoF;YACpF,4DAA4D;QAC9D,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE;YAClD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC7D,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/add-sfx-at-cuts.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const AddSfxAtCutsParams: z.ZodObject<{
+    input: z.ZodString;
+    sfx: z.ZodString;
+    output: z.ZodString;
+    cutPoints: z.ZodArray<z.ZodNumber>;
+    sfxGainDb: z.ZodOptional<z.ZodNumber>;
+    duckDb: z.ZodOptional<z.ZodNumber>;
+    minSpacingSec: z.ZodOptional<z.ZodNumber>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * add_sfx_at_cuts — drop a whoosh / pop / swoosh on every cut point
+ * and mix it into the existing audio. The standard sound-design polish
+ * on every retention-tuned vlog. One ffmpeg pass; video is copied
+ * through untouched by default.
+ *
+ * Pair with `cut_filler_words` or `detect_silence` to feed cut points
+ * automatically.
+ */
+export declare function createAddSfxAtCutsTool(cwd: string): AgentTool<typeof AddSfxAtCutsParams>;
+export {};
+//# sourceMappingURL=add-sfx-at-cuts.d.ts.map

package/dist/tools/add-sfx-at-cuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-sfx-at-cuts.d.ts","sourceRoot":"","sources":["../../src/tools/add-sfx-at-cuts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,kBAAkB;;;;;;;;;iBA8CtB,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAuExF"}

package/dist/tools/add-sfx-at-cuts.js

@@ -0,0 +1,120 @@
+import { 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";
+import { buildSfxOnCutsFilter } from "../core/sfx-on-cuts.js";
+const AddSfxAtCutsParams = z.object({
+    input: z.string().describe("Source video / audio (relative resolves to cwd)."),
+    sfx: z
+        .string()
+        .describe("SFX file (whoosh, pop, swoosh, riser…). Stereo wav / mp3. 200ms-1s long is typical."),
+    output: z.string().describe("Output file. Re-encoded; uses input video codec passthrough."),
+    cutPoints: z
+        .array(z.number().min(0))
+        .min(1)
+        .describe("Timestamps (seconds) where the SFX should fire. Same list you'd pass to punch_in. " +
+        "Closer-than-minSpacingSec hits are deduped automatically."),
+    sfxGainDb: z
+        .number()
+        .min(-30)
+        .max(6)
+        .optional()
+        .describe("SFX gain offset in dB. Default -8 (subtle, sits below voice). -4 = prominent, " +
+        "-12 = barely-there texture."),
+    duckDb: z
+        .number()
+        .max(0)
+        .optional()
+        .describe("Optional voice ducking depth (dB) under each SFX hit. 0 = off (default), -3 to -6 = " +
+        "polished. Negative values only."),
+    minSpacingSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Minimum spacing between SFX hits. Closer cuts get collapsed (avoids 8 stacked whooshes " +
+        "on machine-gun edits). Default 0.25s."),
+    videoCodec: z
+        .string()
+        .optional()
+        .describe("Default 'copy' — no video re-encode. Set to libx264 if input has no compatible video stream."),
+});
+/**
+ * add_sfx_at_cuts — drop a whoosh / pop / swoosh on every cut point
+ * and mix it into the existing audio. The standard sound-design polish
+ * on every retention-tuned vlog. One ffmpeg pass; video is copied
+ * through untouched by default.
+ *
+ * Pair with `cut_filler_words` or `detect_silence` to feed cut points
+ * automatically.
+ */
+export function createAddSfxAtCutsTool(cwd) {
+    return {
+        name: "add_sfx_at_cuts",
+        description: "Drop a SFX (whoosh / pop / swoosh) at each cut point and mix it onto the existing " +
+            "audio. The standard sound-design polish on every retention-tuned vlog or short. " +
+            "Default gain -8dB sits below the voice; optional -3 to -6dB voice ducking. Video is " +
+            "copied through untouched. File-only — works in every host. Pair with cut_filler_words " +
+            "/ detect_silence for automatic cut-point feeds.",
+        parameters: AddSfxAtCutsParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const sfxAbs = resolvePath(cwd, args.sfx);
+                const outAbs = resolvePath(cwd, args.output);
+                if (inAbs === outAbs) {
+                    return err("output and input are identical", "use a different output path");
+                }
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is media");
+                if (!probe.audioCodec) {
+                    return err("input has no audio stream", "add audio first or use a different input");
+                }
+                const { filterComplex, hits } = buildSfxOnCutsFilter({
+                    cutPoints: args.cutPoints,
+                    totalSec: probe.durationSec,
+                    sfxGainDb: args.sfxGainDb,
+                    duckDb: args.duckDb,
+                    minSpacingSec: args.minSpacingSec,
+                });
+                if (hits === 0) {
+                    return err("no usable cut points after filtering", "all cuts were outside [0, duration) or collapsed by minSpacingSec");
+                }
+                const videoCodec = args.videoCodec ?? "copy";
+                const ffArgs = [
+                    "-i",
+                    inAbs,
+                    "-i",
+                    sfxAbs,
+                    "-filter_complex",
+                    filterComplex,
+                    "-map",
+                    "0:v?",
+                    "-map",
+                    "[mix]",
+                    "-c:v",
+                    videoCodec,
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    "192k",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(ffArgs, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg failed: ${tail(r.stderr)}`);
+                }
+                return compact({ path: outAbs, hits });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=add-sfx-at-cuts.js.map

package/dist/tools/add-sfx-at-cuts.js.map

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

package/dist/tools/add-track.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 AddTrackParams: z.ZodObject<{
+    kind: z.ZodEnum<{
+        video: "video";
+        audio: "audio";
+        subtitle: "subtitle";
+    }>;
+}, z.core.$strip>;
+export declare function createAddTrackTool(host: VideoHost): AgentTool<typeof AddTrackParams>;
+export {};
+//# sourceMappingURL=add-track.d.ts.map

package/dist/tools/add-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-track.d.ts","sourceRoot":"","sources":["../../src/tools/add-track.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,cAAc;;;;;;iBAIlB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAiBpF"}

package/dist/tools/add-track.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const AddTrackParams = z.object({
+    kind: z
+        .enum(["video", "audio", "subtitle"])
+        .describe("Track type to append. video=V2/V3..., audio=A2/A3..., subtitle=ST1..."),
+});
+export function createAddTrackTool(host) {
+    return {
+        name: "add_track",
+        description: "Append an empty track to the active timeline. Useful before insert_broll when V2 " +
+            "doesn't exist yet, or before import_subtitles when no subtitle track exists. " +
+            "Resolve only — Premiere uses File → Sequence → Add Tracks manually.",
+        parameters: AddTrackParams,
+        async execute({ kind }) {
+            try {
+                const r = await host.addTrack(kind);
+                return compact({ ok: true, kind, track: r.track });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=add-track.js.map

package/dist/tools/add-track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-track.js","sourceRoot":"","sources":["../../src/tools/add-track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;SACpC,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,mFAAmF;YACnF,+EAA+E;YAC/E,qEAAqE;QACvE,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACpC,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACrD,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/analyze-hook.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const AnalyzeHookParams: z.ZodObject<{
+    input: z.ZodString;
+    windowSec: z.ZodOptional<z.ZodNumber>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * analyze_hook — does the first 3 seconds earn the scroll-stop?
+ *
+ * Runs four checks and returns a 0-100 score plus a list of issues:
+ *   1. Speech in the first 0.5s   (silencedetect probe)
+ *   2. On-screen text             (vision)
+ *   3. Visual motion              (vision; compares two early frames)
+ *   4. Subject clarity            (vision)
+ *   5. Emotional intensity        (vision)
+ *
+ * The agent's job is to surface the score + findings, then drop a red
+ * marker if the hook fails so the user knows where to recut.
+ */
+export declare function createAnalyzeHookTool(cwd: string): AgentTool<typeof AnalyzeHookParams>;
+export {};
+//# sourceMappingURL=analyze-hook.d.ts.map

package/dist/tools/analyze-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-hook.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-hook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOrD,QAAA,MAAM,iBAAiB;;;;;;;;;iBAkBrB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CA0FtF"}

package/dist/tools/analyze-hook.js

@@ -0,0 +1,126 @@
+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 { buildHookResult, runHookVision, speechAt0_5sScore } from "../core/hook-analysis.js";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { parseSilenceDetect } from "../core/silence.js";
+const AnalyzeHookParams = z.object({
+    input: z.string().describe("Source video (relative resolves to cwd)."),
+    windowSec: z
+        .number()
+        .min(0.5)
+        .max(10)
+        .optional()
+        .describe("Window to analyse from t=0. Default 3s — the algorithmic checkpoint for short-form."),
+    passThreshold: z
+        .number()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Score (0-100) above which the hook is judged to pass. Default 70."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+/**
+ * analyze_hook — does the first 3 seconds earn the scroll-stop?
+ *
+ * Runs four checks and returns a 0-100 score plus a list of issues:
+ *   1. Speech in the first 0.5s   (silencedetect probe)
+ *   2. On-screen text             (vision)
+ *   3. Visual motion              (vision; compares two early frames)
+ *   4. Subject clarity            (vision)
+ *   5. Emotional intensity        (vision)
+ *
+ * The agent's job is to surface the score + findings, then drop a red
+ * marker if the hook fails so the user knows where to recut.
+ */
+export function createAnalyzeHookTool(cwd) {
+    return {
+        name: "analyze_hook",
+        description: "Score the first 3 seconds of a video for retention (TikTok / Reels / Shorts / YouTube). " +
+            "Returns a 0-100 score and a list of findings (silent open, no on-screen text, static " +
+            "framing, no clear subject, weak emotional hook). The first 2-3 seconds are the " +
+            "algorithmic checkpoint — videos with strong 3-second retention get pushed to larger " +
+            "audiences. ALWAYS check this on short-form before render. If `passes=false`, drop a " +
+            "red PAUSE marker and propose a stronger opener.",
+        parameters: AnalyzeHookParams,
+        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 inAbs = resolvePath(cwd, args.input);
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is media");
+                const windowSec = Math.min(args.windowSec ?? 3, probe.durationSec);
+                if (windowSec < 0.5) {
+                    return err("video shorter than 0.5s — nothing to analyse");
+                }
+                // ── Audio: silencedetect over [0, windowSec] ─────────────────
+                // We accept any silence ≥ 0.05s in this short window — even
+                // brief openings of dead air kill retention.
+                const silenceRun = await runFfmpeg([
+                    "-i",
+                    inAbs,
+                    "-t",
+                    String(windowSec),
+                    "-af",
+                    "silencedetect=noise=-30dB:d=0.05",
+                    "-f",
+                    "null",
+                    "-",
+                ], { signal: ctx.signal });
+                if (silenceRun.code !== 0) {
+                    return err(`silencedetect failed: ${tail(silenceRun.stderr)}`);
+                }
+                const silences = parseSilenceDetect(silenceRun.stderr, windowSec);
+                const speech = speechAt0_5sScore(silences, Math.min(0.5, windowSec));
+                // ── Vision: two frames sampled near the start of the window ──
+                // 0.5s and (windowSec - 0.5) so the model sees opening and
+                // ~end-of-window for motion comparison.
+                const earlyT = Math.min(0.5, windowSec * 0.2);
+                const laterT = Math.max(earlyT + 0.3, windowSec - 0.5);
+                const frames = await extractAtTimes(inAbs, [earlyT, laterT], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                if (frames.length < 2) {
+                    return err("could not extract two frames from the opening window");
+                }
+                const vision = await runHookVision(frames[0].path, frames[1].path, {
+                    detail: args.detail,
+                    model: args.model,
+                    signal: ctx.signal,
+                });
+                const result = buildHookResult(speech, vision, {
+                    passThreshold: args.passThreshold,
+                });
+                return compact({
+                    score: result.score,
+                    passes: result.passes,
+                    findings: result.findings,
+                    why: result.why,
+                    breakdown: {
+                        speechAt0_5s: result.speechAt0_5s,
+                        onScreenText: result.onScreenText,
+                        motion: result.motion,
+                        subjectClarity: result.subjectClarity,
+                        emotionalIntensity: result.emotionalIntensity,
+                    },
+                    windowSec,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=analyze-hook.js.map

package/dist/tools/analyze-hook.js.map

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

package/dist/tools/append-clip.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 AppendClipParams: z.ZodObject<{
+    track: z.ZodNumber;
+    mediaPath: z.ZodString;
+}, z.core.$strip>;
+export declare function createAppendClipTool(host: VideoHost, cwd: string): AgentTool<typeof AppendClipParams>;
+export {};
+//# sourceMappingURL=append-clip.d.ts.map

package/dist/tools/append-clip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-clip.d.ts","sourceRoot":"","sources":["../../src/tools/append-clip.ts"],"names":[],"mappings":"AACA,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,gBAAgB;;;iBAGpB,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAkBpC"}

package/dist/tools/append-clip.js

@@ -0,0 +1,27 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const AppendClipParams = z.object({
+    track: z.number().int().min(1),
+    mediaPath: z.string(),
+});
+export function createAppendClipTool(host, cwd) {
+    return {
+        name: "append_clip",
+        description: "Append a media clip to the end of a track. Most reliable timeline op across both " +
+            "Resolve and Premiere — prefer over move/insert.",
+        parameters: AppendClipParams,
+        async execute({ track, mediaPath }) {
+            try {
+                const abs = resolvePath(cwd, mediaPath);
+                const c = await host.appendClip(track, abs);
+                // Echo only state delta; track/path is already in args.
+                return compact({ id: c.id, start: c.startFrame, end: c.endFrame });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=append-clip.js.map

package/dist/tools/append-clip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-clip.js","sourceRoot":"","sources":["../../src/tools/append-clip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,mFAAmF;YACnF,iDAAiD;QACnD,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACxC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC5C,wDAAwD;gBACxD,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrE,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/apply-lut.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ApplyLutParams: z.ZodObject<{
+    clipId: z.ZodString;
+    lutPath: z.ZodString;
+    nodeIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createApplyLutTool(host: VideoHost, cwd: string): AgentTool<typeof ApplyLutParams>;
+export {};
+//# sourceMappingURL=apply-lut.d.ts.map

package/dist/tools/apply-lut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-lut.d.ts","sourceRoot":"","sources":["../../src/tools/apply-lut.ts"],"names":[],"mappings":"AACA,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,cAAc;;;;iBASlB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAkBjG"}