@prestyj/editor 0.7.1

package/dist/tools/concat-videos.test.js

@@ -0,0 +1,103 @@
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import * as ffmpegMod from "../core/media/ffmpeg.js";
+import { buildConcatListBody, createConcatVideosTool } from "./concat-videos.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+/**
+ * The lossless branch writes an ffmpeg concat list file to os.tmpdir() and must
+ * clean it up via try/finally regardless of whether ffmpeg succeeded or failed.
+ * We snoop the path by intercepting runFfmpeg and pulling the value of the
+ * argument that follows `-i`.
+ */
+function captureListPathOn(mock) {
+    const ref = { current: () => undefined };
+    let captured;
+    mock.mockImplementation(async (args) => {
+        const i = args.indexOf("-i");
+        captured = i >= 0 ? args[i + 1] : undefined;
+        return { code: 0, stdout: "", stderr: "" };
+    });
+    ref.current = () => captured;
+    return ref;
+}
+describe("buildConcatListBody", () => {
+    it("single-quotes paths and escapes embedded single quotes", () => {
+        const body = buildConcatListBody(["/a/b.mp4", "/weird/it's.mp4"]);
+        expect(body).toBe("file '/a/b.mp4'\nfile '/weird/it'\\''s.mp4'");
+    });
+});
+describe("concat_videos temp-file cleanup", () => {
+    let workDir;
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        workDir = mkdtempSync(join(tmpdir(), "gg-concat-test-"));
+        // Make the inputs and output resolve to real-looking files so the
+        // pre-flight identity check doesn't trip.
+        writeFileSync(join(workDir, "a.mp4"), "");
+        writeFileSync(join(workDir, "b.mp4"), "");
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("removes the concat list file after a successful lossless run", async () => {
+        const ff = vi.spyOn(ffmpegMod, "runFfmpeg");
+        const captured = captureListPathOn(ff);
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(r).not.toMatch(/^error:/);
+        const listPath = captured.current();
+        expect(listPath).toBeDefined();
+        expect(listPath).toMatch(/gg-concat-/);
+        expect(existsSync(listPath)).toBe(false);
+    });
+    it("writes the concat list before invoking ffmpeg (sanity-check the body)", async () => {
+        let bodyAtFfmpegTime;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            const path = args[i + 1];
+            bodyAtFfmpegTime = readFileSync(path, "utf8");
+            return { code: 0, stdout: "", stderr: "" };
+        });
+        const tool = createConcatVideosTool(workDir);
+        await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(bodyAtFfmpegTime).toBeDefined();
+        expect(bodyAtFfmpegTime).toContain("file '");
+        expect(bodyAtFfmpegTime).toContain("a.mp4");
+        expect(bodyAtFfmpegTime).toContain("b.mp4");
+    });
+    it("removes the concat list file when ffmpeg returns a non-zero code", async () => {
+        let captured;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            captured = args[i + 1];
+            return { code: 1, stdout: "", stderr: "boom" };
+        });
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        expect(r).toMatch(/^error: ffmpeg concat-demuxer exited 1/);
+        expect(captured).toBeDefined();
+        expect(existsSync(captured)).toBe(false);
+    });
+    it("removes the concat list file when runFfmpeg throws", async () => {
+        let captured;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            const i = args.indexOf("-i");
+            captured = args[i + 1];
+            throw new Error("spawn failed");
+        });
+        const tool = createConcatVideosTool(workDir);
+        const r = await tool.execute({ inputs: ["a.mp4", "b.mp4"], output: "out.mp4", lossless: true }, ctx);
+        // The outer try/catch in the tool surfaces thrown errors as err()
+        // strings; the temp file must still be gone.
+        expect(r).toMatch(/^error: spawn failed/);
+        expect(captured).toBeDefined();
+        expect(existsSync(captured)).toBe(false);
+    });
+});
+//# sourceMappingURL=concat-videos.test.js.map

package/dist/tools/concat-videos.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat-videos.test.js","sourceRoot":"","sources":["../../src/tools/concat-videos.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,GAAG,GAAG;IACV,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,UAAU,EAAE,IAAI;CACiE,CAAC;AAEpF;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,IAAiC;IAC1D,MAAM,GAAG,GAAsC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAC5E,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC;IAC7B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,mBAAmB,CAAC,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,kEAAkE;QAClE,0CAA0C;QAC1C,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EACjE,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,QAAS,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,IAAI,gBAAoC,CAAC;QACzC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,gBAAgB,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,OAAO,CAChB,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EACjE,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,gBAAiB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,gBAAiB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAiB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,IAAI,QAA4B,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EACjE,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QAC5D,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,IAAI,QAA4B,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EACjE,GAAyC,CAC1C,CAAC;QAEF,kEAAkE;QAClE,6CAA6C;QAC7C,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/copy-grade.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CopyGradeParams: z.ZodObject<{
+    sourceClipId: z.ZodString;
+    targetClipIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare function createCopyGradeTool(host: VideoHost): AgentTool<typeof CopyGradeParams>;
+export {};
+//# sourceMappingURL=copy-grade.d.ts.map

package/dist/tools/copy-grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-grade.d.ts","sourceRoot":"","sources":["../../src/tools/copy-grade.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,eAAe;;;iBAMnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAkBtF"}

package/dist/tools/copy-grade.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const CopyGradeParams = z.object({
+    sourceClipId: z.string().min(1).describe("Hero clip whose grade you want to replicate."),
+    targetClipIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe("Clips that should receive the source's grade."),
+});
+export function createCopyGradeTool(host) {
+    return {
+        name: "copy_grade",
+        description: "Copy the current grade from one clip to many (Resolve only). " +
+            "On Resolve, the Color page may need to be open for copy_grade to take effect. " +
+            "Call open_page('color') first if it errors. Use after grading a hero shot to " +
+            "replicate across similar shots.",
+        parameters: CopyGradeParams,
+        async execute({ sourceClipId, targetClipIds }) {
+            try {
+                await host.copyGrade(sourceClipId, targetClipIds);
+                return compact({ sourceClipId, copied: targetClipIds.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=copy-grade.js.map

package/dist/tools/copy-grade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-grade.js","sourceRoot":"","sources":["../../src/tools/copy-grade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACxF,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,+CAA+C,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,+DAA+D;YAC/D,gFAAgF;YAChF,+EAA+E;YAC/E,iCAAiC;QACnC,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;gBAClD,OAAO,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,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/create-timeline.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CreateTimelineParams: z.ZodObject<{
+    name: z.ZodString;
+    fps: z.ZodNumber;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createCreateTimelineTool(host: VideoHost): AgentTool<typeof CreateTimelineParams>;
+export {};
+//# sourceMappingURL=create-timeline.d.ts.map

package/dist/tools/create-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/create-timeline.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,oBAAoB;;;;;iBAKxB,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAyBhG"}

package/dist/tools/create-timeline.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const CreateTimelineParams = z.object({
+    name: z.string().min(1),
+    fps: z.number().positive(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+});
+export function createCreateTimelineTool(host) {
+    return {
+        name: "create_timeline",
+        description: "Create a new (empty) timeline / sequence on the host with a given name, fps, and " +
+            "optional resolution. Use before rough-cut workflows or when reformatting for " +
+            "shorts (9:16 / 1:1 / 4:5).\n\n" +
+            "Host caveats:\n" +
+            "  - Resolve: fps applies only if the project has no existing timelines (project fps locks once any timeline exists). width/height applied via custom timeline settings.\n" +
+            "  - Premiere: requires a .sqpreset file we don't currently ship; falls back to CLONING the active sequence and renaming. fps/width/height are IGNORED in the fallback path \u2014 the new sequence inherits the active one's settings. For a different fps/aspect on Premiere, use reformat_timeline + import_edl instead.",
+        parameters: CreateTimelineParams,
+        async execute({ name, fps, width, height }) {
+            try {
+                await host.createTimeline({ name, fps, width, height });
+                // Premiere fallback ignores fps/width/height; tell the agent so it
+                // doesn't assume those took effect.
+                if (host.name === "premiere" && (width || height || fps)) {
+                    return "ok:cloned-active-sequence; fps/width/height ignored on Premiere fallback";
+                }
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-timeline.js.map

package/dist/tools/create-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-timeline.js","sourceRoot":"","sources":["../../src/tools/create-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mFAAmF;YACnF,+EAA+E;YAC/E,gCAAgC;YAChC,iBAAiB;YACjB,2KAA2K;YAC3K,4TAA4T;QAC9T,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxD,mEAAmE;gBACnE,oCAAoC;gBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;oBACzD,OAAO,0EAA0E,CAAC;gBACpF,CAAC;gBACD,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/crossfade-videos.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const CrossfadeVideosParams: z.ZodObject<{
+    inputA: z.ZodString;
+    inputB: z.ZodString;
+    output: z.ZodString;
+    durationSec: z.ZodNumber;
+    transition: z.ZodOptional<z.ZodEnum<{
+        fade: "fade";
+        fadeblack: "fadeblack";
+        fadewhite: "fadewhite";
+        fadegrays: "fadegrays";
+        wipeleft: "wipeleft";
+        wiperight: "wiperight";
+        wipeup: "wipeup";
+        wipedown: "wipedown";
+        slideleft: "slideleft";
+        slideright: "slideright";
+        slideup: "slideup";
+        slidedown: "slidedown";
+        circleopen: "circleopen";
+        circleclose: "circleclose";
+        circlecrop: "circlecrop";
+        rectcrop: "rectcrop";
+        dissolve: "dissolve";
+        pixelize: "pixelize";
+        radial: "radial";
+        distance: "distance";
+        hblur: "hblur";
+        smoothleft: "smoothleft";
+        smoothright: "smoothright";
+        smoothup: "smoothup";
+        smoothdown: "smoothdown";
+        coverleft: "coverleft";
+        coverright: "coverright";
+        coverup: "coverup";
+        coverdown: "coverdown";
+        revealleft: "revealleft";
+        revealright: "revealright";
+        revealup: "revealup";
+        revealdown: "revealdown";
+        squeezeh: "squeezeh";
+        squeezev: "squeezev";
+        zoomin: "zoomin";
+    }>>;
+}, z.core.$strip>;
+export declare function createCrossfadeVideosTool(cwd: string): AgentTool<typeof CrossfadeVideosParams>;
+export {};
+//# sourceMappingURL=crossfade-videos.d.ts.map

package/dist/tools/crossfade-videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossfade-videos.d.ts","sourceRoot":"","sources":["../../src/tools/crossfade-videos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAsDhD,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMzB,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CA4D9F"}

package/dist/tools/crossfade-videos.js

@@ -0,0 +1,122 @@
+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";
+import { safeOutputPath } from "../core/safe-paths.js";
+// xfade transitions verified against ffmpeg's filter manual + the wubloader
+// fixture list. ALL of these are accepted by mainline ffmpeg.
+const TransitionSchema = z.enum([
+    // Plain fades
+    "fade",
+    "fadeblack",
+    "fadewhite",
+    "fadegrays",
+    // Wipes (full-edge sweeps)
+    "wipeleft",
+    "wiperight",
+    "wipeup",
+    "wipedown",
+    // Slides
+    "slideleft",
+    "slideright",
+    "slideup",
+    "slidedown",
+    // Geometric
+    "circleopen",
+    "circleclose",
+    "circlecrop",
+    "rectcrop",
+    // Stylised
+    "dissolve",
+    "pixelize",
+    "radial",
+    "distance",
+    "hblur",
+    // Soft directional
+    "smoothleft",
+    "smoothright",
+    "smoothup",
+    "smoothdown",
+    // Cover/reveal pairs
+    "coverleft",
+    "coverright",
+    "coverup",
+    "coverdown",
+    "revealleft",
+    "revealright",
+    "revealup",
+    "revealdown",
+    // Squeeze + zoom
+    "squeezeh",
+    "squeezev",
+    "zoomin",
+]);
+const CrossfadeVideosParams = z.object({
+    inputA: z.string().describe("First video (the one that fades OUT)."),
+    inputB: z.string().describe("Second video (the one that fades IN)."),
+    output: z.string().describe("Output path."),
+    durationSec: z.number().positive().describe("Crossfade duration. Typical 0.5–2s."),
+    transition: TransitionSchema.optional().describe("ffmpeg xfade transition. Default 'fade'."),
+});
+export function createCrossfadeVideosTool(cwd) {
+    return {
+        name: "crossfade_videos",
+        description: "Crossfade between two videos using ffmpeg's xfade. 16+ transition styles available; " +
+            "default 'fade' is the safe choice. Re-encodes both inputs into one output. " +
+            "Use sparingly — most pro edits use straight cuts. Crossfades signal 'time has passed'.",
+        parameters: CrossfadeVideosParams,
+        async execute({ inputA, inputB, output, durationSec, transition }, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const aAbs = resolvePath(cwd, inputA);
+                const bAbs = resolvePath(cwd, inputB);
+                const outAbs = safeOutputPath(cwd, output);
+                if (aAbs === outAbs || bAbs === outAbs) {
+                    return err("output collides with an input");
+                }
+                const probeA = probeMedia(aAbs);
+                if (!probeA)
+                    return err(`probe failed for ${aAbs}`);
+                if (durationSec >= probeA.durationSec) {
+                    return err(`durationSec (${durationSec}) >= duration of inputA (${probeA.durationSec.toFixed(2)})`, "crossfade must fit inside the first clip");
+                }
+                const offset = +(probeA.durationSec - durationSec).toFixed(3);
+                const t = transition ?? "fade";
+                const filter = `[0:v][1:v]xfade=transition=${t}:duration=${durationSec}:offset=${offset}[v];` +
+                    `[0:a][1:a]acrossfade=d=${durationSec}[a]`;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const args = [
+                    "-i",
+                    aAbs,
+                    "-i",
+                    bAbs,
+                    "-filter_complex",
+                    filter,
+                    "-map",
+                    "[v]",
+                    "-map",
+                    "[a]",
+                    "-c:v",
+                    "libx264",
+                    "-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, transition: t, durationSec });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=crossfade-videos.js.map

package/dist/tools/crossfade-videos.js.map

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

package/dist/tools/cut-at.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const CutAtParams: z.ZodObject<{
+    track: z.ZodNumber;
+    frame: z.ZodNumber;
+}, z.core.$strip>;
+export declare function createCutAtTool(host: VideoHost): AgentTool<typeof CutAtParams>;
+export {};
+//# sourceMappingURL=cut-at.d.ts.map

package/dist/tools/cut-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-at.d.ts","sourceRoot":"","sources":["../../src/tools/cut-at.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,WAAW;;;iBAGf,CAAC;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,WAAW,CAAC,CAgB9E"}

package/dist/tools/cut-at.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const CutAtParams = z.object({
+    track: z.number().int().min(1),
+    frame: z.number().int().min(0),
+});
+export function createCutAtTool(host) {
+    return {
+        name: "cut_at",
+        description: "Razor-cut on a track at a frame. Splits one clip into two. " +
+            "If host returns unsupported, use write_edl + import_edl for bulk cuts.",
+        parameters: CutAtParams,
+        async execute({ track, frame }) {
+            try {
+                await host.cutAt(track, frame);
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message, "use write_edl + import_edl");
+            }
+        },
+    };
+}
+//# sourceMappingURL=cut-at.js.map

package/dist/tools/cut-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-at.js","sourceRoot":"","sources":["../../src/tools/cut-at.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,6DAA6D;YAC7D,wEAAwE;QAC1E,UAAU,EAAE,WAAW;QACvB,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

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

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

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