@prestyj/editor 0.7.1

package/dist/tools/set-primary-correction.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const Triple = z
+    .tuple([z.number(), z.number(), z.number()])
+    .describe("[R, G, B] triple of floats.");
+const SetPrimaryCorrectionParams = z.object({
+    clipId: z.string().min(1).describe("Clip id from get_timeline."),
+    slope: Triple.optional().describe("Slope (gain). Default neutral [1,1,1]."),
+    offset: Triple.optional().describe("Offset (lift). Default neutral [0,0,0]."),
+    power: Triple.optional().describe("Power (gamma). Default neutral [1,1,1]."),
+    saturation: z.number().optional().describe("Saturation. 1 = neutral."),
+    nodeIndex: z.number().int().positive().optional().describe("1-based node index. Default 1."),
+});
+export function createSetPrimaryCorrectionTool(host) {
+    return {
+        name: "set_primary_correction",
+        description: "Apply a primary CDL (slope/offset/power/saturation) to a clip's grading node " +
+            "(Resolve only). At least one of slope/offset/power/saturation must be supplied. " +
+            "Cannot create nodes, touch wheels, curves, qualifiers, or windows — use the " +
+            "Color page manually for those. Common recipe: apply_lut as base, then nudge with this.",
+        parameters: SetPrimaryCorrectionParams,
+        async execute({ clipId, slope, offset, power, saturation, nodeIndex }) {
+            if (slope === undefined &&
+                offset === undefined &&
+                power === undefined &&
+                saturation === undefined) {
+                return err("at least one of slope/offset/power/saturation required");
+            }
+            try {
+                await host.setPrimaryCorrection(clipId, {
+                    slope,
+                    offset,
+                    power,
+                    saturation,
+                    nodeIndex,
+                });
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=set-primary-correction.js.map

package/dist/tools/set-primary-correction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-primary-correction.js","sourceRoot":"","sources":["../../src/tools/set-primary-correction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,MAAM,GAAG,CAAC;KACb,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC3C,QAAQ,CAAC,6BAA6B,CAAC,CAAC;AAE3C,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC7E,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,IAAe;IAEf,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,+EAA+E;YAC/E,kFAAkF;YAClF,8EAA8E;YAC9E,wFAAwF;QAC1F,UAAU,EAAE,0BAA0B;QACtC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE;YACnE,IACE,KAAK,KAAK,SAAS;gBACnB,MAAM,KAAK,SAAS;gBACpB,KAAK,KAAK,SAAS;gBACnB,UAAU,KAAK,SAAS,EACxB,CAAC;gBACD,OAAO,GAAG,CAAC,wDAAwD,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE;oBACtC,KAAK;oBACL,MAAM;oBACN,KAAK;oBACL,UAAU;oBACV,SAAS;iBACV,CAAC,CAAC;gBACH,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/smart-reframe.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const SmartReframeParams: z.ZodObject<{
+    clipId: z.ZodString;
+    aspect: z.ZodEnum<{
+        "9:16": "9:16";
+        "1:1": "1:1";
+        "4:5": "4:5";
+        "16:9": "16:9";
+        "4:3": "4:3";
+    }>;
+    frameInterest: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        keyframes: "keyframes";
+        "reference-frame": "reference-frame";
+    }>>;
+    referenceFrame: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createSmartReframeTool(host: VideoHost): AgentTool<typeof SmartReframeParams>;
+export {};
+//# sourceMappingURL=smart-reframe.d.ts.map

package/dist/tools/smart-reframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-reframe.d.ts","sourceRoot":"","sources":["../../src/tools/smart-reframe.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,kBAAkB;;;;;;;;;;;;;;;iBAatB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAwB5F"}

package/dist/tools/smart-reframe.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const SmartReframeParams = z.object({
+    clipId: z.string().min(1).describe("Clip id from get_timeline."),
+    aspect: z.enum(["9:16", "1:1", "4:5", "16:9", "4:3"]),
+    frameInterest: z
+        .enum(["all", "keyframes", "reference-frame"])
+        .optional()
+        .describe("Which frames the AI should consider. Default 'all'."),
+    referenceFrame: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Required when frameInterest='reference-frame' — the frame to use as anchor."),
+});
+export function createSmartReframeTool(host) {
+    return {
+        name: "smart_reframe",
+        description: "Trigger Resolve Studio's Smart Reframe AI on a single clip. Resolve Studio only " +
+            "(free version + Premiere unsupported). Use after reformat_timeline + import_edl to " +
+            "auto-track the subject as the AI re-frames each clip into 9:16/1:1/etc. The agent " +
+            "should call this PER CLIP that needs subject tracking.",
+        parameters: SmartReframeParams,
+        async execute({ clipId, aspect, frameInterest, referenceFrame }) {
+            if (!host.smartReframe) {
+                return err(`${host.name} does not support smart_reframe`, "use reformat_timeline + import_edl, then trigger Smart Reframe manually in Resolve Studio");
+            }
+            try {
+                await host.smartReframe(clipId, { aspect, frameInterest, referenceFrame });
+                return compact({ ok: true, clipId, aspect });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=smart-reframe.js.map

package/dist/tools/smart-reframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-reframe.js","sourceRoot":"","sources":["../../src/tools/smart-reframe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;CAC3F,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,kFAAkF;YAClF,qFAAqF;YACrF,oFAAoF;YACpF,wDAAwD;QAC1D,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE;YAC7D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,OAAO,GAAG,CACR,GAAG,IAAI,CAAC,IAAI,iCAAiC,EAC7C,2FAA2F,CAC5F,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC3E,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/C,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/snap-cuts-to-beats.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const SnapCutsToBeatsParams: z.ZodObject<{
+    audio: z.ZodString;
+    cutPoints: z.ZodArray<z.ZodNumber>;
+    toleranceSec: z.ZodOptional<z.ZodNumber>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * snap_cuts_to_beats — the music-driven cut primitive. CapCut ships this
+ * as "Auto Beat" and it's the single biggest reason their music shorts
+ * feel snappy. We expose it as a pure data tool: in → cut points; out →
+ * beat-aligned cut points. The agent then feeds the result to cut_at /
+ * add_sfx_at_cuts / punch_in for the actual edit.
+ */
+export declare function createSnapCutsToBeatsTool(cwd: string): AgentTool<typeof SnapCutsToBeatsParams>;
+export {};
+//# sourceMappingURL=snap-cuts-to-beats.d.ts.map

package/dist/tools/snap-cuts-to-beats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-cuts-to-beats.d.ts","sourceRoot":"","sources":["../../src/tools/snap-cuts-to-beats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,QAAA,MAAM,qBAAqB;;;;;iBAmCzB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAwE9F"}

package/dist/tools/snap-cuts-to-beats.js

@@ -0,0 +1,110 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { detectBeats, snapCuts } from "../core/beats.js";
+import { compact, err } from "../core/format.js";
+import { findPython } from "../core/python.js";
+const SnapCutsToBeatsParams = z.object({
+    audio: z
+        .string()
+        .describe("Path to an audio or video file (relative resolves to cwd). Librosa loads it via " +
+        "soundfile/audioread, so most containers work — but feeding pure music or a music " +
+        "bed gives much better beat detection than dialogue alone."),
+    cutPoints: z
+        .array(z.number().min(0))
+        .min(1)
+        .describe("Proposed cut times in seconds — typically the boundaries from cut_filler_words.keeps, " +
+        "detect_silence, or hand-picked moments. Each is snapped to its nearest beat within " +
+        "toleranceSec; cuts beyond the tolerance pass through unchanged."),
+    toleranceSec: z
+        .number()
+        .positive()
+        .max(2)
+        .optional()
+        .describe("Maximum distance (seconds) a cut may move to land on a beat. Default 0.25s — large " +
+        "enough to catch the off-by-half-a-beat case, small enough to preserve speech timing. " +
+        "Bump to 0.5 for music-driven montage; tighten to 0.1 if dialog is the focus."),
+    sampleRate: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Override librosa's load sample rate (default 22050). Bump to 44100 if the input is " +
+        "very short and you need finer beat resolution."),
+});
+/**
+ * snap_cuts_to_beats — the music-driven cut primitive. CapCut ships this
+ * as "Auto Beat" and it's the single biggest reason their music shorts
+ * feel snappy. We expose it as a pure data tool: in → cut points; out →
+ * beat-aligned cut points. The agent then feeds the result to cut_at /
+ * add_sfx_at_cuts / punch_in for the actual edit.
+ */
+export function createSnapCutsToBeatsTool(cwd) {
+    return {
+        name: "snap_cuts_to_beats",
+        description: "Snap a list of proposed cut times to the nearest beat in a music track via librosa " +
+            "beat-tracking. The CapCut 'Auto Beat' look — music-driven cuts that pop on the kick. " +
+            "REQUIRES python3 + `pip install librosa numpy soundfile`. Pass `audio` (the song / " +
+            "music bed) and `cutPoints` (from cut_filler_words.keeps, detect_silence, or " +
+            "hand-picked). Default tolerance 0.25s; cuts beyond it stay where they were. " +
+            "Returns {tempo, totalBeats, snapped:[{originalSec,snappedSec,deltaSec,beatIdx}], " +
+            "unchanged:[...]} — feed `snapped[].snappedSec` to cut_at / add_sfx_at_cuts / punch_in.",
+        parameters: SnapCutsToBeatsParams,
+        async execute(args, ctx) {
+            if (!findPython()) {
+                return err("Python 3 not on PATH", "install python3 and librosa: pip install librosa numpy soundfile");
+            }
+            try {
+                const audioAbs = resolvePath(cwd, args.audio);
+                const tol = args.toleranceSec ?? 0.25;
+                let result;
+                try {
+                    result = await detectBeats(audioAbs, {
+                        signal: ctx.signal,
+                        sampleRate: args.sampleRate,
+                    });
+                }
+                catch (e) {
+                    // Surface the most likely fix for the most common failure (missing deps).
+                    const msg = e.message;
+                    if (/missing python dep/i.test(msg)) {
+                        return err(msg, "pip install librosa numpy soundfile");
+                    }
+                    if (/malformed output|empty stdout|unexpected shape/i.test(msg)) {
+                        return err(msg);
+                    }
+                    return err(msg);
+                }
+                if (!result.beats || result.beats.length === 0) {
+                    return err("no beats detected; verify audio has music or rhythmic content", "drop the snap; raw cut points stand");
+                }
+                const { snapped, unchanged } = snapCuts(args.cutPoints, result.beats, tol);
+                return compact({
+                    tempo: round(result.tempo, 2),
+                    totalBeats: result.beats.length,
+                    durationSec: round(result.durationSec, 3),
+                    toleranceSec: tol,
+                    snapped: snapped.map((s) => ({
+                        originalSec: round(s.originalSec, 3),
+                        snappedSec: round(s.snappedSec, 3),
+                        deltaSec: round(s.deltaSec, 3),
+                        beatIdx: s.beatIdx,
+                    })),
+                    unchanged: unchanged.map((u) => ({
+                        atSec: round(u.atSec, 3),
+                        nearestBeatDeltaSec: u.nearestBeatDeltaSec !== undefined ? round(u.nearestBeatDeltaSec, 3) : undefined,
+                    })),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function round(n, places) {
+    if (!Number.isFinite(n))
+        return n;
+    const m = 10 ** places;
+    return Math.round(n * m) / m;
+}
+//# sourceMappingURL=snap-cuts-to-beats.js.map

package/dist/tools/snap-cuts-to-beats.js.map

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

package/dist/tools/snap-cuts-to-beats.test.d.ts

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

package/dist/tools/snap-cuts-to-beats.test.d.ts.map

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

package/dist/tools/snap-cuts-to-beats.test.js

@@ -0,0 +1,99 @@
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import * as beatsCore from "../core/beats.js";
+import * as pythonMod from "../core/python.js";
+import { createSnapCutsToBeatsTool } from "./snap-cuts-to-beats.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("snap_cuts_to_beats tool", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns python-missing error when findPython fails", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue(undefined);
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "song.wav", cutPoints: [1.0] }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/Python 3 not on PATH/);
+        expect(r).toMatch(/pip install librosa/);
+    });
+    it("formats successful output as compact JSON with snapped + unchanged", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(beatsCore, "detectBeats").mockResolvedValue({
+            tempo: 120.5,
+            beats: [1.0, 2.0, 3.0, 4.0],
+            durationSec: 5.0,
+        });
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "song.wav", cutPoints: [1.05, 2.5, 4.02] }, ctx);
+        expect(typeof r).toBe("string");
+        const parsed = JSON.parse(r);
+        expect(parsed.tempo).toBe(120.5);
+        expect(parsed.totalBeats).toBe(4);
+        expect(parsed.toleranceSec).toBe(0.25);
+        // 1.05 → 1.0 (delta -0.05), 4.02 → 4.0 (delta -0.02), 2.5 → unchanged (0.5 from each).
+        expect(parsed.snapped).toHaveLength(2);
+        expect(parsed.snapped[0]).toEqual({
+            originalSec: 1.05,
+            snappedSec: 1.0,
+            deltaSec: -0.05,
+            beatIdx: 0,
+        });
+        expect(parsed.unchanged).toHaveLength(1);
+        expect(parsed.unchanged[0].atSec).toBe(2.5);
+        expect(parsed.unchanged[0].nearestBeatDeltaSec).toBe(0.5);
+    });
+    it("respects custom tolerance", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(beatsCore, "detectBeats").mockResolvedValue({
+            tempo: 60,
+            beats: [0, 1, 2, 3],
+            durationSec: 4,
+        });
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "x.wav", cutPoints: [0.5], toleranceSec: 0.6 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.toleranceSec).toBe(0.6);
+        // 0.5 within 0.6 tol of beat 0 → snaps to 0.
+        expect(parsed.snapped).toHaveLength(1);
+        expect(parsed.snapped[0].snappedSec).toBe(0);
+    });
+    it("returns no-beats error when sidecar reports an empty list", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(beatsCore, "detectBeats").mockResolvedValue({
+            tempo: 0,
+            beats: [],
+            durationSec: 5,
+        });
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "silent.wav", cutPoints: [1] }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/no beats detected/);
+        expect(r).toMatch(/raw cut points stand/);
+    });
+    it("propagates a missing-dep sidecar error with the pip-install fix", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(beatsCore, "detectBeats").mockRejectedValue(new Error("missing python dep: librosa; install librosa numpy soundfile"));
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "x.wav", cutPoints: [1] }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/missing python dep: librosa/);
+        expect(r).toMatch(/pip install librosa numpy soundfile/);
+    });
+    it("propagates a malformed-output sidecar error", async () => {
+        vi.spyOn(pythonMod, "findPython").mockReturnValue({ cmd: "python3", args: [] });
+        vi.spyOn(beatsCore, "detectBeats").mockRejectedValue(new Error("beat sidecar returned malformed output: garbage | stderr: warn"));
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        const r = await tool.execute({ audio: "x.wav", cutPoints: [1] }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/malformed output/);
+    });
+    it("zod rejects an empty cutPoints array", async () => {
+        const tool = createSnapCutsToBeatsTool("/tmp");
+        // The agent SDK normally validates before execute; here we exercise zod directly.
+        const r = tool.parameters.safeParse({ audio: "x.wav", cutPoints: [] });
+        expect(r.success).toBe(false);
+    });
+});
+//# sourceMappingURL=snap-cuts-to-beats.test.js.map

package/dist/tools/snap-cuts-to-beats.test.js.map

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

package/dist/tools/speed-ramp.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const SpeedRampParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    points: z.ZodArray<z.ZodObject<{
+        atSec: z.ZodNumber;
+        speed: z.ZodNumber;
+    }, z.core.$strip>>;
+    muteAudio: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createSpeedRampTool(cwd: string): AgentTool<typeof SpeedRampParams>;
+export {};
+//# sourceMappingURL=speed-ramp.d.ts.map

package/dist/tools/speed-ramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speed-ramp.d.ts","sourceRoot":"","sources":["../../src/tools/speed-ramp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAchD,QAAA,MAAM,eAAe;;;;;;;;iBAYnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAmDlF"}

package/dist/tools/speed-ramp.js

@@ -0,0 +1,72 @@
+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 { buildAtempo, buildSetpts } from "../core/speed-ramp.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const SpeedPointSchema = z.object({
+    atSec: z.number().min(0).describe("Time in the input where this segment begins."),
+    speed: z
+        .number()
+        .positive()
+        .describe("Speed multiplier from this point. 1=normal, 0.5=slow-mo, 2=fast."),
+});
+const SpeedRampParams = z.object({
+    input: z.string(),
+    output: z.string(),
+    points: z
+        .array(SpeedPointSchema)
+        .min(2)
+        .describe("Speed-ramp control points. Min 2 (start + end). Strictly-increasing atSec. " +
+        "Three-point ramp 1→0.5→1 = classic slow-down-then-resume."),
+    /** When true, drop the audio entirely. */
+    muteAudio: z.boolean().optional(),
+});
+export function createSpeedRampTool(cwd) {
+    return {
+        name: "speed_ramp",
+        description: "File-only piecewise speed ramp via setpts. Slow-mo and fast-forward in one pass. " +
+            "Audio is time-stretched via atempo (chained for >2× ranges). Use 3 points for " +
+            "smooth-feeling ramps (1→0.5→1). For complex curves, do separate ramps and concat. " +
+            "Re-encodes the video — output is libx264.",
+        parameters: SpeedRampParams,
+        async execute({ input, output, points, muteAudio }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = safeOutputPath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical");
+                }
+                const setpts = buildSetpts(points);
+                const tempo = buildAtempo(points);
+                const videoFilter = setpts;
+                const audioFilter = tempo.filter;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = ["-i", inAbs, "-vf", videoFilter];
+                if (muteAudio) {
+                    args.push("-an");
+                }
+                else if (audioFilter) {
+                    args.push("-af", audioFilter);
+                }
+                args.push("-c:v", "libx264", "-crf", "20", "-preset", "veryfast", ...(muteAudio ? [] : ["-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,
+                    segments: points.length - 1,
+                    avgSpeed: tempo.avgSpeed,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=speed-ramp.js.map

package/dist/tools/speed-ramp.js.map

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

package/dist/tools/stabilize-video.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const StabilizeVideoParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    shakiness: z.ZodOptional<z.ZodNumber>;
+    smoothing: z.ZodOptional<z.ZodNumber>;
+    zoom: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createStabilizeVideoTool(cwd: string): AgentTool<typeof StabilizeVideoParams>;
+export {};
+//# sourceMappingURL=stabilize-video.d.ts.map

package/dist/tools/stabilize-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilize-video.d.ts","sourceRoot":"","sources":["../../src/tools/stabilize-video.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,oBAAoB;;;;;;iBAuBxB,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CA8B5F"}

package/dist/tools/stabilize-video.js

@@ -0,0 +1,64 @@
+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 } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+import { stabilize } from "../core/stabilize.js";
+const StabilizeVideoParams = z.object({
+    input: z.string().describe("Source video file."),
+    output: z.string().describe("Where to write the stabilized file."),
+    shakiness: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("How shaky the input is. 1=tripod-shake, 10=dropped-on-skateboard. Default 5."),
+    smoothing: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .optional()
+        .describe("Camera-path smoothing window in frames. Higher = more aggressive. Default 15."),
+    zoom: z
+        .number()
+        .min(-10)
+        .max(10)
+        .optional()
+        .describe("Output zoom percent (-10..10). Use ~5 to hide stabilization borders."),
+});
+export function createStabilizeVideoTool(cwd) {
+    return {
+        name: "stabilize_video",
+        description: "Two-pass ffmpeg vidstab stabilization. Pass 1 analyses motion; pass 2 applies the inverse. " +
+            "Requires ffmpeg compiled with libvidstab (most modern builds). For handheld / gimbal-less " +
+            "footage. Stabilization always shrinks the visible frame slightly — pass zoom=5 to crop " +
+            "the borders out. Audio is copied unchanged.",
+        parameters: StabilizeVideoParams,
+        async execute({ input, output, shakiness, smoothing, zoom }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = safeOutputPath(cwd, output);
+                if (inAbs === outAbs) {
+                    return err("input and output paths are identical", "use a different output path");
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const r = await stabilize(inAbs, outAbs, {
+                    shakiness,
+                    smoothing,
+                    zoom,
+                    signal: ctx.signal,
+                });
+                return compact({ ok: true, path: r.output, transforms: r.transformsPath });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=stabilize-video.js.map

package/dist/tools/stabilize-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilize-video.js","sourceRoot":"","sources":["../../src/tools/stabilize-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAClE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,CAAC;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,6FAA6F;YAC7F,4FAA4F;YAC5F,yFAAyF;YACzF,6CAA6C;QAC/C,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG;YAC9D,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC3C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;oBACrB,OAAO,GAAG,CAAC,sCAAsC,EAAE,6BAA6B,CAAC,CAAC;gBACpF,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;oBACvC,SAAS;oBACT,SAAS;oBACT,IAAI;oBACJ,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YAC7E,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/suggest-broll.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+/**
+ * suggest_broll — extract visually-searchable concepts from a transcript
+ * window via ONE LLM call, then query Pexels' free stock-video library
+ * and (optionally) download the top match per concept. The output shape
+ * is shaped to feed `insert_broll` directly:
+ *
+ *   for (const it of items) {
+ *     await insert_broll({
+ *       mediaPath: it.mediaPath,
+ *       recordFrame: Math.round(it.atSec * fps),
+ *     });
+ *   }
+ */
+declare const SuggestBrollParams: z.ZodObject<{
+    transcript: z.ZodString;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    endSec: z.ZodOptional<z.ZodNumber>;
+    topN: z.ZodOptional<z.ZodNumber>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        landscape: "landscape";
+        portrait: "portrait";
+        square: "square";
+    }>>;
+    minDurationSec: z.ZodOptional<z.ZodNumber>;
+    outDir: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    download: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createSuggestBrollTool(cwd: string): AgentTool<typeof SuggestBrollParams>;
+export declare function _tempBrollDir(): string;
+export {};
+//# sourceMappingURL=suggest-broll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-broll.d.ts","sourceRoot":"","sources":["../../src/tools/suggest-broll.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;iBA6DtB,CAAC;AA4CH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CA0LxF;AAgKD,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}