@kenkaiiii/gg-editor 0.1.0

package/dist/tools/index.js

@@ -0,0 +1,242 @@
+import { discoverSkills } from "../core/skills-loader.js";
+import { SKILLS } from "../skills.js";
+import { createAddFadesTool } from "./add-fades.js";
+import { createAddMarkerTool } from "./add-marker.js";
+import { createAddTrackTool } from "./add-track.js";
+import { createApplyLutTool } from "./apply-lut.js";
+import { createAppendClipTool } from "./append-clip.js";
+import { createBurnSubtitlesTool } from "./burn-subtitles.js";
+import { createCleanAudioTool } from "./clean-audio.js";
+import { createCloneTimelineTool } from "./clone-timeline.js";
+import { createClusterTakesTool } from "./cluster-takes.js";
+import { createComposeThumbnailTool } from "./compose-thumbnail.js";
+import { createConcatVideosTool } from "./concat-videos.js";
+import { createColorMatchTool } from "./color-match.js";
+import { createGradeSkinTonesTool } from "./grade-skin-tones.js";
+import { createMatchClipColorTool } from "./match-clip-color.js";
+import { createCutFillerWordsTool } from "./cut-filler-words.js";
+import { createPunchInTool } from "./punch-in.js";
+import { createAnalyzeHookTool } from "./analyze-hook.js";
+import { createWriteKeywordCaptionsTool } from "./write-keyword-captions.js";
+import { createAddSfxAtCutsTool } from "./add-sfx-at-cuts.js";
+import { createComposeLayeredTool } from "./compose-layered.js";
+import { createCopyGradeTool } from "./copy-grade.js";
+import { createDetectSpeakerChangesTool } from "./detect-speaker-changes.js";
+import { createCrossfadeVideosTool } from "./crossfade-videos.js";
+import { createKenBurnsTool } from "./ken-burns.js";
+import { createMixAudioTool } from "./mix-audio.js";
+import { createReorderTimelineTool } from "./reorder-timeline.js";
+import { createSpeedRampTool } from "./speed-ramp.js";
+import { createTransitionVideosTool } from "./transition-videos.js";
+import { createWriteLowerThirdTool } from "./write-lower-third.js";
+import { createWriteTitleCardTool } from "./write-title-card.js";
+import { createDuckAudioTool } from "./duck-audio.js";
+import { createCreateTimelineTool } from "./create-timeline.js";
+import { createCutAtTool } from "./cut-at.js";
+import { createDetectSilenceTool } from "./detect-silence.js";
+import { createExtractAudioTool } from "./extract-audio.js";
+import { createGetMarkersTool } from "./get-markers.js";
+import { createGetTimelineTool } from "./get-timeline.js";
+import { createHostInfoTool } from "./host-info.js";
+import { createImportEdlTool } from "./import-edl.js";
+import { createImportSubtitlesTool } from "./import-subtitles.js";
+import { createImportToMediaPoolTool } from "./import-to-media-pool.js";
+import { createGenerateGifTool } from "./generate-gif.js";
+import { createInsertBrollTool } from "./insert-broll.js";
+import { createListRenderPresetsTool } from "./list-render-presets.js";
+import { createOverlayWatermarkTool } from "./overlay-watermark.js";
+import { createMeasureLoudnessTool } from "./measure-loudness.js";
+import { createMulticamSyncTool } from "./multicam-sync.js";
+import { createNormalizeLoudnessTool } from "./normalize-loudness.js";
+import { createPreRenderCheckTool } from "./pre-render-check.js";
+import { createExtractFrameTool } from "./extract-frame.js";
+import { createSaveProjectTool } from "./save-project.js";
+import { createWriteAssTool } from "./write-ass.js";
+import { createOpenPageTool } from "./open-page.js";
+import { createPickBestTakesTool } from "./pick-best-takes.js";
+import { createProbeMediaTool } from "./probe-media.js";
+import { createReadSkillTool } from "./read-skill.js";
+import { createReadTranscriptTool } from "./read-transcript.js";
+import { createReviewEditTool } from "./review-edit.js";
+import { createReformatTimelineTool } from "./reformat-timeline.js";
+import { createRenderTool } from "./render.js";
+import { createRippleDeleteTool } from "./ripple-delete.js";
+import { createScoreShotTool } from "./score-shot.js";
+import { createReplaceClipTool } from "./replace-clip.js";
+import { createSetClipSpeedTool } from "./set-clip-speed.js";
+import { createSetClipVolumeTool } from "./set-clip-volume.js";
+import { createStabilizeVideoTool } from "./stabilize-video.js";
+import { createSetPrimaryCorrectionTool } from "./set-primary-correction.js";
+import { createSmartReframeTool } from "./smart-reframe.js";
+import { createTranscribeTool } from "./transcribe.js";
+import { createWriteEdlTool } from "./write-edl.js";
+import { createWriteFcpxmlTool } from "./write-fcpxml.js";
+import { createWriteSrtTool } from "./write-srt.js";
+export function createEditorTools(opts) {
+    const { host, cwd, reviewConfig } = opts;
+    const skills = opts.skills ?? discoverSkills({ cwd, bundled: Object.values(SKILLS) });
+    const tools = [
+        // Host introspection — agent should call this first.
+        createHostInfoTool(host),
+        // Timeline-state ops
+        createGetTimelineTool(host),
+        createGetMarkersTool(host),
+        // Mutation ops (per-clip)
+        createCutAtTool(host),
+        createRippleDeleteTool(host),
+        createAddMarkerTool(host),
+        createAppendClipTool(host, cwd),
+        createSetClipSpeedTool(host),
+        createSetClipVolumeTool(host),
+        createReplaceClipTool(host, cwd),
+        createInsertBrollTool(host, cwd),
+        // Project / timeline / media-pool setup
+        createCreateTimelineTool(host),
+        createCloneTimelineTool(host),
+        createSaveProjectTool(host),
+        createAddTrackTool(host),
+        createImportToMediaPoolTool(host, cwd),
+        createOpenPageTool(host),
+        // Bulk timeline ops
+        createWriteEdlTool(cwd),
+        createWriteFcpxmlTool(cwd),
+        createImportEdlTool(host, cwd),
+        createReformatTimelineTool(cwd),
+        createRenderTool(host, cwd),
+        createListRenderPresetsTool(host),
+        createSmartReframeTool(host),
+        createPreRenderCheckTool(host, cwd),
+        createReorderTimelineTool(host, cwd),
+        createComposeLayeredTool(host, cwd),
+        // Captions / subtitles
+        createWriteSrtTool(cwd),
+        createWriteAssTool(cwd),
+        createImportSubtitlesTool(host, cwd),
+        // Color (Resolve-only — Premiere throws unsupported)
+        createApplyLutTool(host, cwd),
+        createSetPrimaryCorrectionTool(host),
+        createCopyGradeTool(host),
+        createColorMatchTool(cwd),
+        createGradeSkinTonesTool(cwd),
+        createMatchClipColorTool(host, cwd),
+        // Audio cleanup + loudness (file-only; works on every host)
+        createMeasureLoudnessTool(cwd),
+        createNormalizeLoudnessTool(cwd),
+        createCleanAudioTool(cwd),
+        createDuckAudioTool(cwd),
+        createMixAudioTool(cwd),
+        // Frame extraction
+        createExtractFrameTool(cwd),
+        // Video stabilization
+        createStabilizeVideoTool(cwd),
+        // Post-production / delivery (file-only)
+        createBurnSubtitlesTool(cwd),
+        createConcatVideosTool(cwd),
+        createAddFadesTool(cwd),
+        createCrossfadeVideosTool(cwd),
+        createTransitionVideosTool(cwd),
+        createGenerateGifTool(cwd),
+        createOverlayWatermarkTool(cwd),
+        createComposeThumbnailTool(cwd),
+        createSpeedRampTool(cwd),
+        createKenBurnsTool(cwd),
+        createWriteLowerThirdTool(cwd),
+        createWriteTitleCardTool(cwd),
+        // Retention-tuning ops (the YouTube / TikTok / Reels pipeline)
+        createCutFillerWordsTool(cwd),
+        createPunchInTool(cwd),
+        createAnalyzeHookTool(cwd),
+        createWriteKeywordCaptionsTool(cwd),
+        createAddSfxAtCutsTool(cwd),
+        // Host-independent media ops
+        createProbeMediaTool(cwd),
+        createExtractAudioTool(cwd),
+        createDetectSilenceTool(cwd),
+        createTranscribeTool(cwd),
+        createReadTranscriptTool(cwd),
+        createClusterTakesTool(cwd),
+        createScoreShotTool(cwd),
+        createPickBestTakesTool(cwd),
+        createMulticamSyncTool(cwd),
+        createDetectSpeakerChangesTool(cwd),
+        // Skills
+        createReadSkillTool(skills),
+    ];
+    if (reviewConfig) {
+        tools.push(createReviewEditTool(host, cwd, reviewConfig));
+    }
+    return tools;
+}
+export { createAddFadesTool } from "./add-fades.js";
+export { createAddMarkerTool } from "./add-marker.js";
+export { createAddTrackTool } from "./add-track.js";
+export { createApplyLutTool } from "./apply-lut.js";
+export { createAppendClipTool } from "./append-clip.js";
+export { createBurnSubtitlesTool } from "./burn-subtitles.js";
+export { createCleanAudioTool } from "./clean-audio.js";
+export { createCloneTimelineTool } from "./clone-timeline.js";
+export { createClusterTakesTool } from "./cluster-takes.js";
+export { createComposeThumbnailTool } from "./compose-thumbnail.js";
+export { createConcatVideosTool } from "./concat-videos.js";
+export { createCrossfadeVideosTool } from "./crossfade-videos.js";
+export { createColorMatchTool } from "./color-match.js";
+export { createGradeSkinTonesTool } from "./grade-skin-tones.js";
+export { createMatchClipColorTool } from "./match-clip-color.js";
+export { createCutFillerWordsTool } from "./cut-filler-words.js";
+export { createPunchInTool } from "./punch-in.js";
+export { createAnalyzeHookTool } from "./analyze-hook.js";
+export { createWriteKeywordCaptionsTool } from "./write-keyword-captions.js";
+export { createAddSfxAtCutsTool } from "./add-sfx-at-cuts.js";
+export { createComposeLayeredTool } from "./compose-layered.js";
+export { createCopyGradeTool } from "./copy-grade.js";
+export { createDetectSpeakerChangesTool } from "./detect-speaker-changes.js";
+export { createKenBurnsTool } from "./ken-burns.js";
+export { createMixAudioTool } from "./mix-audio.js";
+export { createReorderTimelineTool } from "./reorder-timeline.js";
+export { createSpeedRampTool } from "./speed-ramp.js";
+export { createTransitionVideosTool } from "./transition-videos.js";
+export { createWriteLowerThirdTool } from "./write-lower-third.js";
+export { createWriteTitleCardTool } from "./write-title-card.js";
+export { createDuckAudioTool } from "./duck-audio.js";
+export { createCreateTimelineTool } from "./create-timeline.js";
+export { createCutAtTool } from "./cut-at.js";
+export { createDetectSilenceTool } from "./detect-silence.js";
+export { createExtractAudioTool } from "./extract-audio.js";
+export { createGetMarkersTool } from "./get-markers.js";
+export { createGetTimelineTool } from "./get-timeline.js";
+export { createHostInfoTool } from "./host-info.js";
+export { createImportEdlTool } from "./import-edl.js";
+export { createImportSubtitlesTool } from "./import-subtitles.js";
+export { createExtractFrameTool } from "./extract-frame.js";
+export { createImportToMediaPoolTool } from "./import-to-media-pool.js";
+export { createGenerateGifTool } from "./generate-gif.js";
+export { createInsertBrollTool } from "./insert-broll.js";
+export { createListRenderPresetsTool } from "./list-render-presets.js";
+export { createOverlayWatermarkTool } from "./overlay-watermark.js";
+export { createMeasureLoudnessTool } from "./measure-loudness.js";
+export { createMulticamSyncTool } from "./multicam-sync.js";
+export { createNormalizeLoudnessTool } from "./normalize-loudness.js";
+export { createPreRenderCheckTool } from "./pre-render-check.js";
+export { createSaveProjectTool } from "./save-project.js";
+export { createWriteAssTool } from "./write-ass.js";
+export { createOpenPageTool } from "./open-page.js";
+export { createPickBestTakesTool } from "./pick-best-takes.js";
+export { createProbeMediaTool } from "./probe-media.js";
+export { createReadSkillTool } from "./read-skill.js";
+export { createReadTranscriptTool } from "./read-transcript.js";
+export { createReviewEditTool } from "./review-edit.js";
+export { createReformatTimelineTool } from "./reformat-timeline.js";
+export { createRenderTool } from "./render.js";
+export { createRippleDeleteTool } from "./ripple-delete.js";
+export { createScoreShotTool } from "./score-shot.js";
+export { createReplaceClipTool } from "./replace-clip.js";
+export { createSetClipSpeedTool } from "./set-clip-speed.js";
+export { createSetClipVolumeTool } from "./set-clip-volume.js";
+export { createSetPrimaryCorrectionTool } from "./set-primary-correction.js";
+export { createSmartReframeTool } from "./smart-reframe.js";
+export { createStabilizeVideoTool } from "./stabilize-video.js";
+export { createTranscribeTool } from "./transcribe.js";
+export { createWriteEdlTool } from "./write-edl.js";
+export { createWriteFcpxmlTool } from "./write-fcpxml.js";
+export { createWriteSrtTool } from "./write-srt.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/index.test.d.ts

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

package/dist/tools/index.test.d.ts.map

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

package/dist/tools/index.test.js

@@ -0,0 +1,128 @@
+import { describe, expect, it } from "vitest";
+import { NoneAdapter } from "../core/hosts/none/adapter.js";
+import { createEditorTools } from "./index.js";
+/**
+ * Smoke test for the tool registry. Catches accidental dropouts when adding
+ * or renaming tools — every tool must appear in the registry exactly once.
+ */
+const EXPECTED_TOOLS = [
+    // Host introspection
+    "host_info",
+    // Timeline state
+    "get_timeline",
+    "get_markers",
+    // Per-clip mutation
+    "cut_at",
+    "ripple_delete",
+    "add_marker",
+    "append_clip",
+    "set_clip_speed",
+    "set_clip_volume",
+    "replace_clip",
+    "insert_broll",
+    // Project / timeline / media-pool setup
+    "create_timeline",
+    "clone_timeline",
+    "save_project",
+    "add_track",
+    "import_to_media_pool",
+    "open_page",
+    // Bulk timeline
+    "write_edl",
+    "write_fcpxml",
+    "import_edl",
+    "reformat_timeline",
+    "render",
+    "list_render_presets",
+    "smart_reframe",
+    "pre_render_check",
+    "reorder_timeline",
+    "compose_layered",
+    // Captions / subtitles
+    "write_srt",
+    "write_ass",
+    "import_subtitles",
+    // Color
+    "apply_lut",
+    "set_primary_correction",
+    "copy_grade",
+    "color_match",
+    "grade_skin_tones",
+    "match_clip_color",
+    // Audio cleanup + loudness
+    "measure_loudness",
+    "normalize_loudness",
+    "clean_audio",
+    "duck_audio",
+    "mix_audio",
+    // Frame extraction
+    "extract_frame",
+    // Stabilization
+    "stabilize_video",
+    // Post-production / delivery
+    "burn_subtitles",
+    "concat_videos",
+    "add_fades",
+    "crossfade_videos",
+    "transition_videos",
+    "generate_gif",
+    "overlay_watermark",
+    "compose_thumbnail",
+    "speed_ramp",
+    "ken_burns",
+    "write_lower_third",
+    "write_title_card",
+    // Host-independent media
+    "probe_media",
+    "extract_audio",
+    "detect_silence",
+    "transcribe",
+    "read_transcript",
+    "cluster_takes",
+    "score_shot",
+    "pick_best_takes",
+    "multicam_sync",
+    "detect_speaker_changes",
+    // Retention-tuning ops (the YouTube / TikTok / Reels pipeline)
+    "cut_filler_words",
+    "punch_in",
+    "analyze_hook",
+    "write_keyword_captions",
+    "add_sfx_at_cuts",
+    // Skills
+    "read_skill",
+];
+describe("createEditorTools", () => {
+    it("registers every expected tool exactly once", () => {
+        const host = new NoneAdapter();
+        const tools = createEditorTools({ host, cwd: process.cwd() });
+        const names = tools.map((t) => t.name).sort();
+        expect(names).toEqual([...EXPECTED_TOOLS].sort());
+        expect(names.length).toBe(new Set(names).size);
+    });
+    it("registers review_edit only when reviewConfig is supplied", () => {
+        const host = new NoneAdapter();
+        const without = createEditorTools({ host, cwd: process.cwd() });
+        expect(without.find((t) => t.name === "review_edit")).toBeUndefined();
+        const withCfg = createEditorTools({
+            host,
+            cwd: process.cwd(),
+            reviewConfig: {
+                provider: "anthropic",
+                model: "claude",
+                apiKey: "test",
+            },
+        });
+        expect(withCfg.find((t) => t.name === "review_edit")).toBeDefined();
+    });
+    it("read_skill knows about the bundled skills", async () => {
+        const host = new NoneAdapter();
+        const tools = createEditorTools({ host, cwd: process.cwd() });
+        const readSkill = tools.find((t) => t.name === "read_skill");
+        const ctx = { signal: new AbortController().signal, toolCallId: "t1" };
+        const r = await readSkill.execute({ name: "long-form-content-edit" }, ctx);
+        expect(typeof r).toBe("string");
+        expect(r.startsWith("# long-form-content-edit")).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/tools/index.test.js.map

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

package/dist/tools/insert-broll.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 InsertBrollParams: z.ZodObject<{
+    mediaPath: z.ZodString;
+    track: z.ZodOptional<z.ZodNumber>;
+    recordFrame: z.ZodNumber;
+    sourceInFrame: z.ZodOptional<z.ZodNumber>;
+    sourceOutFrame: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createInsertBrollTool(host: VideoHost, cwd: string): AgentTool<typeof InsertBrollParams>;
+export {};
+//# sourceMappingURL=insert-broll.d.ts.map

package/dist/tools/insert-broll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-broll.d.ts","sourceRoot":"","sources":["../../src/tools/insert-broll.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,iBAAiB;;;;;;iBAyBrB,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAyBrC"}

package/dist/tools/insert-broll.js

@@ -0,0 +1,56 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const InsertBrollParams = z.object({
+    mediaPath: z.string().describe("B-roll source file (relative resolves to cwd)."),
+    track: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Video track index. Default 2 (above main A-roll on V1)."),
+    recordFrame: z
+        .number()
+        .int()
+        .min(0)
+        .describe("Frame on the active timeline where the b-roll begins."),
+    sourceInFrame: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("In-point on the source clip (frames). Default 0."),
+    sourceOutFrame: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Out-point on the source clip (frames). Default = clip duration."),
+});
+export function createInsertBrollTool(host, cwd) {
+    return {
+        name: "insert_broll",
+        description: "Place a b-roll/cutaway clip on a higher track at a specific timeline frame, " +
+            "without disturbing the main video. Default track=2. Pair with read_transcript " +
+            "to find moments to cover (filler, ums, awkward pauses) and score_shot or media " +
+            "browsing to pick the b-roll. The main audio stays underneath.",
+        parameters: InsertBrollParams,
+        async execute({ mediaPath, track = 2, recordFrame, sourceInFrame, sourceOutFrame }, _ctx) {
+            try {
+                const abs = resolvePath(cwd, mediaPath);
+                const r = await host.insertClipOnTrack({
+                    mediaPath: abs,
+                    track,
+                    recordFrame,
+                    sourceInFrame,
+                    sourceOutFrame,
+                });
+                return compact(r);
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=insert-broll.js.map

package/dist/tools/insert-broll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-broll.js","sourceRoot":"","sources":["../../src/tools/insert-broll.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,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAChF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uDAAuD,CAAC;IACpE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;CAC/E,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,8EAA8E;YAC9E,gFAAgF;YAChF,iFAAiF;YACjF,+DAA+D;QACjE,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,IAAI;YACtF,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACxC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC;oBACrC,SAAS,EAAE,GAAG;oBACd,KAAK;oBACL,WAAW;oBACX,aAAa;oBACb,cAAc;iBACf,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;YACpB,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/ken-burns.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const KenBurnsParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    durationSec: z.ZodNumber;
+    fps: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    startZoom: z.ZodOptional<z.ZodNumber>;
+    endZoom: z.ZodOptional<z.ZodNumber>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        center: "center";
+        right: "right";
+        up: "up";
+        down: "down";
+        left: "left";
+        ne: "ne";
+        nw: "nw";
+        se: "se";
+        sw: "sw";
+    }>>;
+}, z.core.$strip>;
+export declare function createKenBurnsTool(cwd: string): AgentTool<typeof KenBurnsParams>;
+export {};
+//# sourceMappingURL=ken-burns.d.ts.map

package/dist/tools/ken-burns.d.ts.map

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

package/dist/tools/ken-burns.js

@@ -0,0 +1,125 @@
+import { mkdirSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+const KenBurnsParams = z.object({
+    input: z.string().describe("Source still image (.jpg / .png). Animated input also works."),
+    output: z.string(),
+    durationSec: z.number().positive().describe("How long the resulting clip is."),
+    fps: z.number().positive().optional().describe("Output frame rate. Default 30."),
+    width: z.number().int().positive().optional().describe("Output width. Default 1920."),
+    height: z.number().int().positive().optional().describe("Output height. Default 1080."),
+    startZoom: z.number().min(1).optional().describe("Initial zoom multiplier (1=fit). Default 1."),
+    endZoom: z.number().min(1).optional().describe("Final zoom multiplier. Default 1.4."),
+    /** Pan direction. Center = pure zoom. */
+    direction: z
+        .enum(["center", "left", "right", "up", "down", "ne", "nw", "se", "sw"])
+        .optional()
+        .describe("Where the zoom 'pulls' toward. Default center."),
+});
+export function createKenBurnsTool(cwd) {
+    return {
+        name: "ken_burns",
+        description: "File-only Ken-Burns zoom/pan animation on a still image (or video frame). " +
+            "Renders a video clip with continuous zoom from startZoom → endZoom over durationSec, " +
+            "panning in the chosen direction. Backed by ffmpeg's zoompan filter; works without " +
+            "any NLE. Output is libx264 + silent track.",
+        parameters: KenBurnsParams,
+        async execute(p, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, p.input);
+                const outAbs = resolvePath(cwd, p.output);
+                if (inAbs === outAbs)
+                    return err("input and output paths are identical");
+                const fps = p.fps ?? 30;
+                const w = p.width ?? 1920;
+                const h = p.height ?? 1080;
+                const startZ = p.startZoom ?? 1;
+                const endZ = p.endZoom ?? 1.4;
+                const totalFrames = Math.max(2, Math.round(p.durationSec * fps));
+                const direction = p.direction ?? "center";
+                // zoompan z expression — linear ramp from startZ to endZ over the run.
+                const zExpr = `${startZ}+(${endZ}-${startZ})*on/${totalFrames}`;
+                // Pan expressions per direction. zoompan x/y are the TOP-LEFT of the
+                // crop window; iw/ih = input frame size, iw/zoom = visible width.
+                const { xExpr, yExpr } = panExpressions(direction);
+                const filter = `scale=${w * 4}x-2,zoompan=z='${zExpr}':x='${xExpr}':y='${yExpr}':` +
+                    `d=${totalFrames}:fps=${fps}:s=${w}x${h}`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-loop",
+                    "1",
+                    "-framerate",
+                    String(fps),
+                    "-t",
+                    String(p.durationSec),
+                    "-i",
+                    inAbs,
+                    "-vf",
+                    filter,
+                    "-c:v",
+                    "libx264",
+                    "-crf",
+                    "20",
+                    "-preset",
+                    "veryfast",
+                    "-pix_fmt",
+                    "yuv420p",
+                    "-an",
+                    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, durationSec: p.durationSec });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function panExpressions(dir) {
+    // Center: keep crop window centred. Each direction biases by adding a
+    // linear factor of `on` (frame index) divided by total.
+    const cx = `(iw-iw/zoom)/2`;
+    const cy = `(ih-ih/zoom)/2`;
+    switch (dir) {
+        case "center":
+            return { xExpr: cx, yExpr: cy };
+        case "left":
+            return { xExpr: `(iw-iw/zoom)*(1-on/in_total)`, yExpr: cy };
+        case "right":
+            return { xExpr: `(iw-iw/zoom)*on/in_total`, yExpr: cy };
+        case "up":
+            return { xExpr: cx, yExpr: `(ih-ih/zoom)*(1-on/in_total)` };
+        case "down":
+            return { xExpr: cx, yExpr: `(ih-ih/zoom)*on/in_total` };
+        case "ne":
+            return {
+                xExpr: `(iw-iw/zoom)*on/in_total`,
+                yExpr: `(ih-ih/zoom)*(1-on/in_total)`,
+            };
+        case "nw":
+            return {
+                xExpr: `(iw-iw/zoom)*(1-on/in_total)`,
+                yExpr: `(ih-ih/zoom)*(1-on/in_total)`,
+            };
+        case "se":
+            return {
+                xExpr: `(iw-iw/zoom)*on/in_total`,
+                yExpr: `(ih-ih/zoom)*on/in_total`,
+            };
+        case "sw":
+            return {
+                xExpr: `(iw-iw/zoom)*(1-on/in_total)`,
+                yExpr: `(ih-ih/zoom)*on/in_total`,
+            };
+        default:
+            return { xExpr: cx, yExpr: cy };
+    }
+}
+//# sourceMappingURL=ken-burns.js.map

package/dist/tools/ken-burns.js.map

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