@prestyj/editor 0.7.1

package/dist/tools/index.test.js

@@ -0,0 +1,158 @@
+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",
+    "suggest_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",
+    "render_multi_format",
+    "list_render_presets",
+    "smart_reframe",
+    "face_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",
+    // Motion graphics (Resolve only)
+    "fusion_comp",
+    // 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",
+    "trim_dead_air",
+    "bleep_words",
+    "generate_outro",
+    "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",
+    "text_based_cut",
+    "punch_in",
+    "analyze_hook",
+    "audit_first_frame",
+    "audit_retention_structure",
+    "rewrite_hook",
+    "verify_thumbnail_promise",
+    "write_keyword_captions",
+    "add_sfx_at_cuts",
+    "add_sfx_to_timeline",
+    "snap_cuts_to_beats",
+    "loop_match_short",
+    // LLM-driven creator helpers
+    "score_clip",
+    "find_viral_moments",
+    "generate_youtube_metadata",
+    "compose_thumbnail_variants",
+    // Skills
+    "read_skill",
+    // Escape hatch (always registered; rejects with not_supported on host=none)
+    "host_eval",
+    // Meta-tool — appended last so it sees the rest of the registry
+    "search_tools",
+];
+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");
+        // Skills now ship with YAML frontmatter (Anthropic skill spec); content
+        // starts with the frontmatter delimiter and contains the heading further
+        // down.
+        const text = r;
+        expect(text.startsWith("---")).toBe(true);
+        expect(text).toContain("# long-form-content-edit");
+    });
+});
+//# 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 "@prestyj/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,gBAAgB,CAAC;AAEhD,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 "@prestyj/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,gBAAgB,CAAC;AAKhD,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,126 @@
+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";
+import { safeOutputPath } from "../core/safe-paths.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 = safeOutputPath(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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"}

package/dist/tools/list-render-presets.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ListRenderPresetsParams: z.ZodObject<{}, z.core.$strip>;
+export declare function createListRenderPresetsTool(host: VideoHost): AgentTool<typeof ListRenderPresetsParams>;
+export {};
+//# sourceMappingURL=list-render-presets.d.ts.map

package/dist/tools/list-render-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-render-presets.d.ts","sourceRoot":"","sources":["../../src/tools/list-render-presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,uBAAuB,gCAAe,CAAC;AAE7C,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,SAAS,GACd,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAyB3C"}

package/dist/tools/list-render-presets.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+const ListRenderPresetsParams = z.object({});
+export function createListRenderPresetsTool(host) {
+    return {
+        name: "list_render_presets",
+        description: "List the host's available render presets. CALL THIS BEFORE render() so you pick a real " +
+            "preset name instead of guessing. Resolve returns a populated list. Premiere returns [] " +
+            "(presets live in Adobe Media Encoder; not exposed to ExtendScript) — fall back to common " +
+            "names like 'H.264 Master', 'YouTube 1080p Full HD', or use File → Export manually.",
+        parameters: ListRenderPresetsParams,
+        async execute() {
+            try {
+                const presets = await host.listRenderPresets();
+                const summary = summarizeList(presets, 30);
+                return compact({
+                    host: host.name,
+                    total: summary.total,
+                    ...(summary.omitted > 0
+                        ? { head: summary.head, tail: summary.tail, omitted: summary.omitted }
+                        : { presets }),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=list-render-presets.js.map

package/dist/tools/list-render-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-render-presets.js","sourceRoot":"","sources":["../../src/tools/list-render-presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7C,MAAM,UAAU,2BAA2B,CACzC,IAAe;IAEf,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,yFAAyF;YACzF,yFAAyF;YACzF,2FAA2F;YAC3F,oFAAoF;QACtF,UAAU,EAAE,uBAAuB;QACnC,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC3C,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;wBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;wBACtE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;iBACjB,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/loop-match-short.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const LoopMatchShortParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    crossfadeSec: z.ZodOptional<z.ZodNumber>;
+    copyMethod: z.ZodOptional<z.ZodEnum<{
+        crossfade: "crossfade";
+        jumpcut: "jumpcut";
+    }>>;
+}, z.core.$strip>;
+/**
+ * loop_match_short — make a Short re-loop seamlessly.
+ *
+ * YouTube Shorts auto-replay is a confirmed ranking signal — the more
+ * loops a clip racks up, the more it gets pushed. A 0.3s crossfade
+ * between the tail and the head erases the visible "snap" at the
+ * loop boundary.
+ */
+export declare function createLoopMatchShortTool(cwd: string): AgentTool<typeof LoopMatchShortParams>;
+export {};
+//# sourceMappingURL=loop-match-short.d.ts.map

package/dist/tools/loop-match-short.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-match-short.d.ts","sourceRoot":"","sources":["../../src/tools/loop-match-short.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,oBAAoB;;;;;;;;iBAoBxB,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAwE5F"}

package/dist/tools/loop-match-short.js

@@ -0,0 +1,107 @@
+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 { buildLoopMatchFilter } from "../core/loop-match.js";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const LoopMatchShortParams = z.object({
+    input: z.string().describe("Source Short (.mp4). Relative resolves to cwd."),
+    output: z.string().describe("Output .mp4 path. Re-encoded; must differ from input."),
+    crossfadeSec: z
+        .number()
+        .positive()
+        .max(2)
+        .optional()
+        .describe("Crossfade duration. Default 0.3s — small enough to preserve content, large enough to " +
+        "smooth the loop boundary. Capped at clip duration / 2."),
+    copyMethod: z
+        .enum(["crossfade", "jumpcut"])
+        .optional()
+        .describe("'crossfade' (default) blends the last N ms into the first N ms; 'jumpcut' simply " +
+        "trims the last N ms so the loop hard-cuts to the head. Use jumpcut on very short " +
+        "clips where any crossfade would eat too much of the visible content."),
+});
+/**
+ * loop_match_short — make a Short re-loop seamlessly.
+ *
+ * YouTube Shorts auto-replay is a confirmed ranking signal — the more
+ * loops a clip racks up, the more it gets pushed. A 0.3s crossfade
+ * between the tail and the head erases the visible "snap" at the
+ * loop boundary.
+ */
+export function createLoopMatchShortTool(cwd) {
+    return {
+        name: "loop_match_short",
+        description: "Crossfade the last N ms of a Short into the first N ms so YouTube's auto-replay " +
+            "re-loop feels seamless. Loop rate is a confirmed Shorts ranking signal (per " +
+            "`youtube-algorithm-primer` skill). Default 0.3s crossfade. Pair as the LAST step in " +
+            "the short-form pipeline before delivery: `find_viral_moments → face_reframe → " +
+            "write_keyword_captions → burn_subtitles → punch_in → add_sfx_at_cuts → " +
+            "normalize_loudness(platform=tiktok) → loop_match_short`. File-only ffmpeg pass — no " +
+            "LLM, no API key.",
+        parameters: LoopMatchShortParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const outAbs = safeOutputPath(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.durationSec <= 0)
+                    return err("source has zero duration");
+                const cf = args.crossfadeSec ?? 0.3;
+                const method = args.copyMethod ?? "crossfade";
+                let plan;
+                try {
+                    plan = buildLoopMatchFilter(probe.durationSec, cf, method);
+                }
+                catch (e) {
+                    return err(e.message);
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const r = await runFfmpeg([
+                    "-i",
+                    inAbs,
+                    "-filter_complex",
+                    plan.filter,
+                    "-map",
+                    plan.maps[0],
+                    "-map",
+                    plan.maps[1],
+                    "-c:v",
+                    "libx264",
+                    "-crf",
+                    "20",
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    "192k",
+                    outAbs,
+                ], { signal: ctx.signal });
+                if (r.code !== 0)
+                    return err(`ffmpeg exited ${r.code}: ${tail(r.stderr)}`);
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    crossfadeSec: +plan.crossfadeSec.toFixed(3),
+                    outDurationSec: +plan.outDurationSec.toFixed(3),
+                    method: plan.method,
+                    inDurationSec: +probe.durationSec.toFixed(3),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=loop-match-short.js.map

package/dist/tools/loop-match-short.js.map

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

package/dist/tools/match-clip-color.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const MatchClipColorParams: z.ZodObject<{
+    referenceVideo: z.ZodString;
+    referenceAtSec: z.ZodNumber;
+    targetClipId: z.ZodString;
+    targetAtSec: z.ZodNumber;
+    nodeIndex: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    applyAutomatically: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * match_clip_color — non-baked skin-tone match (Resolve only). Derives the
+ * same vision-tuned grade as `grade_skin_tones` but pipes the CDL portion
+ * through `host.setPrimaryCorrection`. The grade is non-destructive (lives
+ * in the clip's grading node, not in the file).
+ *
+ * `applyAutomatically` defaults to false: the tool returns the grade and
+ * lets the agent decide. When true and confidence ≥ 0.4 the CDL is
+ * applied; below 0.4 it's still returned but skipped with a warning.
+ */
+export declare function createMatchClipColorTool(host: VideoHost, cwd: string): AgentTool<typeof MatchClipColorParams>;
+export {};
+//# sourceMappingURL=match-clip-color.d.ts.map

package/dist/tools/match-clip-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-clip-color.d.ts","sourceRoot":"","sources":["../../src/tools/match-clip-color.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;iBAsBxB,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,oBAAoB,CAAC,CA+DxC"}